本文由本站基于该插件已收录的字段自动派生（wiki / faq / compatibility_json / readme），非 AI 即时创作。每节末尾标源字段。

快速上手

dockyard-dsh

— 源: plugin_wiki.wiki_content

安装与验证

dsh plugin --profile web add github:AITabby/dockyard-dsh

复制以上命令在 DSH Web Profile 内运行。安装完成后在「插件列表」启用即可。

— 源: plugins.install

关键要点

• Codex — 官方浏览器 OAuth、CLI fallback 和原生 Responses 请求链路。
• Antigravity — Google 官方浏览器 OAuth、官方本机会话、实时模型目录、额度/credits 和原生 Gemini SSE 请求链路。
• Grok — xAI 官方浏览器 OAuth、CLI fallback、实时模型目录、官方 Build credits 周期和 provider-native streaming 请求。额度读取使用官方 /billing?format=credits（转发 GetGrokCreditsConfig）；若上游只返回周期，剩余值保持未知。
• Claude — Claude 官方浏览器 OAuth（支持带 state 的手动回调地址/授权码）、CLI fallback 与原生请求适配。
• Cursor — Cursor 官方浏览器登录轮询、CLI fallback 与原生请求适配。

— 源: plugin_wiki.readme_zh (fallback readme_raw)

常见问题

dockyard-dsh 是给 DSH 加新模型 API 还是给 DSH 加账号池?

加账号池。它把多个官方 OAuth 官方客户端会话接到同一个共享 runtime,在 DSH 内部按账号选择策略请求,不会替换 DSH 自带的核心。

安装到哪个 DSH profile 才会有 GUI?

安装到 DSH 自带的 web profile 才能看到 Dockyard 提供的账号/额度界面;新建空 profile 不会启动 Web GUI。

Antigravity 浏览器授权为什么报缺 client 信息?

Antigravity 用的是 Google loopback OAuth,需要 DOCKYARD_ANTIGRAVITY_CLIENT_ID 和 DOCKYARD_ANTIGRAVITY_CLIENT_SECRET,这两个变量不在仓库里,需在启动 DSH 的 shell 里自己设置。

macOS 以外的平台能用吗?

DSH 本身是 web host,跨平台;但凭据默认存 macOS Keychain,在非 macOS 上默认凭据存储会 fail closed,需要宿主 DSH Credentials 服务接管,否则 token 无法持久化。

数据保存在哪里,卸载是否干净?

账号策略与账号元数据写到 ~/.dockyard-dsh/state.json,OAuth token 写在 macOS Keychain 或宿主 DSH Credentials。卸载后删除 state.json 与 Keychain 中 com.dockyard-dsh.credentials 服务即可。

— 源: plugin_wiki.faq_json

兼容性

• DSH: 0.1.0-rc.6+
• Node: >=22.19.0 (22.x) || >=24.0.0
• Platforms: macOS, Windows(未验证), Linux(受限,需宿主凭据服务)
• Native modules: macOS Keychain Swift helper(/usr/bin/swift), Python3 pty 模块(Antigravity CLI fallback)

— 源: plugin_wiki.compatibility_json

踩坑提醒

安装前请审阅上游仓库；本指南基于已收录字段自动派生，可能滞后于最新版本。如发现与官方文档冲突，请以上游为准。

— 来源：通用规则