pi-tool-i18n

Pi extension — auto-translate all tool descriptions to your locale via LLM

Packages

Package details

extension

Install pi-tool-i18n from npm and Pi will load the resources declared by the package manifest.

npm repohome report
$ pi install npm:pi-tool-i18n
Package
pi-tool-i18n
Version
4.0.0
Published
May 30, 2026
Downloads
not available
Author
soul_of_arcane
License
MIT
Types
extension
Size
14.4 KB
Dependencies
0 dependencies · 0 peers
Pi manifest JSON
{
  "extensions": [
    "./tool-i18n.ts"
  ]
}

Security note

Pi packages can execute code and influence agent behavior. Review the source before installing third-party packages.

README

pi-tool-i18n

Pi extension — 将工具描述、参数描述和技能描述翻译为系统语言，让 LLM 用目标语言思考。

运行机制

V4（当前版本）：文件落盘

session_start: 加载 cache → 扫描缺失 → 写入 i18n-pending.json
before_agent_start: 如果有 pending 文件 → 注入指令让 LLM read→翻译→write
message_end: 读取文件合并到 cache → 删除 pending → notify 进度

LLM 用 read + write 工具直接操作文件，不受回复截断限制，JSON 解析失败率为零。

替换位置 事件 键名格式
工具描述 before_provider_request → tools[].function.description toolname
参数描述 before_provider_request → parameters.properties.*.description param:tool:param
技能描述 before_agent_start → 系统提示词 XML skill:name

文件结构

~/.pi/agent/
├── tool-i18n.json          # 翻译缓存（573 条）
└── i18n-pending.json       # 待翻译条目（翻译完成后自动删除）

安装

pi install npm:pi-tool-i18n

命令

命令 说明
/i18n-status 查看已缓存 / 未翻译数量
/i18n-translate 手动生成 pending 文件并触发翻译
/i18n-clear 清除缓存，下次自动全量重翻

首次使用

安装后发第一条消息 → LLM 自动读取 pending 文件 → 翻译 → 写回 → 缓存完成。之后永远不再触发 I18N 请求。

新增工具后 /reload → 自动增量翻译（只有新增的 2-3 条）。

License

MIT