前言¶
在 DeepSeek Harness（DSH）里做多模型、多账号切换时，常见做法是在核心外再挂一层代理网关，或把各家 Provider 的 OAuth、额度读取和请求适配硬写进业务代码。账号一多，登录态、模型目录和额度状态就容易各管各的，和 DSH 本身的命令、模型选择也对不齐。
Dockyard DSH 走另一条路：作为 DSH 的原生 bundle/plugin，把多个官方 OAuth 与本机会话接到同一个账号池和 runtime 上，命令、模型选择和 LLM 生成都读同一套状态，不必另起网关，也不把 Provider 逻辑塞进 DSH 核心。下面介绍它是什么、能做什么，以及怎样安装和使用。
这是什么¶
Dockyard DSH（aitabby/dockyard-dsh）由 AITabby 维护，在 SkillHub 社区目录中归类为 admin-security。仓库描述为：面向 DeepSeek Harness 的原生账号池与 Provider 插件；package.json 中标注为 macOS-only native account-pool and provider plugin，当前版本 0.1.1，许可证 MIT。
它解决的核心问题是：在 DSH 内统一管理多家 Provider 的账号、实时模型目录、额度状态，并通过 provider-native 请求链路发起调用。若对应官方客户端、CLI 或 OAuth 源未安装、未登录，Dockyard 会返回明确的 unavailable/degraded 状态，不会用硬编码账号、模型或额度伪造可用结果。
当前包含的 Provider 模块（据 GitHub README）：
- Codex — 官方浏览器 OAuth、CLI fallback、原生 Responses 请求链路
- Antigravity — Google 官方浏览器 OAuth、本机会话、实时模型目录、额度/credits、原生 Gemini SSE
- Grok — xAI 官方浏览器 OAuth、CLI fallback、实时模型目录、官方 Build credits 周期、provider-native streaming
- Claude — 官方浏览器 OAuth（支持带 state 的手动回调）、CLI fallback、原生请求适配
- Cursor — 官方浏览器登录轮询、CLI fallback、原生请求适配
核心功能¶
账号池与 Provider 管理¶
在运行中的 DSH profile 里，通过 /dockyard 命令管理账号和 Provider。点击「登录添加账号」会打开对应 Provider 的官方浏览器授权页，选择账号后安全导入账号池；Provider 不可用时保留 CLI fallback。
扫描本机已有官方登录态与新增账号是两个独立操作：已有账号不会被「新增」静默重复导入。
账号池策略与实时状态¶
支持手动选择、sticky session、round-robin 和 failover 等账号池策略。模型目录、推理档位、套餐和额度窗口均从 Provider 实时读取；所有命令、模型选择和 LLM 生成都走同一个 Dockyard runtime，不维护第二套账号池或额度缓存。
平台与发布状态¶
README 写明当前为 Developer preview。macOS 已提供通用 DMG 下载；Windows EXE 已完成构建，正在上传到 v0.1.1 Release。
macOS 完整功能依赖 Keychain 凭据存储、DSH GUI 打开的浏览器 OAuth（PKCE、state 校验、loopback/manual-code 回调），以及扫描 Cursor、Antigravity 等桌面端或本机 CLI 会话。非 macOS 默认 credential store 会 fail closed，不会静默退回不安全的内存存储。
安装与启用¶
插件以当前 dsh 进程权限运行，安装前应查看仓库源码与 MIT 许可证，并阅读 SECURITY.md，勿向 issue 提交 token 或敏感日志。
方式一：安装到已有 DSH Web profile（推荐）¶
需先安装 DSH CLI，并确认 dsh 可用。上游要求 Node 22.19+ 的 22.x，或 Node 24+；当前 bundle 已按 @deepseek-ai/dsh@0.1.0-rc.6 验证。
npm install --global @deepseek-ai/dsh
npm install --global pnpm
dsh --version
pnpm --version
web 是 DSH 自带的完整 Web profile；不要新建只含 Dockyard bundle 的空 profile，否则不会启动 Web GUI。
dsh plugin --profile web add github:AITabby/dockyard-dsh
dsh web
默认访问 http://127.0.0.1:3080。首次启动可先检查组合配置：
dsh web --dump-config
如需固定版本，可 pin 到已验证的 commit：
dsh plugin --profile web add github:AITabby/dockyard-dsh#<commit-sha>
方式二：macOS 独立 DMG¶
若不想手动安装 Node.js、pnpm 或 DSH，可下载自带完整运行时的 macOS 通用 DMG（Apple Silicon 与 Intel）。DMG 内置 Node.js、DSH CLI、完整 web profile 和 Dockyard 插件；OAuth 授权页由系统默认浏览器打开。当前为本地 ad-hoc 签名的开发预览。
下载地址见 GitHub Releases。
方式三：克隆后本地安装¶
需要改源码时使用：
git clone https://github.com/AITabby/dockyard-dsh.git
cd dockyard-dsh
npm install
npm test # 可选
npm run build # 修改 source 或 bundle 过期时需要
dsh plugin --profile web add .
dsh web
隔离测试、不影响默认 DSH home：
DSH_HOME=/tmp/dockyard-dsh-home dsh plugin --profile web add .
DSH_HOME=/tmp/dockyard-dsh-home dsh web
典型用法¶
DSH 内命令¶
在运行中的 DSH profile 中：
/dockyard status
/dockyard scan [provider]
/dockyard add [provider] [candidateId]
/dockyard login <provider>
/dockyard refresh [provider]
/dockyard models <provider>
/dockyard policy <provider> <manual|sticky_session|round_robin|failover> [accountId]
/dockyard use <provider> <accountId>
/dockyard remove <provider> <accountId>
新增与导入账号¶
先做浏览器 OAuth 新增：执行 /dockyard login <provider>，在官方授权页完成登录。若要导入本机已有登录态，则先 /dockyard scan <provider>，再 /dockyard add <provider>，最后用 /dockyard status 和 /dockyard models <provider> 核对实时状态。
Codex、Antigravity、Grok、Claude、Cursor 的「登录添加账号」默认由 DSH 打开官方浏览器授权页，不要求本机先装 CLI；CLI 仅作兼容性 fallback。Antigravity 的 Google OAuth 需在启动 DSH 的 shell 中设置 DOCKYARD_ANTIGRAVITY_CLIENT_ID 与 DOCKYARD_ANTIGRAVITY_CLIENT_SECRET，仓库不内置凭据。
适用场景与注意¶
适合谁： 已在用或准备用 DSH 做智能体/Web 对话，且需要在同一界面管理 Codex、Antigravity、Grok、Claude、Cursor 等多家官方账号与模型的开发者。尤其适合 macOS 用户：Keychain、浏览器 OAuth 与桌面端会话扫描是完整体验的前提。
安全边界： 原始 OAuth/token 不写入 Git、账号池快照或页面状态；refresh token 持久化在安全凭据存储中，支持 refresh 的 Provider 会在重启后自动刷新短期 access token。额度、模型、套餐在 Provider 不返回时保持 unknown/null。
已知限制：
- DSH 仍处于 developer preview，上游可能有 breaking changes
- Provider 的 CLI 路径、OAuth 字段和额度接口可能变化；Dockyard 对缺失字段保持未知
- Windows EXE 上传与验证完成前，不宜用于 Windows 生产环境
- Antigravity 浏览器授权需自行配置官方 OAuth client 信息
SkillHub 社区目录与 DeepSeek / 幻方无官方从属关系，属于 DSH「一切皆插件」生态下的独立收录站点。
结尾¶
Dockyard DSH 把多 Provider 的官方 OAuth、本机会话和原生请求收进 DSH 内的一个账号池与 runtime，用 /dockyard 完成登录、扫描、策略与模型查看，避免再维护一套代理或重复缓存。macOS 用户可直接用 DMG 或 dsh plugin --profile web add 接入；使用前请对照 README 核对平台与发布状态。
