dsh-plugin-guide 0.3.42 → 0.4.0

package/references/official-plugin-dev-skill.md

@@ -1,124 +0,0 @@
-# 官方自带插件开发技能（references/official-plugin-dev-skill.md）
-
-> **这是什么**：DeepSeek Harness 自带的 preset（`packages/preset/agent-preset/`）里有一整套**官方插件开发技能**，是 0.2 世代最重要的新增资料——它描述的正是"在当前 Harness 里、由 agent 自己写并安装插件"的官方流程。
-> **本文件性质**：**要点摘录 + 原文定位**（不是逐字全文；逐字全文随官方文档副本一起在 `references/official-docs/` 之外的仓库路径，需 checkout 才能读）。凡写"官方明确"的地方都能在上游文件里逐字查到。
-> **基线**：`d743267388641bc76f17c45ce8b4c231aed1d32c`（`dsh-v0.2.1-alpha.2`，2026-10-09）。升级宿主后若与上游冲突，以上游为准。
-> **上游路径**（在 checkout 里，如 `D:\deepseek-harness`）：`packages/preset/agent-preset/skills/`
-
-## 1. 四个技能与各自职责
-
-| 技能 | 职责 |
-|---|---|
-| `cordis-plugin-development/SKILL.md` | 主流程：设计/评审/启用/安装/配置/调试插件、bundle、页面、面板、工具、MCP 连接 |
-| `cordis-plugin-development/references/{host-plugin,ui-plugin,mcp-bundle,practices,user-actions,verification}.md` | 六份分面参考（见 §3） |
-| `cordis-plugin-development/templates/{decoration,mcp}/**` | 可直接复制的 UI 插件模板与 MCP bundle 模板（含 locale 与 icon） |
-| `cordis-composition-reference/SKILL.md` | Loader patch 方言 + 可安装插件包清单 |
-| `editing-cordis-compositions/SKILL.md` | agent preset 组合的编辑流程 |
-| `agent-experience/SKILL.md` | 面向"模型体验"的写作/设计约束 |
-
-## 2. 主流程（`cordis-plugin-development/SKILL.md` 的硬性规定）
-
-**安装方式（官方唯一推荐）**：在工作区用普通文件写 bundle，然后用 **`plugin_manager` 工具的 `install_bundle`**，`target` 传**绝对包目录**装进当前 profile。改动对该 profile 的**所有会话**生效并跨重启保留。
-
-**官方明确禁止**（原文禁止项，逐条）：
-- 不写 profile 的 `package.json`；
-- 不写 profile 的 `cordis.patch.yml`；
-- **不在 profile 目录里跑 pnpm**；
-- 不在 `$DSH_HOME` 下创建包。
-
-理由：`install_bundle` 会做这些步骤，而"profile 之外的每一次手写都需要单独审批"。另外 `plugin_manager` 的每个动作（**包括 `list_plugins` / `list_bundles`**）在没有 Full access 时也需要审批，所以**只在结果决定下一步时才调**。
-
-**"先交付能跑的插件"五步**：
-1. 先定结果与落点。未指定的可视落点＝当前 Harness Web UI；独立图片文件或 HTML **不算**完成。先实现一个小的第一版并**先装上**，再做视觉打磨。
-2. **只查这一版需要的 API**：先 `cordis_inspect_list`，再有针对性地 `cordis_inspect_query`。UI 类要查 Client 的 `Slots.listSubTree` 与目标 slot 的注册选项/props；超出静态装饰（工具策略、agent 上下文、会话派生状态、Chat 行）要先读 `references/practices.md`；涉及用户动作再读 `references/user-actions.md`。**选定 slot 与注册 API 之后才开始写代码。**
-3. 复制匹配的模板文件到一个工作区目录，或直接在工作区写包/patch/必需的 Host·Client 文件。装之前**完成 `references/host-plugin.md` 的展示清单**（本地化标题/描述、原创或有许可的图标、按需导出资源与分发校验）——Host-only 与纯配置 bundle 同样适用。然后检查 JS 语法与清单，安装。**不要先做预览 HTML、mock 壳、design 变体、截图脚本或栅格化工具**。
-4. 读安装结果：**`application` 与 `warnings` 决定改动是否生效**——不是日志、进程列表，也不是页面的 boot payload。用**免审批**的 `cordis_inspect_query` 确认新行，而不是 `list_plugins`。`application: applied` 之后，实际用一下能力，或检查实时 Client 注册。
-5. 在同一插件里修掉观察到的缺陷；请求的结果能用就收尾，报告位置、验证状态与任何展示资源例外的理由。**不要继续做投机变体、可选功能或 mock 预览。**
-
-**知识来源的优先级（官方顺序）**：
-1. **inspection**——`cordis_inspect_query` 回答精确的 Service 方法、Event 模式（`Service`/`Event`）、已挂插件的 Config JSON Schema（`Config.listConfigs`：先按 `name` 过滤分页目录，再查 `entry` id）、本 Agent 可调用的 Tool（`Tool`）、实时 Client Slots 与主题 token（`Slots`/`Theme`）。
-2. **包文档**——`Config.listConfigs` 带 `name` 找到该包的 entry，查一个 `entry` 会返回 `packageDir`；读 `<packageDir>/README.md`。bundle 包从 dsh 安装位置解析、profile 安装的 bundle 从 profile 解析，**不要**从 `$DSH_PROFILE_DIR` 猜路径。
-3. **源码**——已安装包只带构建后的 `lib/index.js` 与 `lib/types/**/*.d.ts`（含 JSDoc），**没有 `src/`**；源码 checkout 才有 `packages/<group>/<name>/src`。先看 inspection 与 README，再从具体的安装/运行失败出发做源码级诊断。
-
-**环境变量**：profile 启动的 Harness 在每次 shell 调用里都设置 `DSH_PROFILE`（profile 名）与 `DSH_PROFILE_DIR`（其目录，`node_modules` 只含 profile 安装的 bundle）；**不以 profile 启动时不设置**。Bash 读 `$DSH_PROFILE`，Windows preset 用的 PowerShell 读 `$env:DSH_PROFILE`。`dsh --profile "$DSH_PROFILE" --dump-config` 打印组合后的 profile。
-
-**Desktop 下的读取限制（官方警告）**：Desktop 里该技能目录位于 `app.asar` 内，**只有 Host 进程自己的文件读取**能打开它；shell 命令（`ls`/`cat`/`cp`/`cmp`）、glob 与搜索工具（走原生 ripgrep 进程）、`node`、pnpm **全部失败**。**永远不要就地安装或语法检查模板**——先把模板内容复制到工作区。
-
-**启用随包发布但默认关闭的插件**：行 id 与原因写在随包 patch（源码 checkout 的 `packages/bundle/*/cordis.patch.yml`）里。写一个工作区 bundle，用 patch 覆盖该行为 `disabled: false`，并把它依赖的 Host 行一起插入；源码 checkout 的 `apps/cli/config/examples/<feature>/cordis.yml` 会列出这些行。**随 dsh 发布的包从 dsh 安装位置解析，所以这种 bundle 不声明对它们的依赖。**
-
-## 3. 六份分面参考的要点
-
-### 3.1 `host-plugin.md` — bundle 与 Host 插件
-
-- 最小 Host-only bundle **不需要依赖、安装脚本或构建步骤**：
-  ```json
-  { "name": "@local/my-plugin", "version": "1.0.0", "private": true, "type": "module",
-    "exports": { ".": "./index.js" }, "dsh": { "bundle": { "patch": "./cordis.patch.yml" } } }
-  ```
-- **展示元数据与图标清单**（Plugin Manager / Settings 在**不激活**插件的前提下读取）：`locale/en.json` 里写 `meta.title`/`meta.description`，并按用户语言补 `locale/zh.json` 等；图标须原创或有再分发许可、保留署名；导出 `./locale/*.json` 与 `./icon`，并把 patch、locale、图标与**每个运行时文件**都放进 `files`。**本地目录安装链接的是 checkout，`files` 不过滤链接目录**——要直接检查文件。图标支持 SVG/PNG/JPEG/WebP，**≤ 256 KiB**，且 realpath 之后必须仍在包内（绝对路径、URL、指向包外的 symlink 都被拒）。**文件名合规不等于字节能渲染。**
-- 包根插件也可以在 `package.json` 顶层写 `icon`（优先于 `./icon`，路径相对清单目录）。**子路径插件（如 `my-plugins/search`）不是包，永远不读 `package.json`**——它导出 `./search/locale/*.json` 与 `./search/icon`。
-- Host 插件导出形态（**不要混用**）：`export function apply(ctx, config) {}` + 可选 `export const inject = ['tools']` + `export const Config`；或者一个 **service class 作为 default export**。所有资源都在 `apply` 里用 `ctx.effect`/`ctx.on` 注册并返回清理函数。声明了 `Config` 的插件会在激活时校验该行的 `config`——**写 config 之前先查 `Config.listConfigs` 拿 schema，并跟进返回文档里的 `$defs` 引用**。
-- 安装/启用/观察：`install_bundle` 负责包安装与 bundle 选择，**不要用 shell 复现**；只有用户明确批准了报告出来的 pending build 脚本后才传 `approvedBuilds`。`list_plugins`/`list_bundles` 给出精确标识符，`set_plugin`/`set_bundle` 开关，`remove_bundle` 移除。**分开看"保存状态"与"激活结果"**：`failed` 要诊断，`overridden` 表示更高优先层胜出，`restart-required` 表示**未生效**。新装 bundle 可以经 HMR 激活；**替换已安装包需要重启**才能载入新的 JS 模块代。
-
-### 3.2 `ui-plugin.md` — Web 页里的 UI 插件
-
-- 读 `templates/decoration/` 并把文件写进你的 bundle 目录：它的 `package.json` 在 bundle patch 之外加 **`dsh.client` 段**（`platform`/`immediately`/`inject`）与 **`./client` 导出**。`index.js` 导出 `export function apply() {}`；patch 插入一行，行名即包名。
-- 简单绘图优先选**已分配空间**的 slot，如 `conversation.composer.dock`；第一版就留在这个 slot 的流内，**不要**围绕宿主控件规划运动轨迹。只有需要覆盖层且落点已知时才用 `shell.overlay`。
-- 浏览器产物注册一个**懒工厂，其 id 等于包名**。React 来自浏览器模块表——**不需要**第二份 React、CDN script 或 UMD 查找。编译型源码用部署自带的 Client 构建工具产出该格式；非基线运行时 import 在 `dsh.client.external` 里声明。
-- `templates/decoration/client.js` 通过 `ctx.slots.inject` + `ctx.slots.register` 把懒工厂注册进 `conversation.composer.dock`；换 slot 时按 `Slots.listSubTree` 给出的 props/options 来写。
-- **工厂保持无副作用**：样式、定时器、监听器等资源在 `apply` 里用 `ctx.effect`/`ctx.on` 注册并返回清理函数；组件局部样式渲染成 React 元素，卸载即移除。容器与控件继承宿主主题；只有 artwork 可以用自己的配色。**可见文案走 Client locale 服务。不要替换 app root，也不要往 `document.body` 追加第二个应用。不要读别的插件的 DOM、样式表或组件源码去猜位置——选一个已经分配好空间的 slot。**
-
-### 3.3 `mcp-bundle.md` — 接一个 MCP server
-
-- 纯配置 bundle：清单只要有唯一 name、version 与 `dsh.bundle.patch`，**不需要** Host/Client 入口文件。patch 插入**已安装的** `@deepseek-ai/dsh-mcp-client`，配 `serverName`、`transport: streamable-http`、`url`、`failOnStartupError: true`。
-- 换掉 endpoint、经 `plugin_manager` 装好，然后调 `mcp__demo__ping` 之类新出现的 `mcp__<serverName>__<tool>` 验证。
-- stdio 用 `transport: stdio` + `command` + 可选 `args`/`env`/`cwd`；`Config.listConfigs` 查已装行会返回完整 client schema。**环境凭据会被清洗**：用 Loader 的 `!!js` 引用已有凭据，**不要把密钥粘进对话文本**。失败时**修同一个 bundle，不要造重复的**。
-
-### 3.4 `practices.md` — 插件实践总纲（最值得先读的一份）
-
-**六条原则**
-1. **会话日志是唯一真源**：模型看到的一切都必须能从已提交的会话事件重建；fork/resume/replay 都从日志派生。**插件内存只是派生缓存。**
-2. **注册是被 ctx 拥有的 effect**：插件卸载、agent 释放、slot 折叠、profile patch 都会撤销对应 ctx 上注册的东西。**要选对拥有者 ctx**；注册在别的 ctx 上（如 `agent.ctx`）的注册有**两个**拥有者——必须把它的 disposer 也留在自己插件的 effect 里，这样任一侧 teardown 都能移除。
-3. **框架负责驱动，插件只负责计算**：session projection、Conversation 组装、slot 渲染已经替你订阅、缓存、发布。自己去订阅/重扫/写 DOM 就是绕过这套增量机制。
-4. **扩展点是共享的：用最弱的够用机制**。由弱到强：`ctx.tools.restrict()`（只能移除工具）→ `ctx.tools.guard()`（只能拒绝）→ waterfall 监听器（可改写、依赖注册顺序）→ `system-prompt/assemble`（替换整个组装结果）。机制越强，你要替其他插件保留的东西越多。
-5. **别的插件、别的 Harness 版本会读你写的数据**：未知事件类型、更老的读方、更老的缓存状态都会遇到你写的东西——按 Harness 提供的信封字段与版本声明兼容性。
-6. **插件 UI 就是 Harness UI 的一部分**：用户看到的是一个应用，所以插件要用宿主的主题 token、locale 与布局模式，并匹配宿主组件的外观与行为。**能不能做到由"在哪渲染"决定——先选渲染面再写视图**；后面在错误的面里做样式救不回来。
-
-**稳定性（逐条可执行）**
-- 不拥有该决策的 waterfall 监听器（`agent/pre-step`、`agent/request`、`llm/stream`、`tools/pre-execute`、`tools/execute`、`tools/post-execute`）**必须返回 `next()`**。改写 `agent/pre-step` 决策时要**展开**它（`{ ...decision, messages }`），否则 `startsRequestSeries` 之类字段会丢。
-- 必须与顺序无关地成立的拒绝用 `ctx.tools.guard()`（同步）；需要 await（比如问用户）的决策从 `tools/pre-execute` 返回 `ask`。只对某个 agent 隐藏工具＝在那个 agent 的 ctx 上 `ctx.tools.restrict()`（它让 schema 展示、查找、执行保持一致）。**最终结果只看 `tools/result`**；只有要变换结果才用 `tools/post-execute`。**不要监听 `system-prompt/assemble` 来增删工具或文本。**
-- 加提示词文本用 `ctx.systemPrompt.section()`。加 per-agent 上下文用 `agent.inject()`——它在调用时记为 `agent/inbox/spliced`，进入下一次获准的 step。**`agent/request` 监听器不能改请求消息。**
-- per-agent 行为注册在 `agent.ctx` 上（在 `agent/created` 监听器里拿到），这样该 agent 释放时一起移除。**把它包在一个 `agent.ctx.effect()` 里，并且把这个 disposer 按 agent 记在自己插件的 effect 里**——卸载插件本身**不会**释放 `agent.ctx` 的注册。
-- 可选服务放进 `inject` 或 `ctx.inject([...], ...)`，这样在没有它们的 profile 里插件保持不激活，而不是抛错。
-- **绝不要用新的 `type` 追加会话事件**：读方只在事件带信封 `ignorable: true` 时接受未知类型，而运行时 `Session.append()` 写不了这个标记，于是**会话会拒绝重新打开**。插件状态从既有事件推导，或放进 inspection 找到的 storage 服务。
-- 可调值放进插件的 `Config`，让用户在 `cordis.patch.yml` 里改——**用户的 patch 层能跨升级保留**。
-
-**性能**
-- per-session 状态放进 `ctx.sessionProjections` 单元，**不要**订阅 `session/event` 再重扫 `session.events`。`apply(state, event)` 是**纯同步**的，对它忽略的事件**返回同一个引用**，所以未变状态在下游零成本；读取用 `stateOf()`。`view()` 在值未变时返回同一引用，从而抑制发布。
-- projection 状态保持**纯 JSON**，字段或 fold 语义变化时 bump `stateVersion`：投影缓存会 checkpoint 它，冷读只回放尾巴，过期 checkpoint 被丢弃。
-- **等持久事件**（`turn/end`、`assistant/message`、`tool/result`），实时 token 从 `agent/assistant-stream` 渲染。**不要轮询 `agent/status`。** `whenIdle()` **不**代表"一次 followup 结束了"——多个输入可以共享同一个运行区间。
-- 会启动工作的定时器调用 `agent.followup()`（它**唤醒** agent）；`agent.inject()` **不唤醒**，所以注入的上下文可能在 inbox 里等到别的输入才被采纳。定时器要在拥有它的 effect 里清除。
-
-**UI**
-- 插件页面渲染成 slot 里的 React 组件。**不要**从 Host 提供一个 HTML 页面再 iframe 嵌进去：iframe 文档拿不到宿主主题 token、明暗切换和 `ctx.locale`。
-- 用 `cordis_inspect_query` 的 `Theme` 列出的主题 token（`--dsw-alias-*`）做样式；字面颜色只用于 artwork。token 是最低风险的匹配方式：token 改名只会让外观退化，**永远不会弄坏渲染**。间距/字号/行模式照抄同类宿主页面（管理类列表的参照是 Plugin Manager 页）。
-- **不要** `require('@deepseek-ai/dsh-client-ui-primitives')` 或把任何 Harness Client 包当模块加载；`dsh.client.inject` 只做激活排序、保持允许即可。它们会不打招呼地变化，纯 JS 插件没有类型检查，而**抛错的组件会把你的 slot 条目整块搞白**（console 里是 `slot entry crashed in '<slot>'`）。**自己写控件并对齐宿主**：从 primitive 里把标记、CSS 与行为抄进插件（DSH 源码 checkout 的 `src/*.tsx` 与 `*.module.css`，或已安装包的 `lib/index.js` 与 `lib/**/*.css`），或在连着的页面里观察渲染出来的宿主控件。抄来的 class 要改到你自己插件的前缀下，只保留 `--dsw-alias-*` token 引用，并保留用户依赖的行为（Modal 焦点与 Escape、`role="switch"` + `aria-checked`、Tooltip 落位）。这样 token 就是唯一的共享样式依赖。
-- 只通过 slot 贡献：`ctx.slots.inject(ownerKey, () => ctx.slots.register(...))`——回调里的注册在拥有它的声明折叠时释放、恢复时重新安装。会话数据经 slot props 的 selector hook 读取，订阅**最小切片**。**不要**在组件外写 DOM，也不要往 `document.body` 追加。
-- 加 Chat 行：用 `ctx.uiConversation.events.register()` 注册事件定义，并在 `conversation.chat.node` slot 下按该定义的 `kind`（即渲染键）注册视图；分页、Turn/Step 落位与增量组装由 Conversation 层负责。
-- Client 需要会话派生值时，在 Host projection 上声明 **`wire.view`**——值算好了再送到 Client，**Client 不自己 fold 会话事件**。
-
-### 3.5 `user-actions.md` — 用户动作与 agent 工具
-
-- **一个操作，两个调用方**：① 实现成一次 Host 服务方法（返回结果或显式状态，失败带原因）；② UI 动作经 inspection 找到的 Client 可调 Host 入口（如 `ctx.remote.commands.execute()` 跑的会话命令）调用它并显示失败；③ 用参数与语义一致的 agent 工具暴露同一操作（相关操作可用一个 `action` 参数共用工具），工具调同一个方法并把结果作为工具结果返回。
-- **授权/确认类动作仅限用户**（批准工具调用、回答 agent 的提问、放宽策略）。**不要在 UI 与工具两条路径里各维护一份操作逻辑。**
-- 验证：双调用方的操作**只用工具**跑一遍，比较状态变化、返回值与失败是否与 UI 动作一致；用户专属动作要验证 agent **无法**执行或授权。
-
-### 3.6 `verification.md`
-
-无浏览器控制时的页面/面板设计核查流程（配合 §2 第 4-5 步使用）。
-
-## 4. 与本知识库的关系
-
-- 本文件是**索引与摘录**；机制细节（精确签名、事件 `@mode`、Config schema）永远以 **inspection** 与 `references/official-docs/docs/**` 为准。
-- 官方这份技能覆盖"在会话里让 agent 写并安装插件"；本知识库另外覆盖**对外发布**（npm/tarball/git 通道、`prepare` + `allowBuilds`、五语 README、质量门禁）与**版本迁移**（[migration-0.2.md](../guide/migration-0.2.md)）。
-- 上游路径随宿主版本变化（本文件基线 `d743267`）；`preset/agent-presets` → `preset/agent-preset` 的改名发生在 `d1e22a7e24`。

package/references/sources.md

@@ -1,143 +0,0 @@
-# 全部资料来源清单（sources.md）
-
-> 本清单是 `dsh-plugin-guide` 的"下载与记录"总账：每条来源的 URL、本地归档位置、抓取方式与状态。
-> 下载明细（状态/字节数）见 `downloads/manifest.tsv`；社区仓库明细见 `downloads/community-repos/_download.log`。
-> 2026-08-14 晚间二次补录（本文件本次更新）涵盖：官方 Discussions、npm 全家桶、cordiverse 组织其余仓库、GitHub 生态新增 80+ 文档仓库、中英文社区文章与 HN 线程。
-
-## A. 官方核心来源（用户指定的五个入口）
-
-| # | 来源 | URL | 本地归档 |
-|---|---|---|---|
-| 1 | deepseek-harness GitHub 仓库 | https://github.com/deepseek-ai/deepseek-harness | 本地 checkout `D:\deepseek-harness`（工作环境本体）+ `references/official-docs/**`（文档副本）+ `downloads/github/harness/README.md`（线上 README 快照）+ **`downloads/github/harness/discussions/`（Discussions 全量归档，2026-08-14 新增）** |
-| 2 | 官网 Harness 页 | https://www.deepseek.com/harness/ | `downloads/web/deepseek-com-harness.html` + 调研 `references/website-pages.md` |
-| 3 | 文档站 develop/basic | https://deepseek-harness.github.io/deepseek-harness/develop/basic/ | `downloads/web/develop-basic.html` + 全站爬取 `downloads/web/site/**` + 投影源 `references/official-docs/docs/user/develop/basic/**` |
-| 4 | Cordis 框架仓库 | https://github.com/cordiverse/cordis | `downloads/github/cordis/**`（README/package.json/仓库树/全部 md）+ 调研 `references/upstream-cordis.md` + vendored 源码（本地 checkout `vendor/cordis`） |
-| 5 | Cordis 论文仓库 | https://github.com/cordiverse/paper | `downloads/github/paper/**`（README + **paper.pdf 论文全文**）+ 调研 `references/cordis-paper-and-community.md` |
-
-## B. 文档站全站路由清单（GitHub Pages）
-
-站点基址 `https://deepseek-harness.github.io/deepseek-harness/`；根路由为中文投影，`en/` 前缀为英文投影。已全部爬取（`downloads/web/site/<route>.html`）：
-
-- `/`（首页）、`/guide/quickstart`、`/guide/providers`、`/guide/python-sdk`
-- `/develop/basic/`、`/develop/basic/tool`、`/develop/basic/config`、`/develop/basic/publish`
-- `/develop/framework/`、`/develop/framework/service`、`/develop/framework/events`
-- `/develop/practice/`、`/develop/practice/llm-adapter`
-- `/develop/cordis-tutorial/` 及 `01-first-plugin`…`07-into-the-harness`
-- `/reference/`（架构）、`/reference/cordis-primer`、`/reference/capability-seams`、`/reference/agent-lifecycle`、`/reference/tool-execution-pipeline`
-- `/reference/config-catalog`、`/reference/tool-catalog`、`/reference/persistence-catalog`
-- `/reference/cordis-api/context|events|fiber|registry|service|inherited`
-- `/reference/cookbook/adding-a-package|adding-a-tool|adding-an-llm-adapter|extension-cookbook`
-- `/reference/subsystems/` + 全部子系统页（core、llm-streaming、token-meter、scope、typert、goal、schedule、commands、session、persistence、settings、credentials、session-query、feedback、session-title、session-reference、system-prompt、tools、user-questions、approval、attachment、shell、subprocess、terminal、sandbox、code-runtime、extensions、filesystem、lsp、skills、compaction、subagent、web、spill、workflow、jobs、permission-presets、plan、invariants、web-server、storage、workspace、client-modules、session-projection、session-telemetry）
-- 站点投影清单源文件：`references/official-docs/website-docs.ts`（= 仓库 `website/docs.ts`）
-- **08-14 晚复核**：上游 master 仍为 47f9438（站点随仓库构建，无新增路由）；此前 404 的 `/reference/subsystems/{attachment,extensions,feedback}` 仍为 404（已确认），sitemap.xml 仍不存在。
-
-## C. 本地 checkout 文档副本（references/official-docs/）
-
-- `docs/**`（**429 个 md**，含 212 个 `.zh.md` 双语对；2026-10-13 重同步到 `dsh-v0.2.1-alpha.2`）— 教程/架构/子系统/API/cookbook/upgrade-guide/persistence-changes 全量（计数以 `references/official-docs/SNAPSHOT.md` 为准）
-- 仓库根文件（**2026-08-14 晚新增**）：`AGENTS.md`、`CLAUDE.md`（上游为 symlink→AGENTS.md，副本存其目标文本）、`BENCHMARK.md`、`CONTRIBUTING.md`/`.zh.md`/`.i18n.yaml`、`README.zh.md`/`.i18n.yaml`、`THIRD_PARTY_NOTICES.md`、`LICENSE`
-- `packages/AGENTS.md` · `packages/README.md` · `vendor/README.md`
-- `website-docs.ts`（站点投影清单）
-- 上游英文 `README.md` 不进入本目录（与 KB 索引同名），线上快照在 `downloads/github/harness/README.md`
-- 同步脚本本次加固：pathspec 全部 `:(top)` 锚定（避免 basename 全局匹配误收仓库深处 symlink）；Windows 下无法解出的 symlink 按其 blob 目标文本落地；目的目录只保留范围内条目（曾因一次失败抽取残留污染，已由脚本自动修剪 107 项）。
-- **不在站点路由表里的重要文档**（本地有副本、站上找不到）：`session-format-status.md`、`upgrade-guide/**`（6 篇，**无 index、无任何入链**）、`persistence-changes/**`、`ui-radius.md`、`web-styling.md`、`module-graph.md`、`dependency-catalog.json`、`persistence-schema.json`——清单见 [guide/links.md](../guide/links.md) §2.1。
-- **官方自带插件开发技能不在 `docs/` 下**：在 `packages/preset/agent-preset/skills/**`（本库要点摘录见 [official-plugin-dev-skill.md](official-plugin-dev-skill.md)）。
-
-## D. 社区与生态（downloads/community/ + references/community-ecosystem.md）
-
-### D.1 插件开发仓库完整 tarball 归档（scripts/download-community-repos.ps1，共 114 个）
-
-| 批次 | 仓库 | 定位 |
-|---|---|---|
-| 第一批（15） | omdsh-dev/plugin-template、omdsh-dev/dsh-plugin-skills、omdsh-dev/dsh-plugin-dev、vlln/plugin-registry、omdsh-dev/fabric、whyihaveyou/dsh-suite、omdsh-dev/dsh-plugin-check、Opr4Mp3r/deepseek-harness-plugin-from-scratch、randerous/dsh-turn-meta、bobleer/deepseek-harness-plugin-mcp、Nagi-ovo/dsh-find-plugins、omdsh-dev/dsh-hub-workshop、AdamPlatin123/awesome-dsh-plugins、bruc3van/awesome-dsh-plugin、Alex-Yanggg/awesome-DSH-plugin | 首批深读（报告 `references/community-repo-deep-dive.md`） |
-| 第二批（14） | walkinglabs/awesome-deepseek-harness-plugins、vvlife/awesome-deepseek-harness-plugins、cccakeee/awesome-dsh-plugins、bradeGithub/DSH-Plugins-Marketplace、Toukaiteio/dsh-plugin-installer、Scorp1o117/dsh-plugin-marketplace、NanmiCoder/dsh-agent-teams、vibeinging/dsh-tool-search、zhu1090093659/dsh-web-ui、ccch1mneyyy/dsh-cc-tui、dataelement/dsh-desktop、hust-open-atom-club/oh-dsh-desktop、lhh010/dsh-bash-encoding、Nagi-ovo/dsh-visualize | 08-14 上午清单（awesome/市场/候选） |
-| 第三批（26，高优文档型） | flaqai/deepeseek-harness-guide（15 语言指南）、Electricitysheep/dsh-handbook（14 章双语+PDF）、JingHao-Leon/deepseek-harness-guide（保姆级双语教程）、flysheep-ai/learn_deepseek_harness（s01–s23+33 SKILL）、pingfanfan/hello-dsh（22 技能实例）、LaplaceYoung/dsh-book-deepseek-harness（42 md 源码拆解书）、yanhua1010/dsh-harness-tutorial（39 md+8 demo）、hoco-scy/deepseek-harness-deep-dive（36 章/1094 证据）、libukai/awesome-deepseek-harness（中英日三语）、sandbaseai/deepseek-harness-handbook（多语手册）、openma-ai/deepseek-harness-typescript-sdk（TS SDK）、h565656445/dsh-llm-agent-harness-guide、h565656445/dsh-agent-os-worker-protocol、cyanseek/dsh-native-playbook、whyihaveyou/dsh-plugin-tutorial、DumplingHuman/dsh-plugin-tutorial、anweat/dsh-plugin-dev-guide、Hubert-hwk/dsh-for-humans、yangl326-Dylan/learning-dsh、curtiseng/cordis-course（Cordis 论文中文课程）、THU-MAIC/dsh-openmaic（清华 MAIC）、qomob/DSHwiki、calderbuild/awesome-deepseek-harness、njdldkl666699/dsh-learning、Loner1024/deepseek-harness-sdk-rs（Rust SDK）、dshworks/howto-dsh | 08-14 晚 GitHub 生态扫描（报告 `downloads/_research/github-ecosystem-scan.md`） |
-| 第四批（19，中优 skill/契约） | dhicoc/dsh-reverse-skill（85 SKILL）、phoenixlucky/zerotoken-skill、unknowbug/anchorlaw、w2112515/dsh-plugin-development、OneZero-Y/dsh-plugin-kit、akira399/dsh-plugin-publisher、LeslieWylie/dsh-plugin-release、LeslieWylie/dsh-benchmark-evidence、LeslieWylie/dsh-agent-orchestration、dongsheng123132/task-passport、Tostoevsky/TsienHsueShen、Whning0513/awesome-deepseek-skills、Jesse-njx/dsh-skillport、green-dalii/dsh-plugin-dev-skill、RayYeung1989/dsh-plugin-development、SmileTao/dsh-plugin-dev-skill、Leeaoyin/dr-agent-skills、KhalilYamber/hana-dsh-bridge、ieookm/agent-to-dsh-migration | 同上扫描（中优先级） |
-| 第五批（20，低优目录/市场） | kejixiaoliang/awesome-dsh-plugins、like-study1/Oh-My-DSH、zp-home/dsh-recommend、white0dew/awesome-dsh-plugins、wangshunnn/oh-my-dsh、billLiao/awesome-dsh-plugin、YYTbit/awesome-dsh-bridges、HackSing/dsh-plugins、xiaohai-78/Top、2BingLing/dsh-market、lwmxiaobei/dsh-plugins、dshworks/awesome-dsh-themes、dshworks/awesome-dsh-plugins、dsh-pub/dsh-pub、cooljser/dsh-plugin-portal、WatchaAI/awesome-deepseek-harness-plugins、imsai-sh/awesome-deepseek-harness-plugins、xianyu110/awesome-deepseek-harness、openguardrails/openguardrails、Bandersnatch0x/amber-protocol | 同上扫描（低优先级，README 即文档） |
-| 第六批（3） | onychen/learn-dsh、alchaincyf/deepseek-harness-orange-book（橙皮书《从开机到拆开》）、bobleer/deepseek-harness-gui（Tauri 桌面壳） | 中英文社区扫描补充 |
-| 第七批（14） | anywhere-labs/cc1252/LisiChen0/Skyearn/salathleizhang/ChisaAlter/hairyf 的 deepseek-harness-desktop 系列（7 个桌面端）、banana770/dsh-qq-bridge（QQ 桥接）、Vengisk/deepseek-harness-termux、zzszmyf/dsh-security-pocs（安全 PoC）、HenryZ838978/deepseek-harness（Python 移植）、Lyowisee/deepseek-harness、mishibeikejie/zat-dsh-engine（可视化市场）、beancookie/awesome-dsh-plugin | 08-15 上午 web_search 增量扫描（清单见 community-ecosystem.md §4.6） |
-| 第八批（3） | orxz/deepseek-harness-themes（主题集合）、vvlife/whalehub-dsh（WhaleHub 插件市场）、dsh-market/dsh-market（市场注册表组织） | 08-15 午间 web_search 补充（见 community-ecosystem.md §4.7） |
-
-归档位置 `downloads/community-repos/<repo>/`；ETag 记录 `_heads.tsv`；运行日志 `_download.log`。**同名消歧规则（08-15 起）**：多个 owner 有同名仓库（如 4 个 awesome-dsh-plugins、7 个 deepseek-harness-desktop）且 Windows 文件系统大小写不敏感——清单中首个出现者保留裸目录名（兼容既有文档引用），后续同名者用 `<owner>-<repo>` 目录名。脚本改造史：08-14 晚改为 codeload HEAD 探测 + tarball（零 api.github.com 配额消耗）；08-15 修复弱 ETag（`W/"..."`）解析 bug、PS 5.1 切片数学、新增第七批与 `-OnlyMissing`。
-
-### D.2 生态与社区其他来源
-
-- 官方 Discord 社群：https://discord.gg/Ycq5dCaS4 （官方仓库 README 明文链接）
-- GitHub 讨论区：https://github.com/deepseek-ai/deepseek-harness/discussions —— **全量归档见 §G**
-- GitHub topic：https://github.com/topics/dsh-plugin —— 08-14 晚 total_count=2034（topic:deepseek-harness=1432、topic:dsh=980），扫描报告 `downloads/_research/github-ecosystem-scan.md`；早期三期快照在工作区（304/550/993 去重，见前版记录）
-- 生态目录/市场类仓库（第五批）与文档型仓库（第三/四批）完整清单见 §D.1 与 `references/community-ecosystem.md`
-- dshfind（学习分享社区）：https://github.com/hikariming/dshfind
-- 工作区已有插件实例（可作参考实现）：`dsh-chat-import`、`dsh-resume-plugin`、`dsh-plugin-claude-bridge`（目录：`D:\deepseek-harness\Project\Plugins\`）
-- turtle-ui（git 安装 prepare 范例）：https://github.com/deepseek-harness/turtle-ui（**08-14 核查 404**；官方 publish.md 原文仍引用它，活范例见 omdsh-dev/plugin-template 的 scripts/prepare.mjs）
-
-## E. 上游 Cordis 相关
-
-- cordiverse/cordis 全部 md 文档：`downloads/github/cordis/repo/**`
-- cordiverse/paper 全文源文件：`downloads/github/paper/repo/**`
-- **cordiverse 组织其余仓库（2026-08-14 晚新增归档，`downloads/github/cordis/<repo>/`）**：
-  - `docs/` —— **Cordis 官方文档站源（zh-CN，60+ md：API/design/guide/manual/install）**，此前未收录
-  - `webui/`（Cordis App WebUI，385 文件）、`cli/`、`server/`、`capability/`、`registry/` —— 框架周边实现与文档
-- Cordis 文档站（如存在，见 references/upstream-cordis.md 中的调研记录）；cordis.io 为 308 自循环重定向、cordisjs.org 无解析（08-14 复核，均不可用）
-
-## F. 官方 GitHub Discussions 归档（2026-08-14 晚新增；2026-08-15 刷新）
-
-`downloads/github/harness/discussions/`（说明文件 `README.md` 含分类统计与精选清单；刷新脚本 `scripts/archive-discussions.ps1`）：
-
-- `list.json` —— 全部讨论（title/body/category/answers 等，正文即文档）；**2026-10-06 刷新**：`archive-discussions.ps1` 全量重跑（list.json 约 31.6 MB）：**list=5000、精选线程 1648**（`README.md` 由脚本自动生成分类统计：General 2250、Show Your Plugins! 1148、Ideas 1031、Q&A 565、Polls 5、Announcements 1）。
-  - ⚠️ **REST 分页天花板**：`/discussions` 走 REST 只能翻到 **5000 条**（脚本 `page -le 50` × 100/页）；同期 **GraphQL** `UPDATED_AT DESC` 报告仓库 **total_count=8850**。所以归档覆盖的是前 5000 条而非全量；需要更全时按 GraphQL 补抓（社区刷新用的就是 GraphQL 分页：31 页 × 100 覆盖 `UPDATED_AT >= 2026-09-14` 的 3100 条）。
-- `comments-<n>.json` —— 精选线程的全部评论（规则：Announcements/Q&A/Ideas 评论≥1；General/Show and tell 评论≥3 且非拉群帖）
-- `_selection.tsv` —— 精选清单（1648 行 + 表头）
-- 背景：官方仓库 **Issues 关闭、Discussions 开放**（社区反馈主渠道）；**2026-10-06 API 复核**：`has_issues=false`——**没有 issue tracker、也不收 PR**，Discussions 是唯一渠道；仓库 star≈244,304、fork≈29,266、最后 push 2026-10-03、许可 MIT。代表作 [#1629 RFC 官方插件脚手架](https://github.com/deepseek-ai/deepseek-harness/discussions/1629)、[#6520 本库的未修复问题汇总帖](https://github.com/deepseek-ai/deepseek-harness/discussions/6520)（最后活动 2026-09-23，**无维护者回复**）。
-- **重要结论（写进贡献规则）**：本轮通读的 3100 条线程里，**没有任何维护者确认过修复或设计决定**；唯一的"官方决定"权威记录是 **GitHub Releases 说明**（仓库无 CHANGELOG）。引用"官方已确认"必须落到 Release 原文或提交号。另：**Announcements 分类只有 1 条**——官方不在 Discussions 发版，发版只在 Releases。
-- **本窗口最高价值的线程**：#8199（升级后 22 个第三方 bundle 里 11 个被判不兼容 + `minimumReleaseAge` 静默阻塞）、#7850 / #8821（`plugin add` 不补齐 layer 行）、#8633（宿主插件失败在 `dsh web` 下不可见）、#8688（`connection.rpc.handle()` 405，自 0.1.0-rc.7 起）、#8862（profile 内 dsh 包遮蔽运行时）、#8968 / #8857 / #8635（运行中改 `cordis.patch.yml` 的三种破坏后果）、#8590（社区 0.1.5-rc.2 → 0.2.0-rc.2 移植实录）、#8669（12 评论真实插件构建日志，含 `inject` 写成函数导致整 bundle 被自愈禁用的血案）、#8537（插件验收 profile 隔离提案 + `sanitizeProfile` 复盘）、#8836（`assistant()` 空白文本块 → 云端 400）、#8649（桌面端 skill provider 因 `app.asar` 相对根丢光文件系统 skill）。
-
-## G. npm 包归档（2026-08-14 晚新增）
-
-`downloads/npm/`（说明文件 `README.md` 含全表）：
-
-- **@deepseek-ai/* 全家桶 72 个包**的 registry 元数据（全部版本历史+dist-tags；README 非空者另存 `.readme.md`）：由 `@deepseek-ai/dsh@0.1.0-rc.6` 依赖树（约 60 个 dsh-* 包 + cordis-plugin-hmr/loader/timer/include）+ 历史已知包（dsh-shell、dsh-session*、dsh-tools、dsh-web、dsh-loader-smoke、node-addon-landlock-run 等）推导
-- `@deepseek-ai/cordis`（latest 4.0.1，next 4.0.1-rc.4）、`create-dsh-plugin`（0.1.1）、`@linxin666/dsh-remote-web-ui`（社区远程 Web UI）
-- 404（未发布）：`@deepseek-ai/dsh-core`、`@deepseek-ai/dsh-sdk`（截至本快照）
-- `search-*.json`：npm 搜索快照（scope:deepseek-ai / dsh-plugin / deepseek-harness / create-dsh）
-- 依赖上下文包：commander、js-yaml、node-addon-require-builtin、dsh（无关项目 node-dsh，仅存档对比）
-
-## H. 社区文章与论坛归档（2026-08-14 晚新增；2026-08-15 实盘落地为 149 篇）
-
-`downloads/web/community-articles/`（日志 `_download.log`；刷新脚本 `scripts/download-community-articles.ps1`；线索与摘要见 `downloads/_research/chinese-community-scan.md` 与 `english-community-scan.md`）：
-
-- `zh/`（94 篇）—— cnblogs 教程（pc2005 npm 发布实战、qq8864 会话导出/插件vs工具、sing1ee Agent Loop 解析、knqiufan/foxcharon/itech/adgine-ai/isLinXu）、CSDN（yuqingteck Hello Tool、damodev 大仓工程化、zhuosj、aiutools、qq8864、csdnnews、aicoding）、51CTO 2 篇、阿里云开发者社区 2 篇、bibigpt/aixq 实战、量子位/智东西/品玩/DTinsight/极客公园/36氪/界面/IT之家/甲子光年/53AI/搜狐/网易/新浪/东方财富等媒体实测与新闻、V2EX 8 线程（1234203/1234320/1234341/1234424/1234521/1231389/1214141）、locdd 3 线程、B 站视频页 9 支（BV1WmgF6qEMn/BV1iAgc6xEj7/BV1KFgF6zEtk/BV1NKgw6VErB/BV1o4gP6iEeo/BV1vugA6FERZ/BV1VkgK6NEZS/BV1eDgW6QEFx/BV17ygc6tEE1）
-- `en/`（45 篇）—— NYU Shanghai RITS Cordis 解读、dev.to 2 篇（onsen 全指南、reidmarlow 价格信号）、AgentPedia/ExplainX/AgentBreaking 教程、essamamdani、X-CMD 安装页、dsh-index.xlings、xlings 多版本页、36Kr 英文 3 篇、Ollama 官方集成文档、aiengineerguide TIL、GIGAZINE、OpenRouter Ori Harness 文档、Pandaily/Edgen/TMTPOST/BlockBeats/Gate.it/e-ink 等新闻页（digg 2 页被反爬拦截）
-- `hn/`（10 篇）—— Hacker News 镜像（hn.edgecompute.app）7 条线程：49285244（主发布）、49286003（Cordis 论文）、49287821（X-CMD）、49294357（dsh-index）、49291049（xlings）、49291893（jelly ball 视频）、49285620（官方 X 帖）
-- 未归档（反爬/需浏览器）：知乎提问 2040450519303288568、InfoQ 中文 451、venturebeat 429、thenextweb 403、Reddit/X/YouTube（见两份扫描报告的"未收录但无法访问"清单）
-
-### H.1 08-15 抓取环境记录
-
-- Discussions 刷新与话题快照走 **Invoke-WebRequest + Authorization Bearer**（用户提供的 GitHub PAT 经 `$env:GH_TOKEN`/`-Token` 传入，未落盘任何配置）。
-- 关键坑（已写进脚本注释与 §I）：后台任务宿主为 Windows PowerShell 5.1——`curl.exe` 数组参数（`-H` 头）会被拆词静默破坏，导致 API 返回错误对象、一次误把 list.json 写成 0 条（防缩水保护即为此加）；修复为 Invoke-WebRequest 后稳定。
-- 话题快照 08-15 期：`downloads/topic-snapshots/dsh-plugin-topic-2026-08-15/`（去重 998、total_count 抓取期间 2668→2671）。
-
-## I. 抓取说明
-
-- 方式：`scripts/download-sources.ps1`（curl.exe；GitHub API 带 User-Agent；含多分支回退 master/main/HEAD）+ `scripts/download-community-repos.ps1`（**codeload HEAD 探测（main→master→HEAD 三级回退 + ETag 增量）+ codeload tarball + tar 解包**，零 API 配额）+ `scripts/download-community-articles.ps1`（curl + Invoke-Expression 拼串，规避 PS 5.1 拆词）+ `scripts/archive-discussions.ps1`（Invoke-WebRequest + Bearer token）。
-- 明细：`downloads/manifest.tsv`（主脚本）、`downloads/community-repos/_download.log`（社区仓库）、`downloads/web/community-articles/_download.log`（文章）、`downloads/github/harness/discussions/README.md`（Discussions）。
-- 重跑：脚本均幂等，可随时刷新；`sync-official-docs.ps1` 同步官方文档副本（本次扩展了根文件范围与 `:(top)` pathspec/修剪）。
-- **08-14 晚环境限制记录**：`gh` CLI token 失效（401）后，GitHub 全部查询改走 git 协议（ls-remote/clone）与 codeload；api.github.com 匿名配额 60/h 仅用于 Discussions 评论精选抓取；本机网络直连 github.com 网页与 raw.githubusercontent.com 失败（curl 000），git https 与 codeload 正常。
-- **编码约定（重要）**：Windows PowerShell 5.1 无 BOM 的 UTF-8 脚本会按 ANSI 解析，中文注释尾字节可能吞换行导致代码行并入注释（本次真实踩坑）；`scripts/*.ps1` 必须保持 **UTF-8 with BOM**，编辑后务必复核 BOM。
-  - **2026-10-13 复核（约定被违反的实例）**：实测 `scripts/` 下 9 个 `.ps1`，**8 个带 BOM 且 5.1 解析 0 错**；唯一无 BOM 的 `verify-kit.ps1` 有 **1644 个非 ASCII 字节**、在 5.1 下报 **5–6 个解析错误**（`Missing ')' in method call`）——**而它正是发布门禁**（`release.yml` 用 `shell: pwsh` 调它，所以 CI 从没发现；本机没有 pwsh 时才暴露）。已补回 BOM 并实测 `VERIFY-OK` / exit 0（82 项关键路径全在）。**根因不是约定错，而是这一个文件丢了 BOM**——另加 `.gitattributes` 固定行尾，避免同类问题复现。
-- 时间戳：下载会话 2026-08-14 22:45–23:59（+08:00）；dsh-plugin topic 快照共三期（2026-08-13T15:15Z/08-13T18:36Z/08-14T08:16Z）+ 08-14 晚扫描（total_count 2034，见 §D.2）。
-- 官网 deepseek.com 页面受 Cloudflare 保护时可能失败——以 manifest 记录为准，正文内容以 GitHub Pages 同源文档为准。
-- **备注**：用户清单中 `ess-plugin-mcp` 经 GitHub 搜索无精确匹配（最接近者为 Skyrim .ess 插件工具的 MCP，与 DSH 无关）；按 DSH 生态语义定位到 `bobleer/deepseek-harness-plugin-mcp`（让任意 agent 经 MCP 发现/安装/运行 DSH 插件）并归档，如用户所指另有其仓，请告知后补充。
-- **2026-08-14 复核（网络实时核验）**：上游 master 仍为 47f9438（本地 checkout 即上游 HEAD，官方文档副本与 checkout 逐文件 hash 一致）；无 GitHub Releases/tag。npm `@deepseek-ai/dsh` latest=next=0.1.0-rc.6（08-13T12:35Z 发布）、`@deepseek-ai/cordis` latest=4.0.1、`@deepseek-ai/dsh-tools` 与 `@deepseek-ai/dsh-session-persistence-jsonl` 的 `latest` 仍为过期的 0.0.1-rc.1（`next`=0.1.0-rc.6）；已发布还包括 dsh-shell（0.0.1-rc.5）、dsh-session*/dsh-web/dsh-headless/dsh-loader-smoke/dsh-skill（0.0.1-rc.1）；dsh-core、dsh-sdk 未发布（404）；**无作用域 `dsh` 包是无关项目 node-dsh**（description: A shell written in JavaScript）。
-- **2026-08-14 二次复核（08:16Z，网络实时核验）**：`create-dsh-plugin` 已发布（latest=0.1.1，2026-08-13T15:15:42Z）——上次复核"未发布（404）"的记录作废；`@deepseek-ai/cordis` 另发布 `next`=4.0.1-rc.4；其余 npm 结论不变（dsh/dsh-tools/dsh-session-persistence-jsonl/dsh-shell 同上；dsh-core、dsh-sdk 仍 404）。`dsh-plugin` 话题 API total_count 增长至 1391（08-14T08:16Z，分页去重 993，见 §D.2）。官方文档副本与上游 `origin/master`（47f9438）逐字节一致，快照记录见 `references/official-docs/SNAPSHOT.md`。
-- **2026-08-14 外链扫描**：KB 自有文档 215 个外部 URL 逐一探测。真死链已修复/标注：turtle-ui、dsh-external/hub、deepseek-harness/cordis（404）；npmjs/socket.dev/新闻站（163/sohu/qq/aihot）与 discord.gg 对 curl 返回 403/501/超时属反爬，浏览器可用，非死链；cordiverse/paper 的 raw README（master/main）均 200。
-- **2026-08-14 社区仓库提交复核**：15 个深读仓库中 6 个在 08-13T15:15Z 快照后有新提交——dsh-suite（16:20Z X digest 管线/first-party 目录）、from-scratch（16:29Z 教程 prose 与 checkpoint 对齐）、plugin-mcp（16:16Z Streamable HTTP 每会话独立 Server 修复）、dsh-hub-workshop（17:30Z qualify catalog + close registry）、AdamPlatin123/awesome-dsh-plugins（18:10Z 登记 PR #4/#14 等）、bruc3van/awesome-dsh-plugin（17:56Z 目录刷新）；其余 9 个无新提交、无改名/归档。已按最新 HEAD 全部重下（HEAD 记录 downloads/community-repos/_heads.tsv）。
-- **2026-08-15 复核（网络实时核验 + 增量归档）**：上游 master 仍 47f9438、无新提交/Release/tag；`@deepseek-ai/dsh` latest=next=0.1.0-rc.6 无变化。`dsh-plugin` 话题 total_count 08-14 晚 2034 → **08-15 快照抓取期间 2668→2671**（第四期快照 `downloads/topic-snapshots/dsh-plugin-topic-2026-08-15/`，去重 998；`topic:deepseek-harness` 1432→1872）。官方 Discussions 全量刷新 1408→1654（含新增 RFC #1629）。社区仓库新增第七批 14 个 + 第八批 3 个（web_search 增量线索，见 community-ecosystem.md §4.6/§4.7）。社区文章归档 53→149 篇（zh 94/en 45/hn 10）。修复 `download-community-repos.ps1` 弱 ETag 解析 bug（弱 ETag `W/"..."` 曾致 heads 记录损坏 + Substring 越界）。
-
-## J. 生态投递记录（2026-08-15）
-
-本项目同时改造为可安装的 DSH bundle（`package.json#dsh.bundle` + 根 `cordis.patch.yml` + `index.js` 注册 `dsh-plugin-guide` 技能），并按各收录入口的专属规则投递：
-
-- 榜单 PR：awesome-dsh-plugin [PR #465](https://github.com/awesome-dsh-plugin/awesome-dsh-plugin/pull/465)（README.md/README-zh.md Skills 各 +1 行；#461 因 fork 分支被共享 fork 覆盖而自动关闭，已由 #465 取代）、AdamPlatin123/awesome-dsh-plugins [PR #151](https://github.com/AdamPlatin123/awesome-dsh-plugins/pull/151)（PLUGINS.md「🎓 技能」表 +1 行，运行级如实填「待测」）、0xsline/awesome-deepseek-harness [PR #183](https://github.com/0xsline/awesome-deepseek-harness/pull/183)（README.md/README.zh-CN.md Infrastructure & Development 各 +1）、bruc3van/awesome-dsh-plugin [PR #42](https://github.com/bruc3van/awesome-dsh-plugin/pull/42)（作者自荐区中英各 +1 行，`validate-curated.mjs` 本地通过）。
-- DSH Hub Workshop（omdsh-dev）：`package.json#dshWorkshop`（`omdsh-workshop-package/v1`）已提交（固定 commit `9447366f63a02229031af1e0bed2afedeff44860`）；v2 投稿经 `scripts/intake.mjs validate` 通过（"submission accepted for pending review"）；申请 [Issue #20](https://github.com/omdsh-dev/dsh-hub-workshop/issues/20)，pending-review 审核 PR 由 hub 自动化生成（异步）。
-- 官方展示：deepseek-harness Discussions [Show and tell #1824](https://github.com/deepseek-ai/deepseek-harness/discussions/1824)。
-- 自动聚合（预期延迟，复核命令）：Oh-My-DSH `PLUGINS.md`（每 4 小时）、wangshunnn/oh-my-dsh `registry/plugins.json`（根 package.json 已声明 `dsh.bundle.patch`）、YELEBAI/dsh-plugin-marketplace `registry/plugins.json`（每 2 小时扫描 + manifest 验证）、AdamPlatin123 雷达（≤8 小时）、bruc3van 每日快照、dshfind 与 Noob-stupid/yyyyukari（topic 实时聚合，无需动作）。复核：`curl -s https://raw.githubusercontent.com/<repo>/main/<文件> | grep dsh-plugin-guide`（本机直连 raw 失败时经 api.github.com/contents 取）。
-- 自检证据（真实执行）：`dsh plugin --profile dspg-test add .` 成功；`--dump-config` 出现 `# == dsh-plugin-guide` 层；对安装版 `@deepseek-ai/dsh-skill` 的最小 Cordis 挂载列出该技能且 `skills.get()` 返回完整定义（description/content/resourceBase）；完整启动会话无 FAILED。本机无 `DEEPSEEK_API_KEY`，模型对话未执行（如实注明）。