# @astrosheep/pi-context 中文文档

规范地址：https://npmcn.com/package/%40astrosheep/pi-context/

版本：0\.38\.0
npm 元数据更新时间：2026-10-10T14:20:59.237Z
中文译文更新时间：2026-11-07T01:44:26.152Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40astrosheep/pi-context
原文对照：https://npmcn.com/package/%40astrosheep/pi-context/?lang=original
项目主页：https://github.com/astrosheep-zero/pi-context#readme
源码仓库：https://github.com/astrosheep-zero/pi-context

弃用说明：Renamed to notesoup\. Install notesoup instead\.

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：1.5 MB，226 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：0 个
- peer 依赖：typebox \*，@earendil-works/pi-ai \*，@earendil-works/pi-agent-core \*，@earendil-works/pi-coding-agent \*
- 首次发布：2026-09-14T03:47:22.324Z
- 最新版本发布：2026-10-10T09:01:32.469Z
- 近 30 天下载量：2096（2026-10-07 至 2026-11-05，npm 官方下载统计）
- 已发布版本数：60（近 12 个月 60 个）

## 中文简介

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

## 安装

```sh
npm install @astrosheep/pi-context
```

也可以使用：`pnpm add @astrosheep/pi-context`、`yarn add @astrosheep/pi-context`、`bun add @astrosheep/pi-context`

## README

# pi 语句

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

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

## 为什么不只是收缩?

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

## 安装

```sh
pi install npm:@astrosheep/pi-context
```

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

```sh
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_windows` | `history_windows` |
| `history.list_items` | `history_list` |
| `history.read_item` | `history_read` |
| `history.search_contents` | `history_search` |
| `notes.write` | `notes_write` |
| `notes.update` | `notes_update` |
| `notes.rename` | `notes_update` (单位:千美元)`rename_to`(中文(简体) ) |
| `notes.read` | `notes_read` |
| `notes.list` | `notes_list` |
| `notes.search` | `notes_search` |

-   **切换运行时间** —— 说 `/pi-context off` 停止新的自动重装; `/pi-context on` 使他们复活 `/pi-context` 报告情况.

## 配置

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

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

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

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

## 文档

-   [建筑](https://npmcn.com/package/%40astrosheep/pi-context/docs/architecture.md) 财务报告和审定财务报表 [重设生命周期](https://npmcn.com/package/%40astrosheep/pi-context/docs/reset-lifecycle.md) - 窗口、检查站、标志和分支的实际运作情况
-   [工具结果](https://npmcn.com/package/%40astrosheep/pi-context/docs/tool-results.md) ——收件,寻呼和出错形状
-   [独立笔记库](https://npmcn.com/package/%40astrosheep/pi-context/docs/notes-library.md) 使用节点的笔记存储器,不需要 Pi
-   [SDK 整合](https://npmcn.com/package/%40astrosheep/pi-context/docs/sdk-integration.md) ——将pi-context绑定在主机构建的会话上
-   [Claude 代码模式](https://npmcn.com/package/%40astrosheep/pi-context/docs/claude-code-mod.md) – Claude Code 的早期访问笔记工具
-   [技能、梦想和笔记医生](https://npmcn.com/package/%40astrosheep/pi-context/docs/skills.md) —— 说 `/skill:memory`, (中文(简体) ), `/skill:dream`, (中文(简体) ), `dream doctor`梦想锁

## 发展

```sh
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` 从来没有被触动。 见 [捐款额](https://npmcn.com/package/%40astrosheep/pi-context/CONTRIBUTING.md) 所有权和核查规则.

## 许可证

麻省理工学院

## 常见问题

### @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。作者已将其标记为弃用，新项目建议寻找替代方案。