@stofone/dsh-agent-roster 0.5.1 → 0.6.0

package/index.js

@@ -17,6 +17,7 @@ import { readFileSync } from "node:fs";
 import z from "@deepseek-ai/schemastery";
 
 import { configView } from "./lib/config-view.js";
+import { applyCaptain, listSessions } from "./lib/apply.js";
 import { collectLibrary } from "./lib/library.js";
 import { parseDocumentText } from "./lib/parse.js";
 import { validateRoster } from "./lib/validate.js";
@@ -111,7 +112,9 @@ export function apply(ctx, config) {
         const query = new URL(req.url ?? "/", "http://localhost").searchParams;
         // 远程源是“附属信息”：拉不到也不能让本地档案库的响应失败，所以失败只体现在 remote.diagnostics 里。
         const remote = await loadRemotePanel(settings, { refresh: query.get("refresh") === "1" });
-        sendJson(res, 200, { ...snapshot, remote });
+        // 会话列表也是“附属信息”：没有 sessionController（或它报错）时面板仍要能用。
+        const sessions = await listSessions(ctx.get?.("sessionController"));
+        sendJson(res, 200, { ...snapshot, remote, sessions });
       },
       "library route",
     );
@@ -238,6 +241,43 @@ export function apply(ctx, config) {
       "install route",
     );
 
+    register(
+      "/plugins/dsh-agent-roster/apply",
+      async (req, res) => {
+        if (guard(req, res)) return;
+        if (!requireMethod(req, res, "POST")) return;
+        const body = await readJsonBody(req);
+        if (!body.ok) {
+          sendError(res, body.status, body.code);
+          return;
+        }
+        const input = body.value !== null && typeof body.value === "object" ? body.value : {};
+        const rosterId = typeof input.rosterId === "string" ? input.rosterId : "";
+        if (rosterId === "") {
+          sendError(res, 400, "missing-roster");
+          return;
+        }
+        // 只允许对“档案库里真实存在且校验通过”的档案动手：输入不构造路径，也不走缓存。
+        const library = collectLibrary(ctx, settings, { name: pkg.name, version: pkg.version });
+        const rosters = library.workspaces.flatMap((workspace) => workspace.rosters);
+        const roster = rosters.find((item) => item.id === rosterId);
+        if (roster === undefined) {
+          sendJson(res, 404, { ok: false, error: { code: "roster-not-found" }, known: rosters.map((item) => item.id) });
+          return;
+        }
+        const result = await applyCaptain({
+          sessionController: ctx.get?.("sessionController"),
+          roster,
+          mode: input.mode === "new" ? "new" : "existing",
+          sessionId: typeof input.sessionId === "string" ? input.sessionId : "",
+          cwd: typeof input.cwd === "string" ? input.cwd : "",
+        });
+        const status = result.ok ? 200 : result.code === "session-controller-unavailable" ? 503 : 400;
+        sendJson(res, status, result);
+      },
+      "apply route",
+    );
+
     register(
       "/plugins/dsh-agent-roster/rosters",
       async (req, res) => {

package/lib/apply.js

@@ -0,0 +1,186 @@
+/**
+ * “应用队长档案”：把一份档案搬到某个会话里，让那个会话按档案去建团队。
+ *
+ * 为什么是这个形态：队长**不是**能被 `agent_teams_add_member` 创建出来的对象，
+ * 它就是"创建团队的那个会话"。所以要"应用队长档案"，能做的只有三件事：
+ *
+ * 1. 选一个会话（已有的，或新建一个）；
+ * 2. 把档案声明的模型选到那个会话上（`sessionController.selectModel`）；
+ * 3. 往那个会话里排一条提示，让它按档案建团队（`sessionController.prompt`）。
+ *
+ * 第 2 步是**真的写进运行时**（模型选择是会话级持久投影），第 3 步只是让会话开始干活；
+ * 人格（persona）仍然来自部署的 agent preset，档案里只能声明，改不了。
+ *
+ * 这一层不 import 任何宿主包：`sessionController` 由调用方传进来，方便测试。
+ *
+ * @module dsh-agent-roster/apply
+ */
+import { randomUUID } from "node:crypto";
+
+import { MEMBER_FIELDS } from "./format.js";
+
+/**
+ * 会话头上的模型投影：`next` 是下一次请求要用的，`lastUsed` 是上一次真正用过的。
+ *
+ * @param {object | null | undefined} summary `SessionSummary`
+ * @returns {{ provider: string, model: string, reasoningEffort: string } | null}
+ */
+export function pickSessionModel(summary) {
+  const values = summary?.projections?.values;
+  const projection = values?.modelSelection;
+  const selection = projection?.next ?? projection?.lastUsed ?? null;
+  if (selection === null || typeof selection !== "object") return null;
+  return {
+    provider: typeof selection.provider === "string" ? selection.provider : "",
+    model: typeof selection.model === "string" ? selection.model : "",
+    reasoningEffort: typeof selection.reasoningEffort === "string" ? selection.reasoningEffort : "",
+  };
+}
+
+/**
+ * 列可选会话（剔除子代理会话，它们不是队长候选）。
+ *
+ * @param {object | null | undefined} sessionController 宿主 `sessionController` 服务
+ * @returns {Promise<{ ok: boolean, code?: string, sessions: object[] }>}
+ */
+export async function listSessions(sessionController) {
+  if (sessionController === null || typeof sessionController !== "object" || typeof sessionController.list !== "function") {
+    return { ok: false, code: "session-controller-unavailable", sessions: [] };
+  }
+  try {
+    const page = await sessionController.list({});
+    const items = Array.isArray(page?.items) ? page.items : [];
+    const sessions = items
+      .filter((item) => item?.origin !== "subagent")
+      .map((item) => ({
+        sessionId: String(item.sessionId ?? ""),
+        cwd: typeof item.cwd === "string" ? item.cwd : "",
+        updatedAt: typeof item.updatedAt === "number" ? item.updatedAt : 0,
+        running: item.running === true,
+        blank: item.blank === true,
+        model: pickSessionModel(item),
+      }))
+      .filter((item) => item.sessionId !== "");
+    return { ok: true, sessions };
+  } catch (error) {
+    return { ok: false, code: "session-list-failed", reason: String(error?.message ?? error), sessions: [] };
+  }
+}
+
+/**
+ * 一段能给会话照着执行的提示词。
+ *
+ * 只写"要它做什么"和"从哪拿参数"，不复制成员人设原文：人设可能很长，
+ * 而 `roster_show` 已经会把它和建员参数一起给出，重复一遍只会浪费上下文。
+ *
+ * @param {{ roster: object, teamName?: string }} input
+ * @returns {string}
+ */
+export function buildCaptainPrompt(input) {
+  const roster = input.roster;
+  const id = String(roster?.id ?? "");
+  const title = typeof roster?.title === "string" && roster.title !== "" ? roster.title : id;
+  const teamName = typeof input.teamName === "string" && input.teamName !== "" ? input.teamName : id;
+  const members = Array.isArray(roster?.members) ? roster.members : [];
+  const table = members
+    .map((member) => {
+      const bits = [`name: ${member.name}`, `role: ${member.role}`];
+      for (const field of MEMBER_FIELDS) {
+        if (field === "name" || field === "role" || field === "systemPrompt") continue;
+        const value = member[field];
+        if (value === undefined || value === "" || (Array.isArray(value) && value.length === 0)) continue;
+        bits.push(`${field}: ${Array.isArray(value) ? value.join(",") : value}`);
+      }
+      return `- ${bits.join(" | ")}`;
+    })
+    .join("\n");
+
+  return [
+    `请按档案 \`${id}\`（${title}）创建一个多 Agent 团队，队长就是你（当前会话）。`,
+    "",
+    "步骤：",
+    `1. 调用 \`roster_show\`，参数 id: "${id}"。它会给出每个成员的“建员参数”（含人设原文），请以它为准。`,
+    `2. 调用 \`agent_teams_create\`，参数 name: "${teamName}"，description 用档案的 description 或你自己概括，approval: "automatic"。`,
+    `3. 对每个成员调用 \`agent_teams_add_member\`：name / role / executionPrompt 用人设原文，provider / model / reasoningEffort / toolPolicy 按建员参数填；provenance 写 "roster:${id}"。`,
+    `4. 成员都加上后调用 \`roster_verify\`（teamId 用上一步返回的团队 id），确认每个成员的字段是否如实进了运行时。`,
+    "5. 把核对结果摘要给我（哪几个成员、哪些字段 not-carried），不要粘贴成员人设原文。",
+    "",
+    "本次要建的成员：",
+    table === "" ? "- （档案里没有成员）" : table,
+    "",
+    "注意：你的模型/人格不来自这份档案——档案的 captain 段只是声明；要改队长本身，得改部署配置里的 agent-default-model 与 preset persona。档案里的成员模型/provider 若与事实不符，以档案为准去 add_member，不要臆造。",
+  ].join("\n");
+}
+
+/**
+ * 把档案“应用”到一个会话：新建或复用会话 → 选模型 → 排提示。
+ *
+ * @param {object} input
+ * @param {object | null | undefined} input.sessionController 宿主 `sessionController` 服务
+ * @param {object} input.roster 已校验的档案（含 captain 段）
+ * @param {"new" | "existing"} input.mode
+ * @param {string} [input.sessionId] `existing` 时必填
+ * @param {string} [input.cwd] `new` 时可指定会话工作目录，缺省用当前工作区
+ * @param {string} [input.requestId] 便于测试固定 requestId
+ * @returns {Promise<object>}
+ */
+export async function applyCaptain(input) {
+  const sessionController = input.sessionController;
+  if (
+    sessionController === null ||
+    typeof sessionController !== "object" ||
+    typeof sessionController.create !== "function" ||
+    typeof sessionController.prompt !== "function"
+  ) {
+    return { ok: false, code: "session-controller-unavailable" };
+  }
+
+  const roster = input.roster;
+  const captain = roster?.captain ?? {};
+  const mode = input.mode === "new" ? "new" : "existing";
+
+  let sessionId = typeof input.sessionId === "string" ? input.sessionId : "";
+  if (mode === "new") {
+    try {
+      const created = await sessionController.create(input.cwd ? { cwd: input.cwd } : {});
+      sessionId = String(created?.sessionId ?? "");
+    } catch (error) {
+      return { ok: false, code: "session-create-failed", reason: String(error?.message ?? error) };
+    }
+    if (sessionId === "") return { ok: false, code: "session-create-failed" };
+  } else if (sessionId === "") {
+    return { ok: false, code: "missing-session" };
+  }
+
+  let model = null;
+  const provider = typeof captain.provider === "string" ? captain.provider : "";
+  const modelId = typeof captain.model === "string" ? captain.model : "";
+  if (provider !== "" && modelId !== "") {
+    if (typeof sessionController.selectModel !== "function") {
+      return { ok: false, code: "model-selection-unavailable", sessionId };
+    }
+    const selection = { sessionId, provider, model: modelId };
+    const effort = typeof captain.reasoningEffort === "string" ? captain.reasoningEffort : "";
+    if (effort !== "" && effort !== "default") selection.reasoningEffort = effort;
+    try {
+      const applied = await sessionController.selectModel(selection);
+      model = applied?.selected ?? { provider, model: modelId, reasoningEffort: selection.reasoningEffort ?? "" };
+    } catch (error) {
+      // 选不上就**不要**继续排提示：那样会建出一个模型与档案不符的团队，比直接失败更难查。
+      return { ok: false, code: "model-not-applied", sessionId, reason: String(error?.message ?? error) };
+    }
+  }
+
+  try {
+    await sessionController.prompt({
+      requestId: typeof input.requestId === "string" && input.requestId !== "" ? input.requestId : randomUUID(),
+      sessionId,
+      mode: "queue",
+      content: [{ type: "text", text: buildCaptainPrompt({ roster, teamName: input.teamName }) }],
+    });
+  } catch (error) {
+    return { ok: false, code: "prompt-not-queued", sessionId, reason: String(error?.message ?? error) };
+  }
+
+  return { ok: true, sessionId, model, queued: true, mode };
+}

package/lib/captain.js

@@ -0,0 +1,259 @@
+/**
+ * 队长（captain）侧：把部署里真实写着的队长配置读出来，和档案里的声明逐字段核对。
+ *
+ * 为什么需要单独一层：队长**不是一个成员**。agent-teams 的 state 里只有
+ * `captainSessionId` 与 `captainInbox`，没有 captain 成员行，也没有任何工具参数能改写
+ * 队长的路由——队长就是"创建团队的那个会话"，它的模型来自部署配置
+ * （profile 的 `agent-default-model`），它的人格来自 agent preset 的 persona。
+ *
+ * 所以档案里的 `captain` 段只能声明，落地要动部署配置。这一层负责两件事：
+ * 1. 从 profile 的 `cordis.patch.yml` 里读出**实际值**（provider / model / persona 前缀）；
+ * 2. 把实际值和声明逐字段比对，给出 `match / differ / undeclared / unknown` 四态。
+ *
+ * 解析只用行扫描、不引 YAML 解析器：这些 patch 文件里含 `!!js` 标签，
+ * 通用 YAML 解析会直接抛错；而我们要的字段全是顶格的行结构。
+ *
+ * @module dsh-agent-roster/captain
+ */
+import { existsSync, readdirSync, readFileSync } from "node:fs";
+import nodePath from "node:path";
+
+import { displayDshHome, resolveDshHome } from "./home.js";
+
+/** 部署配置里承载队长模型的插件行 id。 */
+export const MODEL_ROW_ID = "agent-default-model";
+
+/** agent preset 行的 id 前缀。 */
+export const PRESET_ID_PREFIX = "preset-";
+
+const PATCH_FILE_NAME = "cordis.patch.yml";
+
+/**
+ * 去掉包裹用的引号（只处理配对的首尾引号，不碰内部字符）。
+ *
+ * @param {string} text
+ * @returns {string}
+ */
+function unquote(text) {
+  const value = text.trim();
+  if (value.length >= 2) {
+    const first = value[0];
+    const last = value[value.length - 1];
+    if ((first === "'" && last === "'") || (first === '"' && last === '"')) {
+      return value.slice(1, -1);
+    }
+  }
+  return value;
+}
+
+/**
+ * 解析 patch 文本，返回**所有** preset 的 persona 前缀（上面的单行扫描已按 preset 分组，
+ * 这里补一份完整列表，便于核对任意 preset）。
+ *
+ * @param {string} text
+ * @param {string} profile
+ * @returns {{ profile: string, provider: string, model: string, reasoningEffort: string, personas: object[] }}
+ */
+export function parseDeployedProfile(text, profile) {
+  const lines = String(text ?? "").split(/\r?\n/);
+  const result = { profile, provider: "", model: "", reasoningEffort: "", personas: [] };
+
+  let row = null;
+  let inPersona = false;
+  let blockIndent = -1;
+  let blockLines = [];
+
+  const flushBlock = () => {
+    if (blockLines.length > 0 && row?.kind === "preset") {
+      row.personaPrefixes.push(blockLines.join("\n").trim());
+    }
+    blockLines = [];
+    blockIndent = -1;
+  };
+
+  const closePreset = () => {
+    if (row?.kind === "preset") {
+      for (const prefix of row.personaPrefixes) {
+        result.personas.push({ preset: row.id, prefix });
+      }
+    }
+  };
+
+  for (const line of lines) {
+    if (blockIndent >= 0) {
+      const indent = line.length - line.trimStart().length;
+      if (line.trim() !== "" && indent >= blockIndent) {
+        blockLines.push(line.trim());
+        continue;
+      }
+      flushBlock();
+    }
+
+    const top = /^-\s+id:\s*(\S+)\s*$/.exec(line);
+    if (top !== null) {
+      closePreset();
+      const id = top[1];
+      if (id === MODEL_ROW_ID) row = { kind: "model" };
+      else if (id.startsWith(PRESET_ID_PREFIX)) row = { kind: "preset", id, personaPrefixes: [] };
+      else row = { kind: "other" };
+      inPersona = false;
+      continue;
+    }
+    if (row === null) continue;
+
+    if (row.kind === "model") {
+      const field = /^\s+(provider|model|reasoningEffort):\s*(.+?)\s*$/.exec(line);
+      if (field !== null) {
+        const value = unquote(field[2]);
+        if (field[1] === "provider") result.provider = value;
+        else if (field[1] === "model") result.model = value;
+        else result.reasoningEffort = value;
+      }
+      continue;
+    }
+
+    if (row.kind === "preset") {
+      const sub = /^\s+-\s+id:\s*(\S+)\s*$/.exec(line);
+      if (sub !== null) {
+        inPersona = sub[1] === "persona";
+        continue;
+      }
+      if (!inPersona) continue;
+      const prefix = /^(\s+)prefix:\s*(.*)$/.exec(line);
+      if (prefix === null) continue;
+      const value = prefix[2].trim();
+      if (value === "|" || value === ">" || value === "|-" || value === ">-") {
+        blockIndent = prefix[1].length + 1;
+        blockLines = [];
+        continue;
+      }
+      if (value !== "") row.personaPrefixes.push(unquote(value));
+    }
+  }
+  flushBlock();
+  closePreset();
+
+  return result;
+}
+
+/**
+ * 读本机所有 profile 的队长配置。
+ *
+ * @param {{ dshHome?: string, env?: Record<string, string | undefined> }} [options]
+ * @returns {{ home: string, displayed: string, profiles: object[], diagnostics: object[] }}
+ */
+export function readDeployedCaptains(options = {}) {
+  const env = options.env ?? process.env;
+  const home = resolveDshHome(options.dshHome, env);
+  const profilesDir = nodePath.join(home, "profiles");
+  const diagnostics = [];
+  const profiles = [];
+
+  if (!existsSync(profilesDir)) {
+    return { home, displayed: displayDshHome(home, env), profiles, diagnostics };
+  }
+
+  let names = [];
+  try {
+    names = readdirSync(profilesDir, { withFileTypes: true })
+      .filter((entry) => entry.isDirectory())
+      .map((entry) => entry.name)
+      .sort();
+  } catch (error) {
+    diagnostics.push({
+      severity: "warn",
+      code: "profiles-unreadable",
+      reason: String(error?.message ?? error),
+    });
+    return { home, displayed: displayDshHome(home, env), profiles, diagnostics };
+  }
+
+  for (const name of names) {
+    const file = nodePath.join(profilesDir, name, PATCH_FILE_NAME);
+    if (!existsSync(file)) continue;
+    try {
+      profiles.push(parseDeployedProfile(readFileSync(file, "utf8"), name));
+    } catch (error) {
+      diagnostics.push({
+        severity: "warn",
+        code: "profile-unreadable",
+        params: { profile: name },
+        reason: String(error?.message ?? error),
+      });
+    }
+  }
+
+  return { home, displayed: displayDshHome(home, env), profiles, diagnostics };
+}
+
+/**
+ * 逐个字段比对"档案声明"与"部署实际值"。
+ *
+ * 四态含义：
+ * - `match`：声明了且部署一致；
+ * - `differ`：声明了但部署不一致（要改部署配置，改档案没用）；
+ * - `undeclared`：档案没声明，运行时用部署默认（不是错误，只是没有约束）；
+ * - `unknown`：读不到部署配置，无法判断（也不能假装通过）。
+ *
+ * @param {object | null | undefined} captain 档案的 captain 段
+ * @param {{ profiles?: object[], displayed?: string }} deployed `readDeployedCaptains` 的结果
+ * @returns {{ checks: object[], ok: boolean, target: object | null, profiles: object[] }}
+ */
+export function verifyCaptain(captain, deployed = {}) {
+  const declared = captain !== null && typeof captain === "object" ? captain : {};
+  const profiles = Array.isArray(deployed.profiles) ? deployed.profiles : [];
+  // 多 profile 时无法确定"这个会话到底跑哪一个"，所以只给出每个字段的"任一匹配"结论，
+  // 并把候选 profile 名单一起返回，让界面说清楚"这是哪个 profile 的值"。
+  const target = profiles.length === 1 ? profiles[0] : null;
+  const compare = (field, declaredValue, actualValues) => {
+    const values = actualValues.filter((value) => typeof value === "string" && value !== "");
+    if (typeof declaredValue !== "string" || declaredValue === "") {
+      const fallback = values.length > 0 ? values[0] : "";
+      return {
+        field,
+        status: fallback === "" ? "undeclared" : "undeclared",
+        declared: "",
+        actual: fallback,
+      };
+    }
+    if (values.length === 0) {
+      return { field, status: "unknown", declared: declaredValue, actual: "" };
+    }
+    const hit = values.includes(declaredValue);
+    return {
+      field,
+      status: hit ? "match" : "differ",
+      declared: declaredValue,
+      actual: values.join(", "),
+    };
+  };
+
+  const checks = [
+    compare("provider", declared.provider, profiles.map((profile) => profile.provider)),
+    compare("model", declared.model, profiles.map((profile) => profile.model)),
+    compare(
+      "reasoningEffort",
+      declared.reasoningEffort === "default" ? "" : declared.reasoningEffort,
+      profiles.map((profile) => profile.reasoningEffort),
+    ),
+  ];
+
+  const personaPrefix = typeof declared.personaPrefix === "string" ? declared.personaPrefix.trim() : "";
+  const prefixes = profiles.flatMap((profile) => profile.personas.map((persona) => persona.prefix));
+  if (personaPrefix === "") {
+    checks.push({ field: "personaPrefix", status: prefixes.length > 0 ? "undeclared" : "unknown", declared: "", actual: prefixes[0] ?? "" });
+  } else if (prefixes.length === 0) {
+    checks.push({ field: "personaPrefix", status: "unknown", declared: personaPrefix, actual: "" });
+  } else {
+    const hit = prefixes.some((prefix) => prefix.trim() === personaPrefix);
+    checks.push({
+      field: "personaPrefix",
+      status: hit ? "match" : "differ",
+      declared: personaPrefix,
+      actual: prefixes[0],
+    });
+  }
+
+  const ok = checks.every((check) => check.status === "match" || check.status === "undeclared");
+  return { checks, ok, target, profiles };
+}

package/lib/render.js

@@ -309,6 +309,31 @@ export function renderCaptainSection(captain) {
 }
 
 /** 状态标签，供 UI 与报告共用。 */
+/**
+ * 队长核对结果：逐字段给「一致 / 不一致 / 未声明 / 无法核对」。
+ *
+ * 四态是刻意的：读不到部署配置时不能写成「通过」，也不能写成「不一致」。
+ *
+ * @param {{ checks?: object[] }} verified
+ * @param {{ displayed?: string }} [options]
+ * @returns {string}
+ */
+export function renderCaptainVerification(verified, options = {}) {
+  const lines = [];
+  const where = options.displayed === undefined || options.displayed === "" ? "" : `（部署：${options.displayed}）`;
+  lines.push(`队长档案核对${where}`);
+  for (const check of verified.checks ?? []) {
+    if (check.status === "match") lines.push(`  ✓ 一致    ${check.field} ${check.declared}`);
+    else if (check.status === "differ") {
+      lines.push(`  ✗ 不一致  ${check.field} 声明 ${check.declared || "（空）"} / 部署 ${check.actual || "（空）"}`);
+    } else if (check.status === "undeclared") {
+      lines.push(`  · 未声明  ${check.field} 未声明，运行时用部署默认${check.actual === "" ? "" : "（" + check.actual + "）"}`);
+    } else lines.push(`  ? 无法核对 ${check.field} 读不到部署配置`);
+  }
+  lines.push("  说明：队长＝创建团队的那个会话，没有成员行；模型来自部署 agent-default-model，人格来自 preset 的 persona。");
+  return lines.join("\n");
+}
+
 export function statusLabel(status) {
   return BINDING_STATUS[status] ?? status;
 }

package/lib/service.js

@@ -13,6 +13,7 @@
 import nodePath from "node:path";
 
 import { globalRosterRoot } from "./home.js";
+import { readDeployedCaptains, verifyCaptain } from "./captain.js";
 import { collectLibrary, listWorkspaces } from "./library.js";
 import { CACHE_DIR_NAME, fetchCollection, loadRegistryIndex } from "./remote.js";
 import { rosterDocumentText } from "./serialize.js";
@@ -74,6 +75,7 @@ export function buildPanelSnapshot(ctx, config, meta, options = {}) {
 
   const hints = buildHints({ library, roots, rosters, teams, config });
   const deployments = countDeployments(rosters, teams.teams);
+  const captain = buildCaptainSection(rosters, options);
 
   return {
     plugin: meta.name,
@@ -89,6 +91,7 @@ export function buildPanelSnapshot(ctx, config, meta, options = {}) {
     workspaces: library.workspaces,
     teams,
     deployments,
+    captain,
     hints,
     summary: {
       rosters: rosters.length,
@@ -241,6 +244,53 @@ export function countDeployments(rosters, teams) {
   return result;
 }
 
+/**
+ * 队长段：部署里的实际值 + 每份档案的核对结果。
+ *
+ * 部署值读不到不算错（核对待核字段会给 `unknown`），但一定如实标出来——不假装通过。
+ *
+ * @param {object[]} rosters
+ * @param {{ readDeployed?: () => object }} [options] 测试注入
+ * @returns {{ deployed: object, reports: object[] }}
+ */
+export function buildCaptainSection(rosters, options = {}) {
+  const readDeployed = options.readDeployed ?? (() => readDeployedCaptains());
+  let deployed;
+  try {
+    deployed = readDeployed();
+  } catch (error) {
+    deployed = {
+      home: "",
+      displayed: "",
+      profiles: [],
+      diagnostics: [{ severity: "warn", code: "captain-unreadable", reason: String(error?.message ?? error) }],
+    };
+  }
+
+  const reports = rosters
+    .filter((roster) => roster.captain !== undefined && roster.captain !== null)
+    .map((roster) => {
+      const verified = verifyCaptain(roster.captain, deployed);
+      return { rosterId: roster.id, rootDir: roster.rootDir ?? "", checks: verified.checks, ok: verified.ok };
+    });
+
+  return {
+    deployed: {
+      home: deployed.home ?? "",
+      displayed: deployed.displayed ?? "",
+      profiles: (deployed.profiles ?? []).map((profile) => ({
+        profile: profile.profile,
+        provider: profile.provider,
+        model: profile.model,
+        reasoningEffort: profile.reasoningEffort,
+        personas: (profile.personas ?? []).length,
+      })),
+      diagnostics: deployed.diagnostics ?? [],
+    },
+    reports,
+  };
+}
+
 /**
  * 配置与环境体检：只产出 code + params，客户端负责措辞。
  *

package/lib/tools.js

@@ -14,7 +14,8 @@ import { LIMITS } from "./format.js";
 import { resolveDirSpec } from "./home.js";
 import { lossless } from "./json.js";
 import { scanRosterLibrary, findRoster } from "./registry.js";
-import { renderBridgePlan, renderRosterDetail, renderRosterList, renderVerifyReport } from "./render.js";
+import { renderBridgePlan, renderCaptainVerification, renderRosterDetail, renderRosterList, renderVerifyReport } from "./render.js";
+import { readDeployedCaptains, verifyCaptain } from "./captain.js";
 import { readTeamStates, resolveStateDir } from "./teams-state.js";
 import { filterChecks, verifyBindings } from "./verify.js";
 
@@ -349,6 +350,11 @@ export function registerRosterTools(ctx, config, meta) {
             // 技能是声明层：只有宿主真的能列出技能目录时才核对，否则如实记成"无法核对"。
             const knownSkills = await readKnownSkills(ctx, workspace);
             let report = verifyBindings(rosters, state.teams, { knownSkills });
+            // 队长不是成员行：只能拿实际的部署配置去比档案里的声明，读不到就记成“无法核对”。
+            const deployedCaptains = readDeployedCaptains();
+            const captainReports = rosters
+              .filter((roster) => roster.captain !== undefined && roster.captain !== null)
+              .map((roster) => ({ roster, verified: verifyCaptain(roster.captain, deployedCaptains) }));
             if (Array.isArray(args.members) && args.members.length > 0) {
               report = filterChecks(report, args.members);
             }
@@ -364,8 +370,16 @@ export function registerRosterTools(ctx, config, meta) {
                 missing: report.summary.missing,
                 unmanaged: report.summary.unmanaged,
                 skills: `${report.summary.skillsMissing}/${report.summary.skillsDeclared}`,
+                captain: captainReports.length,
               }),
               renderVerifyReport(report, { rosterIds: refRosterIds }),
+              ...(captainReports.length === 0
+                ? []
+                : [
+                    captainReports
+                      .map(({ verified }) => renderCaptainVerification(verified, { displayed: deployedCaptains.displayed }))
+                      .join("\n\n"),
+                  ]),
             ].join("\n\n");
             return lossless({
               ok,
@@ -382,6 +396,11 @@ export function registerRosterTools(ctx, config, meta) {
                 fields: check.binding === null ? [] : check.binding.fields,
               })),
               unmanaged: report.unmanaged,
+              captain: captainReports.map(({ roster, verified }) => ({
+                rosterId: roster.id,
+                ok: verified.ok,
+                checks: verified.checks,
+              })),
               skills: report.skills,
               diagnostics: [...scan.diagnostics, ...state.diagnostics],
               text,