dsh-mattpocock-skills-deck 1.7.13 → 1.7.15

package/README.md

@@ -1,208 +1,256 @@
-# dsh-mattpocock-skills-deck
-
-> DSH（DeepSeek Harness）Web 界面的 **Matt Skills Deck 控制面板**插件（Client + Host 双端）——**非官方** Matt Pocock 技能套件（mattpocock/skills）配套工具：wayfinder 地图/票务/进度、triage / grilling / handoff 动作注入。
-> **设计理念**：Matt 的 map 拨开迷雾看到终点；本插件再加一层游戏式任务栏——接任务、推进一步、随时存档交接，每一步都清晰可见。
-> **配合 [Matt Pocock skills](https://github.com/mattpocock/skills) 的 wayfinder / triage / grilling / handoff 等技能使用**：
-> 输入区状态栏胶囊（可接/阻塞/沉淀/交接/环境/更新）+ 右侧 details 列面板（列表 / 技能 / 环境检查三视图，
-> 唯一打开形式）+ GitHub issue 动作注入（诊断 / 修复 / 讨论 / 执行，均带 `/wayfinder` `/triage` 技能命令）
-> + 交接开新会话。
-
-- **插件包名**: `dsh-mattpocock-skills-deck`（可分发 npm 包，见 `package/`，当前 **v1.7.13**（`latest`，品牌迁移自 dsh-waystation v1.5.0，`npm view` 已验）：v1.4 详情页（#441）+ v1.5 升级 map 全量落地 —— 状态栏 BUG/诊断过滤 + 设置直达 + 删 panelHeight + Matt 引导 + 新增 wayfinder + 仓库身份 + 双语 + 仓库级缓存架构（git 根检测 → 磁盘缓存秒开 → 自动探测刷新）+ 进度契约与阶段闸门 + 正文格式容错 + markdown 白名单渲染 + 3 项 bug 修复 + T10 自动刷新机制（变化行高亮/即时转圈反馈））
-- **动态版 pluginId**: `wfst-1`（v9–v24 迭代产物）
-- **平台**: Client（浏览器页面）+ Host（Node 进程，gh CLI 数据层）
-- **配套**: [mattpocock/skills](https://github.com/mattpocock/skills)（wayfinder / triage / grilling / handoff / ask-matt 等）
-- **两种形态**: ① 正式安装（npm 一条命令，开机自启，推荐）；② 动态加载（进程内，会话级）
-## 功能
-
-| 模块 | 说明 |
-|---|---|
-| 状态栏胶囊 | 输入区上方：可接 / 阻塞 / 沉淀（零丢失快照）/ 交接 / 环境 / 更新，点击直达对应面板视图 |
-| 面板 · 列表 | GitHub issue 全列表（map 置顶 + 子票迷你圆环进度）、标签过滤 chips（GitHub 配置色）、阻塞筛选、已关闭折叠、行级动作按钮；行布局 = 两行结构（编号/map 竖排 + 标题占满整宽限 2 行 + 标签/按钮行） |
-| 标签贪心折叠 | 单行不换行：宽面板显示多标签、窄面板少标签（最少 1 个），放不下的折叠为 +N 弹窗（fixed 定位 · 自适应面板左右边界 · 内容完整可见） |
-| 进度显示 | map 行右侧 18px 迷你圆环 + n/total（等宽数字右缘对齐，圆环零间隙） |
-| 面板 · 技能 | 技能雷达（推荐 / 列表 / 圆环），点击注入 /skill |
-| 面板 · 环境检查 | 8 项前置检查（仓库定位 / setup / tracker / gh CLI / 登录 / API / 技能探测），红黄绿分组 + 一键处理 |
-| tabs 行 | 列表 / 技能 / 环境检查 + 右侧刷新按钮 + 最右侧版本号（如 v1.7.13），便于核对已更新 |
-| 行级动作 | 按 label 四选一：诊断(/triage) / 修复(/wayfinder) / 讨论(/wayfinder) / 执行(/wayfinder)，按钮色 = GitHub label 配置色，点击预填输入框；执行/新会话按钮常显（复制/外链也常显） |
-| map 详情 | 顶部「执行」+ 任务按状态动作、可接/已认领/被阻塞/已关闭垂直走廊、Decision/Fog/Out-of-scope 折叠 |
-| 交接 | 第一击注入 /handoff 时间戳模板；第二击预填 /read + 复述确认 prompt 并开新会话 |
-| 统一引导句 | 动作注入统一带「从第一性原理出发完成任务，并对抗式审查。」 |
-
-## 使用方式
-
-### 第 0 步：安装 DSH CLI（仅首次 · 一次性）
-
-DSH CLI 提供 `dsh` 命令行工具（用于安装/更新/卸载插件、查看 DSH 状态）。
-本插件的安装/更新/卸载都通过 `dsh` 命令完成。
-
-**推荐一 · npm 全局安装（最常用）**
+<!-- AUTO-GENERATED by scripts/build.mjs — DO NOT EDIT. Source: ../README.md @ v1.7.15 -->
 
-```bash
-npm install -g @deepseek-ai/dsh
-```
+<h1 align="center">dsh-mattpocock-skills-deck</h1>
 
-验证安装成功：
+<div align="center">
 
-```bash
-dsh --version
-# 期望输出类似 dsh@1.0.x 或更新版本
-```
+**中文** · [English](https://github.com/FeatherHunter/dsh-mattpocock-skills-deck/blob/main/docs/README.en.md)
 
-⚠️ 如果 `dsh` 命令找不到（PATH 未配置）：
-- **Windows**：npm 会自动把全局 bin 加到 `%APPDATA%\npm`，重启 cmd/终端即可
-- **macOS / Linux**：可能需要手动加 `$(npm config get prefix)/bin` 到 `~/.bashrc` 或 `~/.zshrc`
+**拨开战争迷雾看见终点，剩下的交给 MattSkillsDeck。**  
+让 [mattpocock/skills](https://github.com/mattpocock/skills) 在 DSH 里化作一块看得见、派得动的任务板。
 
-**推荐二 · 不装 CLI，用 npx 临时跑**（不需要全局装）
+你的 ⭐是我夜空中最亮的星。
 
-```bash
-npx --yes @deepseek-ai/dsh --version
-```
+*Part the fog of war, see the end — MattSkillsDeck handles the rest.*
 
-`npx --yes @deepseek-ai/dsh` 等价于 `dsh`（每次首次会缓存包）。
+[![版本](https://img.shields.io/npm/v/dsh-mattpocock-skills-deck?label=%E7%89%88%E6%9C%AC)](https://www.npmjs.com/package/dsh-mattpocock-skills-deck) [![下载量](https://img.shields.io/badge/dynamic/json?url=https%3A%2F%2Fapi.npmjs.org%2Fdownloads%2Fpoint%2Flast-month%2Fdsh-mattpocock-skills-deck&query=%24.downloads&label=%E4%B8%8B%E8%BD%BD%E9%87%8F&suffix=%2F%E6%9C%88&color=brightgreen)](https://www.npmjs.com/package/dsh-mattpocock-skills-deck) [![最近更新](https://img.shields.io/github/last-commit/FeatherHunter/dsh-mattpocock-skills-deck?label=%E6%9C%80%E8%BF%91%E6%9B%B4%E6%96%B0&color=FE7D37)](https://github.com/FeatherHunter/dsh-mattpocock-skills-deck/commits/main) [![月提交](https://img.shields.io/github/commit-activity/m/FeatherHunter/dsh-mattpocock-skills-deck?label=%E6%8F%90%E4%BA%A4%E6%95%B0&color=DFAB01)](https://github.com/FeatherHunter/dsh-mattpocock-skills-deck/graphs/commit-activity) [![许可证](https://img.shields.io/badge/%E8%AE%B8%E5%8F%AF%E8%AF%81-MIT-lightgrey.svg)](LICENSE) [![技能包](https://img.shields.io/badge/%E6%8A%80%E8%83%BD%E5%8C%85-mattpocock%2Fskills-9D7CD8)](https://github.com/mattpocock/skills) [![期待你参与](https://img.shields.io/badge/%E6%9C%9F%E5%BE%85%E4%BD%A0%E5%8F%82%E4%B8%8E-brightgreen.svg)](https://github.com/FeatherHunter/dsh-mattpocock-skills-deck/issues) [![未来展望](https://img.shields.io/badge/%E6%9C%AA%E6%9D%A5%E5%B1%95%E6%9C%9B-6f42c1.svg)](https://github.com/FeatherHunter/dsh-mattpocock-skills-deck/blob/main/docs/ROADMAP.md)
 
-### 方式一：正式安装（推荐 · 一条命令 · 装进整个 Harness · 开机自启）
+</div>
 
-用 DSH CLI（`dsh`）或 npx 临时命令（跨平台，Windows / macOS / Linux 同一句；
-`~/.dsh` = DSH 的家，`DSH_HOME` 自定义过就换成它的路径）：
+<h2 align="center"><sub>INSTALL</sub><br>安装</h2>
 
-**前置推荐（可选但强烈建议 · 已装可跳过）——[dsh-better-sidebar](https://github.com/omdsh-dev/DSH-better-sidebar)**：VSCode 风右侧边栏，面板在侧边栏并排打开效果最好；不装则回退到右侧 details 列打开。
+<div align="center">
 
-```bash
-dsh plugin --profile desktop add dsh-better-sidebar   # 与插件同一个 profile（web 服务用户换 --profile web）
-```
+前置要求：[DSH](https://www.npmjs.com/package/@deepseek-ai/dsh)（DeepSeek Harness）。在 DSH 里，你下指令、AI 干活；MattSkillsDeck 把这些活变成面板上的任务。
 
-**安装（已装过 DSH CLI）**——`--profile` 必填：装进你实际使用的 DSH 入口对应的 profile，**装错 profile 等于没装**（重启也不会加载）：
+</div>
 
 ```bash
-dsh plugin --profile desktop add dsh-mattpocock-skills-deck   # DSH Desktop 桌面应用（对应 desktop profile，绝大多数人）
-# dsh plugin --profile web add dsh-mattpocock-skills-deck     # 自启 web 服务（dsh web）用户
+# ① 安装 DSH CLI（已装跳过）
+npm install -g @deepseek-ai/dsh
+
+# ② 安装 MattSkillsDeck —— --profile 必填：装进你实际使用的 DSH 入口对应的 profile
+#    （装错 profile 等于没装，重启多少次都不会加载）
+dsh plugin --profile web add dsh-mattpocock-skills-deck     # 用自启 web 服务（dsh web）
+#     或者
+dsh plugin --profile desktop add dsh-mattpocock-skills-deck   # 用 DSH Desktop 桌面应用
+# 锁定最新版更稳（当前 1.7.15）：
+dsh plugin --profile web add dsh-mattpocock-skills-deck@1.7.15 --registry https://registry.npmjs.org
+#     或者
+dsh plugin --profile desktop add dsh-mattpocock-skills-deck@1.7.15 --registry https://registry.npmjs.org
 ```
 
-**安装（未装 DSH CLI，用 npx）**：
+<div align="center">
+
+装完**重启一次对应的 DSH 入口**即生效：桌面应用完全退出并重开 DSH Desktop；web 服务重启 `dsh web` 后刷新页面。零配置。
+
+窄屏用户可顺手把 dsh-better-sidebar 装进同一个 profile，列表与详情并排看。
+
+**👇 装完重启，面板就绪就是这个样子。**
+
+<img src="https://github.com/FeatherHunter/dsh-mattpocock-skills-deck/raw/main/assets/readme/01-install-board-ready.png" width="640" alt="安装成功后任务板就绪的样子" style="border:1px solid #30363d;border-radius:6px">
+
+</div>
+
+<details>
+<summary>进阶安装：免全局、更新不生效、交给 AI</summary>
+
+下面命令以 web profile 为例——**DSH Desktop 桌面应用用户请把所有 `--profile web` 换成 `--profile desktop`**。
 
 ```bash
-npx --yes @deepseek-ai/dsh plugin --profile desktop add dsh-mattpocock-skills-deck   # DSH Desktop 桌面应用
-# npx --yes @deepseek-ai/dsh plugin --profile web add dsh-mattpocock-skills-deck     # 自启 web 服务用户
+# 免全局安装（想更稳，像上面一样锁版本）
+npx --yes @deepseek-ai/dsh plugin --profile web add dsh-mattpocock-skills-deck
+
+# 更新被静默忽略时，显式指定官方源
+dsh plugin --profile web add dsh-mattpocock-skills-deck@latest --registry https://registry.npmjs.org
 ```
 
-**或者：把安装交给你的 AI**（复制下面提示词发给 AI，它会读仓库、检查环境、按需安装，已装步骤自动跳过）：
+复制下面这段发给你的 AI，它会确认 profile、检查环境并按需安装：
 
 ```text
-请帮我安装 DeepSeek Harness 插件 dsh-mattpocock-skills-deck（MattSkills）。
+请帮我安装 DeepSeek Harness 插件 dsh-mattpocock-skills-deck（MattSkillsDeck）。
 先读仓库 README：https://github.com/FeatherHunter/dsh-mattpocock-skills-deck
 先确认我实际使用的 DSH 入口对应哪个 profile（DSH Desktop 桌面应用 → desktop；自启 web 服务 → web），把插件装进正确的 profile；
 然后自行检查环境并按需安装（已装的跳过），完成后简要汇报结果。
 ```
 
-- 命令把插件装进 **指定的 profile**（`~/.dsh/profiles/<profile>/node_modules`），同步该 profile 的 `package.json`
-  并自动 reconcile 注册（bundle 装配）。**各 profile 互相独立、互不同步**——两个入口都想用就各装一次。
-  装完**重启对应的 DSH 入口**生效（桌面应用：完全退出并重开 DSH Desktop；web：重启 `dsh web` 后刷新页面），之后每次 DSH 启动自动加载。
-- 🩺 **装了重启还是没面板？九成是 profile 没对上**：核对 `~/.dsh/profiles/<你的profile>/package.json`——
-  `dependencies` 里应有 `dsh-mattpocock-skills-deck`，且 `dsh.profile.bundles` 数组里应有同名条目。
-  桌面应用当前选中的 profile 见 `%APPDATA%\DSH Desktop\profile-selection\state.json` 的 `"active"` 字段。
-- ✅ **一键装完即用（bundle 装配）**：本包声明 `dsh.bundle.patch`（包根 `cordis.patch.yml`），
-  `dsh plugin add` 自动把包加入 profile 的 `dsh.profile.bundles`，启动时 loadProfile 自动应用——
-  **无构建脚本**（pnpm v10 不再拦截），无需手动编辑任何文件；`dsh plugin remove` 自动移除。
-
-- ⛔ **千万不要用 `npm install --prefix ~/.dsh/profiles` 安装**：`profiles/node_modules` 是 DSH 的
-  **扁平回退软链区**（启动时 `healProfilesModuleFallback` 自动重建，装的是 npx 全家桶），
-  npm `--prefix` 会把它当新项目，把 package.json 未声明的包（含你的插件）**全部 prune 掉**。
-  **2026-08-14 实测事故**：一次安装插件连带删掉 511 个包，DSH 插件全部加载失败。
-  插件正确安装位 = `profiles/web/node_modules`（官方命令负责），注册写 `web/cordis.patch.yml`。
-- 为什么不用 `npm install -g`：`-g` 装到 `%APPDATA%\npm\node_modules`，而 Node 的默认解析链
-  **不包含该目录**（本机实测 `require.resolve` 失败）——DSH 进程 require 不到，装了也白装。
-  独立 CLI 应用（如 `dsh-feishu-bot`）靠 bin 快捷方式运行所以能 `-g`；**插件必须被 DSH 进程
-  解析**，所以装 Harness 自己的 profile。
-
-**升级**（desktop profile 用户把 `--profile web` 换成 `--profile desktop`）：
+</details>
+
+升级 · 卸载（desktop profile 用户把 `--profile web` 换成 `--profile desktop`）：
 
 ```bash
-dsh plugin --profile web update dsh-mattpocock-skills-deck
-# 或用 npx：npx --yes @deepseek-ai/dsh plugin --profile web update dsh-mattpocock-skills-deck
+dsh plugin --profile web update dsh-mattpocock-skills-deck   # 升级
+dsh plugin --profile web remove dsh-mattpocock-skills-deck   # 卸载
 ```
 
-> **⚠️ 更新后仍显示旧版本？（DSH 平台问题，非本插件 BUG）**
-> 这是 **DSH 桌面端**的 `pnpm` 供应链策略 `minimumReleaseAge` 导致——刚发布的新版本会被 `dsh plugin update` / 插件市场的“更新”按钮**静默忽略**（`pnpm update` 不报错但也不更新，需等待数小时）。**更新后请务必完全退出 DSH 再重开，并 Ctrl+F5 刷新页面**才能看到新版本（如 `v1.6.14`）。若刚发布后立即更新仍不生效，请显式执行：
-> ```bash
-> dsh plugin --profile web add dsh-mattpocock-skills-deck@latest --registry https://registry.npmjs.org
-> ```
-> 或等待数小时后重试。此为 DSH 平台行为，已实测复现（`pnpm update` → `Packages: -2` 仍 `1.0.0`；`pnpm add @1.6.14` → `Added 1` 才成功）。
+<h2 align="center"><sub>BOARD</sub><br>任务板列表</h2>
+
+<div align="center">
+
+仓库里的任务不再是流水账：面板把它们按可接、阻塞、已关闭归位，进度走到哪一格一眼看清。每行任务的按钮就是动作入口：点一下，写好的指令填进输入框，确认后再发送。地图类型的行永远置顶，已关闭的收成一行。
+
+**👇 任务在哪看、状态怎么筛，全在这张图。**
+
+<img src="https://github.com/FeatherHunter/dsh-mattpocock-skills-deck/raw/main/assets/readme/02-task-board-list.png" width="640" alt="任务板列表：状态筛选、标签筛选与行动作按钮" style="border:1px solid #30363d;border-radius:6px">
+
+</div>
+
+<h2 align="center"><sub>STATUSBAR</sub><br>底部任务栏</h2>
+
+<div align="center">
+
+每条会话输入框下面都有一条胶囊状态栏：可接数量、待修（BUG）数量、诊断、沉淀、交接、环境进度都在上面。点可接、环境等主要分段，即跳到对应面板页，看完即回，不打断手头会话。
+
+**👇 离手最近的操作条，完整一条长这样。**
+
+<img src="https://github.com/FeatherHunter/dsh-mattpocock-skills-deck/raw/main/assets/readme/03-statusbar-capsule.png" width="720" alt="底部任务栏：输入框下面完整一条胶囊" style="border:1px solid #30363d;border-radius:6px">
+
+</div>
+
+<h2 align="center"><sub>DETAIL</sub><br>ISSUE 详情与评论</h2>
+
+<div align="center">
+
+点开任意一条任务，描述、标签、认领人与评论都在面板里排好版，不用跳终端。在底部输入框直接回话，一般只按标签显示其中一个（诊断、修复、讨论、执行），需要另起再点新会话。
+
+**👇 点开一条任务，看透并回上话。**
+
+<img src="https://github.com/FeatherHunter/dsh-mattpocock-skills-deck/raw/main/assets/readme/04-issue-detail-comment.png" width="640" alt="点开一条任务后的详情与评论区首屏" style="border:1px solid #30363d;border-radius:6px">
+
+</div>
+
+<h2 align="center"><sub>NEW SESSION</sub><br>新会话</h2>
+
+<div align="center">
 
-**卸载**（同样注意 profile 对应）：
+任何活都能另起干净会话干：详情页顶部点新会话，新会话标题自动起好，承接指令已预填，人只管检查后发送。当前会话不受扰，脏活累活都在新会话里。
+
+**👇 点一下新会话，指令已预填等人发。**
+
+<img src="https://github.com/FeatherHunter/dsh-mattpocock-skills-deck/raw/main/assets/readme/05-new-session-prefilled.png" width="640" alt="点新会话后新会话输入框被预填指令的样子" style="border:1px solid #30363d;border-radius:6px">
+
+</div>
+
+<h2 align="center"><sub>SKILLS</sub><br>技能快捷入口</h2>
+
+<div align="center">
+
+随包 25 个技能（快照 v1.2.3）装好即用：面板技能页顶部给通用推荐（默认 /ask-matt），列表一行讲清一个技能的中文用途，点加载就把斜杠指令填进输入框。完整名单与教程见 Matt 官方 [aihero.dev/skills](https://www.aihero.dev/skills)，本插件只讲入口与推荐。
+
+</div>
+
+<h2 align="center"><sub>BACKENDS</sub><br>多后端切换</h2>
+
+<div align="center">
+
+同一个面板可换跑道：设置页后端选择器列出 GitHub、本地 Markdown、GitLab 与 Other（无后端）逃生舱。切换只换数据源：切换后原数据不可见，原后端数据保留，切回来又可见。新人第一次大多只用一条跑道，知道能换即可。
+
+**👇 换跑道不断数据，选择器长这样。**
+
+<img src="https://github.com/FeatherHunter/dsh-mattpocock-skills-deck/raw/main/assets/readme/07-backend-switch.png" width="560" alt="设置页后端选择器四行与来源小胶囊" style="border:1px solid #30363d;border-radius:6px">
+
+</div>
+
+<h2 align="center"><sub>FAQ</sub><br>常见问题</h2>
+
+<details open>
+<summary>更新之后还是旧版本？</summary>
+
+这是 DSH 桌面端的 pnpm 供应链策略（`minimumReleaseAge`）导致的：刚发布的版本，几个小时内 `dsh plugin update` 和插件市场的「更新」按钮都会静默跳过。更新后请完全退出 DSH 再重开，按 Ctrl+F5 刷新页面；还没更新的话，显式指定官方源装一次：
 
 ```bash
-dsh plugin --profile web remove dsh-mattpocock-skills-deck
-# 或用 npx：npx --yes @deepseek-ai/dsh plugin --profile web remove dsh-mattpocock-skills-deck
-# 并手动删除 cordis.patch.yml 里的 dsh-mattpocock-skills-deck insert 块（或保留，DSH 找不到包会忽略）
+dsh plugin --profile web add dsh-mattpocock-skills-deck@latest --registry https://registry.npmjs.org
 ```
 
-> 原理：DSH 的 `dsh.client` 插件机制（`dsh-client-modules`）会扫描组合里声明了
-> `dsh.client: { platform: 'web' }` 的包，把 `exports["./client"]` 指向的 bundle
-> 伺服为 `/plugins/<id>/client.js` 并注入 `window.__DSH_BOOT__`，浏览器内核在启动
-> 时自动挂载该插件条目。宿主半 `lib/index.js` 通过 `ctx.connection.rpc` 注册
-> `/dsws` RPC 通道（gh CLI 数据层），Client 半经同一通道取数。
+**👇 官方源装最新版，成功回显长这样。**
+
+<img src="https://github.com/FeatherHunter/dsh-mattpocock-skills-deck/raw/main/assets/readme/08-faq-stale-version-fix.png" width="640" alt="终端用官方源装最新版的成功回显" style="border:1px solid #30363d;border-radius:6px">
+
+</details>
+
+<h2 align="center"><sub>ARCHITECTURE</sub><br>架构</h2>
+
+<div align="center">
 
-### 方式二：动态加载（零安装 · 会话级 · 重启失效）
+整体结构、数据流与关键状态见 [在线预览](https://featherhunter.github.io/dsh-mattpocock-skills-deck/architecture/MattSkills-architecture.html)或本地 [MattSkills-architecture.html](https://github.com/FeatherHunter/dsh-mattpocock-skills-deck/blob/main/docs/architecture/MattSkills-architecture.html)（克隆后直接打开）。
 
-在 DSH 会话中由 Agent 通过 Cordis 工具链加载：
+</div>
 
-1. `cordis_define` —— plugin 用 `kind: new`、`idPrefix: wfst`，code.host 填入
-   [host.js](./host.js) 的内容、code.client 填入 [client.js](./client.js) 的内容。
-2. `cordis_run` —— 首次运行需在界面批准（安全机制，Client 代码要在页面执行）。
-3. 生效后输入区出现 Matt Skills Deck 胶囊；Run 卡片内出现控制面板。
+<h2 align="center"><sub>DEVELOPMENT</sub><br>开发</h2>
 
-## 数据层说明（宿主半）
+<div align="center">
 
-- 依赖：`gh` CLI（兜底路径 `DSH_GH_PATH` 环境变量（未设置时走系统 `gh`））+ git 仓库工作目录（默认
-  `D:\2Study\StudyNotes\SKILLS`，可随会话 cwd 切换）。
-- 数据流：`gh issue list` 枚举全量 issues（map 列表从中过滤 `wayfinder:map`）→ **GraphQL aliases 一次查询全部 map 详情**（subIssues + labels + assignees + blockedBy）→ 组装快照（map 五区块解析 + tickets + stats）。
-- RPC 通道 `/dsws`：`status` / `snapshot` / `refresh` / `cwd` / `handoffLatest` / `claim`。
-- 刷新策略：纯手动（状态栏「更新」/ 列表「刷新」/ 打开面板即刷）+ **60s 快照缓存**、30s 环境检查缓存。
-- 性能：v1.3.3 起快照加载 ~35s → ~12s（aliases 批量 8 次 GraphQL → 1 次）。
+开发说明（构建、验证、同步、发布）见 [DEV-WORKFLOW.md](https://github.com/FeatherHunter/dsh-mattpocock-skills-deck/blob/main/docs/workflow/DEV-WORKFLOW.md)。
 
-## 作者的其他作品
+</div>
+
+<h2 align="center"><sub>MORE</sub><br>作者的其他作品</h2>
+
+<div align="center">
 
 喜欢这个插件的话，这些可能你也用得上：
 
-- [**dsh-opencode-palette**](https://github.com/FeatherHunter/dsh-opencode-palette) —— 喜欢 opencode 的配色？让 DSH 也穿上它 —— 34 款经典主题，眼睛舒服了，码字也开心。
-- [**dsh-prompt**](https://github.com/FeatherHunter/dsh-prompt) —— 写 Prompt 卡壳的时候，里面有 24 条深度模板，点一下直接进输入框。
+**[dsh-opencode-palette](https://github.com/FeatherHunter/dsh-opencode-palette)** —— 34 款 opencode 经典配色一键换装 DSH，即点即换，重启不丢
+
+**[dsh-prompt](https://github.com/FeatherHunter/dsh-prompt)** —— Prompt 工具箱：24 条深度模板随手点，别再复制粘贴
+
+**[dsh-chinese-skill-patch](https://github.com/FeatherHunter/dsh-chinese-skill-patch)** —— 让 DSH 直接用中文技能名：输入 /私 就能直达「私家大厨」，技能不必改英文名
+
+**[dsh-im-companion](https://github.com/FeatherHunter/dsh-im-companion)** —— 给每个聊天机器人安个家：哪个工作区有助理在管、在不在线一眼看清，拖一下就能搬家
+
+---
+
+有问题、有想法？[提交 ISSUE](https://github.com/FeatherHunter/dsh-mattpocock-skills-deck/issues)，或到 [讨论区](https://github.com/FeatherHunter/dsh-mattpocock-skills-deck/discussions)聊聊
+
+个人作品，与 [mattpocock/skills](https://github.com/mattpocock/skills) 官方没有关系。
+MIT © FeatherHunter
+
+</div>
+
+<h2 align="center"><sub>THANKS</sub><br>致谢</h2>
+
+<div align="left">
+
+感谢每一位提交 Issue、PR 与参与讨论的朋友，是你们让这个插件一点点变好。
+
+[@pioneerAlone](https://github.com/pioneerAlone) — 反馈了 #298（details/better-sidebar 重复，附完整复现与截图）、#274、#234 等状态栏与健康检查误报，并提交了修复 PR #273、#316，感谢你让「重装后到处异常」的体感得以一次清爽修复 🌹
+
+[@Shimmernight](https://github.com/Shimmernight) — 提交了 #277 等 Issue，以及 PR #287、#275、#106（toast 主题、命名修正、macOS 适配）
+
+[@21967201](https://github.com/21967201) — 提交了 PR #321（完善 triage + wayfinder 标签文档）
+
+[@angenet](https://github.com/angenet) — 反馈了 #295、#262 等 macOS 环境检测问题
+
+[@hyperion2144](https://github.com/hyperion2144) — 反馈了 #110 等环境检查问题
+
+[@tafcear](https://github.com/tafcear) — 反馈了 #422（非编码工作区状态栏降噪诉求），感谢你让非编码工作区不再被初始化横幅打扰 🌹
+
+也感谢在评论区与讨论区留下想法的每一位朋友。如果你也遇到了问题或有新想法，欢迎直接提 Issue 或发起讨论。
 
-## v1.3.3 新增（2026-08-15）
+</div>
 
-- 13 项用户 bug 修复（配置面板全展开 / textarea 自适应 / 占用→阻塞 / 按钮常显 / map 完成态 / 双 loading 修复等）
-- UI 逐版定稿：C 卡片式两行结构、编号/map 竖排、18px 迷你圆环进度、标签贪心折叠 +N 弹窗（自适应面板）、窄屏按钮正方形
-- tabs 行刷新按钮 + 最右侧版本号 v1.3.3
-- 快照性能提速 ~35s → ~12s（GraphQL aliases 批量 + 合并 fetchMaps + 缓存 60s）
-- 开发工作流文档 DEV-WORKFLOW.md（改 bug → 实时生效完整流程）
+<h2 align="center"><sub>CONNECT</sub><br>加入我们</h2>
 
-## v1.5.0 新增（2026-08-16/17）
+<div align="center">
 
-- 状态栏「BUG / 诊断」一键过滤（带计数）+ 设置左侧直达 + 删「面板默认高度」
-- Matt 技能安装引导（设置页 + 环境检查页）+「新增 wayfinder」按钮（prompt 带仓库信息）+ 仓库身份组件
-- 全量中英双语 + 进度契约（## 进度：N%）与阶段闸门（needs-triage 前置诊断）
-- 仓库级缓存数据架构：git 根上溯检测 → 宿主磁盘缓存 → 打开/重启秒开 → 自动探测刷新（probe + 轮询 + focus + 动作后）
-- 正文格式容错自愈（字面 \n + BOM 还原）+ 正文格式契约 + issue 正文 markdown 白名单渲染
-- 3 项 bug 修复（setup 误报 / 新会话 prompt 缺 issue 标识 / 完成态按钮配色）+ 手动刷新去遮罩（按钮即时转圈反馈 · 文字恒定）+ 变化行高亮/新增绿闪/删除提示
+扫码加入话题群——二维码永久有效。日常闲聊与快速答疑走群里，Bug 与需求请直接提 ISSUE，更高效可追溯。
 
-完整变更历史见 [CHANGELOG.md](./CHANGELOG.md)。
+<img src="https://github.com/FeatherHunter/dsh-mattpocock-skills-deck/raw/main/assets/qr-topic-group.png" width="280" alt="扫码加入话题群，dsh-mattpocock-skills 的组织">
+<br>
+<strong>加入话题群</strong>
+<br>
+<sub>dsh-mattpocock-skills · 该二维码永久有效</sub>
 
-## 文件
+</div>
 
-- `host.js` / `client.js` —— 动态版源码（cordis_define 的 `code.host` / `code.client` 函数体）
-- `package/` —— **可分发插件包**（正式安装用，标准 npm 包结构）
-  - `package.json` —— 包声明：`dsh.client`（platform web / immediately）+ `dsh.bundle.patch`（装配）
-  - `cordis.patch.yml` —— bundle 装配 patch（`dsh plugin add` 自动应用，无构建脚本）
-  - `lib/index.js` —— 宿主半（ESM：gh 数据层 + `/dsws` RPC 通道注册）
-  - `lib/client.js` —— 浏览器半 bundle（`window.__ModuleLoader__.load` 注册格式）
-- `README.md` —— 本说明
-- `issues-checklist.html` —— 迭代需求清单（v9–v24，43+ 项）
-- `DESIGN.md` / `prototype.html` —— 设计定稿与原型
-- `tests/` —— host 逻辑测试（verify-status / verify-panel）
+<div align="center">
 
-## 备注
+<a href="https://featherhunter.github.io/dsh-mattpocock-skills-deck/star-history.html">
+  <picture>
+    <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/FeatherHunter/dsh-mattpocock-skills-deck/main/docs/star-history-dark.svg?v=20260905" />
+    <source media="(prefers-color-scheme: light)" srcset="https://raw.githubusercontent.com/FeatherHunter/dsh-mattpocock-skills-deck/main/docs/star-history-light.svg?v=20260905" />
+    <img alt="Star History Chart" src="https://raw.githubusercontent.com/FeatherHunter/dsh-mattpocock-skills-deck/main/docs/star-history-light.svg?v=20260905" />
+  </picture>
+</a>
 
-- 若动态版（方式二）与正式安装版同时生效，两套 UI 会同时出现（同名插槽注册），
-  建议保留正式安装版即可，动态版 `cordis_stop` 掉。
-- 本插件需要 GitHub 仓库工作目录（wayfinder 地图仓库）才能取到数据；
-  非仓库目录下环境检查会提示「仓库定位」未就绪。
-- 用户界面偏好（开始模板等）存浏览器 localStorage，与动态版共用同一 key。
+</div>

package/lib/bootstrap.js

@@ -0,0 +1,207 @@
+// src/host/bootstrap.js —— 启动技底与技能名单（H1 #445 从 host/index.js 31–215/235–249 搬出，纯结构、行为零变化）
+// 以后谁改它：改启动装配、兜底技能 provider 或技能名单惰性加载的人。预估约 250 行，超 350 打回。
+// 接线：由 index.js 动态 import 动态加载，依赖全显式传入（仅 ctx）；本文件不引用其他新文件。
+export function createBootstrap(deps) {
+  const { ctx } = deps
+    // === T2 #389 bundled 兜底 provider（rank 600，trustedHost，ctx.effect 托管）===
+    // 零代码声明：无需 env 晚置，直接 registerProvider；list 返回 package/bundled-skills 的 25 个，rank 600 兜底，bundled 随包消失
+    // 选择 provider 而非 env 的依据见 R1 研究（env 构造时一次性读，晚置失效）；参见 docs/adr/20260828-skill-probe-union-channels.md 的 trustedHost 约束
+    ;(() => {
+      try {
+        const skills = ctx.get('skills')
+        if (!skills || typeof skills.registerProvider !== 'function') return
+        ;(async () => {
+          let bundledDir = null
+          try {
+            const pathMod = await import('node:path')
+            const fsSync = await import('node:fs')
+            const osMod = await import('node:os')
+            const candidates = []
+            const cwd = (typeof process !== 'undefined' && typeof process.cwd === 'function') ? String(process.cwd() || '') : ''
+            if (cwd) {
+              candidates.push(pathMod.resolve(cwd, 'package/bundled-skills'))
+              candidates.push(pathMod.resolve(cwd, '../package/bundled-skills'))
+              candidates.push(pathMod.resolve(cwd, '../../package/bundled-skills'))
+              candidates.push(pathMod.resolve(cwd, 'bundled-skills'))
+              let cur = cwd
+              for (let i = 0; i < 4; i++) {
+                candidates.push(pathMod.join(cur, 'package/bundled-skills'))
+                candidates.push(pathMod.join(cur, 'node_modules/dsh-mattpocock-skills-deck/bundled-skills'))
+                cur = pathMod.dirname(cur)
+              }
+            }
+            try {
+              const home = osMod.homedir()
+              if (home) {
+                candidates.push(pathMod.join(home, '.dsh/profiles/web/node_modules/dsh-mattpocock-skills-deck/bundled-skills'))
+                candidates.push(pathMod.join(home, '.dsh/profiles/desktop/node_modules/dsh-mattpocock-skills-deck/bundled-skills'))
+                try {
+                  const profilesDir = pathMod.join(home, '.dsh/profiles')
+                  const entries = await (await import('node:fs/promises')).readdir(profilesDir, { withFileTypes: true }).catch(() => [])
+                  for (const e of entries) if (e.isDirectory()) candidates.push(pathMod.join(profilesDir, e.name, 'node_modules/dsh-mattpocock-skills-deck/bundled-skills'))
+                } catch {}
+              }
+            } catch {}
+            const seen = new Set()
+            const uniq = []
+            for (const c of candidates) {
+              const n = pathMod.normalize(c)
+              if (!seen.has(n)) { seen.add(n); uniq.push(n) }
+            }
+            for (const cand of uniq) {
+              try {
+                const st = fsSync.statSync(cand)
+                if (st && st.isDirectory()) {
+                  try {
+                    const way = pathMod.join(cand, 'wayfinder', 'SKILL.md')
+                    const wst = fsSync.statSync(way)
+                    if (wst && wst.isFile()) { bundledDir = cand; break }
+                  } catch {}
+                  try {
+                    const ents = fsSync.readdirSync(cand, { withFileTypes: true })
+                    const dcount = ents.filter(e => e.isDirectory()).length
+                    if (dcount >= 20) { bundledDir = cand; break }
+                  } catch {}
+                }
+              } catch {}
+            }
+          } catch (e) { bundledDir = null }
+          if (!bundledDir) {
+            try { ctx.get('logger')?.warn?.('[bundled] dir not found, skip provider') } catch {}
+            return
+          }
+          function parseSkillRaw(raw) {
+            try {
+              const s = String(raw || '').replace(/^/, '')
+              const m = s.match(/^---\s*\r?\n([\s\S]*?)\r?\n---/)
+              if (!m) return undefined
+              const front = m[1]
+              const body = s.slice(m[0].length)
+              const getField = (key) => {
+                const re = new RegExp('^\\s*' + key.replace(/-/g, '\\-') + '\\s*:\\s*(.+)$', 'm')
+                const mm = front.match(re)
+                if (!mm) return undefined
+                let v = mm[1].trim()
+                if ((v.startsWith('"') && v.endsWith('"')) || (v.startsWith("'") && v.endsWith("'"))) v = v.slice(1, -1)
+                return v.trim()
+              }
+              const name = getField('name')
+              const description = getField('description')
+              if (!name || !description) return undefined
+              const whenToUse = getField('whenToUse')
+              const parseBool = (val) => {
+                if (val === undefined) return undefined
+                const l = String(val).toLowerCase().trim()
+                if (l === 'true' || l === 'yes' || l === 'on' || l === '1') return true
+                if (l === 'false' || l === 'no' || l === 'off' || l === '0') return false
+                return undefined
+              }
+              const disableModel = parseBool(getField('disable-model-invocation'))
+              const userInv = parseBool(getField('user-invocable'))
+              const invocation = { modelInvocable: disableModel !== true, userInvocable: userInv !== false }
+              return { name, description, whenToUse: whenToUse || undefined, invocation, body: body.trim(), content: body.trim() }
+            } catch { return undefined }
+          }
+          function isValidSkillName(n) { try { return /^[\p{L}0-9]+(?:-[\p{L}0-9]+)*$/u.test(n) } catch { return /^[a-z0-9]+(?:-[a-z0-9]+)*$/i.test(n) } }
+          const BUNDLED_RANK = 600
+          const PROVIDER_NAME = 'bundled-mattpocock'
+          const createBundledProvider = (control) => {
+            return {
+              name: PROVIDER_NAME,
+              async list(opts) {
+                try {
+                  const fsp = await import('node:fs/promises')
+                  const pathMod2 = await import('node:path')
+                  if (opts && opts.signal && opts.signal.aborted) throw opts.signal.reason
+                  let entries = []
+                  try { entries = await fsp.readdir(bundledDir, { withFileTypes: true }) } catch { return [] }
+                  const out = []
+                  for (const ent of entries) {
+                    if (!ent.isDirectory()) continue
+                    const dirName = ent.name
+                    if (!isValidSkillName(dirName)) continue
+                    const mdPath = pathMod2.join(bundledDir, dirName, 'SKILL.md')
+                    try {
+                      const raw = await fsp.readFile(mdPath, 'utf8')
+                      const parsed = parseSkillRaw(raw)
+                      if (!parsed) continue
+                      if (parsed.name !== dirName) continue
+                      out.push({
+                        name: parsed.name,
+                        description: parsed.description,
+                        ...(parsed.whenToUse ? { whenToUse: parsed.whenToUse } : {}),
+                        invocation: parsed.invocation,
+                        source: 'bundled',
+                        provider: PROVIDER_NAME,
+                        rank: BUNDLED_RANK,
+                        locator: { path: mdPath, directory: pathMod2.join(bundledDir, dirName) },
+                        resourceBase: { kind: 'directory', path: pathMod2.join(bundledDir, dirName) },
+                        path: mdPath
+                      })
+                    } catch {}
+                  }
+                  out.sort((a, b) => a.name.localeCompare(b.name))
+                  return out
+                } catch (e) {
+                  try { ctx.get('logger')?.warn?.('[bundled] list failed: ' + String(e && e.message || e)) } catch {}
+                  return []
+                }
+              },
+              async get(candidate, opts) {
+                try {
+                  const fsp2 = await import('node:fs/promises')
+                  if (opts && opts.signal && opts.signal.aborted) throw opts.signal.reason
+                  const loc = candidate && candidate.locator ? candidate.locator : null
+                  const p = (loc && loc.path) ? loc.path : (candidate && candidate.path) ? candidate.path : null
+                  if (!p) return undefined
+                  let raw
+                  try { raw = await fsp2.readFile(p, 'utf8') } catch { return undefined }
+                  const parsed = parseSkillRaw(raw)
+                  if (!parsed) return undefined
+                  if (parsed.name !== candidate.name) return undefined
+                  const dir = loc && loc.directory ? loc.directory : (await import('node:path')).dirname(p)
+                  if (opts && opts.signal && opts.signal.aborted) throw opts.signal.reason
+                  return {
+                    name: parsed.name,
+                    description: parsed.description,
+                    ...(parsed.whenToUse ? { whenToUse: parsed.whenToUse } : {}),
+                    invocation: parsed.invocation,
+                    source: 'bundled',
+                    provider: PROVIDER_NAME,
+                    resourceBase: { kind: 'directory', path: dir },
+                    path: p,
+                    content: parsed.content
+                  }
+                } catch { return undefined }
+              }
+            }
+          }
+          let dispose = null
+          try {
+            dispose = skills.registerProvider(createBundledProvider)
+            try { ctx.effect(() => () => { try { dispose && dispose() } catch {} }) } catch {}
+            try { ctx.get('logger')?.info?.('[bundled] provider registered at ' + bundledDir + ' rank ' + BUNDLED_RANK) } catch {}
+            console.log('[bundled] provider registered at ' + bundledDir + ' rank ' + BUNDLED_RANK + ' (25 skills expected)')
+          } catch (e) {
+            try { console.warn('[bundled] registerProvider failed ' + String(e && e.message || e)) } catch {}
+          }
+        })()
+      } catch {}
+    })()
+    // 技能名单（#280 单一真源：与 check-catalog + client SKILLS 同步；拼写以真实目录为准，B 语义由 skills.get 覆盖）
+    // 真源 = shared/matt-skills.js（MATT_SKILL_PROBE_NAMES）。本字段由 getMattSkillProbeNames() 惰性加载。
+    let SKILL_PROBE_NAMES = null
+    async function getMattSkillProbeNames() {
+      if (SKILL_PROBE_NAMES) return SKILL_PROBE_NAMES
+      try {
+        const m = await import('../shared/matt-skills.js')
+        SKILL_PROBE_NAMES = (m && (m.MATT_SKILL_PROBE_NAMES || m.default?.MATT_SKILL_PROBE_NAMES)) || null
+        if (!SKILL_PROBE_NAMES) throw new Error('shared/matt-skills.js 未导出 MATT_SKILL_PROBE_NAMES')
+      } catch (e) {
+        // 兜底：内联一份与真源一致的常量（仅在 shared 文件丢失时使用；CI/构建必须保证真源在场）
+        SKILL_PROBE_NAMES = ['ask-matt','code-review','codebase-design','diagnosing-bugs','domain-modeling','grill-with-docs','implement','improve-codebase-architecture','prototype','research','resolving-merge-conflicts','setup-matt-pocock-skills','tdd','to-spec','to-tickets','triage','wayfinder','wizard','grill-me','grilling','handoff','teach','to-questionnaire','wait-what','writing-for-agents']
+      }
+      return SKILL_PROBE_NAMES
+    }
+  return { getMattSkillProbeNames }
+}