@astrosheep/pi-context

中文文档
0.38.0发布于 2026/10/10MITTypeScriptES Module零依赖近 30 天下载 2096

用于 Pi 的 Codex 风格上下文窗口:可持久地重置窗口,会话历史工具,以及持久音符.

此软件包已被标记为弃用

Renamed to notesoup. Install notesoup instead.

中文使用文档
文档目录7 节
  1. 为什么不只是收缩?
  2. 安装
  3. 你得到的东西
  4. 配置
  5. 文档
  6. 发展
  7. 许可证

pi 语句

你经纪人的记忆被擦去 当上下文填满。 Pi-context使这能幸存:代理在被擦出前自己写出检查站,在一扇新窗户中醒来,从旧话中挖出它仍然需要的东西. 对你来说,它大多是隐形的——偶尔通知, /clear-memory 要强制一个新的窗口, /pi-context 切换.

建筑——耐用上下文窗口,模型作者笔记,可搜索历史——是Codex's的OpenAI原型之一 context_management 实验和关闭 10天后,因为它焊接到他们的后端。 pi-context是完全运行在您的机器上的同一个架构,只建在 Pi'公用扩展API. 没有后端,没有订阅门,没有服务器可以在最糟糕的时刻提供404. 它不能从远处关闭,因为没有远处.

为什么不只是收缩?

  • 重置QQ摘要. 收缩是您所坐等的压缩损失——下一篇总结摘要. 一个 pi- context 重置摘要 无:窗口在O(1)中关闭,因为无论什么重要事项,都事先写成注解. 因为没有东西可以计算,所以速度快;因为原始历史从不离开磁盘,所以安全.
  • 注释是您可以打开的文件 . 普通马克倒入 ~/.agents/notes,在命名的家庭(@project, (中文(简体) ), @human, (中文(简体) ), @self, (中文(简体) ), @model,加上每会). 可读可编辑可取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取 这不是一个加密的blob—— 也不是一个秘密 模型被指示要瞒着你。 (是的,这是一个真正的指示。) 不,我们没有移植它。 )
  • 历史永不忘怀. 每个已关闭的窗口——消息、工具呼叫、工具输出——仍可通过 history_* 工具。 说明是代理人损失指数;历史是下面的无损失记录. 这是一半的原实验从未运出.

安装

pi install npm:@astrosheep/pi-context

或把它装入一个引用器,而不安装:

pi -e npm:@astrosheep/pi-context

你得到的东西

  • 持久上下文窗口. /clear-memory (别名) /cm清除并停止; /cm Continue reviewing the implementation 清除和继续。 该模型也可以请求窗口本身与 clear_memory,在窗口关闭前自动关闭。 中止和普通错误永远不会算作补全;原始对讲会话停留在会话中,只是脱离了下个上下文.
  • 每个窗口头都有一个靴子挡住. 静态的每窗内容(cache-stable),有窗口身份,近代音符索引,以及一个短协议,教导模型如何恢复: 用于自己记账的笔记,重置前一切的历史工具.
  • get_context_remaining ——现场倒计时至收尾线,使代理机在开出前能看见悬崖.
  • 9个历史/笔记工具,从最初的 Codex 动作中平出:
代码动作Pi 工具
history.list_windowshistory_windows
history.list_itemshistory_list
history.read_itemhistory_read
history.search_contentshistory_search
notes.writenotes_write
notes.updatenotes_update
notes.renamenotes_update (单位:千美元)rename_to(中文(简体) )
notes.readnotes_read
notes.listnotes_list
notes.searchnotes_search
  • 切换运行时间 —— 说 /pi-context off 停止新的自动重装; /pi-context on 使他们复活 /pi-context 报告情况.

配置

提醒阈值是 Pi 的收缩储备加比值, 配置在顶层 pi-context 键入 ~/.pi/agent/settings.json 或者说 <cwd>/.pi/settings.json (项目值为每个密钥胜出):

{
  "compaction": { "reserveTokens": 16384 },
  "pi-context": { "reminderMarginTokens": 24576 }
}

梦想者模型配置在同一键下; --dreamer <model pattern> 编辑 dream CLI 赢了,然后是非空的 pi-context.dreamer 字符串,然后自动模型:

{
  "pi-context": { "reminderMarginTokens": 24576, "dreamer": "anthropic/claude-sonnet-4-5" }
}

文档

发展

npm test            # build from a clean dist, then run the suite
npm run typecheck
git diff --check
node scripts/check-notes-package.mjs  # optional built /notes CRUD smoke; no install

绳子对着真正的安装了的Pi SessionManager编号 :SettingsManager 在临时目录中有假证书——没有模型或网络呼叫,以及真实的 ~/.pi 从来没有被触动。 见 捐款额 所有权和核查规则.

许可证

麻省理工学院

版本与发布记录

@astrosheep/pi-context 共发布 60 个版本,首次发布于 2026/09/14;过去 12 个月发布了 60 个版本。

版本发布日期距今
0.38.0latest2026/10/1028 天前
0.37.12026/10/0929 天前
0.37.02026/10/0929 天前
0.35.62026/10/0830 天前
0.35.52026/10/0830 天前
0.35.42026/10/0830 天前

关于 @astrosheep/pi-context 的常见问题

@astrosheep/pi-context 是什么?

用于 Pi 的 Codex 风格上下文窗口:可持久地重置窗口,会话历史工具,以及持久音符.注意:该包已被作者标记为弃用——Renamed to notesoup. Install notesoup instead.

如何安装 @astrosheep/pi-context?

在项目目录运行 npm install @astrosheep/pi-context,或使用 pnpm add / yarn add / bun add。它还提供命令行工具 dream,可以用 npx dream 直接运行。

@astrosheep/pi-context 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@astrosheep/pi-context 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@astrosheep/pi-context 可以商用吗?

@astrosheep/pi-context 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@astrosheep/pi-context 的下载量有多少?

根据 npm 官方下载统计,@astrosheep/pi-context 在 2026/10/07 – 2026/11/05 这 30 天内被下载 2,096 次,日均约 70 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@astrosheep/pi-context 还在维护吗?

最新版本 0.38.0 发布于 2026/10/10(28 天前);至今共发布 60 个版本,其中过去 12 个月发布了 60 个;首次发布于 2026/09/14。作者已将其标记为弃用,新项目建议寻找替代方案。