pi-prompt

Pi 的输出精简插件：少说废话，省真金白银。

一句话：把「每次回复都啰嗦一大段、输出 token 悄悄烧钱」的痛，换成「三条正交轴随手调，auto 档按你的真实价格自动选最省钱的那一档」。

---

为什么需要它

输出 token 单价远高于输入（DeepSeek 输出 4~8 元/百万 vs 输入 miss 1 元/百万）， 而多数回复里的寒暄、复述、铺垫都可以不要。pi-prompt 用一段字节稳定的追加 提示，让模型按你选的力度输出——不改变模型能力，只砍掉冗余表达。

---

开箱你能得到什么

• 三条正交轴，随手调
  • show：输出风格力度（normal / lite / full / ultra / auto）
  • write：代码写量（minimal / normal / complete）
  • do：行为力度（direct / normal / deep）
• auto 档：按成本自动选。用成本函数 净收益 = µ × 缩减率 × 输出价 − 注入成本 × 输入价 选最优档， 并随校准样本自动收敛；小任务倾向不注入，大任务才上强度。
• 价格交给你自己管。auto 与成本估算都读 pi-pricer 的共享价表 （~/.pi/model-pricing.json）——包括你自定义的峰谷、促销、节假日规则。 没装 pi-pricer 也能用（回退内置近似价，并会提示你装）。
• 渐进式自进化校准。只采自然样本，零额外花费；想要更快收敛可主动跑 /prompt check --calibrate（3 轮不注入的对照探针）。
• 台账与自检。/prompt usage 给你按天×模型聚合 + 会话明细的 token/金额表， 并标注节省估算；/prompt check 看台账完整性、校准状态与当前价格来源。
• 对比面板。/prompt compare 回答"插件到底省了多少"——分估算（基于先验缩减率） 与实测（不注入对照样本）两轨展示，各自标注口径，不让假设听起来像事实。
• 恒定注入语义 + 换档迟滞。注入文案按档位编号、字节稳定，且三轴各自成块 （调 write/do 不动 show 块字节）；auto 换档带迟滞——新档优势须扣掉"换档的 缓存失效成本"后仍更优才换，避免为省一点输出费而丢掉整段前缀缓存。

---

快速开始（30 秒）

# 1. 安装
pi extension add @foolsecret/pi-prompt

# 2. （推荐）安装 pi-pricer 并维护你的真实价格
pi extension add @foolsecret/pi-pricer
/price                      # 打开价格面板，改成你实际付费的价

# 3. 打开三轴设置抽屉
/prompt config              # 设置抽屉（4 分类钻取；Ctrl+S 保存 · Ctrl+R 丢弃）
/prompt                     # 显示帮助

# 4. 看看花了多少、省了多少
/prompt usage

---

命令速查

命令	干嘛的
/prompt	无参 = 全局开关（关停/恢复注入）
/prompt config	设置抽屉：根层 4 分类（提示词/工具/上下文/其他）钻取；Ctrl+S 保存 / Ctrl+R 丢弃，未保存时显示 ● 未保存改动
/prompt（无参）	显示帮助
/prompt status	当前三轴状态
/prompt usage	token/金额台账（按天×模型 + 会话明细 + 节省估算）
/prompt compare	对比注入 vs 不注入的成本（估算 + 实测双轨）
/prompt check	自检：台账完整性 / 校准状态 / 价格来源；--calibrate 跑探针
/prompt-review	调用 prompt-review 技能审计上一条回复的冗余

状态栏恒常显示 PROMPT <show> · <write> · <do>，show=auto 显示本轮实际解析档。

---

配置

配置文件 ~/.pi/pi-prompt.json：

{
  "defaultShow": "auto",
  "defaultWrite": "normal",
  "defaultDo": "normal",
  "peakUpgrade": true,
  "maxTokensCap": null,
  "autoSample": false,
  "hysteresis": 0.5,
  "autoCompact": false,
  "autoCompactMaxTokens": 400000,
  "autoCompactPercent": 0.6,
  "autoCompactMinTurns": 50,
  "compactInstructions": "摘要时请额外保留：当前正在进行的任务、已完成到哪一步、下一步计划、未解决的阻塞。不要只总结历史对话，要保留工作状态。",
  "toolOutput": {
    "enabled": false,
    "grep": 8192,
    "read": 16384,
    "bash": 8192,
    "default": 8192
  }
}

环境变量（优先级高于配置）：PI_PROMPT_SHOW / PI_PROMPT_WRITE / PI_PROMPT_DO / PI_PROMPT_PEAK / PI_PROMPT_MAX_TOKENS / PI_PROMPT_AUTO_SAMPLE / PI_PROMPT_HYSTERESIS / PI_PROMPT_AUTO_COMPACT / PI_PROMPT_AUTO_COMPACT_MAX_TOKENS / PI_PROMPT_AUTO_COMPACT_PERCENT / PI_PROMPT_AUTO_COMPACT_MIN_TURNS / PI_PROMPT_TOOL_OUTPUT / PI_PROMPT_TOOL_CAP_GREP / PI_PROMPT_TOOL_CAP_READ / PI_PROMPT_TOOL_CAP_BASH / PI_PROMPT_TOOL_CAP_DEFAULT / PI_PROMPT_COMPACT_INSTRUCTIONS。

以上配置项均可在 /prompt config 抽屉里修改（根层 4 分类钻取： 提示词 / 工具 / 上下文 / 其他），无需手改 JSON。

关于 autoCompact（默认关）：pi 自带的压缩阈值是「窗口 − 16K」，在 1M 窗口 模型上 ≈ 98 万，实际很难触发，上下文会一直涨。本插件可在更早触发压缩， 但压缩本身有代价（整段重算一次），而缓存读很便宜——算下来只有长会话才划算， 所以默认关闭，仅在「超阈值 + 会话已够长 + 成本确划算」三重条件同时满足时才会压。

关于 toolOutput（默认关）：pi 已把工具输出截到 50KB；本项提供更激进的 分层上限（grep/bash 8K、read 16K），在工具结果创建时截断一次（不改历史， 缓存友好）。它能省的是每轮重发的缓存读：以你的真实模型单价（deepseek-v4-pro hit=0.15、glm-5.3-flash hit=0.23）估算，8K 上限可省 15~25% 总成本；但会改变 模型看到的内容，故默认关。

历史数据兼容：旧档名 off 读取时自动归一为 normal，不影响既有台账。

---

价格来源

pi-prompt 自己不维护价表。成本估算与 auto 选档都从 pi-pricer 取价：

情况	行为
装了 pi-pricer	用你在 ~/.pi/model-pricing.json 配的真实价格与峰谷规则
没装	回退内置近似价（会在首次 /prompt usage 提示你安装）
装了但解析失败	回退兜底价，并在 /prompt check 给出失败原因

所以想让账目对得上、让 auto 判断准，推荐同时装 @foolsecret/pi-pricer。

---

扩展开发者接入

import { resolvePricing } from "@foolsecret/pi-pricer/pricing";

pi-prompt 自身是 @foolsecret/pi-pricer 的可选 peer 依赖： 未安装时功能完整（回退内置兜底价），不会因缺依赖而加载失败。

---

License

AGPL-3.0-only。详见 LICENSE。