dsh-agy-link 0.5.0 → 0.5.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +40 -0
- package/README.md +84 -17
- package/dist/client.js +540 -128
- package/dist/index.js +28 -5
- package/docs/CONFIGURATION.md +110 -0
- package/docs/README.en.md +17 -7
- package/docs/README.es.md +16 -6
- package/docs/README.pt-BR.md +16 -6
- package/docs/assets/console.png +0 -0
- package/docs/assets/model-picker.png +0 -0
- package/docs/assets/settings.png +0 -0
- package/package.json +1 -1
- package/docs/assets/dashboard.png +0 -0
package/CHANGELOG.md
CHANGED
|
@@ -1,5 +1,45 @@
|
|
|
1
1
|
# Changelog
|
|
2
2
|
|
|
3
|
+
## 0.5.2 (2026-11-04)
|
|
4
|
+
|
|
5
|
+
### English
|
|
6
|
+
|
|
7
|
+
- **Fix(client/translate): the translation card is a native DSH surface.** It read as a foreign banner inside a transcript: a blue→purple→pink gradient fill, a gradient border with a top-right bloom, a gradient wordmark and a "Translated by Gemini" footer stacked on a second header row - all in saturated brand colour. It now follows the host's own tool-card recipe: a 0.5px hairline (`--dsw-alias-border-l1`), the markdown code-block fill, a 12px radius and a code-block-banner header. Identity is reduced to one monochrome spark plus the localized 「Gemini 译文」 label (the spark takes the DSH accent token); model/effort ride the header as caption meta; copy / show-original / collapse share one flat action group that wraps as a unit, so a narrow panel truncates the meta instead of splitting the buttons.
|
|
8
|
+
- **Feat(client/settings): pick the translation model and effort from the Auto-translate row.** Both were config-file/env-only, so changing how the translation call runs meant editing settings and restarting. Two native dropdowns now sit on the right of that row and write through the existing `POST /config`; the empty value still means "let the host decide". Layout measured rather than guessed: at the 640px panel the toggle plus both selects stay on ONE line (label absorbs the shrink) and the description wraps; below 680px the selects stretch to share the line.
|
|
9
|
+
- **Fix(client): the console can no longer flash while scrolling.** The 0.4.72 flicker fix added two compositing hints while chasing that symptom - `contain: content` on the panel and `transform: translateZ(0)`. Both are themselves Chromium traps here: paint containment on an ancestor of a scrolling subtree makes the compositor drop and rebuild the backing layer mid-scroll, and a forced layer over a translucent fixed backdrop re-composites the whole panel per frame. A 640px panel needs neither; plain `overflow: hidden` already clips it, and the decorative shimmer loses its `will-change`. Two isolation holes are closed too: wheel/touch over any part of the overlay that is not its own scroller (header, padding, the dim itself) no longer leaks to the transcript behind, and the same applies while the console is open on phone-width. Reported flash: **gone** on the reporter's machine.
|
|
10
|
+
- A temporary Alt+Shift+F render probe used to bisect that flash was removed before this release.
|
|
11
|
+
|
|
12
|
+
### 中文
|
|
13
|
+
|
|
14
|
+
- **修复(client/translate):译文卡片改成 DSH 原生表面。** 之前它在会话里像个"外来的横幅":蓝→紫→粉渐变底、带左上光晕的渐变边框、渐变字标,再加一行"Translated by Gemini"页脚压在第二个标题行上,全是高饱和品牌色。现在照抄宿主自己的工具卡片配方:`--dsw-alias-border-l1` 发丝线、markdown 代码块底色、12px 圆角、代码块横幅式表头。身份只剩一枚单色星形 + 本地化的「Gemini 译文」标签(星形取 DSH accent 令牌);模型/档位降级为表头 caption 元信息;复制 / 看原文 / 折叠合并成一组扁平操作,按整体换行——面板窄时先截断元信息,而不是把按钮拆开。
|
|
15
|
+
- **新增(client/settings):在"自动翻译"那一行直接选翻译模型与档位。** 这两个原本只能改配置文件/环境变量,改一次就要重启。现在该行右侧是两个原生下拉(走既有的 `POST /config`),空值仍表示"交给宿主决定"。布局是按实测定的:640px 面板下开关 + 两个下拉保持**一行**(靠标签列收缩吸收),描述换行;680px 以下下拉按行均分。
|
|
16
|
+
- **修复(client):控制台滚动时不再闪屏。** 0.4.72 的防闪补丁为了追同一个症状加了两个合成提示——面板上的 `contain: content` 与 `transform: translateZ(0)`——它们在这里本身就是 Chromium 的坑:滚动子树祖先上的 paint containment 会让合成器在滚动中途丢弃并重建 backing layer;而半透明固定背板上的强制图层会每帧重合成整个面板。640px 面板两者都不需要,`overflow: hidden` 本来就裁得干净,装饰光晕也去掉了 `will-change`。同时补上两个隔离漏洞:覆盖层内任何**非自身滚动区**(表头、内边距、遮罩本体)上的滚轮/触摸不再漏给后面的会话;手机宽度下控制台打开时同理。报告者的闪屏:**已消失**。
|
|
17
|
+
- 发布前移除了用于二分定位该闪屏的临时 Alt+Shift+F 渲染探针。
|
|
18
|
+
|
|
19
|
+
### Full Changelog
|
|
20
|
+
|
|
21
|
+
https://github.com/amlyczz/dsh-agy-link/compare/v0.5.1...v0.5.2
|
|
22
|
+
|
|
23
|
+
## 0.5.1 (2026-11-04)
|
|
24
|
+
|
|
25
|
+
### English
|
|
26
|
+
|
|
27
|
+
- **Feat(client): the translation card is a Gemini surface now, not a generic notice.** The card carries the official four-point spark filled with Google's brand gradient (`#4285F4 → #9B72CB → #D96570`), the gradient wordmark, a hairline brand border with a soft top-right bloom, and a "Translated by Gemini" attribution line. Copy and the original-text toggle move onto pill buttons, and the per-reply action glyph reuses the same gradient spark, so the affordance reads as Gemini before you hover. Every colour is an rgba overlay or a DSH token, so the card holds up in both themes, and each render mints its own gradient id so several cards can coexist.
|
|
28
|
+
- **Fix(client): the reply action settles even when the panel remounts mid-flight.** The chat timeline re-creates the transcript whenever a card lands in it, so the instance that started a translation could be gone before the promise resolved — its `setState` was a no-op and the spinner never stopped. Action state is now published to every mounted instance (`setActionState` / `subscribeActionState`) and `ACTION_INFLIGHT` alone decides `working`, so the surviving instance settles to `done`; the durable-record lookup still keeps a finished card `done` across reloads and session switches.
|
|
29
|
+
- **Fix(client): the hover hint can no longer leak as body text.** The tooltip node now carries the `.agy-tsl-tip` class that owns its bubble styling, and `showTip()` repairs a node left behind by an older build (class plus `position: fixed`) before showing it. A missing stylesheet now degrades to "no hint", never to a stray line under the action strip.
|
|
30
|
+
- **Fix(host): a bound translation explains the reply it was given, not one it remembers.** With `translateBindConversation` the host used to send the raw source text on every turn, which left the model free to answer from an earlier turn it had seen. Each turn now sends `buildTranslationRequest()` — an explicit "current turn's reply" instruction plus the source — while the persona still goes out once per conversation. The prompt also stopped being a style contract: unpack jargon before moving on, keep conclusions and conditions, and never compress a long answer into a verdict.
|
|
31
|
+
- **Docs: README rewritten for 0.5.x.** One file with Chinese and English, refreshed pt-BR / es / en standalone pages, a dedicated Console and settings section (header badge, account card, runtime note, pool scheduling, auto-warmup, auto translate, effort, model visibility), a complete [configuration reference](docs/CONFIGURATION.md), and re-captured screenshots (console, model picker, settings) with mailbox and alias redaction.
|
|
32
|
+
|
|
33
|
+
### 中文
|
|
34
|
+
|
|
35
|
+
- **新增(client):翻译卡片改成 Gemini 专属外观,不再是一张通用提示条。** 卡片带官方的四点星标(用 Google 品牌渐变 `#4285F4 → #9B72CB → #D96570` 填充)、渐变字标、品牌细描边与右上柔光,底部有「Translated by Gemini」署名;复制与原文对照换成胶囊按钮,回复动作条上的图标复用同一枚渐变星标,光标移上去之前就认得出是 Gemini。所有颜色都是 rgba 叠加或 DSH 令牌,深浅主题都成立;每次渲染各自生成渐变 id,多张卡片可以共存。
|
|
36
|
+
- **修复(client):面板中途重挂载时,回复动作也能收尾。** 聊天气泡里一有新卡片落地,DSH 就会重建时间线,发起翻译的那个实例可能在 Promise 完成前就没了——它的 `setState` 是空操作,转圈永远不停。现在状态通过 `setActionState` / `subscribeActionState` 广播给所有已挂载实例,`working` 只看 `ACTION_INFLIGHT`,于是活下来的那个实例能落到 `done`;跨刷新、跨会话仍由持久化记录把已完成的卡片保持在 `done`。
|
|
37
|
+
- **修复(client):悬停提示不会再漏成正文。** 提示节点现在带上负责气泡样式的 `.agy-tsl-tip` 类,`showTip()` 还会先修复旧构建遗留的节点(补类名与 `position: fixed`)。样式表缺失时最坏只是「没有提示」,不会在动作条下面多出一行字。
|
|
38
|
+
- **修复(host):绑定会话里的翻译只讲这一轮给的回复,不去翻历史。** 开了 `translateBindConversation` 时,以前每轮只发原文,模型可能拿它记住的上一轮来答。现在每轮都发 `buildTranslationRequest()`——明确「当前这一轮 AI 回复」再加上原文,人格仍然每条会话只发一次。提示词也不再是风格契约:先解释术语再往下讲,结论与条件必须留着,别把长回答压成一句结论。
|
|
39
|
+
- **文档:README 按 0.5.x 重写。** 单文件中英双语,pt-BR / es / en 三份独立页同步,新增「控制台与设置」一节(顶栏徽标、账号卡片、运行方式、号池调度、周额度预热、自动翻译、思考强度、模型显示),补上完整的[配置参考](docs/CONFIGURATION.md),并重拍了截图(控制台、模型选择器、设置页),邮箱与别名已打码。
|
|
40
|
+
|
|
41
|
+
**Full Changelog**: https://github.com/amlyczz/dsh-agy-link/compare/v0.5.0...v0.5.1
|
|
42
|
+
|
|
3
43
|
## 0.5.0 (2026-11-03)
|
|
4
44
|
|
|
5
45
|
### English
|
package/README.md
CHANGED
|
@@ -9,6 +9,7 @@
|
|
|
9
9
|
<a href="https://github.com/amlyczz/dsh-agy-link/actions/workflows/ci.yml"><img src="https://github.com/amlyczz/dsh-agy-link/actions/workflows/ci.yml/badge.svg" alt="CI"/></a>
|
|
10
10
|
<img src="https://img.shields.io/badge/license-MIT-lightgrey" alt="MIT"/>
|
|
11
11
|
<img src="https://img.shields.io/badge/node-%3E%3D24-green" alt="node"/>
|
|
12
|
+
<img src="https://img.shields.io/badge/agy-v0.5.1-purple" alt="agy v0.5.1"/>
|
|
12
13
|
</p>
|
|
13
14
|
|
|
14
15
|
<p align="center">
|
|
@@ -17,7 +18,8 @@
|
|
|
17
18
|
<a href="#english">English</a> ·
|
|
18
19
|
<a href="./docs/README.pt-BR.md">Português (Brasil)</a> ·
|
|
19
20
|
<a href="./docs/README.es.md">Español</a> ·
|
|
20
|
-
<a href="./docs/README.en.md">English (standalone)</a>
|
|
21
|
+
<a href="./docs/README.en.md">English (standalone)</a> ·
|
|
22
|
+
<a href="./docs/CONFIGURATION.md">完整配置文档</a>
|
|
21
23
|
</p>
|
|
22
24
|
|
|
23
25
|
---
|
|
@@ -27,9 +29,12 @@
|
|
|
27
29
|
把 **Google Antigravity 模型接入 DeepSeek Harness(DSH)** —— 支持**多账号智能池化轮换**、**官方多 Bucket 配额监控(5小时滚动 + 7天周额度 + Argon 独立周池)**、**浏览器免粘贴一键登录**与**浅色/深色主题高对比度自适应**,由官方未修改的 `agy` CLI 驱动,完整支持流式输出、思考折叠(thinking)、原生工具卡片与精确 token 用量。
|
|
28
30
|
|
|
29
31
|
<p align="center">
|
|
30
|
-
<img src="./docs/assets/
|
|
32
|
+
<img src="./docs/assets/console.png" alt="Antigravity 管理控制台 - 多账号池化与配额监控" width="760" />
|
|
33
|
+
</p>
|
|
34
|
+
<p align="center">
|
|
35
|
+
<img src="./docs/assets/model-picker.png" alt="DSH 模型选择器中的 Antigravity 模型列表" width="280" />
|
|
31
36
|
|
|
32
|
-
<img src="./docs/assets/
|
|
37
|
+
<img src="./docs/assets/settings.png" alt="DSH 设置 → 插件中的 Antigravity 设置面板" width="540" />
|
|
33
38
|
</p>
|
|
34
39
|
<p align="center">
|
|
35
40
|
<img src="./docs/assets/token-usage.png" alt="原生上下文缓存与 Token 用量统计" width="340" />
|
|
@@ -65,6 +70,9 @@
|
|
|
65
70
|
- 🔀 **手动切换当前账号 (Manual Switch-Active)**:控制台卡片一键「设为当前使用」,即刻把调度指针钉到指定账号。
|
|
66
71
|
- 🔑 **GUI 内浏览器免粘贴登录 (In-GUI Zero-Paste OAuth)**:点击「➕ 添加账号」自动调起系统浏览器,本地回环监听自动捕获授权凭证,**全程无需手动复制粘贴授权码**。
|
|
67
72
|
- 🎨 **多主题高对比度自适应 (Light & Dark Themes)**:原生适配 DSH 浅色/深色主题,告别发暗发灰与看不清文字,UI 视觉清晰锐利。
|
|
73
|
+
- 📱 **手机 Web 端响应式自适应 (Mobile Web)**:控制台在屏幕宽度小于 680px 时自动变为全屏抽屉面板(`100dvh`),标签与开关控件折行重排,配额条独占单行,操作按钮等宽网格分布,并在多尺寸设备(360×800、390×844、768×1024)实测无横向溢出。
|
|
74
|
+
- 🗣 **DSH 原生大白话翻译卡片 (`/tsl`)**:卡片沿用 DSH 自己的观感(0.5px 细描边、markdown 代码块底色、12px 圆角、横幅表头),只用一枚单色 Gemini 星标 + 「Gemini 译文」标签标明出处,深浅主题全由 DSH 令牌决定,不再是一块品牌渐变横幅;每个 DSH 会话绑定独立翻译会话(`<sessionId>#tsl`),仅首轮注入人格,后续仅传指令行,共享主号池与故障转移。
|
|
75
|
+
- 🧠 **思考强度自适应学习 (Effort Learning)**:当模型拒绝 `--effort` 参数时,自动无 effort 原样重放确保轮次完成,持久化记录至本地文件并自动收回该机型的档位声明,避免后续重复报错。
|
|
68
76
|
- 🌐 **独立账号网络代理 (Per-Account Proxy)**:支持为每个账号独立绑定 HTTP(S) / SOCKS 代理,避免多账号同 IP 引起风控;未显式配置时自动探测系统代理(macOS `scutil` / Windows 注册表 / Linux gsettings)。
|
|
69
77
|
- ⚡ **分模型族独立冷却 (Family-Scoped Cooldown)**:Gemini、Claude、GPT-OSS 与 Argon 的速率限制独立计算,某个模型族受限不影响其他模型族正常调用。
|
|
70
78
|
|
|
@@ -84,17 +92,21 @@
|
|
|
84
92
|
| 🔑 **浏览器一键登录** | 点击添加账号自动唤起 Google 授权页,本地回环自动捕获,全程无需复制粘贴任何代码 |
|
|
85
93
|
| 🔀 **手动切换当前账号** | 控制台「设为当前使用」按钮即刻钉住调度指针;顶部徽标始终显示服务器实际调度的账号 |
|
|
86
94
|
| 🎨 **多主题高对比 UI** | 浅色、深色主题自适应变色,纯矢量 SVG 图标(无 Emoji),字迹清晰不发暗 |
|
|
95
|
+
| 📱 **手机 Web 端自适应** | 屏幕宽度 < 680px 时控制台自动转为全屏抽屉面板(`100dvh`),标签开关折行重排,操作按钮等宽网格分布,全面适配触屏滚动 |
|
|
87
96
|
| 🌐 **独立账号代理** | 每个账号支持独立配置 HTTP(S) 代理,隔离 IP 出口;亦可自动探测系统代理 |
|
|
88
|
-
| 🔌 **原生模型路由** | 在 DSH 模型配置中注册 `antigravity` 提供方,`/model`
|
|
97
|
+
| 🔌 **原生模型路由** | 在 DSH 模型配置中注册 `antigravity` 提供方,`/model` 选择器以 `Antigravity (agy CLI)` 分组随心切换 Gemini / Claude / GPT-OSS / Argon |
|
|
89
98
|
| 🌊 **完整流式映射** | 文本、思考过程(thinking turn)与工具活动均无损映射到 DSH 原生流协议 |
|
|
90
|
-
| 🃏 **原生工具卡片** | agy 执行的终端命令(`run_command`)、文件修改(inline diff)均以 DSH
|
|
99
|
+
| 🃏 **原生工具卡片** | agy 执行的终端命令(`run_command`)、文件修改(inline diff)均以 DSH 原生卡片渲染;MCP 元工具(`call_mcp_tool`)自动拆包为 Terminal/Search 卡片 |
|
|
91
100
|
| 🔗 **会话上下文保真** | DSH 会话与 agy 原生会话绑定(`--conversation`),由 agy 管理完整历史,每轮仅发送增量 |
|
|
92
101
|
| 🎯 **DSH 目标与计划集成** | 长任务自动携带 DSH goal / plan 上下文,工具续跑不丢任务状态 |
|
|
93
102
|
| 📊 **精确 Token 统计** | 输入 / 输出 / 思考 / 缓存读取 token 完整计入 DSH 用量统计,全面适配 1M 上下文 |
|
|
94
|
-
| 🎛 **顶部控制台徽标** | 顶部栏 `AGY (n)` 徽标一键弹出控制台,直观查看账号池、配额进度条与代理状态 |
|
|
103
|
+
| 🎛 **顶部控制台徽标** | 顶部栏 `AGY · 别名` / `AGY (n)` 徽标一键弹出控制台,直观查看账号池、配额进度条与代理状态 |
|
|
95
104
|
| 🖼 **图片多模态** | 支持多模态图片传入,自动落盘本地媒体目录并通过 `--add-dir` 安全授权给 agy 查看 |
|
|
96
105
|
| 🤝 **`agy_ask` 辅助工具** | 允许任意 DSH 模型把单次任务委托给 Antigravity 模型(AskAntigravity 协作模式) |
|
|
106
|
+
| 🧠 **思考强度自适应学习** | 模型若拒绝 `--effort`,自动无 effort 原样重放并记录至本地,后续自动收回档位声明,杜绝重复报错 |
|
|
107
|
+
| 🗣 **`/tsl` 大白话翻译** | DSH 原生卡片锚定在回复下方,会话 1:1 独立绑定复用;支持 `/tsl` 命令、自动翻译开关(设置页同一行可选**翻译模型**与**思考档**下拉框)及回复快捷按钮「译成人话」 |
|
|
97
108
|
| ⌨️ **`/agy` 快捷命令族** | `status` / `pool` / `auth` / `models` / `mode` / `effort` / `workspace` / `goal` / `session` / `enable-account` / `disable-account` / `clear` / `doctor` / `help` |
|
|
109
|
+
|
|
98
110
|
---
|
|
99
111
|
|
|
100
112
|
## 📋 前置要求
|
|
@@ -103,7 +115,7 @@
|
|
|
103
115
|
|
|
104
116
|
| 前置项 | 说明 / 验证方式 |
|
|
105
117
|
| --- | --- |
|
|
106
|
-
| **1. 系统网络代理** | **【必须开启】**(推荐开启 Clash / Surge / v2rayA 的 TUN 模式或设置 `HTTPS_PROXY` 环境变量,确保可流畅连接 Google 服务) |
|
|
118
|
+
| **1. 系统网络代理** | **【必须开启】**(推荐开启 Clash / Surge / v2rayA / Sing-box 的 TUN 模式或设置 `HTTPS_PROXY` 环境变量,确保可流畅连接 Google 服务) |
|
|
107
119
|
| **2. DeepSeek Harness (DSH)** | 你正在使用的 DSH 客户端;`dsh --version` 可验证 |
|
|
108
120
|
| **3. Node.js ≥ 24** | DSH 依赖环境;`node --version` 验证 |
|
|
109
121
|
| **4. Google Antigravity `agy` CLI** | 按 [Google 官方安装文档](https://antigravity.google/docs/cli/install) 安装(支持 macOS / Linux / Windows)。`agy --version` 能输出版本号即表示安装成功 |
|
|
@@ -144,16 +156,46 @@ dsh plugin --profile web add dsh-agy-link
|
|
|
144
156
|
| --- | --- | --- | --- |
|
|
145
157
|
| `enabled` | `DSH_AGY_ENABLED` | `true` | 插件主开关 |
|
|
146
158
|
| `agyBin` | `DSH_AGY_BIN` | 自动探测 | 显式指定 `agy` 二进制路径 |
|
|
147
|
-
| `permissionMode` | `DSH_AGY_MODE` | `skip` | 权限模式:`skip`(无人值守执行)/ `plan` / `accept-edits
|
|
159
|
+
| `permissionMode` | `DSH_AGY_MODE` | `skip` | 权限模式:`skip`(无人值守执行)/ `plan` / `accept-edits`。设置面板已固定为 `skip`;`plan` / `accept-edits` 仍可用配置或 `DSH_AGY_MODE` 覆盖(例如无头运行) |
|
|
148
160
|
| `defaultModel` | `DSH_AGY_DEFAULT_MODEL` | `(agy 默认)` | 默认模型 slug |
|
|
149
161
|
| `defaultEffort` | `DSH_AGY_DEFAULT_EFFORT` | `high` | 思考预算:`low` / `medium` / `high`(`auto` = 各模型自身默认)。设置面板「默认思考强度」可直接切换;它只是会话**模型下拉框**的初始档位,仍可在该下拉框里按模型覆盖(与 agy 的等级一一对应) |
|
|
150
162
|
| `hiddenModels` | `DSH_AGY_HIDDEN_MODELS` | `[]` | 在 `/model` 选择器中隐藏的模型 slug 列表(黑名单语义,新模型默认可见;建议直接在设置面板"模型显示"中点选管理) |
|
|
151
163
|
| `timeoutMs` | `DSH_AGY_TIMEOUT_MS` | `600000` | 单轮活跃看门狗超时(毫秒) |
|
|
152
164
|
| `longToolIdleMinutes` | `DSH_AGY_LONG_TOOL_IDLE_MINUTES` | `240` | 存在未完成工具步骤(ACTIVE)时的空闲预算(分钟);`0` = 不抬高预算,卡死的工具按 `timeoutMs` 快速失败 |
|
|
153
165
|
| `workspaceRoot` | `DSH_AGY_WORKSPACE_ROOT` | 会话 cwd | agy 工作区根目录(默认跟随当前会话工作区) |
|
|
166
|
+
| `proxyUrl` | `DSH_AGY_PROXY_URL` | 空字符串 | 全局代理 URL;若在控制台中单独配置了代理,优先使用账号独立代理 |
|
|
154
167
|
| `suppressAgyAutoUpdate` | `DSH_AGY_SUPPRESS_AUTOUPDATE` | Windows `true`,其他平台 `false` | 每次 spawn 前刷新 agy 的更新检查时间戳,阻断 `--bg-updater` 子进程链(Windows 闪窗根因)。关闭后 agy 恢复自动更新检查 |
|
|
155
168
|
| `autoWarmup` | `DSH_AGY_AUTO_WARMUP` | `false` | 7 天周配额自动预热(opt-in):周额度到达重置时间或冷启动时发送极小探活请求,提前激活 7 天计时器。开启后每 5 分钟巡检一次;该路径直连 Google 内部端点,请自行评估风控风险 |
|
|
156
169
|
| `warmupModels` | `DSH_AGY_WARMUP_MODELS` | `gemini-3.8-flash,claude-sonnet-4-6` | 自动预热使用的模型列表(逗号分隔);空数组表示不自动预热 |
|
|
170
|
+
| `autoTranslate` | `DSH_AGY_AUTO_TRANSLATE` | `false` | 每轮对话完成后自动调用 `/tsl` 生成大白话翻译卡片;亦可在会话中通过 `/tsl auto on` 动态开启 |
|
|
171
|
+
| `translateModel` | `DSH_AGY_TRANSLATE_MODEL` | `gemini-3.8-flash` | `/tsl` 默认使用的翻译模型,缺失时按目录回退 |
|
|
172
|
+
| `translateEffort` | `DSH_AGY_TRANSLATE_EFFORT` | `high` | 翻译模型思考强度档位 |
|
|
173
|
+
| `translateTargetLanguage` | `DSH_AGY_TRANSLATE_LANG` | `中文(简体)` | 翻译提示词中指定的目标语言 |
|
|
174
|
+
| `translateBindConversation` | — | `true` | 每个 DSH 会话绑定一条独立的 agy 翻译会话,人格仅发送一次,后续轮次仅传请求行与原文 |
|
|
175
|
+
|
|
176
|
+
> 💡 完整配置参数清单、高级选项与环境变量映射请参见 [docs/CONFIGURATION.md](./docs/CONFIGURATION.md)。
|
|
177
|
+
|
|
178
|
+
---
|
|
179
|
+
|
|
180
|
+
## 🗣 /tsl 大白话翻译
|
|
181
|
+
|
|
182
|
+
模型输出往往偏专业、冗长或充满机器腔。`/tsl` 命令调用 Gemini 模型(默认 `gemini-3.8-flash` · `high`)将当前会话的回复重写为通俗、口语化的大白话。
|
|
183
|
+
|
|
184
|
+
```bash
|
|
185
|
+
/tsl # 翻译上一轮已完成的回复
|
|
186
|
+
/tsl 3 # 翻译指定第 3 轮回复
|
|
187
|
+
/tsl --full # 连同中间工具调用的叙述一并翻译
|
|
188
|
+
/tsl --text 任意文本… # 纯文本翻译模式(在终端直接输出,不生成卡片)
|
|
189
|
+
/tsl --model claude-sonnet-4-6 --effort medium # 临时指定翻译模型与思考强度
|
|
190
|
+
/tsl --print # 在命令执行输出中同步回显译文
|
|
191
|
+
/tsl auto on|off|status # 针对当前会话开启、关闭或查看自动翻译状态
|
|
192
|
+
```
|
|
193
|
+
|
|
194
|
+
- **DSH 原生翻译卡片**:翻译结果持久化存储于 `plugin:agy-link/translation` 会话记录中,渲染为锚定在被翻译回复正下方的原生卡片(只靠一枚单色星标 + 「Gemini 译文」标签标明出处);刷新页面或切换会话后不丢失,原文支持一键展开折叠,且卡片内容不进入模型可见历史。
|
|
195
|
+
- **快捷动作**:每条回复下方均提供「译成人话」快捷操作按钮,历史任一轮次均可按需一键翻译。
|
|
196
|
+
- **会话 1:1 独立绑定 (`translateBindConversation`)**:每个 DSH 会话对应一条独立的 agy 翻译会话(`<sessionKey>#tsl`)。首次调用注入翻译员身份、工作区与日志路径;后续翻译复用该会话,每轮仅发送指令行与原文,显著降低 Token 开销。
|
|
197
|
+
- **共享号池与自愈容错**:翻译调用走插件辅助通道,共享主账号池与冷却机制,账号额度耗尽自动故障转移至下一个可用账号;遇到空返回(`EMPTY_RESPONSE`)自动退避重试。
|
|
198
|
+
- **严格遵循用户授权**:自动翻译默认关闭(`autoTranslate: false`),可在「设置 → Antigravity」中全局开启,或在会话中通过 `/tsl auto on` 动态开启。同一行右侧的两个下拉框可分别改**翻译模型**(默认自动挑 Gemini Flash)与**翻译思考档**(默认跟随「默认思考强度」),改完即写配置、下一轮翻译生效。
|
|
157
199
|
|
|
158
200
|
---
|
|
159
201
|
|
|
@@ -164,6 +206,7 @@ dsh plugin --profile web add dsh-agy-link
|
|
|
164
206
|
3. **多 Bucket 官方配额汇总**:插件定时后台静默轮询官方 `v1internal:retrieveUserQuotaSummary`,精准掌控每个账号的 5h 滚动削峰水位、7d 账号阶梯周额度,以及付费账号的 Argon 独立周池。
|
|
165
207
|
4. **会话级无缝故障转移**:当遭遇 HTTP 429、额度耗尽或凭证异常时,号池调度器自动标记当前账号家族进入冷却(或按额度到期时间择优轮换),并无缝将后续请求路由到池内下一个有效账号。
|
|
166
208
|
5. **失败分类与自愈**:错误按 AUTH / NETWORK / RATE_LIMIT / ELIGIBILITY 等精确分类;网络抖动借由 agy 运行日志自动甄别为可重试故障,绝不误伤健康账号的登录状态。
|
|
209
|
+
6. **辅助通道隔离**:`/tsl` 翻译、会话标题生成、任务目标推导等通过独立专用辅助通道执行,共享号池与冷却机制,不占主会话绑定与工具权限。
|
|
167
210
|
|
|
168
211
|
---
|
|
169
212
|
|
|
@@ -187,6 +230,11 @@ dsh plugin --profile web add dsh-agy-link
|
|
|
187
230
|
- **开关**:`suppressAgyAutoUpdate`(环境变量 `DSH_AGY_SUPPRESS_AUTOUPDATE`)。Windows 上默认开启,其他平台默认关闭;设为 `false` 即回到 agy 原本的自动更新行为。
|
|
188
231
|
- **旧版本用户的手动 workaround**:把 `%USERPROFILE%\.gemini\antigravity-cli\updater\update.lock` 设为只读(`attrib +R ...`),agy 拿不到更新锁就会跳过检查。代价是手动 `agy update` 会报 `update already in progress`,需要先 `attrib -R`。
|
|
189
232
|
|
|
233
|
+
### 某个模型选定思考强度后提示 `--effort is not supported`?
|
|
234
|
+
部分模型(例如 Gemini Flash 系列或特定版本)并不支持 `--effort` 参数。插件具备自适应学习机制:当检测到模型拒绝 `--effort` 时,插件自动从拒绝报错中提取模型标识,立即原样重放一次不带 `--effort` 的请求,确保当前轮次对话顺利完成;同时将该模型写入 `~/.dsh/agy-link/effort-unsupported.json` 本地记录,并在后续运行时收回该模型宣称的思考强度档位,前端选择器自动隐藏该选项。学习记录可通过 `/agy status` 中的 `effortUnsupported` 字段及 `/agy doctor` 报告查阅。
|
|
235
|
+
|
|
236
|
+
### 配额进度条未及时更新?
|
|
237
|
+
配额信息由后台定时轮询(默认每小时轮询一次,可通过 `quotaPollIntervalMs` 调整)。如需即时刷新,可在控制台卡片中点击「同步」,或在输入框执行 `/agy refresh-quota`。
|
|
190
238
|
|
|
191
239
|
---
|
|
192
240
|
|
|
@@ -214,9 +262,12 @@ MIT License.
|
|
|
214
262
|
Bring **Google Antigravity models into DeepSeek Harness (DSH)** — featuring **Multi-Account Pooling & Automatic Rotation**, **Official Multi-Bucket Quota Tracking (5h Rolling + 7d Weekly + Argon Weekly Pool)**, **Zero-Paste In-GUI OAuth Login**, and **Theme-Adaptive High-Contrast UI**, powered by the official unmodified `agy` CLI.
|
|
215
263
|
|
|
216
264
|
<p align="center">
|
|
217
|
-
<img src="./docs/assets/
|
|
265
|
+
<img src="./docs/assets/console.png" alt="Antigravity Management Console - Multi-Account Pool & Quota Monitor" width="760" />
|
|
266
|
+
</p>
|
|
267
|
+
<p align="center">
|
|
268
|
+
<img src="./docs/assets/model-picker.png" alt="Antigravity Model Lineup in DSH Model Picker" width="280" />
|
|
218
269
|
|
|
219
|
-
<img src="./docs/assets/
|
|
270
|
+
<img src="./docs/assets/settings.png" alt="Antigravity Settings Panel in DSH" width="540" />
|
|
220
271
|
</p>
|
|
221
272
|
<p align="center">
|
|
222
273
|
<img src="./docs/assets/token-usage.png" alt="Native Context Caching & Token Usage Breakdown" width="340" />
|
|
@@ -251,6 +302,9 @@ Have multiple Google Antigravity / Gemini accounts? **dsh-agy-link makes multi-a
|
|
|
251
302
|
- 🔀 **Manual Switch-Active**: One click on "Set active" pins the scheduler pointer to the account you choose.
|
|
252
303
|
- 🔑 **In-GUI Zero-Paste OAuth**: One-click "Add Account" opens your browser and automatically captures OAuth tokens via local loopback — **no copying and pasting of authorization codes required**.
|
|
253
304
|
- 🎨 **Theme-Adaptive High-Contrast UI**: Seamlessly adapts to Light and Dark DSH themes with crystal clear typography and crisp contrast.
|
|
305
|
+
- 📱 **Mobile Web Responsiveness**: Below 680px width, the console modal adapts to a full-height sheet drawer (`100dvh`) with stacked labels, full-width quota bars, and equal-width button grids, tested on 360×800, 390×844, and 768×1024 viewports.
|
|
306
|
+
- 🗣 **DSH-Native Translation Card (`/tsl`)**: Plain-language explanations rendered as a native DSH card (0.5px hairline border, markdown code-block fill, 12px radius, banner header) differentiated only by a monochrome spark and a "Gemini 译文" label; light and dark themes come straight from DSH tokens instead of a brand gradient. Binds 1:1 agy translation conversation per session (`<sessionId>#tsl`).
|
|
307
|
+
- 🧠 **Effort Learning Mechanism**: Automatically learns when a model rejects `--effort`, replays the turn without effort, records the slug in `~/.dsh/agy-link/effort-unsupported.json`, and withdraws the level declarations to prevent repeated errors.
|
|
254
308
|
- 🌐 **Per-Account Proxy**: Configure dedicated HTTP(S) / SOCKS proxy for each individual account to isolate IP addresses; when unset, the system proxy is auto-detected (macOS `scutil` / Windows registry / Linux gsettings).
|
|
255
309
|
- ⚡ **Family-Scoped Cooldowns**: Gemini, Claude, GPT-OSS, and Argon rate limits are calculated independently, preventing one exhausted model from blocking others.
|
|
256
310
|
|
|
@@ -270,18 +324,20 @@ Have multiple Google Antigravity / Gemini accounts? **dsh-agy-link makes multi-a
|
|
|
270
324
|
| 🔑 **Zero-Paste Browser Login** | Automatic browser-based Google OAuth login with loopback callback handler |
|
|
271
325
|
| 🔀 **Manual Switch-Active** | Pin the scheduler to any account from the console; the header badge always names the server-scheduled account |
|
|
272
326
|
| 🎨 **Theme-Adaptive UI** | Dynamic light/dark theme switching, pure SVG vector marks (no emojis), high contrast |
|
|
327
|
+
| 📱 **Mobile Web Responsiveness** | Transitions to full-height sheet drawer (`100dvh`) below 680px, stacked labels, and equal-width button grid for touch devices |
|
|
273
328
|
| 🌐 **Per-Account Proxy** | Dedicated HTTP(S) proxy per account slot, or auto-detected system proxy |
|
|
274
|
-
| 🔌 **Native Model Routing** | Registers `antigravity` provider in DSH; choose Gemini / Claude / GPT-OSS / Argon in `/model` picker |
|
|
329
|
+
| 🔌 **Native Model Routing** | Registers `antigravity` provider in DSH; choose Gemini / Claude / GPT-OSS / Argon in `/model` picker under `Antigravity (agy CLI)` |
|
|
275
330
|
| 🌊 **Full Streaming Protocol** | Native streaming for text, thinking turn annotations, and tool calls |
|
|
276
|
-
| 🃏 **Native Tool UI Cards** | Command runs and inline diffs render as clean, native DSH tool cards |
|
|
331
|
+
| 🃏 **Native Tool UI Cards** | Command runs and inline diffs render as clean, native DSH tool cards; MCP meta-tools unwrap to Terminal/Search cards |
|
|
277
332
|
| 🔗 **Session Continuity** | Binds DSH sessions to native agy conversations (`--conversation`) for zero-redundancy context |
|
|
278
333
|
| 🎯 **DSH Goal & Plan Integration** | Long-running tasks carry DSH goal / plan context across tool continuations |
|
|
279
334
|
| 📊 **Accurate Token Metering** | Input, output, thinking, and cacheRead tokens are fully reported to DSH with 1M context support |
|
|
280
335
|
| 🎛 **Top Header Console Badge** | Click the `AGY (n)` badge in the header to instantly open the management console |
|
|
281
336
|
| 🖼 **Multimodal Images** | Stages images to local storage and passes safe absolute paths via `--add-dir` |
|
|
282
337
|
| 🤝 **`agy_ask` Delegation** | Allows other DSH models to delegate subtasks to Antigravity models |
|
|
338
|
+
| 🧠 **Effort Learning Mechanism** | Automatically learns model effort refusals, replays without `--effort`, and hides unsupported options |
|
|
339
|
+
| 🗣 **`/tsl` Plain-Language Translation** | Gemini rewrites the agent's final answer in plain language and the card is pinned under that reply (persisted in session, labelled "Gemini translation", original text preserved); `/tsl auto on` translates every new turn; the settings row carries **translation model** and **thinking effort** dropdowns |
|
|
283
340
|
| ⌨️ **`/agy` Commands** | Full command suite: `status`, `pool`, `auth`, `models`, `mode`, `effort`, `workspace`, `goal`, `session`, `enable-account`, `disable-account`, `clear`, `doctor`, `help` |
|
|
284
|
-
| 🗣 **`/tsl` Plain-Language Translation** | Gemini rewrites the agent's final answer in plain language and the card is pinned under that reply (persisted in the session, labelled "Gemini translation", original text preserved); `/tsl auto on` translates every new turn |
|
|
285
341
|
|
|
286
342
|
---
|
|
287
343
|
|
|
@@ -332,6 +388,7 @@ dsh plugin --profile web add dsh-agy-link
|
|
|
332
388
|
| `timeoutMs` | `DSH_AGY_TIMEOUT_MS` | `600000` | Activity watchdog timeout in milliseconds |
|
|
333
389
|
| `longToolIdleMinutes` | `DSH_AGY_LONG_TOOL_IDLE_MINUTES` | `240` | Idle budget while a tool step is ACTIVE (minutes); `0` keeps the normal `timeoutMs` budget so wedged tools fail fast |
|
|
334
390
|
| `workspaceRoot` | `DSH_AGY_WORKSPACE_ROOT` | session cwd | Working directory root |
|
|
391
|
+
| `proxyUrl` | `DSH_AGY_PROXY_URL` | empty string | Global proxy URL; per-account proxies configured in console take precedence |
|
|
335
392
|
| `suppressAgyAutoUpdate` | `DSH_AGY_SUPPRESS_AUTOUPDATE` | `true` on Windows, `false` elsewhere | Refreshes agy's update-check timestamp before every spawn so its `--bg-updater` child chain (the Windows console-flash root cause) never starts. `false` restores agy's own auto-update checks |
|
|
336
393
|
| `autoWarmup` | `DSH_AGY_AUTO_WARMUP` | `false` | Opt-in 7-day weekly quota warmup: sends a minimal probe when the weekly window has reset or is cold, activating the 7-day timer. Scans every 5 minutes; this path talks directly to Google's internal endpoints, so assess the risk-control tradeoff yourself |
|
|
337
394
|
| `warmupModels` | `DSH_AGY_WARMUP_MODELS` | `gemini-3.8-flash,claude-sonnet-4-6` | Model list used for warmup probes (comma-separated); an empty list disables automatic warmup |
|
|
@@ -339,7 +396,9 @@ dsh plugin --profile web add dsh-agy-link
|
|
|
339
396
|
| `translateModel` | `DSH_AGY_TRANSLATE_MODEL` | `gemini-3.8-flash` | Model used by `/tsl` and auto mode; falls back through the live catalog when absent |
|
|
340
397
|
| `translateEffort` | `DSH_AGY_TRANSLATE_EFFORT` | `high` | Reasoning effort for effort-capable translate models |
|
|
341
398
|
| `translateTargetLanguage` | `DSH_AGY_TRANSLATE_LANG` | `中文(简体)` | Target language wording in the translator prompt |
|
|
342
|
-
| `translateBindConversation` | — | `true` | Keep ONE agy conversation per DSH session for translations: the persona
|
|
399
|
+
| `translateBindConversation` | — | `true` | Keep ONE agy conversation per DSH session for translations: the persona is sent once; later translations reuse it and send only the short request line |
|
|
400
|
+
|
|
401
|
+
> 💡 For full configuration reference, see [docs/CONFIGURATION.md](./docs/CONFIGURATION.md).
|
|
343
402
|
|
|
344
403
|
---
|
|
345
404
|
|
|
@@ -361,14 +420,16 @@ rewrite back.
|
|
|
361
420
|
|
|
362
421
|
- The result is stored as a durable `plugin:agy-link/translation` session
|
|
363
422
|
record and rendered as a **"Gemini translation" card pinned directly under the
|
|
364
|
-
reply it translates** — it survives reloads
|
|
365
|
-
|
|
423
|
+
reply it translates** — it survives reloads, reads like any other DSH card (one
|
|
424
|
+
tinted spark plus a "Gemini 译文" label are the only Gemini signals), and never
|
|
425
|
+
enters the model-visible history.
|
|
366
426
|
- Every reply also gets a hover action **"译成人话"** so historical turns can be
|
|
367
427
|
translated on demand.
|
|
428
|
+
- Binds 1:1 agy translation conversation (`<sessionId>#tsl`): persona sent once, per-turn calls transmit only the request line.
|
|
368
429
|
- The translation call rides this plugin's own auxiliary adapter route, so it
|
|
369
430
|
uses the same account pool: **when an account is out of quota it is cooled
|
|
370
431
|
down and the request retries on the next account automatically** (watch
|
|
371
|
-
`/agy pool` for the switch).
|
|
432
|
+
`/agy pool` for the switch). Empty model responses (`EMPTY_RESPONSE`) retry automatically.
|
|
372
433
|
- Translation is strictly opt-in (`autoTranslate: false` by default) because it
|
|
373
434
|
spends quota per turn. Toggle it in **Settings → Antigravity**, or per session
|
|
374
435
|
with `/tsl auto on`.
|
|
@@ -425,6 +486,12 @@ refreshes and login probes alike.
|
|
|
425
486
|
check — at the price of `agy update` reporting `update already in progress`
|
|
426
487
|
until you run `attrib -R`.
|
|
427
488
|
|
|
489
|
+
### What happens when a model rejects `--effort` with `--effort is not supported`?
|
|
490
|
+
Certain models do not support the `--effort` parameter. The plugin automatically detects this refusal, parses the model slug from the error envelope, and replays the turn once without `--effort` so that execution succeeds seamlessly. It then writes the model slug to `~/.dsh/agy-link/effort-unsupported.json` and withdraws the model's effort level declarations, hiding the option in the UI for subsequent sessions. Learned records can be inspected via `/agy status` (`effortUnsupported`) or `/agy doctor`.
|
|
491
|
+
|
|
492
|
+
### Why are quota bars not updating?
|
|
493
|
+
Quotas update via periodic background polling (defaulting to once per hour, tunable via `quotaPollIntervalMs`). For immediate updates, click "Sync" on the console card or run `/agy refresh-quota` in the chat input.
|
|
494
|
+
|
|
428
495
|
---
|
|
429
496
|
|
|
430
497
|
## ⚠️ Disclaimer
|