pi-zh-cn 0.2.2 → 0.2.4

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 GoetheDady
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,40 +1,58 @@
 # pi-zh-cn
 
+[![npm version](https://img.shields.io/npm/v/pi-zh-cn.svg)](https://www.npmjs.com/package/pi-zh-cn)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
+
 把 [pi](https://github.com/earendil-works/pi) 编码代理的界面变成简体中文。装上重启即可，不想要了随时卸载。
 
-原理上它只是一个普通扩展：调用官方扩展 API 替换文案，不打补丁、不改安装目录里的任何文件，所以 pi 正常升级后一般也能直接用。
+## 特性
+
+- **零侵入**：只是普通扩展，调用官方扩展 API 替换文案，不打补丁、不改安装目录里的任何文件，pi 正常升级后一般也能直接用
+- **不改模型输入**：发给模型的内容保持不变，工具 description 保留英文原文，避免影响模型行为
+- **按需开启**：`grep`、`find`、`ls` 或 `powershell` 没开就不会被偷偷打开
+- **键位跟随**：快捷键提示跟随你自己的键位配置
 
-## 会变成中文的部分
+## 汉化范围
 
-- 启动画面：标题、快捷键提示、引导语（快捷键显示跟随你自己的键位配置）
+- 启动画面：标题、快捷键提示、引导语
 - 底部状态栏：当前目录 / 分支 / 会话名、token 与缓存用量、费用、上下文占比、模型和思考等级
 - 加载提示：「正在处理…」；thinking 折叠块的标签
 - 八个内置工具的执行结果：读取、执行（bash）、编辑、写入、搜索内容、查找文件、列出目录、PowerShell——状态行都是中文，比如「完成」「退出码 N」「输出过长已截断」
+- 编辑与写入的改动展示沿用 pi 内置渲染器（只有标题和展开提示是中文）：`edit` 显示行号 + 红绿 diff，`write` 预览文件内容（折叠 10 行，`ctrl+o` 展开全量）
 - 项目信任弹窗：信任/不信任选择，含「信任父文件夹」变体
+- 内置斜杠命令描述：core 全部 23 个命令
 
-发给模型的内容不变。工具的 description 保持英文原文，避免影响模型行为。
-
-## 保持原样的部分
-
-- 内置菜单和其他硬编码在 pi 源码里的英文（扩展 API 够不到，除非 fork 上游重编译，不值得）
-- 工具的启用范围：`grep`、`find`、`ls` 或 `powershell` 没开就不会被这个插件偷偷打开
-
-## 使用
+## 安装
 
 ```bash
-# 从 npm 安装
 pi install npm:pi-zh-cn
+```
+
+重启 pi 即生效。查看已安装的包：
 
-# 查看/卸载用这里显示的 source 名
+```bash
 pi list
 ```
 
-觉得中文状态栏不如原生好读，可以临时切回英文：
+### 卸载
+
+```bash
+pi remove npm:pi-zh-cn
+```
+
+### 临时切回英文
+
+觉得中文状态栏不如原生好读，可以在会话里执行：
 
 ```text
 /footer
 ```
 
+## 已知局限
+
+- 内置菜单和其他硬编码在 pi 源码里的英文保持原样——扩展 API 够不到，除非 fork 上游重编译，不值得
+- 实验性的全屏模式（`tuiMode: "fullscreen"`）文案写死在 pi-tui 里，同样够不到，例如 pi 0.85.0 新增的 `↓ Jump to latest message · <键位>`，以及搜索框的 `Find in transcript` / `No matches`
+
 ## 开发
 
 ```bash
@@ -47,4 +65,27 @@ pi --no-session -e ./extensions/index.ts -p "hi"
 
 所有文案都集中在 [`extensions/zh.ts`](extensions/zh.ts)，想改词只动这一个文件就够了。
 
-改动记录见 [CHANGELOG.md](CHANGELOG.md)。pi 大版本升级后如果出现错位或残留英文，欢迎提 issue。
+### 上游兼容性测试（契约测试）
+
+汉化依赖 pi 内部结构（footer 统计行、工具 details 字段、trust.json 语义、
+斜杠命令清单等），上游一变就可能静默失效。`test/` 下的契约测试把这些
+依赖点逐条断言：实际执行内置工具、实例化 `ProjectTrustStore`、探查内置
+footer 的 dist 源码，任一结构变化都会失败并指明该核对哪个文案。
+
+```bash
+npm test   # tsc 类型检查 + 全部测试
+```
+
+CI 在每次 push/PR 时运行，并每两天定时跑一次「上游金丝雀」：因为 peer
+依赖是 `*`，定时任务会拉到最新版 pi，上游发布后两天内即可自动暴露兼容
+性问题，不用等用户反馈。
+
+## 反馈
+
+pi 大版本升级后如果出现错位或残留英文，欢迎[提 issue](https://github.com/GoetheDady/pi-zh-cn/issues)。
+
+改动记录见 [CHANGELOG.md](CHANGELOG.md)。
+
+## License
+
+[MIT](LICENSE)

package/extensions/localized-tools.ts

@@ -13,20 +13,24 @@ import {
   createPowerShellTool,
   createReadTool,
   createWriteTool,
+  getLanguageFromPath,
+  highlightCode,
+  keyHint,
   type BashToolDetails,
-  type EditToolDetails,
   type ReadToolDetails,
 } from "@earendil-works/pi-coding-agent";
 import { Text } from "@earendil-works/pi-tui";
 import { zh } from "./zh.ts";
 import {
   countResultRender,
-  errorFirstLine,
   notePartial,
   shellRenders,
   withExpanded,
 } from "./tool-renders.ts";
 
+/** write 工具折叠态预览的行数（与内置 write 渲染器一致）。 */
+const WRITE_PREVIEW_LINES = 10;
+
 /**
  * 重注册所有内置工具的中文渲染。
  *
@@ -118,38 +122,7 @@ export function registerLocalizedTools(pi: ExtensionAPI, cwd: string) {
       return new Text(text, 0, 0);
     },
 
-    renderResult(
-      result: any,
-      { expanded, isPartial }: { expanded: boolean; isPartial: boolean },
-      theme: any,
-    ) {
-      if (isPartial) return notePartial(zh.tools.edit.editing, theme);
-
-      const err = errorFirstLine(result, theme);
-      if (err) return err;
-
-      const details = result.details as EditToolDetails | undefined;
-      if (!details?.diff) {
-        return new Text(theme.fg("success", zh.tools.edit.applied), 0, 0);
-      }
-
-      let additions = 0,
-        removals = 0;
-      for (const line of details.diff.split("\n")) {
-        if (line.startsWith("+") && !line.startsWith("+++")) additions++;
-        if (line.startsWith("-") && !line.startsWith("---")) removals++;
-      }
-
-      let text = theme.fg("success", zh.tools.edit.additions(additions));
-      text += theme.fg("dim", " / ");
-      text += theme.fg("error", zh.tools.edit.removals(removals));
-
-      return new Text(
-        withExpanded(expanded ? details.diff : "", text, theme),
-        0,
-        0,
-      );
-    },
+    // 不覆盖 renderResult：沿用内置渲染器（行号 + 红绿 + 词级高亮的 diff）。
   });
 
   // write
@@ -157,20 +130,38 @@ export function registerLocalizedTools(pi: ExtensionAPI, cwd: string) {
     ...createWriteTool(cwd),
     label: zh.tools.write.label,
 
-    renderCall(args: any, theme: any) {
+    renderCall(args: any, theme: any, context: any) {
+      const rawLines = String(args.content ?? "")
+        .replace(/\r/g, "")
+        .replace(/\t/g, "   ")
+        .split("\n");
+      let end = rawLines.length;
+      while (end > 0 && rawLines[end - 1] === "") end--;
+
       let text = theme.fg("toolTitle", theme.bold(zh.tools.write.title));
       text += theme.fg("accent", args.path);
-      const lineCount = String(args.content).split("\n").length;
-      text += theme.fg("dim", ` (${zh.tools.write.lines(lineCount)})`);
+      text += theme.fg("dim", ` (${zh.tools.write.lines(end)})`);
+
+      if (end > 0) {
+        const maxLines = context.expanded ? end : WRITE_PREVIEW_LINES;
+        const lang = args.path ? getLanguageFromPath(args.path) : undefined;
+        // ponytail: 只高亮预览到的行，大文件折叠态不跑全量高亮；跨行语法
+        // （块注释等）在预览边界可能染色偏移，需要精确时改全量高亮 + 增量缓存
+        // （上游 write.js 的做法）。
+        text += `\n\n${highlightCode(rawLines.slice(0, maxLines).join("\n"), lang).join("\n")}`;
+        if (end > maxLines) {
+          text += theme.fg(
+            "muted",
+            `\n${zh.tools.write.moreLines(end - maxLines, end)}`,
+          );
+          text += keyHint("app.tools.expand", zh.tools.write.expand);
+          text += theme.fg("muted", "）");
+        }
+      }
       return new Text(text, 0, 0);
     },
 
-    renderResult(result: any, { isPartial }: { isPartial: boolean }, theme: any) {
-      if (isPartial) return notePartial(zh.tools.write.writing, theme);
-      const err = errorFirstLine(result, theme);
-      if (err) return err;
-      return new Text(theme.fg("success", zh.tools.write.written), 0, 0);
-    },
+    // 不覆盖 renderResult：沿用内置渲染器（成功时不追加内容，出错时显示完整错误）。
   });
 
   // grep / find / ls：调用渲染各自略有差异，结果渲染走同一个计数模板。

package/extensions/tool-renders.ts

@@ -22,15 +22,6 @@ export const countNonEmpty = (s: string): number =>
 export const notePartial = (msg: string, theme: any): Text =>
   new Text(theme.fg("warning", msg), 0, 0);
 
-// 错误结果：内容以 "Error" 开头时只展示首行（edit/write 共用）。
-/** 展示错误首行（红色）；结果不是错误时返回 undefined。 */
-export const errorFirstLine = (result: any, theme: any): Text | undefined => {
-  const out = textOf(result);
-  return out.startsWith("Error")
-    ? new Text(theme.fg("error", out.split("\n")[0]), 0, 0)
-    : undefined;
-};
-
 // 展开态：在摘要后追加逐行弱化的原始输出。
 /**
  * 组装展开态文本：raw 为空时返回 summary，否则在 summary 之后

package/extensions/zh.ts

@@ -95,6 +95,9 @@ export const zh = {
       writing: "写入中…",
       written: "已写入",
       lines: (n: number) => `${n} 行`,
+      moreLines: (remaining: number, total: number) =>
+        `…（还有 ${remaining} 行，共 ${total} 行，`,
+      expand: "展开",
     },
     grep: {
       label: "搜索内容",

package/package.json

@@ -1,12 +1,16 @@
 {
   "name": "pi-zh-cn",
-  "version": "0.2.2",
+  "version": "0.2.4",
   "description": "pi 编码代理的简体中文界面汉化插件",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/GoetheDady/pi-zh-cn.git"
   },
+  "license": "MIT",
   "type": "module",
+  "scripts": {
+    "test": "tsc -p . && node --test \"test/*.test.ts\""
+  },
   "keywords": [
     "pi-package",
     "i18n",