# DeepSeek Harness 订阅账号插件 2.3.5

Codex、Antigravity 直接在 Harness 内使用；无需运行 CLIProxyAPI 服务。

## 本次升级 (2.3.5)

- **强化 Antigravity 工具参数 Schema 兼容性**：深度兼容 Harness 工具复杂 schema（联合类型 `oneOf`/`anyOf`/`allOf`、`const` 以及各类字符串/数字/数组约束），将其投影为 Google Gemini 严格子集结构，将约束平滑转入 description，彻底解决带联合类型/约束的工具声明被拒问题。
- **打包与依赖优化**：同步版本至 2.3.5。

## 上一版修复 (2.3.4)

- **新版本号强制刷新客户端资源**：不再复用已安装的 2.3.3 包版本，避免 Harness 插件管理器继续加载同版本缓存。
- **设置入口精简**：Harness 设置侧栏由“订阅账号 (CPA)”改为“订阅账号”；内部 CPA 路由、接口与模型标识保持不变。
- **宽度与额度布局修正**：嵌入式内容区限制为 640px，额度窗口最多两列，奇数项自动平衡；520px 以下回落为单列。

## 上一版升级 (2.3.3)

- **Superdesign 原生精简界面**：基于 Superdesign 对现有设置页建立忠实基线并比较两种方向后，采用 Harness 原生精简方案；标题区改为紧凑工具栏，概览压缩为单行同步状态条。
- **额度扫读优化**：同一账号的额度窗口按可用宽度自适应并列展示，突出百分比、重置时间和渠道品牌色，同时在狭窄容器中自动回落为单列。
- **操作层级优化**：优先排列刷新额度与刷新模型，将重新登录和退出移到次要操作区；账号卡改用节省纵向空间的左侧品牌标识，并补齐分页 ARIA 状态。

## 上一版升级 (2.3.2)

- **启动自动同步**：插件随 DeepSeek Harness 激活后，会在后台刷新全部已登录账号的模型额度与模型目录；未登录账号自动跳过，启动过程不会等待网络请求。
- **一键刷新所有额度**：订阅账号页新增“刷新所有额度”按钮，只拉取已登录账号的官方额度，不额外刷新模型目录；保留单账号刷新入口。
- **账号页视觉优化**：新增连接账号、开放模型和最近额度同步概览；优化服务标题、账号品牌状态、操作分组、加载反馈与窄屏布局，并区分“刷新上游额度”和“重新读取本地状态”。
- **刷新生命周期加固**：共享额度、模型目录和令牌续期在插件卸载时安全取消；单个等待者取消不会误伤同一账号的共享目录刷新，批量刷新可隔离单账号失败。

## 上一版升级 (2.3.1)

- **优化 GPT (Codex) 缓存命中率**：向 OpenAI/Codex 发送 Responses 请求时，在请求头中同步添加 `session-id`（取自稳定 `prompt_cache_key` / 会话标识），对齐官方客户端与后端网关会话粘滞（Session Affinity）契约，避免请求漂移至不同网关节点导致 KV Prompt Cache 击穿。

## 上一版升级 (2.3.0)

- **输入框下方额度圆环**：仅在当前会话选择 `Codex 订阅 · CPA` 或 `Antigravity 订阅 · CPA` 模型时显示；额度作为完整分组与 Token/缓存命中统计处于同一行，空间不足时整组换到下一行，5 小时与周额度绝不拆开。Codex 与 Gemini 分别只展示上游实际返回的窗口，缺失的窗口不会占位；每 5 分钟自动刷新，低余量切换为琥珀色或红色。
- **按模型记忆思考强度**：支持推理档位的模型会记住最近一次会话选择，切回该模型时自动恢复；未声明推理档位的模型不写入记忆，也不改变原有行为。

## 上一版修复 (2.2.2)

- **修复流式断连被误报为 `aborted / UNKNOWN`**：此前仅请求建立阶段处理网络异常，SSE 响应读取阶段的连接中断未被归类。现统一报告 `NETWORK`，让 Harness 现有策略最多重试 2 次；持续网络故障仍会明确报错，不会无限重试或冒充成功。
- **保持停止与工具安全语义**：用户主动停止仍保留原始取消原因；中途断开的工具调用不会被当作完成结果提交。协议格式错误仍为 `INVALID_RESPONSE`，不会误判为可重试网络错误。
- 新增 9 项离线回归测试，覆盖代理 `ECONNRESET`、Undici socket 断连、上游 `AbortError`、Codex/Antigravity 工具流中断、取消与错误信息脱敏。无需调用任务清单工具或启动其他模型。

## 上一版升级 (2.2.1)

- **Gemini 多模态与图片发送解锁**：修复了上游接口未声明模态导致 Gemini-3.8-Flash 等模型被错误标记为仅文本并禁用图片识别的缺陷。全面移除对模型图片能力的过度限制，智能识别 Antigravity 全系 Gemini/Claude 多模态能力，支持自由在设置中开启或关闭任意模型的图片识别。
- **全新现代化 UI 界面**：引入胶囊分栏选项卡（账号与模型、图片工坊、网络代理、系统诊断）、状态呼吸灯、iOS 风格切换开关、模型参数微调抽屉以及 SVG 高清矢量图标。

## 升级

你当前使用的是 Electron 独占管理的 `desktop` profile，命令行会拒绝修改它。请在 **Harness 已安装的插件管理器**中安装本地 `dsh-cliproxyapi-2.3.4.tgz`，然后重启应用。

**安装后需要重启 Harness 才能加载新代码**。已有登录凭据和模型偏好会保留；插件激活后会自动刷新已登录账号的额度与模型目录，也可在“设置 → 订阅账号”中手动刷新。普通 Web 安装可用 `dsh plugin --profile web add 包路径`；`npx` 安装则使用 `npx @deepseek-ai/dsh plugin --profile web add 包路径`。

## 模型设置

“设置 → 订阅账号”中展开对应渠道的“模型设置”，也可以直接搜索模型。

- **开放**：决定模型是否在模型选择器显示。关闭后，保存的会话和直接请求也不能继续使用该模型。
- **上下文 Token**：填写完整整数；清空恢复上游默认。有效值通过 Harness 的模型上下文元数据生效，驱动其上下文管理；不会凭空扩大上游模型的实际能力。已知上限取 `max_context_window`，无此字段时取目录上下文长度。
- **思考强度**：按模型目录实际支持的等级选择，包含目录提供的 low、medium、high、xhigh、max、ultra 等。设置为该模型默认值，会话内显式选择的强度优先。不支持或未声明的等级不冒充可用。
- **输出详略**：上游支持时可选简略、标准、详细，实际传入 Codex `text.verbosity`。
- **图片识别**：允许将已上传或工具读取的图片发送给模型。明确声明仅文本的模型不能用开关增加视觉能力。

每行点击“保存”才生效。刷新目录不会清除上述选择，也不会覆盖未保存的界面草稿。

## 图片生成、编辑与识别

- 在聊天中正常上传图片，选择已开放图片识别的模型，即可描述、分析图片。插件通过 Harness 附件服务读取和缩放图片，向 Codex 发送 `input_image`，向 Antigravity 发送 `inlineData`。
- 设置页中的“图片生成与编辑”可选择订阅渠道、图片模型、质量和尺寸；可上传最多 5 张明确的参考图进行编辑。
- Codex 默认图片模型为 `gpt-image-2`，调用订阅专用 `/images/generations` 或 `/images/edits`；该模型的实际使用资格由上游账号决定。
- Antigravity 图片模型来自其目录中声明图片输出的条目，通过 daily 订阅端点调用。其质量和尺寸暂使用上游默认值。
- 启用图片功能后，会话可调用原生工具 `cpa_image_generate`。编辑只允许引用当前会话中的图片，不会悄悄变成无参考图的新图生成。
- 图片保存到 Harness 的附件存储，设置页提供预览、查看原图和下载；原图通过文件附件原样保存。最近 50 项可在设置页访问；会话中的图片仍按 Harness 会话存储管理。

图片生成不会在失败后自动切换账号、模型或付费渠道。图片接口、参考图、附件保存与渲染经过模拟响应测试；本次未消耗订阅额度生成真实图片。

## 网络与错误

默认自动使用环境变量或 Windows 已启用的系统 HTTP 代理，也可在设置页手动指定地址或选择直连。代理变化在下一次请求生效。插件不启动外部代理程序，不修改系统代理。

429 本身不等于账号额度耗尽。插件只有在上游明确返回 `QUOTA_EXHAUSTED`、`usage_limit_reached` 等原因时才显示配额耗尽，其余作为限流或资源暂不可用，并保留上游给出的等待时间。DNS、连接和 TLS 错误分别显示，不在界面或日志中输出令牌。

## 测试与来源

```sh
npm ci --ignore-scripts
npm test
npm run pack:plugin
```

48 项回归测试覆盖授权、启动与批量刷新、目录共享取消语义、账号服务卸载、模型开关、上下文、按模型记忆思考强度、额度窗口筛选与同行换行契约、输出详略、图片输入与生成、SSE、流式断连与取消、Gemini 端点和代理行为。Windows 沙箱内可用 `node --test --test-isolation=none test/*.test.js` 运行离线测试。此前版本已在真实 Harness Web 运行时检查设置页、图片工具注册和上下文保存；本版未自动安装到当前 Harness。

参考本机 CLIProxyAPI，以及用户提供的 `dsh-codex-subscription-main` 2.1.0-beta.5。相关许可见 [THIRD_PARTY_NOTICES.md](THIRD_PARTY_NOTICES.md)。原始参考仓库未修改。

每个渠道仍保存一个订阅账号；本版不包含多账号轮询或跨账号自动故障切换。