> ## Documentation Index
> Fetch the complete documentation index at: https://docs.qoder.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Canvas

> 把文本、数据或分析结果渲染成带布局的可视化面板，支持在画布上直接标注协同，以及一键分享给团队。

Canvas 让 Agent 把文本、数据或分析结果渲染为带布局的面板，支持统计卡片、表格、图表等多种展示形式。你可以在画布上直接标注协同，并把它一键分享给团队。

## Canvas 是什么

* **可视化的分析结果**：把复杂的输出组织成分块面板，代替冗长的文本。
* **标准的 `.canvas.tsx` 文件**：Agent 生成或修改该文件，改动即时反映在 Canvas 预览面板中。
* **对话即修改**：不需要手写源码，你在对话中提出想要的调整，Agent 会自动更新源码并重新渲染。

## 适用场景

* **数据看板**：让 Agent 分析日志或指标数据后，直接在 Canvas 中生成带统计值和趋势图的数据看板，一目了然。
* **结构化报告**：将复杂分析结果（如性能剖析、依赖分析）以分块面板呈现，代替冗长的文本输出。
* **架构与流程可视化**：在梳理系统逻辑或编写文档时，将状态流转、模块依赖或抽象架构渲染为结构图，方便团队沟通对齐。

## 如何使用

在对话中使用 `/canvas` 命令即可触发：

* **首次生成**：描述你想要的画布内容，Agent 会创建 `.canvas.tsx` 并在 Canvas 预览中渲染。
* **迭代调整**：在同一对话中继续向 Agent 提要求，或直接在 Canvas 上标注，Agent 会更新源码并重新渲染。

## 标注

标注让你直接在 Canvas 上圈出需要调整的位置，让 Agent 更精准地理解你的反馈——比起用文字描述"第三张图的图例位置"，直接在画布上指出更快、也更少歧义。

**使用方式：**

* **进入标注模式**：点击 Canvas 上的标注入口。
* **选中或圈出目标**：可以点击一个具体元素，也可以自由画圈圈住一个区域。
* **添加说明**：在标注上输入你的修改建议或反馈。
* **发送给 Agent**：标注会作为上下文附加到对话，Agent 会读取标注并据此更新画布源码，随后重新渲染。

## 分享

Canvas 支持一键发布，把画布分享给团队成员。发布后的画布**仅在你所在企业组织内可见**，不会对外公开，保障企业数据安全。

<Note>
  分享能力仅对 **Teams / Enterprise** 计划账号生效。
</Note>

### 发布 Canvas

Canvas 顶部工具栏点击 **发布**，即可把当前画布发布到企业内。

* 发布浮层会提示 "**所有团队成员均可查看**"，确认后即完成发布。
* 发布后按钮变为 **已发布**，团队成员通过分享链接即可在企业内访问该画布。

### 发布后操作

点击 **已发布** 按钮打开下拉菜单，按以下顺序提供操作：

| 操作       | 说明                                              |
| -------- | ----------------------------------------------- |
| **同步**   | 把当前 Canvas 的最新内容同步到已发布版本，同步完成后菜单顶部的「上次同步时间」会更新。 |
| **取消发布** | 取消发布，原分享链接失效，顶部按钮恢复为 **发布**。                    |
| **拷贝链接** | 复制发布链接到剪贴板，用于分享给团队成员。                           |

### 我的分享

想找回之前发布过的 Canvas，可以到企业管理后台左侧导航的 **我的分享** 里查看，页面顶部按内容类型分 Tab，后面会显示已发布的数量（例如 **Canvas 1**）。

在列表里点击 Canvas 名称即可预览已发布的画布；悬停某一行、点击右侧 `...`，可以 **复制链接** 分享给同事，或 **删除** 不再需要的画布。

<Note>
  未发布过任何内容时，左侧导航中的 **我的分享** 入口不会显示。
</Note>