@lynn123411/dsh-subagent-judge-dispatch 0.0.0-stage → 0.1.3

package/DETAILS.md

@@ -0,0 +1,81 @@
+# @lynn123411/dsh-subagent-judge-dispatch 详情
+
+> 本文档是 [README.md](./README.md) 的补充：装配形态、开发副本与验证。
+
+## 装配形态
+
+装进 profile 一条命令即可，在 profile 里不用手写任何补丁：
+
+```bash
+dsh plugin --profile web add @lynn123411/dsh-subagent-judge-dispatch
+```
+
+这条命令把包名写进 profile 的 `dependencies`，并登记进 `dsh.profile.bundles`；包内 `cordis.patch.yml` 随之插入一条根层行：
+
+```yaml
+- insert:
+    - id: dsh-subagent-judge-dispatch
+      name: '@lynn123411/dsh-subagent-judge-dispatch'
+```
+
+这条行同时承载两个半边：宿主半边在那条行下注册插件本体，浏览器半边由 Web shell 按 root loader 的 enabled entry 依据 `dsh.client` 声明服务 `lib/client.js`。行不写 `config`——配置一律经插件页的卡片读写，避免出现第二处真相。
+
+宿主半边声明的服务（`inject`）：`credentials`、`sessions`、`sessionTitle`；`connection` 经 `ctx.inject` 取，取不到时插件照常加载、只是没有那三条读取通道；`settings` 同样经 `ctx.inject` 取，用来声明本条目不走宿主自动生成的设置页。
+
+客户端半边有两层声明，两层都要写（见 `docs/rules/client-wiring.md`）：
+
+- **cordis 服务名**（`src/client/index.ts` 的 `inject`）：`slots`、`configForms`、`remote`、`remote.session`、`remote.credentials`、`locale`。`remote.session` 读模型目录，`remote.credentials` 写判断密钥。
+- **插件契约包名**（`package.json` 的 `dsh.client.inject`）：`@deepseek-ai/dsh-client-locale`、`@deepseek-ai/dsh-client-ui-settings`、`@deepseek-ai/dsh-client-ui-plugin-manager`、`@deepseek-ai/dsh-client-ui-renderer`、`@deepseek-ai/dsh-client-ui-primitives`。
+
+少声明一个不会报错，只会让插件在页面里消失。
+
+配置卡片的 key 是**包名**，卡片读写的命名空间是**本插件 Loader 行的 id**（同一个字面量 `dsh-subagent-judge-dispatch`）——两者是不同的字面量，写歪一个的症状是配置永远不出现。
+
+## 判断与改写
+
+- **插手位置**：宿主的 `agent/request` 瀑布。注册在根层上下文，所以每个代理的每次请求都会经过；插件自己用 `subagentDepth`（会话头里的 `delegationDepth` 与运行时 `options.subagentDepth` 取较大者）筛出子代理。
+- **判断次数**：按子代理 id 记住已判过的，一个跑十步的子代理只问一次。
+- **任务文字**：只读子代理自己产生的那段事件——先取它自己最后一条 `subagent/descriptor` 的 `label`（就是派工时写的一句话描述），没有时取它自己的头一条用户消息正文。**不能从日志开头读**：fork 出来的子代理，日志前缀是父代理已完成的回合，从开头读会把祖先的标签和父对话的第一条消息送给判断模型。
+- **判断协议**：`POST` 到页面填的地址，请求体 `{ model, state: { message }, questions }`；`questions` 只有一个 `task_type`，类型是 `choice`，`criteria` 就是你的类型清单（键是编号、值是你写的描述），答复取被选中选项的编号。
+- **写入铁律**：模型、强度、提供方三项一起写。`resolveChildAgentOptions` 在「换了模型但没给强度」时会删掉继承来的强度，所以三项必须同进同出。
+- **兜底**：任何失败都一个字段都不写，把宿主解析好的那个调用配置按身份原样退回——不是「把主代理的值再写一遍」，而是根本不碰它。这是 `decideRewrite` 返回 `none`、`applyDecision` 原样返回入参所保证的。
+
+## 配置卡片
+
+- **试通不依赖类型清单**：连通性检查问的是「这个地址与模型能不能答」，所以它自己带一个选项发给判断服务，与读者写没写类型无关——清单是判断时才需要的输入，拿它当能不能测的前提，会让空清单的读者以为服务坏了。返回的原因是连通性本身：`unconfigured`（地址或模型没填）、`unreachable`、`timeout`、`unmatched`。
+- **两节各存各的**：判断服务（含两个开关、端点、判断模型、密钥）与任务类型清单各有一个保存按钮，各写自己那几个字段。类型清单那一节的描述空着或两条重了时，只有它自己的保存会拒绝并弹窗说明；判断服务那一节照常能存。保存失败的提示也按节归位，不会跑到另一节下面去。
+- **保存按下之后**：密钥先写，再写设置。密钥没写进去就不再动设置；设置被宿主拒绝（共享配置表单 resolve `false` 是拒绝，不是异常）时页面必须报没存上，不能显示成已保存。
+- **草稿按字段保留**：宿主每次发布配置，只有读者改过、且改动与「本页上次看到的已提交值」不同的那一项才留在页面上，其余跟着宿主走。按整节保留会让一次保存把读者没碰过的字段写回去，等于撤掉别的页面刚做的改动。
+- **放弃改动只丢草稿**：放弃判断服务那一节，只清掉还没交出去的文本与那几项设置；密钥已经存进凭据文件，页面不会因此改口说「还没有密钥」。
+- **密钥固定引用**：引用名是插件自己的常量 `SUBAGENT_JUDGE_API_KEY`，不是页面填的字段——读者只要把密钥贴进来，不必知道什么是凭据引用。密钥值交给凭据服务之后立刻从页面状态里清掉，`scripts/test-card.mjs` 有一条断言守着它不出现在状态里。密钥格与上面两格同宽；页面没有凭据通道（非回环地址）时，输入框与「删掉密钥」都禁用，并有一行字说明原因。
+
+## 开发副本
+
+运行副本用 `link:` 连到本仓库目录，改完即生效（细则见仓库 `docs/rules/dev-copy.md`）：
+
+```bash
+cd ~/.dsh/profiles/web && pnpm add "link:<my-dsh 绝对路径>/plugins/dsh-subagent-judge-dispatch" --offline
+cd <my-dsh 绝对路径>/plugins/dsh-subagent-judge-dispatch && pnpm install && pnpm build
+```
+
+客户端半边改完刷新页面即生效，必要时强制刷新一次；宿主半边改完要触发一次 profile 重新组合——在插件页或 `plugin_manager` 里把本插件关一次再开一次，不必重启进程。
+
+## 验证
+
+在包目录跑一条链：
+
+```bash
+cd plugins/dsh-subagent-judge-dispatch && pnpm check
+```
+
+`check` = `typecheck` + `build` + 四个自检 + `assert:lib-untracked`：
+
+- **`scripts/test-decision.mjs`** 打的是 `src/`（Node 直接跑 `.ts`），守判断与改写这条纯逻辑：失败时**按身份**退回同一个对象（不是深比较——深比较会放过「复制一份再写回原值」这种仍然算覆盖的写法）、三项同写、残缺行不生效、答复读取的三种形状与七种空答复、四种失败原因各自的归类、超时不重试、日志留 20 条且读出来是副本、编号按位置从 1 连着。
+- **`scripts/smoke-host.mjs`** 起真 cordis `Context`，把 `agent/request` 瀑布按宿主的方式跑一遍（`await next()` 拿到解析好的配置，再把返回值交给断言）：主代理不被判断、同一子代理只判一次、两个开关各自的短路、发送出去的请求体形状、没有描述时取任务正文、fork 子代理只读自己的事件、判断过的记忆有上限。
+- **`scripts/smoke-client.mjs`** 按 Web shell 的方式装载 `lib/client.js`（`window.__ModuleLoader__.load` 桩件），喂假 cordis 服务：断言卡片注册进 `plugins.bundle.config`、key 是包名、走 `slots.inject`、读本插件自己的命名空间与宿主那份「子代理可选用哪些模型」设置、以宿主在服务本条目为挂载条件、样式表在 `apply()` 追加一次且没写死色值，以及 zh/en 键集一致。它的守卫带反例断言（「守卫拒绝未声明的服务读取」必须抛），否则那一串绿灯是假的。
+
+- **`scripts/test-card.mjs`** 打的是 `src/`，守配置卡片这层状态机：两节各存各的、清单没填全不挡端点、宿主回 `false` 算没存上、密钥跟着判断服务那次保存一起写且写的是固定引用名、密钥值从不进页面状态、草稿按字段保留（宿主改了一项而我在改另一项时，保存只写我改的那一项）。
+
+`lib/` 是构建镜像，`assert:lib-untracked` 判它没被 git 跟踪。
+
+要肉眼确认页面上的形态，用仓库的 `node tools/verify-client.mjs dsh-subagent-judge-dispatch --needle '<你新写的文案>'`。

package/README.md

@@ -1,3 +1,28 @@
-# Temporary Holding Version
+# @lynn123411/dsh-subagent-judge-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.
+派工时让一个判断模型从你自己写的任务类型清单里挑一个编号，据此改写这个子代理使用的模型与思考强度。
+
+## 功能
+
+- **按任务类型指派**：每次派工把任务文字交给判断服务，由它从你的类型清单里挑一个编号，插件按这个编号对应的设置改写子代理的模型与思考强度。
+- **清单由你写**：任务类型是一张表格，每一行写一段判定依据、选一个模型、选一个思考强度；模型与强度两栏各是一个下拉。模型从宿主那份「子代理可选用哪些模型」设置里读，强度从该模型自己声明的档位里读。
+- **预制词条**：研发流程常见的八类活各带一句判定依据和一句建议强度，点一下就把这句依据写进描述列，写进去之后就当是你自己写的。建议强度只是提示，模型与强度两栏不会自动填。
+- **完整预览**：看一眼真正会发给判断服务的整段内容，任务文字那一处标注「派工时才填」。
+- **当场试通**：判断服务的地址填完就能试一下通不通，不用等第一次派工失败。
+- **密钥直接填**：判断服务要用的密钥就填在配置卡片里，存进 DSH 的凭据文件，只写不读；页面不会把它显示回来。
+- **结果日志**：每个判过的子代理记一行——供应商、模型、强度、时间、耗时；点开一行看详情，里面有结果来源、原因、主会话标题与子代理描述。只活在本次运行期间，重启即清空。
+
+## 特性
+
+- **只改两样**：只改写子代理使用的模型与思考强度，不改名字、不改标题、不动主对话，其余一概沿用 DSH 原本的派工流程。
+- **判断永不打断派工**：连不上、超过 5 秒、答复对不上清单、答复为空，这四种都算判断失败；失败时一个字段都不写，子代理原样继承主代理的模型与强度，不重试。代价是每次派工最多多等 5 秒。
+- **每个子代理只判一次**：判断挂在宿主公开的那条「每次模型请求」钩子上，由插件自己记住已经判过的子代理，所以一个跑十步的子代理也只问一次。
+- **分节保存**：判断服务与任务类型清单各有一个保存按钮。两边改的时间不同、出错的原因也不同，合成一次保存会让一句没写完的描述挡住端点地址的修改。
+- **密钥只写不读**：密钥值一交出去就不再留在页面状态里；页面只显示「已存 / 还没有」，以及一个删掉它的按钮。
+- **形态与装配**：bundle 型插件，装完即用、在 profile 里不用手写补丁；装配、开发副本与验证见 [DETAILS.md](./DETAILS.md)。
+
+## 安装
+
+```sh
+dsh plugin --profile web add @lynn123411/dsh-subagent-judge-dispatch
+```

package/assets/icon.svg

@@ -0,0 +1,5 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round">
+  <rect x="3.5" y="3.5" width="17" height="17" rx="4"/>
+  <path d="M12 8.5v7"/>
+  <path d="M8.5 12h7"/>
+</svg>

package/cordis.patch.yml

@@ -0,0 +1,11 @@
+# @lynn123411/dsh-subagent-judge-dispatch bundle patch
+# 声明在 package.json 的 dsh.bundle.patch，`dsh plugin --profile web add` 后自动并入 profile 层栈。
+#
+# 这一条 insert 行同时承载两个半边（见 docs/rules/client-wiring.md）：
+#   - 宿主半边：在那条行下注册插件本体（上面 src/index.ts 的 apply）。行在 root 层，
+#     所以它落进全局层；要收窄到某个 preset，就在 preset 的 config.plugins 里另注册一行。
+#   - 浏览器半边：这条行是 root loader entry，dsh-client-modules 只对 root loader 的
+#     enabled entry 依据 dsh.client 声明服务浏览器半边（lib/client.js）。
+- insert:
+    - id: dsh-subagent-judge-dispatch
+      name: '@lynn123411/dsh-subagent-judge-dispatch'