# Changelog ## 2.0.2 — 2026-10-02 **修复：`link:` 安装（插件页安装 / 本地链接）时插件在 DSH 0.2.0-rc.2 上完全不显示。** - fix(manifest): `@deepseek-ai/schemastery` 由 `dependencies` 移到 **`peerDependencies`**（`devDependencies` 保留一份用于本地构建/类型检查）。Host 半的 `dist/host.js` 把它作为外部依赖保留，而 DSH 对 **linked root** 形式的 profile 插件只在「导入方自己的 `package.json` 把该名字声明为 peer」的 `node_modules` 位置上做运行时重定向（`packages/boot/app-boot/src/profile-resolution/resolver.ts` 的 `routeLinked`）。改名前它是普通 dependency，插件目录一旦没有自己的 `node_modules` （`link:` 安装不会装依赖），该 import 就落到 Node 原生解析并抛 `ERR_MODULE_NOT_FOUND: Cannot find package '@deepseek-ai/schemastery'`。 - **故障表现**：Host 半 import 失败 → Loader 行没有 fiber → `ClientModuleRegistry` 不生成该客户端行 → 设置页里没有「模型 Ultra」这一条，**且宿主把该失败写进 stderr 而不显示**（桌面端只缓存 host stderr）， 所以表现为「静默不显示」。`@deepseek-ai/dsh-typert-protocol` 一直是 peer，所以只有它没出问题。 - fix: 版本号 2.0.1 → 2.0.2。dist 无需重新构建（只改了清单声明），重新安装或重启 DSH 后生效。 - test: 新增三个可复跑的验证脚本（见 `DESKTOP-VERIFY.md` §3）： `verify-linked-import.mjs`（用 DSH 自己的 `PluginPackages` 拦截 + 真实 ESM import 对比修复前后）、 `verify-linked-peer-routing.mjs`（断言「Host 束里每个 `@deepseek-ai/*` 外部名都必须是声明的 peer」）、 `verify-plugin-native-resolution.mjs`（证明插件目录下原生 ESM 解析失败，即必须依赖 DSH 重定向）。 ## 2.0.1 — 2026-09-29 **修复 token 预算输入框排版，并把「思考强度」与聊天框自带模型选择器的关系说清楚。** - fix(ui): 「思考强度」页的四个 token 预算输入框不再复用 `.mpro-hdrRow`（那是「标签 + 输入 + 按钮」的 3 列固定栅格），改用新的 `.mpro-budgetRow` 弹性换行行，每个预算都带 `minimal/low/medium/high` 标签； 此前多出的输入框会落到隐式栅格轨道上，间距被拉开、最后一个甚至溢出面板。 - feat(thinking): 每个模型卡片新增「**聊天框 Effort 可选**」预览，直接显示保存后 DSH 聊天框模型选择器里 会出现哪些档位、默认选中哪一个；自定义但未勾选任何档位时提示「保存等于删除字段（回到继承）」。 - feat(thinking): 手写模型（`models[i]`）没有声明档位、却设置了路由级「默认等级」时，卡片上出现「无档位」 告警并说明后果 —— 这种组合下选择器不显示 Effort，请求还会被 `UNSUPPORTED_REASONING_EFFORT` 拒绝。 - docs: 页首说明与 README 增补档位如何从 `reasoningEfforts` 流到选择器（`resolveModelReasoning` → `PiAiAdapter.modelInfo` → `session/modelCatalog` → Effort 一栏）、三条硬规则，以及「改完即生效、无需重启」。 - test: 客户端冒烟新增大纲断言（说明区块、逐模型预览、无档位告警、预设提示）。 - fix(build): `scripts/build.mjs` 在 esbuild 服务进程被拒（受限环境下的 `spawn EPERM`）时回退到平台二进制直连构建， 使 `npm run build` / `prepare` / `prepublishOnly` 在受限沙箱与硬化容器里同样可用；回退路径会把中间产物 `dist/client.raw.js` 删掉，避免它被 `files: ["dist"]` 一起打进发布包。 - chore: 发布包纳入 `CHANGELOG.md`（`files` 白名单），本地 `npm pack` 产物 `*.tgz` 加入 `.gitignore`。 ## 2.0.0 — 2026-09-29 **重命名：`dsh-model-pro` → `dsh-model-ultra`（显示名「模型 Pro」→「模型 Ultra」）** - break!: 包名 `dsh-model-pro` → **`dsh-model-ultra`**；设置页本地化标题改为「模型 Ultra」/ `Model Ultra`， 描述同步更新（思考强度、OpenRouter 已并入描述）。旧安装不会自动接管：请卸载旧包后重新安装新包。 - break!: 入口 id 与设置条目 `dsh-model-pro` → **`dsh-model-ultra`**（`cordis.patch.yml`），因此 `disabledProviders` / `routes` / `composites` / `routeStats` / `uiPrefs` / `openrouter` 的存放位置随之改变； 客户端 bundle id、`settings.dsh-model-ultra` 命名空间、UI 偏好存储键同步更名。 - refactor: 远程服务命名空间 `modelPro` → **`modelUltra`**，类型/组件随之更名 （`ModelUltraRuntime`、`ModelUltraPage`、`ModelUltraCtx`）。 - refactor: 构建期不再硬编码包名——`scripts/build.mjs` 与 `__ModuleLoader__` 包装步骤都从 `package.json` 读取 `name`，避免再次更名时漏改。 - docs: README 全面重写（目录、兼容性、逐项功能、安装/卸载、快速上手、原理、项目结构、开发与验证、排错、 致谢与许可），并移除所有本地绝对路径示例。 - meta: 仓库地址指向 `MrCashmere/dsh-model-ultra`；`author` 保留原作者署名，LICENSE 追加本项目版权行。 - 保留：界面 CSS 类前缀 `mpro-`（纯内部样式作用域）与内部超时哨兵 `__mpro_attempt_timeout__`，不参与 持久化与对外契约，故未随更名调整。 ## 1.3.0 — 2026-09-29 新增两块能力：**逐模型思考强度编辑**与 **OpenRouter 提供商路由（移植 `dsh-openrouter-providers` 全部功能）**。 RPC 由 25 个增加到 **30 个**，插件设置条目新增一个 volatile 状态键 `openrouter`。 **思考强度（Thinking effort）** - feat(thinking): 「思考强度」新页签。**路由级**编辑 `reasoning`（默认等级）、`thinkingBudgets` （minimal/low/medium/high 四个 token 预算）与思考相关 `compat`（`thinkingFormat`、 `thinkingTokenBudgetField`、`supportsReasoningEffort`、`supportsThinkingTokenBudget`、 `requiresThinkingAsText`、`forceAdaptiveThinking`），三态下拉的「继承」= 不写该字段。 - feat(thinking): **逐模型**编辑 `reasoningEfforts`——每个档位一个勾选 + **手动填写线上取值**的文本框， 另附每个档位的**预设值按钮**与整表**一键预设**（两档 / 四档 / 五档 / 全七档 / 非推理）。显式 `models` 列表的提供商写回 `models[i]`；**内置目录路由写 `modelOverrides[id]`，绝不把目录收窄成 `models` 列表**。 - fix(thinking): 归一化同时实施 llm-pi-ai `resolveModelReasoning()` 自己的解析规则（该规则不在 schema 里）： 只有 `off` 档可以留空（`off:` → `null`），其余档位必须有线上取值、不得为空串；`{off: null}` 单独一项 非法（非推理请用 `false`）；空对象按「删除=继承目录」处理而不是写入空字典。这样页面上永远无法保存 一个 DSH 解析时会报错的配置。 - fix(thinking): 未知档位键、部分填写的 `thinkingBudgets`、路由级/模型级字段混用都会返回具名错误， 被拒绝的补丁不会落到配置里。 **OpenRouter 提供商路由（对齐 `dsh-openrouter-providers` v1.3.0）** - feat(openrouter): 新「OpenRouter」页签：总开关、路由模式（`only` / `order`）、提供商 slug 列表 （每行一个，兼容换行 / 逗号 / 中文逗号 / 分号等分隔）、量化位数限制（12 级 + 不限制）、 生效主机列表、应用归属头开关与 `X-OpenRouter-Title`；保存 / 撤销 / 未保存标记 / 自检读数（塑形器状态、 计数、将写入的 `provider` 对象）。 - feat(openrouter): 注入实现为 **`globalThis.fetch` 塑形器**：只改「配置主机 + POST/PUT/PATCH + JSON 且含 `model`」的请求体，把 `provider.only` / `provider.order` / `provider.quantizations` **合并**进已有的 `provider` 对象（参考实现是整体替换，这里更保守），并补发 `HTTP-Referer` / `X-OpenRouter-Title` / `X-OpenRouter-Categories`。任何异常（解析失败、未知 init 形状、无状态）都原样放行、绝不抛给调用方； `dispose()` 仅在仍是自己时还原全局 `fetch`，插件卸载后立即失效。 - feat(openrouter): 状态**每次请求实时读取**（不缓存），改完即对下一次请求生效，无需重启。 - feat(openrouter): 「导入旧插件配置」按钮：按 `$DSH_HOME/openrouter-providers.json` → `/.dsh-plugins/openrouter-providers.json` → `$DSH_HOME/settings.yaml.imported` 顺序探测， 第一个含可识别字段的源生效，结果逐源报告（imported / empty / missing / error / unsupported）。 - 与参考插件的**有意差异**：① 不再复刻 `node -e` 子进程 SSE 桥（`0.2.0-rc.1` 的 pi-ai 已原生支持 OpenRouter，旧桥只是因为早期动态插件沙箱没有 `fetch`）；② 不再把 `OPENROUTER_API_KEY` 写进 `env`；③ `provider` 对象为合并语义；④ 总开关关闭时**同时不发归属头**（关掉就是完全不碰流量）。 - feat(host): 新增 5 个 RPC：`set-thinking`、`get-openrouter`、`set-openrouter`、`import-openrouter`、 `openrouter-selftest`；`get-provider` 增补 `reasoning` / `thinkingBudgets` / `compat` / `modelOverrides`。 **文档与测试** - test: `tests/host.smoke.mjs` 新增思考强度（路由级 / `models` / `modelOverrides` / 归一化拒绝路径）与 OpenRouter（状态、两种模式、量化、归属头、惰性、遗留导入 JSON + YAML、自检、卸载还原 `fetch`）用例； 用例经 manifest 的调用 id 驱动，覆盖 30 个方法。 - test: `tests/client.smoke.mjs` 渲染并驱动两个新页签，断言保存时发出的 RPC 载荷。 - test: 新增 `.tools/verify/verify-openrouter-injection.mjs`（真实 `openai@6.40.0` SDK + 本地 SSE 端点： 构造时机捕获、`only/order` 极性、量化、归属头、流式透明、惰性态逐字节不变、卸载还原）与 `.tools/verify/verify-thinking-schema.mjs`（用运行时树里真实的 `@deepseek-ai/dsh-llm-pi-ai` `Config` 校验页面写出的 profile，并断言 schema 无法表达的解析规则仍存在于编译产物中）。 ## 1.2.0 — 2026-09-20 适配 **DeepSeek Harness `0.2.0-rc.1`**（含 **Desktop 桌面形态**）。下列「BREAKING/适配」条目都是 `0.2.0-rc.1` 的契约变更所致，旧版 DSH 不再受支持。 **BREAKING / 契约适配** - fix(typert)!: 严格编解码器改为 `{ mode: 'strict', typeSymbol, create() }`（旧 `schema:` 字段会让注册抛出 `typert: strict codec has no create() factory`）；manifest 同时更新为 25 个方法。 - fix(settings)!: `settings` 服务不再提供 `get(ns)`。改为 `describe()` 读取，且**读 `user`（原始配置）而非 `value`**——`value` 经 owner schema 解析后会丢掉 `apiKeyEnc` / `disabled` 等提供商私有键。 - fix(settings)!: 设置写入只允许 volatile 路径，`llm-pi-ai` 只声明了 `providers`。因此本插件自己的状态 （`disabledProviders` / `routes` / `composites` / `routeStats` / `uiPrefs`）改存到**插件自己的设置条目** `dsh-model-ultra`：新增 `src/host/config.ts`（schemastery，全部 `.volatile()`）并由 Host 半导出 `Config`。 写入统一走 `settings.replace()` 的**全量快照**；提供商/禁用字典「先加后删」分两次写，避免失败时丢配置。 - fix(host): 监听 `settings/document-updated`（旧事件名 `settings/updated` 不再触发），重装/乱序加载时的 禁用提供商重新停用逻辑恢复正常。 - fix(host): `ctx.get('logger')` → `ctx.logger`（logger 是 Cordis 上下文属性，不是服务）。 - fix(client)!: `conversation.chat.turnTail` 是 **list 座位**，注册项不再接受（也不再被传入）`select`； 回合窗口由组件自己从座位 owner props 推导（`selectTurnSelection`）。 - fix(client): 会话时间的正确来源是 `useChat` 提供的 chat 视图快照 （`snapshot.timeline.turns` / `snapshot.legacy.turnTimings`），旧代码只读 `snapshot.chat.*`，导致精确窗口 静默退化为粗窗口、相邻回合互相“抢/丢”日志（“有时候有有时候没有”）。 - fix(client): 自定义样式改为带 `data-plugin` 的 `