configure-pi-session-tools skillA
configure-pi-session-tools is agent-read markdown (skill) from maplezzk/pi-extensions: 配置与排查 session squash 提醒阈值、强制压缩比例和 bash 管道缓存。Use when configuring pi-session-tools context management..
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-session-tools ## 诊断 读取实际 Pi agent 目录下的 `extensions/pi-session-tools/config.json`，并检查 `PI_SESSION_TOOLS_SQUASH_THRESHOLDS`。配置字段： - `squashContextThresholds`：数字、`150k` 或 `75%` 可混合； - `forceSquashContextThreshold`：`0` 到 `1` 的 JSON 数字，`null` 表示关闭。 环境变量只配置提醒阈值，不配置强制比例。 ## 修改 优先使用 `/config:session-tools`；`/pi-session-tools` 是兼容别名。强制模式使用 `/config:session-tools force 0.9`，关闭使用 `force off`。不要给强制比例写 `"90%"` 字符串。 提醒阈值只在正常停止且跨过阈值时提示。强制阈值达到后只开放 `session_log` 与 `session_squash`，直到压缩成功；不要绕过或静默关闭。 ## 验证 - 配置后回读 JSON，确认类型和值未被归一化成意外形式。 - 压缩时先调用 `session_log`，再把完整任务状态快照直接传给 `session_squash`；没有独立 finalize 步骤。summary 支持自由格式，不会因缺少标题、章节或 `User`/`Agent` 时间线而拒绝压缩；如需便于接手，可按 handoff 结构组织。若未提供标题或时间线，扩展会自动补齐一份标题或紧凑事实时间线；自动时间线只保留 User 与 Agent 文本，不记录工具调用或工具结果。任务或阶段到达安全停点即可压缩，无需等整个任务结束。已作为压缩起点保留的 user anchor 会继续返回；若上次快照后、下一条 user turn 前产生了自动续接内容，应复用该锚点重新压缩。用户纠正优先于 Agent 推断；未证实内容标记 `INFERRED`、`UNKNOWN`、`NOT VERIFIED` 或 `BLOCKED`；不要记录压缩、阈值或会话切换过程，也不要让已完成工作再次进入下一步。每次压缩都必须显式选择接续模式：仍有可立即执行的工作时设置 `continuation: "auto"`；任务已完成或 Resume 依赖用户尚未确认的信息时设置 `continuation: "next-user"`。持久化层仍使用 `custom_message` 以保留 UI 和 `/tree` 能力，但下一轮模型上下文会把它呈现为原生 compaction summary；接手 Agent 必须把它当作当前任务状态交接，而不是新的用户需求。快照消息在 UI… …
Read the whole file at its exact version.
How to install
mdr add maplezzk/pi-extensions/configure-pi-session-tools@git:20260919.5782c68mdr add maplezzk/pi-extensions/configure-pi-session-tools@sha256:1570daa90c87fb5fPin 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_gqhljcsye5afnrcp)
1 badge views in 30 days
Versions
| version | committed | commit | size | audit | |
|---|---|---|---|---|---|
| git:20260919.5782c68 latest | 2026-09-19 | 5782c68 | 3,261 B | A | view · diff |
| git:20260918.fcf36bd | 2026-09-18 | fcf36bd | 2,817 B | A | view · diff |
| git:20260903.d38bd4d | 2026-09-03 | d38bd4d | 2,623 B | A | view · diff |
| git:20260901.489ae8f | 2026-09-01 | 489ae8f | 2,535 B | A | view · diff |
| git:20260827.14362f2 | 2026-08-27 | 14362f2 | 2,884 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 (3261 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_gqhljcsye5afnrcp GET https://markdownregistry.com/api/v1/resolve?ref=maplezzk/pi-extensions/configure-pi-session-tools GET https://markdownregistry.com/api/v1/blob/1570daa90c87fb5f4e58f0a9734f7ac5a35a4ee5f723bdfa458ab1566ac2a7e1
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.