configure-pi-extensions-i18n SKILL.md skillA

configure-pi-extensions-i18n from maplezzk/pi-extensions is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add maplezzk/pi-extensions/configure-pi-extensions-i18n@git:20260922.c7d696c

Pins git:20260922.c7d696c in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
maplezzk/pi-extensions
Path
packages/pi-extensions-i18n/SKILL.md
Versions recorded
6
Latest version
git:20260922.c7d696c, committed Sep 22, 2026
First version recorded
Sep 13, 2026
Size
2,830 bytes
Repository stars
20
License
MIT

配置 Pi 扩展共享语言并排查 locale 优先级、持久化设置和 catalog。Use when changing zh-CN/en-US/auto language behavior.

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# 配置 pi-extensions-i18n

## 修改语言

优先使用 `/config:language zh-CN|en-US|auto`;不带参数时打开 TUI 配置面板(Pi 自带 SettingsList),回车从列表选择,选定立即写盘生效。设置持久化到实际 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

The exact contents, by fingerprint
mdr add maplezzk/pi-extensions/configure-pi-extensions-i18n@sha256:d78ad25afffbba50

The line at the top of this page pins the label git:20260922.c7d696c, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_gzcffil3nkqtsdvc.svg)](https://markdownregistry.com/a/art_gzcffil3nkqtsdvc)

6 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 6 versions of this file, between Sep 13, 2026 and Sep 22, 2026, about one every 2 days.

versioncommittedcommitsizeaudit
git:20260922.c7d696c latest2026-09-22 c7d696c 2,830 BA view · diff
git:20260919.b3f1f592026-09-19 b3f1f59 2,746 BA view · diff
git:20260919.6d00e4b2026-09-19 6d00e4b 2,660 BA view · diff
git:20260915.cdfe6e92026-09-15 cdfe6e9 2,348 BA view · diff
git:20260914.eb002932026-09-14 eb00293 2,150 BA view · diff
git:20260913.a06c6f82026-09-13 a06c6f8 1,536 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (2830 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

GitHub

maplezzk/pi-extensions · 20 stars · license MIT · pushed 2026-11-06 · 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/d78ad25afffbba507c6ef5a7fbfb0731daf543b7a42610836c15e58dedc95546

Your AI assistant 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.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from maplezzk/pi-extensions

AGENTS.md AGENTS.md file
maplezzk/pi-extensions · AGENTS.md
git:20260922.1612473 · audit A · 20 stars
configure-pi-auto-goal SKILL.md skill
maplezzk/pi-extensions · packages/pi-auto-goal/SKILL.md · 配置与排查 pi-auto-goal 的提前停止判定、判定模型、干预上限与催促文案。Use when configuring or diagnosing premature-stop judgement.
git:20260922.a62090b · audit A · 20 stars
configure-pi-clean-mode SKILL.md skill
maplezzk/pi-extensions · packages/pi-clean-mode/SKILL.md · 配置与排查 pi-clean-mode 的配置面板、折叠单位、耗时头、自动展开与快捷键。Use when configuring clean mode, opening its settings panel, or diagnosing…
git:20261006.3c36c0d · audit A · 20 stars
configure-pi-distill SKILL.md skill
maplezzk/pi-extensions · packages/pi-distill/SKILL.md · 配置与排查 pi-distill 的模型、压缩阈值、重试、工具开关和审计卡片。Use when configuring pi-distill or diagnosing output distillation.
git:20261007.3cd5266 · audit A · 20 stars
configure-pi-dynamic-workflows SKILL.md skill
maplezzk/pi-extensions · packages/pi-dynamic-workflows/SKILL.md · 配置与排查 pi-dynamic-workflows 的执行后端和异步模式。Use when configuring workflow backend, async mode, or subagent integration.
git:20260922.07de307 · audit A · 20 stars
configure-pi-extensions-tool-display SKILL.md skill
maplezzk/pi-extensions · packages/pi-extensions-tool-display/SKILL.md · 配置与排查 Pi 工具展示宿主、内建/自定义工具 override、输出模式和 diff 视图。Use when changing pi-extensions-tool-display rendering.
git:20260820.57a9863 · audit A · 20 stars
configure-pi-gen-ui SKILL.md skill
maplezzk/pi-extensions · packages/pi-gen-ui/SKILL.md · 配置与排查 pi-gen-ui 的面板渲染、交互面板、结果行数上限与 Jev 组合。Use when configuring json-render panels or diagnosing render_ui/compose_ui.
git:20261005.f7aef84 · audit A · 20 stars
configure-pi-interactive-subagents SKILL.md skill
maplezzk/pi-extensions · packages/pi-interactive-subagents/SKILL.md · 配置与排查 interactive subagents 的终端复用器、Herdr split/tab 和状态面板。Use when configuring subagent mux behavior.
git:20260918.137b800 · audit A · 20 stars
configure-pi-metrics SKILL.md skill
maplezzk/pi-extensions · packages/pi-metrics/SKILL.md · 启用与排查 pi-metrics 的耗时、TPS、TTFT、token 和成本遥测。Use when configuring or diagnosing Pi session metrics.
git:20260922.07de307 · audit A · 20 stars
configure-pi-models-discovery SKILL.md skill
maplezzk/pi-extensions · packages/pi-models-discovery/SKILL.md · 配置与排查 models.json 的动态模型发现、缓存刷新、鉴权和离线回退。Use when adding discoverModels providers or refreshing model catalogs.
git:20261106.4058f39 · audit A · 20 stars
configure-pi-naming SKILL.md skill
maplezzk/pi-extensions · packages/pi-naming/SKILL.md · 配置 Pi 统一 /rename、首条消息命名和终端目标归属。Use when configuring pi-naming.
git:20261017.d758347 · audit A · 20 stars
configure-pi-nested-skills SKILL.md skill
maplezzk/pi-extensions · packages/pi-nested-skills/SKILL.md · 配置与排查 pi-nested-skills 的技能根目录、递归发现、别名调用和补全。Use when configuring nested skill roots, aliases, discovery, or completion.
git:20260922.e07845b · audit A · 20 stars

Every file in maplezzk/pi-extensions

Browse by kind, by grade A, or by owner.