pi-zh-cn 0.2.1 → 0.2.3
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/LICENSE +21 -0
- package/README.md +55 -15
- package/package.json +9 -1
package/LICENSE
ADDED
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
MIT License
|
|
2
|
+
|
|
3
|
+
Copyright (c) 2026 GoetheDady
|
|
4
|
+
|
|
5
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
+
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
+
in the Software without restriction, including without limitation the rights
|
|
8
|
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
+
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
+
furnished to do so, subject to the following conditions:
|
|
11
|
+
|
|
12
|
+
The above copyright notice and this permission notice shall be included in all
|
|
13
|
+
copies or substantial portions of the Software.
|
|
14
|
+
|
|
15
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
21
|
+
SOFTWARE.
|
package/README.md
CHANGED
|
@@ -1,40 +1,57 @@
|
|
|
1
1
|
# pi-zh-cn
|
|
2
2
|
|
|
3
|
+
[](https://www.npmjs.com/package/pi-zh-cn)
|
|
4
|
+
[](LICENSE)
|
|
5
|
+
|
|
3
6
|
把 [pi](https://github.com/earendil-works/pi) 编码代理的界面变成简体中文。装上重启即可，不想要了随时卸载。
|
|
4
7
|
|
|
5
|
-
|
|
8
|
+
## 特性
|
|
9
|
+
|
|
10
|
+
- **零侵入**：只是普通扩展，调用官方扩展 API 替换文案，不打补丁、不改安装目录里的任何文件，pi 正常升级后一般也能直接用
|
|
11
|
+
- **不改模型输入**：发给模型的内容保持不变，工具 description 保留英文原文，避免影响模型行为
|
|
12
|
+
- **按需开启**：`grep`、`find`、`ls` 或 `powershell` 没开就不会被偷偷打开
|
|
13
|
+
- **键位跟随**：快捷键提示跟随你自己的键位配置
|
|
6
14
|
|
|
7
|
-
##
|
|
15
|
+
## 汉化范围
|
|
8
16
|
|
|
9
|
-
-
|
|
17
|
+
- 启动画面：标题、快捷键提示、引导语
|
|
10
18
|
- 底部状态栏：当前目录 / 分支 / 会话名、token 与缓存用量、费用、上下文占比、模型和思考等级
|
|
11
19
|
- 加载提示：「正在处理…」；thinking 折叠块的标签
|
|
12
20
|
- 八个内置工具的执行结果：读取、执行（bash）、编辑、写入、搜索内容、查找文件、列出目录、PowerShell——状态行都是中文，比如「完成」「退出码 N」「输出过长已截断」
|
|
13
21
|
- 项目信任弹窗：信任/不信任选择，含「信任父文件夹」变体
|
|
22
|
+
- 内置斜杠命令描述：core 全部 23 个命令
|
|
14
23
|
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
## 保持原样的部分
|
|
18
|
-
|
|
19
|
-
- 内置菜单和其他硬编码在 pi 源码里的英文（扩展 API 够不到，除非 fork 上游重编译，不值得）
|
|
20
|
-
- 工具的启用范围：`grep`、`find`、`ls` 或 `powershell` 没开就不会被这个插件偷偷打开
|
|
21
|
-
|
|
22
|
-
## 使用
|
|
24
|
+
## 安装
|
|
23
25
|
|
|
24
26
|
```bash
|
|
25
|
-
# 从 npm 安装
|
|
26
27
|
pi install npm:pi-zh-cn
|
|
28
|
+
```
|
|
29
|
+
|
|
30
|
+
重启 pi 即生效。查看已安装的包：
|
|
27
31
|
|
|
28
|
-
|
|
32
|
+
```bash
|
|
29
33
|
pi list
|
|
30
34
|
```
|
|
31
35
|
|
|
32
|
-
|
|
36
|
+
### 卸载
|
|
37
|
+
|
|
38
|
+
```bash
|
|
39
|
+
pi remove npm:pi-zh-cn
|
|
40
|
+
```
|
|
41
|
+
|
|
42
|
+
### 临时切回英文
|
|
43
|
+
|
|
44
|
+
觉得中文状态栏不如原生好读，可以在会话里执行：
|
|
33
45
|
|
|
34
46
|
```text
|
|
35
47
|
/footer
|
|
36
48
|
```
|
|
37
49
|
|
|
50
|
+
## 已知局限
|
|
51
|
+
|
|
52
|
+
- 内置菜单和其他硬编码在 pi 源码里的英文保持原样——扩展 API 够不到，除非 fork 上游重编译，不值得
|
|
53
|
+
- 实验性的全屏模式（`tuiMode: "fullscreen"`）文案写死在 pi-tui 里，同样够不到，例如 pi 0.85.0 新增的 `↓ Jump to latest message · <键位>`，以及搜索框的 `Find in transcript` / `No matches`
|
|
54
|
+
|
|
38
55
|
## 开发
|
|
39
56
|
|
|
40
57
|
```bash
|
|
@@ -47,4 +64,27 @@ pi --no-session -e ./extensions/index.ts -p "hi"
|
|
|
47
64
|
|
|
48
65
|
所有文案都集中在 [`extensions/zh.ts`](extensions/zh.ts)，想改词只动这一个文件就够了。
|
|
49
66
|
|
|
50
|
-
|
|
67
|
+
### 上游兼容性测试（契约测试）
|
|
68
|
+
|
|
69
|
+
汉化依赖 pi 内部结构（footer 统计行、工具 details 字段、trust.json 语义、
|
|
70
|
+
斜杠命令清单等），上游一变就可能静默失效。`test/` 下的契约测试把这些
|
|
71
|
+
依赖点逐条断言：实际执行内置工具、实例化 `ProjectTrustStore`、探查内置
|
|
72
|
+
footer 的 dist 源码，任一结构变化都会失败并指明该核对哪个文案。
|
|
73
|
+
|
|
74
|
+
```bash
|
|
75
|
+
npm test # tsc 类型检查 + 全部测试
|
|
76
|
+
```
|
|
77
|
+
|
|
78
|
+
CI 在每次 push/PR 时运行，并每两天定时跑一次「上游金丝雀」：因为 peer
|
|
79
|
+
依赖是 `*`，定时任务会拉到最新版 pi，上游发布后两天内即可自动暴露兼容
|
|
80
|
+
性问题，不用等用户反馈。
|
|
81
|
+
|
|
82
|
+
## 反馈
|
|
83
|
+
|
|
84
|
+
pi 大版本升级后如果出现错位或残留英文，欢迎[提 issue](https://github.com/GoetheDady/pi-zh-cn/issues)。
|
|
85
|
+
|
|
86
|
+
改动记录见 [CHANGELOG.md](CHANGELOG.md)。
|
|
87
|
+
|
|
88
|
+
## License
|
|
89
|
+
|
|
90
|
+
[MIT](LICENSE)
|
package/package.json
CHANGED
|
@@ -1,8 +1,16 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "pi-zh-cn",
|
|
3
|
-
"version": "0.2.
|
|
3
|
+
"version": "0.2.3",
|
|
4
4
|
"description": "pi 编码代理的简体中文界面汉化插件",
|
|
5
|
+
"repository": {
|
|
6
|
+
"type": "git",
|
|
7
|
+
"url": "git+https://github.com/GoetheDady/pi-zh-cn.git"
|
|
8
|
+
},
|
|
9
|
+
"license": "MIT",
|
|
5
10
|
"type": "module",
|
|
11
|
+
"scripts": {
|
|
12
|
+
"test": "tsc -p . && node --test \"test/*.test.ts\""
|
|
13
|
+
},
|
|
6
14
|
"keywords": [
|
|
7
15
|
"pi-package",
|
|
8
16
|
"i18n",
|