前言¶
在 DeepSeek Harness（DSH）里做多轮会话，模型往往会写出脚本、配置、图片或文档，路径散落在工作区各处。事后想找回「上周改过的那份配置」或「某次对话里生成的素材」，通常只能翻聊天记录或自己记目录。社区插件 dsh-artifact-library（维护者 wyq183）把思路放在「本地优先」：自动登记 AI 产出、用摘要和标签整理，并支持自然语言检索；同时内置一套与工作区绑定的本地文件搜索，在 Windows 上借用便携版 Everything 引擎，在 Linux 上用纯 Node 做范围索引，不把全盘交给索引器。DSH 生态本身是「一切皆插件」；插件目录站 skillhub.cn 是社区站点，与 DeepSeek / 幻方无官方从属关系。
这是什么¶
dsh-artifact-library 在 DSH 里扮演「作品柜 + 资料柜 + 工作台」：订阅会话事件，把每轮产出登记进库并记录来源会话；新条目可标记为待精化，由会话内模型或管理页的「立即精炼」补全摘要、标签与项目。检索侧提供关键词与语义搜索，以及基于项目、标签、目录等的「相关建议」连线。v0.7.0 起还增加了本地文件管理器：在严格限定的目录范围内做毫秒级文件名/路径搜索，命中后可一键登记为产物。
数据默认落在 ~/.dsh/artifact-library/（环境变量 DSH_ARTIFACT_LIBRARY_DIR 可覆盖）；启动日志中会出现类似 artifact-library: store at ~/.dsh/artifact-library/artifacts.json (N records) 的自证行。官方说明强调数据不出本机。
核心功能¶
下面按 README 已发布能力归纳；未发版界面能力不在此列。
原生面板¶
自 v0.6.0 起，左侧栏「产物库」图标可在主区打开原生 React 面板，使用 DSH 公开侧栏席位，不依赖第三方侧栏插件。面板提供统计、筛选（kind / 状态 / 项目 / 排序）、卡片 / 列表 / 项目视图，以及详情抽屉内的预览、编辑、回收站、在文件管理器中定位等操作。
自动采集与 AI 精化¶
- 每轮产出自动登记，默认每轮上限 20 条（可在设置中调整）。
- 新条目标为「待精化」；会话内模型可主动补全元数据，或在管理页勾选后通过「立即精炼 / 精化项目 / 精化文件夹」开启专属精化会话批量处理（模型仅作预选，不会自动应用）。
检索、连线与整理¶
| 能力 | 说明 |
|---|---|
| 语义搜索 | 管理页语义搜索，或模型调用 artifact_find |
| 关键词搜索 | artifact_search（正文前 8000 字符；更长文档靠后部分搜不到时会提示截断） |
| 相关建议 | 编辑页「扫描相关条目」，或 artifact_suggest_links |
| 整理建议 | 管理页整理入口，或 artifact_suggest_cleanup（重复、缺失文件、待精化、僵尸项目等） |
| 项目合并 | artifact_merge_projects：规则聚类候选、可撤销，原名转标签 |
资料库支持文件夹批量导入；project_overview 可一句话概览某项目的产出与资料。
本地文件管理器（v0.7.0）¶
在面板切换到「文件」视图，首次需「启动文件索引」。索引范围限于 DSH 工作区 + 已登记产出所在目录 + 用户额外指定目录，不索引全盘。查询语法在 Windows 与 Linux 上一致，例如 Everything 风格：ext:psd、dm:today、size:>10mb、path:项目。
| 平台 | 索引后端 | 在文件管理器中定位 |
|---|---|---|
| Windows | 内置 Everything 便携版（vendor/everything/） |
explorer /select, |
| Linux | 纯 Node 范围索引 | D-Bus FileManager1.ShowItems，回退 xdg-open 所在目录 |
独立实例与用户本机已安装的 Everything 隔离；懒启动，不搜索则不拉起进程。会话工作目录会通过事件防抖纳入索引（config.indexScopeDebounceMs 可调）。模型侧可用 search_files，范围与面板一致。
模型工具¶
README 列出 12 个产物工具：register_artifact、artifact_list、artifact_get、artifact_update、artifact_trash、artifact_restore、artifact_stats、artifact_search、artifact_find、artifact_suggest_links、artifact_suggest_cleanup、project_overview；另加 1 个 search_files。
维护¶
定时整理（默认每 7 天，cleanupIntervalDays 可设 1–365）、自动备份（默认保留 10 份，backupKeep 可设 1–100）、整库导出 JSON。
安装与启用¶
插件声明的 DSH 运行时下限为 >= 0.2.0-rc.2（peerDependencies）；不满足时需 dsh plugin allow-version 显式放行。Node 要求 >= 20。
安装步骤如下。
- 在已安装 DSH CLI 的环境中执行官方安装命令：
dsh plugin add github:wyq183/dsh-artifact-library
若数据落在 web profile，可使用注释中的变体：
# dsh plugin --profile web add github:wyq183/dsh-artifact-library
-
重启
dsh web，确认启动日志出现产物库 store 路径一行。 -
使用方式二选一或并用：
- 侧栏 🐋「产物库」打开原生面板；
- 侧栏脚部「产物库 · 网页版」，或访问<dsh web 地址>/ext/artifact-library/进入完整管理页（导入文件夹、立即精炼、语义搜索、整理建议等部分能力目前仍主要在此页，原生面板尚未全部搬运）。
典型用法¶
让模型找回产物：在任意会话中描述需求，例如「找一下上次关于视频素材的产出」，由模型调用 artifact_find；需要精确字段时用 artifact_search 或 artifact_list / artifact_get。
登记与更新：模型可用 register_artifact 手动登记；自动采集已覆盖会话产出时，可在管理页对待精化条目执行精炼，或用 artifact_update 改标签、项目、关联资料。
本地文件再进库：在面板「文件」视图搜索命中后点「登记」；或让模型在范围内使用 search_files 定位路径后再 register_artifact。
项目视角：对某项目调用 project_overview；若同一项目被拆成多个名称，在整理流程中使用 artifact_merge_projects 按 README 说明逐组确认。
维护：依赖默认定时整理与备份即可；迁移或归档前可在管理页导出 JSON。
适用场景与注意¶
适合谁：长期用 DSH 做项目、希望跨会话保留并检索 AI 产出与引用资料的用户；需要在工作区与已登记目录内快速搜文件并纳入产物库的场景。分类上社区目录将其归为「记忆」类插件。
平台：Windows 与 Linux 为 README 明确支持的完整可用平台；macOS 尚未适配，不宜当作生产环境依赖。
权限与安全：插件以当前 dsh 进程权限运行，能读写的路径与宿主一致。安装前应阅读 GitHub 仓库 源码与 MIT 许可证，并理解文件索引与自动采集会触达本地磁盘。README 另设「安全边界」「隐私」「已知限制」章节，部署前建议通读。
能力边界（摘录）：关键词搜索只索引正文前 8000 字符；语义搜索、部分整理与导入能力仍以完整管理页为主；截图在仓库中标注为待补，界面以实际运行为准。
结尾¶
dsh-artifact-library 把 DSH 会话产出和限定范围内的本地文件收到同一套本地库里，用采集、精化、检索和模型工具串起来，减少「产物只活在单次对话里」的损耗。目录页：skillhub.cn/plugins/wyq183/dsh-artifact-library；源码与详细配置：github.com/wyq183/dsh-artifact-library。
