dsh-agy-link 0.6.56 → 0.6.58
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 +18 -32
- package/README.md +111 -117
- package/dist/cli-image.mjs +665 -291
- package/dist/client.js +145 -38
- package/dist/index.js +945 -284
- package/docs/ARCHITECTURE.md +4 -4
- package/docs/CONFIGURATION.md +20 -14
- package/docs/KNOWN-GAPS.md +2 -8
- package/docs/README.en.md +76 -30
- package/docs/SECURITY-NOTES.md +2 -0
- package/docs/assets/console.png +0 -0
- package/docs/assets/context-metering.png +0 -0
- package/docs/assets/model-picker.png +0 -0
- package/docs/assets/settings.png +0 -0
- package/docs/assets/token-usage.png +0 -0
- package/package.json +1 -1
package/CHANGELOG.md
CHANGED
|
@@ -1,50 +1,36 @@
|
|
|
1
1
|
# Changelog
|
|
2
2
|
|
|
3
|
-
## 0.6.
|
|
3
|
+
## 0.6.58 (2026-11-22)
|
|
4
4
|
|
|
5
5
|
### English
|
|
6
6
|
|
|
7
|
-
- **
|
|
8
|
-
-
|
|
9
|
-
-
|
|
10
|
-
-
|
|
7
|
+
- **Feat(accounts): a pool account's label is now editable from the console (fixes #152, part 1).** `pool.setAccountAlias()` existed but nothing exposed it — the alias could only be set while adding an account, so a typo, or a Google account that was renamed, left a stale label forever.
|
|
8
|
+
- **New route `POST /plugins/agy-link/pool/alias`** (`{ id, alias }`): non-empty, ≤64 chars, 404 for an unknown id. A successful rename clears `defaultAlias`, which is exactly what makes the card stop rendering the generated "Backup Google account N" label and show the typed one instead.
|
|
9
|
+
- **Inline rename in the card**: a "Rename" action opens an input under the card and saves through the host. The proxy editor and this one were the same layout written twice, so both now share `src/client/sections/inline-editor.ts` (which also keeps `AccountsPanel.ts` inside the file-size budget).
|
|
10
|
+
- Four locales carry the copy. `saveAlias` lives with the other account-lifecycle actions, not with quota actions — renaming has nothing to do with quota, and keeping it there would have pushed `quotaActions` past the line budget.
|
|
11
11
|
|
|
12
12
|
### 中文
|
|
13
13
|
|
|
14
|
-
-
|
|
15
|
-
-
|
|
16
|
-
- `
|
|
17
|
-
-
|
|
14
|
+
- **特性(账号):池账号的显示名称现在可在控制台编辑(修复 #152 第一部分)。** `pool.setAccountAlias()` 早就存在,但没有任何入口暴露它——别名只能在添加账号时设定,于是打错字、或 Google 账号改名后,卡片上的旧名字会一直留着。
|
|
15
|
+
- **新增路由 `POST /plugins/agy-link/pool/alias`**(`{ id, alias }`):非空、≤64 字符、未知 id 返回 404。改名成功会清除 `defaultAlias`——这正是让卡片不再渲染自动生成的「备用 Google 账号 N」、改为显示用户输入的机制。
|
|
16
|
+
- **卡片内联重命名**:一个「重命名」动作在卡片下展开输入框,经宿主保存。代理编辑器与它原本是同一套布局写了两遍,现在共用 `src/client/sections/inline-editor.ts`(同时让 `AccountsPanel.ts` 保持在行数预算内)。
|
|
17
|
+
- 四语言文案齐全。`saveAlias` 归入账号生命周期动作而非配额动作——改名与配额无关,放在配额里会把 `quotaActions` 顶出行数预算。
|
|
18
18
|
|
|
19
|
-
## 0.6.
|
|
19
|
+
## 0.6.56 (2026-11-21)
|
|
20
20
|
|
|
21
21
|
### English
|
|
22
22
|
|
|
23
|
-
- **Feat(
|
|
24
|
-
- **
|
|
25
|
-
- **
|
|
26
|
-
|
|
27
|
-
- **Extended toolview cards**: Added dedicated cards and models for `swarm`, `run_workflow`, `schedule`, `manage_task`, subagent lifecycle (`invoke_subagent`, `define_subagent`, `manage_subagents`, `send_message`), and browser/devtools tools.
|
|
28
|
-
- **Generative UI `<agent-embed>`**: Added streaming `<agent-embed src="...">` tag buffering in `EventMapper`/`text.ts`, a strict-CSP `/plugins/agy-link/embed` route, and a sandboxed `<iframe sandbox="allow-scripts">` auto-resizing/theme-synced renderer (`src/client/embed.ts`).
|
|
29
|
-
- **Persistent `agy acp` session pool**: Added stdio JSON-RPC `AcpProcess` + `AcpSessionPool` (`transport: 'cli' | 'acp'`, lazy idle sweep timer, Windows single-account eviction, and automatic pre-stream CLI `-p` fallback).
|
|
30
|
-
- **Multi-account ecosystem inventory & sync**: Added discovery across `plugins`, `mcp`, `skills`, `rules`, and `agents`, allowlist sync into isolated pool accounts, `/ecosystem` HTTP routes, Settings `EcosystemPanel`, and `/agy plugins|mcp|agents|skills|sync-ecosystem`.
|
|
31
|
-
- **Slash command bridges**: Added `/agy btw`, `/agy fork` (including `list`/`restore`), `/agy grill` / `grill-me`, `/agy learn [--apply]`, and `/agy compact`.
|
|
32
|
-
- **Per-family account scoping & host-backed warmup bar**: Preserved per-family active account pins (`manualPinAtByFamily`, `resolvedActiveAccountIds`) and host-backed `WarmupStatusBar` + warmup resilience improvements.
|
|
33
|
-
- **i18n & Windows test hardening**: Localized all newly introduced DOM surfaces (`embed.ts`, `audio.ts`, `extended-cards.ts`, `image-card.ts`) onto `src/client/i18n-bridge.ts` across `en`/`zh`/`es`/`ptBR`, and fixed Windows path/CRLF handling in `test/issue153-client-locale.test.ts`.
|
|
23
|
+
- **Feat(accounts): a pool account's label is now editable from the console (fixes #152, part 1).** `pool.setAccountAlias()` existed but nothing exposed it — the alias could only be set while adding an account, so a typo or a renamed Google account left a stale label forever.
|
|
24
|
+
- **New route `POST /plugins/agy-link/pool/alias`** (`{ id, alias }`) with the validations the UI relies on: non-empty, ≤64 chars, and a 404 for an unknown id. A successful rename clears `defaultAlias`, which is what makes the card stop rendering the generated "Backup Google account N" label and show the typed one.
|
|
25
|
+
- **Inline rename in the card**: a "Rename" action opens an input under the card, saving through the host and refreshing the pool. The proxy editor and this one were the same layout twice, so both now share `src/client/sections/inline-editor.ts` (which also keeps `AccountsPanel.ts` inside the file-size budget).
|
|
26
|
+
- **Test(dx): the SIGKILL-escalation test no longer asserts a wall-clock upper bound.** `durationMs` spans spawn→exit, so on a saturated host it read **16 minutes** during a full coverage run while the escalation itself was correct. The lower bound (must wait out the 3s window) and the semantic `signal === 'SIGKILL'` assertion stay; "hangs forever" is covered by the race guard, which reaps the child.
|
|
34
27
|
|
|
35
28
|
### 中文
|
|
36
29
|
|
|
37
|
-
- **特性(
|
|
38
|
-
-
|
|
39
|
-
-
|
|
40
|
-
|
|
41
|
-
- **扩展工具详情卡片**:为 `swarm`、`run_workflow`、`schedule`、`manage_task`、子代理生命周期(`invoke_subagent` / `define_subagent` / `manage_subagents` / `send_message`)及浏览器/DevTools 工具提供专用卡片渲染。
|
|
42
|
-
- **Generative UI `<agent-embed>`**:在 `EventMapper`/`text.ts` 中实现流式标签缓冲,新增严格 CSP 的 `/plugins/agy-link/embed` 路由与支持自适应高度及主题同步的沙箱 `<iframe sandbox="allow-scripts">` 渲染器(`src/client/embed.ts`)。
|
|
43
|
-
- **持久化 `agy acp` 会话池**:实现 stdio JSON-RPC `AcpProcess` 与 `AcpSessionPool`(`transport: 'cli' | 'acp'`、懒启动空闲清理定时器、Windows 单账号驱逐与流前自动回退 CLI `-p`)。
|
|
44
|
-
- **多账号生态清点与同步**:支持 `plugins`/`mcp`/`skills`/`rules`/`agents` 跨账号清点、白名单同步到隔离池账号、`/ecosystem` HTTP 路由、设置页 `EcosystemPanel` 及 `/agy plugins|mcp|agents|skills|sync-ecosystem`。
|
|
45
|
-
- **斜杠命令桥接**:新增 `/agy btw`、`/agy fork`(含 `list`/`restore`)、`/agy grill` / `grill-me`、`/agy learn [--apply]` 与 `/agy compact`。
|
|
46
|
-
- **按模型家族的活跃账号隔离与宿主级预热条**:保留 `manualPinAtByFamily`、`resolvedActiveAccountIds` 及宿主后端驱动的 `WarmupStatusBar` 与预热韧性增强。
|
|
47
|
-
- **国际化与 Windows 测试加固**:将全部新增客户端 DOM 界面(`embed.ts`、`audio.ts`、`extended-cards.ts`、`image-card.ts`)接入 `src/client/i18n-bridge.ts` 并补齐 `en`/`zh`/`es`/`ptBR` 文案,同时修复 `test/issue153-client-locale.test.ts` 的 Windows 路径与 CRLF 注释处理。
|
|
30
|
+
- **特性(账号):池账号的显示名称现在可在控制台直接编辑(修复 #152 第一部分)。** `pool.setAccountAlias()` 早就存在,但没有任何入口暴露它——别名只能在添加账号时设定,于是打错字或 Google 账号改名后,卡片上的旧名字会一直留着。
|
|
31
|
+
- **新增路由 `POST /plugins/agy-link/pool/alias`**(`{ id, alias }`),带 UI 依赖的校验:非空、≤64 字符、未知 id 返回 404。改名成功会清除 `defaultAlias`,这正是让卡片不再渲染自动生成的「备用 Google 账号 N」、改为显示用户输入的关键。
|
|
32
|
+
- **卡片内联重命名**:一个「重命名」动作在卡片下展开输入框,经宿主保存后刷新池。代理编辑器与它原本是同一套布局写了两遍,现在共用 `src/client/sections/inline-editor.ts`(同时让 `AccountsPanel.ts` 保持在文件行数预算内)。
|
|
33
|
+
- **测试(开发体验):SIGKILL 升级用例不再断言墙钟上界。** `durationMs` 是 spawn→exit 的跨度,在饱和的宿主上于一次完整覆盖率运行中读到 **16 分钟**,而升级本身是正确的。保留了下界(必须等过 3 秒窗口)与语义断言 `signal === 'SIGKILL'`;「是否永久挂住」由带回收的 race 守卫覆盖。
|
|
48
34
|
|
|
49
35
|
## 0.6.54 (2026-11-21)
|
|
50
36
|
|
package/README.md
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
<h1 align="center">🛰️ dsh-agy-link</h1>
|
|
2
2
|
|
|
3
3
|
<p align="center">
|
|
4
|
-
<b>DeepSeek Harness × Google Antigravity</b> — 多账号智能池化与官方 agy CLI
|
|
4
|
+
<b>DeepSeek Harness × Google Antigravity</b> — 多账号智能池化与官方 agy CLI / ACP 双通道桥接 / Multi-Account Pool & Native agy CLI / ACP Bridge for DSH
|
|
5
5
|
</p>
|
|
6
6
|
|
|
7
7
|
<p align="center">
|
|
@@ -15,34 +15,36 @@
|
|
|
15
15
|
<p align="center">
|
|
16
16
|
<b>🌐 语言:</b>
|
|
17
17
|
<a href="./docs/README.en.md">English</a> ·
|
|
18
|
-
<a href="./docs/CONFIGURATION.md">完整配置文档</a>
|
|
18
|
+
<a href="./docs/CONFIGURATION.md">完整配置文档</a> ·
|
|
19
|
+
<a href="./docs/ARCHITECTURE.md">架构说明</a> ·
|
|
20
|
+
<a href="./docs/SECURITY-NOTES.md">安全说明</a>
|
|
19
21
|
</p>
|
|
20
22
|
|
|
21
23
|
---
|
|
22
24
|
|
|
23
25
|
# 中文
|
|
24
26
|
|
|
25
|
-
把 **Google Antigravity 模型接入 DeepSeek Harness(DSH)** ——
|
|
27
|
+
把 **Google Antigravity 模型接入 DeepSeek Harness(DSH)** —— 支持**按模型族独立路由的多账号智能池化**、**CLI 优先官方多 Bucket 配额监控(5 小时滚动 + 7 天周额度 + Argon 独立周池)**、**短进程 `-p` 与持久化 `agy acp` 双传输模式**、**浏览器免粘贴一键登录**、**对话内生图(`agy_image` / `/agy image` / `dsh-agy-image`)**、**多模态附件与 Generative UI 内嵌渲染**,以及**多账号定制生态白名单同步**。由官方未修改的 `agy` CLI 驱动,完整支持流式输出、思考折叠、原生工具卡片与 1M 物理上下文精确计量。
|
|
26
28
|
|
|
27
29
|
<p align="center">
|
|
28
|
-
<img src="./docs/assets/console.png" alt="Antigravity 管理控制台 -
|
|
30
|
+
<img src="./docs/assets/console.png" alt="Antigravity 管理控制台 - 多账号池化与多 Bucket 配额监控" width="760" />
|
|
29
31
|
</p>
|
|
30
32
|
<p align="center">
|
|
31
|
-
<img src="./docs/assets/model-picker.png" alt="DSH 模型选择器中的 Antigravity 模型列表" width="
|
|
33
|
+
<img src="./docs/assets/model-picker.png" alt="DSH 模型选择器中的 Antigravity (agy CLI) 模型列表" width="240" />
|
|
32
34
|
|
|
33
|
-
<img src="./docs/assets/settings.png" alt="DSH 设置 → 插件中的 Antigravity
|
|
35
|
+
<img src="./docs/assets/settings.png" alt="DSH 设置 → 插件中的 Antigravity 运行配置、定制生态与模型显示面板" width="520" />
|
|
34
36
|
</p>
|
|
35
37
|
<p align="center">
|
|
36
|
-
<img src="./docs/assets/token-usage.png" alt="原生上下文缓存与 Token 用量统计" width="
|
|
38
|
+
<img src="./docs/assets/token-usage.png" alt="原生上下文缓存与 Token 用量统计" width="330" />
|
|
37
39
|
|
|
38
|
-
<img src="./docs/assets/context-metering.png" alt="1M 物理上下文负载精确计量" width="
|
|
40
|
+
<img src="./docs/assets/context-metering.png" alt="1M 物理上下文负载精确计量" width="310" />
|
|
39
41
|
</p>
|
|
40
42
|
|
|
41
43
|
---
|
|
42
44
|
|
|
43
45
|
> 🚨 **【国内用户核心前置:必须开启系统代理 / TUN 模式!】**
|
|
44
46
|
>
|
|
45
|
-
> Google Antigravity 服务及 OAuth 登录需要直连 Google
|
|
47
|
+
> Google Antigravity 服务及 OAuth 登录需要直连 Google 海外服务器(`oauth2.googleapis.com`、`daily-cloudcode-pa.googleapis.com` 等)。
|
|
46
48
|
>
|
|
47
49
|
> 1. **推荐方式(最稳妥)**:开启代理工具(Clash / Surge / v2rayA / Sing-box / Loon 等)的 **TUN 虚拟网卡模式(或系统代理全局接管)**,确保终端命令、后台 Node.js 进程及浏览器均能顺畅访问 Google 网络。
|
|
48
50
|
> 2. **终端代理环境变量**:若终端未被代理自动接管,启动 DSH 或运行命令前请在终端中执行:
|
|
@@ -50,74 +52,53 @@
|
|
|
50
52
|
> export HTTPS_PROXY=http://127.0.0.1:7890 HTTP_PROXY=http://127.0.0.1:7890 ALL_PROXY=socks5://127.0.0.1:7890
|
|
51
53
|
> ```
|
|
52
54
|
> *(注:端口 `7890` 请替换为你本地代理软件的实际端口)*
|
|
53
|
-
> 3. **GUI 单账号独立代理**:进入 DSH「设置 → Antigravity」或点击顶部 `AGY` 徽标,点击卡片上的「🌐
|
|
55
|
+
> 3. **GUI 单账号独立代理**:进入 DSH「设置 → 插件 → Antigravity」或点击顶部 `AGY` 徽标,点击卡片上的「🌐 代理」按钮,可为特定账号单独绑定专属代理 URL,实现多账号不同 IP 出口隔离。
|
|
54
56
|
|
|
55
57
|
---
|
|
56
58
|
|
|
57
|
-
## 🌟
|
|
59
|
+
## 🌟 核心能力:多账号池化与风控防封
|
|
58
60
|
|
|
59
|
-
|
|
61
|
+
拥有多个 Google Antigravity / Gemini 账号?**dsh-agy-link 让多账号管理自动化、可视化且风控友好**:
|
|
60
62
|
|
|
61
|
-
- 👥
|
|
62
|
-
-
|
|
63
|
-
-
|
|
64
|
-
-
|
|
65
|
-
-
|
|
66
|
-
-
|
|
67
|
-
-
|
|
68
|
-
- 🎨 **多主题高对比度自适应 (Light & Dark Themes)**:原生适配 DSH 浅色/深色主题,告别发暗发灰与看不清文字,UI 视觉清晰锐利。
|
|
69
|
-
- 📱 **手机 Web 端响应式自适应 (Mobile Web)**:控制台在屏幕宽度小于 680px 时自动变为全屏抽屉面板(`100dvh`),标签与开关控件折行重排,配额条独占单行,操作按钮等宽网格分布,并在多尺寸设备(360×800、390×844、768×1024)实测无横向溢出。
|
|
70
|
-
- 🗣 **DSH 原生大白话翻译卡片 (`/tsl`)**:卡片沿用 DSH 自己的观感(0.5px 细描边、markdown 代码块底色、12px 圆角、横幅表头),只用一枚单色 Gemini 星标 + 「Gemini 译文」标签标明出处,深浅主题全由 DSH 令牌决定,不再是一块品牌渐变横幅;每个 DSH 会话绑定独立翻译会话(`<sessionId>#tsl`),仅首轮注入人格,后续仅传指令行,共享主号池与故障转移。
|
|
71
|
-
- 🧠 **思考强度自适应学习 (Effort Learning)**:当模型拒绝 `--effort` 参数时,自动无 effort 原样重放确保轮次完成,持久化记录至本地文件并自动收回该机型的档位声明,避免后续重复报错。
|
|
72
|
-
- 🌐 **独立账号网络代理 (Per-Account Proxy)**:支持为每个账号独立绑定 HTTP(S) / SOCKS 代理,避免多账号同 IP 引起风控;未显式配置时自动探测系统代理(macOS `scutil` / Windows 注册表 / Linux gsettings)。
|
|
73
|
-
- ⚡ **分模型族独立冷却 (Family-Scoped Cooldown)**:Gemini、Claude、GPT-OSS 与 Argon 的速率限制独立计算,某个模型族受限不影响其他模型族正常调用。
|
|
63
|
+
- 👥 **多账号池化与独立沙箱**:在 DSH 内添加任意数量的 Google 账号,每个备用账号拥有独立 HOME 目录沙箱与 `0600` 原子化凭证(带 `.bak` 自愈备份)。Windows 上以「身份级引用计数租约」接管机器级 `gemini:antigravity` 凭据槽,**同一账号的多会话并行运行**,仅跨账号切换时短暂串行交接。
|
|
64
|
+
- ⚡ **按模型族独立切换与冷却 (`Gemini` / `Argon` / `Claude` / `GPT-OSS`)**:控制台每个模型族独立显示「设为当前 / 当前使用」并支持独立冷却与清除冷却;某个模型族限流不影响其余模型族正常调度。
|
|
65
|
+
- 🔄 **顺序耗尽 & 到期优先轮换**:支持 `sequential`(顺次耗尽)与 `round-robin`(轮询均衡)调度;触发 429 或额度耗尽时自动平滑接力至重置窗口最早到期的可用账号,对话不中断。
|
|
66
|
+
- 📊 **CLI 优先多 Bucket 配额监控与自动预热**:默认通过官方 `agy -p /usage` 采集配额(`quotaViaCli: true`),同时展示 **5 小时额度**、**周额度**(以及服务端上报时的 **Argon 独立周池**)与消耗节奏指示;支持单账号/一键预热及宿主驱动的持久化预热进度条,可按需开启到达重置窗口自动预热(`autoWarmup`)。
|
|
67
|
+
- 🧠 **抖动安全鉴权与风控熔断**:基于 agy 运行日志的 `keyringAuth` 传输证据精准区分代理抖动(自动按 `NETWORK` 重试)与真实登出(粘性 `authRequired` 需二次确认),绝不误伤健康账号;遇 `TOS_VIOLATION` 立即隔离该账号并停止自动故障转移,防止连坐封号。
|
|
68
|
+
- 🔑 **浏览器免粘贴 OAuth 与 Token 导入**:支持一键唤起系统浏览器回环自动捕获凭证(含手动回调粘贴兜底)及 `refresh_token` / Token JSON 直接导入。
|
|
69
|
+
- 🌐 **独立账号代理**:每个账号可单独配置 HTTP(S) / SOCKS 代理,未配置时回退全局代理或自动探测系统代理。
|
|
74
70
|
|
|
75
71
|
---
|
|
76
72
|
|
|
77
73
|
## ✨ 全功能特性一览
|
|
78
74
|
|
|
79
75
|
| 能力 | 说明 |
|
|
80
|
-
|
|
|
81
|
-
| 🎨
|
|
82
|
-
|
|
|
83
|
-
|
|
|
84
|
-
| ⚡
|
|
85
|
-
|
|
|
86
|
-
|
|
|
87
|
-
| 📊
|
|
88
|
-
|
|
|
89
|
-
|
|
|
90
|
-
|
|
|
91
|
-
|
|
|
92
|
-
| 🌐
|
|
93
|
-
| 🔌 **原生模型路由** | 在 DSH 模型配置中注册 `antigravity` 提供方,`/model` 选择器以 `Antigravity (agy CLI)` 分组随心切换 Gemini / Claude / GPT-OSS / Argon |
|
|
94
|
-
| 🌊 **完整流式映射** | 文本、思考过程(thinking turn)与工具活动均无损映射到 DSH 原生流协议 |
|
|
95
|
-
| 🃏 **原生工具卡片** | agy 执行的终端命令(`run_command`)、文件修改(inline diff)均以 DSH 原生卡片渲染;MCP 元工具(`call_mcp_tool`)自动拆包为 Terminal/Search 卡片 |
|
|
96
|
-
| 🔗 **会话上下文保真** | DSH 会话与 agy 原生会话绑定(`--conversation`),由 agy 管理完整历史,每轮仅发送增量 |
|
|
97
|
-
| 🎯 **DSH 目标与计划集成** | 长任务自动携带 DSH goal / plan 上下文,工具续跑不丢任务状态 |
|
|
98
|
-
| 📊 **精确 Token 统计** | 输入 / 输出 / 思考 / 缓存读取 token 完整计入 DSH 用量统计,全面适配 1M 上下文 |
|
|
99
|
-
| 🎛 **顶部控制台徽标** | 顶部栏 `AGY · 别名` / `AGY (n)` 徽标一键弹出控制台,直观查看账号池、配额进度条与代理状态 |
|
|
100
|
-
| 🖼 **图片多模态** | 支持多模态图片传入,自动落盘本地媒体目录并通过 `--add-dir` 安全授权给 agy 查看 |
|
|
101
|
-
| 🤝 **`agy_ask` 辅助工具** | 允许任意 DSH 模型把单次任务委托给 Antigravity 模型(AskAntigravity 协作模式) |
|
|
102
|
-
| 🧠 **思考强度自适应学习** | 模型若拒绝 `--effort`,自动无 effort 原样重放并记录至本地,后续自动收回档位声明,杜绝重复报错 |
|
|
103
|
-
| 🎨 **生图(`generate_image` 桥接)** | `dsh-agy-image` CLI;直接复用真实 `AgyAdapter`(`purpose:'image'`)与账号池,额度/地区失败自动换号;固定 Prompt/ImageName/AspectRatio/ImagePaths 参数,产物按魔数+宽高+比例强校验 |
|
|
104
|
-
| 🗣 **`/tsl` 大白话翻译** | DSH 原生卡片锚定在回复下方,会话 1:1 独立绑定复用;支持 `/tsl` 命令、自动翻译开关(设置页同一行可选**翻译模型**与**思考档**下拉框)及回复快捷按钮「译成人话」 |
|
|
105
|
-
| ⌨️ **`/agy` 快捷命令族** | `status` / `pool` / `auth` / `models` / `mode` / `effort` / `workspace` / `goal` / `session` / `enable-account` / `disable-account` / `clear` / `doctor` / `help` |
|
|
76
|
+
| --- | --- |
|
|
77
|
+
| 🎨 **官方专属品牌与双入口控制台** | `assets/icon.svg` 矢量微标自适应深浅主题;顶部 `AGY · 别名` 徽标弹窗与「设置 → 插件 → Antigravity」共用同一完整控制台,屏幕宽度 `< 680px` 自动切换全屏抽屉并支持手机端触控重排 |
|
|
78
|
+
| 📋 **按账号真实模型目录与勾选过滤** | 合并 `agy models` 与配额导出模型目录,提供「模型显示」允许清单勾选(`selectedModels`),支持 `poolWideCatalog` 跨号池并集自动路由,动态展示 `low`/`medium`/`high`/`xhigh` (`Extra`)/`max` 思考档并自愈学习模型拒收 `--effort` |
|
|
79
|
+
| 🛡️ **4 档权限模式与 OS 终端沙箱** | 支持 `skip`、`auto`(`--mode auto` 智能审查高危)、`accept-edits`、`plan` 4 档策略,支持 `--sandbox` 终端沙箱隔离敏感目录及 `--agent` / `--settings` / `--json-schema` 参数透传 |
|
|
80
|
+
| ⚡ **CLI (`-p`) / 持久化 `agy acp` 双传输** | 默认每轮短生命周期 `agy -p` 进程;可在设置或 `/agy transport acp` 切换至持久化 `agy acp` stdio JSON-RPC 会话池(空闲自动回收,流前异常自动回退 CLI) |
|
|
81
|
+
| 🃏 **全链路工具卡片与 Generative UI** | 镜像 Terminal / Diff / Read / Search / MCP 卡片,并针对 **`swarm`**、**`run_workflow`**、**`schedule`**、**`manage_task`**、**子代理生命周期**、**`image-generator`** 与**浏览器/DevTools** 提供专属卡片;支持 **`<agent-embed>`** 严格 CSP 沙箱 HTML 微件自适配高度与深浅主题 |
|
|
82
|
+
| 🎬 **多模态附件与内联播放** | 通过 `--add-dir` 安全暂存 **图片、PDF、音频、视频** 附件(非图单文件默认上限 `mediaMaxFileBytes` 20 MiB);聊天内支持图片全屏灯箱、视频预览、**内联 `<audio>` 播放器**、Mermaid 图表、交互决策芯片与上下文压缩卡 |
|
|
83
|
+
| 📊 **原生上下文缓存与 1M 计量** | 无损映射 `cache_read_tokens`、思考 token 与 1M 物理上下文负载计量;超长上下文自动采用 8:2 掐头去尾并按阈值切为临时 `.md` 分页读取 |
|
|
84
|
+
| 🎨 **对话内生图与命令行生图** | 注册 `agy_image` DSH 工具(`imageTool: true`)、`/agy image` 命令、`image-generator` 卡片与 `dsh-agy-image` CLI;默认优先 `gemini-4-hydrogen`(否则回退 `gemini-3.8-flash`),均衡 `medium` 思考档 |
|
|
85
|
+
| 🗣 **`/tsl` 大白话翻译** | 每会话 1:1 绑定 `<sessionId>#tsl`,原生卡片锚定回复下方持久化存储;支持自动翻译开关(同行可选模型与思考档)及回复快捷按钮「译成人话」 |
|
|
86
|
+
| 🧩 **多账号定制生态清点与同步** | 查看/开关主账号 `plugins`,清点 `mcp` / `skills` / `rules` / `agents`,并按白名单镜像同步至隔离账号池(严格排除凭据、私钥与钥匙串) |
|
|
87
|
+
| 🎯 **DSH Goal/Plan 与斜杠桥接** | `/agy goal` 与 DSH `GoalService` 1:1 对齐,支持 `/plan` 审批流转及 `/agy btw` / `fork` / `grill` / `learn` / `compact` |
|
|
88
|
+
| 🌐 **四语国际化与 UI 开关** | 原生接入 `zh` / `en` / `es` / `pt-BR` 四语言字典;提供 `showHeaderBadge` 与 `showTranslateAction` opt-out 可见性开关 |
|
|
106
89
|
|
|
107
90
|
---
|
|
108
91
|
|
|
109
92
|
## 📋 前置要求
|
|
110
93
|
|
|
111
|
-
在安装本插件前,请确保具备以下环境:
|
|
112
|
-
|
|
113
94
|
| 前置项 | 说明 / 验证方式 |
|
|
114
95
|
| --- | --- |
|
|
115
|
-
| **1. 系统网络代理** |
|
|
116
|
-
| **2. DeepSeek Harness (DSH)** |
|
|
117
|
-
| **3. Node.js ≥ 24** | DSH
|
|
118
|
-
| **4. Google Antigravity `agy` CLI** | 按 [Google 官方安装文档](https://antigravity.google/docs/cli/install)
|
|
96
|
+
| **1. 系统网络代理** | **【必须开启】**(开启 TUN 模式或设置 `HTTPS_PROXY`,确保可连接 Google 服务) |
|
|
97
|
+
| **2. DeepSeek Harness (DSH)** | 宿主客户端;`dsh --version` 验证 |
|
|
98
|
+
| **3. Node.js ≥ 24** | DSH 运行环境;`node --version` 验证 |
|
|
99
|
+
| **4. Google Antigravity `agy` CLI (≥ 1.5)** | 按 [Google 官方安装文档](https://antigravity.google/docs/cli/install) 安装;`agy --version` 验证 |
|
|
119
100
|
|
|
120
|
-
> 💡
|
|
101
|
+
> 💡 即使 `agy` 尚未登录,也可以直接安装插件;随后点击顶部 `AGY` 徽标或进入「设置 → 插件 → Antigravity」,点击「➕ 添加 Google 账号」即可直接在浏览器中完成登录。
|
|
121
102
|
|
|
122
103
|
---
|
|
123
104
|
|
|
@@ -133,16 +114,15 @@ dsh plugin --profile web add dsh-agy-link
|
|
|
133
114
|
# 升级到最新版:
|
|
134
115
|
# dsh plugin --profile web add dsh-agy-link@latest --registry https://registry.npmjs.org
|
|
135
116
|
|
|
136
|
-
# 2. 启动 DSH Web GUI
|
|
117
|
+
# 2. 启动 DSH Web GUI,在输入框检查状态:
|
|
137
118
|
# /agy status
|
|
138
119
|
|
|
139
120
|
# 3. 登录与添加账号:
|
|
140
|
-
# 方式 A:点击顶部导航栏的 "AGY (n)"
|
|
141
|
-
# 方式 B
|
|
142
|
-
# 再用 /agy auth <账号 ID
|
|
143
|
-
# 授权后 30 秒内执行 /agy auth-status 查看最终登录结果。
|
|
121
|
+
# 方式 A:点击顶部导航栏的 "AGY (n)" 徽标 → "➕ 添加 Google 账号",浏览器一键登录(或切换至「导入 Token」);
|
|
122
|
+
# 方式 B:执行 /agy auth 为主账号发起登录,/agy pool 查看账号 ID,
|
|
123
|
+
# 再用 /agy auth <账号 ID|别名|邮箱> 重新登录备用账号,/agy auth-status 查询结果。
|
|
144
124
|
|
|
145
|
-
# 4. 在 /model 选择器中挑选 Antigravity 模型,立即开启对话!
|
|
125
|
+
# 4. 在 /model 选择器中挑选 Antigravity (agy CLI) 模型,立即开启对话!
|
|
146
126
|
```
|
|
147
127
|
|
|
148
128
|
> 无头运行(`dsh headless`)的权限预设与目录白名单见 [docs/HEADLESS-PERMISSIONS.md](./docs/HEADLESS-PERMISSIONS.md)。
|
|
@@ -153,49 +133,66 @@ dsh plugin --profile web add dsh-agy-link
|
|
|
153
133
|
|
|
154
134
|
所有配置键、环境变量、默认值与高级选项**只维护一份**:[docs/CONFIGURATION.md](./docs/CONFIGURATION.md)。
|
|
155
135
|
|
|
156
|
-
常用入口:`/plugin`、设置面板(Antigravity)、`DSH_AGY_*` 环境变量,以及 `~/.dsh/agy-link/runtime-overrides.json
|
|
136
|
+
常用入口:`/plugin`、设置面板(Antigravity)、`DSH_AGY_*` 环境变量,以及 `~/.dsh/agy-link/runtime-overrides.json`(面板与 `/agy` 热修改写入位置)。
|
|
157
137
|
|
|
158
138
|
---
|
|
159
139
|
|
|
160
|
-
## 🗣
|
|
140
|
+
## 🗣 `/tsl` 大白话翻译
|
|
161
141
|
|
|
162
|
-
|
|
142
|
+
`/tsl` 调用 Gemini 模型(默认 `gemini-3.8-flash` · `low`,耗时约 12 秒;可在设置面板改选 `medium` / `high` 或其他 Gemini 模型)将当前会话的回复重写为通俗口语化的大白话。
|
|
163
143
|
|
|
164
144
|
```bash
|
|
165
145
|
/tsl # 翻译上一轮已完成的回复
|
|
166
146
|
/tsl 3 # 翻译指定第 3 轮回复
|
|
167
|
-
/tsl --full #
|
|
168
|
-
/tsl --text 任意文本… #
|
|
169
|
-
/tsl --model claude-sonnet-5-5 --effort medium
|
|
147
|
+
/tsl --full # 连同中间工具调用叙述一并翻译
|
|
148
|
+
/tsl --text 任意文本… # 纯文本翻译模式(直接输出,不生成卡片)
|
|
149
|
+
/tsl --model claude-sonnet-5-5 --effort medium
|
|
170
150
|
/tsl --print # 在命令执行输出中同步回显译文
|
|
171
151
|
/tsl auto on|off|status # 针对当前会话开启、关闭或查看自动翻译状态
|
|
172
152
|
```
|
|
173
153
|
|
|
174
|
-
- **DSH
|
|
175
|
-
-
|
|
176
|
-
-
|
|
177
|
-
-
|
|
178
|
-
- **严格遵循用户授权**:自动翻译默认关闭(`autoTranslate: false`),可在「设置 → Antigravity」中全局开启,或在会话中通过 `/tsl auto on` 动态开启。同一行右侧的两个下拉框可分别改**翻译模型**(默认自动挑 Gemini Flash)与**翻译思考档**(默认跟随「默认思考强度」),改完即写配置、下一轮翻译生效。
|
|
179
|
-
|
|
154
|
+
- **DSH 原生翻译卡片**:持久化存储于 `plugin:agy-link/translation` 会话记录中,渲染在被翻译回复正下方,刷新或切会话不丢失,且不进入模型可见历史。
|
|
155
|
+
- **回复快捷按钮**:每条助理回复下方提供「译成人话」按钮,支持按需点译历史任意一条消息。
|
|
156
|
+
- **1:1 会话绑定 (`translateBindConversation`)**:每个 DSH 会话绑定一条独立翻译会话(`<sessionKey>#tsl`),仅首轮发送译员提示,后续增量传入原文;共享主号池与故障转移。
|
|
157
|
+
- **严格 opt-in**:自动翻译默认关闭(`autoTranslate: false`),可在设置面板或通过 `/tsl auto on` 开启,同行右侧两个下拉框可直接修改翻译模型与思考强度。
|
|
180
158
|
|
|
181
159
|
---
|
|
182
160
|
|
|
183
|
-
## 🎨 生图(`
|
|
161
|
+
## 🎨 生图(`agy_image` + `/agy image` + `dsh-agy-image`)
|
|
184
162
|
|
|
185
|
-
agy
|
|
163
|
+
插件把 `agy` 内置生图(`generate_image` / `image-generator`)接入三条统一入口,全部底层复用同一个 `ImageService` 与真实 `AgyAdapter`(`purpose: 'image'`),共享号池调度、配额/地区失败自动换号、代理与 `--effort` 自愈重试。默认在发现 `gemini-4-hydrogen` 时自动优先选用(否则回退 `gemini-3.8-flash`),默认思考档为均衡的 `medium`。
|
|
186
164
|
|
|
187
|
-
|
|
188
|
-
|
|
189
|
-
|
|
190
|
-
|
|
191
|
-
|
|
165
|
+
1. **对话内工具 `agy_image`**:默认开启(`imageTool: true`),任意 DSH 模型(包括非 Antigravity 模型)均可在对话中直接调用 Antigravity 生图或改图。
|
|
166
|
+
2. **斜杠命令 `/agy image`(别名 `/agy img`)**:在聊天框内快速生成或编辑图片,结果直接渲染为内联 Markdown 图片与元信息;模型执行过程中调用的 `image-generator` 子代理也会渲染为带缩略图与灯箱的预览卡片。
|
|
167
|
+
```bash
|
|
168
|
+
/agy image 一只戴墨镜的柴犬,扁平插画风 -a 16:9 -n shiba
|
|
169
|
+
/agy img 把背景换成夜晚 -i ./day.png
|
|
170
|
+
```
|
|
171
|
+
3. **无头命令行 `dsh-agy-image`**:适合脚本与批处理工作流(不额外暴露 HTTP 端点)。
|
|
172
|
+
```bash
|
|
173
|
+
dsh-agy-image -p "一只戴墨镜的柴犬,扁平插画风" -a 16:9 -o ./dog.jpg
|
|
174
|
+
dsh-agy-image -p "把背景换成夜晚" -i ./day.png -n night_scene --json
|
|
175
|
+
```
|
|
192
176
|
|
|
193
|
-
-
|
|
194
|
-
-
|
|
195
|
-
|
|
196
|
-
|
|
197
|
-
|
|
198
|
-
|
|
177
|
+
- **固定参数与强校验**:透传 `Prompt`、`ImageName`、`AspectRatio`(14 种比例:`1:1`、`2:3`、`3:2`、`3:4`、`4:3`、`4:5`、`5:4`、`9:16`、`16:9`、`21:9`、`1:8`、`8:1`、`1:4`、`4:1`)及 `ImagePaths`;产出前强校验文件存在、魔数(PNG/JPEG/WebP/GIF/BMP)、宽高、`imageMaxBytes`(默认 20 MiB)与比例 3% 容差。
|
|
178
|
+
- **`--json` 输出与退出码**:返回 `{ok, path, mime, width, height, aspectRatio, bytes, model, effort, durationMs, attempts, accountId?, conversationId?}`,失败携带稳定 `code`;退出码:`0` 成功 · `2` 参数错误 · `3` 找不到 agy · `4` 生成失败 · `5` 产物校验失败 · `6` 账号/地区不可用。
|
|
179
|
+
|
|
180
|
+
---
|
|
181
|
+
|
|
182
|
+
## 🧩 定制生态同步与 `/agy` 命令族
|
|
183
|
+
|
|
184
|
+
### Antigravity 定制生态管理与同步
|
|
185
|
+
- 设置面板内置折叠式 **Antigravity 定制生态** 面板,汇总主账号及工作区的 **Plugins / MCP 服务 / 自定义 Agent / Skills / Rules** 数量,展开可在线启停插件或设为默认 `--agent`,点击「同步至号池」即可立即同步。
|
|
186
|
+
- 默认开启启动与请求前轻量白名单同步(`syncAccountCustomizations: true`):仅镜像 `plugins`、`skills`、`rules`、`agents` 与 MCP 配置到隔离池账号,**绝不触碰** `.env`、OAuth Token、私钥(`.pem`/`.key`)、日志与钥匙串。
|
|
187
|
+
|
|
188
|
+
### 常用 `/agy` 斜杠命令
|
|
189
|
+
| 分组 | 命令 |
|
|
190
|
+
| --- | --- |
|
|
191
|
+
| **状态与号池** | `/agy status` · `/agy pool` · `/agy add-account [alias]` · `/agy use <id> [family]` · `/agy enable-account` / `disable-account` / `remove-account` · `/agy refresh-quota` · `/agy clear-cooldown` · `/agy models` |
|
|
192
|
+
| **认证登录** | `/agy auth [id\|alias\|email]` · `/agy auth-status` · `/agy auth-code <code>` · `/agy import <refresh_token_or_json> [alias]` |
|
|
193
|
+
| **运行与安全** | `/agy mode <skip\|auto\|plan\|accept-edits>` · `/agy sandbox [on\|off]` · `/agy transport [cli\|acp\|status]` · `/agy agent [name\|off]` · `/agy settings [show\|<json_or_path>\|clear]` · `/agy effort <low\|medium\|high\|xhigh\|max\|default>` · `/agy workspace [path]` |
|
|
194
|
+
| **生态与目标** | `/agy plugins [list\|enable <id>\|disable <id>]` · `/agy mcp` · `/agy skills` · `/agy agents [list\|use <name>\|off]` · `/agy sync-ecosystem` · `/agy goal [status\|set\|edit\|pause\|resume\|complete\|clear]` · `/agy session [info\|clear]` |
|
|
195
|
+
| **工作流桥接** | `/agy btw <问题>`(只读旁路提问)· `/agy fork [list\|restore <id>\|<提示>]`(分支快照与回溯)· `/agy grill [主题]` / `/agy grill-me`(结构化需求对齐追问)· `/agy learn [--apply] [焦点]`(沉淀 Skill/Rule 到 `.agents/`)· `/agy compact [焦点]`(压缩摘要并重置绑定)· `/agy doctor` |
|
|
199
196
|
|
|
200
197
|
---
|
|
201
198
|
|
|
@@ -203,47 +200,44 @@ dsh-agy-image -p "把背景换成夜晚" -i ./day.png -n night_scene --json
|
|
|
203
200
|
|
|
204
201
|
> 分层、依赖方向与各模块职责见 [docs/ARCHITECTURE.md](./docs/ARCHITECTURE.md);开发与重构门禁见 [docs/DEVELOPMENT.md](./docs/DEVELOPMENT.md)。
|
|
205
202
|
|
|
206
|
-
1.
|
|
207
|
-
2.
|
|
208
|
-
|
|
209
|
-
|
|
210
|
-
|
|
211
|
-
5. **失败分类与自愈**:错误按 AUTH / NETWORK / RATE_LIMIT / ELIGIBILITY 等精确分类;网络抖动借由 agy 运行日志自动甄别为可重试故障,绝不误伤健康账号的登录状态。
|
|
212
|
-
6. **辅助通道隔离**:`/tsl` 翻译、会话标题生成、任务目标推导等通过独立专用辅助通道执行,共享号池与冷却机制,不占主会话绑定与工具权限。
|
|
203
|
+
1. **CLI (`-p`) 与可选 ACP (`agy acp`) 双传输**:默认每轮启动独立的官方 `agy -p --output-format stream-json` 进程解析 NDJSON 流;开启 `transport: 'acp'` 后复用持久化 `agy acp` stdio JSON-RPC 会话池,并在流前失败时自动平滑回退 CLI。
|
|
204
|
+
2. **多账号沙箱与凭据租约**:主账号沿用系统 HOME / 钥匙串,备用账号在 `~/.dsh/agy-accounts/<id>` 独立隔离(写 `0600` + `.bak` 自动恢复)。Windows 上通过身份级引用计数租约接管全局 `gemini:antigravity` 凭据槽,实现同账号并发与安全跨号交接。
|
|
205
|
+
3. **CLI 优先多 Bucket 配额汇总**:默认通过 `agy -p /usage`(`quotaViaCli: true`)采集配额,必要时回退官方 `v1internal:retrieveUserQuotaSummary` 消费级端点,精准追踪 5h 滚动额度、7d 周额度与 Argon 独立周池。
|
|
206
|
+
4. **会话级故障转移与自愈**:429、额度耗尽、地区限制与鉴权异常按模型族独立分类与冷却,并基于运行日志区分网络抖动与真实登出。
|
|
207
|
+
5. **辅助通道隔离**:`/tsl` 翻译、生图、标题生成与目标推导通过专用 `purpose` 走辅助通道,共享号池与故障转移但不污染主会话绑定。
|
|
213
208
|
|
|
214
209
|
---
|
|
215
210
|
|
|
216
211
|
## ❓ 常见问题排查 (FAQ)
|
|
217
212
|
|
|
218
213
|
### 升级到 DSH 0.2.2 后桌面端启动失败(`web boot: 1 entry did not activate` / `locale "es" is already registered`)?
|
|
219
|
-
**答:这是 0.4.99 及更早版本的兼容性问题,已在 0.5.5
|
|
220
|
-
|
|
221
|
-
- **处理**:把 `dsh-agy-link` 升级到 **≥ 0.5.5**(推荐当前 0.6.x)。新版注册前会检查宿主语言目录,仅容忍「已注册 / 已有词典」,卸载时也只清理自己拥有的注册项;宿主已注册 `es`/`pt-BR`(含 `ES`/`pt-br` 大小写变体)都可正常共存。
|
|
222
|
-
- **临时恢复**:若暂时无法升级,禁用该插件即可进入聊天界面。
|
|
214
|
+
**答:这是 0.4.99 及更早版本的兼容性问题,已在 0.5.5 修复,当前 0.6.x 不受影响。**
|
|
215
|
+
新版客户端在注册 `es` / `pt-BR` 语言前会检查宿主语言目录并仅清理自身注册项;升级至 `>= 0.5.5` 即可正常共存。
|
|
223
216
|
|
|
224
217
|
### Windows 平台开始对话时为什么会短暂闪一下黑色命令行窗口(黑框)?
|
|
225
|
-
**答:这是 Windows
|
|
226
|
-
|
|
227
|
-
- **解决步骤**:
|
|
228
|
-
1. 打开 **Windows 终端 (Windows Terminal)** 的「设置」→「启动」(或进入 Windows「设置」→「系统」→「开发者选项」)。
|
|
229
|
-
2. 将 **默认终端应用程序 (Default terminal application)** 从「让 Windows 决定」或「Windows 终端」更改为 **「Windows 控制台主机 (Windows Console Host)」**。
|
|
230
|
-
3. 点击右下角 **保存 (Save)**。
|
|
231
|
-
4. **完全退出并重启 DSH**(使新启动的主进程应用更新后的控制台委托注册表),黑框闪烁即可彻底消除。
|
|
232
|
-
|
|
233
|
-
### agy 自己的自动更新子进程也会闪窗(0.4.66 修复)
|
|
234
|
-
除了上面那种控制台委托导致的闪窗,`agy` **自己**还会在距上次更新检查满 15 分钟后派生一条 `--bg-updater` → `agy --version` 的子进程链,**这条链由 agy 内部创建,会自行分配可见控制台**,父进程的 `windowsHide` 和 `AGY_CLI_DISABLE_AUTO_UPDATE=1` 都来不及生效(这就是 Issue #49 实测确认的结论)。
|
|
235
|
-
|
|
236
|
-
0.4.66 起的处理方式:每次 spawn agy 之前,插件把 agy 更新检查的 fast-path 时间戳(`<agy home>/last_check.timestamp`)刷新为当前时间。agy 的检查逻辑是「距上次检查 < 15 分钟就直接跳过且不派生子进程」,于是这条可见窗口链根本不会被创建——对话、冷启动探测、模型选择器刷新、登录探测全部覆盖。
|
|
218
|
+
**答:这是 Windows 11 默认终端(Windows Terminal)委托拦截控制台子进程句柄所致,完全良性。**
|
|
219
|
+
打开 **Windows 终端**「设置 → 启动」,将 **默认终端应用程序** 改为 **「Windows 控制台主机 (Windows Console Host)」**,保存后**完全退出并重启 DSH** 即可彻底消除。
|
|
237
220
|
|
|
238
|
-
|
|
239
|
-
|
|
240
|
-
- **旧版本用户的手动 workaround**:把 `%USERPROFILE%\.gemini\antigravity-cli\updater\update.lock` 设为只读(`attrib +R ...`),agy 拿不到更新锁就会跳过检查。代价是手动 `agy update` 会报 `update already in progress`,需要先 `attrib -R`。
|
|
221
|
+
### `agy` 自己的自动更新子进程也会闪窗?
|
|
222
|
+
`agy >= 1.4.2` 会在距上次更新检查满 15 分钟后派生可见控制台检查链。插件默认在 Windows 上启用 `suppressAgyAutoUpdate`(环境变量 `DSH_AGY_SUPPRESS_AUTOUPDATE`),每次 spawn 前刷新对应 `agy home` 的 `last_check.timestamp`,避免派生可见窗口链;手动运行 `agy update` 完全不受影响。
|
|
241
223
|
|
|
242
224
|
### 某个模型选定思考强度后提示 `--effort is not supported`?
|
|
243
|
-
|
|
225
|
+
插件内置思考强度自适应学习:遇到模型拒绝 `--effort` 时自动无参数原样重放确保本轮完成,并将该模型记入 `~/.dsh/agy-link/effort-unsupported.json`,后续自动隐藏该模型的档位选择。
|
|
244
226
|
|
|
245
227
|
### 配额进度条未及时更新?
|
|
246
|
-
|
|
228
|
+
后台默认每小时轮询一次(`quotaPollIntervalMs`)。如需立即刷新,点击控制台卡片「同步」或右上角「刷新额度」,或在输入框执行 `/agy refresh-quota`。
|
|
229
|
+
|
|
230
|
+
---
|
|
231
|
+
|
|
232
|
+
## 📚 相关文档
|
|
233
|
+
|
|
234
|
+
- [docs/CONFIGURATION.md](./docs/CONFIGURATION.md) — 全量配置键、环境变量与默认值参考(唯一真相源)
|
|
235
|
+
- [docs/ARCHITECTURE.md](./docs/ARCHITECTURE.md) — 分层架构、Provider 流水线与 35 个 HTTP 路由模块
|
|
236
|
+
- [docs/AUTH.md](./docs/AUTH.md) — PKCE OAuth、Token 导入、平台钥匙串隔离与脱敏机制
|
|
237
|
+
- [docs/SECURITY-NOTES.md](./docs/SECURITY-NOTES.md) — 威胁模型、路由限域、`/embed` CSP 与 MCP 桥接边界
|
|
238
|
+
- [docs/HEADLESS-PERMISSIONS.md](./docs/HEADLESS-PERMISSIONS.md) — `dsh headless` 最小权限配置指南
|
|
239
|
+
- [docs/KNOWN-GAPS.md](./docs/KNOWN-GAPS.md) — 平台限制、多模态暂存与上游行为记录
|
|
240
|
+
- [docs/DEVELOPMENT.md](./docs/DEVELOPMENT.md) — 门禁命令与开发重构规范
|
|
247
241
|
|
|
248
242
|
---
|
|
249
243
|
|