dsh-artifact

中文 | English

dsh-artifact 为 DeepSeek Harness 提供工件（artifact）：智能体通过 artifact 工具写出自包含的 HTML 文档或幻灯片，写完即在对话右侧打开。

智能体生成的报告若只留在聊天记录中，会随对话滚走；若写入仓库，则成为无人再打开的 .html 文件。工件保存在工作区之外，按时间倒序集中列出，可就地阅读、编辑、对比历史版本，幻灯片还可放映并导出为 PowerPoint。

安装

dsh plugin --profile web add dsh-artifact      # dsh web
dsh plugin --profile desktop add dsh-artifact  # 桌面版

插件在进程启动时加载，安装后需重启 dsh web 或桌面版。右侧栏与工件面板需要 DSH 0.1.7 及以上版本。

快速上手

向智能体提出需要保留的产出即可：

把这周的压测结果整理成一份报告。

做一份 4 页的幻灯片，主题是咖啡店季度回顾。

智能体调用 artifact 工具写入工件。写入完成时，若该对话正在屏幕上，工件会在右侧栏自动打开；对话中的工具行同时以工件名显示一个跳转链接，之后可随时点击重新打开。

常用用法

阅读与查找。 对话的「工件」标签页列出该会话写过的工件；左侧栏的「工件」面板列出所有会话的工件。工件面板中的文档可通过「在侧边栏打开」放到对话旁阅读。

编辑幻灯片。 要求制作演示文稿时，智能体写出的是幻灯片而非网页。幻灯片在编辑器中打开，支持直接修改文字、拖入图片、调整表格行列、切换主题、全屏放映与导出 .pptx；修改会保存回同一份工件，智能体下次读取时即可看到。编辑器由 @jannchie/slides 提供。

对比历史版本。 工件被重写后，旧版本会保留下来（默认每份最多 20 个），标题旁出现「历史」按钮。预览模式下按住「按住看这一版」可在同一位置切换新旧版本；源码模式下显示折叠了未变部分的差异。「恢复这一版」无需确认，被替换的内容同样保留为一个版本。

自动打开的范围。 仅在对话中实时完成的 write 会自动打开工件。重新进入会话时回放的旧调用、read 与 list 不会打开任何内容；右侧栏不可用时（例如未选中会话）也不会自动跳转到工件面板。

artifact 工具

命令	参数	作用
list	—	按时间倒序列出所有工件
read	path	读取一份工件的完整内容
write	path、content、kind	新建或替换工件；kind 为 html（默认）或 slides
delete	path	删除工件及其历史版本

path 相对于工件目录，.html 后缀可省略。智能体同时获得 writing-artifacts skill，用于约束 HTML 文档的结构与配色，以及幻灯片可用的格式子集。

存储与渲染

• 工件保存在 $DSH_HOME/artifacts（默认 ~/.dsh/artifacts），历史版本位于其下的 .versions/，幻灯片中的图片位于 .assets/。
• HTML 工件在仅允许脚本的 sandbox iframe 中渲染，无网络访问、无同源权限，所需资源须内联。预览时注入应用当前的颜色变量，工件配色随主题变化。

配置

在 profile 的 cordis.patch.yml 中覆盖：

- id: artifact
  config:
    root: /absolute/path/to/artifacts   # 工件目录，默认 $DSH_HOME/artifacts
    maxArtifactChars: 400000            # 单次写入的字符上限
    maxVersionsPerArtifact: 20          # 每份工件保留的历史版本数，0 为关闭
    promptSection: true                 # 在系统提示词中说明何时写工件
    skill: true                         # 注册 writing-artifacts skill
    palette:                            # 叠加在当前主题上、传给预览的颜色
      state-business-primary: '#e0552b'

插槽约定与通信协议等实现说明见 NOTES.md。

License

MIT