dsh-plugin-t-expert 0.1.0

package/lib/command.js

@@ -0,0 +1,228 @@
+/**
+ * `/t` —— T专家 的小队短命令。
+ *
+ * 只做一件事：把 `/t <小队> <目标>` 翻译成引擎认得的手势消息
+ * `/t --profile <key> <目标>`（引擎的手势边界认得这个形状），并作为**一条真实用户消息**投递回去；
+ * 之后由引擎的 `agent/pre-step` 手势边界接手。
+ * 也就是说：引擎 100% 复用内置的团队引擎（lib/teams/），T专家 只提供「人 + 短命令」。
+ */
+import { readFileSync } from "node:fs";
+import { createUserMessage } from "@deepseek-ai/dsh-llm";
+
+export const COMMAND_NAME = "t";
+
+/** 把两种来源的成员写法归一成 { name, role }：
+ *  - team-profiles.py 生成的 teams.resolved.json：成员已是对象
+ *  - 人工维护的 teams.json：成员是专家 slug 字符串
+ */
+function normalizeMembers(members) {
+  if (!Array.isArray(members)) return [];
+  return members
+    .map((member) => {
+      if (typeof member === "string") return { name: member, role: member };
+      if (member !== null && typeof member === "object" && typeof member.name === "string") {
+        return { name: member.name, role: typeof member.role === "string" ? member.role : member.name };
+      }
+      return undefined;
+    })
+    .filter((member) => member !== undefined);
+}
+
+/** 归一成 { description, aliases, taskPlanning, members }，缺字段给安全默认值。 */
+function normalizeProfile(profile) {
+  const source = profile !== null && typeof profile === "object" ? profile : {};
+  return {
+    description: typeof source.description === "string" ? source.description : "",
+    aliases: Array.isArray(source.aliases) ? source.aliases.filter((a) => typeof a === "string") : [],
+    taskPlanning: source.taskPlanning === "seed" ? "seed" : "captain",
+    members: normalizeMembers(source.members),
+  };
+}
+
+/**
+ * 每次调用都从磁盘读小队定义（改名单不需要重启）：
+ * 优先读同目录下由 team-profiles.py 生成的 `teams.resolved.json`（成员带中文名），
+ * 缺失时回退人工维护的 `teams.json`（成员是 slug）。
+ */
+export function readTeams(file) {
+  const candidates = [file.replace(/teams\.json$/u, "teams.resolved.json"), file];
+  for (const candidate of candidates) {
+    try {
+      const parsed = JSON.parse(readFileSync(candidate, "utf8"));
+      const profiles = parsed?.profiles;
+      if (profiles === null || typeof profiles !== "object" || Array.isArray(profiles)) continue;
+      const out = {};
+      for (const [key, profile] of Object.entries(profiles)) out[key] = normalizeProfile(profile);
+      if (Object.keys(out).length > 0) return out;
+    } catch {
+      /* 试下一个候选 */
+    }
+  }
+  return {};
+}
+
+/** 归一化：小写、去空白、全角转半角（中文别名不受影响）。 */
+function normalizeToken(value) {
+  return String(value ?? "")
+    .trim()
+    .toLowerCase()
+    .replace(/[\uFF01-\uFF5E]/gu, (ch) => String.fromCharCode(ch.charCodeAt(0) - 0xfee0))
+    .replace(/[\s\u3000]/gu, "");
+}
+
+/**
+ * 用 profile key 或别名找小队。三轮：① 精确（key/别名）② 双向子串（用户多打或少打字）
+ * ③ 多个别名命中同一小队时视为命中（例如「写首诗」同时含「诗」与「写」两个别名）。
+ */
+export function resolveTeam(profiles, query) {
+  const needle = normalizeToken(query);
+  if (needle === "") return undefined;
+  const entries = Object.entries(profiles).map(([key, profile]) => ({
+    key,
+    profile,
+    tokens: [key, ...(Array.isArray(profile?.aliases) ? profile.aliases : [])].map(normalizeToken).filter((t) => t !== ""),
+  }));
+  for (const entry of entries) {
+    if (entry.tokens.some((token) => token === needle)) return { key: entry.key, profile: entry.profile };
+  }
+  const fuzzy = entries.filter((entry) => entry.tokens.some((token) => token.includes(needle) || needle.includes(token)));
+  if (fuzzy.length === 1) return { key: fuzzy[0].key, profile: fuzzy[0].profile };
+  const multi = entries.filter((entry) => entry.tokens.filter((token) => needle.includes(token)).length >= 2);
+  if (multi.length === 1) return { key: multi[0].key, profile: multi[0].profile };
+  return undefined;
+}
+
+/** 小队一句话摘要（给队长复述用）。 */
+function describeProfile(key, profile) {
+  const members = Array.isArray(profile?.members) ? profile.members : [];
+  const names = members.map((member) => member.name).filter((name) => typeof name === "string");
+  const aliases = Array.isArray(profile?.aliases) && profile.aliases.length > 0 ? `（别名 ${profile.aliases.join(" / ")}）` : "";
+  return `${key}${aliases} — ${profile?.description ?? ""}${names.length > 0 ? ` · ${names.length} 人：${names.join("、")}` : ""}`;
+}
+
+/**
+ * 让队长把信息**用中文说出来**的投递文本。
+ *
+ * 为什么不用命令的返回值：部分 DSH 版本里命令行的结果行不渲染（用户「发了命令没任何反应」），
+ * 而 followup 消息一定会渲染成可见对话。所以 `/t` 的每一种结果都投一条可读指令给队长。
+ */
+function relayListDirective(list) {
+  return [
+    "【T专家 · 小队列表】用户敲了 `/t`（没有带目标），请直接用中文把下面的小队列表回复给用户，",
+    "并带一句用法提示：`/t <小队|别名> <目标>`。不要创建团队、不要调用建队工具。",
+    "",
+    list,
+  ].join("\n");
+}
+
+function relayPickDirective(key, profile) {
+  const members = Array.isArray(profile?.members) ? profile.members : [];
+  const names = members.map((member) => member.name).filter((name) => typeof name === "string");
+  return [
+    `【T专家 · 已选定小队：${key}】用户敲了 \`/t ${key}\` 但没给目标。`,
+    "请用中文先列出这个小队的成员，再问用户这次要完成什么。现在不要建队、不要调用建队工具。",
+    "",
+    `小队：${describeProfile(key, profile)}`,
+    names.length > 0 ? `成员：${names.join("、")}` : "成员：尚未解析（跑一次 team-profiles.py）",
+  ].join("\n");
+}
+
+function relayRouteDirective(input, list) {
+  return [
+    `【T专家 · 未指定小队】用户敲的是：\`/t ${input}\`，其中没有能匹配到小队名的词。`,
+    `请把「${input}」当作目标，从下面的小队里挑最合适的一个，然后**直接调用 t_team_create 并带上 profile="<key>"** 建队（approval=\"required\" 先 staged，等用户在面板 review）；`,
+    "不要反问用户该用哪个小队，也不要自己手搭成员——profile 已带好成员与人格。",
+    "若确实没有合适的小队，就用中文说明原因并列出可用小队。",
+    "",
+    list,
+  ].join("\n");
+}
+
+/** `/t` 无参数时的列表。 */
+export function renderTeamList(profiles) {
+  const keys = Object.keys(profiles);
+  if (keys.length === 0) {
+    return "还没有配置小队。打开 设置 → T专家 → 小队 保存一次就会生成（保存时用数据目录里的 team-profiles.py 编译引擎配置）。";
+  }
+  const lines = ["T专家 小队（用 /t <小队> <目标> 拉起）："];
+  for (const key of keys) {
+    const profile = profiles[key] ?? {};
+    const members = Array.isArray(profile.members) ? profile.members : [];
+    const names = members.map((member) => member.name).filter((name) => typeof name === "string");
+    const aliases = Array.isArray(profile.aliases) && profile.aliases.length > 0
+      ? `（别名 ${profile.aliases.join(" / ")}）`
+      : "";
+    const detail = names.length > 0 ? `${names.length} 人：${names.join("、")}` : "尚未解析成员（跑一次 team-profiles.py）";
+    lines.push(`- ${key}${aliases} — ${profile.description ?? ""} · ${detail}`);
+  }
+  lines.push("也可以直接用引号里的完整写法：/t --profile <key> <目标>");
+  return lines.join("\n");
+}
+
+/**
+ * 注册 `/t`。
+ * @param ctx 宿主上下文
+ * @param options.teamsFile teams.json 路径（通常与名册同目录）
+ * @param options.hasEngine 探测内置团队引擎是否在位的函数
+ */
+export function registerTeamCommand(ctx, options) {
+  const teamsFile = options.teamsFile;
+  const hasEngine = options.hasEngine;
+  ctx.effect(() => ctx.commands.register({
+    name: COMMAND_NAME,
+    description: "用 T专家 小队执行一个目标（底层走 T专家 内置的多智能体团队引擎）",
+    input: { hint: "<小队名|别名> <目标>" },
+    handler(invocation) {
+      if (hasEngine() !== true) {
+        const detail = typeof options.engineError === "function" ? options.engineError() : "";
+        const text = detail === ""
+          ? "团队引擎未就绪：T专家 内置的团队引擎没有挂载成功（查看 DSH 日志里的 [t-team] 行）。"
+          : `团队引擎挂载失败：${detail}`;
+        // 命令结果行在部分 DSH 版本不渲染，所以连错误也交给队长转述一次。
+        invocation.agent.followup(createUserMessage({
+          content: [{ type: "text", text: `【T专家】团队引擎未就绪，请用中文把这句话转告用户，不要建队：${text}` }],
+          source: { kind: "user" },
+        }));
+        return { kind: "error", text };
+      }
+      const profiles = readTeams(teamsFile);
+      const list = renderTeamList(profiles);
+      const deliver = (text) => invocation.agent.followup(createUserMessage({
+        content: [{ type: "text", text }],
+        source: { kind: "user" },
+      }));
+      const raw = String(invocation?.rawInput ?? "").trim();
+
+      // ① `/t` 裸调用：让队长把小队列表说出来（可见），而不是只塞进命令结果行。
+      if (raw === "" || raw === "list" || raw === "ls" || raw === "help") {
+        deliver(relayListDirective(list));
+        return { kind: "success", text: list };
+      }
+
+      const [head, ...rest] = raw.split(/\s+/u);
+      const goal = rest.join(" ").trim();
+      const hit = resolveTeam(profiles, head);
+
+      // ② 没匹配到小队：不报错了事，让队长按目标自动挑小队（用户不必记得队名）。
+      if (hit === undefined) {
+        deliver(relayRouteDirective(raw, list));
+        return { kind: "success", text: `「${head}」不是小队名——已交给队长按目标挑选小队。` };
+      }
+
+      // ③ 只给了小队名：让队长列成员并问目标。
+      if (goal === "") {
+        deliver(relayPickDirective(hit.key, hit.profile));
+        return { kind: "success", text: `已选定「${hit.key}」，队长会列出成员并问你这次要做什么。` };
+      }
+
+      // ④ 小队 + 目标：投成引擎认得的手势消息，pre-step 边界注入队长协议。
+      deliver(`/t --profile ${hit.key} ${goal}`);
+      const memberCount = Array.isArray(hit.profile?.members) ? hit.profile.members.length : 0;
+      const label = hit.profile?.description || hit.key;
+      return {
+        kind: "success",
+        text: `已激活「${label}」${memberCount > 0 ? `（${memberCount} 人）` : ""} —— 队长会先给出成员与任务草案，等你 review 后再启动。`,
+      };
+    },
+  }), "t-team: /t command");
+}

package/lib/i18n.js

@@ -0,0 +1,136 @@
+/** T专家 host 侧文案与列表/结果渲染。 */
+
+export const NS = "t-team";
+
+const ZH = {
+  "error.rootMissing": "T专家 专家目录不存在或无法访问：\"{root}\"。请运行 ~/.t-team/sync.sh 生成，或配置正确的 root。",
+  "error.rootNotDir": "T专家 专家目录 \"{root}\" 不是目录",
+  "error.catalogEmpty": "在 root \"{root}\" 下没有发现任何专家（*.md）。请确认已运行 sync.sh。",
+  "error.summonRequiresAgent": "当前上下文没有可用的 parent agent，无法召唤专家。",
+  "error.providerMissing": "找不到子代理 provider：{provider}",
+  "error.providerNoPersona": "provider {provider} 不支持 persona，无法注入专家人格。",
+  "error.providerNoToolFilter": "provider {provider} 不支持 toolFilter，无法限制专家可用工具。",
+  "error.providerNoMaxDepth": "provider {provider} 不支持 depthLimit，无法应用 maxDepth。",
+  "error.expertDisabled": "专家「{name}」尚未启用：请在 设置 → T专家 里先启用它。",
+  "error.expertRun": "专家运行未正常结束（{reason}）：{detail}",
+  "error.partialOutput": "已产生部分输出：{text}",
+  "error.taskEmpty": "task 不能为空",
+  "error.taskTooLong": "task 超过 {limit} 个字符",
+  "error.specsEmpty": "experts 不能为空",
+  "error.specsTooMany": "一次最多召唤 {limit} 位专家",
+  "error.specInvalid": "experts[{index}] 需要 expert 与 task 两个字段",
+  "error.settingsMissing": "T专家 设置段尚未注册",
+  "list.headerAll": "T专家 花名册（已启用 {total} 位，覆盖 {divisions} 个分区）：",
+  "list.headerOne": "分区 {division} 的已启用专家（{count} 位）：",
+  "list.emptyAll": "还没有启用任何专家。请在 设置 → T专家 里启用。",
+  "list.emptyOne": "分区「{division}」下没有已启用的专家。",
+  "list.unknownDivision": "找不到分区「{query}」。可用分区：{divisions}",
+  "list.hint": "用 summon_t_expert(expert, task) 召唤其中一位；批量用 summon_t_experts。",
+  "summon.batchHeader": "批量召唤 {total} 位专家：成功 {ok} / 失败 {failed}",
+  "summon.itemOk": "## {expert}\n{answer}",
+  "summon.itemFail": "## {expert}\n失败：{error}",
+};
+
+const EN = {
+  "error.rootMissing": "T Expert expert directory is missing or unreadable: \"{root}\". Run ~/.t-team/sync.sh or configure a valid root.",
+  "error.rootNotDir": "T Expert expert root \"{root}\" is not a directory",
+  "error.catalogEmpty": "No experts (*.md) found under root \"{root}\". Run sync.sh first.",
+  "error.summonRequiresAgent": "No parent agent in this context; cannot summon an expert.",
+  "error.providerMissing": "Subagent provider not found: {provider}",
+  "error.providerNoPersona": "Provider {provider} does not support persona injection.",
+  "error.providerNoToolFilter": "Provider {provider} does not support toolFilter.",
+  "error.providerNoMaxDepth": "Provider {provider} does not support depthLimit, so maxDepth cannot apply.",
+  "error.expertDisabled": "Expert \"{name}\" is not enabled. Enable it in Settings → T Expert first.",
+  "error.expertRun": "Expert run did not complete ({reason}): {detail}",
+  "error.partialOutput": "Partial output: {text}",
+  "error.taskEmpty": "task must not be empty",
+  "error.taskTooLong": "task exceeds {limit} characters",
+  "error.specsEmpty": "experts must not be empty",
+  "error.specsTooMany": "At most {limit} experts per call",
+  "error.specInvalid": "experts[{index}] requires both expert and task",
+  "error.settingsMissing": "T Expert settings section is not registered yet",
+  "list.headerAll": "T Expert roster ({total} enabled experts across {divisions} divisions):",
+  "list.headerOne": "Enabled experts in division {division} ({count}):",
+  "list.emptyAll": "No expert is enabled yet. Enable some in Settings → T Expert.",
+  "list.emptyOne": "No enabled expert in division \"{division}\".",
+  "list.unknownDivision": "Unknown division \"{query}\". Available: {divisions}",
+  "list.hint": "Summon one with summon_t_expert(expert, task); use summon_t_experts for a batch.",
+  "summon.batchHeader": "Summoned {total} experts: {ok} succeeded / {failed} failed",
+  "summon.itemOk": "## {expert}\n{answer}",
+  "summon.itemFail": "## {expert}\nfailed: {error}",
+};
+
+/** 取文案并按 {name} 占位替换。 */
+export function t(locale, key, params = {}) {
+  const table = locale === "en" ? EN : ZH;
+  let text = table[key] ?? ZH[key] ?? key;
+  for (const [key2, value] of Object.entries(params)) {
+    text = text.split(`{${key2}}`).join(String(value));
+  }
+  return text;
+}
+
+/** 从宿主 locale 设置读语言，缺失或异常回退 zh。 */
+export function readLocale(ctx) {
+  try {
+    const section = ctx.settings?.get?.("locale");
+    const preference = section?.preference;
+    if (typeof preference === "string" && preference.toLowerCase().startsWith("en")) return "en";
+  } catch {
+    /* 读不到就用中文 */
+  }
+  return "zh";
+}
+
+/**
+ * 按语言取专家显示名与简介。
+ * 中文优先用侧车目录的译文（expert.nameZh / descriptionZh），缺失则回退上游英文。
+ */
+export function localized(expert, locale) {
+  if (locale === "en") {
+    return { name: expert.nameEn || expert.name, description: expert.descriptionEn || expert.description };
+  }
+  return {
+    name: expert.nameZh || expert.name,
+    description: expert.descriptionZh || expert.description,
+  };
+}
+
+/** list_t_experts 的文本渲染。 */
+export function renderList(locale, { query, groups, total, allDivisions }) {
+  if (query !== "" && groups.length === 0) {
+    return t(locale, "list.unknownDivision", { query, divisions: allDivisions.join(", ") });
+  }
+  if (total === 0) {
+    return query === "" ? t(locale, "list.emptyAll") : t(locale, "list.emptyOne", { division: query });
+  }
+  const lines = [];
+  if (query === "") {
+    lines.push(t(locale, "list.headerAll", { total, divisions: groups.length }));
+    for (const group of groups) {
+      lines.push(`- ${group.label} (${group.division}) — ${group.count}`);
+    }
+    lines.push(t(locale, "list.hint"));
+  } else {
+    const group = groups[0];
+    lines.push(t(locale, "list.headerOne", { division: `${group.label} (${group.division})`, count: group.count }));
+    for (const expert of group.experts) {
+      const { name, description } = localized(expert, locale);
+      // 带上 slug：模型可以直接拿它当召唤参数，避免只靠名字解析
+      lines.push(`- ${expert.emoji} ${name} (${expert.slug}) — ${description}`);
+    }
+  }
+  return lines.join("\n");
+}
+
+/** summon_experts 的文本渲染。 */
+export function renderSummonResults(locale, results) {
+  const ok = results.filter((r) => r.ok).length;
+  const lines = [t(locale, "summon.batchHeader", { total: results.length, ok, failed: results.length - ok })];
+  for (const item of results) {
+    lines.push(item.ok
+      ? t(locale, "summon.itemOk", { expert: item.expert, answer: item.answer })
+      : t(locale, "summon.itemFail", { expert: item.expert, error: item.error ?? "" }));
+  }
+  return lines.join("\n\n");
+}