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