Home / maplezzk / pi-extensions · packages/pi-distill/SKILL.md · GitHub

configure-pi-distill skillA

configure-pi-distill is agent-read markdown (skill) from maplezzk/pi-extensions: 配置与排查 pi-distill 的模型、压缩阈值、重试、工具开关和审计卡片。Use when configuring pi-distill or diagnosing output distillation..

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-distill

## 诊断

1. 定位实际 Pi agent 目录;默认是 `~/.pi/agent`,设置 `PI_CODING_AGENT_DIR` 时使用该目录。
2. 读取 `extensions/pi-distill/config.json`;不存在时从包内 `config.example.json` 建立,不猜字段。
3. 同时检查 `PI_DISTILL_*` 和旧 `PI_BASH_SUMMARY_*` 环境变量。JSON 配置优先;环境变量中同名的新 `PI_DISTILL_*` 优先于旧 `PI_BASH_SUMMARY_*`。

## 修改

优先让用户在 Pi 中运行 `/config:distill`;`/pi-distill` 只是兼容别名。手工配置时只使用包内 `config.example.json` 已声明的字段:

- `model` 留空时使用当前会话模型,否则必须是可用的 `provider/model`;
- `minChars` 控制何时提炼,`maxChars` 与 `maxOutputChars` 控制大结果落盘和返回上限;
- `timeoutRetryCount`、`errorRetryCount` 是额外重试次数;
- `summarizeErrors` 默认 `true`,控制达到 `minChars` 的错误结果是否提炼;环境变量依次为 `PI_DISTILL_SUMMARIZE_ERRORS`、旧 `PI_BASH_SUMMARY_SUMMARIZE_ERRORS`;
- `tools.<name>.enabled` 控制单个工具;`edit`、`write` 默认关闭,其他未配置工具默认开启;
- `render` 只控制展示,不改变提炼语义。

不要把需要完整原文的调用配置成摘要;调用方应传 `outputRequest: "RAW"`。不要为非文本结果启用文本提炼假设。

## 验证

- 用 `/distill:stats` 查看当前会话成功、失败、回退、压缩率和模型消耗。
- 对达到 `minChars` 的文本工具结果观察提炼;再用 `RAW` 确认完整性路径。
- 当前会话无可用模型或模型调用失败时,必须报告原始结果被保留的 fail-open 行为,不能宣称提炼成功。

Read the whole file at its exact version.

How to install

Latest version
mdr add maplezzk/pi-extensions/configure-pi-distill@git:20260820.57a9863
Exact content
mdr add maplezzk/pi-extensions/configure-pi-distill@sha256:4eb95e318fb49c96

Pin 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.

Badge

mdr badge

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

1 badge views in 30 days

Versions

versioncommittedcommitsizeaudit
git:20260820.57a9863 latest2026-08-20 57a9863 1,930 BA view

Audit of the latest version

A  17 of 17 checks passed. Deterministic, no model, 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 (1930 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 · 12 stars · license MIT · pushed 2026-09-22 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_mtdnx6ucrxviypod
GET https://markdownregistry.com/api/v1/resolve?ref=maplezzk/pi-extensions/configure-pi-distill
GET https://markdownregistry.com/api/v1/blob/4eb95e318fb49c96338a67f317c62591844e7446907b34cc9a9df8f5f08bea0c

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.

More from maplezzk/pi-extensions

AGENTS.md agents
maplezzk/pi-extensions · AGENTS.md
git:20260922.961f354 · audit A · 12 stars
configure-pi-auto-goal 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 · 12 stars
configure-pi-clean-mode 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:20260922.73feb1a · audit A · 12 stars
configure-pi-dynamic-workflows skill
maplezzk/pi-extensions · packages/pi-dynamic-workflows/SKILL.md · 配置与排查 pi-dynamic-workflows 的执行后端和异步模式。Use when configuring workflow backend, async mode, or subagent integration.
git:20260820.57a9863 · audit A · 12 stars
configure-pi-extensions-i18n skill
maplezzk/pi-extensions · packages/pi-extensions-i18n/SKILL.md · 配置 Pi 扩展共享语言并排查 locale 优先级、持久化设置和 catalog。Use when changing zh-CN/en-US/auto language behavior.
git:20260919.b3f1f59 · audit A · 12 stars
configure-pi-extensions-tool-display 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 · 12 stars
configure-pi-interactive-subagents 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 · 12 stars
configure-pi-metrics skill
maplezzk/pi-extensions · packages/pi-metrics/SKILL.md · 启用与排查 pi-metrics 的耗时、TPS、TTFT、token 和成本遥测。Use when configuring or diagnosing Pi session metrics.
git:20260920.81cdf04 · audit A · 12 stars
configure-pi-models-discovery skill
maplezzk/pi-extensions · packages/pi-models-discovery/SKILL.md · 配置与排查 models.json 的动态模型发现、缓存刷新、鉴权和离线回退。Use when adding discoverModels providers or refreshing model catalogs.
git:20260920.5241ae4 · audit A · 12 stars
configure-pi-naming skill
maplezzk/pi-extensions · packages/pi-naming/SKILL.md · 配置 Pi 统一 /rename、首条消息命名和终端目标归属。Use when configuring pi-naming.
git:20260914.d76b5b5 · audit A · 12 stars
configure-pi-nested-skills skill
maplezzk/pi-extensions · packages/pi-nested-skills/SKILL.md · 配置与排查 pi-nested-skills 的技能根目录、递归发现、别名调用和补全。Use when configuring nested skill roots, aliases, discovery, or completion.
git:20260907.3bd68af · audit A · 12 stars
configure-pi-notifications skill
maplezzk/pi-extensions · packages/pi-notifications/SKILL.md · 配置与排查 pi-notifications 的外部通知命令、argv 参数、超时和一次性失败提示。Use when configuring or diagnosing Pi external notifications.
git:20260907.3bd68af · audit A · 12 stars

Every file in maplezzk/pi-extensions

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