oh-my-dws 0.0.1 → 0.0.2

package/README.md

@@ -157,11 +157,31 @@ dws chat +chat-messages --group "<cid>" --page-all --download-resources --output
 ## 开发
 
 ```bash
-node bin/oh-my-dws.js --no-open --port 8850   # 本地调试
-npm pack --dry-run                            # 检查发布内容
-npm publish                                   # 发布（需 npm 登录）
+node bin/oh-my-dws.js --no-open --port 26000   # 本地调试（前台）
+npm run check                                  # 语法 + 网页 id 引用自检
+npm pack --dry-run                             # 检查发布内容
 ```
 
+## 发版（打 tag 自动发 npm）
+
+仓库里已有 `.github/workflows/release.yml`：**推 `v*` tag 就自动 `npm publish`**。
+
+1. 一次性（二选一）：
+   - **可信发布（推荐）**：npm 包页面 `/access` → Trusted Publishers → Add publisher → GitHub Actions，
+     填 `duzhenxun` / `oh-my-dws` / `release.yml`，Environment 留空；不用任何 token
+   - **或用 token**：npm 建 **Automation** token，存进 GitHub Secrets，名字 `NPM_TOKEN`
+2. 以后一条命令发版：
+
+```bash
+npm run release          # 0.0.1 → 0.0.2（改版本 + commit + tag + push）
+npm run release:minor    # → 0.1.0
+npm run release:major    # → 1.0.0
+```
+
+CI 会校验 **tag 与 `package.json` 版本一致**、跑 `npm run check`、`npm pack --dry-run`、
+已发布过则跳过，最后 `npm publish --access public` 并建 GitHub Release。
+细节与报错处理见 [docs/使用说明.md](docs/使用说明.md)。
+
 ## 注意
 
 - 图片消息正文只返回 `mediaId`，需要实际图片时由网页按需下载。

package/docs//344/275/277/347/224/250/350/257/264/346/230/216.md

@@ -113,17 +113,77 @@ oh-my-dws start
 
 **macOS 双击 `启动.command`**：等价 `oh-my-dws start`（后台常驻 + 开浏览器），关掉终端窗口服务照旧跑；停用 `oh-my-dws stop`。
 
-## 六、自己发布这个包
+## 六、发版：打 tag 自动发 npm
+
+发版已经交给 CI（`.github/workflows/release.yml`）：**推 `v*` tag → GitHub Actions 自动 `npm publish`**。
+
+### 一次性配置（二选一）
+
+**方式 A：可信发布（推荐，不用管 token）**
+
+在 https://www.npmjs.com/package/oh-my-dws/access → **Trusted Publishers** → Add publisher，
+选 **GitHub Actions**，按这样填（大小写、名字必须一模一样）：
+
+| 字段 | 填什么 |
+|---|---|
+| Publisher | `GitHub Actions` |
+| Organization or user | `duzhenxun` |
+| Repository | `oh-my-dws` |
+| Workflow filename | `release.yml` |
+| Environment name | 留空 |
+
+保存后 CI 里不需要任何 token；workflow 已带 `id-token: write` 并把 npm 升到 ≥ 11.5.1。
+
+**方式 B：Automation token（旧做法）**
+
+1. npmjs.com → Access Tokens → Generate New Token → **Automation**
+2. 仓库 → Settings → Secrets and variables → Actions → New repository secret，名字 `NPM_TOKEN`
+
+workflow 两种都兼容：有 `NPM_TOKEN` 就用它，没有就走 OIDC 可信发布。
+
+> 别加 `--provenance`：provenance 只允许**公开仓库**，本仓库是 private，加了会 422。
+
+### 以后发版
+
+```bash
+npm run release          # 补丁版 0.0.1 → 0.0.2（改 package.json + commit + tag + push）
+npm run release:minor    # 次版本 0.1.0
+npm run release:major    # 主版本 1.0.0
+```
+
+这三个脚本做的是 `npm version <x> -m "chore: release v%s"` + `git push --follow-tags`，
+tag 推上去后 CI 自动跑完发布。想手动控制也可以：
 
 ```bash
-npm login                       # 账号：你的 npm 用户
-npm --version && npm pack --dry-run   # 先看打包内容
-npm publish                     # 第一次发 0.0.1（publishConfig.access=public）
+npm version 0.0.3 -m "chore: release v%s"
+git push --follow-tags
 ```
 
-发布后就能：
+### CI 做了什么
+
+1. 校验 **tag 与 `package.json` 版本一致**（`v0.0.3` ↔ `0.0.3`，不一致直接失败，不会发错版本）
+2. 跑 `npm run check`（全部 JS 语法 + 网页内联脚本 + `$("#id")` 引用是否都存在）
+3. `npm pack --dry-run` 看打包内容
+4. npm 上已有该版本则跳过（可安全重跑）
+5. `npm publish --access public`（token 走 `NPM_TOKEN`）
+6. 建同名 GitHub Release
+
+### 发了之后
 
 ```bash
 npm i -g oh-my-dws            # 装
-oh-my-dws update              # 以后升级 + 自动重启
+oh-my-dws update              # 升级到 latest 并自动重启
 ```
+
+### 常见错误
+
+| 报错 | 原因 / 处理 |
+|---|---|
+| `EOTP` / 要求一次性验证码 | 本地发布才会遇到；CI 用可信发布或 Automation token 不会 |
+| `E401` / `Unable to authenticate` | 可信发布里的 Workflow filename / repo 写错，或 `id-token: write` 没开 |
+| `E403` 无权限发布 | token 没给这个包的读写权限，或包名被别人占 |
+| `422 Unsupported ... visibility: private` | 给私有仓库加了 `--provenance`，去掉它 |
+| `npm 版本太低` | 可信发布需要 npm ≥ 11.5.1，workflow 里已自动 `npm i -g npm@latest` |
+| CI 报 tag 与版本不一致 | 先 `npm version` 再打 tag，不要直接手推 tag |
+
+> 手动应急发布（不经过 CI）：`npm publish --otp=<6位码>`

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "oh-my-dws",
-  "version": "0.0.1",
+  "version": "0.0.2",
   "description": "钉钉群消息归档：本地网页控制台浏览、增量拉取、按群归档与全文 Markdown 导出，数据存放于 ~/.oh-my-dws（支持 start/stop/restart/status/update）",
   "keywords": [
     "dingtalk",
@@ -37,7 +37,11 @@
     "stop": "node bin/oh-my-dws.js stop",
     "status": "node bin/oh-my-dws.js status",
     "restart": "node bin/oh-my-dws.js restart",
-    "prepublishOnly": "node -e \"require('fs').accessSync('web/index.html')\""
+    "prepublishOnly": "node -e \"require('fs').accessSync('web/index.html')\"",
+    "check": "node scripts/check.js",
+    "release": "npm version patch -m \"chore: release v%s\" && git push --follow-tags",
+    "release:minor": "npm version minor -m \"chore: release v%s\" && git push --follow-tags",
+    "release:major": "npm version major -m \"chore: release v%s\" && git push --follow-tags"
   },
   "engines": {
     "node": ">=18"