# 使用指南
[返回首页](../README.md) · [English](GUIDE.en.md)
## 功能说明
### 执行中补充指令
沿用 DSH 原生消息队列：生成中发送消息可排队到下一轮；界面提供插话入口时，可用其快捷键将排队内容交给当前轮的下一步处理。插话不是立即改写正在生成的响应。
### 语音对话（Beta）
开启语音对话后，输入框为空时可用语音按钮开始通话。播报过程中开口会暂停当前声音，让你继续说；这不会取消 DSH 正在执行的任务。
DSH 提问时，语音会读出问题和带编号的选项。说“第二个”或完整选项名称即可提交；多道问题逐题回答，没有选项的问题可直接口述。识别不明确时会重读问题，断开语音后可回到 DSH 界面回答。
选择音色或切换回答语言会播放对应语言的试听。“跟你说的语言一致”使用英语试听，实际对话仍跟随你说的语言。没有样本的音色会显示暂无试听。
### GPT-Reserve（实验性）
账号的官方模型目录提供 `gpt-reserve` 时，模型选择器末尾会出现实验性选项。可用性和扣费归属由服务端决定；请求成功不代表已确认使用独立备用额度。即使普通 Codex 额度显示已用尽，服务端也可能只在模型目录中返回 `gpt-reserve`，不返回独立的 Reserve 额度桶。此时输入框将 Reserve 额度视为未知，不会借用普通 Codex 额度；服务端返回“允许使用”也不能证明请求扣的是 Reserve。
### GPT-6 Sol / Luna
GPT-6 Sol 和 GPT-6 Luna 已在 [OpenAI 的 Codex 模型说明](https://learn.chatgpt.com/docs/models)中列出。插件会从当前账号的 Codex 模型目录自动读取可用模型及推理档位，无需手动添加型号；账号尚未开放时不会显示。Sol 适合复杂编程，Luna 适合高频、目标明确的任务。两者的扩展上下文上限和高速模式以账号目录返回值为准。目录标注退役的模型会在模型名称旁显示退役日期，不会自动切换你的选择。
### GPT-6 Astra 上下文
**模型感知上下文**以模型目录为准，刷新不会覆盖未保存的草稿。
当官方模型目录提供 GPT-6 Astra 时，标准模式保留目录默认窗口；扩展模式使用 872000 Token，自定义模式可设置 128000–872000 Token（初始值为 272000）。该上限依据 [Codex 官方模型目录](https://github.com/openai/codex/blob/6af345407d9c2a568da9d01b6c4b81a9e61495c0/codex-rs/models-manager/models.json#L33-L34)，不是 API 模型的总上下文容量。这些设置只调整 DSH 的本地上下文预算，不授予模型访问权限，也不保证账号的服务端容量；实际可用性以服务端为准。
### 默认模型
在 **设置 → Codex 订阅 → 模型** 的“默认模型”里选择新建会话默认使用的模型。它写入的是 DSH 自己的默认模型设置，和你在对话里切换模型写的是同一处：选择后新建的每个会话都用这个模型；在对话里改选别的模型（包括非订阅模型）也会同步反映到这一项，此时显示“跟随 DSH 默认”。未列出的模型、未登录或模型目录为空时该控件不可用。
### 输入框额度
额度分组以服务端实际返回为准，不补造缺失的额度。
实机示例：GPT-6-Astra · Max（最高推理档）· 高速模式（闪电标识），左侧直接显示剩余额度。
可在“开始”页选择关闭、百分比、进度条或 Beta 续航预测。存在 5 小时额度时，输入框只显示短窗口；每周额度等完整信息留在悬浮详情。仅有周额度时省略“周”字，预测采用 `36% · ≈10h–12h` 这样的紧凑格式。
续航预测根据最近两小时的官方读数估算，额度不变的采样同样参与计算。满足条件时利用连续跳格约束速度，读数不足或使用强度变化时会退回保守估计。范围不是实际可工作时间的保证，仍标记 Beta。历史在本机有限保存；重置、长时间离线或关闭预测会重新校准。
Spark 使用独立额度。只返回每周额度的账号仍只显示每周，不会虚构 5 小时窗口、Credits 或消费上限。
### ChatGPT 连接器
在“联网与工具”里把 **ChatGPT 连接器** 设为“只读”“询问后写入”或“直接写入”后，所有 DSH 模型（包括 DeepSeek）都多出三个工具：`chatgpt_connectors_search` 搜索你在 ChatGPT 里已连接应用的工具，`chatgpt_connectors_describe` 查看参数，`chatgpt_connectors_call` 执行。支持 GitHub、Gmail、Google 云端硬盘、Google 日历等 ChatGPT 里能连接的应用，具体以你的账号为准。
- **只读**：只运行应用标记为只读的工具（搜邮件、读文件、查 PR 等）。
- **询问后写入**：发邮件、改文件、评论等会改动数据的操作，每次调用都会弹出审批，显示工具、参数和说明；手机远程控制开着时，审批也会出现在手机上。拒绝后不会发出任何请求。
- **直接写入**：同样的写操作直接执行，不再弹出审批，做错了无法撤回。只在你信任当前模型和任务时使用。
- 应用返回的内容来自第三方，模型被告知不要执行其中的指令。账号安全、插件管理等 ChatGPT 内部工具不开放。
- 需要先在 ChatGPT 网页里连接应用。默认关闭；工具列表缓存 10 分钟。
### 使用概览
额度卡片下方的“使用概览”显示官方使用统计：累计 token、单日最高、当前和最长连续使用天数、会话总数、最常用推理档、快速模式占比、最长单轮，以及最近半年每天 token 用量的热力图（颜色越深用得越多，悬停可看当天数字）。只读取统计数字，不读取头像、用户名等资料；展开时才读取，结果缓存 30 分钟。
### 额度去向
额度卡片下方的“额度去向（每周）”按周显示额度花在哪：按模型、入口（桌面应用等）、来源（你的对话、子任务、记忆整理）和触发方式拆分，数字是占该周期额度的百分比。数据来自官方用量报告，统计完成的周期才有拆分，通常有一两天延迟；账号没有该报告时这一块不出现。展开时才会读取，不影响平时的额度刷新。
### 安全使用额度重置
ChatGPT 返回可用重置卡时，设置页会把每张卡分别显示为紧凑的一行，并展示服务端提供的名称和到期时间。即使额度尚未到 100%，
也可以主动尝试使用，适合重置卡即将过期的情况；是否需要重置仍由 ChatGPT 判断，服务端可能返回“当前无需重置”且不扣次数。
最终操作需要勾选知情确认并等待 5 秒。取消不会消耗，快速连续点击只允许一次请求，网络结果不确定时也不会自动重试。
### 图片生成与编辑
订阅插件已内置基于 `dsh-image-viewer` 的基础查看器，无需额外安装。插件生成图片的工具卡片使用内置查看器，确保标注和继续编辑功能可用。你可以缩放、拖动、适合窗口、添加区域备注并下载图片。标准“下载”默认获取经过权限与完整性校验的精确原图；旧会话没有精确原图时才下载会话预览图。
新生成或编辑的图片会在工具结果中返回当前 DSH 主机上的原图路径，模型或 Agent 可以读取或复制该文件。该路径位于运行 DSH 的主机，并非浏览器下载链接；原图下载仍按会话授权。卸载插件不会删除已生成的原图。
点击“在输入框中继续编辑”不会自动发送。有标注时会附上干净源图和带编号标记的定位参考图，草稿包含对应编号、坐标、备注，以及不得把标记绘入成品的说明；没有标注时只附上当前图片。每个标记必须填写备注，参考图准备失败时会中止回填。按 Enter 保存并收起备注，Shift+Enter 换行；在当前 DSH 页面重新打开同一张图片时，备注仍会保留。
新的图片请求不会静默带入历史图片。GPT Image 2 可能比文本回复耗时更长，复杂文字、精确构图和连续角色一致性也可能需要再次调整。
上图展示图片查看与图上备注的基本交互；具体按钮会随图片和所安装的查看器版本变化。
### 草图画板（Beta）
点击输入框的草图按钮手动画图。`@sketch` 是 Agent 绘图入口：选择时只填入输入框，发送绘图请求后才由 Agent 打开画板。图片预览中可选择“进入草图”；上传、粘贴和移除附件仍由 DSH 原生组件处理。
草图支持多份本地草稿、图片图层、画布比例、三种笔刷（实色钢笔、颗粒铅笔、半透明荧光笔）、直线和形状、两种橡皮、撤销重做、拖动缩放与可配置快捷键。平滑仅在抬笔后处理整笔路径，不拖慢绘画光标。草稿最多 20 份，仅保存在当前浏览器；附加草图不会自动发送。左侧图片面板只管理当前草图的图片，不是会话图片库。
支持可选中修改的形状与文字、原生曲线，以及侧边粗细/浓度控件。Agent 绘制时可查看、缩放和关闭面板，编辑暂时锁定；顶部可停止绘制，完成后恢复编辑。自动完成预览默认关闭，可在“图片与草图”中开启。切换会话后再返回会保留画板、历史和运行状态。切到其他会话期间不保证后台绘制；整页刷新或退出前请保存草稿，未保存内容不保证恢复。
**用草图生成图片**：画好后点击“附加”，在输入框说明想要的效果，再发送；草图作为参考图，生成时保持构图。
**Agent 照参考图作画**：附上参考图，发送 `@sketch` 加要求。Agent 先用 `reference` 把参考图放进画板（隐藏图层），再分阶段画；每画完一批都会返回误差变化，可并排对比、看差异热图、局部放大、量颜色和边缘位置、撤销重画。画完点画板里的“回放”可以把过程一笔一笔重放，并录成视频（先预览，点“保存视频”才保存）。实测对比见 README 的“草图作画实测”，过程记录见 [绘图实验记录](sketch-drawing-experiments.md)。Agent 优先用 SVG 命令整段绘制，导入后仍是可编辑的原生笔画。
图片请求中的 Flare / Sunburst 型号选项仍属实验性功能。成功生成不代表订阅后端确认采用指定型号或质量；不会把请求参数当成实际返回型号。
### 输入框速度
选择支持的 Codex 模型后，可在输入框的模型菜单中切换标准与高速。标准模式不增加图标，
只有高速模式会在模型名称左侧显示闪电；Spark 不显示速度入口。高速模式会提高速度，也会消耗更多 Credits；具体规则见
[OpenAI Codex Speed 文档](https://learn.chatgpt.com/docs/agent-configuration/speed)。
**极速 Ultrafast（Beta）**：只有当前账号的模型目录给某个模型列出 `ultrafast` 档位时（发布会上仅限 Pro 500 的 GPT-6 Astra），该模型的速度菜单才会多出“极速”。选了极速后，切到不支持它的模型会按标准档发送，不会替你改用 Fast。该档位速度最快，额度和 Credits 消耗也更快。因为还没有在 Pro 500 账号上实机验证，所以标为 Beta。
**账号目录里的 `ultra` 推理档**：部分模型（如 GPT-6-Astra、GPT-6.1-Sol）的目录已列出 `ultra` 推理档，但 DSH 的推理档位表目前只有 off、minimal、low、medium、high、xhigh、max，主输入框无法选择它；插件不会把它改映射成别的档位。Codex 独立子任务可以在聊天里指定 `ultra`。设置 → 维护 的诊断会把它列为“目录含尚未适配的能力”，这不代表模型不可用。
### 手机远程控制（Beta）
在 **设置 → Codex 订阅 → 手机与更多 → 手机远程控制** 打开后，这台电脑上的 DSH 会出现在 ChatGPT 手机 App 的 Codex 主机列表里。点“生成配对码”，用手机扫码，或在 App 里输入手动码；二维码约 10 分钟有效。
- 手机上可以查看历史会话、新建会话、续聊、中断、排队消息、分叉、归档和取消归档，并切换模型（含 DeepSeek 与其他第三方模型）、推理档位和权限（工作区内修改 / 完全访问）。
- DSH 工作区对应手机上的项目，可以在项目里直接新建对话；也能看到用量额度、套餐和上下文用量。
- 回复边生成边显示；命令、文件修改（带差异）、任务清单和生成的图片用手机原生视图显示。
- 可以在手机上发图片（可配文字），前提是所选模型支持图片输入；手机的文件夹选择器能浏览电脑上真实的文件夹。
- 在手机上用 `@` 搜索对话文件夹里的文件，用 `/` 选择 DSH 技能；搜索对话按标题查找（DSH 开启消息索引时也会搜消息内容），打开对话后可在其中搜索关键词并跳到对应消息；手机的用量页显示你的 Codex 累计用量和每日热力图。
- “查看改动”可用：手机请求的命令只会在对话所在的文件夹里运行，并且只放行一小批只读的 git 命令（status、diff、log 等）；其他命令一律拒绝。
- 连接中断后，手机还没确认收到的消息会在重连后补发；电脑休眠或网络切换导致的假连接会在约一分钟内被识别并重连。
- 设置里的“已配对的手机”可以看到配对过的手机，并随时移除。
- DSH 需要批准工具调用或向你提问时，手机会弹出对应的选择；手机掉线后两分钟内重新打开对话会再次弹出，否则交回电脑处理。
- 模型报错（缺 Key、额度用完等）会显示在手机上。
- 只在本机保存一个主机标识，配对用的凭据不落盘；关闭开关即断开。
- 本功能基于 Codex Remote Control 协议实现第三方主机兼容，使用 OpenAI 的远程连接服务；DSH 作为第三方主机的接入方式尚不属于官方明确承诺支持的范围，后续服务更新可能影响兼容性，所以标为 Beta。该功能不代表获得 OpenAI 官方认证或背书。出于安全，手机不能在电脑上执行任意命令，只有上面说的只读 git 可用。
### 高级实验选项
在 **模型** 页的“高级”中按需开启，默认仍使用 SSE 和 DSH 子任务：
- 可在“设置 → Codex 订阅 → 模型”设置**输入图片精度**，默认自动；精度越高，输入 token 用量越大。
- 同一处可设置**流无响应超时**（默认 10 分钟），限制连续没有流式数据的时间，而非整体回答时限；调低可能中断仍在推理的慢回答，并交由 DSH 重试处理。
- **WebSocket**：复用连接和可复用的上下文传输；握手失败可回退 SSE，已开始的响应中断会报错，不自动重放。下次请求生效，不增加模型上下文容量，也不保证更快。
- **Codex 独立子任务**：复用订阅登录和官方 DSH Codex 运行时，无需另行登录；可选组件在“联网与工具”中安装。默认继承当前订阅模型及工作区权限。在“插件 → 子智能体”开启模型选择、勾选允许的模型并新建会话后，可在聊天中指定子任务模型与推理档位；非订阅会话需明确选择订阅模型。共享上下文的子任务仍交给 DSH。Codex 子任务只提供工作区工具，不带你的 ChatGPT 已连接应用（日历、站点部署等）、插件安装和浏览器/电脑控制，以免在自动授权下被误用。
## 可选 Codex 子任务运行时
### 安装、停用与卸载说明
普通订阅聊天、图片和 DSH 原生子任务不需要 Codex CLI。只有“联网与工具”中的 **Codex 独立子任务（Beta）** 需要额外准备官方运行时，插件不会后台自动下载。
在 **设置 → Codex 订阅 → 联网与工具 → 子任务** 点击 **安装组件**。DSH 负责安装，页面显示当前阶段，可取消尚未应用的安装；完成后重启，再选择 Codex。安装不会自动开启子任务。
优先使用上面的 **安装组件** 按钮。插件会按当前 DSH 版本选择对应组件：DSH `0.2.0-rc.2` 安装组件 `0.2.0-rc.2`，DSH `0.1.5-rc.2` 安装组件 `0.1.5-rc.2`；已安装的 `0.1.5-rc.3` 组件仅在同版本宿主上识别。请不要省略组件版本号或自行改用 `@next`。
### 旧版宿主手动安装与离线准备
插件安装页面填写与当前 DSH 相同版本的组件，以下为固定版本示例：DSH `0.2.0-rc.2` 填写 `@deepseek-ai/dsh-subagent-codex@0.2.0-rc.2`。终端方式：
```sh
dsh plugin --profile web add @deepseek-ai/dsh-subagent-codex@0.2.0-rc.2
```
安装到订阅插件所在的同一个 profile，完成后重启。离线使用须提前在目标系统与架构上安装并验证完整运行时；只复制订阅插件或 Codex 启动脚本不够。模型请求仍需联网。
### 不再使用时
只想停用：在“联网与工具”关掉“让官方 Codex 执行子任务”，或切回 **DSH**，组件仍保留，之后可再次开启。
要卸载：在同一位置点击 **卸载组件** 并确认。插件会检查正在运行的子任务，切回 DSH 后交给官方接口卸载；有任务运行时不能卸载。完成后重启。旧版宿主可在终端执行（将 `web` 替换为实际安装的 profile）：
```sh
dsh plugin --profile web remove @deepseek-ai/dsh-subagent-codex
```
卸载的是可选子任务组件，不是订阅插件；普通订阅聊天、生图和 DSH 原生子任务不受影响。若其他插件仍依赖该组件，包管理器可能保留它。
### 存储与清理
卸载不等于清空共享安装缓存，也不能保证释放某个固定大小。安装缓存由 DSH／Portable 统一管理，本插件不直接删除共享目录。草稿、会话记录、生成原图和登录信息不是安装缓存；需要删除时应使用各自的管理入口，不做一键混合清理。
“维护”中的 **存储与缓存** 可查看额度预测缓存占用，并确认清除本地预测历史。清除后需要重新积累采样，不改变服务端额度。支持诊断额外提供 WebSocket 连接／复用／回退计数及云端压缩检查点的保存／复用计数，不包含响应正文和会话标识。计数只反映当前运行期间的观察，不能据此推算性能提升。