# 产物中心 Artifact Center — 需求规格说明

> **产品**：`dsh-artifact-center`（中文名「产物中心」）
> **定位**：DSH 插件。把"我这个对话刚才生成的那份文件在哪"从"翻目录"变成"一次点击"。
> **配套文档**：方案 [`plan.zh.md`](plan.zh.md) · 开发注意事项 [`dev-notes.zh.md`](dev-notes.zh.md)
> **状态**：需求已冻结（决策 D1–D10 见方案文档）。本文件是编码与验收的唯一依据。

---

## 1. 产品定义

### 1.1 问题

DSH 用户在每个工作区的对话里不断生成文件——Office 文档、Markdown、HTML、图片、归档、脚本产物。它们散落在各工作区目录下，**没有统一的入口**，事后基本只能靠回忆路径去翻。

### 1.2 核心洞察

**"产物" ≠ "工作区里的文件"。**

实测本机 8 个工作区共 **26,334 个文件**，其中 `.svg` 12,221、`.java` 2,528、`.py` 2,319、`.png` 1,781、`.md` 1,142 —— 绝大多数是源码、依赖和素材，**不是对话产出**。目录优先的索引会把 99% 的噪声端给用户。

> **产物 = 有对话血缘的文件。索引主键是 `(工作区, 会话, 轮次, 路径)`，不是 `路径`。**

### 1.3 差异化

生态里已有 5+ 个"工作区文件浏览器"（`dsh-file-explorer-kit`、`@jaxzhou/dsh-file-explorer`、`dsh-fs-browser`、`@p-dsh-market/dsh-open-workspace` 等），它们回答的是"**这个工作区里有哪些文件**"。

本插件回答的是"**这些文件是哪个对话、哪一轮产出的，我要找的那份在哪**"。同时它是**跨工作区**的——不是单个会话的工作区浏览器。

### 1.4 目标用户与场景

| 场景 | 描述 |
|---|---|
| S1 找刚才的文件 | "五分钟前那个 agent 生成了一份 docx，我要打开它" |
| S2 找回上周的产物 | "上周某个对话做过一份支付方案，我不知道在哪个工作区" |
| S3 交付前确认 | "这次任务一共产出了哪些文件，我要打包交付" |
| S4 清理 | "这些中间产物没用了，删掉" |
| S5 让 Agent 找 | "帮我找一下上次关于数据的分析文档"（模型用 `artifact_search`） |

---

## 2. 范围

### 2.1 做（In scope）

- 自动索引**所有已注册工作区**、**所有历史与进行中对话**产出的文件
- 左侧栏入口 + 主面板（无活动会话也可用）
- 按工作区 / 类型 / 标签分类，按时间与关键字检索
- 面板内预览（零格式转换）；打不开的交给"打开方式"
- 移入回收站
- 标签、收藏、备注、版本聚合、失效检测、清单导出
- `artifact_search` Agent 工具

### 2.2 不做（Out of scope，明确排除）

| 不做 | 原因 |
|---|---|
| **任何格式转换（含 Office→PDF）** | 决策 D1。原生什么格式就展示什么格式 |
| **浏览工作区全部文件**（目录树浏览模式） | 决策 D6。与已有插件重叠且噪声高 |
| **硬删除** | 决策 D2。只提供移入回收站 |
| **依赖任何 `@deepseek-ai/dsh-client-ui-*` 包** | 决策 D3。官方禁令 + 升级脆性 |
| 文件编辑 / 重命名 / 移动 | 只做查看与移除，不做内容与命名管理 |
| 云端同步 / 多机索引 | 单机本地索引 |
| 全文内容索引（对所有类型） | 只对文本类（md/txt/html/csv/json/代码）抽取内容 |

---

## 3. 功能需求

> **验收标准**均为可客观判定；标注 ⚠️ 的需要在本机真实环境验证。

### FR-A 索引引擎

| 编号 | 需求 | 验收标准 |
|---|---|---|
| FR-A1 | 读取所有已注册工作区 | 调用 `workspaceRegistry.list()`，面板分类树中出现全部 8 个工作区（名称与顺序与 DSH 左侧工作区列表一致） |
| FR-A2 | 回填历史会话 | 对全部历史会话（本机 289 份）提取产物路径；完成后可按文件名检索到装插件之前产出的文件 |
| FR-A3 | 从会话事件提取写文件路径 | `sessionQuery.listEvents()` 中 `write`/`edit`/`str_replace_editor` 的 `file_path` / `path` 全部入库，来源标 `write`/`edit` |
| FR-A4 | 记录显式交付 | `deliverables/presented` 事件的每个文件入库，来源标 `present`，并保存其 `description` |
| FR-A5 | **快照 diff 捕获 shell 产物**（核心） | 每轮 `turn/end` 后对工作区做全量 stat 快照并与上一轮 diff；`bash`/python/MCP 生成的文件必须能入库，来源标 `snapshot` ⚠️ |
| FR-A6 | 相对路径解析 | 事件里的相对路径用该会话 `header.cwd` 解析为绝对路径后再 stat |
| FR-A7 | 忽略规则 | 默认忽略 `.git`、`node_modules`、`dist`、`build`、`.next`、`__pycache__`、`.venv`、`target`、`.cache`、`.dsh`；可在设置里增删 |
| FR-A8 | 爆量轮折叠 | 单轮新增/修改超过阈值（默认 500）时，存为一条"批量产出"记录（含文件总数与顶层目录分布），不在列表里逐条展开 ⚠️（实测出现过单轮 13,090 个文件） |
| FR-A9 | 索引可重建 | 删除索引存储后重启，能重新回填出等价结果（索引是派生缓存） |
| FR-A10 | 增量与崩溃恢复 | 记录处理游标；重启后只处理新增部分，不整库重扫 |
| FR-A11 | 索引进度可见 | 回填期间面板显示进度（已处理/总数）；已索引部分可立即浏览，不阻塞 |

### FR-B 左侧分类树

| 编号 | 需求 | 验收标准 |
|---|---|---|
| FR-B1 | 固定分类维度 | 树中出现全部节点：全部产物 / 最近（今天、7 天、30 天）/ 按工作区 / 按类型 / 按标签 / 收藏 / 失效 |
| FR-B2 | 按工作区 | 展开后列出所有工作区，各自显示产物数量 |
| FR-B3 | 按类型 | 分组：文档、表格、演示、图片、网页、数据、代码、音视频、压缩包、其他；显示数量 |
| FR-B4 | 按标签 | 列出用户标签与自动标签，显示数量；可多选（并集） |
| FR-B5 | 选中联动 | 点击任一节点，右侧列表立即按该条件过滤；当前选中项高亮 |
| FR-B6 | 可折叠 | 树可整体折叠以让出列表宽度 |

### FR-C 产物列表

| 编号 | 需求 | 验收标准 |
|---|---|---|
| FR-C1 | 列：文件名 | 显示文件名（不含目录）；点击 = 预览 |
| FR-C2 | 列：工作区 | 显示所属工作区名；点击 = 筛选该工作区 |
| FR-C3 | 列：类型 | 显示类型图标 + 扩展名 |
| FR-C4 | 列：标签 | 显示标签胶囊；可内联增删 |
| FR-C5 | 列：所属对话 | 显示会话标题（`sessionQuery.readTitle*`）；悬停显示轮次与时间；点击可跳回该对话 |
| FR-C6 | 列：来源 | 徽章区分 `present`（显式交付）/ `write`/`edit` / `snapshot`（推断）/ `manual`，并体现信任度差异 |
| FR-C7 | 列：大小与时间 | 显示文件大小（人类可读）与产生时间（相对时间，悬停显示绝对时间） |
| FR-C8 | 排序 | 可按时间、大小、名称、工作区排序；默认按时间倒序 |
| FR-C9 | 虚拟滚动 | 列表项 1 万条以上仍可流畅滚动（不卡帧） |
| FR-C10 | 空态 | 该筛选无结果时给出说明与"清除筛选"入口 |
| FR-C11 | 搜索 | 顶部搜索框按文件名模糊匹配；结果实时过滤 |
| FR-C12 | 内容检索 | 开启"搜索内容"后，对文本类文件内容匹配并显示命中片段 |

### FR-D 预览

> **总原则（决策 D1）**：原生输出什么格式就展示什么格式。**不为预览做任何格式转换。**

| 编号 | 类型 | 需求 | 验收标准 |
|---|---|---|---|
| FR-D1 | 图片 png/jpg/gif/webp/bmp/ico/svg | 面板内直接显示，支持缩放 | 打开一张真实 png 能正常显示；svg 用 `<img src>` 渲染，不内联 SVG |
| FR-D2 | PDF | 面板内直接用浏览器 PDF 阅读器显示 | 打开一个真实 PDF 能翻页；**不引入 pdfjs** |
| FR-D3 | 文本 / 代码 / json / yaml / 日志 | 文本视图，代码有基础高亮 | 打开一个真实 .ts 或 .json 能显示且高亮 |
| FR-D4 | CSV / TSV | 以表格呈现（只解析，不改文件） | 打开一个真实 csv 显示为表格 |
| FR-D5 | **Markdown** | **渲染展示**（标题/列表/表格/代码块/链接） | 打开一个真实 .md 显示为渲染后的 HTML，不是源码 |
| FR-D6 | **Mermaid** | `.mmd` 或 md 里的 ```mermaid 围栏渲染为图 | 打开一个真实 .mmd 显示为流程图 ⚠️ |
| FR-D7 | HTML | 沙箱 iframe 渲染，只读 | 打开一个真实 html 能显示；不执行外部脚本；带 CSP |
| FR-D8 | 音视频 | 原生 `<audio>` / `<video>` 播放，支持 Range | 拖进度条不重新下载整个文件 |
| FR-D9 | Office（doc/docx/xls/xlsx/ppt/pptx） | **不预览**，显示"用其他应用打开" | 打开 docx 不出现转换/预览，直接给打开方式 |
| FR-D10 | 压缩包 / 二进制 / 未知 | **不预览**，只显示元数据 + 打开方式 | 同上 |
| FR-D11 | 超大文件保护 | 超过阈值（默认 20 MB）不做内嵌预览 | 打开一个 18 MB 的 HTML 不卡死浏览器，给出提示 ⚠️ |
| FR-D12 | 预览错误态 | 读取失败/权限不足时显示错误与"用其他应用打开" | 对不可读文件不白屏 |
| FR-D13 | 可选增强 | 若检测到 `dsh-better-sidebar`，可委托其渲染 markdown/mermaid；不可用时用自带渲染器 | 卸载 better-sidebar 后 markdown 仍能渲染 ⚠️ |

### FR-E 打开方式

| 编号 | 需求 | 验收标准 |
|---|---|---|
| FR-E1 | 用默认程序打开 | 菜单项"用默认程序打开"能调起系统关联程序打开该文件 ⚠️ |
| FR-E2 | 用其他应用打开 | 子菜单列出系统可用应用（来自 `workspacePathApplications`），选择后由该应用打开 ⚠️ |
| FR-E3 | 在文件管理器中显示 | "在文件管理器中显示"能打开 Finder 并定位到该文件（`action: 'reveal'`）⚠️ |
| FR-E4 | 复制路径 | 复制绝对路径到剪贴板 |
| FR-E5 | 复制为 Markdown 链接 | 复制 `[文件名](<绝对路径>)` 形式 |
| FR-E6 | 文件已失效 | 文件不存在时禁用打开类操作并提示 |

### FR-F 删除（移入回收站）

| 编号 | 需求 | 验收标准 |
|---|---|---|
| FR-F1 | 移入系统回收站 | 执行后文件出现在 `~/.Trash`，可从 Finder 恢复 ⚠️ |
| FR-F2 | 二次确认 | 确认弹窗显示完整路径、大小、所属对话、是否多版本引用 |
| FR-F3 | 不提供硬删 | 界面上不存在"永久删除"入口 |
| FR-F4 | 索引标记 | 删除后条目显示为"已移入回收站"，记录保留 |
| FR-F5 | 失败回执 | 回收站操作失败（如路径在工作区外被沙箱拒绝）时给出明确错误，**不静默失败** ⚠️ |
| FR-F6 | 批量删除 | 支持多选后批量移入回收站，确认信息显示总数 |
| FR-F7 | 恢复提示 | 提示用户"可从系统回收站取回；取回后重新校检即可恢复索引状态" |

### FR-G 标签 / 收藏 / 备注

| 编号 | 需求 | 验收标准 |
|---|---|---|
| FR-G1 | 添加/移除标签 | 在列表内联操作，即时生效 |
| FR-G2 | 标签持久化 | 重启 Host 后标签仍在 |
| FR-G3 | 按标签筛选 | 分类树选中标签后列表正确过滤；多选为并集 |
| FR-G4 | 自动标签规则 | 支持按目录 glob / 扩展名 / 来源对话自动打标（如 `outputs/**` → 交付物） |
| FR-G5 | 收藏 | 一键收藏/取消；分类树"收藏"节点列出 |
| FR-G6 | 备注 | 可为单条产物写一段备注并保存 |

### FR-H 版本聚合 / 失效 / 导出

| 编号 | 需求 | 验收标准 |
|---|---|---|
| FR-H1 | 同一路径折叠 | 同一绝对路径的多次产出折叠为一条，标题旁显示 `×N` |
| FR-H2 | 版本时间线 | 展开后显示各版本的时间、大小、来源会话与轮次 |
| FR-H3 | 失效检测 | 启动时与定期校检文件是否存在；不存在标 `missing` 并在"失效"节点列出 |
| FR-H4 | 清理失效条目 | 提供一键清理失效条目（只清索引记录，不动磁盘） |
| FR-H5 | 清单导出 | 把当前筛选结果导出为 Markdown 或 CSV（含文件名、路径、工作区、对话、时间、大小） |
| FR-H6 | 清单可粘回对话 | 导出的 Markdown 能直接粘贴回 DSH 对话使用 |

### FR-I Agent 工具

| 编号 | 需求 | 验收标准 |
|---|---|---|
| FR-I1 | 注册 `artifact_search` 工具 | 模型可调用；参数：`query`（模糊匹配文件名/内容）、`workspace?`、`type?`、`tag?`、`since?`、`limit?` |
| FR-I2 | 返回结构化结果 | 每条含文件名、绝对路径、工作区、类型、所属对话、轮次、时间、大小 |
| FR-I3 | 工具在无匹配时返回空列表 | 不报错，返回空数组 + 说明 |
| FR-I4 | 工具描述准确 | 描述与实现一致（上架审核会核对） |

### FR-J 设置与配置

| 编号 | 需求 | 验收标准 |
|---|---|---|
| FR-J1 | 配置项经 `cordis.patch.yml` 可改 | 至少暴露：`ignorePatterns`、`burstThreshold`、`maxIndexedFiles`、`previewMaxBytes`、`backfillOnStart`、`snapshotOnTurnEnd`、`enableBetterSidebar` |
| FR-J2 | 配置有默认值且缺省可用 | 不做任何配置即可正常工作 |
| FR-J3 | 索引状态可见 | 面板显示：已索引条目数、最后校检时间、回填进度/错误 |

---

## 4. 非功能需求

| 编号 | 类别 | 要求 | 验收标准 |
|---|---|---|---|
| NFR-1 | **不炸树** | 插件任何失败都不得导致 DSH 启动失败 | 故意制造内部错误时，DSH 仍能启动，插件降级并在状态里报错 ⚠️ |
| NFR-2 | 性能：索引开销 | 单轮快照 diff 不阻塞对话 | 26k 文件工作区单轮快照 < 1 s（实测可达 0.37 s） |
| NFR-3 | 性能：界面 | 面板打开到可用 < 1 s（索引已就绪时） | 冷启动后首次打开面板不出现长时间白屏 |
| NFR-4 | 性能：列表 | 1 万条以上虚拟滚动流畅 | 滚动无明显掉帧 |
| NFR-5 | 安全：路由 | 所有自建 HTTP 路由必须过"浏览器信任围栏" | 跨站请求返回 403 ⚠️ |
| NFR-6 | 安全：路径围栏 | 文件读取与回收站操作只允许已注册工作区内，或显式加入的路径 | 构造工作区外路径请求返回 403 |
| NFR-7 | 安全：删除 | 移入回收站必须二次确认；无任何硬删路径 | 代码中不存在 `rm -rf` / `unlink` 调用 |
| NFR-8 | 兼容 | 同时兼容宿主 0.1.7-rc.2 与 0.2.0-rc.2 | `check-plugin-compat.mjs` 通过 ⚠️ |
| NFR-9 | 体积 | 首屏加载的 client bundle 保持精简 | vendor 大依赖（mermaid）必须懒加载，不进入首屏 bundle |
| NFR-10 | i18n | 界面支持中文与英文 | 切换语言后插件 UI 文案随之变化 |
| NFR-11 | 主题 | 浅色/深色下均正确 | 只用 `--dsw-alias-*` token；两种主题截图对比无异常 |
| NFR-12 | 可访问性 | 交互元素可键盘操作，语义正确 | 开关用 `role="switch"` + `aria-checked`；弹窗焦点与 Escape 行为正常 |
| NFR-13 | 数据可重建 | 索引损坏不丢用户数据 | 删除索引后重建，磁盘文件不受影响 |
| NFR-14 | 依赖洁净 | **不依赖任何 `@deepseek-ai/dsh-client-ui-*`** | `grep -r "dsh-client-ui" client.js` 无 import（除类型注释） |

---

## 5. 数据模型

```ts
/** 一条产物记录（索引主键 = workspaceId + path） */
interface ArtifactRecord {
  id: string                     // hash(workspaceId + ':' + path)
  workspaceId: string
  workspaceTitle: string
  sessionId?: string             // 归属对话
  sessionTitle?: string          // 冗余，避免每次读日志
  turn?: number
  path: string                   // 绝对路径
  relPath?: string               // 相对工作区（在工作区内时）
  ext: string                    // '.docx'
  kind: 'doc'|'sheet'|'slide'|'image'|'web'|'data'|'code'|'media'|'archive'|'other'
  size?: number
  mtime?: number
  source: 'present'|'write'|'edit'|'snapshot'|'manual'
  description?: string           // present 自带
  firstSeenAt: number
  lastSeenAt: number
  versions?: Array<{ turn?: number; sessionId: string; time: number; size?: number }>
  missing?: boolean
  trashed?: boolean
  burst?: boolean                // 爆量轮聚合
  tags?: string[]
  starred?: boolean
  note?: string
}

/** 快照库存：path → [mtimeNs, size]，用于 diff */
interface WorkspaceSnapshot {
  workspaceId: string
  takenAt: number
  entries: Record<string, [number, number]>
}

/** 标签定义 */
interface TagRecord { name: string; color?: string; auto?: { kind: 'glob'|'ext'|'session'; value: string } }
```

**持久化**：`ctx.storageDomain.open({ name: 'artifact-center', version: 1, layout: 'per-record', invalidRecords: 'backup-and-skip', tables: {...} })`。

---

## 6. 界面规格

### 6.1 挂载位置

- 左侧栏图标（`sidebar.panellist`，`order: 60`，id = `artifact-center`）
- 主面板（`main` slot，key = `artifact-center`，**root scope**，无会话也可用）

### 6.2 主面板布局

```
┌──────────────────────────────────────────────────────────────────────┐
│  产物中心   [搜索框________________] [含内容] [时间▾] [刷新] [索引状态] │
├──────────────────┬───────────────────────────────────────────────────┤
│ 分类树（可折叠）  │  排序: 时间▾        共 128 项        [导出▾]      │
│                  ├───────────────────────────────────────────────────┤
│ ▸ 全部产物  128  │  ☐ 文件名   工作区  类型  标签   所属对话  来源 大小│
│ ▸ 最近           │  ─────────────────────────────────────────────────│
│   今天      12   │  ☐ 支付方案.docx  赣数通  docx  [交付]  支付功能…  │
│   7 天      47   │  ☐ 归档.html      赣数通  html  —      数据归档…  │
│   30 天    128   │  ☐ 快照.png       plane   png   —      工作台…    │
│ ▸ 按工作区       │  …                                                │
│   赣数通     84  │                                                   │
│   plane      19  ├───────────────────────────────────────────────────┤
│ ▸ 按类型         │  预览区（可折叠 / 抽屉）                           │
│ ▸ 按标签         │  [ 文件名                    用默认程序打开 ▾ ]     │
│ ▸ 收藏           │  ┌───────────────────────────────────────────────┐│
│ ▸ 失效           │  │            （渲染后的内容）                    ││
│                  │  └───────────────────────────────────────────────┘│
└──────────────────┴───────────────────────────────────────────────────┘
```

### 6.3 交互细则

| 场景 | 行为 |
|---|---|
| 点击文件名 | 右侧（或下方）打开预览 |
| 点击工作区列 | 分类树切到"按工作区 → 该工作区" |
| 点击所属对话 | 跳转到该会话（若可用）；不可用时复制会话 id |
| 悬停所属对话 | 显示轮次、产生时间、来源 |
| 右键 / 更多按钮 | 打开操作菜单（预览 / 打开 / 打开方式 / 定位 / 复制 / 收藏 / 标签 / 查看对话 / 移入回收站） |
| 多选 | 支持 Shift 连续选与 Cmd 多选；选中后出现批量操作条 |
| 双击 | 用默认程序打开 |
| 点击标签胶囊 | 加入筛选条件 |
| 空态 | 说明 + "清除筛选" + 索引进度（若在回填） |

### 6.4 状态与反馈

| 状态 | 表现 |
|---|---|
| 索引回填中 | 顶部进度条（已处理/总数）+ 已索引部分可用 |
| 无任何产物 | 空态插画 + 文案 + "查看索引状态" |
| 文件已失效 | 行内置灰 + `失效` 徽章；打开类操作禁用 |
| 已移入回收站 | 行内置灰 + `已移入回收站` 徽章 |
| 爆量轮 | 单条"批量产出"卡片（如"npm install · 13,090 个文件"），可展开查看分类摘要 |
| 读取失败 | 预览区显示错误 + "用其他应用打开" |
| 索引服务缺失 | 明确提示缺少哪个 DSH 服务，插件其余部分仍可用 |

---

## 7. 配置项

| 配置 | 默认 | 说明 |
|---|---|---|
| `ignorePatterns` | `['.git','node_modules','dist','build','.next','__pycache__','.venv','target','.cache','.dsh']` | 快照 diff 时跳过的目录名 |
| `burstThreshold` | `500` | 单轮变更超过此数折叠为"批量产出" |
| `maxIndexedFiles` | `50000` | 单次回填的条目上限保护 |
| `previewMaxBytes` | `20971520`（20 MB） | 超过则不内嵌预览 |
| `backfillOnStart` | `true` | 启动时回填历史会话 |
| `snapshotOnTurnEnd` | `true` | 每轮结束做快照 diff |
| `enableBetterSidebar` | `true` | 检测到 better-sidebar 时委托其 markdown/mermaid 渲染 |

---

## 8. 验收清单（Definition of Done）

**功能**
- [ ] 左栏出现「产物中心」图标，点击进入主面板（无活动会话时也可用）
- [ ] 回填完成后能检索到**装插件之前**的产物
- [ ] **bash/python 生成的文件能被索引到**（这是本插件的核心技术点）
- [ ] 分类树四个维度（工作区/类型/标签/时间）均可正确过滤
- [ ] 列表七列齐全，且所属对话显示为真实会话标题
- [ ] 图片 / PDF / 文本 / CSV / **Markdown / Mermaid** / HTML / 音视频 面板内可预览
- [ ] Office / 压缩包**不预览**，走打开方式
- [ ] 打开方式：默认程序 / 其他应用 / 文件管理器定位 均可用
- [ ] 移入回收站后可**从 Finder 恢复**
- [ ] 标签 / 收藏 / 备注 持久化且可筛选
- [ ] 版本聚合、失效检测、清单导出可用
- [ ] `artifact_search` 工具可被模型调用并返回正确结果

**非功能**
- [ ] 插件内部错误不会导致 DSH 启动失败
- [ ] 自建路由通过信任围栏（跨站请求 403）
- [ ] 工作区外路径读取被拒
- [ ] `check-plugin-compat.mjs` 通过（两代宿主）
- [ ] 浅色 / 深色主题下显示正常
- [ ] 中英文界面可用
- [ ] 1 万条列表滚动流畅
- [ ] 18 MB 级 HTML 不会卡死浏览器

**交付**
- [ ] `node --check` 全过
- [ ] README（中英）+ LICENSE + THIRD_PARTY_NOTICES（如带 vendor）
- [ ] npm 已发布，仓库已加 `dsh-plugin` topic
- [ ] 已向 awesome-dsh-plugin 提交目录条目 PR

---

## 9. 未决 / 需实测确认的点

编码时应**优先验证**这些——它们就是 **P0 的六条链路**（与 [`plan.zh.md`](plan.zh.md) §10.2 一致）：

1. ⚠️ **最小插件骨架能 boot**：web profile 下安装 + `dsh web --port 0 --no-open` 成功启动（纯 JS、零构建），且 stderr 的 `warning: N entries did not activate` 列表里**没有** `artifact-center`。
2. ⚠️ **左栏入口 + 主面板跑通**：`sidebar.panellist` 图标可见，点击进入 `main` 面板（且无活动会话时也可用）。
3. ⚠️ **会话与对话名可取**：`sessionQuery.listSessions()` / `readTitleSnapshots()` 在插件内可调用（服务已挂载）。
4. ⚠️ **自建字节路由可用**：`/artifact-center/file` 能返回图片与 PDF 字节，且信任围栏生效（跨站请求被拒）。
5. ⚠️ **回收站可用**：`subprocess` + `osascript` 移入回收站在本机可用，并能从 Finder 恢复。
6. ⚠️ **`turn/end` 可监听**：插件能收到该事件并触发一次快照 diff。

**P0 六条全绿之后**才做这一步（最高风险）：

7. ⚠️ 在 **desktop profile** 安装后，DSH 桌面应用仍能正常启动 —— 操作前**务必备份 `~/.dsh/profiles/desktop/package.json`**，并确认自己知道如何从 `dependencies` 与 `dsh.profile.bundles` 两处手工摘除该包。