dsh-artifact
English | 中文
 
给 DeepSeek Harness 加上产物（artifact）：智能体写出自包含的 HTML 文档，你在对话旁边的标签页里读。
没有它的话，智能体写的报告要么滚出聊天记录，要么变成仓库里一个没人再打开的 .html。产物存在 workspace 之外、按时间倒序列出、就地渲染——它比产生它的那次对话活得久，也跟着人走而不是跟着项目走。
安装
dsh plugin --profile web add dsh-artifact装完重启 dsh web：插件在进程启动时装入。
上手
让智能体写点值得留下的东西：
> 把这周的压测结果整理成一份报告。
它会调用 artifact 工具，文档出现在产物标签页里。点进去读，‹ 返回。
智能体同时拿到一个 writing-artifacts skill，所以它写出来的 HTML 是一份真正的文档——单栏正文、语义化标题、表格自己横向滚动、配色跟随你的主题——而不是拿一套应用外壳裹住三段话。
artifact 工具
| 命令 | 参数 | 作用 |
|---|---|---|
list | — | 列出全部产物，最新在前 |
read | path | 返回一份产物的完整 HTML |
write | path、content | 创建或整体替换一份产物 |
delete | path | 删除一份产物 |
path 相对产物库解析，.html 后缀可省，所以 write path:"q3-report" 得到 q3-report.html。写入被约束在产物库内：解析后跑到外面的路径会被拒绝，而不是存到浏览器找不到的地方。
产物存在哪
$DSH_HOME/artifacts，默认 ~/.dsh/artifacts——和 harness 自己的 sessions、storages 并排。
刻意不放 workspace：产物跟着人走而不是跟着项目走，仓库也不该被生成的 HTML 填满。
渲染
产物在 iframe 里渲染，只开 allow-scripts——无网络、无同源。远程样式表、CDN 脚本、网络字体、fetch、localStorage、cookie 全都用不了，所以产物必须把需要的东西全部内联。内置 skill 会教智能体这件事，只有你手写产物时才需要关心。
预览会把 app 的实时配色 token 注入进去，所以产物跟随你的主题——包括被别的插件覆盖过的主题。
配置
在 profile 的 cordis.patch.yml 里覆盖：
- id: artifact
config:
# 产物目录，省略或 null 时用 $DSH_HOME/artifacts。
root: /absolute/path/to/artifacts
# 单次写入允许的最大字符数。
maxArtifactChars: 400000
# 是否注入「什么时候该写产物」的 system prompt 段落。
promptSection: true
# 是否注册内置的 writing-artifacts skill。
skill: true
# 交给产物的配色，层叠在实时主题之上。
# 键不带 `--` 时按 alias token 解析。
palette:
state-business-primary: '#e0552b'实现笔记
给其他插件作者的记录——slot 契约、双层信封的线上协议、以及四个值得知道的坑——在 [NOTES.md](NOTES.md)。
License
MIT