@shulex/cxclawctl 0.1.8 → 0.1.10

package/README.md

@@ -33,15 +33,12 @@ codex plugin marketplace add SolveaCX/cx_claw_codex --ref marketplace/stable
 codex plugin add cxclaw@cxclaw
 ```
 
-然后完成钉钉登录：
+安装后不需要单独执行登录命令。首次使用任何需要服务端访问的 CXClaw 能力时，CLI 会自动打开钉钉授权页并持续监听授权结果；授权成功后自动继续原命令，不需要再对 Codex 回复“已授权”。浏览器成功打开时，CLI 不会把授权链接输出给 Agent；只有浏览器无法打开时才显示备用链接和设备码。插件内置的 Stop hook 会在授权仍进行时阻止 Codex 提前结束当前轮次；首次安装或 hook 内容变化后，需要在 Codex 中审查并信任该 hook。
 
-```bash
-npx --yes @shulex/cxclawctl@latest auth login
-```
-
-CLI 固定连接生产授权服务 `https://ai.solvea.cx/api_v2/ticket`，不接受用户指定服务地址或登录环境。CLI 会打开钉钉授权页；一次登录即可访问获准的测试和生产租户。授权完成后，检查登录状态和本地版本：
+CLI 固定连接生产授权服务 `https://ai.solvea.cx/api_v2/ticket`，不接受用户指定服务地址或登录环境。一次登录即可访问获准的测试和生产租户。需要人工诊断授权时，可以执行：
 
 ```bash
+npx --yes @shulex/cxclawctl@latest auth ensure
 npx --yes @shulex/cxclawctl@latest auth status
 npx --yes @shulex/cxclawctl@latest doctor
 ```
@@ -179,41 +176,15 @@ bun run check:capabilities
 
 ## 发布
 
-使用版本准备脚本同步修改 npm、插件清单和能力清单中的版本：
+稳定版使用一条命令创建发布 PR，日常修复默认使用 `patch`：
 
 ```bash
-bun run release:prepare <版本号>
+bun run release:create patch
 ```
 
-版本规则：
-
-- `vX.Y.Z` 发布到 `stable`
-- `vX.Y.Z-canary.N` 发布到 `canary`
-- `vX.Y.Z-dev.N` 发布到 `dev`
-
-稳定版必须在 `release/vX.Y.Z` 分支准备版本并创建 PR。PR 经过评审并合入 `main` 后，GitHub Actions 才会创建 tag 和发布。不要直接推送稳定版 tag。
-
-`canary` 和 `dev` 预发布版在通过 CI 的提交上推送对应 tag 后发布：
-
-```bash
-git push origin vX.Y.Z-canary.N
-git push origin vX.Y.Z-dev.N
-```
-
-发布流水线会固定到触发发布的 Git commit，并依次执行测试、构建、能力校验、npm 发布、GitHub Release 和 Marketplace 通道推进。只有前一步成功才会执行下一步；npm 包未发布时不会推进 `marketplace/<channel>`。
-
-npm 发布需要在 GitHub 的 `npm-publish` Environment 或仓库中配置 Secret `NPM_TOKEN`。缺少凭据会让发布失败，不会跳过。
-
-发布产物包括：
-
-```text
-cxclaw-agent-plugin.zip
-cxclaw-agent-plugin.json
-cxclaw-agent-plugin.sha256
-cxclaw-codex-plugin.zip
-```
+也支持 `minor`、`major` 或明确版本号，例如 `bun run release:create 0.2.0`。命令会统一版本、执行完整检查并创建 `release/vX.Y.Z` PR。PR 合入后，发布流水线才会发布 npm、创建 GitHub Release 并推进 `marketplace/stable`；PR 创建成功不等于已经发布。
 
-插件 ZIP 只从已提交的 Git 快照生成，不会包含本地未提交文件。
+维护者和 AI 在操作前必须阅读完整的[发布手册](./docs/releasing.md)。手册包含版本选择、预发布、合并后验收、失败恢复和禁止操作。仓库根目录的 [`AGENTS.md`](./AGENTS.md) 记录了 AI 每次进入仓库都会读取的强制规则。
 
 ## 仓库结构
 

package/capabilities.lock.json

@@ -1,8 +1,8 @@
 {
   "schemaVersion": 1,
   "plugin": {
-    "pluginVersion": "0.1.8",
-    "cliVersion": "0.1.8",
+    "pluginVersion": "0.1.10",
+    "cliVersion": "0.1.10",
     "toolSchemaVersion": "1",
     "serverApiVersion": "1"
   },
@@ -158,6 +158,7 @@
     }
   ],
   "localCommands": [
+    "node \"<PLUGIN_ROOT>/plugin-cli.mjs\" auth ensure",
     "node \"<PLUGIN_ROOT>/plugin-cli.mjs\" auth status",
     "node \"<PLUGIN_ROOT>/plugin-cli.mjs\" tenant current",
     "node \"<PLUGIN_ROOT>/plugin-cli.mjs\" tenant search",