# 工件 分享文档和网页、查看修改，并把反馈交给 Agent。 Canonical page: https://beeuni.ai/docs/zh/artifacts 工件用于分享 Drive 中的文档或网页。每个工件都有独立链接、分享范围和版本记录。在项目侧栏打开**工件**，即可新建文档或查看已分享的内容。 ## 文档与网页 - 文档是包含 `index.md` 的文件夹。可以直接编辑，停止输入 2 秒后自动保存。**历史记录**列出之前的版本，**恢复**会将选中的内容保存为新版本。 - 网页是包含 `index.html` 及其资源的文件夹。脚本在隔离的预览中运行，无法访问你的 Beeuni 账号。 - **询问 AI**会在工件旁打开聊天。你可以查看内容，同时让 Agent 修改文件。 工件处于 Beta 阶段，默认开启。分享范围可以选择**私有**、**项目**或**公开**。私有工件仅创建者和获得授权的人可见，编辑还需要对应 Drive 文件夹的写入权限。**停止分享**会移除链接和评论，文件仍保留在 Drive 中。 ## 评论与实时查看者 在**项目管理 → 功能开关**中开启**工件评论**。评论功能处于实验阶段，默认关闭。 选中不超过 500 个字符的段落，点击**评论**。网页还支持对元素标注，或绘制反馈并附上截图。评论面板区分未解决和已解决的讨论，工件卡片显示未解决的讨论数量。 输入 `@` 提及 Agent，即可把反馈交给它。回复会保留在原讨论中。**发送未解决讨论给**可以一次发送最多 100 条尚未交付的讨论。每条讨论会显示已发送、等待人工回复或发送失败。用户之间的评论不会启动 Agent。 查看者列表显示正在阅读或编辑的人和 Agent。实时连接会同步不同页面中的评论与活动；实时连接不可用时，只要页面保持可见，评论仍会定期刷新。 ## CLI ```bash beeuni artifacts publish report.md --visibility project beeuni artifacts comments --json beeuni artifacts comment "Check this figure" --quote "Revenue" beeuni artifacts reply "Updated the source." beeuni artifacts resolve beeuni artifacts activity ``` `publish --id --base-version ` 用于更新已有工件。如果别人已保存新版本，命令会拒绝覆盖。Agent 会话可使用 `focus --status editing` 更新在线状态，使用 `--status idle` 移除该状态。 完整命令见 `beeuni artifacts --help`。API 用法见 [SDK 参考](/docs/zh/sdk/reference#artifacts)。 ## 实时协作编辑 开启**工件评论**功能开关后，有写入权限的人可以同时编辑文档；只读查看者也能实时看到更改。彩色光标和选区显示彼此的位置。在头像菜单中选择**隐藏我的光标**会隐藏位置，头像仍会显示。停止输入 2 秒后保存，生成一个版本。 Agent 对文件的修改会合并进文档。如果双方修改同一处文字，文档会保留该段落的两个版本。撤销操作只影响你的编辑，不会撤销 Agent 的修改。 文档超过 1 MiB、混用换行符，或包含编辑器无法原样保留的 Markdown 时，会改用普通自动保存。如果其他人先保存了新版本，自动保存会暂停。你可以选择**加载最新版本**或**保留我的版本**。