dsh-chatgpt-sub 0.5.1 → 0.6.0

package/README.md

@@ -4,6 +4,7 @@
 
 [![License: MIT](https://img.shields.io/github/license/SONGOAO25/dsh-chatgpt-sub)](https://github.com/SONGOAO25/dsh-chatgpt-sub/blob/main/LICENSE)
 [![Release](https://img.shields.io/github/v/release/SONGOAO25/dsh-chatgpt-sub)](https://github.com/SONGOAO25/dsh-chatgpt-sub/releases)
+[![npm version](https://img.shields.io/npm/v/dsh-chatgpt-sub)](https://www.npmjs.com/package/dsh-chatgpt-sub)
 
 A DeepSeek Harness plugin that connects your ChatGPT account through OpenAI's sign-in page and lets you use the account's available ChatGPT models inside DSH. You need a plan that includes Codex access and sufficient subscription quota.
 
@@ -15,25 +16,27 @@ The companion [Bottom Info Bar](https://github.com/songoao25/dsh-bottom-info-bar
 
 ## Install
 
-Recommended: open **Plugins → Add plugin** in DSH and paste this repository address:
+Recommended: open **Plugins → Add plugin** in DSH and enter the package name:
 
 ```
-https://github.com/SONGOAO25/dsh-chatgpt-sub
+dsh-chatgpt-sub
 ```
 
 Prefer the terminal? For a CLI web profile:
 
 ```bash
-dsh plugin --profile web add https://github.com/SONGOAO25/dsh-chatgpt-sub
+dsh plugin --profile web add dsh-chatgpt-sub
 ```
 
-Then **restart DSH**. Refreshing the page is not enough. In the desktop app, use **Plugins → Add plugin**; its profile is managed by the app and cannot be installed into through the CLI. DSH uses pnpm to install plugins; the repository includes its built files and requires no installation build.
-
-**npm availability:** the public registry returned no package for `dsh-chatgpt-sub` on 2026-10-10. Use the repository address until a successful npm release is verified. After publication, the package-name command will be:
+Installing from the repository also works — `lib/` is committed, so that path needs no build:
 
-```bash
-dsh plugin --profile web add dsh-chatgpt-sub
 ```
+https://github.com/SONGOAO25/dsh-chatgpt-sub
+```
+
+Then **restart DSH**. Refreshing the page is not enough. In the desktop app, use **Plugins → Add plugin**; its profile is managed by the app and cannot be installed into through the CLI. DSH uses pnpm to install plugins; the package ships its built files and requires no installation build.
+
+The package has been public on npm since 2026-10-13 (0.5.1). If the package name cannot be resolved, fall back to the repository address.
 
 Local installs, Windows guidance, updating and troubleshooting: [docs/INSTALL.md](docs/INSTALL.md).
 
@@ -47,9 +50,11 @@ Open **Plugins → ChatGPT Subscription** and choose **Sign in with ChatGPT**. C
 
 Authorization and model requests communicate with official OpenAI endpoints. Sign-in tokens are saved in the standard local `~/.codex/auth.json` file with owner-only permissions and synchronized into DSH's credential store. Signing in can update that shared file, so it can affect which account Codex CLI uses. Tokens are transmitted to OpenAI for authorized requests; they are not written to plugin logs.
 
-Unbinding and uninstalling preserve `~/.codex/auth.json` and remove the plugin's binding and managed DSH entries. The plugin refreshes sign-in automatically. Under **Version and updates**, automatic updates (default) check npm when DSH starts, verify and replace the plugin files, then take effect after a restart. Manual mode checks without installing; installation asks for confirmation. Failed updates restore the previous files, and settings offer rollback when needed. Sign-in data is preserved. Local checkout and linked installs require a code update and rebuild; see [docs/INSTALL.md](docs/INSTALL.md). Updates become available after the npm package is published.
+Unbinding and uninstalling preserve `~/.codex/auth.json` and remove the plugin's binding and managed DSH entries. The plugin refreshes sign-in automatically. Under **Version and updates**, automatic updates (default) check npm when DSH starts, verify and replace the plugin files, then take effect after a restart. Manual mode checks without installing; installation asks for confirmation. Failed updates restore the previous files, and settings offer rollback when needed. Sign-in data is preserved. Local checkout and linked installs require a code update and rebuild; see [docs/INSTALL.md](docs/INSTALL.md).
+
+## Uninstall and roll back
 
-Remove the plugin from the desktop app's **Plugins** page, or use `dsh plugin --profile web remove dsh-chatgpt-sub` for the CLI web profile. Do not include sign-in files, credentials, or account details in bug reports.
+Remove the plugin from the desktop app's **Plugins** page, or use `dsh plugin --profile web remove dsh-chatgpt-sub` for the CLI web profile, then restart DSH. Uninstalling keeps `~/.codex/auth.json` (the Codex CLI's own sign-in) and removes this plugin's binding and the DSH entries it manages. To go back a version instead of removing the plugin, **Version and updates** offers rollback after a failed update or while a newer build waits for a restart. Do not include sign-in files, credentials, or account details in bug reports.
 
 ## Languages
 

package/README.zh-CN.md

@@ -4,6 +4,7 @@
 
 [![License: MIT](https://img.shields.io/github/license/SONGOAO25/dsh-chatgpt-sub)](https://github.com/SONGOAO25/dsh-chatgpt-sub/blob/main/LICENSE)
 [![Release](https://img.shields.io/github/v/release/SONGOAO25/dsh-chatgpt-sub)](https://github.com/SONGOAO25/dsh-chatgpt-sub/releases)
+[![npm 版本](https://img.shields.io/npm/v/dsh-chatgpt-sub)](https://www.npmjs.com/package/dsh-chatgpt-sub)
 
 一个 DeepSeek Harness 插件：通过 OpenAI 登录页面连接 ChatGPT 账号，在 DSH 中使用该账号可用的 ChatGPT 模型。需要包含 Codex 使用权限的套餐和足够的订阅额度。
 
@@ -15,25 +16,27 @@
 
 ## 安装
 
-推荐：打开 DSH **插件 → 添加插件**，粘贴仓库地址：
+推荐：打开 DSH **插件 → 添加插件**，填包名：
 
 ```
-https://github.com/SONGOAO25/dsh-chatgpt-sub
+dsh-chatgpt-sub
 ```
 
 使用命令行启动的网页端，也可以执行：
 
 ```bash
-dsh plugin --profile web add https://github.com/SONGOAO25/dsh-chatgpt-sub
+dsh plugin --profile web add dsh-chatgpt-sub
 ```
 
-装完**重启 DSH**，只刷新页面不够。桌面客户端请使用 **插件 → 添加插件**；它的配置由客户端管理，不能通过命令行安装。DSH 使用 pnpm 安装插件；仓库已包含构建文件，安装时无需构建。
-
-**npm 状态：**2026-10-10 查询公开仓库时，未找到 `dsh-chatgpt-sub`。在确认发布成功之前，请使用仓库地址。发布成功后，按包名安装的命令为：
+也可以填仓库地址 —— 仓库已包含构建文件，填地址安装无需构建：
 
-```bash
-dsh plugin --profile web add dsh-chatgpt-sub
 ```
+https://github.com/SONGOAO25/dsh-chatgpt-sub
+```
+
+装完**重启 DSH**，只刷新页面不够。桌面客户端请使用 **插件 → 添加插件**；它的配置由客户端管理，不能通过命令行安装。DSH 使用 pnpm 安装插件；包已包含构建文件，安装时无需构建。
+
+npm 上的 `dsh-chatgpt-sub` 自 2026-10-13（0.5.1）起公开可装。包名解析不到时，改用上面的仓库地址。
 
 本地安装、Windows 说明、更新与故障排查见 [docs/INSTALL.md](docs/INSTALL.md)。
 
@@ -47,9 +50,11 @@ dsh plugin --profile web add dsh-chatgpt-sub
 
 授权和模型请求与 OpenAI 官方服务通信。登录信息保存在本机标准位置 `~/.codex/auth.json`，只有文件所有者可读写，并同步到 DSH 的凭据库。绑定会更新这个共用文件，因此可能改变 Codex CLI 使用的账号。登录信息会随授权请求传给 OpenAI，不写入插件日志。
 
-解绑和卸载保留 `~/.codex/auth.json`，清除本插件的绑定和它管理的 DSH 条目。插件自动续期登录。**版本与更新**中，自动更新（默认）在 DSH 启动时检查 npm，校验并替换插件文件，重启后生效；手动模式只检查，安装前需要确认。更新失败会恢复旧文件，需要时可在设置中回滚。登录信息会保留。本地副本和链接安装需要更新代码并重新构建，见 [docs/INSTALL.md](docs/INSTALL.md)。npm 包发布后才能获取更新。
+解绑和卸载保留 `~/.codex/auth.json`，清除本插件的绑定和它管理的 DSH 条目。插件自动续期登录。**版本与更新**中，自动更新（默认）在 DSH 启动时检查 npm，校验并替换插件文件，重启后生效；手动模式只检查，安装前需要确认。更新失败会恢复旧文件，需要时可在设置中回滚。登录信息会保留。本地副本和链接安装需要更新代码并重新构建，见 [docs/INSTALL.md](docs/INSTALL.md)。
+
+## 卸载与回退
 
-桌面客户端在 **插件** 页卸载；命令行网页端使用 `dsh plugin --profile web remove dsh-chatgpt-sub`。报告问题时，不要附登录文件、凭据或真实账号信息。
+桌面客户端在 **插件** 页卸载；命令行网页端执行 `dsh plugin --profile web remove dsh-chatgpt-sub`，然后重启 DSH。卸载会保留 `~/.codex/auth.json`（Codex CLI 自己的登录态），清除本插件的绑定和它管理的 DSH 条目。想退回上一版而不卸载：更新失败后、或新版正在等待重启时，可在**版本与更新**里回滚。报告问题时，不要附登录文件、凭据或真实账号信息。
 
 ## 语言
 

package/docs/INSTALL.md

@@ -10,13 +10,13 @@
 
 ### 方式一：在 DSH 插件页添加（推荐；桌面端唯一方式）
 
-打开 DSH 的 **插件 → 添加插件**，在「包名或地址」里填仓库地址（当前推荐）：
+打开 DSH 的 **插件 → 添加插件**，在「包名或地址」里填包名（推荐）：
 
 ```
-https://github.com/SONGOAO25/dsh-chatgpt-sub
+dsh-chatgpt-sub
 ```
 
-2026-10-10 查询 npm 公开仓库时未找到 `dsh-chatgpt-sub`，目前请用仓库地址。确认 npm 发布成功后才可按包名安装。填仓库地址安装仓库根（`lib/` 已入库，所以填地址安装**不跑构建、不会弹「待批准的构建脚本」**）。同一个框也接受：
+npm 上的 `dsh-chatgpt-sub` 自 2026-10-13（0.5.1）起公开可装。也可以填仓库地址，安装的是仓库根（`lib/` 已入库，所以填地址安装**不跑构建、不会弹「待批准的构建脚本」**）。同一个框也接受：
 
 - 本仓库工作副本的绝对路径 —— 用于开发（会产生 `link:` 安装）。
 
@@ -27,7 +27,7 @@ https://github.com/SONGOAO25/dsh-chatgpt-sub
 用你实际启动的 profile（`dsh web` 启动的是 `web`）：
 
 ```bash
-# npm 发布成功后才可使用（当前请用下方仓库地址）
+# 按包名（推荐；0.5.1 起已在 npm 公开）
 dsh plugin --profile web add dsh-chatgpt-sub
 
 # 或仓库默认分支（不跑构建，lib/ 已入库）
@@ -85,7 +85,7 @@ dsh --profile web --dump-config | grep dsh-chatgpt-sub
 
 在插件页的**版本与更新**里选择自动更新（默认）或手动更新。自动更新在 DSH 启动时检查 npm、校验并替换插件文件，重启后生效；手动检查只查询版本，安装前会弹出确认。更新失败自动恢复旧文件，需要时可以回滚；登录和绑定信息保留。设置页会显示运行版本、最新版本、上次检查时间以及是否需要重启。
 
-更新状态、日志和备份保存在本端 `DSH_HOME` 下的 `dsh-chatgpt-sub/`（默认 `~/.dsh/dsh-chatgpt-sub/`；`DSH_CHATGPT_DATA_DIR` 可覆盖）。共享 Codex 登录文件及已有绑定标记位置保持原样。源码和链接安装不自动替换文件，仍按下面的方法更新。npm 包未公开时无法下载更新。
+更新状态、日志和备份保存在本端 `DSH_HOME` 下的 `dsh-chatgpt-sub/`（默认 `~/.dsh/dsh-chatgpt-sub/`；`DSH_CHATGPT_DATA_DIR` 可覆盖）。共享 Codex 登录文件及已有绑定标记位置保持原样。源码和链接安装不自动替换文件，仍按下面的方法更新；自动/手动更新都依赖 npm 上的公开版本（`dsh-chatgpt-sub` 自 0.5.1 起已公开）。
 
 ### 手动更新本地副本或迁移安装
 
@@ -132,7 +132,7 @@ dsh plugin --profile web remove dsh-chatgpt-sub
 | 现象 | 原因与处理 |
 |---|---|
 | 插件详情里没有配置页 | ① 没重启：需重启 DSH；② 装错 profile：确认启动用的 profile 与安装目标一致；③ `dsh --profile web --dump-config` 里没有 dsh-chatgpt-sub：重新执行安装 |
-| 插件页或命令行报「未找到相关插件」 | 先检查包名；npm 尚未发布或暂不可用时，改用仓库地址安装 |
+| 插件页或命令行报「未找到相关插件」 | 先检查包名拼写；包名解析不到时改用仓库地址安装 |
 | 插件页报「这个包没有声明组合包」 | 装到的是一个「仓库根不是包」的仓库。本仓库根目录一直是包；请确认填的是本仓库，并用包含最新提交的地址 |
 | 插件页提示「有依赖的安装脚本需要你允许」/「待批准的构建脚本」 | 装到的清单里声明了 `prepare` / `prepack`（本仓库当前清单没有，只有 `prepublishOnly`）。用最新提交的仓库地址重装；确实需要放行时，按提示把 pnpm 打印的那一行加进 profile 的 `pnpm-workspace.yaml` 的 `allowBuilds` 再重试 |
 | 命令行报 `profile "desktop" is managed exclusively by the Electron application` | 桌面端客户端的 profile 不能用 CLI 改：请在客户端 **插件 → 添加插件** 里安装/卸载 |