工件

分享文档和网页、查看修改，并把反馈交给 Agent。

工件用于分享 Drive 中的文档或网页。每个工件都有独立链接、分享范围和版本记录。在项目侧栏打开工件，即可新建文档或查看已分享的内容。

文档与网页

文档是包含 index.md 的文件夹。可以直接编辑，停止输入 2 秒后自动保存。历史记录列出之前的版本，恢复会将选中的内容保存为新版本。
网页是包含 index.html 及其资源的文件夹。脚本在隔离的预览中运行，无法访问你的 Beeuni 账号。
询问 AI会在工件旁打开聊天。你可以查看内容，同时让 Agent 修改文件。

工件处于 Beta 阶段，默认开启。分享范围可以选择私有、项目或公开。私有工件仅创建者和获得授权的人可见，编辑还需要对应 Drive 文件夹的写入权限。停止分享会移除链接和评论，文件仍保留在 Drive 中。

评论与实时查看者

在项目管理 → 功能开关中开启工件评论。评论功能处于实验阶段，默认关闭。

选中不超过 500 个字符的段落，点击评论。网页还支持对元素标注，或绘制反馈并附上截图。评论面板区分未解决和已解决的讨论，工件卡片显示未解决的讨论数量。

输入 @ 提及 Agent，即可把反馈交给它。回复会保留在原讨论中。发送未解决讨论给可以一次发送最多 100 条尚未交付的讨论。每条讨论会显示已发送、等待人工回复或发送失败。用户之间的评论不会启动 Agent。

查看者列表显示正在阅读或编辑的人和 Agent。实时连接会同步不同页面中的评论与活动；实时连接不可用时，只要页面保持可见，评论仍会定期刷新。

CLI

beeuni artifacts publish report.md --visibility project
beeuni artifacts comments <artifact-id> --json
beeuni artifacts comment <artifact-id> "Check this figure" --quote "Revenue"
beeuni artifacts reply <thread-id> "Updated the source."
beeuni artifacts resolve <thread-id>
beeuni artifacts activity <artifact-id>

publish --id <artifact-id> --base-version <version> 用于更新已有工件。如果别人已保存新版本，命令会拒绝覆盖。Agent 会话可使用 focus <artifact-id> --status editing 更新在线状态，使用 --status idle 移除该状态。

完整命令见 beeuni artifacts --help。API 用法见 SDK 参考。

实时协作编辑

开启工件评论功能开关后，有写入权限的人可以同时编辑文档；只读查看者也能实时看到更改。彩色光标和选区显示彼此的位置。在头像菜单中选择隐藏我的光标会隐藏位置，头像仍会显示。停止输入 2 秒后保存，生成一个版本。

Agent 对文件的修改会合并进文档。如果双方修改同一处文字，文档会保留该段落的两个版本。撤销操作只影响你的编辑，不会撤销 Agent 的修改。

文档超过 1 MiB、混用换行符，或包含编辑器无法原样保留的 Markdown 时，会改用普通自动保存。如果其他人先保存了新版本，自动保存会暂停。你可以选择加载最新版本或保留我的版本。