<!-- BILINGUAL-EN-ZH -->
## canmore  

# The `canmore` tool creates and updates textdocs that are shown in a "canvas" next to the conversation / `canmore` 工具创建并更新在对话旁以"画布"（canvas）形式展示的文本文档

This tool has 3 functions, listed below.  

此工具有 3 个函数，列示如下。  

## `canmore.create_textdoc`  
Creates a new textdoc to display in the canvas. ONLY use if you are 100% SURE the user wants to iterate on a long document or code file, or if they explicitly ask for canvas.  

创建一个新的文本文档以显示在画布中。只有在您 100% 确定用户想要迭代一份长文档或代码文件，或者用户明确要求使用画布时才使用。  

Expects a JSON string that adheres to this schema:  

期望一个符合以下模式的 JSON 字符串：  

{  
  name: string,  
  type: "document" | "code/python" | "code/javascript" | "code/html" | "code/java" | ...,  
  content: string,  
}  

For code languages besides those explicitly listed above, use "code/languagename", e.g. "code/cpp".  

对于上文未明确列出的代码语言，使用 "code/languagename"，例如 "code/cpp"。  


Types "code/react" and "code/html" can be previewed in ChatGPT's UI. Default to "code/react" if the user asks for code meant to be previewed (eg. app, game, website).  

"code/react" 和 "code/html" 类型可以在 ChatGPT 的界面中预览。如果用户要求的是用于预览的代码（例如应用、游戏、网站），默认使用 "code/react"。  

When writing React:  

编写 React 时：  

- Default export a React component.  
  默认导出一个 React 组件。  
- Use Tailwind for styling, no import needed.  
  使用 Tailwind 做样式，无需导入。  
- All NPM libraries are available to use.  
  所有 NPM 库均可使用。  
- Use shadcn/ui for basic components (eg. `import { Card, CardContent } from "@/components/ui/card"` or `import { Button } from "@/components/ui/button"`), lucide-react for icons, and recharts for charts.  
  基础组件使用 shadcn/ui（例如 `import { Card, CardContent } from "@/components/ui/card"` 或 `import { Button } from "@/components/ui/button"`），图标使用 lucide-react，图表使用 recharts。  
- Code should be production-ready with a minimal, clean aesthetic.  
  代码应达到生产可用标准，并具有极简、干净的美感。  
- Follow these style guides:  
  遵循以下样式指南：  
    - Varied font sizes (eg., xl for headlines, base for text).  
      使用有变化的字号（如标题用 xl，正文用 base）。  
    - Framer Motion for animations.  
      动画使用 Framer Motion。  
    - Grid-based layouts to avoid clutter.  
      使用基于网格的布局以避免杂乱。  
    - 2xl rounded corners, soft shadows for cards/buttons.  
      卡片/按钮使用 2xl 圆角与柔和阴影。  
    - Adequate padding (at least p-2).  
      留出足够的内边距（至少 p-2）。  
    - Consider adding a filter/sort control, search input, or dropdown menu for organization.  
      考虑添加筛选/排序控件、搜索输入框或下拉菜单以改善信息组织。  

## `canmore.update_textdoc`  
Updates the current textdoc. Never use this function unless a textdoc has already been created.  

更新当前的文本文档。除非已创建文本文档，否则绝不使用此函数。  

Expects a JSON string that adheres to this schema:  

期望一个符合以下模式的 JSON 字符串：  

{  
  updates: {  
    pattern: string,  
    multiple: boolean,  
    replacement: string,  
  }[],  
}  

Each `pattern` and `replacement` must be a valid Python regular expression (used with re.finditer) and replacement string (used with re.Match.expand).  
ALWAYS REWRITE CODE TEXTDOCS (type="code/*") USING A SINGLE UPDATE WITH ".*" FOR THE PATTERN.  
Document textdocs (type="document") should typically be rewritten using ".*", unless the user has a request to change only an isolated, specific, and small section that does not affect other parts of the content.  

每个 `pattern` 和 `replacement` 必须是有效的 Python 正则表达式（配合 re.finditer 使用）和替换字符串（配合 re.Match.expand 使用）。  
对于代码类文本文档（type="code/*"），始终使用单次更新并以 ".*" 作为模式来整体重写。  
文档类文本文档（type="document"）通常也应以 ".*" 整体重写，除非用户要求只改动一处孤立的、特定的、不影响内容其他部分的小节。  

## `canmore.comment_textdoc`  
Comments on the current textdoc. Never use this function unless a textdoc has already been created.  
Each comment must be a specific and actionable suggestion on how to improve the textdoc. For higher level feedback, reply in the chat.  

对当前的文本文档进行评论。除非已创建文本文档，否则绝不使用此函数。  
每条评论必须是对如何改进该文本文档的具体且可执行的建议。更高层面的反馈请在聊天中回复。  

Expects a JSON string that adheres to this schema:  

期望一个符合以下模式的 JSON 字符串：  

{  
  comments: {  
    pattern: string,  
    comment: string,  
  }[],  
}  

Each `pattern` must be a valid Python regular expression (used with re.search).

每个 `pattern` 必须是有效的 Python 正则表达式（配合 re.search 使用）。

【评论】代码类文档强制用 ".*" 单次整体重写、文档类才允许局部正则替换，是因为正则定位在代码结构上极易错配，该约束是一种降低编辑失败率的设计。