dsh-plugin-t-expert 0.1.1 → 0.2.2

package/README.md

@@ -11,12 +11,12 @@
 | `@` 召唤 | 在输入框打 `@` 出现按分区分组的中文菜单，选中的专家作为原生引用 chip 进入本轮对话 |
 | 模型工具 | `list_t_experts` / `summon_t_expert` / `summon_t_experts` / `t_team_plan_check` 四个工具 |
 | 小队命令 | `/t` 列出小队；`/t <小队名\|别名> <目标>` 直接拉起一支多成员小队干活 |
-| 设置页 | 设置 → T专家，三个标签：**专家**（启停）/ **小队**（编辑小队模板）/ **团队**（运行中团队的活动面板） |
+| 设置页 | 设置 → T专家，两个标签：**专家**（启停 / 看提示词）与 **队伍**（小队模板 + 运行中的团队） |
 
-专家名册与团队引擎**解耦**：即使团队引擎挂载失败，专家名册、`@` 召唤、`/t` 列表仍然照常可用。
-
-界面效果见 `docs/`：`panel-preview.png`（专家卡片网格）、`popup-preview.png`（`@` 召唤弹窗）、
-`prompt-modal-preview.png`（查看提示词）、`settings-tabs-preview.png`（设置页标签）。
+专家名册与团队引擎**解耦**：团队引擎挂载失败（例如宿主子代理契约不匹配）时，
+专家名册、`@` 召唤、`/t` 列表仍然照常可用。
+> 注意：这条解耦覆盖的是**引擎的运行时挂载**。宿主包本身缺失时（插件声明了若干
+> `@deepseek-ai/*` peer 依赖，由 DSH 安装提供）整个插件都无法加载 —— 这是任何插件的共同前提。
 
 ---
 
@@ -42,7 +42,7 @@ dsh plugin --profile web add dsh-plugin-t-expert
 需要锁版本时：
 
 ```bash
-dsh plugin --profile web add --save-exact dsh-plugin-t-expert@0.1.0
+dsh plugin --profile web add --save-exact dsh-plugin-t-expert@0.1.1
 ```
 
 插件在 `package.json` 里声明了 `dsh.bundle`（补丁文件 `cordis.patch.yml`），
@@ -57,21 +57,16 @@ dsh plugin --profile web add --save-exact dsh-plugin-t-expert@0.1.0
 error: profile "desktop" is managed exclusively by the Electron application
 ```
 
-所以请走这两条路之一：
-
-- **插件市场（推荐）**：在 DSH Desktop 里用插件市场（dsh-market）一键安装。
-- **仓库内的安装脚本**：先在本仓库里构建，再安装：
+**请用插件市场（dsh-market）安装**：在 DSH Desktop 里搜索本插件一键装即可。
 
-```bash
-npm install
-npm run build
-bash scripts/install-desktop.sh --dry-run   # 预览将要做什么
-bash scripts/install-desktop.sh             # 真正安装
-bash scripts/install-desktop.sh --remove    # 卸载（还原 profile manifest）
-```
+本仓库**不自带安装脚本**（维护者的运维脚本不在仓库里）。如果你要手工装，等价动作是：
+把包内的 `lib/`、`data/`、`cordis.patch.yml` 与许可文件复制到一个运行目录，在目标 profile 的
+`package.json` 里加一条 `file:<该目录>` 依赖并追加到 `dsh.profile.bundles`，再把整个目录
+**真目录拷贝**（不要符号链接）到 profile 的 `node_modules/<包名>`。
 
-脚本会把运行副本写到 `~/.t-team/plugin`，在 profile 的 `package.json` 里加一条 `file:` 依赖与 bundle 条目
-（写入前先备份 manifest），再把运行副本原样拷进 profile 的 `node_modules`。
+> ⚠️ 该 `file:` 依赖指向的是**运行目录**，与首次播种出来的数据目录是两处，不要混在一起：
+> 运行目录可随时重建，数据目录必须长期保留。清空或迁移运行目录会连带影响插件解析，
+> 届时重跑一遍安装步骤即可。
 
 ### 3. 装完之后
 
@@ -102,7 +97,7 @@ bash scripts/install-desktop.sh --remove    # 卸载（还原 profile manifest
 │   ├── descriptions.json # slug → 中文简介
 │   ├── divisions.json    # 分区中文标签
 │   ├── <分区>/<slug>.md  # 中文人格正文（与 experts/ 同相对路径）
-│   ├── manual.json       # 人工补译：names / descriptions / divisionLabels（优先于自动层）
+│   ├── manual.json       # 人工补译：names / descriptions（优先于自动层）
 │   ├── manual-bodies/    # 人工补译正文（最高优先，不会被覆盖）
 │   └── COVERAGE.json     # 中文覆盖率与缺口清单
 ├── teams.json            # 小队定义（设置页「小队」标签写回这里）
@@ -127,6 +122,29 @@ bash scripts/install-desktop.sh --remove    # 卸载（还原 profile manifest
 | `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` 类型不对，属于自带数据的错配，插件会在**加载时直接失败**并指出路径与修法。
 
 ---
 
@@ -152,13 +170,14 @@ bash scripts/install-desktop.sh --remove    # 卸载（还原 profile manifest
 | `/t <小队名\|别名> <目标>` | 拉起该小队执行目标（队长先给出成员与任务草案，等你 review 后再启动） |
 | `/t <一句话目标>` | 没有匹配到小队名时，按目标自动挑选最合适的小队 |
 
-小队匹配支持 key、中文别名与模糊匹配；改名单不需要重启，每次都从磁盘读小队定义。
+小队**列表与匹配**每次都从磁盘读定义，所以改完名字立刻反映在 `/t` 里；
+但**建队时用的是插件启动时载入的引擎配置**，因此小队定义的增删改要**重启 DSH** 才对建队生效。
 
 ---
 
 ## 六、编辑小队
 
-**设置 → T专家 → 小队** 标签里可以搜索、修改成员 / 别名 / 启停，然后保存。
+**设置 → T专家 → 队伍** 标签里可以搜索、修改成员 / 别名 / 启停，然后保存。
 
 保存流程：
 
@@ -167,6 +186,9 @@ bash scripts/install-desktop.sh --remove    # 卸载（还原 profile manifest
 3. **编译失败会自动回滚** `teams.json`（不会把坏定义留在盘上）；
 4. 缺 `python3` 时报错并回滚。
 
+> ⚠️ **保存后需要重启 DSH**：`/t` 列表会立刻看到新小队，但引擎配置在插件启动时已载入，
+> 不重启就建不了队（`/t 新队 目标` 会提示「小队不存在」）。
+
 硬约束（由 `team-profiles.py` 与小队数据层校验）：
 
 | 约束 | 值 |
@@ -184,32 +206,35 @@ bash scripts/install-desktop.sh --remove    # 卸载（还原 profile manifest
 
 本插件以 **MIT** 发布，全文见 `LICENSE`。
 
-随包分发的专家名册与其人格文本、内置团队引擎均按 **MIT** 授权使用，各自的来源、版本与署名要求写在
-`THIRD-PARTY-NOTICES` 里。再分发本插件（含修改版）时，请一并保留 `LICENSE` 与该文件。
+随包分发的专家名册、中文译文与内置团队引擎各自按 MIT 授权使用，
+各自的来源、版本与署名要求写在 `THIRD-PARTY-NOTICES` 里，**完整许可文本随包放在 `vendor/` 下**。
+再分发本插件（含修改版）时，请一并保留 `LICENSE`、`THIRD-PARTY-NOTICES` 与 `vendor/` 下的许可文本。
 
 ---
 
 ## 八、开发 / 构建
 
 ```bash
-npm install          # 安装开发依赖
-npm run build        # 品牌化（scripts/brand.mjs）+ 构建客户端产物（scripts/build-client.mjs）
+npm install          # 安装依赖（peer 依赖由 DSH 宿主提供）
+npm run build        # 品牌化 + 构建客户端产物
 npm run verify       # 自检套件（插件契约、工具、remote、客户端产物、播种与快照一致性）
+npm run sync-data    # 把运行时数据同步进包内 data/（默认源 ~/.t-team）
 ```
 
-随包数据快照：
-
-```bash
-npm run sync-data                    # 把运行时数据同步进包内 data/（默认源 ~/.t-team）
-node scripts/sync-data.mjs --check   # 只校验快照与源是否一致
-```
+> ⚠️ 这些 script 的实现文件**不在本仓库里**：维护者把它们放在仓库同级的运维目录
+> （`../brand.mjs`、`../build-client.mjs`、`../verify.mjs`、`../sync-data.mjs`，由 `package.json`
+> 的 `scripts` 以相对路径引用）。只 clone 本仓库是跑不了构建与自检的；要发布请使用完整的工作目录。
+>
+> `npm run build` 必须**先**品牌化再构建客户端：客户端产物把品牌化后的引擎 bundle 内联进去，
+> 顺序错了会把旧文本打进产物。
 
 ---
 
 ## 九、已知限制
 
 - 客户端面板**不做自定义专家的增删改**；要加自己的专家，直接把 `.md` 放进 `~/.t-team/experts/<分区>/`，宿主按 mtime 指纹自动重载，不需要重启。
+  （中文侧车同理：`zh/` 下的名字 / 简介 / 正文文件增删改都会按指纹重载。）
 - 包内快照只在数据目录**缺项**时播种。升级插件只更新包内快照，**不会覆盖你已有的数据目录内容**。
-- 设置页的「团队」标签只在真的有运行中团队时才出现。
+- 小队定义的改动需要重启 DSH 才对**建队**生效（见第五、六节）。
 - 改插件代码后需要重新 `npm run build`（改了 `src/client.jsx` 才会重新生成客户端产物）并重装/重启。
 - 团队引擎挂载失败时，团队相关功能不可用，但专家名册、`@` 召唤、`/t` 列表不受影响，失败原因由 `/t` 报出。

package/THIRD-PARTY-NOTICES

@@ -1,7 +1,8 @@
 # 第三方组件与内容声明
 
-本插件（`dsh-plugin-t-expert`，MIT，见 `LICENSE`）打包了两部分第三方成果。它们各自保留原许可，
-本文件说明来源、版本与许可，以便再分发时履行署名义务。
+本插件（`dsh-plugin-t-expert`，MIT，见 `LICENSE`）打包了两部分第三方成果。
+它们各自保留原许可，本文件说明来源、版本与许可，以便再分发时履行署名义务。
+**完整许可文本随包分发**在 `vendor/` 下（见第 3 节）。
 
 ## 1. 内置团队引擎
 
@@ -10,24 +11,34 @@
 | 上游包 | `@nanmicoder/dsh-agent-teams` |
 | 上游仓库 | https://github.com/NanmiCoder/dsh-agent-teams |
 | 版本 | `0.1.17-rc.1` |
-| 许可 | MIT — Copyright (c) 2026 程序员阿江(Relakkes) |
-| 位置 | `vendor/dsh-agent-teams/`（上游文件逐字节原样保留，含其 `LICENSE` 与 `VENDOR.md`）、`lib/teams/`（由 `scripts/brand.mjs` 从 vendor 改名生成的品牌化产物：命令 `/agent-teams` → `/t`、工具 `agent_teams_*` → `t_team_*`） |
+| 许可 | 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_*`） |
 
-本插件对引擎的改动都在自己的代码里（挂载、配置注入、client 复用），vendor 目录内的文件不作修改。
+**对上游镜像的改动**：`vendor/dsh-agent-teams/upstream/` 内的文件**永不修改**；
+`lib/teams/` 是生成物，差异 = 品牌化改名 + `brand.mjs` 中逐条注释的 `FIXES`。
+除改名外，`FIXES` 还包含少量**本地缺陷修补与必要的行为改动**（例如把 profile 上限从 16 抬到 48、
+修正命令视图 key、修正交接期与终态任务的校验、放行 `.env.example` 一类模板文件等）。
+每条 `FIXES` 都声明了期望命中次数，上游文本一变即构建失败，不会静默退回上游行为。
 
-## 2. 专家名册与人格文本
+## 2. 专家名册与中文侧车
 
 | 项 | 值 |
 | --- | --- |
-| 上游项目 | The Agency（`msitarzewski/agency-agents`，README 中亦作 AgentLand） |
+| 英文名册 | 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` |
-| 许可 | MIT — Copyright (c) 2025 AgentLand Contributors |
-| 位置 | `data/experts/`（18 分区 / 279 位，逐字节镜像）、`data/zh/`（中文侧车） |
+| 位置 | `data/experts/`（18 分区 / 279 位，逐字节镜像）、`data/zh/`（中文名字 / 简介 / 人格正文 / 分区标签） |
 
-`data/zh/` 下的中文名字、简介、人格正文与分区标签为本项目的翻译与整理成果，
-其中 `data/zh/manual-bodies/` 与 `data/zh/manual.json` 为人工补译，随本插件以 MIT 授权发布。
+`data/zh/manual.json` 与 `data/zh/manual-bodies/` 是**本项目的补充翻译**（用于补齐上游尚未覆盖的
+条目或在译文不准确时覆盖），随本插件以 MIT 发布。
 
 ## 3. 分发要求
 
-再分发本插件（或其修改版）时请一并保留：本文件、`LICENSE`、`vendor/dsh-agent-teams/LICENSE`，
-以及上述两处上游署名。
+再分发本插件（或其修改版）时请一并保留以下文件（它们都在 npm 包内）：
+
+- `LICENSE`（本插件）
+- `THIRD-PARTY-NOTICES`（本文件）
+- `vendor/dsh-agent-teams/LICENSE`（内置团队引擎）
+- `vendor/third-party-licenses/agency-agents.LICENSE`（英文名册）
+- `vendor/third-party-licenses/agency-agents-zh.LICENSE`（中文译文）

package/cordis.patch.yml

@@ -1,5 +1,5 @@
 # 由 `dsh plugin add` 读取并合并到目标 profile。
-# remote 行让 api-gateway 从根服务表发现 T团队 的 Typert 服务（wire 名 tTeam）。
+# remote 行让 api-gateway 从根服务表发现 T专家 的 Typert 服务（wire 名 tTeam）。
 - insert:
     - id: t-team-remote
       name: 'dsh-plugin-t-expert/remote'

package/data/source.json

@@ -2,7 +2,7 @@
   "source": "<home>/.agency-agents",
   "sourceRevision": "6d29a9b",
   "target": "<home>/web/t-team/data/experts",
-  "syncedAt": "2026-09-12 09:32:27 +0800",
+  "syncedAt": "2026-09-12 14:16:29 +0800",
   "divisions": [
     "academic",
     "design",

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          # 引擎侧已由 scripts/brand.mjs 把 MAX_TEAM_PROFILES 调到 48（上游默认 16）
+MAX_PROFILES = 48          # 引擎侧已由品牌化工具 brand.mjs 把 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/teams.json

@@ -1,5 +1,5 @@
 {
-  "_note": "T专家 小队定义（人工维护）。每支小队 = 一个 AgentTeams profile：key 用 ASCII（会变成 /agent-teams-<key> 命令），中文放 description 与 aliases（供 /t 用），members 是 T专家 名册里的专家 slug。改完跑 `python3 team-profiles.py` 重新生成 profile 配置。",
+  "_note": "T专家 小队定义（人工维护）。每支小队 = 一个团队引擎 profile：key 用 ASCII（用 /t <key> <目标> 拉起，引擎内是 /t --profile <key>），中文放 description 与 aliases（供 /t 匹配），members 是 T专家 名册里的专家 slug。改完跑 `python3 team-profiles.py` 重新生成引擎配置。",
   "defaults": {
     "taskPlanning": "captain",
     "personaMode": "summary",

package/data/zh/manual.json

@@ -1,5 +1,5 @@
 {
-  "_note": "T团队 的中文补译层（人工维护）。sync-zh.py 会把它覆盖到自动提取的译文之上；键是专家 slug。上游新增专家若缺译文，会出现在 zh/COVERAGE.json 的 gaps 里，在这里补上再重跑 sync-zh.py 即可。名字/简介用本文件的 names/descriptions；正文缺口另放 zh/manual-bodies/<分区>/<slug>.md（最高优先、不会被同步清理）。",
+  "_note": "T专家 的中文人工补译层（人工维护）。键是专家 slug。名字/简介写在本文件的 names/descriptions；正文另放 zh/manual-bodies/<分区>/<slug>.md（最高优先，同步清场时整棵子树跳过、永不被删）。上游新增专家若缺译文会出现在 zh/COVERAGE.json 的 gaps 里，在这里补上即可。",
   "names": {
     "engineering-ats-validator-architect": "ATS 简历解析验证架构师",
     "engineering-china-network-engineer": "中国网络工程师",

package/lib/catalog.js

@@ -1,5 +1,5 @@
 /**
- * T团队 花名册：扫描固定专家目录，解析 frontmatter，按 slug 建立索引。
+ * T专家 花名册：扫描固定专家目录，解析 frontmatter，按 slug 建立索引。
  *
  * 目录形态固定为 `<root>/<division>/<slug>.md`，
  * 其中 game-development 之类的分区可以再嵌套一层子目录（递归扫描）。