dsh-armory 2.2.1 → 2.3.1

package/lib/tool-ledger.js

@@ -29,6 +29,8 @@ import { setImmediate } from "node:timers";
 
 const SESSIONS_DIR_SEGMENTS = [".dsh", "sessions"];
 const MCP_PREFIX = "mcp__";
+/** §6.4 宿主里「参数带名字」的内置工具：技能调用都从这里走。 */
+const SKILL_TOOL_NAME = "skill";
 /** 每处理这么多文件让出一次事件循环，避免大库扫描把宿主卡住。 */
 const YIELD_EVERY = 16;
 
@@ -60,6 +62,14 @@ const TEXT_CACHE_MAX_ENTRIES = 32;
  */
 const WIRE_TAX_MAX_KEYS = 64;
 
+/**
+ * §6.4 `callId → 技能名` 的映射上限。它只在「等结果回来把错误算到技能头上」这一件事上用，
+ * 而工具账本本来就为每个工具记着 `seenCallIds`，这里只是同一件事的技能版本。上限的作用与
+ * WIRE_TAX_MAX_KEYS 同理：日志长度不可控时不能让它无界增长；超出后停止登记新映射，
+ * 已登记的照常配对，未配对的错误数最多偏少（不会偏多）。
+ */
+const SKILL_CALL_MAP_MAX = 20_000;
+
 
 /** 把字节数格式化成 MB 文案，只用于诊断信息。 */
 function formatMB(bytes) {
@@ -235,6 +245,33 @@ function emptyToolRecord() {
 	return { calls: 0, results: 0, errors: 0, seenCallIds: new Set(), firstUsedMs: null, lastUsedMs: null };
 }
 
+/** §6.4 技能维度的调用账目：`skill` 工具每调一次，参数里就写着一个技能名。 */
+function emptySkillRecord() {
+	return { calls: 0, errors: 0, seenResultIds: new Set(), firstUsedMs: null, lastUsedMs: null };
+}
+
+/**
+ * 从 `skill` 工具的调用参数里取技能名。
+ * 参数是**字符串化的 JSON**（`{"name":"grill"}`），解不出来就不是一次可归属的调用：
+ * 这类情况必须单独计数（`skillCallsUnparsed`）而不是静默丢弃，否则界面上会表现为
+ * 「skill 有 N 次调用、但按技能的表是空的」这种自相矛盾的读数。
+ * @param {unknown} rawArguments
+ * @returns {string|null}
+ */
+function skillNameOf(rawArguments) {
+	if (typeof rawArguments !== "string") return null;
+	let parsed;
+	try {
+		parsed = JSON.parse(rawArguments);
+	} catch {
+		return null;
+	}
+	const name = parsed?.name;
+	if (typeof name !== "string") return null;
+	const trimmed = name.trim();
+	return trimmed === "" ? null : trimmed;
+}
+
 /**
  * 按前缀归属把工具名分类到 MCP 服务器。与 mcp-registry.js 的 toolInventory 同一判定：
  * `mcp__<server>__<tool>`；服务器名自身可能含下划线，取**最长**匹配的归属，匹配到多个
@@ -295,6 +332,13 @@ export async function scanSessionLedger({ days, mcpServerNames, schemas, disable
 	// 桶只存「窗口内的相对天序号」（0 = 最早一天，windowDays-1 = 今天），
 	// 由界面负责渲染；返回绝对日期反而让前端多一次时区换算的机会出错。
 	const dayBuckets = new Array(windowDays).fill(0);
+	// §6.4 技能维度：`skill` 工具是宿主里唯一「参数里带名字」的内置工具，所以同一个 callId
+	// 既属于工具 `skill`，也属于某个具体技能。两本账各记各的，互不覆盖——工具表看「skill 被
+	// 调了 59 次」，技能表看「grill 12 次、剩下 20 个一次没有」，两者回答的是不同的问题。
+	const skillUsage = new Map(); // skillName -> record
+	const skillCallOwner = new Map(); // callId -> skillName（只为把错误算到技能头上）
+	let totalSkillCalls = 0;
+	let skillCallsUnparsed = 0;
 	// §6.1 真实下发税的按天采样。`dayTaxKeys` 每个日桶只存**当天最后一次**请求的指纹（数字与
 	// 短串，不持有工具数组引用 —— 365 个日桶各留一份 234 项清单会常驻几十 MB，宿主主进程里不
 	// 可接受）；`wireTaxByKey` 存每个不同清单的税，只在指纹首次出现时算一次，上限 WIRE_TAX_MAX_KEYS
@@ -416,10 +460,42 @@ export async function scanSessionLedger({ days, mcpServerNames, schemas, disable
 							if (record.firstUsedMs === null || time < record.firstUsedMs) record.firstUsedMs = time;
 							if (record.lastUsedMs === null || time > record.lastUsedMs) record.lastUsedMs = time;
 						}
+						// §6.4 同一件事的技能版本：`skill` 的参数里带着技能名，按名字再记一笔。
+						// 解不出名字的调用单独计数，界面据此说明「有一部分调用无法归属」，
+						// 而不是让技能表的合计悄悄小于工具表里的 skill 调用数。
+						if (name === SKILL_TOOL_NAME) {
+							const skillName = skillNameOf(event.data?.arguments);
+							if (skillName === null) {
+								skillCallsUnparsed += 1;
+							} else {
+								let skillRecord = skillUsage.get(skillName);
+								if (!skillRecord) {
+									skillRecord = emptySkillRecord();
+									skillUsage.set(skillName, skillRecord);
+								}
+								skillRecord.calls += 1;
+								totalSkillCalls += 1;
+								if (callId && skillCallOwner.size < SKILL_CALL_MAP_MAX) skillCallOwner.set(callId, skillName);
+								if (time !== null) {
+									if (skillRecord.firstUsedMs === null || time < skillRecord.firstUsedMs) skillRecord.firstUsedMs = time;
+									if (skillRecord.lastUsedMs === null || time > skillRecord.lastUsedMs) skillRecord.lastUsedMs = time;
+								}
+							}
+						}
 					} else if (event.type === "tool/result") {
 						const message = event.data?.message;
 						const callId = typeof message?.toolCallId === "string" ? message.toolCallId : null;
 						if (!callId) continue;
+						// §6.4 技能错误先归账：结果事件只带 callId，工具那本账要靠遍历
+						// usage 反查，技能这本账直接查映射，成本更低且不受「调用在窗口外」影响。
+						const skillOwner = skillCallOwner.get(callId);
+						if (skillOwner !== undefined) {
+							const skillRecord = skillUsage.get(skillOwner);
+							if (skillRecord && !skillRecord.seenResultIds.has(callId)) {
+								skillRecord.seenResultIds.add(callId);
+								if (message.isError === true) skillRecord.errors += 1;
+							}
+						}
 						// 与 call 配对：同一 callId 的后续 result（重试/续写）不再重复计。
 						let owner = null;
 						for (const record of usage.values()) {
@@ -604,6 +680,23 @@ export async function scanSessionLedger({ days, mcpServerNames, schemas, disable
 		// 没有真实下发记录时为 null —— 界面必须把「不知道」和「差 0」分开呈现。
 		wireTaxDivergenceTokens: wireTaxLatest === null ? null : taxTotalTokens - wireTaxLatest.tokens,
 		tools,
+		// §6.4 技能维度账目。工具表回答「skill 这个工具被调了几次」，这里回答「哪些技能真的
+		// 被用过、各用了几次」——两者的合计**不要求相等**：参数解不出名字的调用单独进
+		// skillCallsUnparsed，让差异自己显形，而不是被悄悄吞掉。
+		// 排序与工具表同口径：调用多的在前，同调用数按名字排，保证两次扫描的先后一致。
+		skills: [...skillUsage]
+			.map(([name, record]) => ({
+				name,
+				calls: record.calls,
+				errors: record.errors,
+				errorRate: record.calls > 0 ? record.errors / record.calls : 0,
+				firstUsedMs: record.firstUsedMs,
+				lastUsedMs: record.lastUsedMs,
+			}))
+			.sort((a, b) => (b.calls - a.calls) || String(a.name).localeCompare(String(b.name))),
+		skillCalls: totalSkillCalls,
+		skillCallsUnparsed,
+		skillCount: skillUsage.size,
 	};
 }
 

package/lib/typert.js

@@ -33,7 +33,6 @@ const mv = (method, params, resultSym) => ({
 const nameParam = { name: 'name', wire: 'name', source: 'json', codec: codec('String', $name) }
 const specParam = { name: 'spec', wire: 'spec', source: 'json', codec: codec('Spec', $any) }
 const payloadParam = { name: 'payload', wire: 'payload', source: 'json', codec: codec('ImportPayload', $any) }
-const builtinInstallParam = { name: 'payload', wire: 'payload', source: 'json', codec: codec('BuiltinInstallPayload', $any) }
 
 export const TYPERT = {
   package: 'dsh-armory',
@@ -46,8 +45,6 @@ export const TYPERT = {
     mv('disable', [nameParam], 'NoteResult'),
     mv('reconnect', [nameParam], 'NoteResult'),
     mv('tools', [payloadParam], 'ToolsResult'),
-    mv('builtins', [], 'BuiltinCatalogResult'),
-    mv('installBuiltins', [builtinInstallParam], 'BuiltinInstallResult'),
     mv('add', [specParam], 'NoteResult'),
     mv('update', [specParam], 'NoteResult'),
     mv('removeServer', [nameParam], 'NoteResult'),
@@ -63,7 +60,6 @@ export const TYPERT = {
     mv('updateWorkspaceServer', [payloadParam], 'NoteResult'),
     mv('removeWorkspaceServer', [payloadParam], 'NoteResult'),
     mv('setWorkspaceExclude', [payloadParam], 'NoteResult'),
-    mv('installWorkspaceBuiltins', [builtinInstallParam], 'BuiltinInstallResult'),
     mv('previewWorkspaceImport', [payloadParam], 'ImportPreview'),
     mv('importWorkspaceJson', [payloadParam], 'ImportResult'),
     mv('revealWorkspaceServer', [payloadParam], 'RevealResult'),
@@ -92,11 +88,13 @@ export const TYPERT = {
     // lib/tool-ledger.js 校验，与 wb* 系列同一宽容度。
     mv('toolTailor', [payloadParam], 'TailorReport'),
     // WorkBuddy 市场直连（连接器 MCP + SkillHub 技能）。payload 全部 $any：数据形状由
-    // lib/wb-market.js 校验，契约层与 builtins/importJson 同一宽容度。
+    // lib/wb-market.js 校验，契约层与 importJson 同一宽容度。
     mv('wbConnectorCatalog', [], 'WbCatalogResult'),
     // 顶栏「市场」chip 常驻计数：只读磁盘缓存，零网络；无缓存返回 { total: null }。
     mv('wbConnectorCachedCount', [], 'WbCachedCountResult'),
     mv('wbConnectorPreview', [payloadParam], 'WbPreviewResult'),
+    // 市场连接器卡片头像：payload {connectorId}，出 {ok, dataUrl}。卡片进视口才调。
+    mv('wbConnectorIcon', [payloadParam], 'WbIconResult'),
     mv('wbConnectorInstall', [payloadParam], 'NoteResult'),
     mv('wbSkillCatalog', [payloadParam], 'WbSkillListResult'),
     mv('wbSkillDetail', [payloadParam], 'WbSkillDetailResult'),
@@ -106,21 +104,26 @@ export const TYPERT = {
     // T03/R4：多市场注册表（读 / 增改）。payload $any，形状由 lib/wb-registry.js 校验。
     mv('wbMarketRegistry', [], 'WbMarketRegistryResult'),
     mv('wbMarketRegistryUpsert', [payloadParam], 'WbMarketRegistryResult'),
-    // T03/R5：codebuddy 插件市场（列表 / 详情）。payload $any，形状由 lib/wb-plugin-market.js 校验。
-    mv('wbPluginCatalog', [], 'WbPluginCatalogResult'),
-    mv('wbPluginDetail', [payloadParam], 'WbPluginDetailResult'),
     // T04/R8：安装状态登记与查询（宿主侧落盘，客户端「已安装」筛选的数据源）。
     mv('wbInstallState', [], 'InstallStateResult'),
     mv('wbInstallStateRecord', [payloadParam], 'NoteResult'),
     mv('wbInstallStateForget', [payloadParam], 'NoteResult'),
-    // T05/R9：插件市场更新探测（只做条件请求，不落新包）。
-    mv('wbPluginUpdateCheck', [], 'WbUpdateHintResult'),
     // T06/Awesome：DSH 社区插件市场（awesome-dsh-plugins，数据层 lib/wb-awesome-market.js）。
     mv('wbAwesomeCatalog', [payloadParam], 'AwesomeCatalogResult'),
     mv('wbAwesomeDetail', [payloadParam], 'AwesomeDetailResult'),
     // README 预览：点击卡片按需取一次（npm registry / GitHub raw），落盘缓存 7 天。
     mv('wbAwesomeReadme', [payloadParam], 'AwesomeReadmeResult'),
     mv('wbAwesomeUpdateCheck', [], 'WbUpdateHintResult'),
+    // 社区元信息：打开详情时按需查 GitHub 仓库（维护者 / 最近提交 / issue / star），
+    // 6 小时缓存。数据层 lib/community-meta.js，payload $any（{repos, refresh}）。
+    mv('wbRepoMeta', [payloadParam], 'WbRepoMetaResult'),
+    // npm 近 30 天下载量：插件卡片底栏的「↓N」。目录里没有这个字段，只能去 npm 统计接口取，
+    // 7 天缓存 + 按可见卡片懒加载。数据层 lib/npm-downloads.js，payload $any（{packages, refresh}）。
+    mv('wbNpmDownloads', [payloadParam], 'WbNpmDownloadsResult'),
+    // 装备清单：导出本机全局配置 / 与贴入的清单做差异。payload $any，形状由
+    // lib/loadout.js 校验；只读，不安装、不写盘、不接收任何凭据。
+    mv('wbLoadoutExport', [payloadParam], 'LoadoutResult'),
+    mv('wbLoadoutDiff', [payloadParam], 'LoadoutDiffResult'),
     // WorkBuddy 专家直连（召唤预设 + 捆绑技能）。payload 全部 $any：数据形状由
     // lib/expert-market.js 校验，与 wb* 系列同一宽容度。
     mv('wbExpertCatalog', [], 'WbExpertCatalogResult'),