@stofone/dsh-agent-roster 0.5.1 → 0.6.1

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,
@@ -85,10 +87,13 @@ export function buildPanelSnapshot(ctx, config, meta, options = {}) {
       defaultRoot: globalRosterRoot(),
       knownToolPolicies: Array.isArray(config.knownToolPolicies) ? config.knownToolPolicies : [],
       stateDirSpec: config.agentTeamsStateDir,
+      region: config.region,
+      registryMirror: config.registryMirror ?? "",
     },
     workspaces: library.workspaces,
     teams,
     deployments,
+    captain,
     hints,
     summary: {
       rosters: rosters.length,
@@ -241,6 +246,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

@@ -1,5 +1,6 @@
 /**
- * 四个模型可见工具：列档案、看成员、生成桥接调用、核对运行时。
+ * 五个模型可见工具：列档案、看成员、生成桥接调用、核对运行时、读公共档案源。
+ * （roster_list / roster_show / roster_create / roster_verify / roster_index）
  *
  * 只读优先：`roster_list` / `roster_show` / `roster_verify` 只读文件系统；
  * `roster_create` 也不写任何东西——它输出的是**参数**，真正的成员创建仍由队长调用
@@ -14,7 +15,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 +351,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 +371,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 +397,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,

package/locale/en.json

@@ -20,7 +20,17 @@
     "policiesNone": "Not configured — policy ids in rosters stay declarations only.",
     "policiesCount": "{count} declared",
     "version": "Version",
-    "openPanel": "Open panel"
+    "openPanel": "Open panel",
+    "region": "Download region",
+    "regionAuto": "Follow default",
+    "regionGlobal": "Global",
+    "regionChina": "China mirror",
+    "save": "Save",
+    "saved": "Saved",
+    "saveFailed": "Could not save — the settings form is unavailable.",
+    "mirror": "Custom registry mirror",
+    "mirrorPlaceholder": "https://registry.npmmirror.com",
+    "mirrorHint": "When set, this replaces the region preset for index sources published as npm packages. Company mirrors with a sub-path (e.g. /repository/npm) work too; leave empty to use the region preset."
   },
   "panel": {
     "title": "Agent Roster",
@@ -46,7 +56,11 @@
     "bannerMany": "{count} things need attention",
     "bannerCta": "Open health",
     "workspaceFallback": "No workspace is registered yet; reading the process directory instead.",
-    "tabsSources": "Sources"
+    "tabsSources": "Sources",
+    "tagPool": "Tags",
+    "tagPoolEmpty": "No tags yet — add `tags:` to an archive.",
+    "tagClear": "Clear tags",
+    "settings": "Settings"
   },
   "roster": {
     "members": "{count} members",
@@ -240,6 +254,40 @@
     "hide": "Hide rosters",
     "loading": "Loading rosters…",
     "repo": "Repository",
-    "conflictHint": "Local versions differ; nothing was overwritten."
+    "conflictHint": "Local versions differ; nothing was overwritten.",
+    "refresh": "Refresh sources",
+    "refreshHint": "No index has been read yet — refresh to fetch the public index."
+  },
+  "captain": {
+    "title": "Captain",
+    "hint": "The captain is the session that creates the team — it has no member row. Its model comes from the deployment (agent-default-model) and its persona from the agent preset, so a roster can only declare them and compare.",
+    "declared": "Declared",
+    "effortDefault": "default",
+    "noPersona": "no persona prefix declared",
+    "hasPersona": "persona prefix declared",
+    "noChecks": "No deployment config read yet — nothing to compare.",
+    "applyTo": "Apply to a session",
+    "modeExisting": "Existing session",
+    "modeNew": "New session",
+    "noSessions": "No sessions available",
+    "cwdPlaceholder": "Working directory (optional)",
+    "apply": "Apply & create team",
+    "applying": "Applying…",
+    "applyFailed": "Apply failed",
+    "applyFailedCode": "Failed: {code}",
+    "applied": "Applied — the team prompt is queued in that session",
+    "appliedTo": "Queued in {session}",
+    "check": {
+      "provider": "Provider",
+      "model": "Model",
+      "reasoningEffort": "Reasoning effort",
+      "personaPrefix": "Persona prefix"
+    },
+    "status": {
+      "match": "matches deployment ({declared})",
+      "differ": "declared {declared}, deployment has {actual}",
+      "undeclared": "not declared, runtime uses {actual}",
+      "unknown": "deployment unreadable"
+    }
   }
 }

package/locale/zh.json

@@ -20,7 +20,17 @@
     "policiesNone": "未配置——档案里写的策略 id 只是声明，运行时不生效。",
     "policiesCount": "已声明 {count} 个",
     "version": "版本",
-    "openPanel": "打开面板"
+    "openPanel": "打开面板",
+    "region": "下载区",
+    "regionAuto": "跟随默认",
+    "regionGlobal": "海外",
+    "regionChina": "国内镜像",
+    "save": "保存",
+    "saved": "已保存",
+    "saveFailed": "保存失败——设置表单当前不可用。",
+    "mirror": "自定义镜像地址",
+    "mirrorPlaceholder": "https://registry.npmmirror.com",
+    "mirrorHint": "填了就用它代替下载区：按 npm 包形式发布的公共档案源从这里取。支持带子路径的公司镜像（如 /repository/npm）；留空用下载区的预置。"
   },
   "panel": {
     "title": "Agent 档案",
@@ -46,7 +56,11 @@
     "bannerMany": "有 {count} 项待处理",
     "bannerCta": "查看体检",
     "workspaceFallback": "还没有注册工作区，暂时按进程所在目录读取。",
-    "tabsSources": "档案源"
+    "tabsSources": "档案源",
+    "tagPool": "标签",
+    "tagPoolEmpty": "还没有标签——给档案加 `tags:`。",
+    "tagClear": "清除标签",
+    "settings": "设置"
   },
   "roster": {
     "members": "{count} 名成员",
@@ -240,6 +254,40 @@
     "hide": "收起",
     "loading": "正在读取档案…",
     "repo": "仓库",
-    "conflictHint": "本地版本与远端不同，未覆盖。"
+    "conflictHint": "本地版本与远端不同，未覆盖。",
+    "refresh": "刷新档案源",
+    "refreshHint": "还没有读到任何索引——点刷新去拉公共索引。"
+  },
+  "captain": {
+    "title": "队长",
+    "hint": "队长就是创建团队的那个会话，没有成员行。它的模型来自部署（agent-default-model），人格来自 agent preset，所以档案只能声明并核对。",
+    "declared": "声明",
+    "effortDefault": "默认",
+    "noPersona": "未声明人格前缀",
+    "hasPersona": "已声明人格前缀",
+    "noChecks": "还没读到部署配置，没有可比对的项。",
+    "applyTo": "应用到会话",
+    "modeExisting": "已有会话",
+    "modeNew": "新建会话",
+    "noSessions": "没有可用会话",
+    "cwdPlaceholder": "工作目录（可留空）",
+    "apply": "应用并创建团队",
+    "applying": "应用中…",
+    "applyFailed": "应用失败",
+    "applyFailedCode": "失败：{code}",
+    "applied": "已应用，建团队提示词已排入该会话",
+    "appliedTo": "已排入 {session}",
+    "check": {
+      "provider": "Provider",
+      "model": "模型",
+      "reasoningEffort": "推理强度",
+      "personaPrefix": "人格前缀"
+    },
+    "status": {
+      "match": "与部署一致（{declared}）",
+      "differ": "声明 {declared}，部署是 {actual}",
+      "undeclared": "未声明，运行时用 {actual}",
+      "unknown": "读不到部署配置"
+    }
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stofone/dsh-agent-roster",
-  "version": "0.5.1",
+  "version": "0.6.1",
   "description": "多 Agent 团队的静态成员档案定义与校验层：档案库在面板里看得见、改得动，团队成员的人设、模型与工具边界固化成可校验、可版本化的文件，并在 dsh-agent-teams 创建成员时把档案桥接给运行时。",
   "type": "module",
   "main": "index.js",