dsh-api-gateway
DeepSeek Harness 的开源插件：一个经过身份验证、故障关闭的回环代理，将 harness /api 接口（apiproxy）暴露给远程客户端。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:litestartup-com/dsh-api-gateway#f454788d5d22440972b47ce421966c7a400de36bApi Gateway 以 dsh-api-gateway 发布，当前版本为 0.2.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
点击下方 Badge 复制 Markdown，粘贴到 README 即可。
验证 package.json 声明的 GitHub 仓库，即可管理这个公开页面。认领后，Hub 会优先安排当前版本的安全扫描，并在通过后公开展示结果。
认领这个 Plugin →DeepSeek Harness 宿主插件：一个带鉴权、fail-closed 的 loopback 反向代理，把宿主机自身的
/api 面（apiproxy = dsh-client-connection + dsh-host-apiproxy）暴露给另一台机器上的客户端
（典型：dsh-agent-manager）。
v0.2.0 起（S3）：插件不再自己驱动 agent。会话、消息、问答、授权全部由宿主的 apiproxy 处理， 插件只做三件事：鉴权、白名单、透传。
DSH 的 /api 只认 loopback（Host 头栅栏不是鉴权，跨机直连 :3080 不可行也不安全）。
本插件跑在 DSH 进程内，内部 fetch 天然走 loopback，对外靠 API Key 鉴权 + 白名单保护。
dsh plugin --profile web add github:litestartup-com/dsh-api-gateway
在宿主组合加一行（见 examples/cordis.yml），重启 DSH。
| 字段 | 默认 | 说明 |
|---|---|---|
prefix | /api-gw/v1 | 路由前缀 |
enabled | true | 主开关（可 admin 运行时切换） |
apiKeys | [] | 静态 API 密钥 |
provisionedKey | — | POST {prefix}/key 一次性自助发放的密钥（存 settings） |
allowKeyProvision | true | 允许首次无钥自助发放 |
adminKey | — | 设置后启用 admin 端点 |
corsOrigin | * | CORS 来源（'*' 或具体域/数组） |
exposeErrors | true | 错误响应是否带内部细节 |
proxyTarget | http://127.0.0.1:3080/api | 上游 /api 基础地址 |
proxyWhitelist | 默认白名单 | 可选：覆盖默认白名单 |
| 方法 | 路径 | 鉴权 |
|---|---|---|
| GET | {prefix}/health | 无 |
| POST | {prefix}/key | 首次无钥（一次性自助发放） |
| POST | {prefix}/admin/enable | X-Admin-Key |
| POST | {prefix}/admin/rotate-key | X-Admin-Key |
| POST | {prefix}/proxy/<method> | X-API-Key / Bearer |
| POST | {prefix}/proxy/respond | X-API-Key / Bearer |
| GET | {prefix}/events.mux（WebSocket 升级） | X-API-Key |
同一 mux 升级路径也注册在 {prefix}/proxy/events.mux，使客户端「base + method」的统一约定
（manager 的 rpc base 即 /api-gw/v1/proxy）无需为 mux 特判。
mux 管道下行只读：客户端发任何帧都被 1008 关闭（与宿主 mux 行为一致）。断线重连是客户端的事。
session.list, session.create, session.history,
session.prompt, session.cancel, session.rename,
session.fork, session.updateQueue, session.attachment,
session.models, session.selectModel,
respond, host.describe
白名单外 → 403 { error: 'method_not_allowed' }，不发往上游。特权面
（credentials.*、settings.*、host.openPath、host.pickDirectory、llm.discoverModels 等）
在代理上不可达。注意：真实方法名是 host.describe（host.version 不存在）。
apiKeys/adminKey 在 settings 线上 surface 脱敏。pnpm build && pnpm test（42 测试全绿；lib/ 必须同步提交）。dsh plugin update（或 profiles/web 下 pnpm install）。GET {prefix}/health → 200，upstream: ok。POST {prefix}/proxy/credentials.set（带正确 key）→ 403 method_not_allowed。POST {prefix}/proxy/session.list 用错 key → 401。POST {prefix}/proxy/host.describe 返回 DSH 版本；session.list 返回会话列表。ws://host{prefix}/proxy/events.mux（握手带 X-API-Key），
session.prompt 后应实时收到 session/event 帧直到 turn/end。自动化验收：本仓库 scripts/proxy-host.mjs（独立验收宿主）+
dsh-agent-manager/scripts/smoke-proxy-b.ts（manager 走 proxy 路径的端到端冒烟）。
删除组合里的插件行（可选 dsh plugin remove dsh-api-gateway），重启。
MIT