dsh-card-dispatch 0.0.0-stage → 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 往事似风如雾
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,250 @@
-# Temporary Holding Version
+# dsh-card-dispatch
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+[![npm](https://img.shields.io/npm/v/dsh-card-dispatch.svg)](https://www.npmjs.com/package/dsh-card-dispatch)
+
+DSH Host 插件：**把需求拆成任务看板卡片**。就这一件事。
+
+```powershell
+npm i dsh-card-dispatch     # 装进 DSH profile 的 node_modules
+```
+
+- 拆分：`src/split.js`（纯函数，判据自动补 `C-01`，按判据拆父卡 + 并行子卡，prompt 自包含）
+- 填写：控制台页面直接调看板的 `POST /api/task-board/action`
+- 执行：**不归本插件**。开会话、钉工作区、预设/权限、跑、结算，全部是看板的事
+
+人类入口：`/api/card-dispatch/`（面板里的「派卡台」）。
+
+## 1. 为什么只做这两件事
+
+这个插件曾经有 6000 行：事件台账、二十行迁移授权表、24 个模型工具、看门狗、
+自动开会话、预算核算、拓扑审计……结果是「什么都能干，但哪一步都不确定」。
+
+现在按一条线切：
+
+| 谁 | 负责 |
+|---|---|
+| 平台（DSH） | 会话、权限、计费、工作区、模型通道 |
+| 看板插件 | 卡片的真源、运行、子卡关系、运行记录 |
+| 本插件 | 闸门（能不能开跑）、投影（需求 → 卡片）、人入口（一块能看懂的表单） |
+
+**平台已经保证的事不重复实现**：不自己起会话、不自己记台账、不自己算并发——
+看板的 `maxParallelRuns`、`sessionDefaultPermission`、`ExecutionRecord` 就是答案。
+重复一份只会得到两份不一致的真相。
+
+## 2. 安装与用法
+
+**安装**（两步都要做，然后重启一次 DSH）：
+
+1. 装进 profile 的依赖里：
+
+   ```powershell
+   cd $env:USERPROFILE\.dsh\profiles\desktop
+   npm i dsh-card-dispatch
+   ```
+
+2. 在 profile 的 `cordis.patch.yml` 里加一个 insert 块：
+
+   ```yaml
+   - insert:
+       - id: card-dispatch
+         name: 'dsh-card-dispatch'
+         config:
+           enabled: false          # 总开关：先关着，进面板自己开
+           permission: workspace-write
+           dataDir: .card-dispatch
+   ```
+
+   **必须是 insert 块**：只写 `- id: card-dispatch` + config 不生效，宿主会报
+   `patch: entry "card-dispatch" not found` 并跳过。
+
+本地改代码时用链接安装（不进 npm 仓库，改完刷新页面即可）：
+
+```powershell
+cd $env:USERPROFILE\.dsh\profiles\desktop
+npm i "dsh-card-dispatch@link:<仓库路径>/plugins/card-dispatch"
+```
+
+**用法**：
+1. 左侧边栏「派卡台」→ 面板（左栏填需求；右栏一列装「工作区 / 模型 / 怎么跑 / 开关 / 体检」；下面整条是预览）；
+   **模型在右栏**：它是全局设置（解析并拆分、生成判据草稿都用它）。换一个就写回 `models.draftRoute`，
+   刷新或重启后仍是它；下拉候选来自宿主设置里已添加的模型。
+2. 填 **需求标题**、描述（可选）、**验收判据**（一行一条）；
+   需求写在文档里的话，用「从文档导入」选 `.md` / `.txt` / `.json`，标题、描述、判据会自动填好；
+   手头只有一段话（聊天记录、验收邮件、会议纪要）就直接贴进描述，点 **「AI 解析并拆分」**：
+   - 第一步（模型）把原文整理成 标题 + 描述（给谁用 / 要什么 / 明确不要什么）+ 3~8 条可判定的判据；
+   - 第二步（规则）按判据拆成「父卡 + 子卡 + 验收卡」，拆几张是算出来的，不由模型决定；
+   - 第三步（模型）**按需求给每张卡写提示词开头**（目标 / 范围 / 不要做什么），
+     判据清单和「完成要交证据」那些硬要求仍由系统确定性地拼在后面；
+   - 预览里能逐张看到提示词，点「看解析用的提示词」能看到两段提示词原文；
+   - 标题只在空着时填、判据只追加不覆盖；改过表单后这一轮写的提示词会被丢掉（回落到模板）；
+   - 模型不可用时按格式规则解析（认 `# 标题`、`- [ ] 勾选项`、`## 验收判据` 列表），并明说走了哪条路；
+3. 判据不想手写就点「生成草稿」：**用右栏选的模型写**，模型不可用或关掉 `models.useModel` 时退回规则提炼。
+   两条路都是草稿，改完再用。
+4. 点「看拆分」先看预览：几张卡、每张卡会收到什么 prompt、这次会不会开跑。
+5. 点「写入看板」（右下）建卡；勾了「写入后立即运行」才会真的开会话（**这一步才计费**）。
+6. 验收驳回后回来点「按结论处理」：读 `out/<根卡 id>/verdict.json`，按打回上限给出 pass / rework / escalate。
+
+## 3. 路由（十一条）
+
+都以 `/api/card-dispatch` 为前缀，`kind: prefix`，页面每次请求从磁盘读（改 HTML 不用重启，改路由要）。
+
+| 方法 + 路径 | 作用 |
+|---|---|
+| `GET /` | 控制台页面（`src/console.html`） |
+| `GET /view` | 页面要的状态快照：能力清单、看板基址、当前配置 |
+| `GET /models` | 宿主设置里已添加的模型（只读扫描 `cordis.patch.yml`），给下拉用 |
+| `POST /split` | 需求 → 卡片计划（`cards[]` + `envelopes[]` + `warnings[]`），**不写任何东西** |
+| `POST /plan` | 解析 + 算拆几张卡 + 给每张卡写提示词（两次模型调用）；回 `intros` 给页面，写卡时原样带回 `/split` |
+| `POST /parse` | 整段需求 → 标题 / 描述 / 判据（只整理字段，不拆分） |
+| `POST /criteria` | 判据草稿：模型优先，失败退回规则提炼 |
+| `POST /import` | 文档正文 → 标题 / 描述 / 判据（正文由浏览器读成文本发来，插件不碰磁盘路径） |
+| `POST /rework` | 读 `verdict.json`，按 `gates.maxReworkRounds` 给 pass / rework / escalate |
+| `GET /config` | 声明表 + 当前值（页面据此回填控件） |
+| `POST /config` | 归一化后落盘成完整配置；不认识的键回 `rejected`，不会被悄悄丢掉 |
+| `GET /status` | 配置、开关、体检结论 |
+
+`POST` 一律要求人标记：请求头 `x-card-dispatch-human: true` 或 body 里 `human: true`。
+没有这个标记就是 400——**这条路只能人走**，模型和脚本不该替人按「开跑」。
+
+## 4. 配置
+
+配置只有一份真源：`src/config.js` 的声明表。面板、`/config` 路由、`cordis.patch.yml` 都按它收敛；
+旧版键（`budgetPerDay`、`autoProvision.permission`）仍然认得，非法值退回缺省并记一条 note。
+
+| 键 | 缺省 | 作用 | 插件能真拦吗 |
+|---|---|---|---|
+| `enabled` | `false` | 总开关；关掉只拆卡、不返回运行信封 | 能 |
+| `permission` | `workspace-write` | 卡片权限预设（写进每个 create 信封） | 能 |
+| `dataDir` | `.card-dispatch` | 插件的数据目录（配置、结论文件） | — |
+| `gates.requirePlanApproval` | `true` | 没批准的拆分不给运行信封 | 能（「批准」= 人点「写入并运行」） |
+| `gates.requireEvidence` | `true` | 没有 commit / 报告不算完成（团队开着时验收卡也在同一条会话里） | 能 |
+| `gates.budgetPerDay` | `200` | 每日运行次数上限 | 能，需调用方给 `runsToday` |
+| `gates.maxParallelRuns` | `3` | 同时在跑的会话上限 | 能，需调用方给 `runningSessions` |
+| `gates.maxReworkRounds` | `2` | 打回上限，第 3 次升级给人（基线 R3） | 能 |
+| `models.useModel` | `true` | 解析与判据草稿用不用模型；关掉只用规则（点一次才计费） | 是 |
+| `models.draftRoute` | 空 | 全局模型：解析并拆分、判据草稿、写卡提示词都用它（右栏下拉写的就是这一项），留空 = 宿主默认 | 是 |
+| `org.departments` | `dev/verify/integrate` | 部门名（写进卡片描述，供人读） | 只记录 |
+| `execution.driver` | `task-board` | 执行层驱动（只有看板一条路） | 枚举校验 |
+| `execution.teamRun` | `true` | 智能体团队：开了才按判据拆子卡（父卡带 `teamRun: true`，看板只起一个 Lead 会话，子卡由它派 teammate）；关掉不拆子卡、每张卡各一条会话 | 能（决定拆不拆 + 写进 create 信封） |
+| `audit.orgChart` | `true` | 拓扑稽查：事后核对有没有人绕开主管 | 只检查，不拦 |
+| `org.depthRequired` | `2` | 主管带人所需的委派深度 | **不能**，只体检提示 |
+
+**优先级：`<dataDir>/config.json` 优先于部署配置。** 面板保存的是归一化后的**完整**配置，
+所以不会出现半份配置的中间态；想回到部署值就删掉这个文件（`/status` 会给出路径）。
+
+三个闸都是纯函数（`src/gates.js`）：同样的输入永远同样答案，因此能逐条单测，也能在页面上先算给人看。
+`/split` 用 `evaluateStart` 决定给不给运行信封——**写卡不花钱，运行才花钱**，闸门只卡后者。
+
+## 5. 看板信封的字段约束（踩过就回不来）
+
+看板对 action 做 `exactKeys` 校验，**多一个字段就是 400**：
+
+- `create` 只认 `{kind, title, description, prompt, workspaceId?, mode?, permission?, parentId?, teamRun?}`；
+  `null` 也要整个省掉，不能写 `workspaceId: null`。
+- `teamRun` 只写在**父卡**上。子卡再带一次，看板会给子卡也起一个 Lead，等于开了两套班子。
+- `run` 是 `{kind:'run', taskId}`；`delete` 拒删**有子卡**的卡（`task has subtasks; detach or delete them first`），
+  也拒删正在跑的卡；要整棵子树消失用 `archive`（可恢复）。
+- 插件进程调 `/state` 是 403：看板有信任栅栏（`sec-fetch-site` / `Origin` / `dsh-auth-` cookie）。
+  所以插件只**生成信封**，真正的请求由**页面**同源发出（浏览器的标记天然通过）。
+
+## 6. 拆分策略
+
+| 情况 | 产出 | 会话数 |
+|---|---|---|
+| 判据 0 条 | 1 张父卡 + 警告「执行者不知道做到什么算完」 | 1 |
+| 判据 1 条 | 1 张父卡（不拆——拆多了全是计费） | 1 |
+| **没开智能体团队**（`execution.teamRun: false`） | 不拆子卡，判据全写进一张卡 | 每张卡各 1 条 |
+| 判据 ≥2 条 + 开了团队 + 勾了并行 | 父卡 + 每判据组 1 张子卡（子卡由父卡的 Lead 在**同一个**会话里派成 teammate） | **1** |
+| 判据 ≥2 条但没勾并行 | 1 张父卡，全部判据写进去 | 1 |
+| 交付门槛开着（`gates.requireEvidence`） | 上面任一种 + **1 张验收卡** | 团队开：仍是 1；团队关：+1 |
+
+**卡数 ≠ 会话数**。团队开着时 5 张卡（父卡 + 3 子卡 + 验收卡）都在同一个 Lead 会话里跑，
+只算 1 条会话；关掉团队时每张卡各开一条，所以「1 张开发卡 + 1 张验收卡」是 2 条。
+预览里的警告会把这次到底是 1 条还是 N 条直接写出来。
+
+拆不拆子卡只看**跑法**：团队开着才拆。页面跟着联动——团队没勾时
+「按判据拆成并行子卡」直接禁用；勾一下就存盘并重算预览，不用先点「保存」才发现会话条数变了。
+
+**子卡是并行的**：看板没有「卡片间依赖」字段。所以每张子卡的 prompt 自带它那组判据
+和「怎么算完」，不靠顺序；要严格串行就别勾并行。
+
+**验收卡为什么是另一张卡**：基线 §3.3 要求验证独立于开发——同一张卡自己说「我做完了」
+不算验收。所以门槛开着时，插件会把交付要求写进每张开发卡（报告路径写死成
+`out/<该卡 id>/report.md`，附 commit sha），再生成一张只读证据的验收卡：
+结论只能是 PASS 或 REJECT，REJECT 必须带 `{criteriaId, expected, actual, evidencePath}`。
+顺序（先开发、后验收、打回最多两次）写在父卡 prompt 里——teamRun 模式下父卡就是 Lead，
+由它守；平台排不出这个顺序，因为看板没有依赖字段。
+验收卡和团队开关无关：门槛开着就有；代价只是没开团队时它多占一条会话，预览会写明。
+
+## 7. 已验证 / 未验证
+
+已验证（真机，2026-10-22，在运行中的看板页里直接发请求）：
+
+| 动作 | 结果 |
+|---|---|
+| `GET /api/task-board/state` | 200，`sessionDefaultPermission: workspace-write` |
+| `create` 单卡 | 200，卡片出现 `status: todo` |
+| `create` 父卡 + 子卡（`parentId`） | 200，子卡正确挂到父卡下 |
+| `delete` | 200，卡片移除，看板回到干净状态 |
+| `delete` 有子卡的父卡 | 400 `task has subtasks; detach or delete them first`（所以要按子树删/归档） |
+
+**AI 解析并拆分**（2026-10-24，真机点过一次，用的是宿主里配的 `deepseek-v4.1-flash`）：
+一段「做一个可视化计算器…」的原文，返回 5 条判据，页面自动拆成 6 张卡（父卡 + 4 子卡 + 验收卡），
+预览里逐张列出提示词。`/plan` 的两段提示词（解析、写卡）在同一轮里各调一次模型。
+模型不可用或关掉 `models.useModel` 时退回「格式规则解析 + 模板提示词」，并在提示里说明。
+
+**未验证**：`run` 的会话侧效果（真的开出一个会话并跑完）——那会真开会话计费，
+没有替你跑。第一次点运行时请留意看板是否解析出工作区与预设。
+`teamRun` 写进 create 信封后看板是否真的只起一个 Lead、把子卡派成 teammate，同样没跑过；
+看板自己的 `teamRunAvailable` 与「Agent Teams 服务缺失就拒绝运行」两道检查仍在它那边。
+
+**交付门槛现在到哪一步**：证据要求已写进每张开发卡的 prompt，验收卡独立存在、只给
+PASS/REJECT 并把结论落到 `out/<根卡 id>/verdict.json`——「证据从哪来、谁来验、结论放哪」都解决了。
+
+「打回之后谁重跑」现在有一个**人触发**的答案：`POST /rework` 读那个文件，按
+`gates.maxReworkRounds` 给出三种结局——`pass` 收尾、`rework` 返回重跑被拒卡片的 run 信封、
+`escalate` 停下来交给人（基线 R3）。没有轮询、没有定时器：人点一下才跑一次判定。
+
+为什么判定靠文件而不是看板状态：`GET /api/task-board/state` 走看板自己的信任栅栏，
+插件进程没有那张 cookie，**实测 403**；而且 `ExecutionRecord.result` 只记「执行成没成」，
+不记「验收判 PASS 还是 REJECT」。落盘的文件三方都能读，也才符合基线 P3。
+
+**还没做**：预算真正计数（需要调用方给 `runsToday` / `runningSessions`）、worktree 隔离、
+逐手台账、`skills/card-dispatch-org/SKILL.md` 的安装。
+
+## 8. 测试
+
+```powershell
+node test\run-all.mjs        # 155 个用例，全绿
+```
+
+十五个文件：`config`（收敛/兼容/合并）、`gates`（三个闸的判定顺序与理由）、
+`selfcheck`（体检判据）、`split`（拆分、信封、智能体团队、提示词覆盖）、`status`（所有路由）、
+`verdict`（结论文件契约）、`import`（文档解析）、`criteria`（规则提炼）、`models`（模型清单扫描）、
+`criteria-llm`（判据草稿的模型通道）、`parse-llm`（整段需求解析）、`prompts-llm`（按需求写每张卡的提示词）、
+`human-channel`（路由 + 两道门 + 依赖透传 + 闸门降级）、`console`（页面 id / 看板基址 / 旧机制痕迹清零）、
+`index`（导出形状 / 旧配置兼容 / apply 只挂路由 / 端到端打一次 /models）。
+
+模型相关的用例全部用假的 `llm` 服务：**不在测试里花真钱**。真模型的验证靠人点一次、
+看页面回的 `source: 'model'` 和实际文案。
+
+## 9. 文件
+
+| 文件 | 行数 | 作用 |
+|---|---|---|
+| `index.js` | ~90 | cordis 入口：`apply` 只注册路由，注入 `models` 依赖 |
+| `src/human-channel.js` | ~800 | 十一条路由、两道门（人标记 + 配置闸）、依赖透传 |
+| `src/split.js` | ~390 | 需求 → 卡片计划（唯一有「业务判断」的地方，纯函数） |
+| `src/gates.js` | ~120 | 三个闸：计划、预算、并发、打回次数 |
+| `src/config.js` | ~230 | 声明表 + 归一化 + 兼容旧键 |
+| `src/config-store.js` | ~90 | 配置读写（`<dataDir>/config.json` 优先） |
+| `src/selfcheck.js` | ~200 | 体检：看板在不在、模型清单、权限、委派深度 |
+| `src/catalog-source.js` | ~70 | 从宿主的 `cordis.patch.yml` 扫出可选模型 |
+| `src/model-call.js` | ~120 | 模型调用与 JSON 抽取（一次点击一次调用，45 秒超时） |
+| `src/criteria.js` | ~90 | 规则提炼判据（无模型时的退路） |
+| `src/criteria-llm.js` | ~125 | 判据草稿的模型通道 |
+| `src/parse-llm.js` | ~120 | 整段需求 → 标题 / 描述 / 判据：提示词 + 回复解析 |
+| `src/prompts-llm.js` | ~140 | 按需求给每张卡写提示词开头（结构不归它管） |
+| `src/import.js` | ~150 | `.md` / `.txt` / `.json` → 标题 / 描述 / 判据 |
+| `src/verdict.js` | ~120 | `verdict.json` 的读写与形状校验 |
+| `src/console.html` | ~950 | 控制台页面（单文件，无构建） |

package/cordis.patch.yml

@@ -0,0 +1,25 @@
+- insert:
+    - id: card-dispatch
+      name: 'dsh-card-dispatch'
+      config:
+        # 总开关：false 时只做「拆分 + 填卡」，不开任何会话、不产生费用。
+        enabled: false
+        # 新卡片钉住的权限预设；null 表示不改动（沿用看板默认）。
+        permission: workspace-write
+        # 数据目录（相对宿主 cwd；桌面端 cwd 是 profile 目录）。
+        # 面板改的开关会落到 <dataDir>/config.json，且**文件优先于本文件**。
+        dataDir: .card-dispatch
+        gates:
+          requirePlanApproval: true   # DAG 未经人确认不开跑（计划闸）
+          budgetPerDay: 200           # 每日运行次数预算（D10）
+          maxParallelRuns: 3          # 同时在跑的会话上限
+          maxReworkRounds: 2          # 打回上限，第 3 次升级给人（基线 R3）
+          requireEvidence: true       # 没有 commit / 报告不算完成（基线 P4）
+        org:
+          departments: [dev, verify, integrate]   # 基线 §12：第一版三个职能
+          depthRequired: 2                        # 主管要带人所需的委派深度（插件改不了，只体检）
+        execution:
+          driver: task-board          # 执行层驱动：任务看板（D-15）
+          teamRun: true               # 父卡起 Lead、子卡起 teammate
+        audit:
+          orgChart: true              # 拓扑事后稽查（人员越权在平台上已不可能）

package/icon.svg

@@ -0,0 +1,21 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 64 64" width="64" height="64" role="img" aria-label="Unattended Dev Ledger">
+  <defs>
+    <linearGradient id="ud-bg" x1="0" y1="0" x2="1" y2="1">
+      <stop offset="0" stop-color="#3b6fd4"/>
+      <stop offset="1" stop-color="#1e3a7a"/>
+    </linearGradient>
+  </defs>
+  <rect x="4" y="4" width="56" height="56" rx="14" fill="url(#ud-bg)"/>
+  <g fill="none" stroke="#ffffff" stroke-width="2.4" stroke-linecap="round">
+    <path d="M18 20h28"/>
+    <path d="M18 32h28"/>
+    <path d="M18 44h18"/>
+  </g>
+  <g fill="#8ec5ff">
+    <circle cx="24" cy="20" r="3.2"/>
+    <circle cx="33" cy="32" r="3.2"/>
+    <circle cx="21" cy="44" r="3.2"/>
+  </g>
+  <circle cx="47" cy="43" r="7.5" fill="none" stroke="#ffffff" stroke-width="2.6"/>
+  <path d="M52.4 48.4 57 53" stroke="#ffffff" stroke-width="2.6" stroke-linecap="round"/>
+</svg>

package/index.js

@@ -0,0 +1,88 @@
+/**
+ * 插件入口：**控制面**（配置 / 闸门 / 体检），执行面交给任务看板。
+ *
+ * 历史（偏差 D-14 / D-15）：这里曾经装着台账、20 行迁移规则、24 个模型工具、看门狗、
+ * 自动调度和自动开会话。真机验证后确认两件事：
+ *
+ *   1. 宿主不授权插件直调会话控制器（`sessionController` 是网关客户端，缺 peer 抛
+ *      `throwIfAborted` / `truncatedAt`），自己开会话这条路走不通；
+ *   2. 任务看板（`@linxin666/dsh-client-ui-task-board`）已经把「建卡 → 钉工作区/预设/
+ *      权限 → 开会话 → 跑 → 结算」做通了，且暴露 `POST /api/task-board/action`。
+ *
+ * 所以本插件的定位是：**平台没有的那三件事**——闸门、体检、人入口；执行一律外移。
+ * 反过来，平台已经保证的事（谁能给谁发消息、谁指挥谁、委派深度、计费）**不写**，
+ * 写进插件只会造成「以为拦住了」的错觉。
+ *
+ * 关于 inject：一个都不声明。`webServer` 由 human-channel 用 `ctx.inject(['webServer'], …)`
+ * 惰性获取——纯 CLI profile 里没有 webServer，硬依赖会让插件装不上（偏差 D-9）。
+ * 同样不导出 `export const Config`（有意避开 schemastery 依赖，偏差 D-7）。
+ */
+
+import { registerHumanChannel, HUMAN_ROUTE_PREFIX } from './src/human-channel.js'
+import { normalizeConfig, normalizeConfigDetailed } from './src/config.js'
+import { createConfigStore } from './src/config-store.js'
+import { loadCatalog } from './src/catalog-source.js'
+
+export const name = 'card-dispatch'
+
+// 测试与面板共用同一份收敛逻辑，避免「插件里一套、面板里一套」
+export { normalizeConfig, normalizeConfigDetailed }
+
+/**
+ * 取配置：**面板保存的文件优先于部署配置**。
+ *
+ * 理由：面板上的开关是「人此刻的意图」，重启后不该悄悄回退；而部署配置是安装时的
+ * 意图。文件里存的永远是归一化后的**完整**配置，所以不会出现半份配置的中间态。
+ * 想让部署配置重新生效，删掉 `dataDir/config.json` 即可（面板会把路径给出来）。
+ *
+ * @returns {{config: object, notes: string[], source: 'file'|'deploy', store: object, error: string|null}}
+ */
+function resolveConfig(rawConfig) {
+  const deployed = normalizeConfigDetailed(rawConfig)
+  const store = createConfigStore({ dir: deployed.config.dataDir })
+  const loaded = store.load()
+  const hasFile = loaded.error === null && Object.keys(loaded.config).length > 0
+  if (!hasFile) {
+    return { config: deployed.config, notes: deployed.notes, source: 'deploy', store, error: loaded.error }
+  }
+  const fromFile = normalizeConfigDetailed(loaded.config)
+  return { config: fromFile.config, notes: fromFile.notes, source: 'file', store, error: null }
+}
+
+export function apply(ctx, rawConfig = {}) {
+  const { config, notes, source, store, error } = resolveConfig(rawConfig)
+  const logger = typeof ctx.get === 'function' ? ctx.get('logger') : null
+
+  logger?.info?.(
+    `[card-dispatch] 已装载：控制台 ${HUMAN_ROUTE_PREFIX}（需求拆分 → 任务看板）；` +
+      `enabled=${config.enabled}；配置来源=${source === 'file' ? store.file : '部署配置'}`,
+  )
+  if (error !== null) logger?.warn?.(`[card-dispatch] ${error}（已退回部署配置）`)
+  for (const note of notes) logger?.warn?.(`[card-dispatch] ${note}`)
+
+  const dispose = registerHumanChannel(ctx, {
+    config,
+    store,
+    // 插件读不到部署的子智能体深度，也探测不了看板；两者都交给 /status 的体检去问人。
+    facts: () => ({ subagentDepthMax: null, boardReachable: null, boardTeamRun: null }),
+    /* 模型接口用宿主已经配好的那份：`llm` 是官方服务，模型清单读 profile 的
+       cordis.patch.yml。拿不到就返回 null，页面自动退回规则提炼。 */
+    models: {
+      llm: () => {
+        try {
+          return typeof ctx.get === 'function' ? ctx.get('llm') ?? null : null
+        } catch {
+          return null
+        }
+      },
+      catalog: () => loadCatalog(),
+    },
+  })
+  return () => {
+    try {
+      dispose?.()
+    } catch {
+      // 卸载失败不影响宿主回收 fiber
+    }
+  }
+}

package/locale/en.json

@@ -0,0 +1,6 @@
+{
+  "meta": {
+    "title": "Card Dispatch · Requirement → Task Board",
+    "description": "Splits a requirement into task-board cards. Execution, sessions and accounting belong to the task-board plugin."
+  }
+}

package/locale/zh.json

@@ -0,0 +1,6 @@
+{
+  "meta": {
+    "title": "派卡台 · 需求 → 任务看板",
+    "description": "把需求拆成任务看板卡片：拆分在本地完成，执行、会话与结算交给任务看板插件。"
+  }
+}

package/package.json

@@ -1,6 +1,58 @@
 {
   "name": "dsh-card-dispatch",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.0",
+  "type": "module",
+  "description": "派卡台开发的上游：把需求拆成任务看板卡片（执行交给 dsh-client-ui-task-board）",
+  "keywords": [
+    "dsh",
+    "deepseek-harness",
+    "dsh-plugin",
+    "task-board",
+    "card-dispatch",
+    "requirement-split",
+    "prompt"
+  ],
+  "license": "MIT",
+  "author": "yangchaoran",
+  "repository": {
+    "type": "git",
+    "url": "git+https://gitee.com/past-events-sifenruwu/dsh-card-dispatch.git"
+  },
+  "homepage": "https://gitee.com/past-events-sifenruwu/dsh-card-dispatch#readme",
+  "bugs": {
+    "url": "https://gitee.com/past-events-sifenruwu/dsh-card-dispatch/issues"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "exports": {
+    ".": "./index.js",
+    "./client": "./src/client/index.js",
+    "./locale/*.json": "./locale/*.json",
+    "./icon": "./icon.svg"
+  },
+  "files": [
+    "index.js",
+    "src",
+    "cordis.patch.yml",
+    "locale/*.json",
+    "icon.svg",
+    "README.md"
+  ],
+  "scripts": {
+    "test": "node test/run-all.mjs",
+    "test:node": "node --test test/"
+  },
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    },
+    "client": {
+      "platform": "web",
+      "immediately": true,
+      "inject": [
+        "@deepseek-ai/dsh-client-ui-slots"
+      ]
+    }
+  }
+}

package/src/catalog-source.js

@@ -0,0 +1,122 @@
+/**
+ * catalog-source.js：把「宿主已添加的模型」从磁盘读出来。
+ *
+ * 真相在 profile 的 `cordis.patch.yml`（provider 插件把 models 写在那里）。
+ * 本文件负责找文件、读文件；解析优先用 `yaml` 包，解析不到就退回 models.js
+ * 里的纯文本扫描（插件是 junction 进来的，yaml 不一定解析得到）。
+ *
+ * 缓存按 mtime：设置里加了模型，刷新页面就能看到，不用重启。
+ */
+
+import { readdirSync, readFileSync, statSync } from 'node:fs'
+import { homedir } from 'node:os'
+import { join } from 'node:path'
+
+import { buildCatalog, scanProviders } from './models.js'
+
+/** 进程内缓存：同一次运行里反复点「生成」不该反复读盘。 */
+let cache = { file: null, mtimeMs: 0, catalog: null, error: null }
+
+/**
+ * 找出该读哪个 profile 的配置。
+ *
+ * 机器上可能有好几个 profile（desktop / personwork…），插件不知道宿主跑的是哪个。
+ * 规则：**先只考虑声明了本插件的**（那才是宿主真在用的），再取最近改过的；
+ * 时间一样就优先叫 desktop 的（桌面端默认 profile），否则按名字排——保证确定性。
+ *
+ * @param {object} [options]
+ * @param {string} [options.home] 用户目录（测试里可替换）
+ * @returns {string|null}
+ */
+export function findProfileConfig({ home = homedir() } = {}) {
+  const root = join(home, '.dsh', 'profiles')
+  let names = []
+  try {
+    names = readdirSync(root, { withFileTypes: true })
+      .filter((entry) => entry.isDirectory())
+      .map((entry) => entry.name)
+      .sort()
+  } catch {
+    return null
+  }
+
+  const candidates = []
+  for (const name of names) {
+    const file = join(root, name, 'cordis.patch.yml')
+    try {
+      const stat = statSync(file)
+      let mentions = false
+      try {
+        mentions = readFileSync(file, 'utf8').includes('card-dispatch')
+      } catch {
+        mentions = false
+      }
+      candidates.push({ file, name, mtimeMs: stat.mtimeMs, mentions })
+    } catch {
+      /* 这个 profile 没有配置文件，跳过 */
+    }
+  }
+  if (candidates.length === 0) return null
+
+  const preferred = candidates.filter((item) => item.mentions)
+  const pool = preferred.length > 0 ? preferred : candidates
+  pool.sort((a, b) => {
+    if (b.mtimeMs !== a.mtimeMs) return b.mtimeMs - a.mtimeMs
+    if (a.name === 'desktop') return -1
+    if (b.name === 'desktop') return 1
+    return a.name < b.name ? -1 : 1
+  })
+  return pool[0].file
+}
+
+/**
+ * 读模型目录（带 mtime 缓存）。
+ *
+ * @param {object} [options]
+ * @param {string} [options.home]
+ * @param {string} [options.file] 直接指定配置文件（测试用）
+ * @returns {Promise<{file:string|null, catalog:{default:string|null, groups:Array}, error:string|null}>}
+ */
+export async function loadCatalog({ home, file } = {}) {
+  const target = file ?? findProfileConfig(home === undefined ? {} : { home })
+  if (target === null) {
+    return { file: null, catalog: { default: null, groups: [] }, error: '没找到 profile 的 cordis.patch.yml' }
+  }
+  let mtimeMs = 0
+  try {
+    mtimeMs = statSync(target).mtimeMs
+  } catch (error) {
+    return { file: target, catalog: { default: null, groups: [] }, error: `读不到配置：${error.message}` }
+  }
+  if (cache.file === target && cache.mtimeMs === mtimeMs && cache.catalog !== null) {
+    return { file: target, catalog: cache.catalog, error: cache.error }
+  }
+
+  let text = ''
+  try {
+    text = readFileSync(target, 'utf8')
+  } catch (error) {
+    const catalog = { default: null, groups: [] }
+    cache = { file: target, mtimeMs, catalog, error: `读不到配置：${error.message}` }
+    return { file: target, catalog, error: cache.error }
+  }
+
+  // 先试 YAML 解析（结构最准）；包不在或有语法错，都退回文本扫描
+  let catalog = null
+  let error = null
+  try {
+    const { parse } = await import('yaml')
+    catalog = buildCatalog(parse(text))
+  } catch (yamlError) {
+    try {
+      catalog = scanProviders(text)
+    } catch (scanError) {
+      catalog = { default: null, groups: [] }
+      error = `解析配置失败：${String(scanError?.message ?? scanError)}`
+    }
+  }
+  if (catalog.groups.length === 0 && error === null) error = '配置里没读到 providers（设置里还没添加模型？）'
+
+  cache = { file: target, mtimeMs, catalog, error }
+  return { file: target, catalog, error }
+}