@leviyuan/lodestar 0.21.30 → 0.21.31

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/docs/AGENTS.md CHANGED
@@ -10,6 +10,7 @@ README 保留项目哲学、项目介绍、最短快速开始、常用指令表
10
10
  - `usage.md`:群内命令、会话、worktree、文件与生图、本机通知。
11
11
  - `models.md`:账号、模型与 effort、OpenRouter 默认列表、DSH 与 GLM 接入。
12
12
  - `claude-agent-backend.md`:后端实现、模型路由和会话行为。
13
+ - `release.md`:发版步骤、工作流入口、凭据位置和常见坑(本机不 publish)。
13
14
 
14
15
  - 保留 Codex、Claude Code 订阅、GLM、DeepSeek、OpenRouter、通用中转站和 DeepSeek Harness 的支持说明。
15
16
  - 只写已实现的行为。删除失效接口、历史方案、重复规则和无法复现的验证结论;不另建产品规范或计划。
@@ -0,0 +1,27 @@
1
+ # 发布
2
+
3
+ 发布包由 GitHub Actions 的 `发布版本` 工作流(`.github/workflows/release.yml`)发布。本机没有仓库令牌,`secrets.NPM_TOKEN` 与 `secrets.GH_PACKAGES_TOKEN` 只存在于仓库 Secrets,因此**不要在本机执行 `npm publish`**,也不要为此改发布脚本。
4
+
5
+ ## 步骤
6
+
7
+ 1. 升版本:只改 `package.json` 的 `version`(未指定 minor/major 时只升 patch),例如 `0.21.31`。
8
+ 2. 本地检查:`bun run typecheck`、`bun test`、`bun run build`、`bun scripts/sync-security-deps.ts --check`。
9
+ 3. 提交并推送 `main`(远端名为 `github`):`git push github main`。
10
+ 4. 打并推送标签:`git tag v0.21.31 && git push github v0.21.31`。标签必须与 `version` 一致,且指向要发布的提交(工作流会校验)。
11
+ 5. 触发工作流:`gh workflow run release.yml -f tag=v0.21.31`。
12
+ 6. 等待结果:`gh run watch`,或 `gh run list --workflow=release.yml --limit 1`。
13
+ 工作流依次做:校验标签/版本 → 探测两个仓库身份 → `bun run ci` → `npm pack` → tarball 验收(`test-codex-plugin-upgrade`、`npm audit --omit=dev`、`check-installed-package`)→ 上传制品 → 发布 npm → 发布 GitHub Packages。
14
+ 7. 发布成功后建 GitHub Release(标题、功能说明和验证结果用中文):
15
+
16
+ ```bash
17
+ gh release create v0.21.31 --title "v0.21.31 <中文摘要>" --notes-file /tmp/notes.md
18
+ ```
19
+
20
+ 同一版本必须同时发布 npm 与 GitHub Packages,并推送 `main` 与 tag。
21
+
22
+ ## 常见坑
23
+
24
+ - 本机 npm 是 12.x,`npm pack` 会因 `bundleDependencies`(`mathjax-full`)与 `overrides`(含 `@xmldom/xmldom`)冲突报 `EBUNDLEOVERRIDE`。发布包由工作流的 Node 22 环境生成;需要本地验收制品时才用 `npx npm@11.6.2 pack --json`,不要改 `package.json` 去绕开。
25
+ - 本机没有 `NODE_AUTH_TOKEN`,`gh` 的 OAuth 令牌也没有 `write:packages` 权限;本地 `npm publish` 和 `npm view --registry=https://npm.pkg.github.com` 都会 401,这不代表发布流程有问题。
26
+ - 发布中断但制品已验收时,用 `续发已验收版本`(`resume-release.yml`)传 `tag`、`run_id`、`attempt` 复用已验收制品,不重新打包;同一版本续发只核对远端完整性。
27
+ - `scripts/publish-verified-package.mjs` 只接受 `npm pack --json` 生成的清单(含 `name`、`version`、`filename`、`integrity`),并在 `NODE_AUTH_TOKEN` 缺失时直接拒绝发布。
package/docs/usage.md CHANGED
@@ -84,7 +84,7 @@ Linux/macOS 下,额外账号通过软链接共用默认账号的配置、会
84
84
 
85
85
  WT 使用独立工作目录,其项目工具/MCP 配置与主目录分开。BTW/FK 始终共享来源目录的这些配置,包括从 WT 创建的临时群。文件交付统一按大小自动选择,云空间目录各群独立。任务清单属于项目级,主群、所有 WT 及其临时群共用。临时群的模型、账号在创建时继承,之后各自切换、互不影响。
86
86
 
87
- 已合并且未挂载的分支会折叠隐藏,再次启用时更新到主线。卡片上的“删”会检查对应群没有运行中的会话、工作区没有未提交变更,再解散群并删除 worktree;Git 分支保留。
87
+ 已合并且未挂载的分支会折叠隐藏,再次启用时更新到主线。卡片上的“删”会检查对应群和该分支下的临时群都没有运行中的会话、工作区没有未提交变更,先解散这些临时群,再解散群并删除 worktree;Git 分支保留。
88
88
 
89
89
  ## 临时会话与对话分支
90
90
 
@@ -92,12 +92,12 @@ WT 使用独立工作目录,其项目工具/MCP 配置与主目录分开。BTW
92
92
 
93
93
  | 完整指令 | 缩写 / 别名 | 行为 |
94
94
  | --- | --- | --- |
95
- | `btw [备注]` | — | 创建 `<session>*MMDD-HHMM` 临时群;带备注时用 `<session>*<备注>` 代替时间后缀。继承账号、模型并共享原工作目录配置,启动新会话 |
95
+ | `btw [备注]` | — | 创建 `<session>*MMDD-HHMM` 临时群;带备注时用 `<session>*<备注>` 代替时间后缀,同一个备注对应同一个群。基名跟随当前群:主群是 `<项目>`,WT 群是 `<项目>[分支]`。继承账号、模型并共享该目录配置,启动新会话 |
96
96
  | `fork` | `fk` | 选择一条用户输入,在临时群里从这条输入之前分叉 |
97
97
  | `back` | `bk` | 选择一条用户输入,让本群接到这条输入之前的新分支 |
98
- | `bye` | — | 停止并解散当前临时群,仅适用于 Lodestar 创建的临时群 |
98
+ | `bye` | — | 自己退出临时群;最后一个人退出时停止会话并解散整个群 |
99
99
 
100
- `btw` 的备注会直接成为群名后缀,支持中文、字母、数字、连字符和下划线;空格等字符会写成 `_`。备注重名时自动追加 `-2`、`-3`。`*` 后缀保留给临时群,普通项目群不要用 `*` 结尾。
100
+ `btw` 的备注会直接成为群名后缀,支持中文、字母、数字、连字符和下划线;空格等字符会写成 `_`。同一个备注就是同一个群:`项目*修复登录` 已存在时,其他成员再发 `btw 修复登录` 会被拉进这个群并沿用群内既有的会话与模型/账号设置,不新建 `-2`、`-3` 群,也不重启会话。不带备注的时间后缀仍按分钟去重,每次都是新群。临时群落在发起时所在的目录:主群发就落主项目目录,WT 群发就落该 worktree(群名相应带上 `[分支]`),所以分支和 btw 互不改写对方的目录;备注长到超过群名上限时明确拒绝,不会创建会被截断的同名群。创建、加入、退出和解散都用同一套临时群提示卡展示状态。`bye` 不看是谁创建的:群里有别人就只把自己移出,最后一个人退出时连同会话一起解散;机器人无权移出成员时提示在群设置里手动退出。`*` 后缀保留给临时群,普通项目群不要用 `*` 结尾。
101
101
 
102
102
  `fk`、`bk` 和从历史记录恢复的 `rs` 都使用后端原生 fork,保留源对话。选第 N 条输入表示回到它发出之前,选中的输入不包含在新分支内。Claude 的新分支在首条输入时获得会话 id,准备状态会持久保存;结果卡显示源会话、新会话和所选会话的最后一条用户输入。Claude 订阅账号全部额度耗尽时,恢复优先沿用该会话原来的账号。
103
103
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@leviyuan/lodestar",
3
- "version": "0.21.30",
3
+ "version": "0.21.31",
4
4
  "publishConfig": {
5
5
  "access": "public"
6
6
  },