@liwu1995/afu-context 0.1.4 → 0.1.5
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md
CHANGED
|
@@ -20,24 +20,24 @@ Install and sign in to your host first. You need npm, Node.js **22.19+ (22.x) or
|
|
|
20
20
|
|
|
21
21
|
| Host | System | Install | Launch after installation |
|
|
22
22
|
| --- | --- | --- | --- |
|
|
23
|
-
| <a id="afu-claude"></a>Claude Code | macOS / Linux | `npx --yes --registry=https://registry.npmjs.org @liwu1995/afu-context@0.1.
|
|
24
|
-
| Claude Code | Windows 10/11¹ | `npx.cmd --yes --registry=https://registry.npmjs.org "@liwu1995/afu-context@0.1.
|
|
25
|
-
| <a id="afu-codex"></a>Codex CLI | macOS / Linux | `npx --yes --registry=https://registry.npmjs.org @liwu1995/afu-context@0.1.
|
|
26
|
-
| <a id="afu-pi"></a>Pi | macOS / Linux | `npx --yes --registry=https://registry.npmjs.org @liwu1995/afu-context@0.1.
|
|
27
|
-
| <a id="afu-dsh"></a>DSH | macOS / Linux | `npx --yes --registry=https://registry.npmjs.org @liwu1995/afu-context@0.1.
|
|
23
|
+
| <a id="afu-claude"></a>Claude Code | macOS / Linux | `npx --yes --registry=https://registry.npmjs.org @liwu1995/afu-context@0.1.5 install claude` | `claude` |
|
|
24
|
+
| Claude Code | Windows 10/11¹ | `npx.cmd --yes --registry=https://registry.npmjs.org "@liwu1995/afu-context@0.1.5" install claude` | `claude` |
|
|
25
|
+
| <a id="afu-codex"></a>Codex CLI | macOS / Linux | `npx --yes --registry=https://registry.npmjs.org @liwu1995/afu-context@0.1.5 install codex` | `codex` |
|
|
26
|
+
| <a id="afu-pi"></a>Pi | macOS / Linux | `npx --yes --registry=https://registry.npmjs.org @liwu1995/afu-context@0.1.5 install pi` | `pi` |
|
|
27
|
+
| <a id="afu-dsh"></a>DSH | macOS / Linux | `npx --yes --registry=https://registry.npmjs.org @liwu1995/afu-context@0.1.5 install dsh --profile YOUR_PROFILE` | `dsh --profile YOUR_PROFILE` |
|
|
28
28
|
|
|
29
|
-
Supported systems are macOS on Apple Silicon (ARM64) and Linux x64. The first `afu` command sets up a private Python environment from your Python 3.11+, which takes about half a minute. On macOS, Claude Code and Codex were tested end to end with real models (install, chat with compaction, upgrade, remove, launchd autostart). On Linux, Claude Code was tested with a real model and Codex with a local fixture; user-systemd autostart was not tested. Start a new session for Claude Code or Codex. Pi loads the extension in new sessions. Replace `YOUR_PROFILE` with the DSH profile to integrate, such as `headless` or `web`. For web, you can also launch with `dsh web`. To remove just one profile, run `npx --yes --registry=https://registry.npmjs.org @liwu1995/afu-context@0.1.
|
|
29
|
+
Supported systems are macOS on Apple Silicon (ARM64) and Linux x64. The first `afu` command sets up a private Python environment from your Python 3.11+, which takes about half a minute. On macOS, Claude Code and Codex were tested end to end with real models (install, chat with compaction, upgrade, remove, launchd autostart). On Linux, Claude Code was tested with a real model and Codex with a local fixture; user-systemd autostart was not tested. Start a new session for Claude Code or Codex. Pi loads the extension in new sessions. Replace `YOUR_PROFILE` with the DSH profile to integrate, such as `headless` or `web`. For web, you can also launch with `dsh web`. To remove just one profile, run `npx --yes --registry=https://registry.npmjs.org @liwu1995/afu-context@0.1.5 remove dsh --profile YOUR_PROFILE`.
|
|
30
30
|
|
|
31
31
|
¹ On Windows, use PowerShell, Python **3.11+** and a Claude Code version with PowerShell hook support. Native Claude Code is implemented and awaits Windows testing. Native Codex is unsupported, and Pi and DSH are unverified on Windows.
|
|
32
32
|
|
|
33
|
-
The commands pin **0.1.
|
|
33
|
+
The commands pin **0.1.5** from the public npm registry so installation does not depend on a mirror carrying the latest release. Use 0.1.5 or later; earlier versions lack the fixes in this release. If npm reports `with a date before`, check `before` and `min-release-age`. This version was published at **PUBLISH_TIME_UTC**. Retry after a rolling cooldown expires. For a fixed cutoff, the effective policy must allow that publication date.
|
|
34
34
|
|
|
35
35
|
<details>
|
|
36
36
|
<summary>Startup after reboot and Pi / DSH launch options</summary>
|
|
37
37
|
|
|
38
38
|
Claude Code and Codex start the AFU gateway from their session hooks, so it comes back with the first session after a reboot. Installation also registers a login service when the system allows it. If system policy refuses it (for example an endpoint-security rule on `~/Library/LaunchAgents`, or Linux without user systemd), installation continues and prints a notice; no reinstall is needed after reboot. Codex runs only hooks you have trusted: open `codex` once after installing and trust the AFU hooks when asked.
|
|
39
39
|
|
|
40
|
-
For Pi **0.84.4**, pass `--provider` and `--model` on the Pi command line. DSH was tested with **0.1.2-rc.1** and Cordis **4.0.2**. If a web profile reports an incompatible HMR API, run `npx --yes --registry=https://registry.npmjs.org @liwu1995/afu-context@0.1.
|
|
40
|
+
For Pi **0.84.4**, pass `--provider` and `--model` on the Pi command line. DSH was tested with **0.1.2-rc.1** and Cordis **4.0.2**. If a web profile reports an incompatible HMR API, run `npx --yes --registry=https://registry.npmjs.org @liwu1995/afu-context@0.1.5 dsh --web-compat -- --profile web`.
|
|
41
41
|
|
|
42
42
|
</details>
|
|
43
43
|
|
|
@@ -72,18 +72,28 @@ In a LongBench V2 replay of 39 history questions (20 agent histories and 19 dial
|
|
|
72
72
|
|
|
73
73
|
## Web dashboard
|
|
74
74
|
|
|
75
|
-
|
|
75
|
+
The quickest way to open the dashboard:
|
|
76
|
+
|
|
77
|
+
| Where | Type |
|
|
78
|
+
| --- | --- |
|
|
79
|
+
| In a Claude Code session | `/afu:ui` |
|
|
80
|
+
| In a Codex session | `$afu-ui` |
|
|
81
|
+
| In a terminal | `afu` |
|
|
82
|
+
|
|
83
|
+
The dashboard runs in the background and does not occupy a terminal; opening it again reuses the same one, and it exits after 30 minutes without an open page. The terminal `afu` command is placed in `~/.local/bin` by the installer (only when that folder is already on `PATH`; shell startup files are never edited) and is removed with the last integration.
|
|
84
|
+
|
|
85
|
+
To check compaction for the current session, type `/afu:status` in Claude Code, `$afu-status` in Codex, or run `afu status` in a terminal. It shows whether AFU is connected, the current context against the compaction threshold, and how many compactions have been applied. The in-session commands are added on install and removed on removal.
|
|
76
86
|
|
|
77
87
|
From a terminal, check the integration status, then open the dashboard and select your session. For another host, replace `codex` with `claude`, `pi` or `dsh`; `--brief` prints the same short lines as the slash commands.
|
|
78
88
|
|
|
79
89
|
```sh
|
|
80
|
-
npx --yes --registry=https://registry.npmjs.org @liwu1995/afu-context@0.1.
|
|
81
|
-
npx --yes --registry=https://registry.npmjs.org @liwu1995/afu-context@0.1.
|
|
90
|
+
npx --yes --registry=https://registry.npmjs.org @liwu1995/afu-context@0.1.5 status codex --brief
|
|
91
|
+
npx --yes --registry=https://registry.npmjs.org @liwu1995/afu-context@0.1.5 ui
|
|
82
92
|
```
|
|
83
93
|
|
|
84
94
|
The dashboard distinguishes **request observed → summary ready → summary applied**. For Claude Code and Codex, application requires a complete successful response to a request carrying the summary. For Pi and DSH it means the host committed the summary to session history. The dashboard also shows summary duration and provider-reported cache usage.
|
|
85
95
|
|
|
86
|
-
**Overview** shows what AFU saved you:
|
|
96
|
+
**Overview** shows what AFU saved you: tokens saved and how many compactions took effect, followed by your sessions and the state of their latest compaction. Open a **session** to see the context drop after each compaction, how long each one took and what it saved, plus cache hit rates. Integrations, versions and issues live on the **Status** page. The dashboard supports light/dark themes and English/Chinese.
|
|
87
97
|
|
|
88
98
|
## Models and thresholds
|
|
89
99
|
|
|
@@ -95,21 +105,21 @@ All four integrations reuse the conversation’s model and authentication. The d
|
|
|
95
105
|
For a Codex model with a known 200,000-token window, the first command sets a 30% trigger. The second restores automatic settings.
|
|
96
106
|
|
|
97
107
|
```sh
|
|
98
|
-
npx --yes --registry=https://registry.npmjs.org @liwu1995/afu-context@0.1.
|
|
99
|
-
npx --yes --registry=https://registry.npmjs.org @liwu1995/afu-context@0.1.
|
|
108
|
+
npx --yes --registry=https://registry.npmjs.org @liwu1995/afu-context@0.1.5 install codex --context-window 200000 --ratio 0.3
|
|
109
|
+
npx --yes --registry=https://registry.npmjs.org @liwu1995/afu-context@0.1.5 install codex --context-window auto --ratio auto
|
|
100
110
|
```
|
|
101
111
|
|
|
102
112
|
</details>
|
|
103
113
|
|
|
104
|
-
For frequent use, run `npm install -g --registry=https://registry.npmjs.org @liwu1995/afu-context@0.1.
|
|
114
|
+
For frequent use, run `npm install -g --registry=https://registry.npmjs.org @liwu1995/afu-context@0.1.5` and use `afu` in place of the full `npx` invocation. For example, `afu ui` opens the dashboard, and `afu ui --prices ./afu-prices.json` uses your price file to estimate costs.
|
|
105
115
|
|
|
106
116
|
## Upgrade and remove
|
|
107
117
|
|
|
108
118
|
After upgrading a Claude Code or Codex integration, start a new session to use the new gateway. To uninstall, remove the host integration first, then restart the host. Use the appropriate command below.
|
|
109
119
|
|
|
110
120
|
```sh
|
|
111
|
-
npx --yes --registry=https://registry.npmjs.org @liwu1995/afu-context@0.1.
|
|
112
|
-
npx --yes --registry=https://registry.npmjs.org @liwu1995/afu-context@0.1.
|
|
121
|
+
npx --yes --registry=https://registry.npmjs.org @liwu1995/afu-context@0.1.5 upgrade codex
|
|
122
|
+
npx --yes --registry=https://registry.npmjs.org @liwu1995/afu-context@0.1.5 remove codex
|
|
113
123
|
```
|
|
114
124
|
|
|
115
125
|
Use `remove pi` or `remove dsh` for those integrations. In Windows PowerShell, use `npx.cmd` and double-quote the package name.
|
package/README.zh-CN.md
CHANGED
|
@@ -20,24 +20,24 @@
|
|
|
20
20
|
|
|
21
21
|
| 宿主 | 系统 | 一键安装 | 安装后启动 |
|
|
22
22
|
| --- | --- | --- | --- |
|
|
23
|
-
| <a id="afu-claude"></a>Claude Code | macOS / Linux | `npx --yes --registry=https://registry.npmjs.org @liwu1995/afu-context@0.1.
|
|
24
|
-
| Claude Code | Windows 10/11¹ | `npx.cmd --yes --registry=https://registry.npmjs.org "@liwu1995/afu-context@0.1.
|
|
25
|
-
| <a id="afu-codex"></a>Codex CLI | macOS / Linux | `npx --yes --registry=https://registry.npmjs.org @liwu1995/afu-context@0.1.
|
|
26
|
-
| <a id="afu-pi"></a>Pi | macOS / Linux | `npx --yes --registry=https://registry.npmjs.org @liwu1995/afu-context@0.1.
|
|
27
|
-
| <a id="afu-dsh"></a>DSH | macOS / Linux | `npx --yes --registry=https://registry.npmjs.org @liwu1995/afu-context@0.1.
|
|
23
|
+
| <a id="afu-claude"></a>Claude Code | macOS / Linux | `npx --yes --registry=https://registry.npmjs.org @liwu1995/afu-context@0.1.5 install claude` | `claude` |
|
|
24
|
+
| Claude Code | Windows 10/11¹ | `npx.cmd --yes --registry=https://registry.npmjs.org "@liwu1995/afu-context@0.1.5" install claude` | `claude` |
|
|
25
|
+
| <a id="afu-codex"></a>Codex CLI | macOS / Linux | `npx --yes --registry=https://registry.npmjs.org @liwu1995/afu-context@0.1.5 install codex` | `codex` |
|
|
26
|
+
| <a id="afu-pi"></a>Pi | macOS / Linux | `npx --yes --registry=https://registry.npmjs.org @liwu1995/afu-context@0.1.5 install pi` | `pi` |
|
|
27
|
+
| <a id="afu-dsh"></a>DSH | macOS / Linux | `npx --yes --registry=https://registry.npmjs.org @liwu1995/afu-context@0.1.5 install dsh --profile YOUR_PROFILE` | `dsh --profile YOUR_PROFILE` |
|
|
28
28
|
|
|
29
|
-
支持 Apple Silicon（ARM64）的 macOS 和 x64 Linux。首次执行 `afu` 会用本机 Python 3.11+ 创建专用运行环境，约半分钟。macOS 上 Claude Code 和 Codex 已用真实模型完成端到端验证（安装、对话压缩、升级、移除、launchd 自启）；Linux 上 Claude Code 用真实模型验证，Codex 用本地模拟服务验证，用户级 systemd 自启尚未验证。Claude Code 和 Codex 安装后新开会话。Pi 扩展在新开的会话自动加载。将 DSH 的 `YOUR_PROFILE` 换成要接入的 profile，例如 `headless` 或 `web`。选择 web 后也可以用 `dsh web` 启动。仅移除某个 profile 时运行 `npx --yes --registry=https://registry.npmjs.org @liwu1995/afu-context@0.1.
|
|
29
|
+
支持 Apple Silicon（ARM64）的 macOS 和 x64 Linux。首次执行 `afu` 会用本机 Python 3.11+ 创建专用运行环境，约半分钟。macOS 上 Claude Code 和 Codex 已用真实模型完成端到端验证（安装、对话压缩、升级、移除、launchd 自启）；Linux 上 Claude Code 用真实模型验证，Codex 用本地模拟服务验证，用户级 systemd 自启尚未验证。Claude Code 和 Codex 安装后新开会话。Pi 扩展在新开的会话自动加载。将 DSH 的 `YOUR_PROFILE` 换成要接入的 profile，例如 `headless` 或 `web`。选择 web 后也可以用 `dsh web` 启动。仅移除某个 profile 时运行 `npx --yes --registry=https://registry.npmjs.org @liwu1995/afu-context@0.1.5 remove dsh --profile YOUR_PROFILE`。
|
|
30
30
|
|
|
31
31
|
¹ Windows 使用 PowerShell，需本机 Python **3.11+** 和支持 PowerShell Hook 的 Claude Code。Windows 原生 Claude Code 已实现，待实机验收。Codex 未支持，Pi 和 DSH 未验收。
|
|
32
32
|
|
|
33
|
-
安装命令固定使用公网 npm 上的 **0.1.
|
|
33
|
+
安装命令固定使用公网 npm 上的 **0.1.5**，避免镜像尚未同步最新版本。请使用 0.1.5 或更新版本；更早的版本不含本版修复。如果报错含 `with a date before`，请核对 npm 的 `before` 或 `min-release-age`。此版本发布于 **PUBLISH_TIME_UTC**。若使用滚动冷却期，等该版本满足期限后重试；若设置了固定截止日期，需使用允许安装该版本的策略。
|
|
34
34
|
|
|
35
35
|
<details>
|
|
36
36
|
<summary>重启后的启动方式与 Pi / DSH 启动参数</summary>
|
|
37
37
|
|
|
38
38
|
Claude Code 和 Codex 会在会话启动时通过 hook 拉起 AFU 网关，重启电脑后打开第一个会话即可恢复。系统允许时，安装还会注册开机自启；若被系统策略拒绝（例如终端安全软件禁止写入 `~/Library/LaunchAgents`，或 Linux 没有用户级 systemd），安装会继续并给出提示，重启后无需重新安装。Codex 只执行你信任过的 hook：安装后打开一次 `codex`，在提示中信任 AFU 的 hook。
|
|
39
39
|
|
|
40
|
-
Pi **0.84.4** 可直接传 `--provider` 和 `--model`。DSH 已适配 **0.1.2-rc.1** 和 Cordis **4.0.2**。若 Web profile 提示 HMR API 不兼容，可使用 `npx --yes --registry=https://registry.npmjs.org @liwu1995/afu-context@0.1.
|
|
40
|
+
Pi **0.84.4** 可直接传 `--provider` 和 `--model`。DSH 已适配 **0.1.2-rc.1** 和 Cordis **4.0.2**。若 Web profile 提示 HMR API 不兼容，可使用 `npx --yes --registry=https://registry.npmjs.org @liwu1995/afu-context@0.1.5 dsh --web-compat -- --profile web`。
|
|
41
41
|
|
|
42
42
|
</details>
|
|
43
43
|
|
|
@@ -72,18 +72,28 @@ Pi **0.84.4** 可直接传 `--provider` 和 `--model`。DSH 已适配 **0.1.2-rc
|
|
|
72
72
|
|
|
73
73
|
## Web 面板：查看压缩是否生效
|
|
74
74
|
|
|
75
|
-
|
|
75
|
+
打开面板最简单的方式：
|
|
76
76
|
|
|
77
|
-
|
|
77
|
+
| 在哪里 | 输入 |
|
|
78
|
+
| --- | --- |
|
|
79
|
+
| Claude Code 会话里 | `/afu:ui` |
|
|
80
|
+
| Codex 会话里 | `$afu-ui` |
|
|
81
|
+
| 终端里 | `afu` |
|
|
82
|
+
|
|
83
|
+
面板在后台运行，不占用终端；再次打开会复用同一个面板，30 分钟没有页面打开时自动退出。终端里的 `afu` 命令由安装程序放在 `~/.local/bin`（已在 `PATH` 中时才放，不修改 shell 配置），移除最后一个接入时一并删除。
|
|
84
|
+
|
|
85
|
+
查看当前会话的压缩情况：Claude Code 输入 `/afu:status`，Codex 输入 `$afu-status`，终端里运行 `afu status`。可以看到 AFU 是否已接入、当前上下文距离压缩触发线还有多少，以及已经生效的压缩次数。会话里的命令随安装添加、随移除删除。
|
|
86
|
+
|
|
87
|
+
没有 `afu` 命令时（例如 `~/.local/bin` 不在 `PATH` 中），可以用完整的 npx 命令。以 Codex 为例，其它宿主将 `codex` 换成 `claude`、`pi` 或 `dsh`：
|
|
78
88
|
|
|
79
89
|
```sh
|
|
80
|
-
npx --yes --registry=https://registry.npmjs.org @liwu1995/afu-context@0.1.
|
|
81
|
-
npx --yes --registry=https://registry.npmjs.org @liwu1995/afu-context@0.1.
|
|
90
|
+
npx --yes --registry=https://registry.npmjs.org @liwu1995/afu-context@0.1.5 status codex --brief
|
|
91
|
+
npx --yes --registry=https://registry.npmjs.org @liwu1995/afu-context@0.1.5 ui
|
|
82
92
|
```
|
|
83
93
|
|
|
84
94
|
面板分别记录**请求已接入 → 摘要已生成 → 摘要已应用**。Claude Code 和 Codex 的应用回执表示替换历史后的请求已收到完整成功响应。Pi 和 DSH 的回执表示宿主已把摘要写入会话历史。面板也展示摘要耗时和模型返回的缓存用量。
|
|
85
95
|
|
|
86
|
-
**总览**先告诉你 AFU 帮你省了多少：节省的 token
|
|
96
|
+
**总览**先告诉你 AFU 帮你省了多少：节省的 token 和生效的压缩次数，下方列出每个会话及其最近一次压缩的状态。点进一个**会话**，可以看到上下文在每次压缩后回落、每次压缩的耗时和节省量，以及缓存命中率。接入情况、版本和异常记录在**运行状态**页查看。面板支持亮色/暗色主题和中英文。
|
|
87
97
|
|
|
88
98
|
## 模型与压缩阈值
|
|
89
99
|
|
|
@@ -95,21 +105,21 @@ npx --yes --registry=https://registry.npmjs.org @liwu1995/afu-context@0.1.3 ui
|
|
|
95
105
|
下面以已知窗口为 200,000 tokens 的 Codex 模型为例。第一条将触发比例设为 30%，第二条恢复自动设置。
|
|
96
106
|
|
|
97
107
|
```sh
|
|
98
|
-
npx --yes --registry=https://registry.npmjs.org @liwu1995/afu-context@0.1.
|
|
99
|
-
npx --yes --registry=https://registry.npmjs.org @liwu1995/afu-context@0.1.
|
|
108
|
+
npx --yes --registry=https://registry.npmjs.org @liwu1995/afu-context@0.1.5 install codex --context-window 200000 --ratio 0.3
|
|
109
|
+
npx --yes --registry=https://registry.npmjs.org @liwu1995/afu-context@0.1.5 install codex --context-window auto --ratio auto
|
|
100
110
|
```
|
|
101
111
|
|
|
102
112
|
</details>
|
|
103
113
|
|
|
104
|
-
如果经常使用 AFU，可运行 `npm install -g --registry=https://registry.npmjs.org @liwu1995/afu-context@0.1.
|
|
114
|
+
如果经常使用 AFU，可运行 `npm install -g --registry=https://registry.npmjs.org @liwu1995/afu-context@0.1.5`，以后用 `afu` 代替完整的 `npx` 命令。例如，`afu ui` 打开面板，`afu ui --prices ./afu-prices.json` 使用自己的单价文件估算费用。
|
|
105
115
|
|
|
106
116
|
## 升级与移除
|
|
107
117
|
|
|
108
118
|
升级 Claude Code 或 Codex 接入后，新开会话即可使用新版网关。需要移除时，先撤销对应宿主的接入，再重启宿主。以下两条命令分别用于升级和移除。
|
|
109
119
|
|
|
110
120
|
```sh
|
|
111
|
-
npx --yes --registry=https://registry.npmjs.org @liwu1995/afu-context@0.1.
|
|
112
|
-
npx --yes --registry=https://registry.npmjs.org @liwu1995/afu-context@0.1.
|
|
121
|
+
npx --yes --registry=https://registry.npmjs.org @liwu1995/afu-context@0.1.5 upgrade codex
|
|
122
|
+
npx --yes --registry=https://registry.npmjs.org @liwu1995/afu-context@0.1.5 remove codex
|
|
113
123
|
```
|
|
114
124
|
|
|
115
125
|
Pi 和 DSH 可分别用 `remove pi` 或 `remove dsh` 撤销。Windows PowerShell 请使用 `npx.cmd` 并将包名放在双引号中。
|
package/package.json
CHANGED
package/python/{afu_context_local-0.1.4-py3-none-any.whl → afu_context_local-0.1.5-py3-none-any.whl}
RENAMED
|
Binary file
|
package/release.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
|
-
"version": "0.1.
|
|
3
|
-
"build": "
|
|
4
|
-
"wheel": "afu_context_local-0.1.
|
|
2
|
+
"version": "0.1.5",
|
|
3
|
+
"build": "9211426113913a6035cb91ef91d2bdb420342298b4994abf214dbfd0fd1ed521",
|
|
4
|
+
"wheel": "afu_context_local-0.1.5-py3-none-any.whl",
|
|
5
5
|
"prebuilt": false
|
|
6
6
|
}
|