@menghuan1918/dsh-apollo 0.4.0 → 0.4.1

package/README.md

@@ -86,7 +86,7 @@ flowchart TB
 
 ```sh
 # npm 安装（推荐）
-dsh plugin --profile <profile> add @menghuan1918/dsh-apollo@0.4.0
+dsh plugin --profile <profile> add @menghuan1918/dsh-apollo@0.4.1
 
 # 或从 GitHub main 源码安装（备选）
 dsh plugin --profile <profile> add github:Menghuan1918/dsh-apollo
@@ -94,13 +94,13 @@ dsh plugin --profile <profile> add github:Menghuan1918/dsh-apollo
 
 npm 包页面：[`@menghuan1918/dsh-apollo`](https://www.npmjs.com/package/@menghuan1918/dsh-apollo)。安装、升级或换包都会改变运行的代码，必须重启对应 profile 的 DSH 进程；只刷新网页不够。重启后选择「工程模式」；需要 CLI 时，打开 **Plugins → @menghuan1918/dsh-apollo → `apollo-skills` 行** 按需启用。
 
-> npm 和 GitHub 安装都会自动带入精确依赖 `dsh-better-goal@0.1.0`，**不需要再单独安装**。安装 Apollo 不会安装、登录或启用 Codex / Claude。
+> npm 和 GitHub 安装都会自动带入精确依赖 `dsh-better-goal@0.2.0`，**不需要再单独安装**。安装 Apollo 不会安装、登录或启用 Codex / Claude。
 
 如果之前通过 GitHub 或 `link:` 安装了旧名 `dsh-apollo`，迁移到 scoped npm 包时请按下面两条命令手动处理，不要依赖自动迁移。会话记录会保留，但换包后仍须重启对应 profile（刷新网页不够）：
 
 ```sh
 dsh plugin --profile <profile> remove dsh-apollo
-dsh plugin --profile <profile> add @menghuan1918/dsh-apollo@0.4.0
+dsh plugin --profile <profile> add @menghuan1918/dsh-apollo@0.4.1
 ```
 
 > `dsh-apollo` 只是旧入口名；unscoped 的 `dsh-apollo` 已被其他项目占用，不要从 npm 安装它。
@@ -153,9 +153,9 @@ flowchart TB
 
 ## 长期目标
 
-目标域由独立插件 **[`dsh-better-goal`](https://www.npmjs.com/package/dsh-better-goal)**（npm `0.1.0`）提供，Apollo 负责把它装进同一个 profile。每个会话一个持久目标；执行步骤单独记录，不与目标混在一起。模型侧只看到一个 `goal` 工具，人侧用 `/goal` 管理同一个目标。
+目标域由独立插件 **[`dsh-better-goal`](https://www.npmjs.com/package/dsh-better-goal)**（npm `0.2.0`）提供，Apollo 负责把它装进同一个 profile。每个会话一个持久目标；执行步骤单独记录，不与目标混在一起。模型侧只看到一个 `goal` 工具，人侧用 `/goal` 管理同一个目标。
 
-> **相较原生 goal，重点不只是继续跑，而是该停时能停。** 缺少必需密钥、权限或外部条件时，Agent 可以立即记录失败原因并停止续跑，不用先凑目标轮数；提问默认等 120 秒，超时后仍可回答，也可以先推进不依赖答案的工作。原生的受阻门槛、恢复限制、默认阻塞提问与本插件的[完整对照](https://github.com/Menghuan1918/dsh-better-goal/blob/main/README.md#与-dsh-原生-goal-对比)见独立插件文档。
+> **相较原生 goal，重点不只是继续跑，而是该停时能停。** 缺少必需密钥、权限或需要你做决定时，Agent 会立即暂停目标并说明缺什么，不会为了“完成”而伪造、跳过检查或缩小范围，也不用先凑目标轮数；提问默认等 120 秒，超时后仍可回答，也可以先推进不依赖答案的工作。原生的受阻门槛、恢复限制、默认阻塞提问与本插件的[完整对照](https://github.com/Menghuan1918/dsh-better-goal/blob/main/README.md#与-dsh-原生-goal-对比)见独立插件文档。
 
 - **默认轮数策略是 `agent`**：由 Agent 按任务决定是否设置上限；切到 `fixed` 才使用配置值，`unlimited` 不施加策略性轮数上限。
 - **固定值默认 `256`**，只在 `fixed` 模式生效。
@@ -213,7 +213,7 @@ flowchart TB
 
 <details><summary>需要单独安装 dsh-better-goal 吗？</summary>
 
-不需要。通过 npm 或 GitHub 安装 Apollo 时，Apollo 会把 `dsh-better-goal@0.1.0` 作为固定依赖装配进来，goal 行和 `/goal` 一起可用。只有在准备脱离 Apollo 单独使用目标插件时，才按[独立包页面](https://www.npmjs.com/package/dsh-better-goal)或独立仓库说明安装；不要在同一个 profile 里重复添加两个 goal bundle。
+不需要。通过 npm 或 GitHub 安装 Apollo 时，Apollo 会把 `dsh-better-goal@0.2.0` 作为固定依赖装配进来，goal 行和 `/goal` 一起可用。只有在准备脱离 Apollo 单独使用目标插件时，才按[独立包页面](https://www.npmjs.com/package/dsh-better-goal)或独立仓库说明安装；不要在同一个 profile 里重复添加两个 goal bundle。
 
 </details>
 

package/docs/DEVELOPMENT.md

@@ -2,7 +2,7 @@
 
 面向维护者、集成者和需要排查装配问题的用户。用户安装与配置请看 [README](../README.md)；本文保留 [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness)（DSH）插件的实现细节、历史兼容与验证方法。
 
-当前实现版本：`0.4.0`；npm 包名是 `@menghuan1918/dsh-apollo`。纯 ESM，无构建步骤；宿主浏览器半边是直接加载的闭包工厂，不需要打包。
+当前实现版本：`0.4.1`；npm 包名是 `@menghuan1918/dsh-apollo`。纯 ESM，无构建步骤；宿主浏览器半边是直接加载的闭包工厂，不需要打包。
 
 ## 目录
 
@@ -32,7 +32,7 @@
 运行时依赖：
 
 - `@deepseek-ai/schemastery`：行配置 schema；
-- `dsh-better-goal`：独立的 goal 插件，依赖精确的 npm 版本 `0.1.0`（见 `dependencies`），不是 Git commit、分支、范围或 `file:` 说明符；
+- `dsh-better-goal`：独立的 goal 插件，依赖精确的 npm 版本 `0.2.0`（见 `dependencies`），不是 Git commit、分支、范围或 `file:` 说明符；
 - `react` 是 peer dependency，由宿主提供。
 
 ### 为什么宿主只有一行 `apollo-skills`
@@ -460,10 +460,10 @@ Claude 的默认登录态与显式 `CLAUDE_CONFIG_DIR` 语义不同：
 ### npm 安装
 
 ```sh
-dsh plugin --profile <profile> add @menghuan1918/dsh-apollo@0.4.0
+dsh plugin --profile <profile> add @menghuan1918/dsh-apollo@0.4.1
 ```
 
-包发布到 npm 官方 registry 后即可用此命令安装，并带入精确依赖 `dsh-better-goal@0.1.0`，同时应用三份 bundle patch。安装后需要重启对应 profile 的 DSH 进程。README 中的 npm 命令是发布后的安装路径；首发完成前不要宣称 registry 已有该版本。
+包发布到 npm 官方 registry 后即可用此命令安装，并带入精确依赖 `dsh-better-goal@0.2.0`，同时应用三份 bundle patch。安装后需要重启对应 profile 的 DSH 进程。README 中的 npm 命令是发布后的安装路径；首发完成前不要宣称 registry 已有该版本。
 
 ### GitHub 源码安装
 
@@ -471,7 +471,7 @@ dsh plugin --profile <profile> add @menghuan1918/dsh-apollo@0.4.0
 dsh plugin --profile <profile> add github:Menghuan1918/dsh-apollo
 ```
 
-GitHub main 仍是源码安装选项。它同样按 `package.json` 解析精确依赖 `dsh-better-goal@0.1.0`，因此不能早于 Goal 的 npm 发布推进 main：Goal 尚未在 registry 可取得时，源码安装会因依赖 404 失败。安装后重启 profile。
+GitHub main 仍是源码安装选项。它同样按 `package.json` 解析精确依赖 `dsh-better-goal@0.2.0`，因此不能早于 Goal 的 npm 发布推进 main：Goal 尚未在 registry 可取得时，源码安装会因依赖 404 失败。安装后重启 profile。
 
 ### 本地 link 安装
 
@@ -484,7 +484,7 @@ dsh plugin --profile <profile> add link:/absolute/path/to/dsh-apollo
 注意：
 
 - `dsh plugin add link:` 只链接 Apollo 本身，不会代装它的依赖；所以必须先 `npm install`；
-- 开发时可将 `dsh-better-goal` 临时改为 `file:../dsh-better-goal`，但不要提交该改动；发布版必须保持精确 npm 版本 `0.1.0`，不要写成 Git SHA、分支或范围；
+- 开发时可将 `dsh-better-goal` 临时改为 `file:../dsh-better-goal`，但不要提交该改动；发布版必须保持精确 npm 版本（当前 `0.2.0`），不要写成 Git SHA、分支或范围；
 - 不需要启动额外服务或构建 Web 资源；宿主提供 React。
 
 ### 核对
@@ -510,15 +510,14 @@ dsh plugin --profile <profile> remove @menghuan1918/dsh-apollo
 
 旧 unscoped 安装使用 `remove dsh-apollo`。卸载 Apollo 后，Apollo 插入的 `dsh-better-goal` 行也会消失。如果之前单独安装过独立 bundle，需要按独立插件的说明处理；不要留下两个 goal 状态服务或续跑驱动同时工作。
 
-### npm 首发顺序
+### npm 发布顺序
 
-首发只做人工发布，不把登录、2FA 或 publish 放进脚本：
+两个仓库都由 GitHub Release 触发 `.github/workflows/release.yml`，通过 npm trusted publishing（OIDC）发布，仓库里不存 npm token。tag 必须是 `v<package.json 的 version>`，CI 会先校验再跑测试和 `npm publish --provenance`。
 
-1. 在 Goal 仓库人工发布 `dsh-better-goal@0.1.0` tarball；发布目标必须是 `https://registry.npmjs.org/`，`access` 为 `public`。
-2. 在官方 registry 验证 `0.1.0` 已可取得（查询版本并下载 tarball），排除镜像或本地缓存造成的假象。
-3. 再人工发布 `@menghuan1918/dsh-apollo@0.4.0` tarball，同样指向 `https://registry.npmjs.org/` 且 `access` 为 `public`。
-4. 登录、2FA 和 publish 都由维护者在真实终端完成；OTP、token 和恢复码不得写入脚本、环境文件或仓库。
-5. 在 Goal 发布并验证通过前，不要把 Apollo 的 `package.json` 精确依赖 `0.1.0` 合并或推送到 main，否则 GitHub 源码安装会解析到尚不存在的 Goal 版本并 404。
+1. 先发布 Goal：在 `dsh-better-goal` 仓库推 main 并发布 Release（如 `v0.2.0`）。
+2. 在官方 registry（`https://registry.npmjs.org/`）确认该版本已可取得，排除镜像或缓存造成的假象。
+3. 再把 Apollo 的精确依赖改到该版本，推 main 并发布 Apollo Release（如 `v0.4.1`）。
+4. Goal 版本可取得前，不要把指向它的精确依赖推到 Apollo main，否则 GitHub 源码安装会 404。
 
 ## 测试与冒烟
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@menghuan1918/dsh-apollo",
-  "version": "0.4.0",
+  "version": "0.4.1",
   "description": "DSH plugin: 流程技能、工程模式、Codex/Claude 可续接子代理与统一设置。纯 ESM，无构建步骤。",
   "license": "GPL-3.0-or-later",
   "repository": {
@@ -53,7 +53,7 @@
   },
   "dependencies": {
     "@deepseek-ai/schemastery": "~3.18.4",
-    "dsh-better-goal": "0.1.0"
+    "dsh-better-goal": "0.2.0"
   },
   "peerDependencies": {
     "react": "^18.2.0"