dsh-composer-ux 0.1.3 → 0.1.5

package/CHANGELOG.md

@@ -2,6 +2,23 @@
 
 本项目遵循 [语义化版本](https://semver.org/lang/zh-CN/)。
 
+## [0.1.5] — 2026-09-13
+
+### 新增
+- **按 baseURL 识别 OpenCode 路由**：自动匹配（「作用路由」留空）原先只看路由名是否以 `opencode` 开头，因此自建别名路由（例如 `go: { baseURL: https://opencode.ai/zen/go/v1 }`）拿不到请求头。现在改为「名字前缀 **或** baseURL 主机是 `opencode.ai`（含子域）」两者取或——内置 `opencode-go` 仍走名字那条（它的 baseURL 由 pi-ai 目录内置，配置里读不到），自建别名走 URL 那条。
+- 仿冒主机不匹配：`https://opencode.ai.evil.example/v1` 若只做子串判断会误伤，因此改为解析 URL 后比较主机名（解析失败才退回子串）。
+- 设置页「作用路由」的说明与占位符同步更新；无命中时「状态」行会写出实际的匹配规则。
+
+### 测试
+- `test/host-header-mirror.mjs` 新增 3 组（9 项）：按 URL 命中别名路由 / 子域命中 / 非 OpenCode 路由不动 / 仿冒主机不写入 / 显式名单优先 / URL 非法时子串回退。**35 passed, 0 failed**。
+
+## [0.1.4] — 2026-09-13
+
+### 文档
+- **安装一节精简为两条命令**（安装 / 更新），GitHub 源码安装、锁定 commit、本地目录开发等做法收进折叠块——README 页面不再一上来就是四条命令。
+- 移除 README 里的本机绝对路径，改为占位符，别人可以直接照抄。
+- 功能代码无改动（`lib/` 与 0.1.3 一致），26 项宿主行为测试全绿。
+
 ## [0.1.3] — 2026-09-13
 
 ### 变更

package/README.md

@@ -20,23 +20,33 @@ DeepSeek Harness Web 输入体验增强插件：
 
 ## 安装
 
-本插件按官方「[打包与安装插件](https://deepseek-harness.github.io/deepseek-harness/develop/basic/publish)」规范打包为可安装**组合包**（bundle）：`package.json` 声明 `dsh.bundle.patch → ./cordis.patch.yml`，该层以**包名**插入插件行 `dsh-composer-ux`，装进 profile 后由 pnpm/Node 从 `node_modules` 解析到 `lib/index.js`。
-
 ```sh
-# npm 安装（推荐）：已是预构建产物，没有构建脚本，安装时不会在本地执行任何代码
-dsh plugin --profile <你的 profile> add dsh-composer-ux
+# 安装
+dsh plugin --profile web add dsh-composer-ux
+
+# 更新到最新版
+dsh plugin --profile web update dsh-composer-ux
+```
+
+npm 包：[dsh-composer-ux](https://www.npmjs.com/package/dsh-composer-ux) —— 预构建产物，安装期不在本地执行任何代码，也不需要 pnpm 的构建授权。（`--profile web` 换成你自己的 profile 名即可。）
 
+<details>
+<summary>其它安装方式（GitHub 源码 / 锁定 commit / 本地目录）</summary>
+
+```sh
 # 从 GitHub 安装（等价；lib/ 构建产物已提交，没有 prepare 脚本，因此不需要 pnpm 的构建授权）
-dsh plugin --profile <你的 profile> add github:fangwen9527/dsh-composer-ux
+dsh plugin --profile web add github:fangwen9527/dsh-composer-ux
 
 # 锁定 commit 安装（更安全：后续推送无法悄悄改变实际运行的内容）
-dsh plugin --profile <你的 profile> add github:fangwen9527/dsh-composer-ux#<commit-sha>
+dsh plugin --profile web add github:fangwen9527/dsh-composer-ux#<commit-sha>
 
-# 本地目录安装（开发用，等价于 link）
-dsh plugin --profile <你的 profile> add D:/1zcode/dsh插件/输入体验
+# 本地目录 / 源码开发（等价于 link；改完 src/ 先跑 node build.mjs）
+dsh plugin --profile web add <你克隆或解压出来的目录>
 ```
 
-npm 包：<https://www.npmjs.com/package/dsh-composer-ux>（`repository` 指回本仓库，市场据此关联下载量）。
+本插件按官方「[打包与安装插件](https://deepseek-harness.github.io/deepseek-harness/develop/basic/publish)」规范打包为可安装**组合包**（bundle）：`package.json` 声明 `dsh.bundle.patch → ./cordis.patch.yml`，该层以**包名**插入插件行 `dsh-composer-ux`，装进 profile 后由 pnpm/Node 从 `node_modules` 解析到 `lib/index.js`。
+
+</details>
 
 装完按 DSH 提示重启一次（Host 半的插件代码只在进程启动时 import），客户端半刷新页面即生效。
 
@@ -66,7 +76,10 @@ OpenCode 的接口要求客户端在每次请求里带上一个稳定的会话 I
 - **设置页位置**：设置 → 输入体验 → 「OpenCode 请求头」（折叠栏目）：开关 / 头名 / 值 / 作用路由，附一行宿主半回写的「状态」。
 - **落点**：`llm-pi-ai` 的 provider profile —— `providers.<路由>.headers.<头名>`。这是 DSH 里唯一受支持的出网请求头入口：它作为 pi-ai 的 `optionsHeaders` **最后合并**（能覆盖默认头），且该适配器每次请求都重读配置，所以改完**下一次请求即生效**，不用重启、不用手工改 `settings.yaml`。
 - **写入方式**：`settings.mutate` 的路径寻址——只动我们那一个键，绝不重述或删除你写在同一个 profile 里的其它字段（`models` / `apiKeyEnv` / 其它 headers 都不碰）。
-- **只写已存在的路由**：profile 的 `models` 是必填项，凭空造一个只有 headers 的路由会让整份配置校验失败；所以「作用路由」留空时只匹配 `providers` 里以 `opencode` 开头的路由，显式写了名单也只保留其中**已存在**的。
+- **目标路由怎么选**：profile 的 `models` 是必填项，凭空造一个只有 headers 的路由会让整份配置校验失败，所以只写**已存在**的路由。判据：
+  - 「作用路由」**留空**时自动匹配——路由名以 `opencode` 开头（DSH 内置的 `opencode-go` 走这条，它的 baseURL 由 pi-ai 目录内置、配置里读不到），**或**该路由的 `baseURL` 主机是 `opencode.ai`（含子域）。后一条是为自建别名路由准备的：例如把 OpenCode 端点配成 `go: { baseURL: https://opencode.ai/zen/go/v1 }`，名字里没有 opencode 也能被认出来。
+  - 「作用路由」**填了名单**时只看名单（逗号或空格分隔），且只保留其中确实存在的路由。
+  - 判据只看主机名：`https://opencode.ai.evil.example/v1` 这类仿冒主机不会被匹配。
 - **撤销**：关栏目开关、关插件总开关、或改头名，都会自动清掉此前写入的那一个键；并且只清「值等于当前配置值或记账值」的，用户自己手写的同名头不会被误删。
 - **值**：所有对话共用同一个值（栏目里可改、可「重新生成」）；第一次启用若留空，会自动生成一个 UUID 并保存沿用。OpenCode 文档原话是要「每段对话」一个 ID——按会话变化的头 DSH 的配置层做不到（`llm/stream` 钩子被设计成只能读不能改，`GenerateOptions` 里没有 `headers` 字段），所以这里退一步用固定值。已知代价：所有对话挤同一个上游（没有负载分散）；单段对话内的缓存命中不受影响。另外它**不保证**缓存一定命中（还取决于上游模型与网关策略）。
 - **自校验**：写入前用与 llm-pi-ai 相同的规则（`new Headers()`）校验头名与头值；非法值被拒绝，原因写进栏目的「状态」行，而不是把整条路由弄坏。
@@ -77,7 +90,7 @@ OpenCode 的接口要求客户端在每次请求里带上一个稳定的会话 I
 
 ## 结构
 
-项目根目录：`D:\1zcode\dsh插件\输入体验\`（构建产物与被挂载的 `cordis.patch.yml` 都在这里）。
+仓库根目录（克隆或解压出来即是）：
 
 ```
 dsh-composer-ux/
@@ -117,16 +130,16 @@ $env:DSH_REPO_PATH='D:/DeepSeek Harness'; node build.mjs
 ## 加载（从 DSH 源码检出）
 
 ```sh
-cd D:\DeepSeek Harness
-pnpm dsh web --patch D:/1zcode/dsh插件/输入体验/cordis.dev.patch.yml
+cd <你的 DeepSeek Harness 检出目录>
+pnpm dsh web --patch <本仓库的绝对路径>/cordis.dev.patch.yml
 ```
 
-替换为你的真实路径即可；插件行的 `name` 必须是 `file:///` 形式的绝对 URL（Windows 下 `D:/...` 裸路径无法被 ESM loader 导入）。该文件只在本机存在（已 gitignore），内容如下：
+把尖括号替换成你的真实路径；插件行的 `name` 必须是 `file:///` 形式的绝对 URL（Windows 下 `D:/...` 裸路径无法被 ESM loader 导入）。该文件只在本机存在（已 gitignore），内容如下：
 
 ```yaml
 - insert:
     - id: composer-ux
-      name: 'file:///D:/1zcode/dsh插件/输入体验/lib/index.js'
+      name: 'file:///<本仓库的绝对路径>/lib/index.js'
 ```
 
 ## 开发时热更新

package/lib/client.js

@@ -1487,9 +1487,9 @@ function SettingsSection({ useLive, actions }) {
           TextFieldRow,
           {
             title: "\u4F5C\u7528\u8DEF\u7531",
-            desc: "\u9017\u53F7\u6216\u7A7A\u683C\u5206\u9694\uFF1B\u7559\u7A7A = \u81EA\u52A8\u5339\u914D opencode \u7CFB\u8DEF\u7531",
+            desc: "\u9017\u53F7\u6216\u7A7A\u683C\u5206\u9694\uFF1B\u7559\u7A7A = \u81EA\u52A8\u5339\u914D OpenCode \u8DEF\u7531\uFF08\u540D\u5B57\u4EE5 opencode \u5F00\u5934\uFF0C\u6216 baseURL \u6307\u5411 opencode.ai\uFF09",
             value: settings.headerRoutes,
-            placeholder: "\u7559\u7A7A = \u81EA\u52A8\uFF08opencode*\uFF09",
+            placeholder: "\u7559\u7A7A = \u81EA\u52A8\uFF08opencode* \u6216 opencode.ai \u7AEF\u70B9\uFF09",
             maxLength: HEADER_VALUE_MAX,
             onChange: (next) => {
               actions.setField(HEADER_ROUTES_FIELD, next);