pi-zh-cn 0.2.4 → 0.2.6

package/README.md

@@ -48,6 +48,16 @@ pi remove npm:pi-zh-cn
 /footer
 ```
 
+## 兼容性
+
+`peerDependencies` 只设下限（`>=0.84.0`）不设上限，pi 出新版也不会被拦住。兼容性靠测试保证，不靠钉版本：
+
+- push/PR：对着 lockfile 钉住的基线跑契约测试
+- 每两天：上游金丝雀忽略 lockfile、拉最新版 pi 跑同一套测试
+- 基线本身由 Dependabot 自动开 PR 跟进，它的 PR 就是一次新版兼容性验证，绿了合并即完成升级
+
+Node 版本要求跟随 pi，由 pi 自己声明和检查。
+
 ## 已知局限
 
 - 内置菜单和其他硬编码在 pi 源码里的英文保持原样——扩展 API 够不到，除非 fork 上游重编译，不值得
@@ -76,15 +86,34 @@ footer 的 dist 源码，任一结构变化都会失败并指明该核对哪个
 npm test   # tsc 类型检查 + 全部测试
 ```
 
-CI 在每次 push/PR 时运行，并每两天定时跑一次「上游金丝雀」：因为 peer
-依赖是 `*`，定时任务会拉到最新版 pi，上游发布后两天内即可自动暴露兼容
-性问题，不用等用户反馈。
+CI 在每次 push/PR 时运行，并每两天定时跑一次「上游金丝雀」：本地开发
+基线由 `package-lock.json` 钉住，而金丝雀那趟会忽略 lockfile、拉到最新
+版 pi，所以上游发布后两天内即可自动暴露兼容性问题，不用等用户反馈。
+
+### 发布
+
+改完 `package.json` 的 `version` 并提交后，打 tag 推上去即可：
+
+```bash
+git tag -a v0.2.6 -m "0.2.6: 一句话说明"
+git push origin v0.2.6
+```
+
+`.github/workflows/publish.yml` 会核对 tag 与版本号、跑一遍测试、发布到 npm
+并生成 provenance。认证走 npm Trusted Publishing（OIDC），仓库里不放
+`NPM_TOKEN`——那种长期 token 一过期就卡住发版。前提是 npmjs.com 上已把本
+仓库配成该包的 Trusted Publisher（一次性）；没配的话 publish 步骤会失败，
+退回本地 `npm login && npm publish` 即可。
+
+GitHub Release 的正文单独写，用 `gh release create v0.2.6 --notes-file …` 建。
+补打历史 tag 时要注意：Release 列表按 **tag 时间**排序，不是按创建时间，
+所以得带上原始时间（`GIT_COMMITTER_DATE=<原始时间> git tag -a …`）。
 
 ## 反馈
 
 pi 大版本升级后如果出现错位或残留英文，欢迎[提 issue](https://github.com/GoetheDady/pi-zh-cn/issues)。
 
-改动记录见 [CHANGELOG.md](CHANGELOG.md)。
+改动记录见 [GitHub Releases](https://github.com/GoetheDady/pi-zh-cn/releases)。
 
 ## License
 

package/extensions/header.ts

@@ -9,6 +9,7 @@ import {
   VERSION,
   type ExtensionContext,
 } from "@earendil-works/pi-coding-agent";
+import { truncateToWidth } from "@earendil-works/pi-tui";
 import { zh } from "./zh.ts";
 
 /**
@@ -36,15 +37,21 @@ export function setChineseHeader(ctx: ExtensionContext) {
         rawKeyHint("!", "bash"),
         keyHint("app.tools.expand", zh.header.more),
       ].join(theme.fg("muted", " · "));
+      // 窄终端时按宽度截断，避免触发 pi 的超宽崩溃检查
+      const w = Math.max(1, _width);
       return [
-        logo,
-        compact,
-        theme.fg(
-          "dim",
-          `${zh.header.expandHelp} (${keyText("app.tools.expand")})`,
+        truncateToWidth(logo, w, ""),
+        truncateToWidth(compact, w, ""),
+        truncateToWidth(
+          theme.fg(
+            "dim",
+            `${zh.header.expandHelp} (${keyText("app.tools.expand")})`,
+          ),
+          w,
+          "",
         ),
         "",
-        theme.fg("dim", zh.header.onboarding),
+        truncateToWidth(theme.fg("dim", zh.header.onboarding), w, ""),
       ];
     },
     invalidate() {},

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-zh-cn",
-  "version": "0.2.4",
+  "version": "0.2.6",
   "description": "pi 编码代理的简体中文界面汉化插件",
   "repository": {
     "type": "git",
@@ -26,11 +26,14 @@
   },
   "peerDependencies": {
     "@earendil-works/pi-ai": "*",
-    "@earendil-works/pi-coding-agent": "*",
-    "@earendil-works/pi-tui": "*"
+    "@earendil-works/pi-coding-agent": ">=0.84.0",
+    "@earendil-works/pi-tui": ">=0.84.0"
   },
   "devDependencies": {
+    "@earendil-works/pi-ai": ">=0.85.1",
+    "@earendil-works/pi-coding-agent": ">=0.85.1",
+    "@earendil-works/pi-tui": ">=0.85.1",
     "@types/node": "^26.3.0",
-    "typescript": "^5.9.3"
+    "typescript": "^7.0.2"
   }
 }