前言¶

在 DeepSeek Harness（DSH）里跑多轮对话时，文件往往散落在当前工作区、终端输出和会话事件里。换会话或关侧边栏后，要找回「某次对话写了哪个文件、从哪条会话链路过来的」，通常只能翻历史或自己记路径。Artifact Center 是面向 web 侧栏的全局面板：不依赖当前是否在对话中，也能按工作区、标签和时间筛产物，并链回来源会话。

这是什么¶

Artifact Center（插件 ID：artifact-center，npm 包名 dsh-artifact-center）由 YQing0123 维护，MIT 许可证。它解决的是：定位 DSH 对话产生的文件，并连同工作区与会话脉络一起查看。历史记录保存来源与元数据，不保留旧文件内容；快照类结果会标注为推断，因为文件系统变化无法证明是哪条并发任务所致。

核心功能¶

下面按 README 已列能力归纳，便于对照是否满足你的流程。

侧栏与索引¶

1. 全局侧栏面板，无需处于活跃对话即可打开。
2. 启动时可从完整会话事件历史回填，包括写入、编辑以及明确展示的交付物。
3. 每轮结束可对工作区做实时快照，用于发现 shell 与子进程输出；大块输出超过阈值时会摘要，避免列表被刷屏（默认 burstThreshold: 500）。
4. 支持工作区 / 标签 / 日期筛选、收藏、备注、有界文本搜索与虚拟列表；在「Readable formats」下可直接勾选扩展名控制可见性，选择保存在当前浏览器。
5. 默认忽略目录包括 .git、node_modules、dist、build、.next、__pycache__、.venv、target、.cache、.dsh；若显式提供 ignorePatterns 则替换默认列表。

预览与打开¶

内置只读预览：图片、PDF、Markdown、Mermaid、文本/代码、CSV/TSV、沙箱 HTML 与媒体。Office 与二进制文件走系统默认应用，不做格式转换。HTML 预览不执行脚本、不访问网络。

会话与导出¶

提供会话链接、路径/链接复制、文件关联程序选择、来源历史，以及 CSV / Markdown 导出。

文件状态与清理¶

支持缺失文件检测；确认后可移入系统回收站。用文件管理器取回文件后，可在界面勾选以恢复索引状态。

Agent 工具与中英文界面¶

只读工具 artifact_search 供 Agent 按条件检索元数据与路径；界面支持中英文。

自 0.1.2 起，单独的 provenance 表在重建派生列表缓存时仍保留已记录输出与注解；持久化的 turn checkpoint 可在重启后恢复，已完成轮次不会纳入其记录结束时间之后改动的文件。清除整个 storage domain 会一并删除 provenance 与注解。enableBetterSidebar 为预留项，尚未委托给可选插件。

安装与启用¶

npm 已发布基线为 0.1.0；仓库当前 package.json 版本为 0.1.2。安装后需重启 Host 并刷新浏览器。

从 npm 安装：

dsh plugin --profile web add dsh-artifact-center

目录审核期间也可直接从 GitHub 安装：

dsh plugin --profile web add github:YQing0123/dsh-artifact-center

说明：Electron 管理的 desktop profile 须通过其插件管理器安装，不要用上述 CLI 管理 desktop。市场上架取决于 awesome-dsh-plugin 目录条目 的验收。参考验收 Host 为 DSH 0.1.7-rc.2。

配置¶

在 profile 的 cordis.patch.yml 中覆盖 artifact-center 配置，例如：

- update:
    artifact-center:
      config:
        backfillOnStart: true
        snapshotOnTurnEnd: true
        burstThreshold: 500
        maxIndexedFiles: 50000
        previewMaxBytes: 20971520
        textMaxBytes: 1048576
        validationIntervalMs: 300000
        readableExtensions:
          - md
          - txt
          - json
          - yaml
          - yml
          - csv
          - js
          - ts
          - png
          - jpg
          - pdf
        autoTags:
          - name: Deliverable
            kind: glob
            value: outputs/**
          - name: Spreadsheet
            kind: ext
            value: xlsx

autoTags 规则支持 glob、ext 与 session（会话标题子串）。readableExtensions 为不带前导点的白名单；Artifact Center 导航在「Readable formats」下展示当前生效列表，空列表则使用全部内置支持格式。名单外扩展不会被索引或读内容。状态经 Host 的 storageDomain API 保存在 artifact_center。

/artifact-center/* 路由需要 Host 浏览器认证与同源请求守卫；仅已索引且位于注册工作区内的文件可读或可打开，工作区外符号链接会被拒绝。文本搜索对每个候选最多读 textMaxBytes，不是语义或二进制文档搜索引擎。

典型用法¶

侧栏浏览与筛选¶

1. 安装并重启 Host、刷新浏览器后，打开全局 Artifact Center 侧栏。
2. 按工作区、标签、日期或使用收藏、备注缩小列表；需要时在「Readable formats」调整可见扩展名。
3. 点击条目预览或打开；通过会话链接回到产生该文件的对话。

Agent 检索¶

Agent 可调用只读工具（参数以 README 为准）：

artifact_search(query, workspace?, type?, tag?, since?, limit?)

• workspace：工作区 ID 或标题。
• type：doc、sheet、slide、image、web、data、code、media、archive、other 等。
• since：ISO 时间戳；limit 最多 100。
• 缺失或已进回收站的文件仍会在结果中保留标签。

适用场景与注意¶

适合：长期在 DSH 中写代码、写文档、跑 shell 的开发者，需要在多个工作区之间统一查看「对话留下了哪些文件」，并偶尔让 Agent 按元数据检索路径。

注意：

1. 插件以当前 DSH Host / 进程权限运行；安装前请阅读 源码仓库 与 MIT 许可证，自行评估信任边界。
2. 历史不保存旧内容；无路径记录的早期 shell 输出无法仅从现有文件重建。
3. DSH 生态强调「一切皆插件」；SkillHub 目录页 为社区站点，与 DeepSeek / 幻方无官方从属关系。

链接¶

• 目录页：https://www.skillhub.cn/plugins/YQing0123/dsh-artifact-center
• GitHub：https://github.com/YQing0123/dsh-artifact-center
• 中文说明与需求、验收文档见仓库内 README.zh-CN.md、docs/requirements.zh.md、docs/acceptance.zh.md。