dsh-plugin-t-expert 0.2.4 → 0.2.6

package/README.md

@@ -1,240 +1,146 @@
 # T专家（dsh-plugin-t-expert）
 
-**T专家** 把一个 **22 个分区 / 314 位专家**的名册（含全量中文译文）
-做成一个独立的 DeepSeek Harness 插件，并在插件内部**自带一套多智能体团队引擎**（多成员小队、任务 DAG、调度、邮箱、活动面板）。
+DeepSeek Harness 插件：**22 个分类 / 314 位专家**的名册（中文名、简介、人格正文全量覆盖），
+外加插件内自带的**多智能体团队引擎**（小队模板、任务 DAG、调度、活动面板）。
 
-装上一个插件，你同时得到三样东西：
+装上以后你能做四件事：
 
-| 能力 | 说明 |
+| 做什么 | 怎么做 |
 | --- | --- |
-| 专家名册 | 314 位专家，含**中文侧车**（中文名 / 中文简介 / 中文人格正文，当前覆盖率 314/314） |
-| `@` 召唤 | 在输入框打 `@` 出现按分区分组的中文菜单，选中的专家作为原生引用 chip 进入本轮对话 |
-| 模型工具 | `list_t_experts` / `summon_t_expert` / `summon_t_experts` / `t_team_plan_check` 四个工具 |
-| 小队命令 | `/t` 列出小队；`/t <小队名\|别名> <目标>` 直接拉起一支多成员小队干活 |
-| 设置页 | 设置 → T专家，两个标签：**专家**（启停 / 看提示词）与 **队伍**（小队模板 + 运行中的团队） |
+| 用专家 | 输入框打 `@` → 按分类分组的菜单 → 选中的专家作为引用 chip 进本轮对话；模型也可用 `summon_t_expert` 召唤 |
+| 拉起一支小队干活 | `/t <小队> <目标>`（`/t` 单跑列出现有小队） |
+| 管名册 | 设置 → T专家 → **专家**（启停 / 看提示词 / 新建自建专家） |
+| 管分类与小队 | 设置 → T专家 → **分类**（新建 / 改名 / 删除自建分类）、**队伍**（小队模板 + 运行中的团队） |
 
-专家名册与团队引擎**解耦**：团队引擎挂载失败（例如宿主子代理契约不匹配）时，
-专家名册、`@` 召唤、`/t` 列表仍然照常可用。
-> 注意：这条解耦覆盖的是**引擎的运行时挂载**。宿主包本身缺失时（插件声明了若干
-> `@deepseek-ai/*` peer 依赖，由 DSH 安装提供）整个插件都无法加载 —— 这是任何插件的共同前提。
+设置页一共**三个标签**：**专家**（启停 / 看提示词 / 新建自建专家）、**分类**（自建分类的增删改）、
+**队伍**（小队模板 + 运行中的团队）。
 
 ---
 
-## 一、环境要求
-
-| 项 | 要求 |
-| --- | --- |
-| DSH 宿主 | `0.1.5-rc.1` 或 `0.1.5-rc.2` |
-| Node.js | `^22.19.0 || >=24` |
-| pnpm | **必须在 PATH 上**。`dsh plugin` 本质上是在 profile 目录里转发 pnpm，缺 pnpm 会直接报错 |
-| python3 | 仅在用设置页「小队」标签编辑并编译小队时需要（保存时要调用 `team-profiles.py`） |
-
----
-
-## 二、安装
-
-### 1. 命令行安装（推荐）
+## 一、安装
 
 ```bash
 dsh plugin --profile web add dsh-plugin-t-expert
 ```
 
-需要锁版本时：
-
-```bash
-dsh plugin --profile web add --save-exact dsh-plugin-t-expert@0.1.1
-```
-
-插件在 `package.json` 里声明了 `dsh.bundle`（补丁文件 `cordis.patch.yml`），
-`dsh plugin` 会**自动**把它接到 profile 的 bundle 层（注册 `t-team` 与 `t-team-remote` 两行）。
-**你不需要手改任何配置文件。**
-
-### 2. 图形端（DSH Desktop）
-
-`desktop` profile 由 Electron 应用独占，`dsh plugin --profile desktop …` 会被 CLI 直接拒绝：
-
-```
-error: profile "desktop" is managed exclusively by the Electron application
-```
-
-**请用插件市场（dsh-market）安装**：在 DSH Desktop 里搜索本插件一键装即可。
-
-本仓库**不自带安装脚本**（维护者的运维脚本不在仓库里）。如果你要手工装，等价动作是：
-把包内的 `lib/`、`data/`、`cordis.patch.yml` 与许可文件复制到一个运行目录，在目标 profile 的
-`package.json` 里加一条 `file:<该目录>` 依赖并追加到 `dsh.profile.bundles`，再把整个目录
-**真目录拷贝**（不要符号链接）到 profile 的 `node_modules/<包名>`。
+**DSH Desktop 请在插件市场里装**（搜 `dsh-plugin-t-expert` 一键安装）。
+`dsh plugin --profile desktop …` 会被 CLI 拒绝（desktop profile 由 Electron 应用独占），
+这不是本插件的限制——任何插件都一样。
 
-> ⚠️ 该 `file:` 依赖指向的是**运行目录**，与首次播种出来的数据目录是两处，不要混在一起：
-> 运行目录可随时重建，数据目录必须长期保留。清空或迁移运行目录会连带影响插件解析，
-> 届时重跑一遍安装步骤即可。
+依赖：DSH 宿主 `0.1.5-rc.1` / `0.1.5-rc.2`；Node `^22.19.0 || >=24`；`pnpm` 在 PATH 上
+（`dsh plugin` 本质是在 profile 目录里转发 pnpm）。`python3` 只在**设置页保存小队**时需要
+（要调用小队编译器）；缺它插件照常加载，只是小队编译会报错并回滚。
 
-### 3. 装完之后
-
-1. 重启 DSH。
-2. 打开 **设置 → T专家**。
-3. 勾选要启用的专家（**默认全部未启用**，未启用的专家不能被召唤）。
-4. 回到输入框打 `@`，出现 T专家的分组菜单即可用。
+装完重启 DSH，然后在 **设置 → T专家** 里启用专家——**默认全部未启用**，未启用的专家不能被召唤。
 
 ---
 
-## 三、数据目录与首次播种
-
-插件对任何机器都是**自包含**的：包内自带一份数据快照（`data/`），
-首次启动时会把快照**播种**到你的数据目录 `~/.t-team/`，因此不需要任何额外脚本或同步流程。
+## 二、数据目录
 
-- 默认 `root = ~/.t-team/experts`、`zhRoot = ~/.t-team/zh`。
-- **已有的文件不会被覆盖**：目录（`experts` / `zh`）与文件（`teams.json` / `teams.resolved.json` / `t-team.config.json` / `team-profiles.py` / `source.json`）按项独立判断，缺哪个补哪个。
-- 因此**升级插件不会动你改过的内容**（例如你编辑过的小队定义、你补译的中文正文）。
-- 播种失败（只读文件系统、权限不足等）只告警，插件照常加载。
-
-播种后的数据目录大致是：
+插件对任何机器都**自包含**：包内带一份名册快照，首次启动播种到 `~/.t-team/`。
 
 ```
 ~/.t-team/
-├── experts/              # 专家名册：<分区>/<slug>.md（22 个分区、314 位）
-├── zh/                   # 中文侧车（译文只在这里，永不写进 experts/）
-│   ├── names.json        # slug → 中文名
-│   ├── descriptions.json # slug → 中文简介
-│   ├── divisions.json    # 分区中文标签
-│   ├── <分区>/<slug>.md  # 中文人格正文（与 experts/ 同相对路径）
-│   ├── manual.json       # 人工补译：names / descriptions（优先于自动层）
-│   ├── manual-bodies/    # 人工补译正文（最高优先，不会被覆盖）
-│   └── COVERAGE.json     # 中文覆盖率与缺口清单
-├── teams.json            # 小队定义（设置页「小队」标签写回这里）
-├── teams.resolved.json   # 编译产物：/t 列表与成员解析用
-├── t-team.config.json    # 编译产物：内置团队引擎的配置（人格已内联）
-├── team-profiles.py      # 小队编译器（设置页保存小队时调用）
-└── source.json           # 名册指纹（宿主据此判断名册是否变化）
+├── experts/              名册：<分类>/<slug>.md（22 个分类、314 位）
+├── zh/                   中文侧车：names.json、descriptions.json、<分类>/<slug>.md、divisions.json
+├── custom/               你在面板里自建的专家
+├── teams.json            小队定义（设置页「队伍」写回这里）
+├── t-team.config.json    小队编译产物（引擎配置，人格已内联）
+├── teams.resolved.json   小队编译产物（/t 列表用）
+├── team-profiles.py      小队编译器的播种副本（实际跑的是包内那份）
+└── source.json           名册清单（专家数 / 分类 / 更新时间）
 ```
 
-换源或改目录位置：用配置项 `root` / `zhRoot` 覆盖即可，不必改代码。
+- **已有文件不会被覆盖**：升级插件不会动你改过的小队定义或补译的中文正文。
+  唯一例外是小队编译器——它是代码、随插件版本走，始终用包内那份（数据目录里那份只作兜底）。
+- 想换目录位置，用配置项 `root` / `zhRoot` / `customRoot` 覆盖即可，不必改代码。
 
 ---
 
-## 四、配置项
-
-以插件 `Config` 定义为准（`lib/index.js`）：
-
-| 配置项 | 类型 | 默认值 | 含义 |
-| --- | --- | --- | --- |
-| `root` | string | `~/.t-team/experts` | 专家名册目录，读 `experts/<分区>/<slug>.md` |
-| `zhRoot` | string | `~/.t-team/zh` | 中文侧车目录（名字 / 简介 / 正文 / 分区标签） |
-| `provider` | string | `"spawn"` | 召唤专家时使用的子代理 provider |
-| `divisions` | string[] | `[]` | 留空 = 自动扫描 `root` 下所有含 `.md` 的分区目录 |
-| `maxDepth` | natural | 无默认（不传则不加限制） | 传给子代理的嵌套深度上限 |
-| `maxSummonBatch` | natural | `8` | 一次 `summon_t_experts` 最多几位专家 |
-| `summonConcurrency` | natural | `4` | `summon_t_experts` 的并发度 |
-| `summonTaskMaxChars` | natural | `8000` | 单个专家任务的字符上限 |
-| `descriptionLimit` | natural | `120` | `list_t_experts` 里简介的截断长度 |
-| `engineConfig` | string | `root` 同级目录下的 `t-team.config.json` | 团队引擎配置路径（`team-profiles.py` 的产物） |
-| `stateDir` | string | `".agent-teams"` | 团队状态目录（相对工作区） |
-| `memberProvider` | string | `"spawn"` | 队员子代理使用的 provider |
-| `memberModel` | string | 不传 = 跟随队长 | 队员默认模型 |
-| `maxMembers` | natural | `8` | 一支团队最多几名成员 |
-
-> 这些都可以在 profile 的 `cordis.patch.yml` 里覆盖，例如：
->
-> ```yaml
-> - id: t-team
->   name: 'dsh-plugin-t-expert'
->   config:
->     maxSummonBatch: 4
->     stateDir: .my-team-state
-> ```
->
-> 注意 patch 行的 `config` 是**整体替换**而不是深合并，覆盖时要重述该行需要的每一个键。
-
-**引擎配置：缺失 vs 损坏**。`engineConfig` 指向的文件不存在时（例如自定义了 `root`、还没生成过小队），插件正常加载，只是团队功能不可用 —— 原因会写进日志、由 `/t` 报出，并进入系统提示段让模型知道，不是静默跳过。而文件存在却解析失败、或 `profiles` 类型不对，属于自带数据的错配，插件会在**加载时直接失败**并指出路径与修法。
+## 三、自建专家与分类
 
----
+**新建专家**：设置 → 专家 → 「＋ 新建专家」，选分类（官方 22 个或你自建的），填名称 / 简介 / 人格正文。
 
-## 五、工具与命令
+- 自建专家写在 `customRoot`（默认 `~/.t-team/custom/<分类>/<slug>.md`），**与随包发布的名册分开**：
+  内置名册升级时整棵替换，自建的不受影响。
+- 归到官方分类名下是**允许且安全**的：分类只是归属，文件仍在 `customRoot`，内置名册一个字节不动。
+- 自建专家自带中文（frontmatter 里的 `name` 就是显示名），不依赖中文侧车。
 
-### 工具
+**新建分类**：设置 → 分类 → 填目录名（小写 ASCII）+ 显示名（中文）。
+官方分类只读（名字与存亡随包内名册）；删除自建分类时若里面还有专家会被拒绝，不会静默连删。
 
-| 工具 | 作用 |
-| --- | --- |
-| `list_t_experts` | 列出**已启用**专家的分区与数量；传入分区名可列出该分区专家（用于挑出唯一的专家名） |
-| `summon_t_expert` | 召唤 1 位专家：以该专家的完整人格跑一个子代理并返回结果（阻塞等待） |
-| `summon_t_experts` | 并行召唤多位专家：最多 8 位、并发 4；部分失败时仍返回成功的结果 |
-| `t_team_plan_check` | **只读** DAG 预检：把打算创建的一批团队任务先跑一遍引擎校验，一次报出全部问题、警示与建议执行顺序 |
+---
 
-> 团队引擎自身还注册了 `t_team_*` 系列工具（建队、建任务、派发等），随插件一起提供。
+## 四、工具与命令
 
-### 命令
+| 工具 | 作用 |
+| --- | --- |
+| `list_t_experts` | 列出已启用专家的分类与数量；传分类名可列出该分类的专家 |
+| `summon_t_expert` | 召唤 1 位专家：以它的完整人格跑一个子代理并返回结果 |
+| `summon_t_experts` | 并行召唤多位（最多 8 位、并发 4；部分失败仍返回成功的结果） |
+| `t_team_plan_check` | 只读 DAG 预检：一批团队任务先跑一遍引擎校验，一次报出全部问题 |
 
-| 用法 | 行为 |
+| 命令 | 行为 |
 | --- | --- |
 | `/t` | 列出所有小队（key、别名、人数、成员中文名） |
-| `/t <小队名\|别名>` | 选定小队，队长会列出成员并问你这次要做什么 |
-| `/t <小队名\|别名> <目标>` | 拉起该小队执行目标（队长先给出成员与任务草案，等你 review 后再启动） |
-| `/t <一句话目标>` | 没有匹配到小队名时，按目标自动挑选最合适的小队 |
+| `/t <小队\|别名>` | 选定小队，队长列出成员并问你目标 |
+| `/t <小队\|别名> <目标>` | 拉起小队干活（先给成员与任务草案，你 review 后开跑） |
+| `/t <一句话目标>` | 没匹配到小队名时，按目标自动挑最合适的小队 |
 
-小队**列表与匹配**每次都从磁盘读定义，所以改完名字立刻反映在 `/t` 里；
-但**建队时用的是插件启动时载入的引擎配置**，因此小队定义的增删改要**重启 DSH** 才对建队生效。
+团队引擎另注册 **13 个 `t_team_*` 工具**（`t_team_create` 建队、`t_team_approve` 审批、
+`t_team_create_task` 建任务、`t_team_reassign_task` 派发、`t_team_status` 看状态、`t_team_resume` 恢复等），
+随插件一起提供；队长与成员各看到其中一个子集。
 
 ---
 
-## 六、编辑小队
+## 五、小队
+
+设置 → 队伍 里搜索、修改成员 / 别名 / 启停，然后保存：改动写回 `~/.t-team/teams.json`，
+再调用小队编译器生成引擎配置；**编译失败会自动回滚**，不会把坏定义留在盘上。
 
-**设置 → T专家 → 队伍** 标签里可以搜索、修改成员 / 别名 / 启停，然后保存。
+> ⚠️ **保存后要重启 DSH 才对建队生效**：`/t` 列表会立刻显示新小队，
+> 但引擎配置在插件启动时就已载入，不重启用新小队建不了队。
 
-保存流程：
+约束：小队 key 只能 ASCII `a-z0-9-`（中文放 `description` / `aliases`）；每队 ≤ 8 人；小队总数 ≤ 48；
+别名全局唯一；成员必须是名册里真实存在的专家。
 
-1. 把改动写回 `~/.t-team/teams.json`；
-2. 调用 `~/.t-team/team-profiles.py` 编译出 `t-team.config.json` 与 `teams.resolved.json`；
-3. **编译失败会自动回滚** `teams.json`（不会把坏定义留在盘上）；
-4. 缺 `python3` 时报错并回滚。
+---
 
-> ⚠️ **保存后需要重启 DSH**：`/t` 列表会立刻看到新小队，但引擎配置在插件启动时已载入，
-> 不重启就建不了队（`/t 新队 目标` 会提示「小队不存在」）。
+## 六、配置项
 
-硬约束（由 `team-profiles.py` 与小队数据层校验）：
+全部以插件 `Config` 定义为准（`lib/index.js`，共 15 项）。常用的几个：
 
-| 约束 | 值 |
-| --- | --- |
-| 小队 key | 只能是 ASCII 的 `a-z0-9-`（形如 `^[a-z0-9]+(?:-[a-z0-9]+)*$`），中文放在 `description` 与 `aliases` |
-| 每队成员数 | ≤ 8 |
-| 小队总数 | ≤ 48 |
-| 每队固定任务数 | ≤ 32 |
-| 别名 | 全局唯一，不能与别的小队 key 冲突（否则 `/t` 无法判断用哪支） |
-| 成员 | 写专家 slug（或 `{slug, role}`），必须能在名册里找到有效成员 |
+| 配置项 | 默认值 | 含义 |
+| --- | --- | --- |
+| `root` | `~/.t-team/experts` | 名册目录 |
+| `zhRoot` | `~/.t-team/zh` | 中文侧车目录 |
+| `customRoot` | `~/.t-team/custom` | 自建专家目录（与 `root` 分开是硬要求） |
+| `provider` | `"spawn"` | 召唤专家用的子代理 provider |
+| `divisions` | `[]` | 留空＝自动扫描 `root` 下所有含 `.md` 的分类 |
+| `maxSummonBatch` / `summonConcurrency` | `8` / `4` | 批量召唤上限与并发 |
+| `stateDir` / `memberProvider` / `memberModel` / `maxMembers` | — | 转给内置团队引擎 |
 
 ---
 
 ## 七、许可
 
-本插件以 **MIT** 发布，全文见 `LICENSE`。
-
-随包分发的专家名册、中文译文与内置团队引擎各自按 MIT 授权使用，
-各自的来源、版本与署名要求写在 `THIRD-PARTY-NOTICES` 里，**完整许可文本随包放在 `vendor/` 下**。
-再分发本插件（含修改版）时，请一并保留 `LICENSE`、`THIRD-PARTY-NOTICES` 与 `vendor/` 下的许可文本。
+本插件 MIT（见 `LICENSE`）。随包分发的专家名册、中文译文与内置团队引擎各自按其原许可使用：
+来源、版本与署名写在 `THIRD-PARTY-NOTICES`，完整许可文本随包放在 `vendor/`。
+再分发（含修改版）时请一并保留这三样。
 
 ---
 
-## 八、开发 / 构建
+## 八、开发
 
 ```bash
-npm install          # 安装依赖（peer 依赖由 DSH 宿主提供）
-npm run build        # 品牌化 + 构建客户端产物
-npm run verify       # 自检套件（插件契约、工具、remote、客户端产物、播种与快照一致性）
-npm run sync-data    # 把运行时数据同步进包内 data/（默认源 ~/.t-team）
+npm run build       # 构建客户端产物（lib/client.js）
+npm run verify      # 自检套件：插件契约、工具、remote、客户端产物、播种与快照，
+                    # 外加「发布包自洽」（真打一份 tgz、解开、再用插件解析器读一遍）
+npm run sync-data   # 把运行时数据同步进包内 data/
 ```
 
-> ⚠️ 这些 script 的实现文件**不在本仓库里**：维护者把它们放在仓库同级的运维目录
-> （`../brand.mjs`、`../build-client.mjs`、`../verify.mjs`、`../sync-data.mjs`，由 `package.json`
-> 的 `scripts` 以相对路径引用）。只 clone 本仓库是跑不了构建与自检的；要发布请使用完整的工作目录。
->
-> `npm run build` 必须**先**品牌化再构建客户端：客户端产物把品牌化后的引擎 bundle 内联进去，
-> 顺序错了会把旧文本打进产物。
-
----
-
-## 九、已知限制
+> 这些 script 的实现不在本仓库：维护者的构建 / 自检脚本放在仓库同级的运维目录，
+> 由 `package.json` 以 `node ../<file>.mjs` 引用。只 clone 本仓库跑不了构建与自检。
 
-- 客户端面板**不做自定义专家的增删改**；要加自己的专家，直接把 `.md` 放进 `~/.t-team/experts/<分区>/`，宿主按 mtime 指纹自动重载，不需要重启。
-  （中文侧车同理：`zh/` 下的名字 / 简介 / 正文文件增删改都会按指纹重载。）
-- 包内快照只在数据目录**缺项**时播种。升级插件只更新包内快照，**不会覆盖你已有的数据目录内容**。
-- 小队定义的改动需要重启 DSH 才对**建队**生效（见第五、六节）。
-- 改插件代码后需要重新 `npm run build`（改了 `src/client.jsx` 才会重新生成客户端产物）并重装/重启。
-- 团队引擎挂载失败时，团队相关功能不可用，但专家名册、`@` 召唤、`/t` 列表不受影响，失败原因由 `/t` 报出。
+内置团队引擎（`lib/teams/`）是**手工维护的源码**，改引擎直接改这里；
+名册（`data/experts/`）与中文侧车（`data/zh/`）就是发布源，两者都不再从任何上游同步。

package/THIRD-PARTY-NOTICES

@@ -12,13 +12,17 @@
 | 上游仓库 | https://github.com/NanmiCoder/dsh-agent-teams |
 | 版本 | `0.1.17-rc.1` |
 | 许可 | MIT（完整文本随包：`vendor/dsh-agent-teams/LICENSE`）— Copyright (c) 2026 程序员阿江(Relakkes) |
-| 位置 | `vendor/dsh-agent-teams/upstream/`（上游文件逐字节原样保留，含 `LICENSE` 与 `VENDOR.md`）、`lib/teams/`（由品牌化工具 `brand.mjs` 从上游镜像生成的品牌化产物：命令 `/agent-teams` → `/t`、工具 `agent_teams_*` → `t_team_*`） |
+| 位置 | `lib/teams/`（16 个文件，由上述上游派生的品牌化产物：命令 `/agent-teams` → `/t`、工具 `agent_teams_*` → `t_team_*`）。它的客户端产物内联在 `lib/client.js` 里 |
+| 许可全文 | `vendor/dsh-agent-teams/LICENSE` |
 
-**对上游镜像的改动**：`vendor/dsh-agent-teams/upstream/` 内的文件**永不修改**；
-`lib/teams/` 是生成物，差异 = 品牌化改名 + `brand.mjs` 中逐条注释的 `FIXES`。
-除改名外，`FIXES` 还包含少量**本地缺陷修补与必要的行为改动**（例如把 profile 上限从 16 抬到 48、
-修正命令视图 key、修正交接期与终态任务的校验、放行 `.env.example` 一类模板文件等）。
-每条 `FIXES` 都声明了期望命中次数，上游文本一变即构建失败，不会静默退回上游行为。
+**本插件对该上游做的改动**（都在 `lib/teams/` 里，可直接对照阅读）：
+一是品牌化改名（命令与工具名、包 id、事件与路由前缀）；二是少量**本地缺陷修补与必要的行为改动**
+（例如把 profile 上限从 16 抬到 48、修正命令视图 key、修正交接期与终态任务的校验、
+放行 `.env.example` 一类模板文件等）。上游文本从未被修改过——我们只在自己的产物里改。
+
+> 2026-09-12 起，上游的**逐字节原样镜像**（`vendor/dsh-agent-teams/upstream/`）与品牌化生成工具
+> （`brand.mjs`）已从仓库移除：`lib/teams/` 转为**手工维护的源码**，不再在构建时从上游重新生成。
+> 停止跟随上游不改变署名义务，故本节保留。
 
 ## 2. 专家名册与中文侧车
 
@@ -27,20 +31,22 @@
 | 英文名册 | The Agency / AgentLand（`msitarzewski/agency-agents`）— MIT，Copyright (c) 2025 AgentLand Contributors。完整文本随包：`vendor/third-party-licenses/agency-agents.LICENSE` |
 | 中文译文 | `jnMetaCode/agency-agents-zh`（中文翻译与本地化）— MIT，Copyright (c) 2025 Michael Sitarzewski（英文原版）、Copyright (c) 2026 jnMetaCode（中文翻译与本地化）。完整文本随包：`vendor/third-party-licenses/agency-agents-zh.LICENSE` |
 | 分发形态 | 上述两部分内容随 `@michengai/dsh-agency-agents` 一同分发（该包自身的 TypeScript 源码与构建脚本为 Apache-2.0，**本插件不打包其任何代码**） |
-| 版本指纹 | 见 `data/source.json` 的 `sourceRevision`；补入部分见同文件的 `extraSource` / `extraSourceVersion` |
-| 位置 | `data/experts/`（22 分区 / 314 位）、`data/zh/`（中文名字 / 简介 / 人格正文 / 分区标签） |
+| 位置 | `data/experts/`（22 个分类 / 314 位）、`data/zh/`（中文名字 / 简介 / 人格正文 / 分类标签） |
+| 维护方式 | 上述内容随本插件分发（`data/` 是发布源，不再从上游重新镜像）；`data/source.json` 是该名册的清单（专家数 / 分类 / 更新时间） |
+
+名册的构成分两部分（总计 314 位）：
 
-名册的构成分两部分：
+- **279 位来自 `msitarzewski/agency-agents`**（上表英文名册一行）。
+- **35 位来自 `@michengai/dsh-agency-agents` 的包内快照**（company / hr / legal / supply-chain
+  四个分类，以及若干中国本地化角色）。这些条目在另一上游仓库的任何历史与分支里都不存在，只随该包分发。
+  它们的英文人格与中文译文同样按上表两个 MIT 项目（AgentLand Contributors / jnMetaCode）的条款使用，
+  完整许可文本与上表共用。与已有角色职能重复的条目未并入。
 
-- **279 位逐字节镜像上游仓库** `msitarzewski/agency-agents`（上表第 1 行），随时可 `git pull` 后重新镜像。
-- **35 位由 `@michengai/dsh-agency-agents` 包内快照补入**（company / hr / legal / supply-chain
-  四个分区，以及若干中国本地化角色）。这些条目在上游仓库的任何历史与分支里都不存在，只随该包分发；
-  其英文人格与中文译文同样按上表两个 MIT 项目（AgentLand Contributors / jnMetaCode）的条款使用，
-  完整许可文本与上表共用。补入范围与逐条判定依据记录在 `data/source.json` 的
-  `extraAdded` / `extraSkipped`（与上游角色职能重复的条目会被排除，不并入名册）。
+> 两部分内容自 2026-09-12 起随本插件分发并作为**名册真源**维护，不再从上游重新拉取或镜像
+> （原镜像 / 补入脚本与逐条判定记录已移除；需要追溯当时来源与判定，见仓库 git 历史）。
 
-`data/zh/manual.json` 与 `data/zh/manual-bodies/` 是**本项目的补充翻译**（用于补齐上游尚未覆盖的
-条目或在译文不准确时覆盖），随本插件以 MIT 发布。
+`data/zh/manual.json` 与 `data/zh/manual-bodies/` 是**本项目的补充翻译**（用于补齐尚未覆盖的条目
+或在译文不准确时覆盖），随本插件以 MIT 发布，同样保留在包内。
 
 ## 3. 分发要求
 

package/data/source.json

@@ -1,8 +1,6 @@
 {
-  "source": "<home>/.agency-agents",
-  "sourceRevision": "6d29a9b",
-  "target": "<home>/web/t-team/data/experts",
-  "syncedAt": "2026-09-12 14:47:18 +0800",
+  "updatedAt": "2026-09-12 15:56:06 +0800",
+  "expertFiles": 314,
   "divisions": [
     "academic",
     "company",
@@ -27,88 +25,5 @@
     "support",
     "testing"
   ],
-  "expertFiles": 314,
-  "extraSource": "<home>/.dsh/profiles/desktop/node_modules/@michengai/dsh-agency-agents/assets/agency-agents",
-  "extraSourceVersion": "0.1.41",
-  "extraAdded": 35,
-  "extraSkipped": [
-    {
-      "division": "company",
-      "slug": "chief-of-staff",
-      "duplicateOf": "specialized-chief-of-staff",
-      "verdict": "duplicate"
-    },
-    {
-      "division": "engineering",
-      "slug": "engineering-network-engineer-china",
-      "duplicateOf": "engineering-china-network-engineer",
-      "verdict": "duplicate"
-    },
-    {
-      "division": "engineering",
-      "slug": "engineering-security-engineer",
-      "duplicateOf": "security-appsec-engineer",
-      "verdict": "duplicate"
-    },
-    {
-      "division": "engineering",
-      "slug": "engineering-threat-detection-engineer",
-      "duplicateOf": "security-threat-detection-engineer",
-      "verdict": "duplicate"
-    },
-    {
-      "division": "finance",
-      "slug": "finance-financial-forecaster",
-      "duplicateOf": "finance-financial-analyst",
-      "verdict": "near-duplicate"
-    },
-    {
-      "division": "hr",
-      "slug": "hr-recruiter",
-      "duplicateOf": "specialized-recruitment-specialist",
-      "verdict": "duplicate"
-    },
-    {
-      "division": "marketing",
-      "slug": "marketing-bilibili-strategist",
-      "duplicateOf": "marketing-bilibili-content-strategist",
-      "verdict": "near-duplicate"
-    },
-    {
-      "division": "marketing",
-      "slug": "marketing-ecommerce-operator",
-      "duplicateOf": "marketing-china-ecommerce-operator",
-      "verdict": "duplicate"
-    },
-    {
-      "division": "marketing",
-      "slug": "marketing-wechat-operator",
-      "duplicateOf": "marketing-wechat-official-account",
-      "verdict": "duplicate"
-    },
-    {
-      "division": "marketing",
-      "slug": "marketing-xiaohongshu-operator",
-      "duplicateOf": "marketing-xiaohongshu-specialist",
-      "verdict": "duplicate"
-    },
-    {
-      "division": "specialized",
-      "slug": "prompt-engineer",
-      "duplicateOf": "engineering-prompt-engineer",
-      "verdict": "duplicate"
-    },
-    {
-      "division": "specialized",
-      "slug": "specialized-pricing-optimizer",
-      "duplicateOf": "specialized-pricing-analyst",
-      "verdict": "near-duplicate"
-    },
-    {
-      "division": "support",
-      "slug": "support-recruitment-specialist",
-      "duplicateOf": "specialized-recruitment-specialist",
-      "verdict": "duplicate"
-    }
-  ]
+  "note": "本仓名册清单：data/experts 是真源，由 add-expert.py 维护（上游同步已移除）"
 }

package/data/team-profiles.py

@@ -42,7 +42,7 @@ DEFAULT_PATCH = os.environ.get("T_TEAM_PATCH", os.path.join(HOME, ".dsh", "profi
 MARKER_START = "# >>> t-team teams（由 team-profiles.py 生成，勿手改；改 teams.json 后重跑）"
 MARKER_END = "# <<< t-team teams"
 
-MAX_PROFILES = 48          # 引擎侧已由品牌化工具 brand.mjs 把 MAX_TEAM_PROFILES 调到 48（上游默认 16）
+MAX_PROFILES = 48          # 引擎侧 lib/teams/profiles.js 已把 MAX_TEAM_PROFILES 调到 48（原默认 16）
 MAX_MEMBERS = 8            # 一个 profile 的成员数上限（经验值：队长上下文压力）
 MAX_SEED_TASKS = 32        # AgentTeams: MAX_PROFILE_TASKS
 PROFILE_KEY_RE = re.compile(r"^[a-z0-9]+(?:-[a-z0-9]+)*$")

package/data/zh/COVERAGE.json

@@ -14,7 +14,7 @@
     "missingDescription": [],
     "missingBody": []
   },
-  "generatedFrom": "<home>/.dsh/profiles/desktop/node_modules/@michengai/dsh-agency-agents",
+  "generatedFrom": "<home>/web/t-team/vendor/agency-agents",
   "divisions": 22,
   "unlabelledDivisions": []
 }