@dsh-plus/llm-pi 0.2.0 → 0.2.2

package/lib/client.js

@@ -184,7 +184,7 @@ window.__ModuleLoader__.load({
 			unsaved: "未保存",
 			loading: "加载中…",
 			unavailable: "配置服务不可用。",
-			readOnly: "当前部署无 settings provider，配置为只读；请编辑 settings.yaml。",
+			readOnly: "当前部署无 settings provider，配置为只读；请在 profile 的 cordis.patch.yml 行级配置。",
 			invalidNumber: "请输入正整数。",
 			collapse: "收起",
 			expand: "展开",
@@ -201,7 +201,7 @@ window.__ModuleLoader__.load({
 			unsaved: "Unsaved",
 			loading: "Loading…",
 			unavailable: "Settings service unavailable.",
-			readOnly: "No settings provider in this deployment; config is read-only. Edit settings.yaml.",
+			readOnly: "No settings provider in this deployment; config is read-only. Configure it at the profile row in cordis.patch.yml.",
 			invalidNumber: "Enter a positive integer.",
 			collapse: "Collapse",
 			expand: "Expand",
@@ -408,7 +408,7 @@ ${extra}
 		//#region src/ns.ts
 		/**
 		* settings 命名空间字面量（纯常量，零依赖，浏览器半可安全引入）。
-		* 服务端直接以字面量注册（0.1.2-alpha.2 起 dsh-settings 对命名空间做编译期
+		* 服务端直接以字面量注册（dsh-settings 对命名空间做编译期
 		* 语法校验，见 config.ts）；浏览器半把它作为配置卡片的注册键
 		* （插件页配置卡片挂在 row/bundle config 槽位上，与命名空间解耦，
 		* 见 shared/config-slots），
@@ -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.d.ts

@@ -2,7 +2,7 @@ import z from "@deepseek-ai/schemastery";
 import { VolatileFields } from "@dsh-plus/shared";
 import { Context } from "@deepseek-ai/cordis";
 //#region src/config.d.ts
-/** settings 命名空间（字面量即合法命名空间，0.1.2-alpha.2 起编译期校验；webui 配置卡片与插件运行期读取同一份）。 */
+/** settings 命名空间（字面量即合法命名空间，编译期校验；webui 配置卡片与插件运行期读取同一份）。 */
 declare const SETTINGS_NS = "dsh-plus-llm-pi";
 /** 线协议标识；合法集合运行期推导，故此处是开放字符串而非字面量联合。 */
 type ProtocolId = string;
@@ -89,7 +89,7 @@ interface LlmPiConfig {
  * （2 个根字段均有 schema 默认值），解析输出仍是完整的 {@link LlmPiConfig}。
  */
 type LlmPiConfigInput = Partial<LlmPiConfig>;
-/** 活动字段形态（0.1.7 loader 解析产物：volatile 字段为活动引用）。 */
+/** 活动字段形态（loader 解析产物：volatile 字段为活动引用）。 */
 type LlmPiConfigFields = VolatileFields<LlmPiConfig>;
 declare const Config: z<LlmPiConfigInput, LlmPiConfigFields>;
 //#endregion

package/lib/index.js

@@ -24,7 +24,7 @@ import { homedir } from "node:os";
 //#region src/config.ts
 /**
 * 配置单一事实源：cordis 行级 Config（组合默认值）与 settings namespace
-*（用户层，经 dsh-settings-file 持久化到 $DSH_HOME/settings.yaml）共用同一
+*（用户层＝profile 行级覆盖层 cordis.patch.yml，热生效）共用同一
 * schemastery schema。无密钥字段（apiKeyEnv 是凭据引用名而非密钥本身）。
 *
 * 与官方 llm-pi-ai 的差异：
@@ -35,10 +35,10 @@ import { homedir } from "node:os";
 *   官方将来新增协议无需改本插件。
 * @module llm-pi/config
 */
-/** settings 命名空间（字面量即合法命名空间，0.1.2-alpha.2 起编译期校验；webui 配置卡片与插件运行期读取同一份）。 */
+/** settings 命名空间（字面量即合法命名空间，编译期校验；webui 配置卡片与插件运行期读取同一份）。 */
 const SETTINGS_NS = "dsh-plus-llm-pi";
 /**
-* 官方适配器不可用/推导失败时的协议兜底三元组（自 0.1.2-alpha 线以来的稳定集）。
+* 官方适配器不可用/推导失败时的协议兜底三元组。
 * 运行期生效集合来自已安装官方包的 `supportedProtocols()`（见 resolve-dsh.ts），
 * 本常量只用于 schema 描述、浏览器半首帧兜底与推导失败回退。
 */
@@ -68,8 +68,6 @@ const DEEPSEEK_REASONING_EFFORTS = [
 	"high",
 	"max"
 ];
-/** 旧版 imageDetail 枚举（0.1.2-alpha.1 已移除该字段；仅用于 schema 透传陷阱的取值集）。 */
-const DEEPSEEK_IMAGE_DETAILS = ["auto", "low"];
 /** dsh-timeout 的定时器上限（与官方 MAX_TIMER_DELAY_MS 对齐）。 */
 const MAX_TIMER_DELAY_MS = 2 ** 31 - 1;
 /**
@@ -103,8 +101,7 @@ const modelEntry = z.object({
 	reasoningEfforts: z.union([z.const(false), reasoningEfforts]).description("可选 reasoning 档位：false=非推理模型；dict=档位→线值映射；缺省继承内置目录能力"),
 	compat: compatDict.description("模型级 compat（字段级合并，压过 route 级与继承值）"),
 	imagePixelBudget: z.number().step(1).min(1).description("（仅 adapter: deepseek）单张请求图片的总像素预算；缺省继承官方目录"),
-	imageMaxBytes: z.number().step(1).min(1).description("（仅 adapter: deepseek）单张请求图片的编码字节上限；缺省继承官方目录"),
-	imageDetail: z.union(DEEPSEEK_IMAGE_DETAILS).description("（已移除）图片细节档位；0.1.2-alpha.1 起请改用 imagePixelBudget/imageMaxBytes")
+	imageMaxBytes: z.number().step(1).min(1).description("（仅 adapter: deepseek）单张请求图片的编码字节上限；缺省继承官方目录")
 });
 const providerProfile = z.object({
 	adapter: z.union(ADAPTER_KINDS).description("路由适配器：pi=PiAiAdapter（默认，协议集合随已装官方适配器推导）；deepseek=官方 DeepSeekAdapter（图片走 Files API 文件通道，失败自动降级 base64）").default("pi"),
@@ -134,7 +131,7 @@ const providerProfile = z.object({
 	timeoutMs: z.natural().description("HTTP/provider 超时毫秒"),
 	websocketConnectTimeoutMs: z.natural().description("WebSocket 连接超时毫秒"),
 	streamIdleTimeoutMs: z.number().min(Number.MIN_VALUE).max(MAX_TIMER_DELAY_MS).description("单支流式读取的最大空闲间隔毫秒"),
-	maxRequestImageBytes: z.natural().description("单请求 base64 图片载荷上限字节；缺省 20MiB（0.1.2-alpha.1 起官方必需字段，旧配置免改）"),
+	maxRequestImageBytes: z.natural().description("单请求 base64 图片载荷上限字节；缺省 20MiB（官方必需字段，旧配置免改）"),
 	requestImagePixelBudget: z.number().step(1).min(1).description("单请求每个确定性内联图片版本的像素总预算；缺省 2048x2048（官方同值）"),
 	requestImageMaxBytes: z.number().step(1).min(1).description("内联图片版本编码字节目标；缺省 1MiB（官方同值）"),
 	retryPolicy: z.any().description("provider 重试策略（dsh-llm RetryPolicy 形状，构建期校验）"),
@@ -517,7 +514,7 @@ function browseModels(kit, query = {}) {
 * 3. **模型条目字段集**：Config schema 的 `providers.*.models` 键集——继承时按此
 *    透传 pi-ai 目录的同名字段，官方将来新增模型级字段即自动跟随。
 *
-* 历史教训（0.1.5-rc.1）：compat 门控曾是官方 catalog.ts 的手抄镜像，官方扩容
+* 历史教训（详见 docs/repo/事故记录.md）：compat 门控曾是官方的手抄镜像，官方扩容
 * offer 字段而旧表漏收，导致官方可配字段被本插件**误拒**（静默功能缺失、无报错）。
 * 现改为现场推导，`tests/official-surface.test.ts` 直读官方副本守门推导正确性。
 *
@@ -652,10 +649,18 @@ const FALLBACK_MODEL_ENTRY_FIELDS = [
 function fallbackProtocols() {
 	return [...FALLBACK_PROTOCOLS];
 }
-/** 官方门控表不可解析时的最后已知快照（0.1.5-rc.2 实测值）。 */
+/**
+* 官方门控表不可解析时的兜底快照（0.2.1-alpha.1 现场推导值）。
+*
+* 只在官方改打包形态、`COMPAT_GATES` 解析失败时启用（此时未知键放行、只拦快照里
+* 明确 withhold 的键，见 compat.ts 的「语义分两档」）。快照过期会重新引入
+* 「误拒官方新字段」那类静默故障，故由 tests/official-surface.test.ts 的
+* 「兜底快照不得过期」用例与现场推导逐协议比对守门。
+*/
 const FALLBACK_TABLE = {
 	source: "fallback",
 	gates: {
+		"mistral-conversations": { supportsMidConvoSystemMessages: "withhold" },
 		"openai-completions": {
 			supportsStore: "offer",
 			supportsDeveloperRole: "offer",
@@ -681,7 +686,8 @@ const FALLBACK_TABLE = {
 			zaiToolStream: "withhold",
 			supportsOpenAIGrammarTools: "withhold",
 			sendSessionAffinityHeaders: "withhold",
-			deferredToolsMode: "withhold",
+			supportsMidConvoSystemMessages: "withhold",
+			supportsMidConvoToolAdditions: "withhold",
 			sessionAffinityFormat: "withhold"
 		},
 		"openai-responses": {
@@ -693,7 +699,32 @@ const FALLBACK_TABLE = {
 			supportsOpenAIGrammarTools: "withhold",
 			supportsAdditionalTools: "withhold",
 			supportsToolSearch: "withhold",
-			supportsExplicitPromptCacheMode: "withhold"
+			supportsExplicitPromptCacheMode: "withhold",
+			supportsMidConvoSystemMessages: "withhold"
+		},
+		"azure-openai-responses": {
+			supportsDeveloperRole: "offer",
+			supportsMaxOutputTokens: "offer",
+			supportsStrictMode: "offer",
+			supportsLongCacheRetention: "offer",
+			sessionAffinityFormat: "withhold",
+			supportsOpenAIGrammarTools: "withhold",
+			supportsAdditionalTools: "withhold",
+			supportsToolSearch: "withhold",
+			supportsExplicitPromptCacheMode: "withhold",
+			supportsMidConvoSystemMessages: "withhold"
+		},
+		"openai-codex-responses": {
+			supportsDeveloperRole: "offer",
+			supportsMaxOutputTokens: "offer",
+			supportsStrictMode: "offer",
+			supportsLongCacheRetention: "offer",
+			sessionAffinityFormat: "withhold",
+			supportsOpenAIGrammarTools: "withhold",
+			supportsAdditionalTools: "withhold",
+			supportsToolSearch: "withhold",
+			supportsExplicitPromptCacheMode: "withhold",
+			supportsMidConvoSystemMessages: "withhold"
 		},
 		"anthropic-messages": {
 			supportsEagerToolInputStreaming: "offer",
@@ -704,10 +735,13 @@ const FALLBACK_TABLE = {
 			allowEmptySignature: "offer",
 			supportsStrictTools: "offer",
 			sendSessionAffinityHeaders: "withhold",
-			supportsToolReferences: "withhold",
+			sessionAffinityFormat: "withhold",
+			supportsMidConvoSystemMessages: "withhold",
+			supportsMidConvoToolChanges: "withhold",
 			supportsMidConvoEffort: "withhold",
 			allowedFallbackModels: "withhold"
-		}
+		},
+		"bedrock-converse-stream": { supportsStrictMode: "offer" }
 	},
 	specs: {
 		supportsStore: "boolean",
@@ -821,7 +855,7 @@ function checkValue(field, spec, value, where) {
 }
 /**
 * 校验一份 compat 字典对指定协议合法（对齐官方门控语义 + schema 值约束）：
-* - 未知键/withhold 字段拒绝（官方写时拒绝，替代旧版静默丢弃）；
+* - 未知键/withhold 字段拒绝（与官方写时拒绝同款）；
 * - 值类型/枚举按官方 schema 校验；
 * - 无值键（null/undefined）拒绝（官方 assertOfferedCompatFields 同款）。
 */
@@ -1527,7 +1561,6 @@ function declaredModalities(configured) {
 /** 物化单个模型目录条目：官方 base 在下，条目显式字段逐字段覆盖。 */
 function materializeModel$1(route, entry, deps) {
 	if (entry.reasoningEfforts !== void 0 || nonEmptyDict(entry.compat)) invalid$1(route, `model "${entry.id}" 的 reasoningEfforts/compat 仅 adapter: pi 可用`);
-	if (entry.imageDetail !== void 0) invalid$1(route, `model "${entry.id}" 的 imageDetail 已随 0.1.2-alpha.1 移除；请改用 imagePixelBudget/imageMaxBytes（低细节可配更小的 imagePixelBudget）并删除 imageDetail`);
 	const base = resolveOfficialBase(route, entry, deps);
 	const input = declaredModalities(entry.input) ?? base.input;
 	const imageFields = {
@@ -1588,7 +1621,7 @@ function rawAdapterConfig(profile, baseURL, models) {
 /** 物化单个 deepseek route；lenient 下失败告警并返回 null（调用方跳过注册）。 */
 function buildRoute(route, profile, deps) {
 	try {
-		if (deps.kit.deepseek === void 0) invalid$1(route, "使用 adapter: deepseek，但当前运行时套件不含 dsh-llm-deepseek（0.1.2-alpha.1 基线）");
+		if (deps.kit.deepseek === void 0) invalid$1(route, "使用 adapter: deepseek，但当前运行时套件不含 dsh-llm-deepseek（本仓基线的必需套件）");
 		rejectPiOnlyFields(route, profile);
 		if (profile.extends !== void 0 && profile.extends !== "deepseek") invalid$1(route, `的 extends ${JSON.stringify(profile.extends)} 非法：adapter: deepseek 仅支持 "deepseek"（官方目录）`);
 		if (profile.apiKeyEnv === void 0 || profile.apiKeyEnv.length === 0) invalid$1(route, "需要 apiKeyEnv：DeepSeekAdapter 无环境自发现，凭据引用必须显式配置");
@@ -1625,7 +1658,7 @@ function buildDeepseekRoutes(providers, deps) {
 //#endregion
 //#region src/profiles.ts
 /**
-* profile 构建器（0.1.2-alpha.2 复核兼容）：插件 Config → 官方 schema 形状的
+* profile 构建器：插件 Config → 官方 schema 形状的
 * 「前置数据源归一化」→ 官方 resolveProfiles（或插件等价兜底）→
 * ResolvedPiAiProviderProfile。
 *
@@ -1740,7 +1773,6 @@ function reasoningEffortsFromBase(provider, entry, base) {
 * 返回 null（调用方跳过该模型）。
 */
 function materializeModel(route, profile, entry, base, routeApi, defaultInput, deps) {
-	if (entry.imageDetail !== void 0) invalid(route, `model "${entry.id}" 的 imageDetail 已随 0.1.2-alpha.1 移除；请改用 imagePixelBudget/imageMaxBytes（仅 adapter: deepseek）并删除 imageDetail`);
 	const api = profile.api ?? base.api ?? routeApi;
 	if (api === void 0) {
 		if (deps.lenient) {
@@ -2434,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));
@@ -2472,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");
@@ -2489,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"
@@ -2558,15 +2618,40 @@ function authContextFrom(ctx) {
 * 模型条目字段集同样现场推导（official-surface.ts）。生效版本只用于状态行显示，
 * 超出已验证区间也只是提示（kit-meta.ts），永不阻断。
 *
-* 0.1.2-alpha 线的新面（0.1.2-alpha.2 复核包根仍未导出、仅 src 子路径有）：
-* - resolveProfiles（config.ts）：官方解析链，dev 布局树可经 src 子路径复用；
+* 仅 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 = [];
@@ -2592,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 模块形状自检；返回问题清单（空 = 可用），由调用方决定降级。 */
@@ -2696,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;
 }
 /**
@@ -2709,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),
@@ -2773,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,
@@ -2785,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(),
@@ -2833,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）。 */
@@ -2867,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();
@@ -2913,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;
 }
 /**
@@ -2939,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) {
@@ -2969,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: {
@@ -2979,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
@@ -3016,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);
@@ -3285,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.0",
+  "version": "0.2.2",
   "description": "dsh-plus service+ui plugin: 基于 PiAiAdapter 的自定义 LLM 路由（全量 compat、模型继承、pi-ai 内置目录；协议/compat/字段集现场推导，自动跟随已装 dsh）",
   "type": "module",
   "main": "lib/index.js",
@@ -32,7 +32,7 @@
   },
   "dependencies": {
     "yaml": "^2.9.0",
-    "@dsh-plus/shared": "0.1.35"
+    "@dsh-plus/shared": "0.1.37"
   },
   "peerDependencies": {
     "@deepseek-ai/cordis": "^4.0.5-alpha.1",