Preface¶
The philosophy of DeepSeek Harness (DSH) is “everything is a plugin.” When integrating Google Antigravity (agy) into DSH, common tasks include OAuth login, multi-account management, account rotation after rate limiting, device fingerprinting, and proxy configuration. dsh-agy encapsulates these capabilities into plugins, offering both Web and CLI management interfaces.
Below is an introduction organized by installation, usage, and notes.
What is This¶
dsh-agy is a DeepSeek Harness plugin for Google Antigravity (agy), maintained by chaos-03x under the MIT license. It provides OAuth authentication, multi-account pools, 429 rotation, device fingerprinting, and supports both CLI and Web management.
Core Features¶
- OAuth Login: Supports browser callback, headless URL pasting, and credential blob channels.
- Web & CLI: Two management interfaces with consistent core functionality.
- Multi-Account Pool: Encrypted account storage, usage-aware selection, automatic rotation on rate limits, per-account cooldown, and per-account device fingerprinting.
- DSH Web Runtime: Enables login, account management, per-model quotas, model testing, credential import/export, and fingerprint management in the
/agypanel. - CLI: Can run in standalone environments with or without the harness.
- Proxy: Individual proxy configuration per account.
- Environment Variables: Options to disable the plugin, switch fingerprint modes, and set background health check intervals.
Installation and Enabling¶
Web Method¶
First, install the plugin to DSH’s web profile:
dsh plugin --profile web add dsh-agy
Then start DSH Web:
dsh web
Open the /agy panel:
http://127.0.0.1:3080/agy
Click “Login with Google” to complete OAuth authorization.
CLI Method¶
If you don’t want to install globally, you can run directly:
npx dsh-agy login
npx dsh-agy status
Or install globally:
npm install -g dsh-agy
Then use:
dsh-agy login
dsh-agy status
dsh-agy verify
dsh-agy health
dsh-agy import <file>
dsh-agy logout
Typical Usage¶
Account Proxy¶
Each account can have an individual proxy configured:
dsh-agy proxy set --index 0 --proxy <url>
dsh-agy proxy clear --index 0
dsh-agy proxy test --index 0
Per-account proxy ignores NO_PROXY. If the proxy is unreachable, the account is skipped and affinity is cleared; loopback addresses force a direct connection.
Rate Limiting and Error Handling¶
429 responses are handled based on type:
soft_rate_limit: Immediate retry.rate_limited: Cooldown and switch accounts.quota_exhausted: Cooldown until the actual reset time.unknown: Exponential backoff.
401 / 403 marks the account as requiring re-authentication.
Risk Control¶
DSH_AGY_DISABLE=1 is a kill switch: the plugin does not register the provider or /agy routes, and the CLI refuses to run.
Uninstallation¶
If no longer using the Web plugin:
dsh plugin --profile web remove dsh-agy
If no longer using the global CLI:
npm uninstall -g dsh-agy
Use Cases and Notes¶
Suitable for developers who need to manage multiple agy accounts in DSH using the Web panel or CLI.
Usage Notes:
- The plugin runs with the current DSH process permissions; review the source code and license before installation.
- The quota dashboard is only active when DSH Web is running.
- Deleting local files does not revoke Google-side authorization; refresh tokens remain valid until expiration or manual revocation.
- Local development requires Node >= 22;
package.jsonengines specify node >=20.18.1; the minimum runtime requirement should be confirmed based on the actual environment. - The community directory is an independent site with no official affiliation with DeepSeek / High-Flyer.
Get the Project¶
Directory Page: https://www.skillhub.cn/plugins/chaos-03x/dsh-agy
GitHub: https://github.com/chaos-03x/dsh-agy