dsh-plugin-t-expert 0.3.6 → 0.3.24

package/README.md

@@ -1,166 +1,54 @@
 # T专家（dsh-plugin-t-expert）
 
-DeepSeek Harness 插件：**22 个分类 / 316 位专家**的名册（中文名、简介全量覆盖，人格正文回退英文 2 位），
-外加插件内自带的**多智能体团队引擎**（小队模板、任务 DAG、调度、活动面板）。
+dsh-plugin-t-expert 插件：包含 **22 个分类 / 316 位专家**的名册（中文名、简介全量覆盖），
+外加插件自带的**多智能体团队引擎**（T Team：小队模板、任务 DAG、调度、活动面板）。
 
 装上以后你能做四件事：
 
 | 做什么 | 怎么做 |
 | --- | --- |
-| 用专家 | 输入框打 `@` → 按分类分组的菜单 → 选中的专家作为引用 chip 进本轮对话；模型也可用 `summon_t_expert` 召唤 |
+| 用专家 | 输入框打 `@` → 按分类分组的菜单 → 选中的专家作为引用 chip 进本轮对话；模型也可自行 `summon_t_expert` |
 | 拉起一支小队干活 | `/t <小队> <目标>`（`/t` 单跑列出现有小队） |
 | 管名册 | 设置 → T专家 → **专家**（启停 / 看提示词 / 新建自建专家） |
-| 管分类与小队 | 设置 → T专家 → **分类**（新建 / 改名 / 删除自建分类）、**队伍**（小队模板 + 运行中的团队） |
+| 管分类与小队 | 设置 → T专家 → **分类**（自建分类增删改）、**队伍**（小队模板 + 运行中的团队） |
 
-设置页一共**三个标签**：**专家**（启停 / 看提示词 / 新建自建专家）、**分类**（自建分类的增删改）、
-**队伍**（小队模板 + 运行中的团队）。
-
-真实的后台任务列表不在设置页。右上角有一个**常驻的小徽章**（与团队徽章同一层、同一视觉体系），
-它是随时点开查看的入口；只有真的还有东西在跑时才亮起来并给出运行中数量（安静时只是一个灰点，不显示数字），
-点开就是任务面板：当前会话及其子代理的后台任务，只读（状态、退出码与耗时，
-不含输出与终止）。面板可拖动，位置记在本机。
-
-徽章只在"从无到有"时冒出，**面板绝不自动展开**——展开与否完全由你决定，关掉之后同一批任务不会再打扰你。
-子代理区显示的是**子代理的真名**（取自语宿主的子代理目录 `label`，而不是从提示词生成的会话标题），
-点一行即可跳到那个子代理的会话（与官方任务页同一个 `openSubagent` 接口）。
-每行副标题显示该子代理的**请求文本前一段**（会话标题就是从它生成的），并标注运行中/已结束；
-列表顺序沿用宿主子代理目录的原生次序——与官方任务页一致（快照里没有创建时间字段，不自造一种序）。
-输入区 **T专家** 按钮弹开的浮层里有四个标签：**专家 → 小队 →（有运行中的团队时才出现）团队 → 任务**，
-点开时默认停在**专家**标签（这个浮层主要就是用来挑专家的）。
-
----
-
-## 一、安装
+## 安装
 
 ```bash
 dsh plugin --profile web add dsh-plugin-t-expert
 ```
 
-**DSH Desktop 请在插件市场里装**（搜 `dsh-plugin-t-expert` 一键安装）。
-`dsh plugin --profile desktop …` 会被 CLI 拒绝（desktop profile 由 Electron 应用独占），
-这不是本插件的限制——任何插件都一样。
-
-依赖：DSH 宿主 `0.1.5-rc.1` / `0.1.5-rc.2`；Node `^22.19.0 || >=24`；`pnpm` 在 PATH 上
-（`dsh plugin` 本质是在 profile 目录里转发 pnpm）。`python3` 只在**设置页保存小队**时需要
-（要调用小队编译器）；缺它插件照常加载，只是小队编译会报错并回滚。
-
-装完重启 DSH，然后在 **设置 → T专家** 里启用专家——**默认全部未启用**，未启用的专家不能被召唤。
-
-### 兼容性与两个已知依赖
-
-团队引擎里有两处**贴着宿主实现细节**的适配，升级 DSH 前值得知道：
-
-| 依赖 | 说明 | 失效时的表现 |
-| --- | --- | --- |
-| 子代理投递契约（`ctx.subagents` 的 `followup` / `sendMessage` 与两个 `Symbol.for` 内部接口） | 插件要在"成员已退役"时拦住投递，而宿主没有公开的 retire/forget 扩展点，只能按**实测过的版本**包装这几个方法；已实测版本写在 `lib/teams/harness-compat.js` 的 `TESTED_HARNESS_VERSIONS`（当前 `0.1.5-rc.1` / `rc.2`） | 引擎**降级**（团队功能不可用，名册与召唤不受影响），日志与 `/t` 会给出原因。若上游把服务冻结或改成 accessor，会明确报「属性不可写」而不是一个裸 `TypeError` |
-| 活动面板的客户端物化用 `new Function` 求值内联产物 | 因此需要宿主允许 `eval`。当前 DSH 壳**没有**设置 CSP，本机实测可用 | 壳将来若加严格 CSP，面板模块会加载失败——失败会记 `console.error` 并跳过，不影响名册与团队引擎 |
-
-这两条都不是"插件写坏了"，而是宿主还没提供文档化扩展点。要根治第一条，需要宿主提供一个
-文档化的退役/投递拦截扩展点，插件改为挂在那里。
-
----
-
-## 二、数据目录
-
-插件对任何机器都**自包含**：包内带一份名册快照，启动时与 `~/.t-team/` 对齐（不是只在首次播种）。
-
-```
-~/.t-team/
-├── experts/              名册：<分类>/<slug>.md（22 个分类、316 位）
-├── zh/                   中文侧车：names.json、descriptions.json、<分类>/<slug>.md、divisions.json
-├── custom/               你在面板里自建的专家
-├── teams.json            小队定义（设置页「队伍」写回这里）
-├── schedule.json         定时任务：任务、cron 表达式与最近 20 次执行记录
-├── t-team.config.json    小队编译产物（引擎配置，人格已内联）
-├── teams.resolved.json   小队编译产物（/t 列表用）
-├── team-profiles.py      小队编译器的播种副本（实际跑的是包内那份）
-├── source.json           名册清单（专家数 / 分类 / 更新时间）
-└── .t-team-snapshot.json 上次对齐的记录（版本 / 漂移计数，用于「升级与送不到」出声）
-```
-
-- **升级会送达，用户内容不动**（2026-09-13 起按条目同步，不再是「首次播种后一律不动」）：
-  - 包内**新增**的专家、小队、译文键：直接补齐到你的数据目录；
-  - 包内**修订**的只读条目（`experts/`、`source.json`、`team-profiles.py`、`zh/` 的覆盖表与分区表）：
-    与包内对齐；
-  - `zh/names.json`、`zh/descriptions.json`、`teams.json`：**只补缺失的键**，你改过的键一个都不动；
-  - 你改过或补译的 `zh/<分类>/<slug>.md` 正文：**保留盘上那份**，并在日志里明确告知；
-  - 包内已移除的条目：只报告，不删你的文件。
-- 一句话：**送得到的送到，送不到的一定出声**（日志里给出数量与例子，删掉对应文件后重启即可重新播种）。
-- 唯一始终用包内那份的是小队编译器 `team-profiles.py`——它是代码，随插件版本走。
-- 想换目录位置，用配置项 `root` / `zhRoot` / `customRoot` 覆盖即可，不必改代码。
-- `schedule.json` 是**定时任务自己的数据文件**（见第三节）：它在数据根下、与 `teams.json` 同级，
-  刻意不写进宿主的存储域，也不与其它定时插件（例如 `@weibaohui/dsh-tasks`）共享任何文件。
+DSH Desktop 请在插件市场里搜 `dsh-plugin-t-expert` 安装（`--profile desktop` 由 Electron 应用独占，
+CLI 会被拒绝 —— 任何插件都一样）。
 
----
+- 依赖：DSH 宿主 `0.1.5-rc.1` / `0.1.5-rc.2`；Node `^22.19.0 || >=24`；`pnpm` 在 PATH 上。
+  `python3` 只在**保存小队**时用到（缺它插件照常加载，只是小队编译会报错并回滚）。
+- 装完**重启 DSH** 即可用；第一次怎么上手见下面的「快速上手」。
 
-## 三、定时任务
+## 快速上手
 
-到点自动**新开一个会话**、把提示词交给它执行——也可以随时手动「立即执行」。
+1. **启用专家**：设置 → T专家 → **专家**，把要用的打开 —— **默认全部未启用**，未启用的不会被召唤。
+2. **用一位专家**：输入框打 `@`，按分类挑一位，它以引用 chip 进入本轮对话；也可以直接说"让 XX 专家看看"，
+   由模型调 `summon_t_expert`。
+3. **拉一支小队**：`/t` 看有哪些小队（随包自带 48 支），`/t <小队> <目标>` 让它干活 —— 先给成员与任务草案，
+   你 review 后开跑。
 
-**入口在哪**：Web UI 左侧栏**「新会话」按钮正下方**那一行「定时任务」（与「新会话」同款按钮外观：
-38px 高、12px 圆角、同样的边框与抬升填充；侧栏收起时退回图标态）。
-点开后在**右侧主区域**直接显示管理页（不是设置弹窗里的一个小节）。点左侧任意会话即回到会话视图。
+## 界面入口
 
-**能做什么**：
-
-| 能力 | 说明 |
+| 位置 | 是什么 |
 | --- | --- |
-| cron 定时执行 | 每条 = 标题 + 提示词 + 五段 croner 表达式（`分 时 日 月 周`） |
-| 结构化选择器 | 快捷模板（每小时整点 / 每 30 分钟 / 每天 9:00 / 工作日 8:30 / 每周一 10:00）；按「每小时 / 每天 / 每周 / 自定义」逐级选；周几多选；也可直接写原始表达式 |
-| 实时预览 | 选定后在面板上显示**最近 5 次执行时间**（由宿主用 croner 计算，保存前就能确认周期对不对） |
-| 立即执行 | 任意一条都能一键跑一次，不必等 cron 到点 |
-| 绑定工作区 | 可选；绑定后会话挂到该工作区并继承其目录，执行记录里也会标出工作区 |
-| 会话自动命名 | 执行出来的会话叫「任务标题 · MM-DD HH:mm」，同一任务多次运行在侧栏里能一一区分 |
-| 执行记录 | 每条保留最近 20 次（时间、成败、失败原因、会话 id），可展开追溯 |
-| 启用/停用 | 停用的事项保留数据但不再定时触发 |
-| 点名专家 | 提示词框下面有「🧩 T专家」按钮：浮层只列**已启用**专家（可搜、可键盘选），选中后把 `@专家名` 填进提示词 —— 与对话输入框里那个专家芯片同一形态。**可以点选多位**（列表里打勾标记，再点一次即取消） |
-
-**点名专家怎么生效**：提示词开头的 `@A @B …` 在到点执行时由宿主改写成一句明确的召唤指令，并把这些
-提及从正文里摘掉：**点名一位**用 `summon_t_expert`，**点名多位**改用 `summon_t_experts` 批量并行召唤。
-之所以要改写：新会话没有对话输入框那套引用芯片机制，光留几个名字模型不一定会去请人。
-名字判据是中文名 / 英文名 / slug 三种都认（互为子串时取更长的那个），**不在已启用名册里就原样提交、
-绝不猜**；面板会实时显示「到点执行时会召唤「X」」或「会同时召唤「X、Y」」，重复挑选同一位是
-**取消**而不是叠加。
-
-**到点执行会发生什么**：新建会话 → 挂载部署的默认 agent preset（不挂 preset 的新会话没有工具）→
-写入会话标题 → 以 **插件来源**（`plugin: dsh-plugin-t-expert`）提交你的提示词。
-绑定工作区的工作区若已被删除，这次执行会记一条失败原因，不会静默。
-
-**功能开关**：设置 → T专家 → 「显示定时任务按钮」（在「显示任务徽章」下面）。
-**关掉它不是仅仅藏按钮**：宿主会**同时停掉全部定时触发**，手动执行也会被拒；任务与执行记录完整保留，
-重新打开立刻按 stored 状态恢复调度。这样做是为了不出现「以为关了、其实 cron 还在后台开新会话」。
-
-**与 `@weibaohui/dsh-tasks` 的关系（可同时安装、同时使用）**：
-
-| 维度 | 本插件 | `@weibaohui/dsh-tasks` |
-| --- | --- | --- |
-| 数据 | `~/.t-team/schedule.json` | 宿主存储域 `dsh_tasks` |
-| 侧栏入口 | `sidebar.panellist`（id `t-team-schedule`，「新会话」下方那一组） | 设置面板内的 section |
-| 右侧页面 | `main` 槽 keyed 面板（key `t-team-schedule`） | 同上（设置内一节） |
-| remote 服务 | `tTeam` / `tTeamSchedule` | 自有 HTTP 路由 `/dsh-tasks/api` |
-| 消息来源 | `plugin: dsh-plugin-t-expert` | `plugin: dsh-tasks` |
-| locale 命名空间 | `t-team`（键前缀 `sched.`） | `settings.dshTasks` |
-| CSS 前缀 | `t-team-sched-*` | `si-*` |
-
-两者各跑各的定时器、各存各的任务，互不可见也互不干扰；只有 croner 是共用依赖（各装各的）。
+| 设置 → T专家 | 管理页，一共**三个标签**：**专家**（启停 / 提示词 / 新建自建专家）、**分类**（自建分类增删改）、**队伍**（小队模板 + 运行中的团队） |
+| 输入框 `@` | 按分类分组的专家菜单，选中即插入引用 chip |
+| 输入区「T专家」按钮 | 浮层四个标签：**专家 → 小队 →（有运行中的团队时才出现）团队 → 任务**，默认停在**专家** |
+| 会话标题栏徽章 | 后台任务只读面板（当前会话及其子代理的任务：状态、退出码、耗时）；只在真有任务在跑时亮起并给出数量，**面板绝不自动展开**，可拖动、位置记在本机 |
+| 左侧栏「新会话」下方 | **定时任务**入口（与「新会话」同款按钮外观），点开在右侧主区域显示管理页；点任意会话即回到会话视图 |
 
----
+## 专家
 
-## 四、自建专家与分类
-
-**新建专家**：设置 → 专家 → 「＋ 新建专家」，选分类（官方 22 个或你自建的），填名称 / 简介 / 人格正文。
-
-- 自建专家写在 `customRoot`（默认 `~/.t-team/custom/<分类>/<slug>.md`），**与随包发布的名册分开**：
-  内置名册升级时整棵替换，自建的不受影响。
-- 归到官方分类名下是**允许且安全**的：分类只是归属，文件仍在 `customRoot`，内置名册一个字节不动。
-- 自建专家自带中文（frontmatter 里的 `name` 就是显示名），不依赖中文侧车。
-
-**新建分类**：设置 → 分类 → 填目录名（小写 ASCII）+ 显示名（中文）。
-官方分类只读（名字与存亡随包内名册）；删除自建分类时若里面还有专家会被拒绝，不会静默连删。
-
----
-
-## 五、工具与命令
+- 名册随包发布，启动时与 `~/.t-team/` 对齐（按条目送达，见「数据目录」）。
+- **自建专家**：设置 → 专家 → 「＋ 新建专家」，写在 `customRoot`（默认 `~/.t-team/custom/<分类>/<slug>.md`），
+  与内置名册分开 —— 内置名册升级时整棵替换，自建的不受影响；归到官方分类名下也安全（分类只是归属）。
+- **自建分类**：设置 → 分类 → 目录名（小写 ASCII）+ 显示名。官方分类只读；删除自建分类时若里面还有专家会被拒绝。
 
 | 工具 | 作用 |
 | --- | --- |
@@ -169,160 +57,95 @@ dsh plugin --profile web add dsh-plugin-t-expert
 | `summon_t_experts` | 并行召唤多位（最多 8 位、并发 4；部分失败仍返回成功的结果） |
 | `t_team_plan_check` | 只读 DAG 预检：一批团队任务先跑一遍引擎校验，一次报出全部问题 |
 
-| 命令 | 行为 |
-| --- | --- |
-| `/t` | 列出所有小队（key、别名、人数、成员中文名） |
-| `/t <小队\|别名>` | 选定小队，队长列出成员并问你目标 |
-| `/t <小队\|别名> <目标>` | 拉起小队干活（先给成员与任务草案，你 review 后开跑） |
-| `/t <一句话目标>` | 没匹配到小队名时，按目标自动挑最合适的小队 |
-
-团队引擎另注册 **13 个 `t_team_*` 工具**（`t_team_create` 建队、`t_team_approve` 审批、
-`t_team_create_task` 建任务、`t_team_reassign_task` 派发、`t_team_status` 看状态、`t_team_resume` 恢复等），
-随插件一起提供；队长与成员各看到其中一个子集。
-
-另有 **3 个按需加载的 skill**（`skills/`，插件启动时注册）：
+## 小队与团队引擎
 
-| skill | 何时用 |
-| --- | --- |
-| `t-expert-manager` | 维护这个名册的人：名册增删、一致性校验、统计、小队编辑、装机与发布都走它 |
-| `dsh-harness-project` | 在 `deepseek-harness` 检出里读写代码的人：架构、包地图、profile/bundle 启动模型、扩展点、门禁 |
-| `dsh-harness-languages` | 同一个仓库的各语言面规则与工具链（TypeScript / React / Python / C / YAML / SQLite / shell） |
-
-它们都不占常驻提示段；宿主没有 skill 注册表的组合里会静默跳过，不影响其它任何功能。
-`t-expert-manager` 正文里的 `tz.sh` 路径是注册时按本机解出来的，不是写死的。
-后两个是 `dsh-project-expert`（项目专家模式）这个 agent preset 里同名 skill 的随包副本。
-
-### 本地活动的可见范围
-
-设置页「团队」标签读的是插件在本机注册的只读接口（`/plugins/t-team/…`）：每个请求都先过宿主的
-Host/Origin 校验与浏览器认证，静态资源另有白名单，非白名单一律 404。其中团队活动接口会**遍历
-当前机器的所有工作区**，所以任何已认证的本机浏览器上下文都能看到这些工作区里的团队名、成员名
-与任务标题（这是内置引擎的既有行为，不是 T专家 自己引入的）。DSH 是单用户本地应用，风险有限；
-只在你的机器上有不信任的浏览器扩展或共享浏览器配置时才需要留意。
+```bash
+/t                       # 列出所有小队（key、别名、人数、成员中文名）
+/t <小队|别名>            # 选定小队，队长列出成员并问你目标
+/t <小队|别名> <目标>      # 拉起小队干活（先给成员与任务草案，你 review 后开跑）
+/t <一句话目标>           # 没匹配到小队名时，按目标自动挑最合适的小队
+```
 
----
+引擎另注册 **13 个 `t_team_*` 工具**（建队 / 审批 / 建任务 / 派发 / 状态 / 恢复 / 删除…），随插件一起提供；
+队长与成员各看到其中一个子集。
 
-## 六、小队
+**设置 → 队伍**里改成员 / 别名 / 启停，保存写回 `~/.t-team/teams.json` 并调用小队编译器：
+**保存后立即生效，无需重启 DSH**——编译成功后运行中的插件就地重载引擎配置，`/t` 与新建队随即看到新小队，
+已经跑起来的团队继续用启动时的成员表。**编译失败会自动回滚**，盘上仍是旧配置，设置页直接报错并说明引擎是否可用。
 
-设置 → 队伍 里搜索、修改成员 / 别名 / 启停，然后保存：改动写回 `~/.t-team/teams.json`，
-再调用小队编译器生成引擎配置；**编译失败会自动回滚**，不会把坏定义留在盘上。
+约束：小队 key 只能 ASCII `a-z0-9-`（中文放 `description` / `aliases`）；每队 ≤ `maxMembers`（默认 8）；
+小队总数 ≤ 48；别名全局唯一；成员必须是名册里真实存在的专家。
 
-**保存后立即生效，无需重启 DSH**：编译成功后运行中的插件会就地重载引擎配置，
-`/t` 列表与新建队（含队长提示段）随即看到新小队；已经跑起来的团队不受影响，继续用启动时的成员表。
+## 定时任务
 
-- 编译失败并**回滚**时不会重载：盘上还是旧配置，建队照旧按旧小队走，设置页会直接报错。
-- 引擎重载本身失败时会留下可诊断的信号（日志里有 `[t-team]` 的 error/warn），
-  并且报错时会带着原因说清引擎当前是否可用，不会静默假装已生效。
+到点自动**新开一个会话**执行提示词，也可以随时「立即执行」。
 
-约束：小队 key 只能 ASCII `a-z0-9-`（中文放 `description` / `aliases`）；每队 ≤ `maxMembers`（默认 8，见「七、配置项」）；
-小队总数 ≤ 48；别名全局唯一；成员必须是名册里真实存在的专家。
-> 成员上限由插件透传给小队编译器（`data/team-profiles.py --max-members`），两边同一个真源：
-> 改 `maxMembers` 就能真正生效，不必再动编译器。只有在用**旧版本**编译器（不认这个参数）时，
-> 才会退回它内置的默认值并打印一条 warn —— 正常升级路径下包内编译器会一起更新。
+| 能力 | 说明 |
+| --- | --- |
+| cron 执行 | 每条 = 标题 + 提示词 + 五段 croner 表达式（`分 时 日 月 周`） |
+| 结构化选择器 | 快捷模板 + 「每小时 / 每天 / 每周 / 自定义」逐级选，周几多选；也可直接写原始表达式 |
+| 实时预览 | 面板显示**最近 5 次执行时间**（宿主用 croner 算，保存前就能确认周期） |
+| 立即执行 | 任意一条一键跑一次，不必等 cron 到点 |
+| 绑定工作区 | **默认绑好**：新建即绑定自动创建的「定时任务」工作区（目录 = 默认工作目录下的 `tesk`）；下拉里还能选「＋ 自定义目录…」填任意绝对路径（不存在会建出来，工作区名取目录名），或选「不绑定工作区」 |
+| 会话自动命名 | 「任务标题 · MM-DD HH:mm」，同一任务多次运行在侧栏里分得清 |
+| 执行记录 | 每条保留最近 20 次（时间、成败、失败原因、会话 id） |
+| 启用 / 停用 | 停用的事项保留数据但不再触发 |
+| 点名专家 | 提示词框下的「🧩 T专家」浮层只列**已启用**专家（可搜、可键盘选、可多选），把 `@专家名` 插在光标处；到点执行时宿主把它改写成召唤指令（1 位 → `summon_t_expert`，多位 → `summon_t_experts`），不在已启用名册里的名字**原样提交、绝不猜** |
 
----
+**开关**：设置 → T专家 → 「显示定时任务按钮」。关掉它**不只是藏按钮**：宿主同时停掉全部定时触发，
+手动执行也被拒；任务与执行记录完整保留，重新打开立刻按 stored 状态恢复调度。
 
-## 七、配置项
+数据写在 `~/.t-team/schedule.json`（插件自己的数据根下，不进宿主存储域），与 `@weibaohui/dsh-tasks`
+**可同时安装、同时使用**：各跑各的定时器、各存各的任务、各用各的侧栏入口与 remote 服务，互不可见。
 
-全部以插件 `Config` 定义为准（`lib/index.js`，共 15 项）。常用的几个：
+## 数据与目录
 
-| 配置项 | 默认值 | 含义 |
-| --- | --- | --- |
-| `root` | `~/.t-team/experts` | 名册目录 |
-| `zhRoot` | `~/.t-team/zh` | 中文侧车目录 |
-| `customRoot` | `~/.t-team/custom` | 自建专家目录（与 `root` 分开是硬要求） |
-| `provider` | `"spawn"` | 召唤专家用的子代理 provider |
-| `divisions` | `[]` | 留空＝自动扫描 `root` 下所有含 `.md` 的分类 |
-| `maxSummonBatch` / `summonConcurrency` | `8` / `4` | 批量召唤上限与并发 |
-| `stateDir` | `.agent-teams` | 团队状态目录（**工作区内的相对路径**），团队状态落在 `<工作区>/<stateDir>/<teamId>/`。内置团队引擎、设置页「队伍」标签与只读预检工具 `t_team_plan_check` 都按它定位团队——**三处都读这一个字段**，不存在第二来源（自检 8f 有静态 + 行为双断言兜着）。要挪团队状态目录只改这里 |
-| `memberProvider` / `memberModel` / `maxMembers` | — | 转给内置团队引擎；`maxMembers` 还由插件透传给小队编译器（见「六、小队」） |
+**全部数据都在你本机**：不连任何网络服务、不做遥测；名册、中文译文与小队的编译器都随包分发，运行时不向上游拉取。
 
----
+```
+~/.t-team/
+├── experts/              名册：<分类>/<slug>.md（包内快照 22 个分类、316 位；你自建的另计）
+├── zh/                   中文侧车：names.json、descriptions.json、<分类>/<slug>.md
+├── custom/               你在面板里自建的专家
+├── teams.json            小队定义（设置页「队伍」写回）
+├── schedule.json         定时任务：任务、cron 表达式与最近 20 次执行记录
+├── t-team.config.json    小队编译产物（引擎配置，人格已内联）
+├── teams.resolved.json   小队编译产物（/t 列表用）
+├── team-profiles.py      小队编译器的播种副本（实际跑的是包内那份）
+├── source.json           名册清单（专家数 / 分类 / 更新时间）
+└── .t-team-snapshot.json 上次对齐的记录（版本 / 漂移计数）
+```
 
-## 八、许可
+- 启动时**按条目**与包内快照对齐：包内新增的专家 / 小队 / 译文键补齐；只读条目（`experts/`、`source.json`、
+  `team-profiles.py`、`zh/` 的覆盖表与分区表）与包内对齐；`names.json` / `descriptions.json` / `teams.json`
+  **只补缺失的键**（你改过的键一个都不动）；你改过的译文正文保留盘上那份；包内已移除的条目只报告、不删你的文件。
+- 一句话：**送得到的送到，送不到的一定出声**（日志给出数量与例子）。唯一始终用包内那份的是小队编译器
+  （它是代码，随插件版本走）。想换目录位置，用配置项 `root` / `zhRoot` / `customRoot` 覆盖。
 
-本插件 MIT（见 `LICENSE`）。随包分发的专家名册、中文译文、内置团队引擎，以及**运行时依赖**
-`croner`（定时任务的 cron 解析与调度）各自按其原许可使用：
-来源、版本与署名写在 `THIRD-PARTY-NOTICES`，完整许可文本随包放在 `vendor/`。
-再分发（含修改版）时请一并保留这四样。
+## 常见问题
 
----
+| 现象 | 原因与处理 |
+| --- | --- |
+| 召唤不了某位专家 | 它没被启用（设置 → T专家 → 专家）；名册默认是"全部未启用" |
+| `/t` 不可用或提示引擎降级 | 宿主版本不在实测范围内（见「安装」的依赖一行）时团队引擎会降级：`/t` 会给出原因，名册与 `@` 召唤不受影响 |
+| 保存小队报错 | 缺 `python3`，或新定义没通过编译 —— **失败会自动回滚**，盘上仍是旧配置，设置页会说明引擎是否可用 |
+| 定时任务没有按时跑 | 设置 → T专家 → 「显示定时任务按钮」若被关掉，宿主会停掉**全部**定时触发（手动执行也会被拒），这是有意为之 |
+| 改完插件看不到变化 | 客户端与宿主代码都要重启 DSH 才生效；设置 → T专家 标题行有当前版本号（`v0.3.x`）可核对 |
 
-## 九、开发
+## 卸载与反馈
 
-```bash
-npm install         # 装开发期依赖（.npmrc 里开了 legacy-peer-deps，原因见该文件）
-npm run typecheck   # 类型检查（tsconfig.json 只覆盖自研 Host 文件，不碰并入的引擎）
-npm run verify      # 自检套件（现 601 项断言）：插件契约、工具、remote、客户端产物、播种与快照，
-                    # 外加「发布包自洽」（真打一份 tgz、解开、再用插件解析器读一遍）
-npm run invariants  # 引擎不变量门禁：真 cordis + 真 lib/teams + 桩 Agent，只报「违反集 D」
-npm run build       # 构建客户端产物（lib/client.js）
-npm run sync-data   # 把运行时数据同步进包内 data/
-```
+- **卸载**：DSH Desktop 在插件市场里卸载；CLI 用 `dsh plugin --profile web remove dsh-plugin-t-expert`。
+  卸载不会删数据目录 `~/.t-team/`（名册、自建专家、小队、定时任务都在那儿），要清干净手动删它即可。
+- **反馈与源码**：<https://github.com/jiuaiwo/dsh-plugin-t-expert> —— 问题请走 Issues。
 
-`tools/` 里的构建 / 自检 / 同步脚本**随仓库走**，所以干净 clone 就能跑 `typecheck` 与 `verify`；
-需要运维台（`tz.sh`、`add-expert.py`）的那几节在本机没有运维目录时会**显式打印 skip**，不会
-静默少跑。推送与 PR 由 `.github/workflows/ci.yml` 跑同一套门禁（含 `npm run invariants`）。
+## 许可
 
-### 引擎不变量（`npm run invariants`）
+本插件以 **MIT** 发布（见 `LICENSE`）。
 
-`lib/teams/**` 是内置的团队引擎（约 9,600 行）。它没有「读一遍代码」的判据，所以这里用
-**可执行探针**把引擎声称永远成立的契约钉住，只看**违反集 D**：`D = ∅` 即本轮干净。
+随包内容包含第三方成果 —— 内置团队引擎（派生自 `@nanmicoder/dsh-agent-teams`）、专家名册与中文译文
+（`msitarzewski/agency-agents`、`jnMetaCode/agency-agents-zh` 等）、以及运行时依赖 `croner` ——
+它们各自保留原许可。完整来源、版本与署名见 `THIRD-PARTY-NOTICES`，完整许可文本随包放在 `vendor/`。
 
-| 不变量 | 钉住什么 |
-| --- | --- |
-| `INV-1` | 任务被转交/重试后**旧 `attempt_id` 必须失效**（旧主人与伪造令牌都被拒） |
-| `INV-2` | 两个未完成的**写**任务不得共用同一 `inScope` 路径；`implementation` 必须带 `inScope` |
-| `INV-3` | 一成员同时只能有一个未完成任务（顺序与**并发**都成立，并发恰好 1 胜） |
-| `INV-4` | `halted` 语义：停→取消未完成任务并拒新单；`resume` 必须带非空 reason，之后才恢复派发 |
-| `INV-5` | 并发写不丢更新：N 次并发建单全部落盘、id 唯一、状态文件始终可解析 |
-| `INV-6` | `review` 必须带 `reviewedTaskId`；`needs_revision` 走 `failed` 且自动生成 `repair`；`verdict=pass` 才算完成 |
-| `INV-7` | 质量类建单契约：`implementation` 必须带 `objective`/`acceptance`/`inScope`/`verify` |
-| `INV-8` | 调度器契约：`approve` 后 pending 任务会被自动派给空闲成员（不是停在池里等人 claim） |
-| `INV-9` | 宿主路径契约：`agents` 未就绪时快照不得抛错（用**真 cordis 受门控 ctx** 钉住；旧写法会抛 `without inject`，那一瞬间所有团队会从面板消失） |
-
-**聚合入口**：`npm run invariants -- --all` 会把引擎不变量与既有的三道门禁一起跑，统一输出违反集 `D`：
-
-| 聚合项 | 说明 |
-| --- | --- |
-| 引擎不变量 | 本文件的 9 条（真 cordis + 真 `lib/teams` + 桩 Agent） |
-| 插件契约 | 以**黑盒**调用 `tools/verify.mjs`（527 项），只取退出码与摘要行 |
-| 宿主 skill 漂移 | `tools/skill-drift.mjs`（它现在也能独立跑：有漂移即退出码 1） |
-| 数据快照一致 | `tools/sync-data.mjs --check`（**源目录不存在时显式记 SKIP**，不算违反） |
-
-约定：门禁报告「已跳过」不算违反（与 `verify.mjs` 的 skip 规矩一致）。CI 里仍分别跑 `verify` 与
-`invariants`（不重复跑一遍 `--all`）。
-
-探针基座的三条忠告写在 `tools/invariants.mjs` 的文件头（成员 id 要 approve 后才出现、团队 id
-会被 slug 化、工具执行上下文必须带 `signal` 且成员 agent 要有 `status`/`whenIdle`）——它们都是
-写这个门禁时踩出来的，改探针前先读那段。
-
-
-四条容易踩的开发约定：
-
-- **线格式（remote）的 schema 只有一份**：`lib/remote-schemas.js`，host 的 `lib/remote.js`
-  与客户端 `src/client.jsx` 都从它取；两端各自只保留**信封**（`descriptor()` / `direct()`）。
-  改字段只改 schema 文件；改方法签名要同时改两端信封——自检会机械比对每个方法的**参数名与
-  typeSymbol 是否两端一致**，漏改一处就会被拦下（不用等调用期）。
-- `lib/client.js` 是**入库的构建产物**（≈1 MB）。改客户端只改 `src/client.jsx`，
-  然后必须重跑 `npm run build` —— 自检里有一条「产物新鲜度」门禁，忘了重跑会拦下来。
-- `package-lock.json` 管的是**本插件自己的 devDependencies**；用户装插件用的 `pnpm`
-  是宿主 `dsh plugin` 在 profile 目录里跑的，两者互不冲突，不要为了方便删掉 lock。
-- `lib/squads.js` 这类数据层**不写 `console`**：诊断一律走注入的宿主 logger
-  （`ctx.logger`），桌面与 Web 里 stderr 用户看不见。编译团队配置是**异步**的
-  （`execFile`，不是 `execFileSync`）—— 同步跑会把整个 Host 事件循环卡住。
-
-内置团队引擎（`lib/teams/`）是**手工维护的源码**，改引擎直接改这里；
-名册（`data/experts/`）与中文侧车（`data/zh/`）就是发布源，两者都不再从任何上游同步。
-
-### `dsh.client.inject` 为什么写着 `dsh-client-ui-primitives`
-
-那是**承重的声明，不是笔误**。`@deepseek-ai/dsh-client-modules` 的到达顺序契约里，
-`dsh.client.inject` 让被点名的包**先于本插件的 client module 到达**；而 `lib/client.js`
-里确实有 `require("@deepseek-ai/dsh-client-ui-primitives")`（构建时只把 `react` 外部化）。
-删掉它并不会让构建失败，却可能让本插件赶在 primitives 之前物化、require 当场抛错。
-
-顺带说明两个容易误判的点：**①** 这个包没有 `exports["./client"]`，所以它不作为「client module」
-参与 `dsh.client.inject` 的常规扫描——但名字仍必须留在这里；**②** 自检 `[20b]` 已经把
-「bundle 里每个 `@deepseek-ai/*` 外部 require 都必须在名单里」固化成不变量，以后新增 require
-忘了声明会当场红，不必再靠人肉比对。
+本插件及随包内容按**「原样」提供，不附带任何明示或默示担保**；与上述上游项目及 DeepSeek Harness
+官方无隶属或背书关系。再分发（含修改版）时请保留 `LICENSE`、`THIRD-PARTY-NOTICES` 与 `vendor/`
+下的许可文本。