dsh-plugin-t-expert 0.3.6 → 0.3.24

package/lib/index.js

@@ -12,8 +12,8 @@
  */
 import { homedir } from "node:os";
 import { existsSync, readFileSync, readdirSync } from "node:fs";
-import { stat, rmdir } from "node:fs/promises";
-import { dirname, join } from "node:path";
+import { mkdir, stat, rmdir } from "node:fs/promises";
+import { basename, dirname, join, resolve } from "node:path";
 import schema from "@deepseek-ai/schemastery";
 import { defineTool } from "@deepseek-ai/dsh-tools";
 import {
@@ -111,6 +111,16 @@ export const Config = schema.object({
   memberModel: schema.string(),
   /** 一支团队最多几名成员。 */
   maxMembers: schema.natural().min(1).default(8),
+  /**
+   * 定时任务默认绑定的工作区（首次使用时自动建/复用）。
+   *
+   * 为什么要有它：定时任务跑出来的会话如果"不绑定工作区"，在侧栏里就没有归属，
+   * 一堆自动会话会散在工作区列表外面；给它们一个固定去处（默认「定时任务」工作区、
+   * 目录 <默认目录>/tesk）最好找。目录不存在会被建出来 —— 宿主的工作区 create
+   * 只接受已存在的目录。
+   */
+  scheduleWorkspaceTitle: schema.string().default("定时任务"),
+  scheduleWorkspaceDir: schema.string().default(join(homedir(), "tesk")),
 });
 
 /** 供 remote 服务读取名册的服务名。 */
@@ -247,12 +257,41 @@ export function apply(ctx, config) {
     defaultCwd: process.cwd(),
     // 提交前的提示词改写：提示词里挑中的 `@专家名` 由它在执行时落成召唤指令。
     expandPrompt: (text) => expandSchedulePrompt(text),
+    // 工作区需求：定时任务默认绑到「定时任务」工作区（目录 <默认目录>/tesk），也可自定义目录。
+    ensureWorkspace: (path, title) => ensureWorkspace(path, title),
     // 先按「开」起来；settings 就绪后立刻按真实偏好对齐（见下面的 inject 回调）。
     armed: true,
   });
   ctx.effect(() => () => scheduleEngine.dispose(), "t-team: schedule jobs");
   ctx.reflect.provide(SCHEDULE_SERVICE, scheduleEngine);
 
+  /**
+   * 确保一个工作区存在，并返回 { id, title, path }。
+   *
+   * 顺序：目录不存在先 mkdir（宿主的工作区 create **只接受已存在的目录**）→ 交给
+   * workspaceRegistry.create：它内部对同路径工作区是**幂等复用**（createCanonical 第一件事
+   * 就是按 path 查找已有实体），所以重复调用不会造出第二个「定时任务」工作区。
+   *
+   * @param path - 目录绝对路径；空串表示用配置里的 scheduleWorkspaceDir。
+   * @param title - 工作区标题；缺省时：默认工作区用配置里的 scheduleWorkspaceTitle，自定义目录用目录名。
+   */
+  async function ensureWorkspace(path, title) {
+    const registry = ctx.get("workspaceRegistry") ?? ctx.get("workspace");
+    if (registry === undefined || typeof registry.create !== "function") {
+      throw new Error("宿主没有可用的工作区服务（workspaceRegistry.create），无法准备定时任务工作区。");
+    }
+    const raw = typeof path === "string" && path.trim() !== "" ? path.trim() : config.scheduleWorkspaceDir;
+    const custom = typeof path === "string" && path.trim() !== "";
+    const target = resolve(raw);
+    await mkdir(target, { recursive: true });
+    // 自定义目录的工作区标题缺省取目录名：否则几个自定义目录会挤成同名「定时任务」，侧栏里分不出来。
+    const label = title !== undefined && title !== ""
+      ? title
+      : (custom ? basename(target) : config.scheduleWorkspaceTitle);
+    const entity = await registry.create(target, label);
+    return { id: String(entity.id), title: String(entity.title ?? ""), path: String(entity.path ?? target) };
+  }
+
   /**
    * 把定时任务提示词里点名的专家落成**明确的召唤指令**（支持同时点名多位）。
    *

package/lib/remote-schemas.js

@@ -209,7 +209,8 @@ export const scheduleSnapshotSchema = z.object({
   /** 正在执行中的事项 id（面板据此显示「执行中…」）。 */
   running: z.array(z.string()),
   capabilities: z.object({ agents: z.boolean(), presets: z.boolean() }),
-  workspaces: z.array(z.object({ id: z.string(), title: z.string() })),
+  /** 可选工作区（下拉选项）；path 是目录，面板显示给用户看落地位置。 */
+  workspaces: z.array(z.object({ id: z.string(), title: z.string(), path: z.string().optional() })),
 });
 
 /** 新建/编辑表单提交的字段。 */
@@ -230,3 +231,8 @@ export const schedulePreviewSchema = z.object({ fires: z.array(z.string()) });
 
 /** `setArmed` 的结果。 */
 export const scheduleArmedSchema = z.object({ armed: z.boolean() });
+
+/** `ensureScheduleWorkspace` 的返回：定时任务要绑定的工作区（默认「定时任务」工作区或自定义目录）。 */
+export const scheduleWorkspaceSchema = z.object({
+  workspace: z.object({ id: z.string(), title: z.string(), path: z.string() }),
+});

package/lib/remote.js

@@ -32,6 +32,7 @@ import {
   scheduleInputSchema,
   schedulePatchSchema,
   schedulePreviewSchema,
+  scheduleWorkspaceSchema,
   scheduleSnapshotSchema,
   squadInputSchema,
   squadMemberSchema,
@@ -121,6 +122,14 @@ const DESCRIPTORS = [
       codec: { mode: "strict", typeSymbol: "string", schema: z.string().min(1).max(120) },
     },
   ], "TTeamSchedulePreview", schedulePreviewSchema),
+  descriptor("ensureScheduleWorkspace", [
+    {
+      name: "path",
+      wire: "path",
+      source: "json",
+      codec: { mode: "strict", typeSymbol: "string", schema: z.string().max(1024) },
+    },
+  ], "TTeamScheduleWorkspace", scheduleWorkspaceSchema),
   descriptor("setEnabled", [
     {
       name: "enabled",
@@ -436,6 +445,18 @@ class TTeamRemote extends TypertRemoteService {
     }
   }
 
+  /**
+   * 确保定时任务要绑定的工作区存在：空 path = 配置里的默认「定时任务」工作区（目录 <默认目录>/tesk）；
+   * 给了 path = 面板里填的自定义目录（不存在会建出来）。宿主的工作区 create 对同路径是幂等复用。
+   */
+  async ensureScheduleWorkspace(path) {
+    try {
+      return { workspace: await this.schedule().ensureWorkspace(String(path ?? ""), undefined) };
+    } catch (error) {
+      throw this.businessError(error, "tTeam/schedule-workspace-failed");
+    }
+  }
+
   /** 预览某个 cron 表达式接下来的 5 次触发时间（宿主用 croner 算，客户端不打包 cron 解析器）。 */
   async previewSchedule(cron) {
     try {
@@ -639,7 +660,7 @@ class TTeamRemote extends TypertRemoteService {
 exposeRemoteMethods(TTeamRemote, [
   "getCatalog", "setEnabled", "getPrompt", "getSquads", "saveSquads", "getTeams", "stopTeam", "startSquad",
   "getUiPrefs", "setUiPrefs",
-  "getSchedule", "createScheduleItem", "updateScheduleItem", "deleteScheduleItem", "runScheduleItem", "previewSchedule",
+  "getSchedule", "createScheduleItem", "updateScheduleItem", "deleteScheduleItem", "runScheduleItem", "previewSchedule", "ensureScheduleWorkspace",
   "createExpert", "updateExpert", "deleteExpert",
   "createCategory", "updateCategory", "deleteCategory",
 ]);

package/lib/schedule.js

@@ -110,10 +110,14 @@ export function normalizeInput(input, t) {
  * @param {string} options.defaultCwd - 不绑定工作区时的会话工作目录。
  * @param {boolean} [options.armed] - 初始是否启用调度（= 界面开关的当前值）。
  * @param {(text: string) => Promise<string>} [options.expandPrompt] - 提交前的提示词改写
- *   （提示词里挑中的  由它落成召唤指令）。缺省就是原文。
+ *   （提示词里挑中的 `@专家名` 由它落成召唤指令）。缺省就是原文。
+ * @param {(path: string, title?: string) => Promise<{ id: string, title: string, path: string }>} [options.ensureWorkspace]
+ *   - 准备定时任务的工作区（默认「定时任务」工作区，或面板里填的自定义目录）。缺省则面板该项不可用。
  */
 export function createScheduleEngine(options) {
   const { ctx, file, logger, t, defaultCwd } = options;
+  /** 工作区准备（默认「定时任务」工作区 / 自定义目录），由 host 注入。 */
+  const ensureWorkspace = typeof options.ensureWorkspace === "function" ? options.ensureWorkspace : undefined;
   /** 提交前的提示词改写：没有注入就原样提交（定时任务本身不依赖它）。 */
   const expandPrompt = typeof options.expandPrompt === "function"
     ? options.expandPrompt
@@ -320,6 +324,8 @@ export function createScheduleEngine(options) {
       workspaces: list.map((workspace) => ({
         id: String(workspace.id ?? ""),
         title: String(workspace.title ?? workspace.path ?? ""),
+        // 目录：面板把它显示在表单里，用户能看清这条任务落在哪个文件夹。
+        path: typeof workspace.path === "string" ? workspace.path : "",
       })).filter((workspace) => workspace.id !== ""),
     };
   }
@@ -412,6 +418,13 @@ export function createScheduleEngine(options) {
     remove,
     runNow,
     preview: (cron) => ({ fires: previewRuns(cron, t) }),
+    /** 给面板用：确保定时任务的默认工作区（或自定义目录）存在，返回 { id, title, path }。 */
+    ensureWorkspace: (path, title) => {
+      if (ensureWorkspace === undefined) {
+        return Promise.reject(new Error("宿主没有提供工作区准备能力（ensureWorkspace）。"));
+      }
+      return ensureWorkspace(path, title);
+    },
     setArmed,
     isArmed: () => armed,
     /** 当前真正挂着定时器的事项 id（自检与诊断用：能看出"任务在、但没排定"这种失效）。 */

package/lib/skill.js

@@ -33,10 +33,20 @@ export const SKILLS_ROOT = resolve(dirname(fileURLToPath(import.meta.url)), ".."
  * 随包发布的 skill 清单（目录名 = 宿主路由用的 skill 名）。
  *
  * 顺序即注册顺序。缺文件的条目会被跳过并逐条告警，而不是让整段注册失败 ——
- * 一个 skill 文件缺失不该带走另外两个。
+ * 一个 skill 文件缺失不该带走另外两个（见 {@link LOCAL_ONLY_SKILL_NAMES} 的例外）。
  */
 export const BUNDLED_SKILL_NAMES = ["t-expert-manager", "dsh-harness-project", "dsh-harness-languages"];
 
+/**
+ * **只在本机布局里存在**的 skill：不进 npm 包（见 `package.json` 的 `files`）。
+ *
+ * 为什么：`t-expert-manager` 的正文整篇都是 `tz.sh` 运维流程，而 `ops/`、`tools/`、`tz.sh`
+ * 都不随包发布 —— 从 npm 装的人本来就不该有它，拿了也是一份跑不动的手册。所以它缺席是**预期**，
+ * 不能按"缺文件"告警（否则每次启动一条"未注册"，看着像装坏了）。本机从源码装（`tz.sh install`
+ * 会把整个 `skills/` 复制进运行副本）时它照常在，运维流程一字不少。
+ */
+export const LOCAL_ONLY_SKILL_NAMES = ["t-expert-manager"];
+
 /** 只有运维 skill 的正文带 `{{TZ}}` / `{{OPS_ROOT}}` 占位符，其余按原样注册。 */
 const PLACEHOLDER_SKILL = "t-expert-manager";
 
@@ -161,17 +171,23 @@ function loadBundledSkill(name, config = {}) {
 /**
  * 逐个构建随包 skill，并**记下**哪些条目没建成以及为什么。
  *
- * 注册方靠 `missing` 逐条告警 —— 缺一个文件不该静默、也不该带走另外两个。
+ * 注册方靠 `missing` 逐条告警 —— 缺一个文件不该静默、也不该带走另外两个；
+ * 唯一的例外是 {@link LOCAL_ONLY_SKILL_NAMES}：它们不随 npm 包发布，缺席是预期。
  * @param config - 插件配置。
- * @returns `{ skills, missing }`；顺序与 {@link BUNDLED_SKILL_NAMES} 一致。
+ * @returns `{ skills, missing }`；`skills` 顺序与 {@link BUNDLED_SKILL_NAMES} 一致。
  */
 function collectBundledSkills(config = {}) {
   const skills = [];
   const missing = [];
   for (const name of BUNDLED_SKILL_NAMES) {
     const loaded = loadBundledSkill(name, config);
-    if (loaded.skill === undefined) missing.push({ name, reason: loaded.reason });
-    else skills.push(loaded.skill);
+    if (loaded.skill !== undefined) {
+      skills.push(loaded.skill);
+      continue;
+    }
+    // 本机专有的 skill（npm 包里本来就没有）：缺席是预期，既不告警也不进 missing。
+    if (LOCAL_ONLY_SKILL_NAMES.includes(name)) continue;
+    missing.push({ name, reason: loaded.reason });
   }
   return { skills, missing };
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-plugin-t-expert",
-  "version": "0.3.6",
+  "version": "0.3.24",
   "type": "module",
   "description": "T Expert — a 316-expert, 22-division roster with full Chinese translations, as a standalone DeepSeek Harness plugin, with a built-in multi-agent team engine (T Team).",
   "license": "MIT",
@@ -42,7 +42,8 @@
   "files": [
     "lib",
     "data",
-    "skills",
+    "skills/dsh-harness-project",
+    "skills/dsh-harness-languages",
     "cordis.patch.yml",
     "README.md",
     "LICENSE",

package/vendor/third-party-licenses/README.md

@@ -5,7 +5,7 @@
 
 | 文件 | 覆盖的随包内容 | 来源 |
 | --- | --- | --- |
-| `agency-agents.LICENSE` | `data/experts/`（22 分区 / 316 位；其中 315 位来自第三方 —— 279 位为上游仓库逐字节镜像、35 位来自名册来源包快照；余 2 位为本仓自建，不由本许可覆盖） | The Agency / AgentLand 名册快照，MIT |
+| `agency-agents.LICENSE` | `data/experts/`（22 分区 / 316 位；其中 314 位来自第三方 —— 279 位为上游仓库逐字节镜像、35 位来自名册来源包快照；余 2 位为本仓自建，不由本许可覆盖） | The Agency / AgentLand 名册快照，MIT |
 | `agency-agents-zh.LICENSE` | `data/zh/` 中的中文名字、简介与人格正文 | `agency-agents-zh` 中文翻译与本地化资产，MIT |
 
 两份文本都是从实际用于生成快照的来源包内**逐字节复制**的，未经改写：

package/skills/t-expert-manager/SKILL.md

@@ -1,125 +0,0 @@
----
-name: t-expert-manager
-description: T专家 运维台 —— 316 位专家 / 22 分区的名册增删、名册一致性校验、统计与中文覆盖、小队（/t）成员编辑、装机到 DSH Desktop、发布到 npm。Use when the user asks to add/remove/validate/count T专家 experts, 新增专家 / 删除专家 / 校验名册 / 名册统计 / 改小队 / 重装插件 / 发布插件.
----
-
-# T专家 运维（expert-manager）
-
-运维入口只有一个：`bash "{{TZ}}"`。本机运维台根目录：`{{OPS_ROOT}}`。
-
-这套流程解决的是「你是原作者，要维护自己的名册和插件」的场景；只想**用**专家或拉小队，不要走这里
-（用 `list_t_experts` / `summon_t_expert`，小队用 `/t`）。
-
-## 铁律
-
-1. **只用 tz.sh**。不要手改 `data/experts/`、`plugin/`、`~/.t-team/`，也不要手改 `package.json` 的版本号 ——
-   这些动作脚本都代劳了，绕开脚本换来的就是"源码加了、运行时没加"这类半成品状态。
-2. **`data/experts/` 是真源**。增删由 `add-expert.py`（tz.sh 代跑）执行，它**同时写**源码与运行时
-   `~/.t-team/experts/`，两边永远一致。
-3. **统计必须递归**。有专家落在嵌套子目录（如 `game-development/unreal-engine/…`），
-   只看分类目录的第一层会漏掉它们。位数一律以 `tz.sh status` 的递归结果为准 ——
-   正文里不写死位数，因为每加一位专家它就会过期。
-4. **数据更新不用重装、不用重启**（宿主按 mtime 指纹自动重载名册）；**改插件代码**才需要
-   `tz.sh build` → `tz.sh install` → 重启 DSH Desktop。
-5. **小队改完分两条路，只有设置页那条会热重载**：
-   - **设置页「队伍」保存**（推荐）：`squads.save()` 编译成功后**就地热重载引擎配置 → 立即生效、不用重启**。
-   - **`tz.sh squads`（= 菜单 11）**：只是 CLI 直跑编译器（`python3 data/team-profiles.py`）把 `teams.json`
-     编译成引擎配置，**不经过插件、不会热重载**——运行中的引擎仍用旧 profiles，**必须重启 DSH**
-     （或再到设置页保存一次）才生效。所以别对用户说「跑完 tz.sh squads 就已经生效」。
-   两条路的失败语义一致：编译失败会**回滚**，盘上仍是旧配置（按旧小队建队）。
-   只有**改插件代码**才需要重启（见第 4 条）。
-6. **`data/zh/` 已冻结**：不要新增或"补译"中文。新专家没有中文名/简介会回退英文，这是预期行为。
-7. **破坏性动作先确认**：删除专家、卸载插件、发布 npm 之前，把影响讲给用户听，得到明确同意再执行。
-
-## 先看状态
-
-```bash
-bash "{{TZ}}" status
-```
-
-一眼给出：名册位数 / 分类数 / 中文覆盖 / 插件版本 vs DSH 里装的版本 / 仓库是否干净。
-
-## 工作流
-
-### A. 新增专家
-
-1. 先确认 slug 不冲突（`bash "{{TZ}}" roster` 看现有分类与位数）。
-2. **先 dry-run**：
-   ```bash
-   bash "{{TZ}}" experts add --category <分区> --slug <slug> --file </绝对路径/xxx.md> --dry-run
-   ```
-3. 确认路径无误后去掉 `--dry-run` 正式写入。源文件缺 frontmatter 时补 `--name` / `--description`；
-   目标已存在要覆盖时加 `--force`。
-4. 收尾校验：`bash "{{TZ}}" experts check`，必须报"三处一致"。
-
-### B. 删除专家
-
-先 `--dry-run` 看清要删的两条路径，再执行：
-
-```bash
-bash "{{TZ}}" experts remove --category <分区> --slug <slug> --yes
-```
-
-源码与运行时会被一并删除（`--yes` 跳过交互确认，所以**先跟用户确认过**再用）。
-
-### C. 校验名册
-
-```bash
-bash "{{TZ}}" experts check     # 源码 ↔ 运行时 ↔ 清单，逐文件 sha256；退出码 1 = 有漂移
-bash "{{TZ}}" verify            # check + 插件自检（verify.mjs），改过代码后必跑
-```
-
-### D. 统计与中文覆盖
-
-```bash
-bash "{{TZ}}" experts stats
-```
-
-汇报时给"分类数 / 专家数 / 中文覆盖"，不要把整张分类表贴给用户。
-
-### E. 修改小队（`/t`）
-
-1. 小队定义在 `data/teams.json`（人工维护）：成员写专家 slug 字符串，或 `{slug, role}` 对象。
-2. 用编辑器改完后编译成引擎配置：
-   ```bash
-   bash "{{TZ}}" squads
-   ```
-3. 明确告诉用户：**`tz.sh squads` 只是 CLI 直跑编译器**——它把 `teams.json` 编译成引擎配置，
-   **不会让运行中的插件重载**。所以：**要让新小队真正生效，需重启 DSH Desktop**（或再到设置页「队伍」保存一次，
-   那条路才会就地热重载、立即生效）。若 `/t` 里仍看不到新小队，先确认编译没报错（编译失败会回滚，盘上仍是旧配置）。
-4. 想免重启就直接走设置页：设置 → T专家 → 队伍 → 改完保存（`squads.save()` 编译成功后触发引擎热重载，立即生效）。
-
-### F. 装机（只在改过插件代码时需要）
-
-```bash
-bash "{{TZ}}" verify            # 先自检
-bash "{{TZ}}" build             # 构建 client bundle
-bash "{{TZ}}" install           # 装到 profile（默认 desktop）；可先 --dry-run
-```
-
-装机后仍需**重启 DSH Desktop**。装错/装坏时 `bash "{{TZ}}" install-restore` 可还原被接管的依赖。
-
-### G. 发布到 npm
-
-```bash
-bash "{{TZ}}" publish-dry       # 预演：只跑预检与打包预览
-bash "{{TZ}}" publish --current # 直接发布 package.json 里的当前版本（不升版）—— 版本号在开发期就写好了
-bash "{{TZ}}" publish           # 交互选版本（菜单里选项 1 就是"发布当前版本"）；也可 --patch / --minor / --major / --version X.Y.Z
-```
-
-> 版本号的单一来源是 `package.json`：菜单 15 会把**当前版本号自动读出来**并作为首选，
-> 客户端构建版本（`CLIENT_BUILD_VERSION`）与它必须一致（verify 有断言盯着），所以通常不需要在发布时再 bump。
-> 回车＝取消（发布不可逆，没有"回车即发"的默认）。
-> 选「发布当前版本」不跑 `npm version`，但会**给该版本补一个 tag** —— 发出去的版本要能对应到具体提交，失败后也才能用 `--retry` 重试。
-
-**发布前必须**：(a) 得到用户明确同意；(b) `experts check` 与 `verify` 全绿；(c) 工作区没有未提交的意外改动。
-
-## 汇报约定
-
-- 给"执行的命令 + 结尾结论"，不要贴整篇日志。
-- 失败就贴出错那一段（含退出码）并说明下一步；不要静默重试或换个命令重来。
-- 名册位数永远按递归结果报（见铁律 3）。
-
-## 参考
-
-- `references/ops-reference.md` —— 完整子命令 / 菜单号 / 参数表，以及"哪份文件是真源"的地图。

package/skills/t-expert-manager/references/ops-reference.md

@@ -1,100 +0,0 @@
-# T专家 运维参考
-
-本文件是 `SKILL.md` 的展开版：完整命令、菜单号、参数与"哪份文件是真源"的地图。
-命令里的 `<ops>` = 运维台根目录（`tz.sh` 所在目录）。
-
-## 一、子命令（脚本化用，agent 优先用这一组）
-
-| 子命令 | 作用 | 备注 |
-| --- | --- | --- |
-| `tz.sh status` | 状态头：名册/中文/版本/仓库是否干净 | 只读 |
-| `tz.sh experts add` | 新增专家 | 参数见下；无参数 = 交互 |
-| `tz.sh experts remove` | 删除专家（源码 + 运行时） | 先 `--dry-run` |
-| `tz.sh experts stats` | 名册统计（分类 / 专家数 / 中文覆盖） | 递归统计 |
-| `tz.sh experts check` | 名册一致性（源码 ↔ 运行时 ↔ 清单） | 退出码 1 = 漂移 |
-| `tz.sh roster` | 同 `experts stats` | |
-| `tz.sh verify` | `experts check` + `verify.mjs` 插件自检 | 改代码后必跑 |
-| `tz.sh squads` | 刷新小队配置（`teams.json` → 引擎 profiles，= 菜单 11） | **CLI 直跑编译器，不触发热重载**：运行中的引擎仍用旧 profiles → 需重启 DSH Desktop（或改走设置页保存） |
-| `tz.sh build` | 构建 client bundle | `npm run build` |
-| `tz.sh install` | 安装/重装到 profile | 见参数；`--dry-run` 预演 |
-| `tz.sh uninstall` | 卸载（保留 `experts/` 与 `zh/`） | |
-| `tz.sh install-restore` | 还原被接管的 `@nanmicoder/dsh-agent-teams` | 有接管记录时可用 |
-| `tz.sh sync-data` | 把运行时数据快照同步回包内 `data/` | 发布前用 |
-| `tz.sh publish-dry` / `publish` | 发布预演 / 发布到 npm | 见参数 |
-| `tz.sh open` | 打开运行时数据目录 | |
-
-## 二、交互菜单号（`tz.sh <编号>` 等价）
-
-| # | 动作 | # | 动作 |
-| --- | --- | --- | --- |
-| 1 | 新增专家 | 9 | 卸载插件（保留数据） |
-| 2 | 删除专家 | 10 | 校验：名册一致性 + 插件自检 |
-| 3 | 名册统计 | 11 | 刷新小队配置 |
-| 4 | 打开源码专家目录 `data/experts` | 12 | 构建插件产物 |
-| 5 | 名册一致性校验 | 13 | （已移除）内置引擎同步 |
-| 6 | 中文覆盖报告（已冻结） | 14 | 发布预演（dry-run） |
-| 7 | 打开运行时数据目录 | 15 | 一键发布到 npm |
-| 8 | 安装/重装到 profile | 16 | 同步包内数据快照 |
-
-## 三、`experts add` / `experts remove` 参数
-
-`add`（`--repo` / `--runtime` 由 tz.sh 自动注入，不要手写）：
-
-| 参数 | 说明 |
-| --- | --- |
-| `--category <分区>` | 目标分类（已存在或新建） |
-| `--slug <slug>` | 文件名即 slug：`a-z 0-9 -`；中文名必须显式给 `--slug` |
-| `--file <路径>` | 源 Markdown（绝对路径最稳） |
-| `--label <显示名>` | 新建分类时的中文显示名 |
-| `--name` / `--description` / `--emoji` | 源文件缺 frontmatter 时补齐 |
-| `--force` | 目标已存在时覆盖 |
-| `--yes` | 跳过交互确认 |
-| `--dry-run` | 只打印将写入的路径，不落盘 |
-
-`remove`：`--category` + `--slug`（+ `--yes` / `--dry-run`）。
-`slug` 就是文件名；工具会在分类树下**递归**定位它，嵌套子目录也能删对。
-
-## 四、`install` / `publish` 参数
-
-```
-tz.sh install [--profile <名或路径>] [--dry-run] [--keep-agent-teams]
-tz.sh install-restore
-tz.sh uninstall
-tz.sh publish-dry | publish [--patch|--minor|--major|--version X.Y.Z] [--retry] [--push|--no-push]
-```
-
-- 默认 profile：`~/.dsh/profiles/desktop`。
-- `install` 会：把仓库复制成运行副本 `plugin/`（STAGE）→ 复制到 profile 的 `node_modules/` →
-  改 profile 的 `package.json` 依赖/bundles。**必须重启 DSH Desktop 才生效**。
-- `publish` 默认 patch 升版；`--retry` 用于发布中断后重试；`--no-push` 不推 git tag。
-
-## 五、真源地图（改哪份才是改对了）
-
-| 内容 | 真源 | 说明 |
-| --- | --- | --- |
-| 专家名册 | `<ops>/dsh-plugin-t-expert/data/experts/` | 22 分类 / 316 位；运行时是它的同步副本 |
-| 中文侧车 | `<ops>/dsh-plugin-t-expert/data/zh/` | **已冻结**，只读不写 |
-| 小队定义 | 数据目录 `teams.json` | 人工维护；`data/` 与 `~/.t-team/` 同一份（软链） |
-| 小队编译产物 | 数据目录 `t-team.config.json` | 由 `team-profiles.py` 生成，**不要手改** |
-| 面板自建专家 | `<数据目录>/custom/custom/<slug>.md` | 不属于快照，同步脚本永不碰它 |
-| 团队引擎源码 | `<ops>/dsh-plugin-t-expert/lib/teams/` | 手工维护的源码 |
-| 运行副本 | `<ops>/plugin/` | 安装产物，删了重跑 `tz.sh install` 即可重建 |
-
-## 六、环境变量（覆盖路径）
-
-| 变量 | 默认 | 作用 |
-| --- | --- | --- |
-| `T_TEAM_REPO` | `<ops>/dsh-plugin-t-expert` | 插件仓库位置 |
-| `T_TEAM_DATA` | `<ops>/data` | 数据目录 |
-| `T_TEAM_STAGE` | `<ops>/plugin` | 运行副本目录 |
-
-## 七、常见故障
-
-| 现象 | 原因 / 处理 |
-| --- | --- |
-| 名册少了几位 | 只数了分类目录的第一层（嵌套子目录里的专家被漏掉）—— 必须递归，以 `tz.sh status` 为准 |
-| `experts check` 报"运行时缺/多出" | 绕开脚本手工拷贝过文件；用 `experts add` 重做那一条 |
-| 新增专家后面板看不到 | 面板按 mtime 指纹自动重载；仍看不到就查该专家是否被**启用**（设置页 T专家 标签，默认全禁用） |
-| 改了小队但 `/t` 里没生效 | 先看编译报错（失败会回滚，盘上仍是旧配置）；若编译成功却是走 `tz.sh squads` 的，**运行中的引擎不会热重载 → 需重启 DSH Desktop**，或改走设置页「队伍」保存（那条立即生效） |
-| 装了新版本但没变化 | 只跑了 `build` 没跑 `install`，或没重启 |
-| `找不到插件仓库` | 设 `T_TEAM_REPO`，或用 `--repo` 指定 |