z-biz-tool-shared 0.1.6 → 0.1.8

package/dist/ai/index.d.ts

@@ -1,4 +1,5 @@
 export * from './AIManager.js';
 export * from './types.js';
 export * from './context.js';
+export * from './privateEndpoint.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/ai/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/ai/index.ts"],"names":[],"mappings":"AACA,cAAc,aAAa,CAAC;AAC5B,cAAc,SAAS,CAAC;AACxB,cAAc,WAAW,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/ai/index.ts"],"names":[],"mappings":"AACA,cAAc,aAAa,CAAC;AAC5B,cAAc,SAAS,CAAC;AACxB,cAAc,WAAW,CAAC;AAC1B,cAAc,mBAAmB,CAAC"}

package/dist/ai/index.js

@@ -2,4 +2,5 @@
 export * from './AIManager.js';
 export * from './types.js';
 export * from './context.js';
+export * from './privateEndpoint.js';
 //# sourceMappingURL=index.js.map

package/dist/ai/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/ai/index.ts"],"names":[],"mappings":"AAAA,YAAY;AACZ,cAAc,aAAa,CAAC;AAC5B,cAAc,SAAS,CAAC;AACxB,cAAc,WAAW,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/ai/index.ts"],"names":[],"mappings":"AAAA,YAAY;AACZ,cAAc,aAAa,CAAC;AAC5B,cAAc,SAAS,CAAC;AACxB,cAAc,WAAW,CAAC;AAC1B,cAAc,mBAAmB,CAAC"}

package/dist/ai/privateEndpoint.d.ts

@@ -0,0 +1,68 @@
+/**
+ * 「这份配置指向本机 / 局域网吗」—— 前端侧的免密钥判定。
+ *
+ * ## 为什么前端也要有这份判据
+ *
+ * 后端 cap-llm 的 `LlmConfig::needs_api_key()` 已经统一了免密钥判定：
+ * ① 选了登记「免 Key」的预设；② 地址落在本机 / 局域网。
+ * 但前端也得判同一件事 —— 否则会出现**判据分裂**：
+ * 后端放行、前端却说「还没配置 API Key」，用户点一下就被弹回设置页，
+ * 而设置页里后端根本不要求填 Key（填了也无处可用）。
+ *
+ * 分裂的两副面孔：
+ * - AI 对话框的「密钥框该藏不该藏」—— 藏错了用户找不到该填的地方；
+ * - AI 功能入口的「已配置没有」—— 判错了功能按钮直接禁用，用户无从知道原因。
+ *
+ * ## 为什么规则必须与 Rust 侧逐条对齐
+ *
+ * Rust 的 `is_private_endpoint()` 在 `z-biz-tool-capability/crates/cap-llm/src/config.rs`。
+ * 这份实现是它的**逐条镜像**，两边认同一批地址：
+ *
+ * - 回环：`localhost` / `127.0.0.0/8` / `::1` / `0.0.0.0`
+ * - 私有段：`10/8`、`172.16/12`、`192.168/16`
+ * - 本地域名：`.local`（mDNS）、`.lan`、`.internal`、`host.docker.internal`
+ *
+ * 只看 host，**不看端口**：llama.cpp 8200、Ollama 11434、LM Studio 1234、
+ * vLLM 8000，按端口列举必然过时；而 host 属于私有段的判断依据是
+ * IPv4/IPv6 保留地址（RFC 1918 / RFC 4193），不会随时间失效。
+ *
+ * ## 改这份代码之前
+ *
+ * 先确认 Rust 侧没变。判据分裂的根因永远是「两份实现漂移」，
+ * 而 Rust 侧是金标（它决定请求实际发不发鉴权头）。
+ */
+/**
+ * 从 URL 里取 host（去掉 scheme、userinfo、端口、路径）。
+ *
+ * 不引 `url` 包：这里的输入只有 baseUrl 一种，且历史配置里存在
+ * `192.168.1.2:8200/v1`（无 scheme）这种写法，严格解析器反而要额外容错。
+ * 取不到就返回空串，由调用方当作「不是私有地址」处理。
+ */
+export declare function hostOf(url: string): string;
+/**
+ * 该地址是否指向「本机 / 局域网」。
+ *
+ * 与 Rust 侧 `cap_llm::is_private_endpoint()` 逐条对齐。
+ */
+export declare function isPrivateEndpoint(url: string): boolean;
+/**
+ * 这份 AI 配置要不要 API Key。
+ *
+ * 与 Rust 侧 `LlmConfig::needs_api_key()` **判据顺序严格一致**：
+ *
+ * ① 预设登记为「免 Key」→ 免（显式声明，优先）；
+ * ② 预设登记为「要 Key」→ **要**（哪怕地址被改成本机代理，也按预设走 ——
+ *    用户显式选的厂商优先于地址猜测。这条反向约束是 Rust 侧
+ *    `private_endpoint_does_not_rescue_key_requiring_preset` 钉死的）；
+ * ③ 没匹配到预设（自定义服务）→ 看地址：私网免、公网要。
+ *
+ * 第②条最容易被写反：只判「预设说不免」而不判「预设说要」，
+ * 会让「选了 DeepSeek 但把地址指向本机代理」的场景被私网规则救掉，
+ * 于是请求发出去了、没带鉴权头、拿到 401 —— 而用户完全不知道为什么。
+ *
+ * @param presetRequiresApiKey 预设施置里的 `requires_api_key`；
+ *   传 `undefined` 表示「没匹配到预设」（自定义服务）。
+ * @param baseUrl 服务地址。
+ */
+export declare function needsApiKey(presetRequiresApiKey: boolean | undefined, baseUrl: string): boolean;
+//# sourceMappingURL=privateEndpoint.d.ts.map

package/dist/ai/privateEndpoint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"privateEndpoint.d.ts","sourceRoot":"","sources":["../../src/ai/privateEndpoint.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAEH;;;;;;GAMG;AACH,wBAAgB,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAa1C;AAoCD;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAmBtD;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,WAAW,CACzB,oBAAoB,EAAE,OAAO,GAAG,SAAS,EACzC,OAAO,EAAE,MAAM,GACd,OAAO,CAIT"}

package/dist/ai/privateEndpoint.js

@@ -0,0 +1,148 @@
+/**
+ * 「这份配置指向本机 / 局域网吗」—— 前端侧的免密钥判定。
+ *
+ * ## 为什么前端也要有这份判据
+ *
+ * 后端 cap-llm 的 `LlmConfig::needs_api_key()` 已经统一了免密钥判定：
+ * ① 选了登记「免 Key」的预设；② 地址落在本机 / 局域网。
+ * 但前端也得判同一件事 —— 否则会出现**判据分裂**：
+ * 后端放行、前端却说「还没配置 API Key」，用户点一下就被弹回设置页，
+ * 而设置页里后端根本不要求填 Key（填了也无处可用）。
+ *
+ * 分裂的两副面孔：
+ * - AI 对话框的「密钥框该藏不该藏」—— 藏错了用户找不到该填的地方；
+ * - AI 功能入口的「已配置没有」—— 判错了功能按钮直接禁用，用户无从知道原因。
+ *
+ * ## 为什么规则必须与 Rust 侧逐条对齐
+ *
+ * Rust 的 `is_private_endpoint()` 在 `z-biz-tool-capability/crates/cap-llm/src/config.rs`。
+ * 这份实现是它的**逐条镜像**，两边认同一批地址：
+ *
+ * - 回环：`localhost` / `127.0.0.0/8` / `::1` / `0.0.0.0`
+ * - 私有段：`10/8`、`172.16/12`、`192.168/16`
+ * - 本地域名：`.local`（mDNS）、`.lan`、`.internal`、`host.docker.internal`
+ *
+ * 只看 host，**不看端口**：llama.cpp 8200、Ollama 11434、LM Studio 1234、
+ * vLLM 8000，按端口列举必然过时；而 host 属于私有段的判断依据是
+ * IPv4/IPv6 保留地址（RFC 1918 / RFC 4193），不会随时间失效。
+ *
+ * ## 改这份代码之前
+ *
+ * 先确认 Rust 侧没变。判据分裂的根因永远是「两份实现漂移」，
+ * 而 Rust 侧是金标（它决定请求实际发不发鉴权头）。
+ */
+/**
+ * 从 URL 里取 host（去掉 scheme、userinfo、端口、路径）。
+ *
+ * 不引 `url` 包：这里的输入只有 baseUrl 一种，且历史配置里存在
+ * `192.168.1.2:8200/v1`（无 scheme）这种写法，严格解析器反而要额外容错。
+ * 取不到就返回空串，由调用方当作「不是私有地址」处理。
+ */
+export function hostOf(url) {
+    const rest = url.includes('://') ? url.slice(url.indexOf('://') + 3) : url;
+    const hostPort = rest.split('/')[0] ?? '';
+    // userinfo@host
+    const afterUser = hostPort.includes('@')
+        ? hostPort.slice(hostPort.lastIndexOf('@') + 1)
+        : hostPort;
+    // IPv6 字面量 [::1]:8200
+    if (afterUser.startsWith('[')) {
+        const end = afterUser.indexOf(']');
+        return end === -1 ? afterUser : afterUser.slice(0, end + 1);
+    }
+    return afterUser.split(':')[0] ?? '';
+}
+/** IPv4 是否落在回环 / 私有段 / link-local / 未指定地址里。 */
+function isPrivateV4(host) {
+    const parts = host.split('.');
+    if (parts.length !== 4)
+        return false;
+    const nums = parts.map((p) => {
+        // 只接受纯数字段 —— "1e2" 这类不是合法 IPv4 写法
+        if (!/^\d{1,3}$/.test(p))
+            return -1;
+        const n = Number(p);
+        return n >= 0 && n <= 255 ? n : -1;
+    });
+    if (nums.some((n) => n < 0))
+        return false;
+    const [a, b] = nums;
+    if (a === 127)
+        return true; // 127.0.0.0/8 回环
+    if (a === 10)
+        return true; // 10.0.0.0/8
+    if (a === 172 && b >= 16 && b <= 31)
+        return true; // 172.16.0.0/12
+    if (a === 192 && b === 168)
+        return true; // 192.168.0.0/16
+    if (a === 169 && b === 254)
+        return true; // 169.254.0.0/16 link-local
+    if (a === 0)
+        return true; // 0.0.0.0 未指定
+    return false;
+}
+/** IPv6 是否是回环或唯一本地地址（fc00::/7）。 */
+function isPrivateV6(host) {
+    const inner = host.replace(/^\[|\]$/g, '');
+    if (!inner.includes(':'))
+        return false;
+    const lower = inner.toLowerCase();
+    if (lower === '::1' || lower === '::')
+        return true;
+    // fc00::/7 —— 唯一本地地址（ULA）。段首的高两位判据：fc/fd 开头。
+    const head = lower.split(':')[0] ?? '';
+    if (!/^[0-9a-f]{1,4}$/.test(head))
+        return false;
+    const n = parseInt(head, 16);
+    return (n & 0xfe00) === 0xfc00;
+}
+/**
+ * 该地址是否指向「本机 / 局域网」。
+ *
+ * 与 Rust 侧 `cap_llm::is_private_endpoint()` 逐条对齐。
+ */
+export function isPrivateEndpoint(url) {
+    const host = hostOf(url);
+    if (!host)
+        return false;
+    const h = host.replace(/^\[|\]$/g, '').toLowerCase();
+    // 名称类：mDNS / 局域网后缀 / 容器回流名。这些后缀不可能属于公网服务，
+    // 但它们解析不成 IP，必须显式列出，否则 `.local` 的 mini 会被当成公网。
+    if (h === 'localhost' ||
+        h === 'host.docker.internal' ||
+        h.endsWith('.local') ||
+        h.endsWith('.lan') ||
+        h.endsWith('.internal')) {
+        return true;
+    }
+    if (h.includes(':'))
+        return isPrivateV6(host);
+    return isPrivateV4(h);
+}
+/**
+ * 这份 AI 配置要不要 API Key。
+ *
+ * 与 Rust 侧 `LlmConfig::needs_api_key()` **判据顺序严格一致**：
+ *
+ * ① 预设登记为「免 Key」→ 免（显式声明，优先）；
+ * ② 预设登记为「要 Key」→ **要**（哪怕地址被改成本机代理，也按预设走 ——
+ *    用户显式选的厂商优先于地址猜测。这条反向约束是 Rust 侧
+ *    `private_endpoint_does_not_rescue_key_requiring_preset` 钉死的）；
+ * ③ 没匹配到预设（自定义服务）→ 看地址：私网免、公网要。
+ *
+ * 第②条最容易被写反：只判「预设说不免」而不判「预设说要」，
+ * 会让「选了 DeepSeek 但把地址指向本机代理」的场景被私网规则救掉，
+ * 于是请求发出去了、没带鉴权头、拿到 401 —— 而用户完全不知道为什么。
+ *
+ * @param presetRequiresApiKey 预设施置里的 `requires_api_key`；
+ *   传 `undefined` 表示「没匹配到预设」（自定义服务）。
+ * @param baseUrl 服务地址。
+ */
+export function needsApiKey(presetRequiresApiKey, baseUrl) {
+    if (presetRequiresApiKey === false)
+        return false;
+    if (presetRequiresApiKey === true)
+        return true;
+    return !isPrivateEndpoint(baseUrl);
+}
+//# sourceMappingURL=privateEndpoint.js.map

package/dist/ai/privateEndpoint.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"privateEndpoint.js","sourceRoot":"","sources":["../../src/ai/privateEndpoint.ts"],"names":[],"mappings":"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"}

package/dist/types/index.d.ts

@@ -1,2 +1,3 @@
 export * from './product.js';
+export * from './productManifest.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AACA,cAAc,WAAW,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AACA,cAAc,WAAW,CAAC;AAC1B,cAAc,mBAAmB,CAAC"}

package/dist/types/index.js

@@ -1,3 +1,4 @@
 // 家族级类型定义。
 export * from './product.js';
+export * from './productManifest.js';
 //# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,WAAW;AACX,cAAc,WAAW,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,WAAW;AACX,cAAc,WAAW,CAAC;AAC1B,cAAc,mBAAmB,CAAC"}

package/dist/types/product.d.ts

@@ -27,7 +27,7 @@ import type { DeepLinkResult } from "../protocol/deeplink.js";
  * 与 bundle id / 数据目录命名保持一致（`z-biz-tool-db` → `db`），
  * 减少用户与开发者的心智负担。
  */
-export type ProductId = "aigen" | "box" | "cpu" | "db" | "file" | "kb" | "math" | "mind" | "music" | "note" | "pet" | "sys" | "terminal" | "worker";
+export type ProductId = "aigen" | "box" | "cpu" | "db" | "file" | "history" | "kb" | "math" | "mind" | "music" | "note" | "pet" | "remote" | "sys" | "terminal" | "worker";
 /** 全部产品 id 的运行时列表。 */
 export declare const PRODUCT_IDS: readonly ProductId[];
 /** 判断一个字符串是不是合法的产品 id。 */

package/dist/types/product.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"product.d.ts","sourceRoot":"","sources":["../../src/types/product.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAM3D;;;;;GAKG;AACH,MAAM,MAAM,SAAS,GACjB,OAAO,GACP,KAAK,GACL,KAAK,GACL,IAAI,GACJ,MAAM,GACN,IAAI,GACJ,MAAM,GACN,MAAM,GACN,OAAO,GACP,MAAM,GACN,KAAK,GACL,KAAK,GACL,UAAU,GACV,QAAQ,CAAC;AAEb,sBAAsB;AACtB,eAAO,MAAM,WAAW,EAAE,SAAS,SAAS,EAelC,CAAC;AAEX,0BAA0B;AAC1B,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,SAAS,CAE7D;AAMD;;;;;;GAMG;AACH,MAAM,WAAW,WAAW;IAC1B,aAAa;IACb,EAAE,EAAE,SAAS,CAAC;IACd,iBAAiB;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,oBAAoB;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB;;;;;OAKG;IACH,eAAe,EAAE,OAAO,CAAC;IACzB,mCAAmC;IACnC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IAC3B,6BAA6B;IAC7B,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC9B;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,OAAO,GAAG,cAAc,CAAC,WAAW,CAAC,CA4B9E;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;CACxD;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,SAAS,WAAW,EAAE,GAC5B,eAAe,CAajB;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,eAAe,GACxB,WAAW,EAAE,CAOf;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,eAAe,EACzB,MAAM,EAAE,MAAM,GACb,WAAW,EAAE,CAEf"}
+{"version":3,"file":"product.d.ts","sourceRoot":"","sources":["../../src/types/product.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAM3D;;;;;GAKG;AACH,MAAM,MAAM,SAAS,GACjB,OAAO,GACP,KAAK,GACL,KAAK,GACL,IAAI,GACJ,MAAM,GACN,SAAS,GACT,IAAI,GACJ,MAAM,GACN,MAAM,GACN,OAAO,GACP,MAAM,GACN,KAAK,GACL,QAAQ,GACR,KAAK,GACL,UAAU,GACV,QAAQ,CAAC;AAEb,sBAAsB;AACtB,eAAO,MAAM,WAAW,EAAE,SAAS,SAAS,EAiBlC,CAAC;AAEX,0BAA0B;AAC1B,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,SAAS,CAE7D;AAMD;;;;;;GAMG;AACH,MAAM,WAAW,WAAW;IAC1B,aAAa;IACb,EAAE,EAAE,SAAS,CAAC;IACd,iBAAiB;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,oBAAoB;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB;;;;;OAKG;IACH,eAAe,EAAE,OAAO,CAAC;IACzB,mCAAmC;IACnC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IAC3B,6BAA6B;IAC7B,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC9B;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,OAAO,GAAG,cAAc,CAAC,WAAW,CAAC,CA4B9E;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;CACxD;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,SAAS,WAAW,EAAE,GAC5B,eAAe,CAajB;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,eAAe,GACxB,WAAW,EAAE,CAOf;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,eAAe,EACzB,MAAM,EAAE,MAAM,GACb,WAAW,EAAE,CAEf"}

package/dist/types/product.js

@@ -27,12 +27,14 @@ export const PRODUCT_IDS = [
     "cpu",
     "db",
     "file",
+    "history",
     "kb",
     "math",
     "mind",
     "music",
     "note",
     "pet",
+    "remote",
     "sys",
     "terminal",
     "worker",

package/dist/types/product.js.map

@@ -1 +1 @@
-{"version":3,"file":"product.js","sourceRoot":"","sources":["../../src/types/product.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"product.js","sourceRoot":"","sources":["../../src/types/product.ts"],"names":[],"mappings":"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"}

package/dist/types/productManifest.d.ts

@@ -0,0 +1,91 @@
+/**
+ * 产品自报文件的**读取与汇总** —— 「每条记录都有主人」的机器那一半。
+ *
+ * ## 为什么需要这一层
+ *
+ * `product.ts` 提供类型与校验，但真值分散在 16 个仓各自的 `product.json` 里。
+ * 谁来读、读完怎么对账，是这一层的事：
+ *
+ * - **读取**：把一个仓根目录下的 `product.json` 读成 `ProductMeta`，
+ *   并在读的时候就地校验（不合规的仓不该等到汇总时才被发现）。
+ * - **汇总**：把 N 份自报汇成一份 registry，重复 id 直接炸。
+ * - **对账**：把「自报的真值」与「协议层认识的产品集合」对齐 ——
+ *   少一个仓自报、或某个仓声明了协议层不存在的 id，都属于**家族契约破损**，
+ *   必须在 CI 里红，不能等用户在 box 面板上看到一张打不开的卡片才发现。
+ *
+ * ## 为什么不内置真值
+ *
+ * 见 `product.ts` 顶部：本模块只做**机制**，一条真值都不带。
+ * 谁的产品叫什么、支持什么动作，只有那个仓知道。
+ */
+import { isProductId, type ProductId, type ProductMeta, type ProductRegistry } from "./product.js";
+import type { DeepLinkResult } from "../protocol/deeplink.js";
+/**
+ * 自报文件在仓根的**相对路径**。
+ *
+ * 固定在仓根而不是 `src/` 里：这份文件是「这个仓向家族报什么」，
+ * 属于仓级契约，不是前端代码的一部分 —— 放在 `src/` 下会被
+ * 「前端源码」的构建/打包规则误伤。
+ */
+export declare const PRODUCT_MANIFEST_PATH = "product.json";
+/**
+ * 自报文件的磁盘形状（camelCase，与 `ProductMeta` 的 JSON 序列化一致）。
+ *
+ * 与 `ProductMeta` 分开声明，是因为磁盘上的字段是**外部输入**：
+ * 多一个字段少一个字段都可能是别人的笔误，解析时要能指名报错，
+ * 而不是被 TS 的类型断言悄悄放过。
+ */
+export interface ProductManifestFile {
+    readonly id: string;
+    readonly displayName: string;
+    readonly description: string;
+    readonly acceptsDeepLink: boolean;
+    readonly actions: readonly string[];
+    readonly keywords?: readonly string[];
+}
+/**
+ * 解析一个自报文件的内容。
+ *
+ * 与 `validateProductMeta` 的区别：这里管**磁盘形状**（字段在不在、类型对不对），
+ * 那里管**语义自洽**（id 合不合法、声明了动作却说自己不接深链这种矛盾）。
+ * 两层都要过。
+ */
+export declare function parseProductManifest(raw: unknown): DeepLinkResult<ProductMeta>;
+/**
+ * 把若干份自报汇总成 registry。
+ *
+ * 重复 id 直接抛错 —— 两个仓声明同一个产品 id 意味着有人改了协议没同步，
+ * 这在协议层必须炸出来，不能静默取最后一份。
+ */
+export declare function buildRegistryFromManifests(manifests: readonly ProductManifestFile[]): ProductRegistry;
+/**
+ * 对账结果。
+ *
+ * `missing` = 协议层认识、但没人生存自报的产品（**没人认领**）。
+ * `unknown` = 自报了自己、但协议层不认这个 id（**协议没同步**）。
+ */
+export interface ManifestReconciliation {
+    readonly ok: boolean;
+    /** 协议层认识但无人自报的产品 id */
+    readonly missing: readonly ProductId[];
+    /** 自报了但协议层不认识的 id */
+    readonly unknown: readonly string[];
+    /** 重复声明的 id */
+    readonly duplicated: readonly string[];
+}
+/**
+ * 把「自报的真值」与「协议层认识的产品集合」对账。
+ *
+ * 两种破损都要报出来：
+ * - **无人认领**（missing）：协议层说这个产品存在，但没有任何仓声明它 ——
+ *   要么那个仓忘了加 `product.json`，要么它已经下线了。
+ * - **协议没同步**（unknown）：某个仓声明了协议层不存在的 id ——
+ *   多半是加了新产品但忘了同步 `cap-hub` / `shared` 的产品集合。
+ *
+ * @param declared 自报的产品 id 集合
+ * @param known 协议层认识的产品 id 集合
+ */
+export declare function reconcileManifests(declared: readonly string[], known: readonly string[]): ManifestReconciliation;
+/** 便捷判断：id 是否是协议层认识的产品 id（供各仓自检用）。 */
+export { isProductId };
+//# sourceMappingURL=productManifest.d.ts.map

package/dist/types/productManifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"productManifest.d.ts","sourceRoot":"","sources":["../../src/types/productManifest.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EAEL,WAAW,EAEX,KAAK,SAAS,EACd,KAAK,WAAW,EAChB,KAAK,eAAe,EACrB,MAAM,WAAW,CAAC;AAInB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAE3D;;;;;;GAMG;AACH,eAAO,MAAM,qBAAqB,iBAAiB,CAAC;AAEpD;;;;;;GAMG;AACH,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAC;IAClC,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACvC;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAClC,GAAG,EAAE,OAAO,GACX,cAAc,CAAC,WAAW,CAAC,CA4B7B;AAED;;;;;GAKG;AACH,wBAAgB,0BAA0B,CACxC,SAAS,EAAE,SAAS,mBAAmB,EAAE,GACxC,eAAe,CAUjB;AAED;;;;;GAKG;AACH,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,EAAE,EAAE,OAAO,CAAC;IACrB,uBAAuB;IACvB,QAAQ,CAAC,OAAO,EAAE,SAAS,SAAS,EAAE,CAAC;IACvC,qBAAqB;IACrB,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,eAAe;IACf,QAAQ,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;CACxC;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,SAAS,MAAM,EAAE,EAC3B,KAAK,EAAE,SAAS,MAAM,EAAE,GACvB,sBAAsB,CAkBxB;AAED,sCAAsC;AACtC,OAAO,EAAE,WAAW,EAAE,CAAC"}

package/dist/types/productManifest.js

@@ -0,0 +1,116 @@
+/**
+ * 产品自报文件的**读取与汇总** —— 「每条记录都有主人」的机器那一半。
+ *
+ * ## 为什么需要这一层
+ *
+ * `product.ts` 提供类型与校验，但真值分散在 16 个仓各自的 `product.json` 里。
+ * 谁来读、读完怎么对账，是这一层的事：
+ *
+ * - **读取**：把一个仓根目录下的 `product.json` 读成 `ProductMeta`，
+ *   并在读的时候就地校验（不合规的仓不该等到汇总时才被发现）。
+ * - **汇总**：把 N 份自报汇成一份 registry，重复 id 直接炸。
+ * - **对账**：把「自报的真值」与「协议层认识的产品集合」对齐 ——
+ *   少一个仓自报、或某个仓声明了协议层不存在的 id，都属于**家族契约破损**，
+ *   必须在 CI 里红，不能等用户在 box 面板上看到一张打不开的卡片才发现。
+ *
+ * ## 为什么不内置真值
+ *
+ * 见 `product.ts` 顶部：本模块只做**机制**，一条真值都不带。
+ * 谁的产品叫什么、支持什么动作，只有那个仓知道。
+ */
+import { buildProductRegistry, isProductId, validateProductMeta, } from "./product.js";
+/**
+ * 自报文件在仓根的**相对路径**。
+ *
+ * 固定在仓根而不是 `src/` 里：这份文件是「这个仓向家族报什么」，
+ * 属于仓级契约，不是前端代码的一部分 —— 放在 `src/` 下会被
+ * 「前端源码」的构建/打包规则误伤。
+ */
+export const PRODUCT_MANIFEST_PATH = "product.json";
+/**
+ * 解析一个自报文件的内容。
+ *
+ * 与 `validateProductMeta` 的区别：这里管**磁盘形状**（字段在不在、类型对不对），
+ * 那里管**语义自洽**（id 合不合法、声明了动作却说自己不接深链这种矛盾）。
+ * 两层都要过。
+ */
+export function parseProductManifest(raw) {
+    if (typeof raw !== "object" || raw === null || Array.isArray(raw)) {
+        return { ok: false, reason: "产品自报文件不是对象" };
+    }
+    const m = raw;
+    const missing = (field) => ({
+        ok: false,
+        reason: `产品自报文件缺少字段 ${field}`,
+    });
+    if (typeof m.id !== "string" || m.id.length === 0)
+        return missing("id");
+    if (typeof m.displayName !== "string")
+        return missing("displayName");
+    if (typeof m.description !== "string")
+        return missing("description");
+    if (typeof m.acceptsDeepLink !== "boolean")
+        return missing("acceptsDeepLink");
+    if (!Array.isArray(m.actions))
+        return missing("actions");
+    if (m.actions.some((a) => typeof a !== "string")) {
+        return { ok: false, reason: "产品自报文件的 actions 里有非字符串" };
+    }
+    if (m.keywords !== undefined) {
+        if (!Array.isArray(m.keywords))
+            return missing("keywords");
+        if (m.keywords.some((k) => typeof k !== "string")) {
+            return { ok: false, reason: "产品自报文件的 keywords 里有非字符串" };
+        }
+    }
+    // 交给语义层校验（id 合法性、动作与 acceptsDeepLink 的自洽性）
+    return validateProductMeta(m);
+}
+/**
+ * 把若干份自报汇总成 registry。
+ *
+ * 重复 id 直接抛错 —— 两个仓声明同一个产品 id 意味着有人改了协议没同步，
+ * 这在协议层必须炸出来，不能静默取最后一份。
+ */
+export function buildRegistryFromManifests(manifests) {
+    return buildProductRegistry(manifests.map((m) => {
+        const v = parseProductManifest(m);
+        if (!v.ok) {
+            throw new Error(`产品自报校验失败：${v.reason}`);
+        }
+        return v.value;
+    }));
+}
+/**
+ * 把「自报的真值」与「协议层认识的产品集合」对账。
+ *
+ * 两种破损都要报出来：
+ * - **无人认领**（missing）：协议层说这个产品存在，但没有任何仓声明它 ——
+ *   要么那个仓忘了加 `product.json`，要么它已经下线了。
+ * - **协议没同步**（unknown）：某个仓声明了协议层不存在的 id ——
+ *   多半是加了新产品但忘了同步 `cap-hub` / `shared` 的产品集合。
+ *
+ * @param declared 自报的产品 id 集合
+ * @param known 协议层认识的产品 id 集合
+ */
+export function reconcileManifests(declared, known) {
+    const seen = new Set();
+    const duplicated = [];
+    for (const id of declared) {
+        if (seen.has(id))
+            duplicated.push(id);
+        seen.add(id);
+    }
+    const knownSet = new Set(known);
+    const missing = known.filter((id) => !seen.has(id));
+    const unknown = [...seen].filter((id) => !knownSet.has(id));
+    return {
+        ok: missing.length === 0 && unknown.length === 0 && duplicated.length === 0,
+        missing: missing,
+        unknown,
+        duplicated,
+    };
+}
+/** 便捷判断：id 是否是协议层认识的产品 id（供各仓自检用）。 */
+export { isProductId };
+//# sourceMappingURL=productManifest.js.map

package/dist/types/productManifest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"productManifest.js","sourceRoot":"","sources":["../../src/types/productManifest.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EACL,oBAAoB,EACpB,WAAW,EACX,mBAAmB,GAIpB,MAAM,WAAW,CAAC;AAMnB;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,cAAc,CAAC;AAkBpD;;;;;;GAMG;AACH,MAAM,UAAU,oBAAoB,CAClC,GAAY;IAEZ,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QAClE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,CAAC;IAC7C,CAAC;IACD,MAAM,CAAC,GAAG,GAAmC,CAAC;IAE9C,MAAM,OAAO,GAAG,CAAC,KAAa,EAA+B,EAAE,CAAC,CAAC;QAC/D,EAAE,EAAE,KAAK;QACT,MAAM,EAAE,cAAc,KAAK,EAAE;KAC9B,CAAC,CAAC;IAEH,IAAI,OAAO,CAAC,CAAC,EAAE,KAAK,QAAQ,IAAI,CAAC,CAAC,EAAE,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC;IACxE,IAAI,OAAO,CAAC,CAAC,WAAW,KAAK,QAAQ;QAAE,OAAO,OAAO,CAAC,aAAa,CAAC,CAAC;IACrE,IAAI,OAAO,CAAC,CAAC,WAAW,KAAK,QAAQ;QAAE,OAAO,OAAO,CAAC,aAAa,CAAC,CAAC;IACrE,IAAI,OAAO,CAAC,CAAC,eAAe,KAAK,SAAS;QAAE,OAAO,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAC9E,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC;QAAE,OAAO,OAAO,CAAC,SAAS,CAAC,CAAC;IACzD,IAAI,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC,EAAE,CAAC;QACjD,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,wBAAwB,EAAE,CAAC;IACzD,CAAC;IACD,IAAI,CAAC,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;QAC7B,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC;YAAE,OAAO,OAAO,CAAC,UAAU,CAAC,CAAC;QAC3D,IAAI,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC,EAAE,CAAC;YAClD,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,yBAAyB,EAAE,CAAC;QAC1D,CAAC;IACH,CAAC;IAED,2CAA2C;IAC3C,OAAO,mBAAmB,CAAC,CAAC,CAAC,CAAC;AAChC,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,0BAA0B,CACxC,SAAyC;IAEzC,OAAO,oBAAoB,CACzB,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;QAClB,MAAM,CAAC,GAAG,oBAAoB,CAAC,CAAC,CAAC,CAAC;QAClC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;YACV,MAAM,IAAI,KAAK,CAAC,YAAY,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;QAC1C,CAAC;QACD,OAAO,CAAC,CAAC,KAAK,CAAC;IACjB,CAAC,CAAC,CACH,CAAC;AACJ,CAAC;AAkBD;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,kBAAkB,CAChC,QAA2B,EAC3B,KAAwB;IAExB,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,MAAM,UAAU,GAAa,EAAE,CAAC;IAChC,KAAK,MAAM,EAAE,IAAI,QAAQ,EAAE,CAAC;QAC1B,IAAI,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;YAAE,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACtC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IACf,CAAC;IAED,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC;IAChC,MAAM,OAAO,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;IACpD,MAAM,OAAO,GAAG,CAAC,GAAG,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;IAE5D,OAAO;QACL,EAAE,EAAE,OAAO,CAAC,MAAM,KAAK,CAAC,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC;QAC3E,OAAO,EAAE,OAAsB;QAC/B,OAAO;QACP,UAAU;KACX,CAAC;AACJ,CAAC;AAED,sCAAsC;AACtC,OAAO,EAAE,WAAW,EAAE,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "z-biz-tool-shared",
-  "version": "0.1.6",
+  "version": "0.1.8",
   "license": "MIT",
   "description": "z-biz-tool 核心共享模块（AI/Agent/主题/快捷键/组件）",
   "type": "module",