dsh-codex-subscription 1.0.4 → 1.0.6

package/README.md

@@ -1,96 +1,85 @@
 # DSH Codex Subscription
 
+<div align="center">
+
+**把 ChatGPT / Codex 订阅直接接入 DeepSeek Harness**
+
+在 DeepSeek Harness 中直接登录 ChatGPT 并使用 Codex 订阅。无需 OpenAI API Key，也不依赖 Codex CLI；
+模型、搜索、额度和图片生成都留在 DSH 里。
+
 [![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)
-[![npm version](https://img.shields.io/npm/v/dsh-codex-subscription?logo=npm&label=npm)](https://www.npmjs.com/package/dsh-codex-subscription)
-[![License: MIT](https://img.shields.io/badge/license-MIT-111111.svg)](LICENSE)
-[![GitHub stars](https://img.shields.io/github/stars/WSL043/dsh-codex-subscription?style=flat&logo=github&label=stars)](https://github.com/WSL043/dsh-codex-subscription/stargazers)
+[![npm](https://img.shields.io/npm/v/dsh-codex-subscription?logo=npm&label=npm)](https://www.npmjs.com/package/dsh-codex-subscription)
+[![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)
 
-[English](https://github.com/WSL043/dsh-codex-subscription/blob/main/README.en.md)
+[交给 Agent 安装](#交给-agent推荐) · [Windows 安装](#windows-手动安装) · [更新与卸载](#更新与卸载) · [English](https://github.com/WSL043/dsh-codex-subscription/blob/main/README.en.md)
 
-在 DeepSeek Harness 中直接登录 ChatGPT 并使用 Codex 订阅，不需要 OpenAI API Key，
-也不依赖 Codex CLI。保留 DSH 原有的会话、工具和权限，还能生成图片、切换联网搜索来源并查看额度。
+</div>
 
-[交给 Agent 安装](#交给-agent推荐) · [Windows 手动安装](#windows-手动安装) · [更新与卸载](#更新与卸载) · [English](#english)
+<p align="center">
+  <img src="https://raw.githubusercontent.com/WSL043/dsh-codex-subscription/main/docs/assets/readme-hero.webp" width="900" alt="Codex 订阅直接用在 DSH：订阅模型、联网搜索、实时额度和图片生成">
+</p>
 
-![DeepSeek Harness 的 Codex 订阅设置](https://raw.githubusercontent.com/WSL043/dsh-codex-subscription/main/docs/assets/settings.png)
+## 核心优势
 
-设置页会显示登录状态、搜索来源，以及服务端实际返回的普通 Codex 与 Spark 独立额度。
+| 能力 | 用户得到什么 |
+| --- | --- |
+| **Codex 图片生成** | 在 DSH 对话里直接描述画面，生成结果会显示在当前会话中 |
+| **订阅模型直连** | 登录 ChatGPT 后直接使用 Codex，不需要 OpenAI API Key 或 Codex CLI |
+| **订阅搜索** | 可在 DSH 默认搜索与 Codex 订阅搜索之间明确切换 |
+| **额度可见** | 普通 Codex、Spark 等服务端实际返回的额度分开显示 |
 
-如果它帮到了你，欢迎在 [GitHub 仓库](https://github.com/WSL043/dsh-codex-subscription)的右上角点一下 **Star**，也方便其他 DSH 用户发现。
+这些能力共用同一份本机 ChatGPT 登录。订阅路由失败时会明确报错，不会静默切换到其他付费路由。
 
-## 能做什么
+## 实际界面
 
-- 在 DSH 中直接使用 ChatGPT / Codex 订阅，不需要 OpenAI API Key 或 Codex CLI；
-- 在设置页登录 ChatGPT，凭据保留在本机；
-- 支持 Codex 图片生成，结果直接显示在 DSH 会话中；
-- 可在 DSH 默认搜索与 Codex 订阅搜索之间切换；
-- 展示服务端实际返回的额度、重置时间和更新时间；
-- 可在模型名称左侧显示当前 Codex 模型的剩余额度（Beta，默认关闭）；
-- 单独显示 Codex-Spark、Credits 等独立额度，不把它们混在一起；
-- 订阅路由不可用时明确报错，不会静默切换到其他付费路由。
+<p align="center">
+  <img src="https://raw.githubusercontent.com/WSL043/dsh-codex-subscription/main/docs/assets/settings-focus.png" width="820" alt="DeepSeek Harness 中的 Codex 订阅设置">
+</p>
+
+<details>
+<summary>查看完整设置界面</summary>
+
+![DeepSeek Harness 的完整 Codex 订阅设置](https://raw.githubusercontent.com/WSL043/dsh-codex-subscription/main/docs/assets/settings.png)
+
+</details>
 
 ## 准备 DSH
 
-本插件适配 DeepSeek Harness `0.1.0-rc.6`、`0.1.0-rc.7` 与 `0.1.0-rc.8`，还需要一个当前具有 Codex 使用资格的
-ChatGPT 账户。
+本插件适配 DeepSeek Harness `0.1.0-rc.6`、`0.1.0-rc.7` 与 `0.1.0-rc.8`，并需要一个当前具有 Codex 使用资格的 ChatGPT 账户。
 
 - 不想配置 Node.js：使用 [DSH-Portable（社区便携包）](https://github.com/WSL043/DSH-Portable)；
 - 想按官方方式运行：查看 [DeepSeek Harness 官方说明](https://github.com/deepseek-ai/deepseek-harness#run)。
 
-已经能正常打开 DSH 的用户可以直接继续安装插件。
-
 ## 安装
 
 ### 交给 Agent（推荐）
 
-把下面的链接直接发给 Agent。文档包含安装、更新、卸载和验收步骤；Agent 不应删除
-DSH profile、登录信息或擅自重启 DSH。
+把这个链接直接发给 Agent：
 
-[打开 Agent 安装文档](https://raw.githubusercontent.com/WSL043/dsh-codex-subscription/main/AGENTS.md)
+**[Agent 安装、更新与卸载文档](https://raw.githubusercontent.com/WSL043/dsh-codex-subscription/main/AGENTS.md)**
 
 ```text
 https://raw.githubusercontent.com/WSL043/dsh-codex-subscription/main/AGENTS.md
 ```
 
+Agent 文档包含安装、更新、卸载和验收步骤，并要求保留 DSH profile、登录信息和其他插件。
+
 ### Windows 手动安装
 
 打开 PowerShell，只需要复制这一行：
 
 ```powershell
-curl.exe -fL https://github.com/WSL043/dsh-codex-subscription/releases/latest/download/dsh-codex-setup.ps1 -o "$env:TEMP\dsh-codex-setup.ps1"; if ($LASTEXITCODE -eq 0) { powershell.exe -NoProfile -ExecutionPolicy Bypass -File "$env:TEMP\dsh-codex-setup.ps1" }
-```
-
-安装助手会先让你选择 **中文（简体）** 或 **English**，然后自动寻找 DSH：
-
-- 只找到一个 DSH：直接显示目标并继续；
-- 找到多个 DSH：显示编号、状态和路径，让你输入编号选择，不再直接抛英文报错；
-- 没有安装过插件：明确显示 **安装**；
-- 已经安装当前版或旧版插件：明确显示 **更新**，旧包会按原有安全迁移流程处理；
-- 成功后只提示结果和需要手动重启 DSH，不会擅自重启程序。
-
-普通安装版和 DSH-Portable 都能使用。便携版不需要另装 Node.js 或 pnpm，整个过程不需要
-管理员权限。安装助手下载核心管理脚本后会校验 Release 提供的 SHA-256，再交给原有管理器
-执行安装、更新、验证和 PATH 处理。
-
-<details>
-<summary>非交互安装 / 兼容旧方式</summary>
-
-需要脚本化安装、Agent 操作，或想明确指定 `Install` 时，仍然可以使用原来的核心管理器：
-
-```powershell
-curl.exe -fL https://github.com/WSL043/dsh-codex-subscription/releases/latest/download/dsh-codex.ps1 -o "$env:TEMP\dsh-codex.ps1"
-powershell.exe -NoProfile -ExecutionPolicy Bypass -File "$env:TEMP\dsh-codex.ps1" Install
+irm 'https://github.com/WSL043/dsh-codex-subscription/releases/latest/download/dsh-codex-setup.ps1' | iex
 ```
 
-如果有多个 DSH-Portable，也可以继续显式传入 `-PortableRoot`。这个入口保持非交互，适合自动化。
-
-</details>
-
-如果便携文件夹改过名字或位置，先启动一次正确的 DSH-Portable，再执行安装。完成后手动
-重启 DSH，让插件生效。
+这个轻量助手只在当前目录、系统命令和常见的
+[DSH-Portable](https://github.com/WSL043/DSH-Portable) 位置查找 DSH，然后调用一次官方
+`plugin add`。它不会递归扫盘、安装 pnpm、创建常驻命令、保存 profile 快照或重复下载插件。
+无需管理员权限，也不会擅自重启 DSH。
 
 <details>
-<summary>macOS、Linux，或已有 <code>dsh</code> 命令</summary>
+<summary>macOS、Linux，或已有 <code>dsh</code> 命令（通用安装）</summary>
 
 ```sh
 dsh plugin --profile web add dsh-codex-subscription
@@ -103,64 +92,48 @@ dsh --profile web --dump-config
 
 </details>
 
-## 登录与使用
+安装完成后手动重启 DSH，然后：
 
-1. 打开 DSH 的 **设置 -> Codex 订阅**；
+1. 打开 **设置 -> Codex 订阅**；
 2. 登录具有 Codex 使用资格的 ChatGPT 账户；
-3. 选择使用 DSH 默认搜索，或使用 Codex 订阅搜索；
+3. 选择搜索来源；
 4. 在模型选择器中选择 Codex 模型。
 
-需要图片时直接描述想要的画面，Agent 会调用 Codex 图片生成并在会话中显示结果。
+## 功能
 
-Codex 订阅搜索复用同一份 ChatGPT 登录，不需要 OpenAI API Key。切换搜索来源不会改变
-当前对话模型，也不会在失败时自动改走另一个付费服务。升级后默认保留 DSH 原有搜索，
-需要使用 Codex 订阅搜索时再主动切换。
+- ChatGPT OAuth 登录，凭据保留在本机；
+- Codex 模型和图片生成直接出现在 DSH 会话中；
+- DSH 默认搜索与 Codex 订阅搜索可随时切换；
+- 设置页显示服务端返回的额度、重置时间和更新时间；
+- 普通 Codex、Codex-Spark、Credits 等独立额度分开显示；
+- 输入框可显示当前 Codex 模型的剩余额度（Beta，默认关闭）；
+- 订阅路由不可用时明确报错，不会静默切换到其他付费路由。
 
-## 额度如何显示
+### 输入框额度
 
-![输入框内的 Codex 剩余额度](https://raw.githubusercontent.com/WSL043/dsh-codex-subscription/main/docs/assets/composer-quota-en.png)
+<p align="center">
+  <img src="https://raw.githubusercontent.com/WSL043/dsh-codex-subscription/main/docs/assets/composer-quota-en.png" width="800" alt="输入框内的 Codex 剩余额度">
+</p>
 
-- 设置页始终展示服务端返回的详细额度；快捷百分比是 Beta 功能，默认关闭；
-- 开启后，百分比会显示在输入框内、模型名称左侧，只在选择 Codex 模型时出现；
-- 普通 Codex 模型取标准 Codex 窗口中剩余最少的一项，避免给出过于乐观的数字；
-- 选择 Spark 模型时，快捷百分比使用服务端返回的 Spark 独立额度；
-- 只显示服务端实际返回的窗口，不写死“5 小时 + 每周”；
-- 当前只有每周额度时不虚构 5 小时窗口，以后服务端恢复时会自动显示；
-- Codex-Spark 等独立额度不会与普通 Codex 额度合并；
-- Credits 和月度消费上限仅在账户或工作区真实返回时显示；
-- 百分比表示使用状态，不是账单金额或计费承诺。
+快捷百分比只在选择 Codex 模型时显示。普通 Codex 使用服务端返回窗口中剩余最少的一项，
+Spark 使用独立额度。插件不会写死“5 小时 + 每周”，也不会虚构服务端没有返回的 Credits 或消费上限。
 
 ## 更新与卸载
 
-Windows 安装器用户只需要两条短命令：
-
-| 操作 | PowerShell 命令 |
-| --- | --- |
-| 更新 | `dsh-codex update` |
-| 卸载 | `dsh-codex uninstall` |
-
-更新会校验最新 Release 管理脚本的 SHA-256。卸载会移除插件和 `dsh-codex` 命令，但保留
-DSH profile、其他插件和已保存的登录信息。旧版本如果还没有短命令，重新执行一次上面的
-Windows 首次安装命令即可；安装助手检测到已有插件时会自动显示并执行“更新”。
+Windows 用户重新运行上面的单行助手即可更新。卸载使用 DSH 官方命令；两种操作都保留
+DSH profile、其他插件和登录信息。
 
 <details>
 <summary>使用现有 <code>dsh</code> 命令更新或卸载</summary>
 
-更新并检查：
-
 ```sh
 dsh plugin --profile web update dsh-codex-subscription
 dsh plugin --profile web list dsh-codex-subscription --depth 0
 dsh --profile web --dump-config
-```
-
-卸载：
-
-```sh
 dsh plugin --profile web remove dsh-codex-subscription
 ```
 
-从 v0.2.1 手动更新时，确认新包安装成功后再移除旧包名：
+从 v0.2.1 手动迁移时，确认新包安装成功后再移除旧包名：
 
 ```sh
 dsh plugin --profile web remove @wsl043/dsh-codex-subscription
@@ -168,50 +141,22 @@ dsh plugin --profile web remove @wsl043/dsh-codex-subscription
 
 </details>
 
-如果 DSH 正在运行，安装或更新后请手动重启。
+DSH-Portable 在其目录中把上述 `dsh` 换成 `.\dsh.exe`。
 
 ## 常见问题
 
-- 找不到 `dsh-codex`：关闭并重新打开 PowerShell；
-- 找不到 DSH-Portable：先启动一次正确的便携版，再重新安装；
-- 检测到多个 DSH：新版安装助手会列出编号和路径，选你准备使用的那个即可；
-- 没有 `curl.exe` 或仍然失败：把 Agent 文档链接发给 Agent，不要自行修改系统 PATH、执行策略或删除 profile。
+- **找不到 DSH-Portable**：进入它的目录后重新执行安装命令，或直接运行 `.\dsh.exe plugin --profile web add dsh-codex-subscription`；
+- **电脑上有多个 DSH**：进入要使用的那个 DSH-Portable 目录再运行助手；
+- **安装仍然失败**：把上面的 Agent 文档链接发给 Agent，不要删除 profile 或随意修改系统 PATH。
 
 ## 边界与支持
 
-- 本项目接入 ChatGPT 订阅，不会把订阅转换成 OpenAI API Key；
-- ChatGPT Codex 后端和 DeepSeek Harness 都可能变化，兼容性以当前发布说明为准；
-- 本项目为社区项目，与 DeepSeek、OpenAI 无隶属或背书关系。
+ChatGPT Codex 后端和 DSH 可能独立变化；本项目为社区项目，与 DeepSeek、OpenAI 无隶属或背书关系。
 
 本项目的问题反馈请使用 [GitHub Issues](https://github.com/WSL043/dsh-codex-subscription/issues)；
-DSH 插件相关交流也可以前往
-[DeepSeek Harness Discussions](https://github.com/deepseek-ai/deepseek-harness/discussions)。
+DSH 插件交流可前往 [DeepSeek Harness Discussions](https://github.com/deepseek-ai/deepseek-harness/discussions)。
 敏感问题请先阅读 [SECURITY.md](SECURITY.md)。
 
-## English
-
-Use your ChatGPT / Codex subscription directly in DeepSeek Harness without an
-OpenAI API key or Codex CLI. The plugin supports Codex image generation, lets
-you choose DSH or Codex subscription search, and shows the quota returned by the
-service.
-
-**Agent install:** send this
-[installation guide](https://raw.githubusercontent.com/WSL043/dsh-codex-subscription/main/AGENTS.md)
-to your Agent.
-
-**Windows install:** open PowerShell and run this one line:
-
-```powershell
-curl.exe -fL https://github.com/WSL043/dsh-codex-subscription/releases/latest/download/dsh-codex-setup.ps1 -o "$env:TEMP\dsh-codex-setup.ps1"; if ($LASTEXITCODE -eq 0) { powershell.exe -NoProfile -ExecutionPolicy Bypass -File "$env:TEMP\dsh-codex-setup.ps1" }
-```
-
-The setup asks for Chinese or English first, turns multiple DSH copies into a
-numbered choice, and automatically shows **Install** or **Update** based on the
-selected DSH. DSH-Portable is supported without a separate Node.js or pnpm
-installation. After the first install, use `dsh-codex update` to update and
-`dsh-codex uninstall` to remove it. Open **Settings -> Codex**, sign in with a
-ChatGPT account that has Codex access, choose a search source, and select a Codex
-model. For full usage and troubleshooting, see the
-[English documentation](https://github.com/WSL043/dsh-codex-subscription/blob/main/README.en.md).
+如果这个项目对你有帮助，[点一下 Star](https://github.com/WSL043/dsh-codex-subscription/stargazers) 可以让更多 DSH 用户发现它。
 
 [MIT](LICENSE)

package/lib/index.js

@@ -463,7 +463,7 @@ function openaiCodexSubscriptionProvider() {
 		})
 	});
 }
-const USER_AGENT = `dsh-codex-subscription/1.0.4`;
+const USER_AGENT = `dsh-codex-subscription/1.0.6`;
 //#endregion
 //#region src/codex-search.js
 const CODEX_SEARCH_PROVIDER_ID = "codex-subscription";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-codex-subscription",
-  "version": "1.0.4",
+  "version": "1.0.6",
   "packageManager": "pnpm@11.19.0",
   "description": "ChatGPT and Codex subscriptions for DeepSeek Harness with OAuth login, image generation, quota, and subscription web search",
   "type": "module",
@@ -17,7 +17,6 @@
     "README.md",
     "README.en.md",
     "AGENTS.md",
-    "dsh-codex.ps1",
     "LICENSE",
     "SECURITY.md",
     "THIRD_PARTY_NOTICES.md",