@dsh-plus/llm-pi 0.2.1 → 0.2.3

package/lib/client.js

@@ -145,7 +145,7 @@ window.__ModuleLoader__.load({
 		const DSH_PLUS_BUNDLE = "@dsh-plus/bundle-main";
 		/**
 		* 把一张配置卡片注册进插件页的两个配置槽位。
-		* 两个槽位都由 0.2.1-alpha.1 的插件页声明，任一缺席即报错——不做版本探测。
+		* 两个槽位都由 0.2.1-alpha.2 的插件页声明，任一缺席即报错——不做版本探测。
 		*/
 		function injectPluginConfigCard(slots, reg) {
 			const base = {
@@ -314,7 +314,7 @@ window.__ModuleLoader__.load({
 		/**
 		* 配置分节样式工厂（各插件 client 的公共收编版）。
 		*
-		* 目标宿主 dsh 0.2.1-alpha.1：插件页把配置视图放进已有页面级内边距的容器里
+		* 目标宿主 dsh 0.2.1-alpha.2：插件页把配置视图放进已有页面级内边距的容器里
 		* （`div.detailSections[data-plugin-config]` 或 `section.detailSection[data-plugin-config]`），
 		* 外层无边框——故这里输出的是**无边框分节**（小节标题 13px/600、字段 12px 0、
 		* 横向零内边距、页脚非 sticky），度量对齐官方设置页
@@ -1125,8 +1125,9 @@ ${extra}
 		*
 		* 状态行回答的是"我现在到底在跑哪一份 pi-ai"——插件按文件路径动态加载已装 dsh 树
 		* 里的套件（见 resolve-dsh.ts），manifest 上写的版本**不是**生效版本。这里显示
-		* 生效版本、安装树、目录规模与数据日期、可服务协议、compat 表来源，以及逐项降级
-		* 诊断；版本超出验证区间时给出提示（提示而非阻断）。
+		* 生效版本、安装树、目录规模与数据日期、可服务协议、compat 表来源，以及诊断
+		* （按「形态说明 / 降级诊断」分块，避免恒定事实淹没真实降级）；版本超出验证区间
+		* 时给出提示（提示而非阻断）。
 		* @module llm-pi/client/root-fields
 		*/
 		/** 时间戳 → 本地日期（秒级精度足够）。 */
@@ -1154,6 +1155,21 @@ ${extra}
 			if (copy.updatedAt === void 0) return t("officialCopyPending");
 			return `${copy.path} · ${copy.routes} ${t("officialCopyRoutes")} · ${formatTime(copy.updatedAt, t("runtimeVersionUnknown"))}`;
 		}
+		/**
+		* 诊断分块：形态说明与降级分开渲染——「官方 src 不随 npm 发布」这类恒定事实
+		* 永不会消失，混在一起会把真正的降级淹掉。空块不渲染。
+		*/
+		function DiagnosticBlock(props) {
+			const messages = props.items.filter((item) => item.level === props.level).map((m) => m.message);
+			if (messages.length === 0) return null;
+			return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(react_jsx_runtime.Fragment, { children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
+				className: "lpc-catDetailLabel",
+				children: props.label
+			}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("pre", {
+				className: "lpc-catJson",
+				children: messages.join("\n")
+			})] });
+		}
 		function RootFields(props) {
 			const { t, draft, disabled, kit, onEdit } = props;
 			return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(react_jsx_runtime.Fragment, { children: [
@@ -1205,12 +1221,14 @@ ${extra}
 						className: "lpc-invalid",
 						children: `${t("runtimeNotice")}：${kit.versionNotice}`
 					}) : null,
-					kit.diagnostics.length > 0 ? /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(react_jsx_runtime.Fragment, { children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
-						className: "lpc-catDetailLabel",
-						children: t("runtimeDiagnostics")
-					}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("pre", {
-						className: "lpc-catJson",
-						children: kit.diagnostics.join("\n")
+					kit.diagnostics.length > 0 ? /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(react_jsx_runtime.Fragment, { children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)(DiagnosticBlock, {
+						label: t("runtimeFormNotes"),
+						level: "info",
+						items: kit.diagnostics
+					}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)(DiagnosticBlock, {
+						label: t("runtimeDiagnostics"),
+						level: "degradation",
+						items: kit.diagnostics
 					})] }) : null
 				] })
 			] });
@@ -2866,7 +2884,8 @@ ${extra}
 			officialCopyPending: "尚未生成",
 			officialCopyFailed: "生成失败：",
 			officialCopyRoutes: "个 route",
-			runtimeDiagnostics: "诊断",
+			runtimeFormNotes: "形态说明",
+			runtimeDiagnostics: "降级诊断",
 			runtimeVersionUnknown: "未知",
 			runtimeCatalogUnit: "个 provider /",
 			runtimeCatalogModels: "个模型",
@@ -3000,7 +3019,8 @@ ${extra}
 			officialCopyPending: "not generated yet",
 			officialCopyFailed: "generation failed: ",
 			officialCopyRoutes: "routes",
-			runtimeDiagnostics: "Diagnostics",
+			runtimeFormNotes: "Packaging notes",
+			runtimeDiagnostics: "Degradations",
 			runtimeVersionUnknown: "unknown",
 			runtimeCatalogUnit: "providers /",
 			runtimeCatalogModels: "models",

package/lib/index.js

@@ -650,7 +650,7 @@ function fallbackProtocols() {
 	return [...FALLBACK_PROTOCOLS];
 }
 /**
-* 官方门控表不可解析时的兜底快照（0.2.1-alpha.1 现场推导值）。
+* 官方门控表不可解析时的兜底快照（0.2.1-alpha.2 现场推导值）。
 *
 * 只在官方改打包形态、`COMPAT_GATES` 解析失败时启用（此时未知键放行、只拦快照里
 * 明确 withhold 的键，见 compat.ts 的「语义分两档」）。快照过期会重新引入
@@ -1337,7 +1337,7 @@ async function discoverModels(request, deps) {
 * @module llm-pi/kit-meta
 */
 /** 本插件开发/测试覆盖过的 pi-ai 区间（semver range，仅用于状态行提示）。 */
-const VERIFIED_PI_AI_RANGE = ">=0.85.1 <0.88.0";
+const VERIFIED_PI_AI_RANGE = ">=1.0.2 <2.0.0";
 /** 读 package.json 的 version；文件不存在/非 JSON/无 version 都返回 undefined。 */
 function readPackageVersion(manifestPath) {
 	try {
@@ -1409,13 +1409,13 @@ function collectVendoredVersions() {
 }
 /** 已验证区间的解析端点（与 {@link VERIFIED_PI_AI_RANGE} 同步维护）。 */
 const VERIFIED_MIN = [
+	1,
 	0,
-	85,
-	1
+	2
 ];
 const VERIFIED_MAX_EXCLUSIVE = [
+	2,
 	0,
-	88,
 	0
 ];
 /** 解析 `x.y.z[-pre][+build]` 的数值三元组；形状不符返回 undefined。 */
@@ -2466,6 +2466,20 @@ function createOfficialCopyWriter(deps) {
 		status: () => status
 	};
 }
+//#endregion
+//#region src/auth-inline.ts
+/**
+* PiAiAdapter 认证注入的内联实现（官方 llm-pi-ai/src/auth.ts 的等价移植）。
+*
+* 官方 credentialStoreFrom/authContextFrom 仅在 @deepseek-ai/dsh-llm-pi-ai 的
+* src/auth.ts 子路径导出（包根只导出 recordKeyFor），而 npm 发布形态不携带
+* src/（lib/index.js 单 bundle）——源码布局优先经 src 子路径走官方实现
+* （见 resolve-dsh.ts 探测），本文件在其余形态（npm 布局的 dsh 树 /
+* vendored 兜底）下按官方语义逐行等价实现，并经 assertKitShape 自检兜底。
+* recordKeyFor 由调用方注入（与 PiAiAdapter 同源模块的包根导出，保证记录
+* 键格式与官方写入方一致）；记录作用域不手抄，由它现场推导（见 recordScopeOf）。
+* @module llm-pi/auth-inline
+*/
 /** 官方 jsonImage：pi-ai 凭据里显式 undefined 成员 JSON 序列化为缺省/数组 null。 */
 function jsonImage(value) {
 	if (Array.isArray(value)) return value.map((entry) => entry === void 0 ? null : jsonImage(entry));
@@ -2504,12 +2518,26 @@ function writableStore(ctx) {
 	if (credentials === void 0) throw new LlmError("llm-pi: 当前组合未挂载凭据服务（dsh-credentials-local），登录产生的凭据无处存储", "NO_CREDENTIAL_STORE");
 	return credentials;
 }
+/** 作用域推导的探针 provider id（合法记录段，故 recordKeyFor 给出完整键）。 */
+const RECORD_SCOPE_PROBE_ID = "record-scope-probe";
+/**
+* 记录作用域的现场推导（**不手抄**官方常量）：`recordKeyFor` 由与 PiAiAdapter
+* 同源的官方包根注入，其产物 `scope/id` 的 scope 段就是官方写入方使用的作用域。
+* 官方改作用域时此处自动跟随——硬编码镜像一旦落后，{@link credentialStoreFrom}
+* 的 list() 会把本插件自己的登录记录判成他人的而凭空消失，且无任何报错
+* （与 compat 门控表手抄镜像同一类故障，见 docs/repo/事故记录.md）。
+*/
+function recordScopeOf(recordKeyFor) {
+	return credentialKeyScope(recordKeyFor(RECORD_SCOPE_PROBE_ID));
+}
 /**
 * pi-ai `CredentialStore`（官方 credentialStoreFrom 等价实现）。
 * 路由键任意而记录 id 受语法约束：语法外的 id 读答"未存储"、删除无事可做、
-* modify 拒绝（写不落地不能报成功）。
+* modify 拒绝（写不落地不能报成功）。list() 的归属判定用现场推导的作用域
+* （{@link recordScopeOf}），不比对硬编码常量。
 */
 function credentialStoreFrom(ctx, recordKeyFor) {
+	const recordScope = recordScopeOf(recordKeyFor);
 	return {
 		async read(providerId) {
 			const credentials = ctx.get("credentials");
@@ -2521,7 +2549,7 @@ function credentialStoreFrom(ctx, recordKeyFor) {
 			const stored = await ctx.get("credentials")?.listRecords() ?? [];
 			const mine = [];
 			for (const entry of stored) {
-				if (credentialKeyScope(entry.key) !== "llm-pi-ai") continue;
+				if (credentialKeyScope(entry.key) !== recordScope) continue;
 				mine.push({
 					providerId: credentialKeyId(entry.key),
 					type: entry.kind === "api-key" ? "api_key" : "oauth"
@@ -2591,14 +2619,39 @@ function authContextFrom(ctx) {
 * 超出已验证区间也只是提示（kit-meta.ts），永不阻断。
 *
 * 仅 src 子路径导出、包根不导出的两块面：
-* - resolveProfiles（config.ts）：官方解析链，dev 布局树可经 src 子路径复用；
+* - resolveProfiles（config.ts）：官方解析链，源码布局可经 src 子路径复用；
 * - credentialStoreFrom/authContextFrom（auth.ts）：PiAiAdapter 必需 auth 注入。
 * npm 发布形态（lib/index.js 单 bundle + 无 src/）两者都拿不到：dsh 树优先
 * 探测 src/*（含 lib/* 候选），未命中时 resolveProfiles 走插件等价实现
-* （profiles.ts，门控表对齐官方 catalog.ts）、auth 走内联等价实现
-* （auth-inline.ts，recordKeyFor 自包根导出同源注入）——形状自检兜底。
+* （profiles.ts，语义对齐官方 config.ts:resolveProfiles）、auth 走内联等价实现
+* （auth-inline.ts，recordKeyFor 自包根导出同源注入、记录作用域由它现场推导）。
+* 这是**打包形态的恒定事实而非降级**，故按 info 档记入诊断（missingSourceNote），
+* 免得淹没同面板里真正的降级；等价实现由形状自检与单测兜底。
 * @module llm-pi/resolve-dsh
 */
+/** 生成一条降级诊断（推导失败 / 加载回退）。 */
+function degradation(message) {
+	return {
+		level: "degradation",
+		message
+	};
+}
+/**
+* 官方 `src/` 子路径未随 npm 发布携带时的**形态说明**（info 档）。
+*
+* 官方 `resolveProfiles`（src/config.ts）与认证助手（src/auth.ts）只在子路径导出、
+* 包根不导出，而发布清单只含 `lib/index.js` + `lib/types/**`——任何 npm 安装形态都
+* 拿不到，故这两块常走插件等价实现。此处逐面列出实际走等价实现的部分，并点明
+* **仍取自官方现场推导**的部分（compat 门控 / 协议 / 模型字段集），避免被读成
+* "自动跟随失败"。
+* @param surfaces 走等价实现的官方面名称（如 `profile 解析`）。
+*/
+function missingSourceNote(surfaces) {
+	return {
+		level: "info",
+		message: `官方 @deepseek-ai/dsh-llm-pi-ai 只经 src/ 子路径导出、npm 发布形态不携带 src/：${surfaces.join("、")}使用插件等价实现；compat 门控 / 协议集合 / 模型条目字段集仍取自官方安装副本现场推导`
+	};
+}
 /** kit 必备形状清单：缺失即视为上游不兼容。 */
 function assertKitShape(kit, origin) {
 	const problems = [];
@@ -2624,6 +2677,7 @@ function assertKitShape(kit, origin) {
 	if (typeof kit.resolveProfiles !== "function") problems.push("resolveProfiles 缺失");
 	if (typeof kit.resolveImageAttachmentAccess !== "function") problems.push("resolveImageAttachmentAccess 缺失");
 	if (typeof kit.auth?.credentialStoreFrom !== "function" || typeof kit.auth?.authContextFrom !== "function") problems.push("auth 助手（credentialStoreFrom/authContextFrom）缺失");
+	if (typeof kit.recordKeyFor !== "function") problems.push("recordKeyFor 缺失");
 	if (problems.length > 0) throw new Error(`llm-pi: ${origin} 来源的运行时套件形状不兼容：${problems.join("；")}`);
 }
 /** deepseek 模块形状自检；返回问题清单（空 = 可用），由调用方决定降级。 */
@@ -2728,7 +2782,7 @@ async function loadFallbackTreeFactories(root, diagnostics) {
 			if (factory !== void 0) out[api] = factory;
 		} catch {}
 	}
-	if (Object.keys(out).length < fallbackProtocols().length) diagnostics.push(`pi-ai 协议兜底三元组未能全部加载（${Object.keys(out).join("/") || "空"}）；请检查 dsh 安装树里 @earendil-works/pi-ai/dist/api 的形态`);
+	if (Object.keys(out).length < fallbackProtocols().length) diagnostics.push(degradation(`pi-ai 协议兜底三元组未能全部加载（${Object.keys(out).join("/") || "空"}）；请检查 dsh 安装树里 @earendil-works/pi-ai/dist/api 的形态`));
 	return out;
 }
 /**
@@ -2741,25 +2795,25 @@ async function loadTreeProtocols(root, derived, diagnostics) {
 	for (const api of derived) {
 		const file = join(dir, `${api}.lazy.js`);
 		if (!existsSync(file)) {
-			diagnostics.push(`pi-ai 未提供协议 "${api}" 的惰性实现（缺 ${file}）；该协议不可用，其余协议不受影响`);
+			diagnostics.push(degradation(`pi-ai 未提供协议 "${api}" 的惰性实现（缺 ${file}）；该协议不可用，其余协议不受影响`));
 			continue;
 		}
 		try {
 			const factory = protocolFactoryOf(await import(pathToFileURL(file).href));
 			if (factory === void 0) {
-				diagnostics.push(`协议 "${api}" 的实现模块未导出唯一 *Api 工厂；该协议不可用`);
+				diagnostics.push(degradation(`协议 "${api}" 的实现模块未导出唯一 *Api 工厂；该协议不可用`));
 				continue;
 			}
 			out[api] = factory;
 		} catch (error) {
-			diagnostics.push(`协议 "${api}" 的实现加载失败（${error instanceof Error ? error.message : String(error)}）；该协议不可用`);
+			diagnostics.push(degradation(`协议 "${api}" 的实现加载失败（${error instanceof Error ? error.message : String(error)}）；该协议不可用`));
 		}
 	}
 	if (Object.keys(out).length > 0) return {
 		protocols: derived.filter((api) => out[api] !== void 0),
 		protocolFactories: out
 	};
-	diagnostics.push("官方声明的协议一个都加载不到；回退内置三元组");
+	diagnostics.push(degradation("官方声明的协议一个都加载不到；回退内置三元组"));
 	const fallback = await loadFallbackTreeFactories(root, diagnostics);
 	return {
 		protocols: fallbackProtocols().filter((api) => fallback[api] !== void 0),
@@ -2805,7 +2859,7 @@ function installOfficialSurface(options) {
 	try {
 		const gates = deriveGates(readFileSync(bundlePath, "utf8"));
 		if (gates === void 0) {
-			diagnostics.push(`${compatLabel}未能从官方 bundle 解析 COMPAT_GATES（${bundlePath}）；使用内置快照（未知字段放行、withhold 仍拒绝；请检查 dsh-llm-pi-ai 打包形态）`);
+			diagnostics.push(degradation(`${compatLabel}未能从官方 bundle 解析 COMPAT_GATES（${bundlePath}）；使用内置快照（未知字段放行、withhold 仍拒绝；请检查 dsh-llm-pi-ai 打包形态）`));
 			installCompatTable(FALLBACK_TABLE);
 		} else installCompatTable({
 			gates,
@@ -2817,13 +2871,13 @@ function installOfficialSurface(options) {
 		});
 	} catch (error) {
 		const reason = error instanceof Error ? error.message : String(error);
-		diagnostics.push(`${compatLabel}推导失败（${reason}）；使用内置快照（未知字段放行）`);
+		diagnostics.push(degradation(`${compatLabel}推导失败（${reason}）；使用内置快照（未知字段放行）`));
 		installCompatTable(FALLBACK_TABLE);
 	}
 	const derivedProtocols = deriveProtocols(adapterModule);
-	if (derivedProtocols === void 0) diagnostics.push(`${origin}：官方 supportedProtocols() 不可用；协议集合回退内置三元组 ${fallbackProtocols().join("/")}`);
+	if (derivedProtocols === void 0) diagnostics.push(degradation(`${origin}：官方 supportedProtocols() 不可用；协议集合回退内置三元组 ${fallbackProtocols().join("/")}`));
 	const fields = deriveModelEntryFields(adapterModule);
-	if (fields === void 0) diagnostics.push(`${origin}：官方 Config schema 的模型条目字段集不可推导；继承字段回退已知键 ${FALLBACK_MODEL_ENTRY_FIELDS.join("/")}（官方新增字段可能不被继承）`);
+	if (fields === void 0) diagnostics.push(degradation(`${origin}：官方 Config schema 的模型条目字段集不可推导；继承字段回退已知键 ${FALLBACK_MODEL_ENTRY_FIELDS.join("/")}（官方新增字段可能不被继承）`));
 	const generatedAt = catalogGeneratedAtOf(options.catalogModule);
 	return {
 		protocols: derivedProtocols ?? fallbackProtocols(),
@@ -2865,7 +2919,8 @@ function kitFromTree(options) {
 			credentialStoreFrom: officialCredentialStoreFrom !== void 0 ? officialCredentialStoreFrom : (ctx) => credentialStoreFrom(ctx, recordKeyFor),
 			authContextFrom: officialAuthContextFrom !== void 0 ? officialAuthContextFrom : authContextFrom
 		},
-		resolveImageAttachmentAccess: mods.llm["resolveImageAttachmentAccess"]
+		resolveImageAttachmentAccess: mods.llm["resolveImageAttachmentAccess"],
+		recordKeyFor
 	};
 }
 /** vendored 兜底副本的 deepseek 模块（形状自检不过时返回 undefined）。 */
@@ -2899,7 +2954,7 @@ function vendoredProtocolFactories() {
 * npm 发布形态不携带 src/、lib 仅 index.js/invariant.js——resolveProfiles 与
 * auth 助手在此无条件走插件等价实现（内联，见文件头说明）；compat 门控表则
 * 仍从 vendored 副本的 bundle + Config schema 现场推导（与 dsh 树同一推导链）。
-* @param diagnostics 可选诊断收集器（回退原因与逐项降级说明）。
+* @param diagnostics 可选诊断收集器（回退原因、形态说明与逐项降级）。
 */
 function loadVendoredKit(diagnostics = []) {
 	const staticFactories = vendoredProtocolFactories();
@@ -2945,9 +3000,11 @@ function loadVendoredKit(diagnostics = []) {
 			authContextFrom
 		},
 		resolveImageAttachmentAccess: vendoredLlm.resolveImageAttachmentAccess,
+		recordKeyFor: vendoredPiAiAdapter.recordKeyFor,
 		...deepseek === void 0 ? {} : { deepseek }
 	};
 	assertKitShape(kit, "vendored");
+	diagnostics.push(missingSourceNote(["profile 解析", "认证助手"]));
 	return kit;
 }
 /**
@@ -2971,7 +3028,8 @@ function dshTreeAnchor(installAnchor, argvEntry = process.argv[1]) {
 /**
 * 解析运行时套件：优先 dsh 安装树（自动跟随上游），失败回退 vendored 副本；
 * 两者都过不了形状自检时抛错（调用方应记日志并放弃注册 route）。
-* 返回的 diagnostics 记录回退原因与逐项降级说明，供配置卡片与日志展示。
+* 返回的 diagnostics 记录回退原因、打包形态说明（info）与逐项降级（degradation），
+* 供配置卡片与日志分档展示。
 * @param installAnchor profile 的 dsh 安装锚点（`ctx.profileContext.installAnchor`）。
 */
 async function resolveDshKit(installAnchor) {
@@ -3001,8 +3059,10 @@ async function resolveDshKit(installAnchor) {
 				versions: collectTreeVersions(anchor)
 			});
 			assertKitShape(kit, "dsh-tree");
-			if (auth === void 0) diagnostics.push("dsh 树不含 dsh-llm-pi-ai/src（npm 发布形态）；认证助手使用插件内联等价实现");
-			if (config === void 0) diagnostics.push("dsh 树不含 dsh-llm-pi-ai/src（npm 发布形态）；profile 解析使用插件等价实现（compat 门控对齐官方 catalog.ts）");
+			const missingSeams = [];
+			if (config === void 0) missingSeams.push("profile 解析");
+			if (auth === void 0) missingSeams.push("认证助手");
+			if (missingSeams.length > 0) diagnostics.push(missingSourceNote(missingSeams));
 			const tree = await importTreeDeepseek(anchor);
 			if (tree.kit !== void 0) return {
 				kit: {
@@ -3011,17 +3071,17 @@ async function resolveDshKit(installAnchor) {
 				},
 				diagnostics
 			};
-			diagnostics.push(`dsh 安装树的 dsh-llm-deepseek 不可用（${tree.problem ?? "未知原因"}）；adapter: deepseek 的 route 不可用，pi 路由不受影响`);
+			diagnostics.push(degradation(`dsh 安装树的 dsh-llm-deepseek 不可用（${tree.problem ?? "未知原因"}）；adapter: deepseek 的 route 不可用，pi 路由不受影响`));
 			return {
 				kit,
 				diagnostics
 			};
 		} catch (error) {
-			diagnostics.push(`dsh 安装树套件不可用（${anchor}）：${error instanceof Error ? error.message : String(error)}；回退 vendored 副本`);
+			diagnostics.push(degradation(`dsh 安装树套件不可用（${anchor}）：${error instanceof Error ? error.message : String(error)}；回退 vendored 副本`));
 		}
-	} else diagnostics.push("未能从 profileContext.installAnchor / process.argv[1] 定位 dsh 安装树；回退 vendored 副本");
+	} else diagnostics.push(degradation("未能从 profileContext.installAnchor / process.argv[1] 定位 dsh 安装树；回退 vendored 副本"));
 	const kit = loadVendoredKit(diagnostics);
-	if (kit.deepseek === void 0) diagnostics.push("vendored 副本的 dsh-llm-deepseek 形状不兼容；adapter: deepseek 的 route 不可用");
+	if (kit.deepseek === void 0) diagnostics.push(degradation("vendored 副本的 dsh-llm-deepseek 形状不兼容；adapter: deepseek 的 route 不可用"));
 	return {
 		kit,
 		diagnostics
@@ -3048,10 +3108,11 @@ function makeResolveApiKey(ctx, kit) {
 		throw new kit.LlmError(`llm-pi: provider route "${provider}" 的凭据引用 ${String(ref)} 未解析到值——请经凭据服务（web Models 页）存放或导出环境变量；仅当该 provider 应使用 pi-ai 自有环境发现时才移除 apiKeyEnv`, "MISSING_CREDENTIAL");
 	};
 }
-/** 解析运行期套件并落启动日志（来源/生效版本/协议/逐项降级诊断）。 */
+/** 解析运行期套件并落启动日志（来源/生效版本/协议/形态说明与逐项降级）。 */
 async function loadRuntimeKit(ctx, logger) {
 	const { kit, diagnostics } = await resolveDshKit(ctx.get("profileContext")?.installAnchor);
-	for (const line of diagnostics) logger.warn(line);
+	for (const item of diagnostics) if (item.level === "info") logger.info(item.message);
+	else logger.warn(item.message);
 	logger.info(`运行时套件来源：${kit.source}；pi-ai ${kit.versions.piAi ?? "?"} / dsh-llm-pi-ai ${kit.versions.piAiAdapter ?? "?"}；协议 ${kit.protocols.join("/")}`);
 	const versionNotice = piAiVersionNotice(kit.versions.piAi);
 	if (versionNotice !== void 0) logger.warn(versionNotice);
@@ -3317,8 +3378,8 @@ async function startRuntime(ctx, rawConfig) {
 			officialCopy: copy,
 			diagnostics: [
 				...diagnostics,
-				...copy.warnings.map((warning) => `应急副本：${warning}`),
-				...copy.error === void 0 ? [] : [`应急副本：生成失败（${copy.error}）`]
+				...copy.warnings.map((warning) => degradation(`应急副本：${warning}`)),
+				...copy.error === void 0 ? [] : [degradation(`应急副本：生成失败（${copy.error}）`)]
 			]
 		};
 	};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dsh-plus/llm-pi",
-  "version": "0.2.1",
+  "version": "0.2.3",
   "description": "dsh-plus service+ui plugin: 基于 PiAiAdapter 的自定义 LLM 路由（全量 compat、模型继承、pi-ai 内置目录；协议/compat/字段集现场推导，自动跟随已装 dsh）",
   "type": "module",
   "main": "lib/index.js",
@@ -32,43 +32,43 @@
   },
   "dependencies": {
     "yaml": "^2.9.0",
-    "@dsh-plus/shared": "0.1.36"
+    "@dsh-plus/shared": "0.1.38"
   },
   "peerDependencies": {
     "@deepseek-ai/cordis": "^4.0.5-alpha.1",
-    "@deepseek-ai/dsh-anonymous-user-id": "^0.2.1-alpha.1",
-    "@deepseek-ai/dsh-credentials": "^0.2.1-alpha.1",
-    "@deepseek-ai/dsh-home-paths": "^0.2.1-alpha.1",
-    "@deepseek-ai/dsh-host-webserver": "^0.2.1-alpha.1",
-    "@deepseek-ai/dsh-launch-environment": "^0.2.1-alpha.1",
-    "@deepseek-ai/dsh-llm": "^0.2.1-alpha.1",
-    "@deepseek-ai/dsh-llm-deepseek": "^0.2.1-alpha.1",
-    "@deepseek-ai/dsh-llm-pi-ai": "^0.2.1-alpha.1",
-    "@deepseek-ai/dsh-settings": "^0.2.1-alpha.1",
-    "@deepseek-ai/dsh-util-values": "^0.2.1-alpha.1",
+    "@deepseek-ai/dsh-anonymous-user-id": "^0.2.1-alpha.2",
+    "@deepseek-ai/dsh-credentials": "^0.2.1-alpha.2",
+    "@deepseek-ai/dsh-home-paths": "^0.2.1-alpha.2",
+    "@deepseek-ai/dsh-host-webserver": "^0.2.1-alpha.2",
+    "@deepseek-ai/dsh-launch-environment": "^0.2.1-alpha.2",
+    "@deepseek-ai/dsh-llm": "^0.2.1-alpha.2",
+    "@deepseek-ai/dsh-llm-deepseek": "^0.2.1-alpha.2",
+    "@deepseek-ai/dsh-llm-pi-ai": "^0.2.1-alpha.2",
+    "@deepseek-ai/dsh-settings": "^0.2.1-alpha.2",
+    "@deepseek-ai/dsh-util-values": "^0.2.1-alpha.2",
     "@deepseek-ai/schemastery": "^3.18.5-alpha.1",
-    "@earendil-works/pi-ai": ">=0.85.1"
+    "@earendil-works/pi-ai": ">=1.0.2"
   },
   "devDependencies": {
     "@deepseek-ai/cordis": "4.0.5-alpha.1",
-    "@deepseek-ai/dsh-anonymous-user-id": "0.2.1-alpha.1",
-    "@deepseek-ai/dsh-app-boot": "0.2.1-alpha.1",
-    "@deepseek-ai/dsh-atomic-write": "0.2.1-alpha.1",
-    "@deepseek-ai/dsh-attachment": "0.2.1-alpha.1",
-    "@deepseek-ai/dsh-credentials": "0.2.1-alpha.1",
-    "@deepseek-ai/dsh-home-paths": "0.2.1-alpha.1",
-    "@deepseek-ai/dsh-host-webserver": "0.2.1-alpha.1",
-    "@deepseek-ai/dsh-launch-environment": "0.2.1-alpha.1",
-    "@deepseek-ai/dsh-llm": "0.2.1-alpha.1",
-    "@deepseek-ai/dsh-llm-deepseek": "0.2.1-alpha.1",
-    "@deepseek-ai/dsh-llm-pi-ai": "0.2.1-alpha.1",
-    "@deepseek-ai/dsh-settings": "0.2.1-alpha.1",
-    "@deepseek-ai/dsh-timeout": "0.2.1-alpha.1",
-    "@deepseek-ai/dsh-typert-protocol": "0.2.1-alpha.1",
-    "@deepseek-ai/dsh-util-crypto": "0.2.1-alpha.1",
-    "@deepseek-ai/dsh-util-values": "0.2.1-alpha.1",
+    "@deepseek-ai/dsh-anonymous-user-id": "0.2.1-alpha.2",
+    "@deepseek-ai/dsh-app-boot": "0.2.1-alpha.2",
+    "@deepseek-ai/dsh-atomic-write": "0.2.1-alpha.2",
+    "@deepseek-ai/dsh-attachment": "0.2.1-alpha.2",
+    "@deepseek-ai/dsh-credentials": "0.2.1-alpha.2",
+    "@deepseek-ai/dsh-home-paths": "0.2.1-alpha.2",
+    "@deepseek-ai/dsh-host-webserver": "0.2.1-alpha.2",
+    "@deepseek-ai/dsh-launch-environment": "0.2.1-alpha.2",
+    "@deepseek-ai/dsh-llm": "0.2.1-alpha.2",
+    "@deepseek-ai/dsh-llm-deepseek": "0.2.1-alpha.2",
+    "@deepseek-ai/dsh-llm-pi-ai": "0.2.1-alpha.2",
+    "@deepseek-ai/dsh-settings": "0.2.1-alpha.2",
+    "@deepseek-ai/dsh-timeout": "0.2.1-alpha.2",
+    "@deepseek-ai/dsh-typert-protocol": "0.2.1-alpha.2",
+    "@deepseek-ai/dsh-util-crypto": "0.2.1-alpha.2",
+    "@deepseek-ai/dsh-util-values": "0.2.1-alpha.2",
     "@deepseek-ai/schemastery": "3.18.5-alpha.1",
-    "@earendil-works/pi-ai": "0.87.1",
+    "@earendil-works/pi-ai": "1.1.0",
     "@types/react": "~18.3.31",
     "react": "^18.2.0"
   },

package/src/auth-inline.ts

@@ -3,11 +3,11 @@
  *
  * 官方 credentialStoreFrom/authContextFrom 仅在 @deepseek-ai/dsh-llm-pi-ai 的
  * src/auth.ts 子路径导出（包根只导出 recordKeyFor），而 npm 发布形态不携带
- * src/（lib/index.js 单 bundle）——dsh 树 dev 布局优先经 src 子路径走官方
- * 实现（见 resolve-dsh.ts 探测），本文件在其余形态（npm 布局的 dsh 树 /
+ * src/（lib/index.js 单 bundle）——源码布局优先经 src 子路径走官方实现
+ * （见 resolve-dsh.ts 探测），本文件在其余形态（npm 布局的 dsh 树 /
  * vendored 兜底）下按官方语义逐行等价实现，并经 assertKitShape 自检兜底。
  * recordKeyFor 由调用方注入（与 PiAiAdapter 同源模块的包根导出，保证记录
- * 键格式与官方写入方一致）。
+ * 键格式与官方写入方一致）；记录作用域不手抄，由它现场推导（见 recordScopeOf）。
  * @module llm-pi/auth-inline
  */
 import { access } from 'node:fs/promises'
@@ -36,9 +36,6 @@ import type {
   CredentialStore,
 } from '@earendil-works/pi-ai'
 
-/** 官方 RECORD_SCOPE 常量（llm-pi-ai/src/auth.ts）——读写作用域必须与官方一致。 */
-export const INLINE_RECORD_SCOPE = 'llm-pi-ai'
-
 /** 官方 jsonImage：pi-ai 凭据里显式 undefined 成员 JSON 序列化为缺省/数组 null。 */
 function jsonImage(value: unknown): unknown {
   if (Array.isArray(value))
@@ -94,15 +91,31 @@ function writableStore(ctx: Context): CredentialProvider {
   return credentials
 }
 
+/** 作用域推导的探针 provider id（合法记录段，故 recordKeyFor 给出完整键）。 */
+const RECORD_SCOPE_PROBE_ID = 'record-scope-probe'
+
+/**
+ * 记录作用域的现场推导（**不手抄**官方常量）：`recordKeyFor` 由与 PiAiAdapter
+ * 同源的官方包根注入，其产物 `scope/id` 的 scope 段就是官方写入方使用的作用域。
+ * 官方改作用域时此处自动跟随——硬编码镜像一旦落后，{@link credentialStoreFrom}
+ * 的 list() 会把本插件自己的登录记录判成他人的而凭空消失，且无任何报错
+ * （与 compat 门控表手抄镜像同一类故障，见 docs/repo/事故记录.md）。
+ */
+function recordScopeOf(recordKeyFor: (providerId: string) => CredentialKey): string {
+  return credentialKeyScope(recordKeyFor(RECORD_SCOPE_PROBE_ID))
+}
+
 /**
  * pi-ai `CredentialStore`（官方 credentialStoreFrom 等价实现）。
  * 路由键任意而记录 id 受语法约束：语法外的 id 读答"未存储"、删除无事可做、
- * modify 拒绝（写不落地不能报成功）。
+ * modify 拒绝（写不落地不能报成功）。list() 的归属判定用现场推导的作用域
+ * （{@link recordScopeOf}），不比对硬编码常量。
  */
 export function credentialStoreFrom(
   ctx: Context,
   recordKeyFor: (providerId: string) => CredentialKey,
 ): CredentialStore {
+  const recordScope = recordScopeOf(recordKeyFor)
   return {
     async read(providerId) {
       const credentials = ctx.get('credentials')
@@ -114,7 +127,7 @@ export function credentialStoreFrom(
       const stored = (await ctx.get('credentials')?.listRecords()) ?? []
       const mine: CredentialInfo[] = []
       for (const entry of stored) {
-        if (credentialKeyScope(entry.key) !== INLINE_RECORD_SCOPE) continue
+        if (credentialKeyScope(entry.key) !== recordScope) continue
         mine.push({
           providerId: credentialKeyId(entry.key),
           type: entry.kind === 'api-key' ? 'api_key' : 'oauth',

package/src/client/api.ts

@@ -26,7 +26,14 @@ export interface WireKitInfo {
     warnings: string[]
     error?: string
   }
-  diagnostics: string[]
+  diagnostics: WireDiagnostic[]
+}
+
+/** 套件诊断条目（服务端 KitDiagnostic 的镜像）。 */
+export interface WireDiagnostic {
+  /** info = 打包形态说明（非缺陷）；degradation = 回退与逐项降级。 */
+  level: 'info' | 'degradation'
+  message: string
 }
 
 /** 内置 provider 条目。 */

package/src/client/i18n.ts

@@ -27,7 +27,8 @@ const ownZh = {
   officialCopyPending: '尚未生成',
   officialCopyFailed: '生成失败：',
   officialCopyRoutes: '个 route',
-  runtimeDiagnostics: '诊断',
+  runtimeFormNotes: '形态说明',
+  runtimeDiagnostics: '降级诊断',
   runtimeVersionUnknown: '未知',
   runtimeCatalogUnit: '个 provider /',
   runtimeCatalogModels: '个模型',
@@ -168,7 +169,8 @@ const ownEn = {
   officialCopyPending: 'not generated yet',
   officialCopyFailed: 'generation failed: ',
   officialCopyRoutes: 'routes',
-  runtimeDiagnostics: 'Diagnostics',
+  runtimeFormNotes: 'Packaging notes',
+  runtimeDiagnostics: 'Degradations',
   runtimeVersionUnknown: 'unknown',
   runtimeCatalogUnit: 'providers /',
   runtimeCatalogModels: 'models',

package/src/client/root-fields.tsx

@@ -3,15 +3,16 @@
  *
  * 状态行回答的是"我现在到底在跑哪一份 pi-ai"——插件按文件路径动态加载已装 dsh 树
  * 里的套件（见 resolve-dsh.ts），manifest 上写的版本**不是**生效版本。这里显示
- * 生效版本、安装树、目录规模与数据日期、可服务协议、compat 表来源，以及逐项降级
- * 诊断；版本超出验证区间时给出提示（提示而非阻断）。
+ * 生效版本、安装树、目录规模与数据日期、可服务协议、compat 表来源，以及诊断
+ * （按「形态说明 / 降级诊断」分块，避免恒定事实淹没真实降级）；版本超出验证区间
+ * 时给出提示（提示而非阻断）。
  * @module llm-pi/client/root-fields
  */
 
 import { CheckRow } from '@dsh-plus/shared/client'
 import type { ReactElement } from 'react'
 
-import type { WireKitInfo } from './api.ts'
+import type { WireDiagnostic, WireKitInfo } from './api.ts'
 import type { Draft } from './draft.ts'
 import type { Translate } from './i18n.ts'
 
@@ -44,6 +45,25 @@ function officialCopyText(kit: WireKitInfo, t: Translate): string {
   return `${copy.path} · ${copy.routes} ${t('officialCopyRoutes')} · ${formatTime(copy.updatedAt, t('runtimeVersionUnknown'))}`
 }
 
+/**
+ * 诊断分块：形态说明与降级分开渲染——「官方 src 不随 npm 发布」这类恒定事实
+ * 永不会消失，混在一起会把真正的降级淹掉。空块不渲染。
+ */
+function DiagnosticBlock(props: {
+  label: string
+  level: WireDiagnostic['level']
+  items: readonly WireDiagnostic[]
+}): ReactElement | null {
+  const messages = props.items.filter((item) => item.level === props.level).map((m) => m.message)
+  if (messages.length === 0) return null
+  return (
+    <>
+      <p className="lpc-catDetailLabel">{props.label}</p>
+      <pre className="lpc-catJson">{messages.join('\n')}</pre>
+    </>
+  )
+}
+
 export interface RootFieldsProps {
   t: Translate
   draft: Draft
@@ -96,8 +116,12 @@ export function RootFields(props: RootFieldsProps): ReactElement {
           ) : null}
           {kit.diagnostics.length > 0 ? (
             <>
-              <p className="lpc-catDetailLabel">{t('runtimeDiagnostics')}</p>
-              <pre className="lpc-catJson">{kit.diagnostics.join('\n')}</pre>
+              <DiagnosticBlock label={t('runtimeFormNotes')} level="info" items={kit.diagnostics} />
+              <DiagnosticBlock
+                label={t('runtimeDiagnostics')}
+                level="degradation"
+                items={kit.diagnostics}
+              />
             </>
           ) : null}
         </>

package/src/kit-meta.ts

@@ -24,7 +24,7 @@ export interface KitVersions {
 }
 
 /** 本插件开发/测试覆盖过的 pi-ai 区间（semver range，仅用于状态行提示）。 */
-export const VERIFIED_PI_AI_RANGE = '>=0.85.1 <0.88.0'
+export const VERIFIED_PI_AI_RANGE = '>=1.0.2 <2.0.0'
 
 /** 读 package.json 的 version；文件不存在/非 JSON/无 version 都返回 undefined。 */
 export function readPackageVersion(manifestPath: string): string | undefined {
@@ -109,8 +109,8 @@ export function collectVendoredVersions(): KitVersions {
 }
 
 /** 已验证区间的解析端点（与 {@link VERIFIED_PI_AI_RANGE} 同步维护）。 */
-const VERIFIED_MIN: readonly [number, number, number] = [0, 85, 1]
-const VERIFIED_MAX_EXCLUSIVE: readonly [number, number, number] = [0, 88, 0]
+const VERIFIED_MIN: readonly [number, number, number] = [1, 0, 2]
+const VERIFIED_MAX_EXCLUSIVE: readonly [number, number, number] = [2, 0, 0]
 
 /** 解析 `x.y.z[-pre][+build]` 的数值三元组；形状不符返回 undefined。 */
 function numericTriple(version: string): [number, number, number] | undefined {

package/src/official-surface.ts

@@ -206,7 +206,7 @@ export function fallbackProtocols(): string[] {
 }
 
 /**
- * 官方门控表不可解析时的兜底快照（0.2.1-alpha.1 现场推导值）。
+ * 官方门控表不可解析时的兜底快照（0.2.1-alpha.2 现场推导值）。
  *
  * 只在官方改打包形态、`COMPAT_GATES` 解析失败时启用（此时未知键放行、只拦快照里
  * 明确 withhold 的键，见 compat.ts 的「语义分两档」）。快照过期会重新引入

package/src/resolve-dsh.ts

@@ -20,12 +20,14 @@
  * 超出已验证区间也只是提示（kit-meta.ts），永不阻断。
  *
  * 仅 src 子路径导出、包根不导出的两块面：
- * - resolveProfiles（config.ts）：官方解析链，dev 布局树可经 src 子路径复用；
+ * - resolveProfiles（config.ts）：官方解析链，源码布局可经 src 子路径复用；
  * - credentialStoreFrom/authContextFrom（auth.ts）：PiAiAdapter 必需 auth 注入。
  * npm 发布形态（lib/index.js 单 bundle + 无 src/）两者都拿不到：dsh 树优先
  * 探测 src/*（含 lib/* 候选），未命中时 resolveProfiles 走插件等价实现
- * （profiles.ts，门控表对齐官方 catalog.ts）、auth 走内联等价实现
- * （auth-inline.ts，recordKeyFor 自包根导出同源注入）——形状自检兜底。
+ * （profiles.ts，语义对齐官方 config.ts:resolveProfiles）、auth 走内联等价实现
+ * （auth-inline.ts，recordKeyFor 自包根导出同源注入、记录作用域由它现场推导）。
+ * 这是**打包形态的恒定事实而非降级**，故按 info 档记入诊断（missingSourceNote），
+ * 免得淹没同面板里真正的降级；等价实现由形状自检与单测兜底。
  * @module llm-pi/resolve-dsh
  */
 import { existsSync, readFileSync, realpathSync } from 'node:fs'
@@ -106,6 +108,43 @@ export interface AuthHelpers {
   authContextFrom(ctx: Context): AuthContext
 }
 
+/**
+ * 套件诊断条目，配置页按档分块展示：
+ * - `info`：当前打包形态下的**恒定事实**，不是缺陷——官方 `src/` 只经子路径导出、
+ *   npm 发布形态不携带，本插件因此走等价实现（见 {@link missingSourceNote}）；
+ * - `degradation`：推导/加载真的降级了（回退快照、协议缺失、树不可用等）。
+ * 分档是为了不让恒定事实淹没真实降级。
+ */
+export interface KitDiagnostic {
+  level: 'info' | 'degradation'
+  message: string
+}
+
+/** 生成一条降级诊断（推导失败 / 加载回退）。 */
+export function degradation(message: string): KitDiagnostic {
+  return { level: 'degradation', message }
+}
+
+/**
+ * 官方 `src/` 子路径未随 npm 发布携带时的**形态说明**（info 档）。
+ *
+ * 官方 `resolveProfiles`（src/config.ts）与认证助手（src/auth.ts）只在子路径导出、
+ * 包根不导出，而发布清单只含 `lib/index.js` + `lib/types/**`——任何 npm 安装形态都
+ * 拿不到，故这两块常走插件等价实现。此处逐面列出实际走等价实现的部分，并点明
+ * **仍取自官方现场推导**的部分（compat 门控 / 协议 / 模型字段集），避免被读成
+ * "自动跟随失败"。
+ * @param surfaces 走等价实现的官方面名称（如 `profile 解析`）。
+ */
+export function missingSourceNote(surfaces: readonly string[]): KitDiagnostic {
+  return {
+    level: 'info',
+    message:
+      '官方 @deepseek-ai/dsh-llm-pi-ai 只经 src/ 子路径导出、npm 发布形态不携带 src/：' +
+      `${surfaces.join('、')}使用插件等价实现；` +
+      'compat 门控 / 协议集合 / 模型条目字段集仍取自官方安装副本现场推导',
+  }
+}
+
 /** 插件运行期所需的全部上游模块表面（单一来源，内部一致）。 */
 export interface DshKit {
   /** 解析来源：dsh 安装树 / 插件 vendored 兜底副本。 */
@@ -140,16 +179,22 @@ export interface DshKit {
   getBuiltinProviders: typeof vendoredCatalog.getBuiltinProviders
   getBuiltinModels: typeof vendoredCatalog.getBuiltinModels
   /**
-   * profile 解析链：dsh 树 dev 布局（src/config.ts 存在）时为官方
-   * resolveProfiles；npm 形态（无 src）与 vendored 兜底时为插件等价实现。
+   * profile 解析链：官方源码布局（`src/config.ts` 存在，如上游工作区）时为官方
+   * resolveProfiles；npm 发布形态（不携带 src/，包根也不导出）与 vendored 兜底时
+   * 为插件等价实现——该形态事实按 info 档记入诊断（见 {@link missingSourceNote}）。
    */
   resolveProfiles: ResolveProfiles
   /**
-   * PiAiAdapter 必需 auth 注入：dsh 树 dev 布局（src/auth.ts 存在）时为官方
+   * PiAiAdapter 必需 auth 注入：官方源码布局（`src/auth.ts` 存在）时为官方
    * credentialStoreFrom/authContextFrom；其余形态为内联等价实现
-   * （auth-inline.ts，与官方同语义：记录作用域 llm-pi-ai + recordKeyFor）。
+   * （auth-inline.ts，记录键与作用域均取自官方 recordKeyFor）。
    */
   auth: AuthHelpers
+  /**
+   * 官方凭据记录键格式器（包根导出）。auth 助手按它对齐记录键，并**现场推导**
+   * 记录作用域（不再手抄官方常量，见 auth-inline.ts）；缺失即形状不兼容。
+   */
+  recordKeyFor: (providerId: string) => CredentialKey
   /** 附件引用 → 当前模型工具执行世界的只读路径桥（官方 dsh-llm 导出）。 */
   resolveImageAttachmentAccess: typeof DshLlm.resolveImageAttachmentAccess
   /** deepseek 文件通道路由所需模块；同源自检失败时为 undefined（见 diagnostics）。 */
@@ -207,6 +252,7 @@ function assertKitShape(kit: DshKit, origin: string): void {
   ) {
     problems.push('auth 助手（credentialStoreFrom/authContextFrom）缺失')
   }
+  if (typeof kit.recordKeyFor !== 'function') problems.push('recordKeyFor 缺失')
   if (problems.length > 0) {
     throw new Error(`llm-pi: ${origin} 来源的运行时套件形状不兼容：${problems.join('；')}`)
   }
@@ -343,7 +389,7 @@ function piAiApiDir(root: string): string {
 /** 内置三元组的静态加载（协议推导失败或全部工厂加载失败时的兜底）。 */
 async function loadFallbackTreeFactories(
   root: string,
-  diagnostics: string[],
+  diagnostics: KitDiagnostic[],
 ): Promise<Record<string, () => unknown>> {
   const dir = piAiApiDir(root)
   const out: Record<string, () => unknown> = {}
@@ -359,8 +405,10 @@ async function loadFallbackTreeFactories(
   }
   if (Object.keys(out).length < fallbackProtocols().length) {
     diagnostics.push(
-      `pi-ai 协议兜底三元组未能全部加载（${Object.keys(out).join('/') || '空'}）；` +
-        '请检查 dsh 安装树里 @earendil-works/pi-ai/dist/api 的形态',
+      degradation(
+        `pi-ai 协议兜底三元组未能全部加载（${Object.keys(out).join('/') || '空'}）；` +
+          '请检查 dsh 安装树里 @earendil-works/pi-ai/dist/api 的形态',
+      ),
     )
   }
   return out
@@ -373,7 +421,7 @@ async function loadFallbackTreeFactories(
 async function loadTreeProtocols(
   root: string,
   derived: string[],
-  diagnostics: string[],
+  diagnostics: KitDiagnostic[],
 ): Promise<{ protocols: string[]; protocolFactories: Record<string, () => unknown> }> {
   const dir = piAiApiDir(root)
   const out: Record<string, () => unknown> = {}
@@ -381,27 +429,31 @@ async function loadTreeProtocols(
     const file = join(dir, `${api}.lazy.js`)
     if (!existsSync(file)) {
       diagnostics.push(
-        `pi-ai 未提供协议 "${api}" 的惰性实现（缺 ${file}）；该协议不可用，其余协议不受影响`,
+        degradation(
+          `pi-ai 未提供协议 "${api}" 的惰性实现（缺 ${file}）；该协议不可用，其余协议不受影响`,
+        ),
       )
       continue
     }
     try {
       const factory = protocolFactoryOf((await import(pathToFileURL(file).href)) as never)
       if (factory === undefined) {
-        diagnostics.push(`协议 "${api}" 的实现模块未导出唯一 *Api 工厂；该协议不可用`)
+        diagnostics.push(degradation(`协议 "${api}" 的实现模块未导出唯一 *Api 工厂；该协议不可用`))
         continue
       }
       out[api] = factory
     } catch (error) {
       diagnostics.push(
-        `协议 "${api}" 的实现加载失败（${error instanceof Error ? error.message : String(error)}）；该协议不可用`,
+        degradation(
+          `协议 "${api}" 的实现加载失败（${error instanceof Error ? error.message : String(error)}）；该协议不可用`,
+        ),
       )
     }
   }
   if (Object.keys(out).length > 0) {
     return { protocols: derived.filter((api) => out[api] !== undefined), protocolFactories: out }
   }
-  diagnostics.push('官方声明的协议一个都加载不到；回退内置三元组')
+  diagnostics.push(degradation('官方声明的协议一个都加载不到；回退内置三元组'))
   const fallback = await loadFallbackTreeFactories(root, diagnostics)
   return {
     protocols: fallbackProtocols().filter((api) => fallback[api] !== undefined),
@@ -465,7 +517,7 @@ function installOfficialSurface(options: {
   adapterModule: Record<string, unknown>
   catalogModule: Record<string, unknown>
   origin: string
-  diagnostics: string[]
+  diagnostics: KitDiagnostic[]
 }): OfficialSurface {
   const { bundlePath, adapterModule, origin, diagnostics } = options
   const compatLabel = 'compat 门控表'
@@ -477,8 +529,10 @@ function installOfficialSurface(options: {
       // 快照模式下未知 compat 键**放行**（交给官方自身校验），只拦快照里明确的
       // withhold——表落后时"误拒官方新字段"比"多放一个键"严重得多。
       diagnostics.push(
-        `${compatLabel}未能从官方 bundle 解析 COMPAT_GATES（${bundlePath}）；` +
-          `使用内置快照（未知字段放行、withhold 仍拒绝；请检查 dsh-llm-pi-ai 打包形态）`,
+        degradation(
+          `${compatLabel}未能从官方 bundle 解析 COMPAT_GATES（${bundlePath}）；` +
+            `使用内置快照（未知字段放行、withhold 仍拒绝；请检查 dsh-llm-pi-ai 打包形态）`,
+        ),
       )
       installCompatTable(FALLBACK_TABLE)
     } else {
@@ -488,21 +542,27 @@ function installOfficialSurface(options: {
     }
   } catch (error) {
     const reason = error instanceof Error ? error.message : String(error)
-    diagnostics.push(`${compatLabel}推导失败（${reason}）；使用内置快照（未知字段放行）`)
+    diagnostics.push(
+      degradation(`${compatLabel}推导失败（${reason}）；使用内置快照（未知字段放行）`),
+    )
     installCompatTable(FALLBACK_TABLE)
   }
 
   const derivedProtocols = deriveProtocols(adapterModule)
   if (derivedProtocols === undefined) {
     diagnostics.push(
-      `${origin}：官方 supportedProtocols() 不可用；协议集合回退内置三元组 ${fallbackProtocols().join('/')}`,
+      degradation(
+        `${origin}：官方 supportedProtocols() 不可用；协议集合回退内置三元组 ${fallbackProtocols().join('/')}`,
+      ),
     )
   }
   const fields = deriveModelEntryFields(adapterModule)
   if (fields === undefined) {
     diagnostics.push(
-      `${origin}：官方 Config schema 的模型条目字段集不可推导；` +
-        `继承字段回退已知键 ${FALLBACK_MODEL_ENTRY_FIELDS.join('/')}（官方新增字段可能不被继承）`,
+      degradation(
+        `${origin}：官方 Config schema 的模型条目字段集不可推导；` +
+          `继承字段回退已知键 ${FALLBACK_MODEL_ENTRY_FIELDS.join('/')}（官方新增字段可能不被继承）`,
+      ),
     )
   }
   const generatedAt = catalogGeneratedAtOf(options.catalogModule)
@@ -570,6 +630,7 @@ function kitFromTree(options: {
     resolveImageAttachmentAccess: mods.llm[
       'resolveImageAttachmentAccess'
     ] as DshKit['resolveImageAttachmentAccess'],
+    recordKeyFor,
   }
 }
 
@@ -607,9 +668,9 @@ function vendoredProtocolFactories(): Record<string, () => unknown> {
  * npm 发布形态不携带 src/、lib 仅 index.js/invariant.js——resolveProfiles 与
  * auth 助手在此无条件走插件等价实现（内联，见文件头说明）；compat 门控表则
  * 仍从 vendored 副本的 bundle + Config schema 现场推导（与 dsh 树同一推导链）。
- * @param diagnostics 可选诊断收集器（回退原因与逐项降级说明）。
+ * @param diagnostics 可选诊断收集器（回退原因、形态说明与逐项降级）。
  */
-export function loadVendoredKit(diagnostics: string[] = []): DshKit {
+export function loadVendoredKit(diagnostics: KitDiagnostic[] = []): DshKit {
   const staticFactories = vendoredProtocolFactories()
   const surface = installOfficialSurface({
     bundlePath: vendoredAdapterBundlePath(),
@@ -658,9 +719,11 @@ export function loadVendoredKit(diagnostics: string[] = []): DshKit {
       authContextFrom: inlineAuthContextFrom,
     },
     resolveImageAttachmentAccess: vendoredLlm.resolveImageAttachmentAccess,
+    recordKeyFor: vendoredPiAiAdapter.recordKeyFor,
     ...(deepseek === undefined ? {} : { deepseek }),
   }
   assertKitShape(kit, 'vendored')
+  diagnostics.push(missingSourceNote(['profile 解析', '认证助手']))
   return kit
 }
 
@@ -689,14 +752,15 @@ export function dshTreeAnchor(
 /**
  * 解析运行时套件：优先 dsh 安装树（自动跟随上游），失败回退 vendored 副本；
  * 两者都过不了形状自检时抛错（调用方应记日志并放弃注册 route）。
- * 返回的 diagnostics 记录回退原因与逐项降级说明，供配置卡片与日志展示。
+ * 返回的 diagnostics 记录回退原因、打包形态说明（info）与逐项降级（degradation），
+ * 供配置卡片与日志分档展示。
  * @param installAnchor profile 的 dsh 安装锚点（`ctx.profileContext.installAnchor`）。
  */
 export async function resolveDshKit(installAnchor?: string | undefined): Promise<{
   kit: DshKit
-  diagnostics: string[]
+  diagnostics: KitDiagnostic[]
 }> {
-  const diagnostics: string[] = []
+  const diagnostics: KitDiagnostic[] = []
   const anchor = dshTreeAnchor(installAnchor)
   if (anchor !== undefined) {
     const treePkgDir = join(anchor, 'node_modules', '@deepseek-ai', 'dsh-llm-pi-ai')
@@ -729,39 +793,39 @@ export async function resolveDshKit(installAnchor?: string | undefined): Promise
         versions: collectTreeVersions(anchor),
       })
       assertKitShape(kit, 'dsh-tree')
-      if (auth === undefined) {
-        diagnostics.push(
-          'dsh 树不含 dsh-llm-pi-ai/src（npm 发布形态）；认证助手使用插件内联等价实现',
-        )
-      }
-      if (config === undefined) {
-        diagnostics.push(
-          'dsh 树不含 dsh-llm-pi-ai/src（npm 发布形态）；profile 解析使用插件等价实现（compat 门控对齐官方 catalog.ts）',
-        )
-      }
+      const missingSeams: string[] = []
+      if (config === undefined) missingSeams.push('profile 解析')
+      if (auth === undefined) missingSeams.push('认证助手')
+      if (missingSeams.length > 0) diagnostics.push(missingSourceNote(missingSeams))
       const tree = await importTreeDeepseek(anchor)
       if (tree.kit !== undefined) {
         return { kit: { ...kit, deepseek: tree.kit }, diagnostics }
       }
       diagnostics.push(
-        `dsh 安装树的 dsh-llm-deepseek 不可用（${tree.problem ?? '未知原因'}）；` +
-          'adapter: deepseek 的 route 不可用，pi 路由不受影响',
+        degradation(
+          `dsh 安装树的 dsh-llm-deepseek 不可用（${tree.problem ?? '未知原因'}）；` +
+            'adapter: deepseek 的 route 不可用，pi 路由不受影响',
+        ),
       )
       return { kit, diagnostics }
     } catch (error) {
       diagnostics.push(
-        `dsh 安装树套件不可用（${anchor}）：${error instanceof Error ? error.message : String(error)}；回退 vendored 副本`,
+        degradation(
+          `dsh 安装树套件不可用（${anchor}）：${error instanceof Error ? error.message : String(error)}；回退 vendored 副本`,
+        ),
       )
     }
   } else {
     diagnostics.push(
-      '未能从 profileContext.installAnchor / process.argv[1] 定位 dsh 安装树；回退 vendored 副本',
+      degradation(
+        '未能从 profileContext.installAnchor / process.argv[1] 定位 dsh 安装树；回退 vendored 副本',
+      ),
     )
   }
   const kit = loadVendoredKit(diagnostics)
   if (kit.deepseek === undefined) {
     diagnostics.push(
-      'vendored 副本的 dsh-llm-deepseek 形状不兼容；adapter: deepseek 的 route 不可用',
+      degradation('vendored 副本的 dsh-llm-deepseek 形状不兼容；adapter: deepseek 的 route 不可用'),
     )
   }
   return { kit, diagnostics }

package/src/service.ts

@@ -47,7 +47,7 @@ import {
 } from './official-copy-writer.ts'
 import { assertServiceable, buildProfiles, isDraftRoute } from './profiles.ts'
 import { buildDeepseekRoutes, type ResolvedDeepseekRoute } from './profiles-deepseek.ts'
-import { type DshKit, resolveDshKit } from './resolve-dsh.ts'
+import { type DshKit, degradation, type KitDiagnostic, resolveDshKit } from './resolve-dsh.ts'
 
 /** 配置页「运行期状态」所需的事实（纯 JSON，可直接进 HTTP 响应）。 */
 export interface LlmPiKitInfo {
@@ -71,8 +71,11 @@ export interface LlmPiKitInfo {
   compatSource: string
   /** 官方应急副本状态（路径/生成时间/覆盖 route/警告；error = 最近生成失败）。 */
   officialCopy: OfficialCopyStatus
-  /** 回退与逐项降级诊断（有内容时界面显式展示）。 */
-  diagnostics: string[]
+  /**
+   * 套件诊断（分档，界面分块展示）：`info` = 打包形态说明（恒定事实、非缺陷），
+   * `degradation` = 回退与逐项降级。
+   */
+  diagnostics: KitDiagnostic[]
 }
 
 export interface LlmPiRuntime {
@@ -132,13 +135,16 @@ function makeResolveApiKey(ctx: Context, kit: DshKit) {
   }
 }
 
-/** 解析运行期套件并落启动日志（来源/生效版本/协议/逐项降级诊断）。 */
+/** 解析运行期套件并落启动日志（来源/生效版本/协议/形态说明与逐项降级）。 */
 async function loadRuntimeKit(
   ctx: Context,
   logger: PluginLogger,
-): Promise<{ kit: DshKit; diagnostics: string[] }> {
+): Promise<{ kit: DshKit; diagnostics: KitDiagnostic[] }> {
   const { kit, diagnostics } = await resolveDshKit(ctx.get('profileContext')?.installAnchor)
-  for (const line of diagnostics) logger.warn(line)
+  for (const item of diagnostics) {
+    if (item.level === 'info') logger.info(item.message)
+    else logger.warn(item.message)
+  }
   logger.info(
     `运行时套件来源：${kit.source}；pi-ai ${kit.versions.piAi ?? '?'} / ` +
       `dsh-llm-pi-ai ${kit.versions.piAiAdapter ?? '?'}；协议 ${kit.protocols.join('/')}`,
@@ -479,8 +485,8 @@ export async function startRuntime(
       officialCopy: copy,
       diagnostics: [
         ...diagnostics,
-        ...copy.warnings.map((warning) => `应急副本：${warning}`),
-        ...(copy.error === undefined ? [] : [`应急副本：生成失败（${copy.error}）`]),
+        ...copy.warnings.map((warning) => degradation(`应急副本：${warning}`)),
+        ...(copy.error === undefined ? [] : [degradation(`应急副本：生成失败（${copy.error}）`)]),
       ],
     }
   }