首页科技看点 LightRSI：AI Agent 工具实践指南

LightRSI：AI Agent 工具实践指南

2026-09-30 0

如果把LightRSI放进候选清单，不能只看热度；它的定位是[EMNLP 2026] LightRSI 是一个模块化运行时，用于在长范围 LLM 代理中轻松部署递归自我改进循环。对部署与运行环境任务来说，权限、依赖和环境差异会放大维护成本往往决定它能否落地，不能只用安装成功来判断。先在非生产环境复现一次安装与运行更稳妥；过程中要观察依赖锁定、权限边界、日志、回滚和资源消耗，失败也应能解释原因。整体来看，它适合愿意维护环境并重视故障恢复的工程团队拿来做对照测试，最终决定仍应回到真实结果和维护状态。

zjunlp/LightRSI 项目截图 1

用于递归改进长期运行的 LLM 代理的模块化运行时

产品

上下文清理器

Context Cleaner 可用，跨主机具有相同的计划、批准、状态和取消模型。在Codex中，/lightrsi-clean打开主机渲染任务选择器；直接终端等效为 lightrsi codex clean。在您确认选择之前，分析是只读的，并且无法选择受保护的任务。

论文

LightRSI 将可重用的改进功能与共享运行时基础架构和特定于主机的集成分开。 TokenPilot 是第一个预设。

论文	它的作用	它是如何运作的	效果
`TokenPilot`	使长时间运行的代理会话更小、更便宜且更容易维持	稳定可重用的提示前缀，在过大的工具输出损坏之前对其进行修剪，并限制随着会话增长而保留的旧上下文量	更好的缓存重用、更低的令牌使用、更低的成本以及更少的共享会话中的上下文膨胀

新闻

[2026-09-16]： Context Cleaner，我们的第一款产品，现已上市，TokenPilot 现在支持 DeepSeek Harness。
[2026-08-21]： TokenPilot：LLM 代理的缓存高效上下文管理 已被 EMNLP 接受2026！
[2026-06-28]: TokenPilot 现在支持 Codex 和 Claude Code。演示视频：视频平台 · 哔哩哔哩
[2026-06-16]： TokenPilot：LLM 代理 的缓存高效上下文管理已发布。

安装

1. 准备一次存储库

克隆存储库并构建共享包：

git clone https://github.com/zjunlp/LightRSI.git
cd LightRSI
corepack enable
pnpm install

下面的特定于主机的 Cleaner 安装程序构建共享 CLI，恢复 MCP，并在安装之前选择适配器。一个单独的存储库范围的构建是此流程不需要。

2. 选择您的主机

打开所需的主机并运行默认安装命令。

OpenClaw

默认安装：

pnpm component:install:tokenpilot:openclaw

这将安装当前的 TokenPilot OpenClaw 适配器，更新 ~/.openclaw/openclaw.json，启用插件，将 plugins.s.contextEngine 切换到 layered-context，应用默认的 normal 模式，并尝试重新启动 OpenClaw自动网关。

如果您的 OpenClaw 主目录或配置路径不在默认 ~/.openclaw 下，请设置：

export LIGHTRSI_OPENCLAW_HOME="/path/to/openclaw-home"
export OPENCLAW_CONFIG_PATH="/path/to/openclaw.json"

然后再次运行相同的安装命令：

pnpm component:install:tokenpilot:openclaw

Codex CLI

默认安装：

corepack pnpm cleaner:install:codex

这将构建并安装共享 CLI、恢复 MCP、Codex 适配器和仅显式 lightrsi-clean、lightrsi-clean-status、 lightrsi-clean-apply和lightrsi-clean-cancel指挥技能。它保留了您当前有效的 Codex 提供商，通过本地 TokenPilot 重新路由它 proxy，写入~/.codex/tokenpilot.json，并注册所需的钩子和 MCP 服务器。

如果您的 Codex 配置文件不在默认的 ~/.codex 下，请设置：

export CODEX_CONFIG_PATH="/path/to/config.toml"
export CODEX_HOOKS_CONFIG_PATH="/path/to/hooks.json"
export TOKENPILOT_CODEX_CONFIG="/path/to/tokenpilot.json"

然后运行相同的安装流程：

corepack pnpm cleaner:install:codex

在 Windows 上，安装程序使用 npm 命令目录（当该目录为已在 PATH 上并创建 lightrsi.cmd。在 Linux/macOS 上，它安装在默认为 ~/.local/bin。设置 LIGHTRSI_BIN_DIR 选择另一个命令目录。

Claude Code

默认安装：

corepack pnpm cleaner:install:claude-code

这将构建并安装共享 CLI、恢复 MCP、Claude Code 适配器和仅显式的 Cleaner 分析、状态、应用和取消命令技能。它更新本地网关路由，注册所需的钩子和 MCP 服务器，以及在重写之前将现有的 Claude 文件保留为 .tokenpilot.bak 备份。

如果您的 Claude 代码文件不在默认的 ~/.claude 下，请设置：

export CLAUDE_CODE_SETTINGS_PATH="/path/to/settings.json"
export CLAUDE_CODE_MCP_CONFIG_PATH="/path/to/.claude.json"
export TOKENPILOT_CLAUDE_CODE_CONFIG="/path/to/tokenpilot.json"

然后运行相同的安装流程：

corepack pnpm cleaner:install:claude-code

使用 node scripts/install-cleaner.mjs --dry-run 检查确切的构建和安装命令，无需更改主机配置。仅在重用现有本地构建时添加 --skip-build；安装程序在更改主机之前拒绝丢失或较旧的 CLI、MCP 和适配器工件配置。

DeepSeek Harness

DeepSeek Harness 适配器是原生 Cordis 插件，安装到 DeepSeek Harness checkout 中，而不是通过共享的 CLI 安装。从此存储库构建本地包：

corepack pnpm --filter @lightrsi/deepseek-harness-adapter build
corepack pnpm --filter @lightrsi/deepseek-harness-adapter pack --pack-destination ./artifacts

从 DeepSeek Harness checkout 中，将生成的 .tgz 添加到您使用的配置文件中，例如 web：

node --import tsx/esm apps/cli/src/bin.ts plugin --profile web add /absolute/path/to/lightrsi-deepseek-harness-adapter-.tgz

该插件注册为 tokenpilot-dsh，默认情况下处于禁用状态。仅在提供耐用的 stateDir 以及 Harness 配置文件所需的估计器和逐出设置后才配置和启用它。其故障模式是故障开放，因此优化失败不会阻止代理。

⚡ 快速入门

选择您的主机并打开下面匹配的一次性设置。

OpenClaw

启动或重新启动OpenClaw。
使用 lightrsi/ 模型（例如 lightrsi/gpt-5.4-mini）打开会话。
运行：

/lightrsi status

您应该看到类似于以下内容的状态块：

插件条目已启用
配置已启用
模式 normal
上下文引擎槽 layered-context
启用稳定器
减少启用

要获得更完整的运行时摘要，请运行：

/lightrsi report
/lightrsi doctor
/lightrsi visual
/lightrsi mode normal

/lightrsi doctor是当前OpenClaw适配器表面最快的集成自检。 /lightrsi visual 打开本地视觉检查器以进行稳定性、缩减和驱逐快照。 /lightrsi 模式 <保守|正常|Aggressive> 切换预设的运行时行为。

您还可以在 OpenClaw 之外使用独立的 CLI：

lightrsi openclaw status
lightrsi openclaw report
lightrsi openclaw doctor
lightrsi openclaw visual
lightrsi openclaw mode normal

Codex CLI

当前的 Codex 路径使用独立的 CLI 以及 Codex 挂钩。

运行上面显示的 Codex 安装流程。
正常启动 Codex。
如果 Codex 要求您查看或信任已安装的 TokenPilot 挂钩，请批准它们。
打开一个新的 Codex 会话，以便 SessionStart 可以启动本地代理。
在另一个终端中，验证适配器：

lightrsi codex status
lightrsi codex doctor
lightrsi codex report
lightrsi codex mode normal
lightrsi codex reduction status
lightrsi codex stabilizer target user

预计首轮形状：

lightrsi codex doctor 报告 proxy healthy: yes
lightrsi codex status 显示 stabilizer 和 reduction 已启用
几个回合后，lightrsi codex report不再说No TokenPilot session stats yet.

安装成功并不总是意味着代理已经在第一个受信任会话之前运行。如果在信任钩子并打开新的 Codex 会话后，医生仍然报告 proxy healthy: no，请使用手动后备：

tokenpilot-codex status
tokenpilot-codex start

Claude Code

当前的 Claude Code 路径也使用独立的 CLI，但通过本地 Anthropic 兼容网关和共享 MCP 恢复服务器路由请求。

运行上面所示的 Claude Code 安装流程。
正常启动克劳德代码。
打开一个新的 Claude Code 会话，以便 SessionStart 可以自动启动本地网关。
在另一个终端中，验证适配器：

lightrsi claude-code status
lightrsi claude-code doctor
lightrsi claude-code report
lightrsi claude-code mode normal
lightrsi claude-code reduction status
lightrsi claude-code stabilizer target developer

预计首轮形状：

lightrsi claude-code doctor 报告 proxy healthy: yes
lightrsi claude-code status 显示 stabilizer 和 reduction 已启用
几个回合后，lightrsi claude-code report不再说No TokenPilot session stats yet.

与 Codex 一样，安装成功并不能保证在第一个真实会话触发 SessionStart 之前网关已经正常运行。

DeepSeek Harness

添加并启用tokenpilot-dsh Cordis插件后，打开一个DeepSeek 利用会话并运行：

/tokenpilot-status

该命令报告估计器、调度、应用程序和延迟状态，而无需创建模型轮次。默认情况下，适配器在 Harness 的本机压缩之前运行其逐出过程；保留此顺序，除非您故意更改配置文件配置。

视觉效果

下面的屏幕截图来自打开的内置视觉检查器：

lightrsi visual

TokenPilot 运行时 effects

稳定前缀视图：

缩小视图：

驱逐视图：

建筑

当前的公共存储库将可重用功能、经过验证的预设、主机适配器和面向用户的产品分开。

高层次上：

components/packages
- 共享基础和可独立组合的功能包
components/presets
- 经过验证的功能组合，例如 TokenPilot
components/adapters
- 特定于主机的集成、安装表面、运行时挂钩和产品注册
components/products
- 共享 CLI、视觉启动器、恢复 MCP 和交互式清洁表面

LightRSI/
├── components/
│   ├── packages/
│   │   ├── foundation/           # contracts, runtime, host, history, artifact, product infrastructure
│   │   └── features/             # stabilizer, reduction, eviction, and memory
│   ├── presets/
│   │   └── tokenpilot/           # Stabilizer + Reduction + Eviction composition contract
│   ├── adapters/
│   │   ├── openclaw/             # OpenClaw adapter
│   │   ├── codex/                # Codex CLI adapter
│   │   ├── claude-code/          # Claude Code adapter
│   │   └── deepseek-harness/     # native DeepSeek Harness Cordis adapter
│   └── products/
│       ├── cli/                  # shared lightrsi CLI, browser visual launcher, and Cleaner UI
│       └── mcp/                  # shared recovery and interactive MCP session support
├── docs/                         # Public-facing notes and smoke helpers for the current runtime path
├── website/                      # Documentation site
└── README.md

TokenPilot 现在是预设而不是源代码父目录。每个适配器显式绑定预设并贡献主机发现元数据；共享的 CLI 和视觉表面消耗这些注册。

实验再现

基准测试任务、运行程序、配置文件和分析均保存在单独的 TokenPilot 实验存储库中。 LightRSI包含运行时和插件平台；它不再供应实验工具。

实验入口点：

TokenPilot 复制指南

命令

首先使用基本命令，然后在需要时使用会话感知命令和高级命令。

共享独立 CLI 模式：

lightrsi report
lightrsi visual
lightrsi use openclaw
lightrsi use codex session 
lightrsi context
lightrsi  session  report

lightrsi report 显示跨主机的最新可用报告
lightrsi visual 打开共享浏览器视觉效果并允许您切换主机和会话
lightrsi use 设置无主机 CLI 命令的默认主机
lightrsi use session 为以后的 report 和 visual 固定默认会话
lightrsi context 显示当前默认主机、固定会话和记住的配置目标
lightrsi session report 直接读取一个特定会话

在下面的命令界面中选择您的主机。

OpenClaw

在 OpenClaw 会话内：

/lightrsi status
/lightrsi report
/lightrsi doctor
/lightrsi visual
/lightrsi mode normal
/lightrsi stabilizer target developer
/lightrsi reduction mode balanced
/lightrsi eviction on
/lightrsi help

在OpenClaw之外，独立的CLI直接支持同一主机：

lightrsi openclaw status
lightrsi openclaw report
lightrsi openclaw doctor
lightrsi openclaw visual
lightrsi openclaw mode normal
lightrsi openclaw session  report

有用的 OpenClaw-only 控件：

mode aggressive 启用最积极的运行时策略预设
eviction ... 控制生命周期感知上下文驱逐
settings details on 扩展状态输出，提供更多运行时详细信息
stabilizer ... 和 reduction ... 让您直接调整前缀稳定和观测减少

Codex CLI

使用独立的CLI：

lightrsi codex status
lightrsi codex report
lightrsi codex doctor
lightrsi codex visual
lightrsi codex session  report
lightrsi codex reduction status
lightrsi codex stabilizer target developer
lightrsi codex mode normal
lightrsi codex reduction mode balanced
lightrsi codex help

有用的 Codex 控件：

稳定器开启|off 切换稳定前缀重写
稳定器目标<开发者|user> 选择附加动态上下文的位置
减少|off 切换观察减少 -还原模式<光|平衡>在较轻和较强的修剪之间切换
reduction pass toolPayloadTrim off 禁用一个特定的缩减过程
lightrsi codex clean 分析会话并交互选择要清理的任务

Claude Code

使用独立的CLI：

lightrsi claude-code status
lightrsi claude-code report
lightrsi claude-code doctor
lightrsi claude-code visual
lightrsi claude-code session  report
lightrsi claude-code reduction status
lightrsi claude-code stabilizer target developer
lightrsi claude-code mode normal
lightrsi claude-code reduction mode balanced
lightrsi claude-code help

有用的克劳德代码控件：

稳定器开启|off 切换稳定前缀重写
稳定器目标<开发者|user> 选择附加动态上下文的位置
减少|off 切换观察减少 -还原模式<光|平衡>在较轻和较强的修剪之间切换
reduction pass toolPayloadTrim off 禁用一个特定的缩减过程

DeepSeek Harness

在 DeepSeek Harness 会话中：

/tokenpilot-status

此只读命令报告估算器活动、符合条件的驱逐工作、计划或应用的更改以及任何延期。 DeepSeek 线束适配器由 Cordis 注册为 tokenpilot-dsh；它不使用共享的 lightrsi CLI。

实验结果

基准任务、运行程序、配置文件、分析和结果包均保存在单独的 TokenPilot 实验存储库中。该存储库仅保留运行时和插件平台。

TokenPilot 复制指南
PinchBench 基准测试文档
Claw-Eval 基准测试文档

对于最新的命令、配置和报告的结果，请使用实验存储库作为事实来源。

相关作品

LightMem系列

该存储库属于 ZJUNLP LightMem 系列，专注于解决长时间运行的 LLM 代理的上下文膨胀、令牌消耗过多和缓存利用率低的问题：

LightMem — 专为大型语言模型和 AI 代理设计的轻量级高效内存管理框架
LightMem-Ego — 用于日常生活辅助的轻量级流式多模式存储系统

其他相关项目

LLMLingua-2 — 令牌级提示压缩
SelectiveContext - 基于自信息的上下文缩减
Pichay — LLM 上下文窗口的请求分页
MemoBrain - 长视野推理代理的执行内存
AgentSwing - Web代理的自适应并行上下文管理路由
MemOS — LLM 代理的内存操作系统
Headroom — 当 AI 代理读取时压缩所有内容

社区

Discord — 设置帮助、调试、反馈和用户讨论
GitHub 问题 — 可重现的错误、功能请求和集成回归

郑重声明：本站发布内容宗旨在传播更多信息，仅提供查阅，与本站立场无关，不拥有所有权，不承担相关法律责任。不具有任何效益，仅供参考。如果需要专业知识建议，请咨询相关专业人士。如有侵权请联系邮箱。一经查实，立即删除！

喜欢(0)

DeepSeek Harness的7个插件,让 Agent真正好用的插件实用指南

geml：AI Agent 工具实践指南