configure-pi-extensions-i18n skillA
configure-pi-extensions-i18n is agent-read markdown (skill) from maplezzk/pi-extensions: 配置 Pi 扩展共享语言并排查 locale 优先级、持久化设置和 catalog。Use when changing zh-CN/en-US/auto language behavior..
Indexed from public GitHub and served as immutable, content-addressed versions. Install it pinned to an exact SHA-256 with the mdr CLI, and every file is verified against the hash recorded here before it reaches your agent. The deterministic audit below grades the latest version, and the same file always earns the same grade.
What the file says
# 配置 pi-extensions-i18n
## 修改语言
优先使用 `/config:language zh-CN|en-US|auto`；不带参数时使用交互界面。设置持久化到实际 Pi agent 目录的 `extensions/pi-extensions-i18n/config.json`。
语言优先级：
1. `PI_EXTENSIONS_LOCALE`；
2. 持久化配置；
3. 默认 `zh-CN`。
`auto` 根据 `LC_ALL`、`LC_MESSAGES`、`LANG` 选择中文或英文。`/pi-language` 只是兼容别名。
## 验证
执行语言命令后观察下一个使用共享 i18n 的扩展文案。若环境变量存在，它会覆盖持久化值；必须先报告这个覆盖关系，不能反复改 JSON。修改 catalog 时，每个 key 必须同时有 `zh-CN` 与 `en-US`，缺失翻译应作为加载错误修复，不能静默 fallback。
## 统一提示出口
功能包的用户可见提示必须走 `notifyWithSource`（而不是直接 `ctx.ui.notify`），否则 Pi 会把 `info` 级提示渲染成暗灰无前缀的一行文字，用户既分不清来源也不容易注意到：
```ts
notifyWithSource({ ctx, source: NOTICE_SOURCE, level: "warning", message: i18n.t("failed") });
```
- 呈现：TUI 下画成会话区里的带底色消息块（落在消息下方，不进 LLM 上下文）；rpc/print/json 仍走 `ctx.ui.notify` 的纯文本。
- 细节：`details` 默认收起、只占一行，行尾带展开箭头（收起 `▶` / 展开 `▼`，强调色）；全屏模式下直接点这条提示块切换，常规模式用 `Ctrl+O`（`MouseRegion` 不可用时自动退化成只能键盘展开）。没有 `details` 的提示不带箭头，不会指一个点了没反应的入口。**不要在这里写「Ctrl+O 展开」**：条目渲染器拿不到 Pi 的 `tuiMode`，全屏与常规模式区分不出来，而箭头在两种模式下都成立。
- 标签：每个包用短的唯一 tag；标签颜色统一用 `NOTICE_TAG_COLOR`（弱化色），来源靠 tag 文本区分，不靠颜色。颜色只在 tui 模式添加（自动处理，不要自己在调用点拼 ANSI）。
…Read the whole file at its exact version.
How to install
mdr add maplezzk/pi-extensions/configure-pi-extensions-i18n@git:20260919.b3f1f59mdr add maplezzk/pi-extensions/configure-pi-extensions-i18n@sha256:fedd5282a526de11Pin to a label to follow the author's releases, or to a sha256 to freeze the exact bytes forever. Either way the resolved hash is written to mdr.lock, and mdr install reproduces it on any machine.
[](https://markdownregistry.com/a/art_gzcffil3nkqtsdvc)
1 badge views in 30 days
Versions
| version | committed | commit | size | audit | |
|---|---|---|---|---|---|
| git:20260919.b3f1f59 latest | 2026-09-19 | b3f1f59 | 2,746 B | A | view · diff |
| git:20260919.6d00e4b | 2026-09-19 | 6d00e4b | 2,660 B | A | view · diff |
| git:20260915.cdfe6e9 | 2026-09-15 | cdfe6e9 | 2,348 B | A | view · diff |
| git:20260914.eb00293 | 2026-09-14 | eb00293 | 2,150 B | A | view · diff |
| git:20260913.a06c6f8 | 2026-09-13 | a06c6f8 | 1,536 B | A | view |
Audit of the latest version
- pass: Frontmatter block present
- pass: Frontmatter declares a name
- pass: Frontmatter declares a description
- pass: Size between 200 bytes and 200 KB (2746 bytes)
- pass: No zero-width or bidi control characters
- pass: No instruction hidden inside an HTML comment
- pass: No link to an exfiltration or paste host
- pass: No credential-shaped string
- pass: No instruction to send local credentials anywhere
- pass: No text hidden with inline styles
- pass: No prompt-injection phrasing
- pass: No curl or wget piped into a shell
- pass: No recursive delete of root, home or parent
- pass: No instruction to read or print local credentials
- pass: No base64 blob over 200 characters
- pass: No link to a raw IP address
- pass: No script tag
Source
maplezzk/pi-extensions · 12 stars · license MIT · pushed 2026-09-22 · branch main
API
GET https://markdownregistry.com/api/v1/artifacts/art_gzcffil3nkqtsdvc GET https://markdownregistry.com/api/v1/resolve?ref=maplezzk/pi-extensions/configure-pi-extensions-i18n GET https://markdownregistry.com/api/v1/blob/fedd5282a526de11b71c2b48d6b1d5157ce5139d0782ec43bfd6e20b7f3477e4
Your agent does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.