dsh-codex-subscription 2.2.1 → 2.2.3

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/README.md CHANGED
@@ -1,13 +1,14 @@
1
- # DSH Codex Subscription — 在 DeepSeek Harness 使用 ChatGPT 订阅
1
+ <p align="center"><img src="icon-subscription.webp" width="128" height="128" alt="DSH Codex Subscription 图标"></p>
2
2
 
3
3
  <div align="center">
4
4
 
5
+ # DSH Codex Subscription
6
+
5
7
  **简体中文** · [English](https://github.com/WSL043/dsh-codex-subscription/blob/main/README.en.md)
6
8
 
7
9
  **把 ChatGPT / Codex 订阅直接接入 DeepSeek Harness**
8
10
 
9
- 在 DeepSeek Harness 中直接登录 ChatGPT 并使用 Codex 订阅。无需 OpenAI API Key,也不依赖 Codex CLI;
10
- 模型、搜索、额度和图片生成都留在 DSH 里。
11
+ 登录已有订阅,即可在 DSH 中选模型、查额度、搜索和生图。无需 API Key,也不依赖 Codex CLI。
11
12
 
12
13
  [![CI](https://github.com/WSL043/dsh-codex-subscription/actions/workflows/ci.yml/badge.svg)](https://github.com/WSL043/dsh-codex-subscription/actions/workflows/ci.yml)
13
14
  [![npm](https://img.shields.io/npm/v/dsh-codex-subscription?logo=npm&label=npm)](https://www.npmjs.com/package/dsh-codex-subscription)
@@ -15,52 +16,77 @@
15
16
  [![MIT](https://img.shields.io/badge/license-MIT-111111.svg)](LICENSE)
16
17
  [![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)
17
18
 
18
- [三步开始](#三步开始) · [安装](#安装) · [参与贡献](CONTRIBUTING.md) · [更新与卸载](#更新与卸载)
19
+ [功能](#功能一览) · [安装](#安装) · [日常使用](#界面一览) · [作品案例](#从草图到作品) · [使用指南](docs/GUIDE.zh-CN.md) · [更新与卸载](#更新与卸载)
19
20
 
20
21
  </div>
21
22
 
22
- <p align="center">
23
- <img src="docs/assets/codex-subscription-overview.webp" width="900" alt="在 DeepSeek Harness 登录 ChatGPT 并使用 Codex 订阅:无需 API Key,支持模型选择和剩余额度显示">
24
- </p>
25
-
26
- 已适配 DSH `0.1.7-rc.2` 的插件兼容性检查与设置接口,同时保留已支持版本的兼容。
27
-
28
- ## 三步开始
29
-
30
- 1. **安装插件**:打开 **插件 → 添加插件**,在 **包名或地址** 中填写 `dsh-codex-subscription`,点击 **安装**。
31
- 2. **登录订阅**:按安装结果提示操作;若提示需要重启,先保存工作再重启。打开 **设置 -> Codex 订阅**,点击浏览器登录。无需 Codex CLI,也不要粘贴 token。
32
- 3. **开始使用**:在模型选择器中选择 Codex;额度、订阅搜索、图片生成和高速模式都在 DSH 内使用。
33
-
34
- 详细安装步骤、终端方式以及更新与卸载说明见下文。
35
-
36
- ## 核心优势
37
-
38
- | 能力 | 用户得到什么 |
39
- | --- | --- |
40
- | **订阅模型直连** | 登录 ChatGPT 后直接使用 Codex,不需要 OpenAI API Key 或 Codex CLI |
41
- | **可恢复、可诊断** | 登录状态会自动对账;读取失败时可在原处重试,超时和旧账号响应不会覆盖当前状态;设置页可生成不含凭据和账号标识的支持报告 |
42
- | **额度可见** | 普通 Codex、Spark 等服务端实际返回的额度分开显示,并显示重置时间 |
43
- | **可选额度恢复** | 可选择让对话等待已确认的短时 Codex 额度重置;对话会显示等待原因、仍可停止,等待期间切换账号会立即重试 |
44
- | **输入框额度** | 可选择紧凑百分比、进度条、Beta 续航预测或关闭显示 |
45
- | **安全额度重置** | 每张重置卡单独显示,并通过冷静期和知情确认主动尝试重置 |
46
- | **订阅搜索** | 可将全部模型的搜索明确路由到 DSH 默认搜索或已登录的 Codex 订阅 |
47
- | **Codex 图片生成与编辑(Beta)** | 可无参考图全新生成,也可明确选择会话图片继续编辑;支持预览、缩放、区域备注、下载原图,并为新生成或编辑的图片提供 DSH 主机上的原图路径 |
48
- | **高速模式** | 直接在输入框切换标准或高速,无需离开当前会话 |
49
- | **模型感知上下文** | 可保留目录默认值、按模型启用扩展窗口,或为每个模型填写完整数字 Token 上限;设置页打开、账号切换和连接重置后会刷新模型目录,失败时可重试且不会覆盖未保存的草稿 |
50
- | **Headless 任务** | 使用同一份已登录的 Codex Provider 运行一次性 DSH 任务,输出答案后自动退出 |
51
-
52
- 这些能力共用同一份本机 ChatGPT 登录。订阅路由失败时会明确报错,不会静默切换到其他付费路由。
53
-
54
- ## 实际界面
55
-
56
- <p align="center">
57
- <img src="docs/assets/subscription-account.png" width="820" alt="DSH Codex 订阅主界面:ChatGPT 登录、剩余额度与输入框偏好">
58
- </p>
59
-
60
- 上图为“账号与偏好”主界面,展示登录状态、订阅额度和输入框偏好。截图中的账号、额度、余额与时间均为演示数据,不代表套餐固定权益。高级功能与可选组件见下文。
23
+ <p align="center"><img src="docs/assets/product-account-demo.png" width="1100" alt="Codex 订阅账号与额度界面:模型选择、双周期额度与提醒;使用演示数据"></p>
24
+
25
+ ## 功能一览
26
+
27
+ 把订阅接入、模型控制、额度管理和图片创作放在同一个 DSH 工作流里。下面逐项列出插件提供的能力;模型权限和额度以账号实际返回为准。
28
+
29
+ ### 模型与搜索
30
+
31
+ | 功能 | 你可以做什么 | 使用方式 / 条件 |
32
+ | --- | --- | --- |
33
+ | **订阅登录** | 直接登录 ChatGPT,使用 Codex 订阅模型,无需 API Key | 普通聊天无需 Codex CLI |
34
+ | **模型目录同步** | 自动读取账号可用模型与推理档位,支持手动刷新 | 新型号以账号目录开放情况为准 |
35
+ | **推理等级** | 在输入框选择模型支持的推理档位 | 档位随模型变化 |
36
+ | **高速模式** | 在支持的模型上切换标准 / Fast,输入框显示闪电标识 | 默认标准;Fast 会增加用量消耗 |
37
+ | **输出详略** | 选择简短、适中或详细的回答偏好 | 默认跟随模型 |
38
+ | **订阅联网搜索** | 使用 Codex 搜索,或选择 DSH 搜索 | 可选自动、DSH、Codex 路由 |
39
+ | **搜索范围** | 选择实时 / 缓存搜索、关闭搜索,或限定域名 | 在模型与运行中设置 |
40
+ | **上下文预算** | 按模型使用标准、扩展或自定义上下文预算 | 受模型目录上限约束 |
41
+ | **GPT-Reserve** | 在账号开放时选择备用模型入口 | 实验性;不承诺独立备用额度 |
42
+
43
+ ### 账号与额度
44
+
45
+ | 功能 | 你可以做什么 | 使用方式 / 条件 |
46
+ | --- | --- | --- |
47
+ | **多账号管理** | 添加、切换、移除账号,或退出全部账号 | 设置 → 账号与额度 |
48
+ | **额度详情** | 查看短周期 / 每周额度、重置时间及独立额度分组 | 仅展示服务端返回的窗口与分组 |
49
+ | **Credits 与重置卡** | 查看额外 Credits、消费上限和可用重置卡 | 账号返回对应数据时显示 |
50
+ | **输入框额度** | 不离开会话即可查看百分比或进度条 | 默认关闭,可选显示方式 |
51
+ | **续航预测** | 根据最近使用速度估算剩余可用时长 | Beta;可选,不是保证值 |
52
+ | **额度提醒** | 使用固定阈值、提前提醒,或分别设置短 / 长周期阈值 | 默认剩余 20% 提醒,可关闭 |
53
+ | **使用重置卡** | 在确认后主动使用服务端提供的重置卡 | 二次确认与等待保护,由服务端判定结果 |
54
+ | **重置后重试** | 等待已确认的短时额度重置,再继续请求 | 默认关闭;等待期间可停止 |
55
+
56
+ ### 图片与草图
57
+
58
+ | 功能 | 你可以做什么 | 使用方式 / 条件 |
59
+ | --- | --- | --- |
60
+ | **图片生成** | 通过订阅生成图片,调整可用的请求型号与质量 | Beta;默认开启,可关闭 |
61
+ | **参考图编辑** | 带上参考图继续修改作品 | Beta;默认开启,可关闭 |
62
+ | **图片查看与下载** | 缩放、拖动、适合窗口,下载校验后的原图 | 内置查看器,无需另装;旧图可能只有预览 |
63
+ | **区域标注编辑** | 在图上圈定区域、填写备注,带定位参考继续编辑 | 回填输入框后由你确认发送 |
64
+ | **手绘画板** | 选择画布比例,使用钢笔、铅笔、荧光笔及橡皮 | Beta;画板默认关闭 |
65
+ | **形状与文字** | 绘制直线、箭头、形状、原生曲线,选中修改对象和文字 | 在草图画板中使用 |
66
+ | **图层与图片导入** | 分层创作,将图片加入草图继续画 | 图片作为图层管理 |
67
+ | **笔画平滑与导航** | 抬笔后平滑整条路径;拖动、缩放、撤销重做 | 快捷键可自定义和关闭 |
68
+ | **多份草稿** | 保存并重新编辑最多 20 份本地草稿 | 保存在当前浏览器 |
69
+ | **导入与导出** | 导出 PNG、分层 PSD,或交换保留原生笔画的草稿文件 | PSD 导入仅支持有限的普通像素图层 |
70
+ | **Agent 绘图** | 用 `@sketch` 让 Agent 绘制,查看进度并随时停止 | Beta;默认关闭,需同时开启画板 |
71
+ | **绘图结果回看** | 完成后向模型返回画布预览,帮助后续检查 | Beta;默认关闭,会增加图片输入用量 |
72
+
73
+ ### 进阶能力与维护
74
+
75
+ | 功能 | 你可以做什么 | 使用方式 / 条件 |
76
+ | --- | --- | --- |
77
+ | **Codex 独立子任务** | 复用订阅登录和工作区权限执行独立任务,可指定允许的模型与推理档位 | Beta;默认 DSH,Codex 需安装可选组件并配置模型选择 |
78
+ | **子任务组件管理** | 在设置里安装、停用或卸载官方 Codex 子任务组件 | 由支持的 DSH 宿主管理,无需额外登录 |
79
+ | **云端上下文压缩** | 使用 Codex 云端压缩继续长对话,同时保留 DSH 历史与原生压缩 | Beta / 实验性;默认关闭,开启的请求使用 SSE |
80
+ | **WebSocket 连接** | 实验性复用连接和上下文传输,连接失败可回退 SSE | Beta / 实验性;默认 SSE,不保证更快 |
81
+ | **支持诊断** | 查看功能前置条件、近期操作结果与宿主注册信息;报告不含凭据和会话正文 | 设置 → 维护;未验证不代表故障 |
82
+ | **预测缓存清理** | 查看并清理本地额度预测历史 | 保留登录、草稿、原图和共享依赖 |
83
+
84
+ [详细用法、限制与可选组件 →](docs/GUIDE.zh-CN.md)
61
85
 
62
86
  ## 准备 DSH
63
87
 
88
+ 已适配 DSH `0.1.7-rc.2` 的插件兼容性检查与设置接口,同时保留已支持版本的兼容。
89
+
64
90
  本插件支持软件包元数据中记录的最新版 DeepSeek Harness,并需要一个当前具有 Codex 使用资格的 ChatGPT 账户。
65
91
 
66
92
  - 不想配置 Node.js:使用 [DSH-Portable](https://github.com/WSL043/DSH-Portable)。这是面向 Windows、macOS 和 Linux 的社区便携桌面分发;
@@ -80,7 +106,7 @@
80
106
  3. 点击 **安装**,等待安装完成;按页面提示操作,需要重启时先保存工作。
81
107
  4. 打开 **设置 → Codex 订阅**,登录 ChatGPT,然后在会话中选择 Codex 模型。
82
108
 
83
- 包名不带版本号时安装最新正式版。指定版本时填写 `dsh-codex-subscription@2.1.9`;测试版则使用对应发布说明中的完整版本号。此处只填包名,不要粘贴整条终端命令。安装本插件使用上面的 npm 包名即可,无需填写 GitHub 地址或本地目录。
109
+ 默认安装最新正式版。指定版本时填 `dsh-codex-subscription@版本号`,版本号见[发布页](https://github.com/WSL043/dsh-codex-subscription/releases)。
84
110
 
85
111
  <details>
86
112
  <summary>终端安装(已能运行 dsh 命令)</summary>
@@ -105,87 +131,65 @@ dsh --profile headless "只回复:ok"
105
131
 
106
132
  </details>
107
133
 
108
- ## 功能说明
109
-
110
- ### 执行中补充指令
111
-
112
- 沿用 DSH 原生消息队列:生成中发送消息可排队到下一轮;界面提供插话入口时,可用其快捷键将排队内容交给当前轮的下一步处理。插话不是立即改写正在生成的响应。
113
-
114
- ### GPT-Reserve(实验性)
134
+ ## 界面一览
115
135
 
116
- 账号的官方模型目录提供 `gpt-reserve` 时,模型选择器末尾会出现实验性选项。可用性和扣费归属由服务端决定;请求成功不代表已确认使用独立备用额度。即使普通 Codex 额度显示已用尽,服务端也可能只在模型目录中返回 `gpt-reserve`,不返回独立的 Reserve 额度桶。此时输入框将 Reserve 额度视为未知,不会借用普通 Codex 额度;服务端返回“允许使用”也不能证明请求扣的是 Reserve。
136
+ ### 日常操作,留在输入框
117
137
 
118
- ### GPT-6 Sol / Luna
138
+ 选模型、调推理档位、开启高速模式,同时查看剩余额度。无需为每次请求打开设置。
119
139
 
120
- GPT-6 Sol 和 GPT-6 Luna 已在 [OpenAI 的 Codex 模型说明](https://learn.chatgpt.com/docs/models)中列出。插件会从当前账号的 Codex 模型目录自动读取可用模型及推理档位,无需手动添加型号;账号尚未开放时不会显示。Sol 适合复杂编程,Luna 适合高频、目标明确的任务。两者的扩展上下文上限和高速模式以账号目录返回值为准。
140
+ <p align="center"><img src="docs/assets/composer-astra-fast.png" width="800" alt="DSH 输入框:GPT-6-Astra Max、闪电标识的 Fast 高速模式与剩余额度"></p>
121
141
 
122
- ### GPT-6 Astra 上下文
142
+ ### 账号与偏好,集中管理
123
143
 
124
- 当官方模型目录提供 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 的本地上下文预算,不授予模型访问权限,也不保证账号的服务端容量;实际可用性以服务端为准。
144
+ 在 **设置 → Codex 订阅** 中管理账号和额度;其余功能按任务需要开启。
125
145
 
126
- ### 输入框额度
127
-
128
- <p align="center">
129
- <img src="docs/assets/composer-quota.png" width="800" alt="DSH 实机输入框:GPT-6-Astra、Max 推理、高速模式和剩余额度">
130
- </p>
131
-
132
- 实机示例:GPT-6-Astra · Max(最高推理档)· 高速模式(闪电标识),左侧直接显示剩余额度。
133
-
134
- 可在“账号与偏好”选择关闭、百分比、进度条或 Beta 续航预测。存在 5 小时额度时,输入框只显示短窗口;每周额度等完整信息留在悬浮详情。仅有周额度时省略“周”字,预测采用 `36% · ≈10h–12h` 这样的紧凑格式。
135
-
136
- 续航预测根据最近两小时的官方读数估算,额度不变的采样同样参与计算。满足条件时利用连续跳格约束速度,读数不足或使用强度变化时会退回保守估计。范围不是实际可工作时间的保证,仍标记 Beta。历史在本机有限保存;重置、长时间离线或关闭预测会重新校准。
137
- Spark 使用独立额度。只返回每周额度的账号仍只显示每周,不会虚构 5 小时窗口、Credits 或消费上限。
138
-
139
- ### 安全使用额度重置
140
-
141
- ChatGPT 返回可用重置卡时,设置页会把每张卡分别显示为紧凑的一行,并展示服务端提供的名称和到期时间。即使额度尚未到 100%,
142
- 也可以主动尝试使用,适合重置卡即将过期的情况;是否需要重置仍由 ChatGPT 判断,服务端可能返回“当前无需重置”且不扣次数。
143
- 最终操作需要勾选知情确认并等待 5 秒。取消不会消耗,快速连续点击只允许一次请求,网络结果不确定时也不会自动重试。
144
-
145
- ### 图片生成与编辑(Beta)
146
-
147
- 订阅插件已内置基于 `dsh-image-viewer` 的基础查看器,无需额外安装。插件生成图片的工具卡片使用内置查看器,确保标注和继续编辑功能可用。你可以缩放、拖动、适合窗口、添加区域备注并下载图片。标准“下载”默认获取经过权限与完整性校验的精确原图;旧会话没有精确原图时才下载会话预览图。
148
-
149
- 新生成或编辑的图片会在工具结果中返回当前 DSH 主机上的原图路径,模型或 Agent 可以读取或复制该文件。该路径位于运行 DSH 的主机,并非浏览器下载链接;原图下载仍按会话授权。卸载插件不会删除已生成的原图。
150
-
151
- 点击“在输入框中继续编辑”不会自动发送。有标注时会附上干净源图和带编号标记的定位参考图,草稿包含对应编号、坐标、备注,以及不得把标记绘入成品的说明;没有标注时只附上当前图片。每个标记必须填写备注,参考图准备失败时会中止回填。按 Enter 保存并收起备注,Shift+Enter 换行;在当前 DSH 页面重新打开同一张图片时,备注仍会保留。
146
+ <details>
147
+ <summary>四个设置页分别做什么?</summary>
152
148
 
153
- 新的图片请求不会静默带入历史图片。GPT Image 2 可能比文本回复耗时更长,复杂文字、精确构图和连续角色一致性也可能需要再次调整。
149
+ | 设置页 | 在这里做什么 |
150
+ | --- | --- |
151
+ | **账号与额度** | 登录与切换账号、查看重置时间、设置额度显示和提醒 |
152
+ | **模型与运行** | 订阅搜索、上下文预算、连接方式与独立子任务 |
153
+ | **图片与草图** | 分别开启图片生成、画板和 Agent 绘图 |
154
+ | **维护** | 生成支持诊断、管理本地额度预测缓存 |
154
155
 
155
- <p align="center">
156
- <img src="docs/assets/image-preview-annotations.png" width="800" alt="DSH 图片查看器中的生成图、区域备注和继续编辑">
157
- </p>
156
+ **模型感知上下文**跟随账号模型目录,刷新不会覆盖未保存的草稿。额度分组以服务端实际返回为准,包括 Spark 等独立额度。
158
157
 
159
- 上图展示图片查看与图上备注的基本交互;具体按钮会随图片和所安装的查看器版本变化。
158
+ 订阅请求失败时会明确报错,不会静默切换到其他付费路由。
160
159
 
161
- ### 草图画板(Beta)
160
+ </details>
162
161
 
163
- ![草图画板实机界面:画布比例、笔刷、形状、图层与缩放](docs/assets/sketch-canvas.png)
162
+ [查看完整使用指南 →](docs/GUIDE.zh-CN.md)
164
163
 
165
- 点击输入框的草图按钮手动画图。`@sketch` 是 Agent 绘图入口:选择时只填入输入框,发送绘图请求后才由 Agent 打开画板。图片预览中可选择“进入草图”;上传、粘贴和移除附件仍由 DSH 原生组件处理。
164
+ ## 从草图到作品
166
165
 
167
- 草图支持多份本地草稿、图片图层、画布比例、三种笔刷(实色钢笔、颗粒铅笔、半透明荧光笔)、直线和形状、两种橡皮、撤销重做、拖动缩放与可配置快捷键。平滑仅在抬笔后处理整笔路径,不拖慢绘画光标。草稿最多 20 份,仅保存在当前浏览器;附加草图不会自动发送。左侧图片面板只管理当前草图的图片,不是会话图片库。
166
+ 图片生成与编辑、草图画板均为 **Beta**。画板和 Agent 绘图默认关闭,在“图片与草图”中按需开启。
168
167
 
169
- 支持可选中修改的形状与文字、原生曲线,以及侧边粗细/浓度控件。Agent 绘制时可查看、缩放和关闭面板,编辑暂时锁定;顶部可停止绘制,完成后恢复编辑。自动完成预览默认关闭,可在高级设置开启。切换会话后再返回会保留画板、历史和运行状态。切到其他会话期间不保证后台绘制;整页刷新或退出前请保存草稿,未保存内容不保证恢复。
168
+ **画草图 → 附加到输入框 → 描述效果 → 生成成图。**
170
169
 
171
- **草图生成图片实测**:画好后点击“附加”,在输入框说明想要的效果,再发送。
170
+ 手动画图时点击画板按钮;让 Agent 绘图时发送 `@sketch` 加绘图要求。
172
171
 
173
- | 画板原草图 | 插件实际生成结果 |
174
- | --- | --- |
175
- | ![山峰与小屋草图](docs/assets/sketch-demo-source.png) | ![根据草图生成的水彩山间小屋](docs/assets/sketch-demo-result.png) |
172
+ <table>
173
+ <tr><th width="50%">画板原草图</th><th width="50%">插件实际生成结果</th></tr>
174
+ <tr><td><img src="docs/assets/sketch-demo-source.png" alt="山峰与小屋草图" width="480"></td><td><img src="docs/assets/sketch-demo-result.png" alt="根据草图生成的水彩山间小屋" width="480"></td></tr>
175
+ </table>
176
176
 
177
- 示例要求:保留山峰与小屋的构图,生成温暖的水彩旅行插画,青绿山峰、橙色屋顶、草地小溪与柔和晨光,不保留蓝色线条。此例通过 GPT-5.6-Luna 发起一次图片工具调用,请求低质量;Luna 是对话模型,实际出图型号由订阅后端决定。
177
+ 示例要求:保留山峰与小屋的构图,生成温暖的水彩旅行插画,青绿山峰、橙色屋顶、草地小溪与柔和晨光,不保留蓝色线条。
178
178
 
179
179
  <details>
180
- <summary>进阶展示</summary>
180
+ <summary>进阶展示 · 分层插画与蒙娜丽莎</summary>
181
181
 
182
182
  **《画布背面有人》**
183
183
 
184
- **Astra 绘制草图,GPT Image 2 生成成图。** Astra 通过原生 `codex_sketch` 接口完成 6 层、427 笔绘制,再由 Luna 调用订阅生图工具精修。生图请求使用 `gpt-image-2`、低质量档;服务端未报告实际执行型号。Beta 新增 PNG 导出、分层 PSD 导入导出和可编辑草稿文件;PSD 保留像素图层,原生草稿保留笔画。草图画板与 Agent 绘图均默认关闭,可在高级设置中分别开启。仅开启 Agent 绘图后才向模型提供绘图工具。
184
+ **Astra 绘制草图,GPT Image 2 生成成图。** 原生草图共 6 层、427 笔,可继续编辑;生图请求保留构图,精修纸艺与手绘质感。请求型号为 `gpt-image-2`,服务端未报告实际执行型号。
185
185
 
186
- | 原生草图 | 实际生成结果 |
187
- | --- | --- |
188
- | ![Sketch](docs/assets/sketch-advanced-source.png) | ![Result](docs/assets/sketch-advanced-result.png) |
186
+ <table>
187
+ <tr><th width="50%">原生草图</th><th width="50%">实际生成结果</th></tr>
188
+ <tr><td><img src="docs/assets/sketch-advanced-source.png" alt="Sketch" width="480"></td><td><img src="docs/assets/sketch-advanced-result.png" alt="Result" width="480"></td></tr>
189
+ </table>
190
+
191
+ <details>
192
+ <summary>展开复现提示词与原始生图请求</summary>
189
193
 
190
194
  **草图复现提示词(按原画面整理,非完整原始对话)**
191
195
 
@@ -201,6 +205,8 @@ ChatGPT 返回可用重置卡时,设置页会把每张卡分别显示为紧凑
201
205
  请基于本条附加草图实际调用订阅图片工具一次,生成成品插画。quality=low,模型使用当前默认,不切换型号,不额外生成。主题《画布背面有人》:保留4:3横构图、中央偏上的撕纸洞口、洞内拿颜料桶的小画师、流出成为S形河流的蓝色颜料、下方左侧未上色城市与右侧被点亮城市、纸船飞鸟。精修为惊艳的立体纸艺与精细手绘结合的编辑插画,纸张纤维、真实撕边及柔和投影,深靛蓝洞内星月,丰富青蓝颜料层次和流动质感,赭橙画师与暖色建筑,微小清晰的叙事细节。不重构为风景,不添加文字水印。必须使用本条参考图片编辑,不能仅凭文字生成。生成后简短说明完成即可。
202
206
  ```
203
207
 
208
+ </details>
209
+
204
210
  原案例首发:[Beta v2.1.0-beta.2](https://github.com/WSL043/dsh-codex-subscription/releases/tag/v2.1.0-beta.2)
205
211
 
206
212
  **《蒙娜丽莎》:Astra 草图 → GPT 生图**
@@ -209,9 +215,10 @@ ChatGPT 返回可用重置卡时,设置页会把每张卡分别显示为紧凑
209
215
 
210
216
  用户在另一台电脑上的实际效果:先让 Astra 在竖版画板上绘制,再通过 GPT 生图转成油画。
211
217
 
212
- | Astra 原生草图 | GPT 生图:油画效果 |
213
- | --- | --- |
214
- | ![Astra 绘制的蒙娜丽莎草图](docs/assets/sketch-mona-lisa-source.png) | ![草图转换后的蒙娜丽莎油画](docs/assets/sketch-mona-lisa-result.png) |
218
+ <table>
219
+ <tr><th width="50%">Astra 原生草图</th><th width="50%">GPT 生图:油画效果</th></tr>
220
+ <tr><td><img src="docs/assets/sketch-mona-lisa-source.png" alt="Astra 绘制的蒙娜丽莎草图" width="480"></td><td><img src="docs/assets/sketch-mona-lisa-result.png" alt="草图转换后的蒙娜丽莎油画" width="480"></td></tr>
221
+ </table>
215
222
 
216
223
  草图提示词:`@sketch 用竖版画板画一幅《蒙娜丽莎》`
217
224
 
@@ -219,87 +226,80 @@ ChatGPT 返回可用重置卡时,设置页会把每张卡分别显示为紧凑
219
226
 
220
227
  </details>
221
228
 
222
- 图片请求中的 Flare / Sunburst 型号选项仍属实验性功能。成功生成不代表订阅后端确认采用指定型号或质量;不会把请求参数当成实际返回型号。
229
+ <details>
230
+ <summary>查看图片与草图设置</summary>
223
231
 
224
- ### 输入框速度
232
+ <p align="center"><img src="docs/assets/real-creative-zh.png" width="564" alt="图片与草图设置:生图编辑、请求型号,以及独立的画板和 Agent 开关"></p>
225
233
 
226
- 选择支持的 Codex 模型后,可在输入框的模型菜单中切换标准与高速。标准模式不增加图标,
227
- 只有高速模式会在模型名称左侧显示闪电;Spark 不显示速度入口。高速模式会提高速度,也会消耗更多 Credits;具体规则见
228
- [OpenAI Codex Speed 文档](https://learn.chatgpt.com/docs/agent-configuration/speed)。
234
+ DSH 实机设置截图。
229
235
 
230
- ### 高级实验选项
236
+ </details>
231
237
 
232
- 在 **高级与诊断** 中按需开启,默认仍使用 SSE 和 DSH 子任务:
238
+ 支持图层、原生曲线、笔刷、撤销重做和快捷键;可保存多份草稿,导出 PNG 或分层 PSD。生成图可标注区域后继续编辑。
233
239
 
234
- - **WebSocket**:复用连接和可复用的上下文传输;握手失败可回退 SSE,已开始的响应中断会报错,不自动重放。下次请求生效,不增加模型上下文容量,也不保证更快。
235
- - **Codex 独立子任务**:复用订阅登录和官方 DSH Codex 运行时,无需另行登录;可选组件在高级设置中安装。默认继承当前订阅模型及工作区权限。开启 DSH 子任务模型选择、配置允许模型并新建会话后,可在聊天中指定子任务模型与推理档位;非订阅会话需明确选择订阅模型。共享上下文的子任务仍交给 DSH。
240
+ [图片编辑、草稿保存与 PSD 限制 →](docs/GUIDE.zh-CN.md#图片生成与编辑beta)
236
241
 
237
242
  <a id="codex-subtask-runtime"></a>
238
243
 
239
- ## 可选 Codex 子任务运行时
244
+ ## 按需扩展
240
245
 
241
- 普通订阅聊天、图片和 DSH 原生子任务不需要 Codex CLI。只有高级设置中的 **Codex 独立子任务(Beta)** 需要额外准备官方运行时,插件不会后台自动下载。
246
+ 普通订阅聊天无需 Codex CLI。需要 **Codex 独立子任务** 时,可在“模型与运行”中点击“安装组件”,停用和卸载也在同一处完成。其余实验选项按需开启。
242
247
 
243
- 在 **设置 → Codex 订阅 → 高级与诊断 → 独立子任务** 点击 **安装组件**。DSH 负责安装,页面显示当前阶段,可取消尚未应用的安装;完成后重启,再选择 Codex。安装不会自动开启子任务。
248
+ [可选组件、存储清理与完整使用指南 →](docs/GUIDE.zh-CN.md)
244
249
 
245
- ![可选组件管理实机界面](docs/assets/settings-runtime-current.png)
250
+ ## 更新与卸载
246
251
 
247
- 优先使用上面的 **安装组件** 按钮。正式版 **2.1.9** 会按当前 DSH 版本选择对应组件:DSH `0.1.7-rc.2` 安装组件 `0.1.7-rc.2`,DSH `0.1.5-rc.2` 安装组件 `0.1.5-rc.2`;已安装的 `0.1.5-rc.3` 组件仅在同版本宿主上识别。请不要省略组件版本号或自行改用 `@next`。
252
+ 在 DSH **插件** 页面找到本插件,使用更新或卸载操作,完成后按页面提示重启。卸载插件不会删除其他插件。
248
253
 
249
254
  <details>
250
- <summary>旧版宿主手动安装与离线准备</summary>
251
-
252
- 插件安装页面填写与当前 DSH 相同版本的组件,例如 DSH `0.1.7-rc.2` 填写 `@deepseek-ai/dsh-subagent-codex@0.1.7-rc.2`。终端方式:
255
+ <summary>终端方式</summary>
253
256
 
254
257
  ```sh
255
- dsh plugin --profile web add @deepseek-ai/dsh-subagent-codex@0.1.7-rc.2
258
+ dsh plugin --profile web update dsh-codex-subscription
256
259
  ```
257
260
 
258
- 安装到订阅插件所在的同一个 profile,完成后重启。离线使用须提前在目标系统与架构上安装并验证完整运行时;只复制订阅插件或 Codex 启动脚本不够。模型请求仍需联网。
261
+ 仅在需要卸载时运行:
262
+
263
+ ```sh
264
+ dsh plugin --profile web remove dsh-codex-subscription
265
+ ```
259
266
 
260
267
  </details>
261
268
 
262
- ### 不再使用时
269
+ ## 常见问题
263
270
 
264
- 只想停用:在高级设置切回 **DSH**,组件仍保留,之后可再次开启。
271
+ <details>
272
+ <summary>电脑没有 dsh 命令,怎么安装?</summary>
265
273
 
266
- 要卸载:在同一位置点击 **卸载组件** 并确认。插件会检查正在运行的子任务,切回 DSH 后交给官方接口卸载;有任务运行时不能卸载。完成后重启。旧版宿主可在终端执行(将 `web` 替换为实际安装的 profile):
274
+ 直接使用 DSH 的 **插件 → 添加插件**,粘贴包名即可,无需配置终端命令。
267
275
 
268
- ```sh
269
- dsh plugin --profile web remove @deepseek-ai/dsh-subagent-codex
270
- ```
276
+ </details>
271
277
 
272
- 卸载的是可选子任务组件,不是订阅插件;普通订阅聊天、生图和 DSH 原生子任务不受影响。若其他插件仍依赖该组件,包管理器可能保留它。
278
+ <details>
279
+ <summary>有多个 DSH,或安装后找不到插件?</summary>
273
280
 
274
- ### 存储与清理
281
+ 在你实际使用的 DSH 中安装。使用终端时,请从目标 DSH 环境运行命令,并确认对应的 profile;不要删除 profile 或修改系统 PATH 来强行安装。
275
282
 
276
- 卸载不等于清空共享安装缓存,也不能保证释放某个固定大小。安装缓存由 DSH/Portable 统一管理,本插件不直接删除共享目录。草稿、会话记录、生成原图和登录信息不是安装缓存;需要删除时应使用各自的管理入口,不做一键混合清理。
283
+ </details>
277
284
 
278
- ## 更新与卸载
285
+ <details>
286
+ <summary>如何反馈问题?</summary>
279
287
 
280
- 在 DSH **插件** 页面找到本插件,使用更新或卸载操作,完成后按页面提示重启。卸载插件不会删除其他插件。
288
+ 在 **设置 → Codex 订阅 → 维护** 生成“支持诊断”,粘贴到[使用问题表单](https://github.com/WSL043/dsh-codex-subscription/issues/new?template=install-problem.yml)的诊断栏,并补充触发步骤。
281
289
 
282
- <details>
283
- <summary>终端方式</summary>
290
+ 诊断不含凭据、账号标识、原始响应或完整日志。请勿附上登录链接、授权码或浏览器回调地址。
284
291
 
285
- ```sh
286
- dsh plugin --profile web update dsh-codex-subscription
287
- ```
292
+ </details>
288
293
 
289
- 仅在需要卸载时运行:
294
+ ## 当前图标
290
295
 
291
- ```sh
292
- dsh plugin --profile web remove dsh-codex-subscription
293
- ```
296
+ 这是当前使用的插件图标,以及它在 DSH「已安装」列表中的实际显示效果。
294
297
 
295
- </details>
298
+ <p align="center"><img src="icon-subscription.webp" width="200" height="200" alt="当前 Codex 订阅插件图标"></p>
296
299
 
297
- ## 常见问题
300
+ <p align="center"><img src="docs/assets/plugin-installed.png" width="800" alt="DSH 已安装列表中的 Codex 订阅插件卡片"></p>
298
301
 
299
- - **`dsh` 无法识别**:直接使用 DSH 的插件页面安装,无需为了安装插件配置终端命令。
300
- - **电脑上有多个 DSH**:请从目标 DSH 环境运行标准命令,由该产品自身选择对应 profile;
301
- - **安装仍然失败**:确认命令是在目标 DSH 环境中运行,不要删除 profile 或随意修改系统 PATH。
302
- - **需要提交问题**:在设置页底部生成“支持诊断”,然后打开[使用问题表单](https://github.com/WSL043/dsh-codex-subscription/issues/new?template=install-problem.yml)。报告包含系统/运行时、有限的登录阶段和安全的请求失败分类,但不含凭据、账号标识、原始响应或完整日志;请粘贴到必填诊断栏,且不要附上登录链接、授权码或浏览器回调地址。
302
+ <sub>DSH 0.1.7-alpha.2 实机界面。</sub>
303
303
 
304
304
  ## 边界与支持
305
305