@dsh-plus/llm-pi 0.2.0 → 0.2.1

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），

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) {
@@ -2558,7 +2590,7 @@ function authContextFrom(ctx) {
 * 模型条目字段集同样现场推导（official-surface.ts）。生效版本只用于状态行显示，
 * 超出已验证区间也只是提示（kit-meta.ts），永不阻断。
 *
-* 0.1.2-alpha 线的新面（0.1.2-alpha.2 复核包根仍未导出、仅 src 子路径有）：
+* 仅 src 子路径导出、包根不导出的两块面：
 * - resolveProfiles（config.ts）：官方解析链，dev 布局树可经 src 子路径复用；
 * - credentialStoreFrom/authContextFrom（auth.ts）：PiAiAdapter 必需 auth 注入。
 * npm 发布形态（lib/index.js 单 bundle + 无 src/）两者都拿不到：dsh 树优先

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dsh-plus/llm-pi",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "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.36"
   },
   "peerDependencies": {
     "@deepseek-ai/cordis": "^4.0.5-alpha.1",

package/src/client/client.ts

@@ -7,8 +7,8 @@
  *
  * 类型说明：浏览器半只用到 slots/locale/remote 的很窄一面，
  * scope 与基础控件走 @dsh-plus/shared/client 套件（收编自本插件原实现）。
- * 配置读写经 ctx.remote.settings 直连（0.1.2-alpha.1 起 connection.api.settings
- * 已移除；0.1.7 起 settingsScope 服务亦删除（configForms 取代）——插件卡片自始
+ * 配置读写经 ctx.remote.settings 直连（connection.api.settings
+ * 已移除； settingsScope 服务亦删除（configForms 取代）——插件卡片自始
  * 直连 remote.settings，见 @dsh-plus/shared/client scope.ts）；自定义端点只剩
  * `/catalog`（api.ts：运行期套件事实 + pi-ai 内置目录搜索，浏览器半读不到 pi-ai 包）。
  * 卡片 key/rowId 约定见 @dsh-plus/shared/client/config-slots。

package/src/compat.ts

@@ -10,7 +10,7 @@
  *   assertOfferedCompatFields："写了但没生效"的表面状态不允许）。
  * - **fallback（推导失败，用最后已知快照）**：只拒绝快照中明确 withhold 的键，
  *   **未知键放行**交给官方适配器自身校验——表落后时"误拒官方新字段"比"多放一个键"
- *   严重得多（0.1.5-rc.1 教训：静默功能缺失、无任何报错）。
+ *   严重得多（教训：静默功能缺失、无任何报错）。
  *
  * pi-ai 侧消费语义：getCompat 逐字段 `??` 覆盖 detectCompat 的 baseURL/名称猜测；
  * undefined 视为未设置（无法显式清空检测值）。
@@ -122,7 +122,7 @@ function checkValue(field: string, spec: CompatValue, value: unknown, where: str
 
 /**
  * 校验一份 compat 字典对指定协议合法（对齐官方门控语义 + schema 值约束）：
- * - 未知键/withhold 字段拒绝（官方写时拒绝，替代旧版静默丢弃）；
+ * - 未知键/withhold 字段拒绝（与官方写时拒绝同款）；
  * - 值类型/枚举按官方 schema 校验；
  * - 无值键（null/undefined）拒绝（官方 assertOfferedCompatFields 同款）。
  */

package/src/config-api.ts

@@ -1,6 +1,6 @@
 /**
  * 自定义端点 HTTP 通道：配置读写走官方 remote.settings 直连
- * （0.1.2-alpha.1 起第三方命名空间全量开放），这里只提供浏览器半拿不到的两样东西：
+ * （第三方命名空间全量开放），这里只提供浏览器半拿不到的两样东西：
  * - 运行期套件事实（生效版本、协议集合、目录规模、逐项降级诊断）；
  * - pi-ai 内置目录的搜索/筛选/分页（浏览器半读不到 pi-ai 包）。
  *

package/src/config.ts

@@ -1,6 +1,6 @@
 /**
  * 配置单一事实源：cordis 行级 Config（组合默认值）与 settings namespace
- *（用户层，经 dsh-settings-file 持久化到 $DSH_HOME/settings.yaml）共用同一
+ *（用户层＝profile 行级覆盖层 cordis.patch.yml，热生效）共用同一
  * schemastery schema。无密钥字段（apiKeyEnv 是凭据引用名而非密钥本身）。
  *
  * 与官方 llm-pi-ai 的差异：
@@ -17,11 +17,11 @@ import type { VolatileFields } from '@dsh-plus/shared'
 
 import { SETTINGS_NS as NS_LITERAL } from './ns.ts'
 
-/** settings 命名空间（字面量即合法命名空间，0.1.2-alpha.2 起编译期校验；webui 配置卡片与插件运行期读取同一份）。 */
+/** settings 命名空间（字面量即合法命名空间，编译期校验；webui 配置卡片与插件运行期读取同一份）。 */
 export const SETTINGS_NS = NS_LITERAL
 
 /**
- * 官方适配器不可用/推导失败时的协议兜底三元组（自 0.1.2-alpha 线以来的稳定集）。
+ * 官方适配器不可用/推导失败时的协议兜底三元组。
  * 运行期生效集合来自已安装官方包的 `supportedProtocols()`（见 resolve-dsh.ts），
  * 本常量只用于 schema 描述、浏览器半首帧兜底与推导失败回退。
  */
@@ -45,9 +45,6 @@ export type AdapterKind = (typeof ADAPTER_KINDS)[number]
 /** deepseek 路由的思考/推理档位（线协议枚举，对齐官方 llm-deepseek）。 */
 export const DEEPSEEK_THINKING = ['enabled', 'disabled'] as const
 export const DEEPSEEK_REASONING_EFFORTS = ['off', 'low', 'high', 'max'] as const
-/** 旧版 imageDetail 枚举（0.1.2-alpha.1 已移除该字段；仅用于 schema 透传陷阱的取值集）。 */
-export const DEEPSEEK_IMAGE_DETAILS = ['auto', 'low'] as const
-
 export const DEFAULT_CONTEXT_WINDOW = 262144
 export const DEFAULT_MAX_TOKENS = 32768
 export const DEFAULT_STREAM_IDLE_TIMEOUT_MS = 300000
@@ -201,12 +198,6 @@ const modelEntry = z.object({
     .step(1)
     .min(1)
     .description('（仅 adapter: deepseek）单张请求图片的编码字节上限；缺省继承官方目录'),
-  // 0.1.2-alpha.1 移除字段的 schema 透传陷阱：官方已删除 imageDetail（改用
-  // imagePixelBudget/imageMaxBytes），此处保留取值 union 让旧配置通过 schema、
-  // 在写时校验（assertServiceable）以中文迁移提示明确拒绝（见 profiles-deepseek.ts）。
-  imageDetail: z
-    .union(DEEPSEEK_IMAGE_DETAILS)
-    .description('（已移除）图片细节档位；0.1.2-alpha.1 起请改用 imagePixelBudget/imageMaxBytes'),
 })
 
 const providerProfile = z.object({
@@ -254,9 +245,7 @@ const providerProfile = z.object({
     .description('单支流式读取的最大空闲间隔毫秒'),
   maxRequestImageBytes: z
     .natural()
-    .description(
-      '单请求 base64 图片载荷上限字节；缺省 20MiB（0.1.2-alpha.1 起官方必需字段，旧配置免改）',
-    ),
+    .description('单请求 base64 图片载荷上限字节；缺省 20MiB（官方必需字段，旧配置免改）'),
   requestImagePixelBudget: z
     .number()
     .step(1)
@@ -333,10 +322,10 @@ const providerProfile = z.object({
     .description('本 route 的模型目录；缺省且 provider 有 extends 时继承该源全部模型'),
 })
 
-// 0.1.7：根字段全 `.volatile()`——条目进入 settings describe 视图（卡片可读写），
+// 根字段全 `.volatile()`——条目进入 settings describe 视图（卡片可读写），
 // loader 原位提交活动引用；输出面标注活动字段声明面（结构兼容 volatile 引用），
 // 平面消费契约保持 LlmPiConfig 接口不变（服务侧经 unwrapVolatile 解包现取）。
-/** 活动字段形态（0.1.7 loader 解析产物：volatile 字段为活动引用）。 */
+/** 活动字段形态（loader 解析产物：volatile 字段为活动引用）。 */
 export type LlmPiConfigFields = VolatileFields<LlmPiConfig>
 
 export const Config: z<LlmPiConfigInput, LlmPiConfigFields> = z.object({

package/src/deepseek-routes.ts

@@ -11,7 +11,7 @@
  * 请求生效）；retryPolicy 是注册期捕获事实，变化时 handle.replace 原地重注册
  * （官方同款模式）；route 移除即 dispose 释放路由名。
  *
- * 0.1.2-alpha 线：DeepSeekAdapterOptions 必需 prepareExtensions（官方接线
+ * DeepSeekAdapterOptions 必需 prepareExtensions（官方接线
  * ctx.get('deepseekLlmApiExtensions')，缺省空实现）与可选 resolveImageAccess。
  * @module llm-pi/deepseek-routes
  */
@@ -158,7 +158,7 @@ export class DeepseekRouteRegistrar {
             )?.processPathFromHostPath(hostPath),
           ref,
         ) as never,
-      // 0.1.2-alpha 线必需：官方扩展注册表（deepseekLlmApiExtensions）缺席时
+      // 必需项：官方扩展注册表（deepseekLlmApiExtensions）缺席时
       // 给空实现（官方接线范式，llm-deepseek/src/index.ts:404-470）。
       prepareExtensions: (request) => {
         const extensions = ctx.get('deepseekLlmApiExtensions') as

package/src/inherit.ts

@@ -3,7 +3,7 @@
  *
  * 数据源只有一个：**pi-ai 内置目录**（随已装 dsh 的 pi-ai 版本自动跟随，
  * 含官方校正的 compat/thinkingLevelMap/模态）。未命中即「手写条目」，
- * 必填字段由 route 级配置或兜底给出。models.dev 兜底源已随 0.1.43 移除——
+ * 必填字段由 route 级配置或兜底给出。models.dev 兜底源已移除——
  * 版本漂移靠「现场推导 + 状态行显示生效版本」处理，不引入第二份可能过期的目录。
  *
  * 引用语法：`"provider/model"` 显式引用；裸 `"model"` 随 route 级 extends 源；

package/src/ns.ts

@@ -1,6 +1,6 @@
 /**
  * settings 命名空间字面量（纯常量，零依赖，浏览器半可安全引入）。
- * 服务端直接以字面量注册（0.1.2-alpha.2 起 dsh-settings 对命名空间做编译期
+ * 服务端直接以字面量注册（dsh-settings 对命名空间做编译期
  * 语法校验，见 config.ts）；浏览器半把它作为配置卡片的注册键
  * （插件页配置卡片挂在 row/bundle config 槽位上，与命名空间解耦，
  * 见 shared/config-slots），

package/src/official-surface.ts

@@ -10,7 +10,7 @@
  * 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` 直读官方副本守门推导正确性。
  *
@@ -205,10 +205,20 @@ export function fallbackProtocols(): string[] {
   return [...FALLBACK_PROTOCOLS]
 }
 
-/** 官方门控表不可解析时的最后已知快照（0.1.5-rc.2 实测值）。 */
+/**
+ * 官方门控表不可解析时的兜底快照（0.2.1-alpha.1 现场推导值）。
+ *
+ * 只在官方改打包形态、`COMPAT_GATES` 解析失败时启用（此时未知键放行、只拦快照里
+ * 明确 withhold 的键，见 compat.ts 的「语义分两档」）。快照过期会重新引入
+ * 「误拒官方新字段」那类静默故障，故由 tests/official-surface.test.ts 的
+ * 「兜底快照不得过期」用例与现场推导逐协议比对守门。
+ */
 export const FALLBACK_TABLE: CompatTable = {
   source: 'fallback',
   gates: {
+    'mistral-conversations': {
+      supportsMidConvoSystemMessages: 'withhold',
+    },
     'openai-completions': {
       supportsStore: 'offer',
       supportsDeveloperRole: 'offer',
@@ -234,7 +244,8 @@ export const FALLBACK_TABLE: CompatTable = {
       zaiToolStream: 'withhold',
       supportsOpenAIGrammarTools: 'withhold',
       sendSessionAffinityHeaders: 'withhold',
-      deferredToolsMode: 'withhold',
+      supportsMidConvoSystemMessages: 'withhold',
+      supportsMidConvoToolAdditions: 'withhold',
       sessionAffinityFormat: 'withhold',
     },
     'openai-responses': {
@@ -247,6 +258,31 @@ export const FALLBACK_TABLE: CompatTable = {
       supportsAdditionalTools: 'withhold',
       supportsToolSearch: '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',
@@ -257,10 +293,15 @@ export const FALLBACK_TABLE: CompatTable = {
       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',

package/src/profiles-deepseek.ts

@@ -130,16 +130,6 @@ function materializeModel(
   if (entry.reasoningEfforts !== undefined || nonEmptyDict(entry.compat)) {
     invalid(route, `model "${entry.id}" 的 reasoningEfforts/compat 仅 adapter: pi 可用`)
   }
-  const legacyImageDetail = (entry as ModelEntryConfig & { imageDetail?: unknown }).imageDetail
-  if (legacyImageDetail !== undefined) {
-    // 0.1.2-alpha.1 移除字段：写时明确拒绝并给出迁移提示（官方 llm-deepseek
-    // 对含 imageDetail 的目录模型同样直接抛错，index.ts:212-215）。
-    invalid(
-      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 = {
@@ -233,7 +223,7 @@ function buildRoute(
     if (deps.kit.deepseek === undefined) {
       invalid(
         route,
-        '使用 adapter: deepseek，但当前运行时套件不含 dsh-llm-deepseek（0.1.2-alpha.1 基线）',
+        '使用 adapter: deepseek，但当前运行时套件不含 dsh-llm-deepseek（本仓基线的必需套件）',
       )
     }
     rejectPiOnlyFields(route, profile)

package/src/profiles.ts

@@ -1,5 +1,5 @@
 /**
- * profile 构建器（0.1.2-alpha.2 复核兼容）：插件 Config → 官方 schema 形状的
+ * profile 构建器：插件 Config → 官方 schema 形状的
  * 「前置数据源归一化」→ 官方 resolveProfiles（或插件等价兜底）→
  * ResolvedPiAiProviderProfile。
  *
@@ -190,14 +190,6 @@ function materializeModel(
   defaultInput: ('text' | 'image')[],
   deps: BuildDeps,
 ): MaterializedEntry | null {
-  const legacyImageDetail = (entry as ModelEntryConfig & { imageDetail?: unknown }).imageDetail
-  if (legacyImageDetail !== undefined) {
-    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 === undefined) {
     if (deps.lenient) {
@@ -606,7 +598,7 @@ export function resolveProfilesFallback(
     // 模型物化：全显式条目 + route 级 api/baseURL（官方 resolveRouteModels 镜像，
     // 无目录继承——归一化已把继承值落定在条目里）
     const configuredMaxTokens = new Map<string, number>()
-    // 官方 0.1.5-alpha.2（llm-pi-ai）adapter 读取 profile.modelErrors/catalogError：
+    // 官方 llm-pi-ai adapter 读取 profile.modelErrors/catalogError：
     // 本 fallback 对条目严格校验、坏条目整体拒绝（不产生"条目级不可服务"的
     // deferred 诊断），故补空表保持与官方 profile 形状一致——缺失会让
     // PiAiAdapter.modelOf 读 modelErrors.get 时以 TypeError 打崩。

package/src/resolve-dsh.ts

@@ -19,7 +19,7 @@
  * 模型条目字段集同样现场推导（official-surface.ts）。生效版本只用于状态行显示，
  * 超出已验证区间也只是提示（kit-meta.ts），永不阻断。
  *
- * 0.1.2-alpha 线的新面（0.1.2-alpha.2 复核包根仍未导出、仅 src 子路径有）：
+ * 仅 src 子路径导出、包根不导出的两块面：
  * - resolveProfiles（config.ts）：官方解析链，dev 布局树可经 src 子路径复用；
  * - credentialStoreFrom/authContextFrom（auth.ts）：PiAiAdapter 必需 auth 注入。
  * npm 发布形态（lib/index.js 单 bundle + 无 src/）两者都拿不到：dsh 树优先
@@ -76,7 +76,7 @@ import { type ResolverDeps, resolveProfilesFallback } from './profiles.ts'
 
 /**
  * deepseek 适配器模块表面（可选）：dsh-llm-deepseek 的官方 DeepSeekAdapter
- * 与目录解析器 + 匿名用户 id。缺失（旧版 dsh 树或形状漂移）不拖垮核心
+ * 与目录解析器 + 匿名用户 id。缺失（形状漂移）不拖垮核心
  * 套件——deepseek 类 route 在构建期以明确错误拒绝，pi 路由不受影响。
  * 与核心套件强制同源（杜绝跨源模块混用：brand/LlmError 恒等性敏感）。
  */
@@ -161,8 +161,8 @@ function assertKitShape(kit: DshKit, origin: string): void {
   const problems: string[] = []
   if (typeof kit.PiAiAdapter !== 'function') problems.push('PiAiAdapter 不是类')
   else {
-    // 0.1.2-alpha.2 的 LlmAdapter 抽象面：prepareCall/providerRetryPolicy 为
-    // master 适配器必需 override；models.getModels/getModel 语义未变
+    // LlmAdapter 抽象面：prepareCall/providerRetryPolicy 为适配器必需 override；
+    // models.getModels/getModel 语义
     // （pi-ai 0.84.2 Models.getModel(provider,id)/getModels(provider)，
     // 由同源 adapter 内部消费，本插件不直调）。
     for (const method of [

package/src/service.ts

@@ -1,8 +1,8 @@
 /**
  * 运行时主逻辑：注册/热更新/发现（逐点对齐官方 dsh-llm-pi-ai apply 的模式）。
  *
- * - profiles 回调按原始 config 对象 identity 备忘；配置变更经 0.1.7
- *   volatile 原位提交（loader/volatile-update 换代快照）传播，下一请求生效
+ * - profiles 回调按原始 config 对象 identity 备忘；配置变更经 volatile 原位提交
+ *   （loader/volatile-update 换代快照）传播，下一请求生效
  *   （adapter 快照按 profiles identity 失效）；
  * - route 集或注册时捕获的事实（displayName/retryPolicy）变化 → 原子的
  *   handle.replace 重注册；写入被校验拒绝时保留旧注册（官方同款护栏）；
@@ -201,8 +201,8 @@ function createAdapter(options: {
     profiles,
     resolveApiKey: makeResolveApiKey(ctx, kit),
     resolveAttachments: () => ctx.get('attachments'),
-    // 0.1.2-alpha.2 必需（包根仍未导出官方 auth 助手）：登录/OAuth 类 provider 与
-    // pi-ai 自有凭据写入的落点。dsh 树 dev 布局（src/auth.ts 存在）时为官方助手，
+    // 官方 auth 助手只在 src 子路径导出：登录/OAuth 类 provider 与 pi-ai 自有
+    // 凭据写入的落点。dsh 树 dev 布局（src/auth.ts 存在）时为官方助手，
     // 其余形态为内联等价实现（resolve-dsh.ts 探测，见 auth-inline.ts）。
     auth: {
       credentials: kit.auth.credentialStoreFrom(ctx),
@@ -372,7 +372,7 @@ export async function startRuntime(
 ): Promise<LlmPiRuntime> {
   const logger = ctx.logger('llm-pi')
   // cordis 行级 config 可能未经 schema 解析（insert 行无 config 键时为原始空对象），
-  // 在此统一规范化；0.1.7 loader 解析出的 volatile 活动字段形态直接透传
+  // 在此统一规范化；loader 解析出的 volatile 活动字段形态直接透传
   // （hasVolatileRefs 辨识——重复校验会把引用再包一层、破坏 loader 原位提交）。
   const fields: LlmPiConfigFields = hasVolatileRefs(rawConfig)
     ? (rawConfig as LlmPiConfigFields)
@@ -434,7 +434,7 @@ export async function startRuntime(
   ensureDirectory()
   void copyWriter.ensureOfficialCopy()
 
-  // 0.1.7 替代 installSection（validate/setSource/onChange 三钩子）：
+  // 替代 installSection（validate/setSource/onChange 三钩子）：
   // - 活动引用原位提交 → volatile-update 触发快照换代与重注册（原 onChange 体）；
   // - internal/config waterfall 承接写入校验（原 validate；官方 llm-pi-ai
   //   同款）：configEditor.edit 落盘前先跑 waterfall，handler throw 即拒绝整笔写入。