# 截图清单 Screenshot manifest

> **状态：待补（0/3）** —— 本目录目前**只有这份说明，没有任何 `.png`**。
> 截图必须在真实运行中的 DSH GUI 里人工截取：**不允许合成、拼贴、或从旧版本挪用**。
> 目录站 `deepseek-harness-plugin.com` 会自动抓取本目录下的 `*.png` 并渲染到详情页，
> 所以**图必须是当前版本的真实界面**——放错图比不放图更伤信任。

---

## 一、为什么必须人工截

本插件是**宿主 UI 插件**：面板由 DSH 主窗口通过官方席位（`sidebar.panellist` + `main`）渲染，
样式全部读宿主设计 token，因此**长得像 DSH 本身**。

这意味着截图**无法**在无头浏览器 / 静态页面里复现——`ui/index.html` 是**兜底管理页**（旧形态），
拿它截图会与用户实际看到的面板**不一致**，属于事实性错误。所以：

- ❌ 不要用 `ui/index.html` 截图冒充面板
- ❌ 不要用 `~/.dsh/scratch/*.png` 里的历史调试图
- ✅ 必须开真实 DSH Web GUI，点左侧栏 🐋「产物库」，再截

---

## 二、三张必交图

命名固定（目录站按文件名排序展示，数字前缀别改）：

| # | 文件名 | 内容 | 尺寸 | 状态 |
|:-:|:---|:---|:---|:-:|
| 1 | `01-directory.png` | **目录视图** —— 文件管理器形态，逐层浏览 | 1941×1243 | ⬜ 待补 |
| 2 | `02-search.png` | **文件搜索** —— Everything 语法搜索出结果 | 1941×1243 | ⬜ 待补 |
| 3 | `03-cards.png` | **卡片视图** —— 产物卡片 + 详情/星级 | 1941×1243 | ⬜ 待补 |

**尺寸**：优先 **1941×1243**（宿主窗口实际分辨率，文档站会等比缩放，清晰度最好）。
若屏幕放不下，退而用 **1440×900**；三张**保持一致**，避免详情页里图片高低参差。

---

## 三、每张图具体截什么

### 1. `01-directory.png` — 目录视图

**怎么到那**：左侧栏 🐋「产物库」→ 顶部视图切换 → **「目录」** → 展开到至少第二层。

画面里必须能看清（这几项正是 v0.7.0 的卖点，别裁掉）：

- [ ] **面包屑路径**在顶部（行内不复读路径——这是本版的关键设计）
- [ ] 行是**紧凑行高**（32px），不是旧版 110px 的大卡片
- [ ] **按类型着色的文件图标**（文件夹琥珀色 / 代码 DeepSeek 蓝 / 图片紫 …）
- [ ] 目录在前、文件在后，且显示 **「N 项」**
- [ ] 列：文件名 · 大小 · 修改时间，数值右对齐
- [ ] 悬停某一行时**操作按钮出现**（打开 / 定位 / 登记）

⚠️ 截之前**确认窗口够宽**（≥1200px），否则列被挤掉，看起来像半成品。

### 2. `02-search.png` — 文件搜索

**怎么到那**：同一面板 → 视图切换 → **「文件」** → 首次点「启动文件索引」，等就绪 → 输入关键词。

必须体现：

- [ ] 搜索框里有**真实的 Everything 语法**（例如 `ext:md path:项目`），占位符不算
- [ ] **命中条数**和**索引范围**在界面上如实显示（这是隐私卖点，别裁）
- [ ] 至少 3 条**跨目录**的命中结果，**两行式**（文件名 + 次级路径）
- [ ] 一行 hover 出的「登记」按钮

⚠️ **不要**截索引还没就绪的「启动中」画面 —— 那是等待态，不是能力展示。
⚠️ 图上**不要**出现真实私人路径。用工作区/示例目录，或事后**整行打码**（不要整张涂黑）。

### 3. `03-cards.png` — 卡片视图

**怎么到那**：面板视图切换 → **「卡片」** → 鼠标悬停或点开一条带图片/文本的产物。

必须体现：

- [ ] ≥4 张产物卡片：**标题 + 摘要 + 项目 + 标签**（证明 AI 精化真的填进去了）
- [ ] 至少一张有**缩略图预览**
- [ ] **星级**控件可见（有打过分）
- [ ] 顶部**统计条**（总数 / 待精化 / 项目数）

⚠️ 卡片内容若含隐私，替换成示例数据，**不要**只做马赛克。

---

## 四、截完自检

- [ ] 三张**同一主题**（全深色 或 全浅色，别混）
- [ ] 三张**同一窗口宽度**、同一缩放级别（建议 100%）
- [ ] PNG **未二次压缩成糊图**；文字在 100% 缩放下可读
- [ ] 图上没有：`ALF-PROBE` 红色诊断条、`localhost` 调试条、编辑器光标、通知弹窗、私人文件名
- [ ] 文件名**逐字符**等于上表（`01-directory.png`，不是 `01_directory.png` / `01-directory.PNG`）
- [ ] 提交前把本节状态从 **0/3** 改成 **3/3**

> 诊断条提示：客户端那条红色 `ALF-PROBE` 只在页面 URL 带 `alfdebug` 时才会画出来
> （`lib/client.js` 的 `apply()`），正常截图不会出现。**如果它出现了**，说明你开的 URL
> 带了调试参数——把参数去掉再截。