LightRSI：AI Agent 工具实践指南

新闻

• [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 <host> --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-<version>.tgz

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

/lightrsi status

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

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

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

tokenpilot-codex status
tokenpilot-codex start

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

/tokenpilot-status

lightrsi visual

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

lightrsi report
lightrsi visual
lightrsi use openclaw
lightrsi use codex session <session-id>
lightrsi context
lightrsi <host> session <session-id> report

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

lightrsi openclaw status
lightrsi openclaw report
lightrsi openclaw doctor
lightrsi openclaw visual
lightrsi openclaw mode normal
lightrsi openclaw session <session-id> report

lightrsi codex status
lightrsi codex report
lightrsi codex doctor
lightrsi codex visual
lightrsi codex session <session-id> report
lightrsi codex reduction status
lightrsi codex stabilizer target developer
lightrsi codex mode normal
lightrsi codex reduction mode balanced
lightrsi codex help

lightrsi claude-code status
lightrsi claude-code report
lightrsi claude-code doctor
lightrsi claude-code visual
lightrsi claude-code session <session-id> 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

/tokenpilot-status