dsh-codex-subscription 3.0.0-beta.4 → 3.0.0-beta.6

package/README.md

@@ -18,17 +18,122 @@
 [![MIT](https://img.shields.io/badge/license-MIT-111111.svg)](LICENSE)
 [![Star](https://img.shields.io/github/stars/WSL043/dsh-codex-subscription?style=flat&logo=github&label=Star)](https://github.com/WSL043/dsh-codex-subscription/stargazers)
 
-[功能](#功能一览) · [安装](#安装) · [日常使用](#界面一览) · [作品案例](#从草图到作品) · [使用指南](docs/GUIDE.zh-CN.md) · [更新与卸载](#更新与卸载)
+[安装](#安装) · [核心功能](#核心功能) · [手机远程控制](#手机远程控制beta) · [作品案例](#从草图到作品) · [全部功能](#全部功能) · [使用指南](docs/GUIDE.zh-CN.md) · [常见问题](#常见问题)
 
 </div>
 
-<p align="center"><img src="docs/assets/product-account-demo.png" width="1100" alt="Codex 订阅账号与额度界面：模型选择、双周期额度与提醒；使用演示数据"></p>
+<p align="center"><img src="docs/assets/hero-zh.webp" width="1100" alt="已有的订阅，在 DSH 接着用：鲸鱼少女吉祥物与 Codex 订阅账号额度界面"></p>
 
-## 功能一览
+## 准备 DSH
+
+已验证兼容 DSH `0.2.0-rc.2`（`latest` 与 `next` 通道），最低支持 `0.1.7-rc.2`；更早的 DSH 请先升级。
+
+本插件支持软件包元数据中记录的最新版 DeepSeek Harness，并需要一个当前具有 Codex 使用资格的 ChatGPT 账户。
+
+- **推荐：官方桌面端**。DeepSeek 已发布 [DeepSeek Harness 桌面版](https://www.deepseek.com/harness/)（macOS Apple Silicon、Windows 64 位，预览版、开源），无需配置 Node.js，安装后按下文在插件页面添加本插件即可。桌面端与网页版、命令行使用同一套 DSH 插件系统；本插件的端到端验收主要在网页版上完成，桌面端遇到问题请[提交 issue](https://github.com/WSL043/dsh-codex-subscription/issues)；
+- 需要 Linux，或想要社区便携分发：使用 [DSH-Portable](https://github.com/WSL043/DSH-Portable)。这是面向 Windows、macOS 和 Linux 的社区便携桌面分发；
+- 想按官方方式运行：查看 [DeepSeek Harness 官方说明](https://github.com/deepseek-ai/deepseek-harness#run)。
+
+## 安装
+
+### 在插件页面安装（推荐）
+
+1. 打开 DSH 的 **插件 → 添加插件**。
+2. 在 **包名或地址** 输入框中粘贴下面的包名（已带版本号）：
+
+   ```text
+   dsh-codex-subscription@2.6.8
+   ```
+
+3. 点击 **安装**，等待安装完成；按页面提示操作，需要重启时先保存工作。
+4. 打开 **设置 → Codex 订阅**，登录 ChatGPT，然后在会话中选择 Codex 模型。
+
+为什么要带版本号：DSH 的插件页只会安装发布满 24 小时的版本，只填包名时，新版本发布后的第一天可能装到更早的旧版，而旧版不一定兼容你的 DSH。带上版本号可以直接装到这一版；发布一天后只填 `dsh-codex-subscription` 也会装到最新正式版。其他版本号见[发布页](https://github.com/WSL043/dsh-codex-subscription/releases)。
+
+<details>
+<summary>终端安装（已能运行 dsh 命令）</summary>
+
+```sh
+dsh plugin --profile web add dsh-codex-subscription@2.6.8
+```
+
+安装完成后按提示重启 DSH，再到 **设置 → Codex 订阅** 登录。插件页面和终端均由 DSH 管理安装。
+
+</details>
+
+<details>
+<summary>Headless 任务</summary>
+
+先在 Web 中完成登录并选择一次 Codex 模型，再把同一个插件安装到 Headless profile：
 
-把订阅接入、模型控制、额度管理和图片创作放在同一个 DSH 工作流里。下面逐项列出插件提供的能力；模型权限和额度以账号实际返回为准。
+```sh
+dsh plugin --profile headless add dsh-codex-subscription@2.6.8
+dsh --profile headless "只回复：ok"
+```
+
+</details>
+
+## 核心功能
+
+### 用订阅登录，直接用 Codex 模型
+
+在 DSH 的 **设置 → Codex 订阅** 登录 ChatGPT，会话里就能选 GPT-6 等账号目录里的模型，调推理档位和速度档位，并使用订阅联网搜索。不需要 API Key。模型和额度以账号实际返回为准。
+
+### 额度一眼看清
+
+短周期和每周额度、重置时间、额外 Credits 与重置卡都在设置里；输入框旁可以常驻显示剩余额度，低于阈值会提醒。
+
+<p align="center"><picture><source media="(prefers-color-scheme: dark)" srcset="docs/assets/ui-quota-zh-dark.png"><img src="docs/assets/ui-quota-zh-light.png" width="560" alt="额度卡片：每周额度与重置时间，下方可展开使用概览和额度去向"></picture></p>
+
+<details>
+<summary>使用概览与额度去向：累计用量、连续天数、每日热力图，以及每周额度花在哪</summary>
+<br>
+<p align="center"><img src="docs/assets/usage-overview.png" width="460" alt="额度卡片里的使用概览与额度去向：累计 token、连续使用天数、最近半年每日用量热力图，以及每周额度按模型、入口、来源的拆分"></p>
+</details>
+
+### 日常操作，留在输入框
+
+选模型、调推理档位、切换速度档位，同时查看剩余额度，无需为每次请求打开设置。
+
+<p align="center"><picture><source media="(prefers-color-scheme: dark)" srcset="docs/assets/ui-composer-zh-dark.png"><img src="docs/assets/ui-composer-zh-light.png" width="760" alt="输入框：权限、草图、剩余额度、闪电标识的 Fast 模式和模型选择"></picture></p>
+
+### 手机远程控制（Beta）
 
-### 模型与搜索
+用 ChatGPT 手机 App 的 Codex 扫码配对，这台电脑上的 DSH 就出现在手机的主机列表里，DeepSeek 等任意 DSH 模型都能在手机上用：
+
+- 查看、新建、续聊、中断、归档对话，搜索对话和对话内的关键词；
+- 切换模型、推理档位和权限（工作区内修改 / 完全访问）；
+- 批准工具调用或回答提问时手机直接弹出；手机掉线，重新打开会再弹一次，否则交回电脑处理；
+- 回复边生成边显示；命令、文件修改（带差异）、任务清单、联网搜索、连接器调用和生成的图片用手机原生视图显示；
+- 发图片，@ 搜电脑上的文件，/ 选 DSH 技能，只读 git 查看改动，用真实的文件夹选择器新建对话；
+- DSH 工作区对应手机上的项目；可以从手机分叉对话，看用量额度、累计用量和上下文用量；
+- 模型报错会显示在手机上；设置里能看到已配对的手机，随时移除。
+
+默认关闭：**设置 → Codex 订阅 → 模型与运行 → 手机远程控制**。电脑需要保持开机、联网并打开 DSH。这是 OpenAI 尚未向第三方开放的 ChatGPT 能力，随时可能变化，所以标为 Beta，目前在预发布版中提供：`dsh-codex-subscription@3.0.0-beta.5`。
+
+<p align="center"><picture><source media="(prefers-color-scheme: dark)" srcset="docs/assets/ui-remote-zh-dark.png"><img src="docs/assets/ui-remote-zh-light.png" width="560" alt="设置里的手机远程控制：开关、配对二维码和手动码、已配对的手机"></picture></p>
+
+### 图片与草图（Beta）
+
+用订阅生成图片，在图上圈出区域写备注继续修改，或者打开草图画板自己画、让 Agent 画，再以草图为参考生成成品。
+
+<p align="center"><img src="docs/assets/annotate-zh.webp" width="900" alt="图片预览：在烟囱上方圈出区域并写下备注，再带着备注继续编辑"></p>
+
+案例见 [从草图到作品](#从草图到作品)，开关在 **设置 → Codex 订阅 → 图片与草图**。
+
+### ChatGPT 连接器（Beta）
+
+让 DeepSeek 等任意 DSH 模型使用你在 ChatGPT 里连接的应用：GitHub、Gmail、Google 云端硬盘、日历等。模型先搜索再调用，写操作每次都要你批准。默认关闭，在“模型与运行”里开启。
+
+[详细用法、限制与可选组件 →](docs/GUIDE.zh-CN.md)
+
+## 全部功能
+
+模型权限和额度以账号实际返回为准。
+
+<details>
+<summary><b>模型与搜索</b>（13 项）</summary>
+<br>
 
 | 功能 | 你可以做什么 | 使用方式 / 条件 |
 | --- | --- | --- |
@@ -46,12 +151,18 @@
 | **上下文预算** | 按模型使用标准、扩展或自定义上下文预算 | 受模型目录上限约束 |
 | **GPT-Reserve** | 在账号开放时选择备用模型入口 | 实验性；不承诺独立备用额度 |
 
-### 账号与额度
+</details>
+
+<details>
+<summary><b>账号与额度</b>（10 项）</summary>
+<br>
 
 | 功能 | 你可以做什么 | 使用方式 / 条件 |
 | --- | --- | --- |
 | **多账号管理** | 添加、切换、移除账号，或退出全部账号 | 设置 → 账号与额度 |
 | **额度详情** | 查看短周期 / 每周额度、重置时间及独立额度分组 | 仅展示服务端返回的窗口与分组 |
+| **额度去向** | 在额度卡片里按周查看额度花在哪：按模型、入口、来源和触发方式拆分 | 来自官方用量报告，近似值，有一两天延迟；账号没有该报告时不显示 |
+| **使用概览** | 在额度卡片里查看累计 token、单日最高、连续使用天数、最常用推理档，以及最近半年的每日用量热力图 | 来自官方使用统计；账号没有该统计时不显示 |
 | **Credits 与重置卡** | 查看额外 Credits、消费上限和可用重置卡 | 账号返回对应数据时显示 |
 | **输入框额度** | 不离开会话即可查看百分比或进度条 | 默认关闭，可选显示方式 |
 | **续航预测** | 根据最近使用速度估算剩余可用时长 | Beta；可选，不是保证值 |
@@ -59,7 +170,11 @@
 | **使用重置卡** | 在确认后主动使用服务端提供的重置卡 | 二次确认与等待保护，由服务端判定结果 |
 | **重置后重试** | 等待已确认的短时额度重置，再继续请求 | 默认关闭；等待期间可停止 |
 
-### 图片与草图
+</details>
+
+<details>
+<summary><b>图片与草图</b>（12 项）</summary>
+<br>
 
 | 功能 | 你可以做什么 | 使用方式 / 条件 |
 | --- | --- | --- |
@@ -76,71 +191,27 @@
 | **Agent 绘图** | 用 `@sketch` 让 Agent 绘制，查看进度并随时停止；Agent 可用 SVG 整段作画，导入为可编辑原生笔画 | Beta；默认关闭，需同时开启画板 |
 | **绘图结果回看** | 完成后向模型返回画布预览，帮助后续检查 | Beta；默认关闭，会增加图片输入用量 |
 
-### 进阶能力与维护
+</details>
+
+<details>
+<summary><b>进阶能力与维护</b>（9 项）</summary>
+<br>
 
 | 功能 | 你可以做什么 | 使用方式 / 条件 |
 | --- | --- | --- |
-| **手机远程控制** | 在 ChatGPT 手机 App 的 Codex 里直接指挥电脑上的 DSH：新建、续聊、归档对话，切换模型和权限，回答审批和提问，DeepSeek 等任意 DSH 模型都能用 | Beta（3.0.0-beta.4）；默认关闭，设置 → Codex 订阅 → 模型与运行 → 手机远程控制，扫码或输入手动码配对 |
+| **手机远程控制** | 在 ChatGPT 手机 App 的 Codex 里直接指挥电脑上的 DSH：新建、续聊、归档对话，切换模型和权限，回答审批和提问，DeepSeek 等任意 DSH 模型都能用 | Beta（3.0.0-beta.5）；默认关闭，设置 → Codex 订阅 → 模型与运行 → 手机远程控制，扫码或输入手动码配对 |
 | **Codex 独立子任务** | 复用订阅登录和工作区权限执行独立任务，可指定允许的模型与推理档位 | Beta；默认 DSH，Codex 需安装可选组件并配置模型选择 |
 | **子任务组件管理** | 在设置里安装、停用或卸载官方 Codex 子任务组件 | 由支持的 DSH 宿主管理，无需额外登录 |
 | **云端上下文压缩** | 使用 Codex 云端压缩继续长对话，同时保留 DSH 历史与原生压缩 | Beta / 实验性；默认关闭，开启的请求使用 SSE |
 | **WebSocket 连接** | 实验性复用连接和上下文传输，连接失败可回退 SSE | Beta / 实验性；默认 SSE，不保证更快 |
 | **Auto review 官方审查模型** | DSH Auto review 改用 Codex 自带的审查模型判断工具调用，审查规则与放行流程仍由 DSH 负责 | Beta；默认关闭，账号目录提供该模型时生效 |
+| **ChatGPT 连接器** | 让 DeepSeek 等任意 DSH 模型使用你在 ChatGPT 里连接的应用：GitHub、Gmail、Google 云端硬盘、日历等；模型先搜索再调用，写操作每次都要你批准 | Beta；默认关闭，设置 → Codex 订阅 → 模型与运行 → ChatGPT 连接器；需先在 ChatGPT 里连接应用 |
 | **支持诊断** | 查看功能前置条件和近期操作结果，一键复制约 1 KB 的精简报告（完整报告可另行复制）；不含凭据和会话正文 | 设置 → 维护；未验证不代表故障 |
 | **预测缓存清理** | 查看并清理本地额度预测历史 | 保留登录、草稿、原图和共享依赖 |
 
-[详细用法、限制与可选组件 →](docs/GUIDE.zh-CN.md)
-
-## 准备 DSH
-
-已验证兼容 DSH `0.2.0-rc.2`（`latest` 与 `next` 通道），最低支持 `0.1.7-rc.2`；更早的 DSH 请先升级。
-
-本插件支持软件包元数据中记录的最新版 DeepSeek Harness，并需要一个当前具有 Codex 使用资格的 ChatGPT 账户。
-
-- **推荐：官方桌面端**。DeepSeek 已发布 [DeepSeek Harness 桌面版](https://www.deepseek.com/harness/)（macOS Apple Silicon、Windows 64 位，预览版、开源），无需配置 Node.js，安装后按下文在插件页面添加本插件即可。桌面端与网页版、命令行使用同一套 DSH 插件系统；本插件的端到端验收主要在网页版上完成，桌面端遇到问题请[提交 issue](https://github.com/WSL043/dsh-codex-subscription/issues)；
-- 需要 Linux，或想要社区便携分发：使用 [DSH-Portable](https://github.com/WSL043/DSH-Portable)。这是面向 Windows、macOS 和 Linux 的社区便携桌面分发；
-- 想按官方方式运行：查看 [DeepSeek Harness 官方说明](https://github.com/deepseek-ai/deepseek-harness#run)。
-
-## 安装
-
-### 在插件页面安装（推荐）
-
-1. 打开 DSH 的 **插件 → 添加插件**。
-2. 在 **包名或地址** 输入框中粘贴下面的包名（已带版本号）：
-
-   ```text
-   dsh-codex-subscription@2.5.9
-   ```
-
-3. 点击 **安装**，等待安装完成；按页面提示操作，需要重启时先保存工作。
-4. 打开 **设置 → Codex 订阅**，登录 ChatGPT，然后在会话中选择 Codex 模型。
-
-为什么要带版本号：DSH 的插件页只会安装发布满 24 小时的版本，只填包名时，新版本发布后的第一天可能装到更早的旧版，而旧版不一定兼容你的 DSH。带上版本号可以直接装到这一版；发布一天后只填 `dsh-codex-subscription` 也会装到最新正式版。其他版本号见[发布页](https://github.com/WSL043/dsh-codex-subscription/releases)。
-
-<details>
-<summary>终端安装（已能运行 dsh 命令）</summary>
-
-```sh
-dsh plugin --profile web add dsh-codex-subscription@2.5.9
-```
-
-安装完成后按提示重启 DSH，再到 **设置 → Codex 订阅** 登录。插件页面和终端均由 DSH 管理安装。
-
 </details>
 
-<details>
-<summary>Headless 任务</summary>
-
-先在 Web 中完成登录并选择一次 Codex 模型，再把同一个插件安装到 Headless profile：
-
-```sh
-dsh plugin --profile headless add dsh-codex-subscription@2.5.9
-dsh --profile headless "只回复：ok"
-```
-
-</details>
-
-## 界面一览
+## 界面演示
 
 <details>
 <summary><b>界面演示（动图，点击展开）</b>：选模型、提问、出图、标注、草图、额度与重置</summary>
@@ -148,32 +219,6 @@ dsh --profile headless "只回复：ok"
 <p align="center"><img src="docs/assets/readme-demo.webp" width="1100" alt="演示：登录 ChatGPT 选订阅模型、提问、用订阅出图、查看与标注、进入草图、查看额度与重置"></p>
 </details>
 
-### 日常操作，留在输入框
-
-选模型、调推理档位、切换速度档位，同时查看剩余额度。无需为每次请求打开设置。
-
-<p align="center"><img src="docs/assets/composer-astra-fast.png" width="800" alt="DSH 输入框：GPT-6-Astra Max、闪电标识的 Fast 高速模式与剩余额度"></p>
-
-### 手机远程控制 DSH（Beta）
-
-打开 **设置 → Codex 订阅 → 模型与运行 → 手机远程控制**，用 ChatGPT 手机 App 的 Codex 扫码配对，这台电脑上的 DSH 就会出现在手机的主机列表里：
-
-- 在手机上查看、新建、续聊、中断和归档 DSH 对话，DeepSeek、Codex 以及其他 DSH 模型都能用；
-- 在手机上切换模型、推理档位和权限（工作区内修改 / 完全访问）；
-- DSH 需要批准工具调用或向你提问时，手机会直接弹出；手机掉线会在重新打开时再弹一次，否则交回电脑处理；
-- 回复边生成边显示在手机上；
-- 命令、文件修改（带差异）、任务清单、生成的图片在手机上用原生视图显示，文件修改的审批也能看到差异；
-- DSH 工作区对应手机上的项目，可在项目里新建对话，也能从手机分叉对话、看到用量额度和上下文用量；
-- 手机上可以用 @ 搜索电脑上的文件、用 / 选择 DSH 技能，也能在手机上查看改动（只读 git）；
-- 设置里可以看到已配对的手机，并能随时移除；
-- 在手机上发图片（可配文字），DSH 生成的图片也会显示在手机上；
-- 手机的文件夹选择器能浏览这台电脑上真实的文件夹，新对话可以直接在其中开始；
-- 模型报错会显示在手机上。
-
-默认关闭。电脑需要保持开机、联网并打开 DSH。这是 OpenAI 尚未向第三方开放的 ChatGPT 能力，随时可能变化，所以标为 Beta。目前在预发布版中提供：`dsh-codex-subscription@3.0.0-beta.4`。
-
-<p align="center"><img src="docs/assets/remote-control.png" width="560" alt="官方桌面版设置页：手机远程控制已连接，显示配对二维码和手动码"></p>
-
 ### 账号与偏好，集中管理
 
 在 **设置 → Codex 订阅** 中管理账号和额度；其余功能按任务需要开启。
@@ -292,9 +337,9 @@ SVG 版在“这次只在草图画布上画”之前多加了一句：
 <details>
 <summary>查看图片与草图设置</summary>
 
-<p align="center"><img src="docs/assets/real-creative-zh.png" width="564" alt="图片与草图设置：生图编辑、请求型号，以及独立的画板和 Agent 开关"></p>
+<p align="center"><picture><source media="(prefers-color-scheme: dark)" srcset="docs/assets/ui-creative-zh-dark.png"><img src="docs/assets/ui-creative-zh-light.png" width="564" alt="图片与草图设置：图片生成与编辑、创作入口、请求型号与质量"></picture></p>
 
-DSH 实机设置截图。
+DSH 实机设置截图，随浅色 / 深色主题切换。
 
 </details>
 
@@ -302,14 +347,6 @@ DSH 实机设置截图。
 
 [图片编辑与草稿保存 →](docs/GUIDE.zh-CN.md#图片生成与编辑beta)
 
-<a id="codex-subtask-runtime"></a>
-
-## 按需扩展
-
-普通订阅聊天无需 Codex CLI。需要 **Codex 独立子任务** 时，可在“模型与运行”中点击“安装组件”，停用和卸载也在同一处完成。其余实验选项按需开启。
-
-[可选组件、存储清理与完整使用指南 →](docs/GUIDE.zh-CN.md)
-
 ## 更新与卸载
 
 在 DSH **插件** 页面找到本插件，使用更新或卸载操作，完成后按页面提示重启。卸载插件不会删除其他插件。
@@ -318,7 +355,7 @@ DSH 实机设置截图。
 <summary>终端方式</summary>
 
 ```sh
-dsh plugin --profile web update dsh-codex-subscription@2.5.9
+dsh plugin --profile web update dsh-codex-subscription@2.6.8
 ```
 
 仅在需要卸载时运行：
@@ -331,13 +368,6 @@ dsh plugin --profile web remove dsh-codex-subscription
 
 ## 常见问题
 
-<details>
-<summary>DSH 0.2.0-rc.2 提示插件不兼容？</summary>
-
-2.2.10 之前的所有版本发布时 DSH 0.2.0-rc.2 还不存在，其兼容声明无法事后修改。请安装 2.2.10 或更高版本（只填包名时，发布满 24 小时前可能装到旧版，请直接填 `dsh-codex-subscription@2.2.10`）：在 **插件** 页面更新，或运行 `dsh plugin --profile web update dsh-codex-subscription@2.5.9`，然后重启 DSH。
-
-</details>
-
 <details>
 <summary>和官方插件列表里的 Codex 组合包（dsh-hooks-codex）是什么关系？</summary>
 
@@ -368,15 +398,12 @@ dsh plugin --profile web remove dsh-codex-subscription
 
 </details>
 
-## 当前图标
-
-这是当前使用的插件图标，以及它在 DSH「已安装」列表中的实际显示效果。
-
-<p align="center"><img src="icon-subscription.webp" width="200" height="200" alt="当前 Codex 订阅插件图标"></p>
+<details>
+<summary>需要装 Codex 命令行才能用吗？</summary>
 
-<p align="center"><img src="docs/assets/plugin-installed.png" width="800" alt="DSH 已安装列表中的 Codex 订阅插件卡片"></p>
+普通订阅聊天不需要。只有想用 **Codex 独立子任务** 时，才在“设置 → Codex 订阅 → 模型与运行”里点“安装组件”，停用和卸载也在同一处。其余实验选项按需开启。[可选组件、存储清理与完整说明 →](docs/GUIDE.zh-CN.md)
 
-<sub>DSH 0.1.7-alpha.2 实机界面。</sub>
+</details>
 
 ## 定位与边界
 

package/compatibility.json

@@ -7,6 +7,7 @@
   ],
   "previews": [
     "0.2.1-alpha.1",
-    "0.2.1-alpha.2"
+    "0.2.1-alpha.2",
+    "0.2.1-alpha.3"
   ]
 }