前言¶
在 DeepSeek Harness（DSH / Cordis）里跑 agent，对话过程中会不断产出文件：报告 PDF、Excel、PPT、脚本、JSON 等。这些文件通常落在各会话自己的工作目录里，换一条对话或目录被清理后，很难再从统一入口找回「值得留下的交付物」。手工翻目录或靠记忆路径，成本随会话数线性上升。
下面介绍社区插件 artifact-center（维护者 lishuo4096，分类：记忆）：用 agent 工具把重要文件登记进共享索引，默认复制到统一目录；桌面版左侧边栏提供「产物中心」面板，按分类、后缀和关键词筛选，索引与副本跨会话共用。
这是什么¶
Artifact Center 是 DSH 插件，定位为跨会话的产物中心。agent 侧提供 4 个工具登记、列举、统计和删除产物；用户侧在支持 Web GUI 的宿主上通过侧边栏面板浏览同一份索引。数据默认落在 ~/.dsh/artifact-center/（索引 index.json 与 copy 模式下的 files/ 副本），所有对话共享。
与「只在当前工作区找文件」相比，本插件把「登记 + 可选复制 + 集中筛选」做成固定流程，减少产物散落在各会话目录的问题。
核心功能¶
Agent 工具¶
| 工具 | 参数 | 作用 |
|---|---|---|
artifact_save |
path（必填）、title、note、tags[]、mode（copy 默认 / link） |
登记产物；copy 复制到统一目录，link 只记路径 |
artifact_list |
ext、category、keyword |
列出/筛选，条件可组合 |
artifact_stats |
— | 按分类、后缀计数 |
artifact_remove |
id（必填） |
删除条目；copy 连副本删，link 只删索引、不碰原文件 |
返回值是结构化 JSON。artifact_save 在 path 不存在或不是文件时返回 {ok:false,message}，不抛异常打断对话。
侧边栏面板¶
重启 DSH 后，左侧边栏出现「产物中心」，与工具读写同一份索引：
- 分类 chip：
pdf/excel/ppt/word/image/code/data/archive/other，带计数。 - 后缀 chip：按真实后缀分组，按数量降序。
- 搜索：匹配标题、文件名、路径、备注、标签（约 220ms 防抖）。
- 行操作：复制路径、在文件夹中显示、删除（二次确认）。
面板通过宿主 webServer 同源路由 /artifact-center/api/state、remove、reveal 取数；无 webServer 的纯 CLI 形态下工具仍可用，面板不激活。
数据与配置¶
~/.dsh/artifact-center/
├── index.json
└── files/ # copy 模式副本
索引写入为串行队列。可用用户覆盖层指定根目录：
# cordis.patch.yml（用户覆盖层）
- id: artifact-center
config:
rootDir: D:/artifacts
安装与启用¶
从 GitHub 安装（README 推荐命令）：
dsh plugin --profile desktop add github:lishuo4096/artifact-center
本地开发可 link 到源码目录：
dsh plugin --profile desktop add link:/path/to/artifact-center
也可在插件市场（dshmarket）搜索 artifact-center 安装。装完后重启 DSH（插件走 ESM 缓存，新装或改源码需重启）；重启后侧边栏出现「产物中心，对 agent 说话时artifact_save` 等工具即可用。
典型用法¶
1、agent 写出文件后，调用 artifact_save 登记（默认 mode: copy，原目录清理也不丢副本）。
2、需要只记路径、不复制时，使用 mode: link；删除时用 artifact_remove，link 条目不会删除磁盘上的原文件。
3、在对话中或脚本侧用 artifact_list / artifact_stats 按 ext、category、keyword 查询；用户在面板里用 chip 和搜索框做同样维度的筛选。
4、改存储根目录时，在用户 cordis.patch.yml 里配置 rootDir（见上文 YAML 示例）。
维护者在仓库提供离线自检，不依赖启动 DSH：
node test/local-smoke.mjs
适用场景与注意¶
适合：长期用 DSH 桌面版做多轮对话、需要把 PDF/表格/代码等交付物集中登记和找回的开发者或团队。
注意：
- 插件以当前 dsh 进程权限运行，安装前请自行查看 GitHub 源码 与 MIT 许可证。
- 面板依赖 Web GUI（
sidebar.panellist/main与同源 API）；纯 CLI 仅工具可用。 - 社区目录 SkillHub 插件页 与 GitHub 为独立信息源，与 DeepSeek / 幻方无官方从属关系；DSH 生态理念是「一切皆插件」。
HTTP 写操作要求 content-type: application/json，并带同源栅栏（跨站 Origin 请求 403）；reveal 只接受索引内 id，由服务端解析路径，不能用来打开任意路径。
结尾¶
Artifact Center 把「登记产物、可选复制、跨会话索引、侧边栏筛选」收进一个插件：agent 用四个工具维护交付物，用户在「产物中心」面板里按分类和后缀快速定位文件。
- 目录页：https://www.skillhub.cn/plugins/lishuo4096/artifact-center
- 仓库：https://github.com/lishuo4096/artifact-center
