dsh-client-connection-authz

DeepSeek Harness 0.1.0-rc.x 内置 connection 的完整替代包。它保留官方 HTTP、共享/独立 RPC、WebSocket 和浏览器 client 行为，并在所有远程入口前 增加一个由外部插件提供的 ConnectionRequestAuthorizer。

设计

本包的 bundle patch 做两件事：

1. 用 id + name 双重匹配禁用内置 @deepseek-ai/dsh-client-connection；如果上游改名，patch 会显式告警而不会 误伤复用该 id 的其它插件。
2. 插入 @dsh-external/dsh-client-connection-authz，并强制注入 connectionRequestAuthorizer。认证插件缺失或配置失败时，connection 不会以 匿名模式降级启动。

浏览器 bundle 来自官方 @deepseek-ai/dsh-client-connection（跟随 package.json 声明的依赖范围），构建时只替换模块表 id；脚本校验唯一 id 出现次数防止静默漂移， 不校验上游精确版本。Host 源码基于 DeepSeek Harness commit 47f943859bef60e4160492346772ded9b24f765a，来源见 NOTICE.md。

授权接口

interface ConnectionRequestAuthorizer {
  authorize(facts: ConnectionRequestFacts):
    | { allowed: true; principal: ConnectionPrincipal }
    | { allowed: false; status: 401 | 403 }
}

facts 包含 transport、channel、endpoint、headers、TCP peer address，以及目标 要求的 authority：

• trusted-host：普通 API、普通 RPC 和两个 WebSocket downlink。
• loopback：设置、凭据、宿主文件操作等特权 API；认证插件只有显式授予更高权限 才能让远程调用通过。

执行顺序固定为：Host/Origin/DNS-rebinding fence → 本地回环判断 → 外部 authorizer → body 读取/协议升级/业务 handler。有效本地旁路必须同时满足回环 Host 和回环 TCP peer；远端仅伪造 Host: 127.0.0.1 仍会进入 authorizer。共享 RPC 会在 授权前把 handler 与 authority 快照为同一 target，避免授权后切换 interceptor 的 时序绕过。

浏览器侧不再用页面 hostname 预先否决 Host-authority 界面。替换 bundle 会让既有 connection.isLoopback 消费者尝试配置、凭据、宿主文件等特权 RPC；这不是授权结论， 每个请求仍必须通过上述 Host fence 与外部 authorizer。没有 admin capability 的远程 身份只能得到 403，拥有 admin capability 的身份才会到达业务 handler。

安装

这个包故意不能单独启用；profile 还必须安装一个提供 authorizer 的认证包。例如与 dsh-auth-tailscale 一起安装：

gh auth setup-git
dsh plugin --profile web add \
  git+https://github.com/sperictao/dsh-client-connection-authz.git \
  git+https://github.com/sperictao/dsh-auth-tailscale.git

两个仓库目前是 private；上面的已验证路径使用当前 gh 登录为 Git 配置 HTTPS 凭据。也可以改用已配置公钥的 SSH URL。

开发

pnpm install
pnpm check

测试覆盖 HTTP、共享/独立 RPC、WebSocket、特权 authority、回环 Host 伪造和既有 trust fence。pnpm build 生成并校验官方浏览器 bundle。

兼容范围

依赖声明（package.json 的 ^0.1.0-rc.8 等）是本包与 dsh 版本兼容性的唯一事实 来源：范围语义承诺该包在任何满足范围的 dsh 版本下工作。升级 dsh 到新 rc 时， 本包的依赖范围随 ^ 自动覆盖（npm 预发布语义下 ^0.1.0-rc.8 匹配 0.1.1-rc.1 等后续 rc）；只有当上游 d.ts 出现 breaking change 时才需要改代码， 此时 bump 本包版本并把依赖范围同步到新下限。不能用锁死确切版本的方式"防漂移"—— 那只会让 pnpm 在 profile 里解出版本裂缝（rc.6 插件 + rc.8 核心的 boot 崩溃 就是这么来的）。