lcc 本地上下文编译器

这个 Agent 能做什么，适合哪些场景？

lcc（Local Context Compiler）是一个面向编码 agent 的上下文压缩工具，目标是在不丢失关键信息的前提下减少会话 token。它把旧工具输出从上下文中移出，但每个被移除的片段都进入本地内容寻址存储（~/.cache/lcc/stash），可通过 recall 命令以哈希校验方式原样取回。所有保留的文本段与源文件逐字节一致，不会被改写或摘要。它提供三种使用方式：命令行工具 lcc、MCP 服务器（compact、recall、inspect 等工具）、以及替代 /compact 的 Claude Code 插件。默认判断器在本地 CPU 上以纯 Python 运行，无需 API 密钥或网络，另有一个需显式启用的远程 jev provider。每次压缩都会写出 JSON 报告，可用 lcc explain 查看每个块的保留或丢弃原因。

lcc 读取 Claude Code 会话 JSONL、Codex CLI rollout 文件、Aider 聊天记录或普通文档，按指定模式（tool-calls）与 provider（rules、specialist-v3、mechanical、jev）判断哪些块可丢弃。rules 模式有三种：lossless 只删可证明的重复，recoverable 还删可重读的输出，stashed（推荐）把被删输出写入 ~/.cache/lcc/stash 并在上下文里留下 [removed: N lines, X KB · lcc recall <id>] 形式的占位符。输出是一份压缩后的文件和一份 relevance-compaction-1.2 JSON 报告，报告记录 provider_used 与 degraded 状态。lcc recall <id> 读取时重新计算哈希；lcc explain report.json --source 给出每个块被保留或丢弃的理由。lcc measure-session 在单个会话或整个项目目录上离线运行各模式，仅打印计数（消息数、工具调用数、压缩前后 token、耗时），并可用 --input-map 展示缓存读写与工具结果所占的计费输入份额。MCP 服务器暴露 compact、compact_transcript、recall、inspect、prepare、explain、intake 七个工具。

1. Claude Code 用户遇到长会话上下文膨胀、/compact 摘要后丢失具体报错或路径时，改用 lcc 插件保留原文并可按需 recall。
2. 需要在 Cursor、Claude Desktop 等任意 stdio MCP 客户端中接入上下文压缩能力时，配置 lcc mcp 作为服务器。
3. 开发者在 CI 或脚本中批量处理会话文件或 Markdown 文档，用 lcc compact 配合 -q 目标描述和对 --provider 选择生成压缩产物与审计报告。
4. 研究员或团队想先用 lcc measure-session 在自己真实会话上量化各模式的 token 削减幅度，再决定是否采用。
5. 需要审计合规的团队希望每次裁剪都有 JSON 报告和逐块理由，用 lcc explain 复核。
6. 对隐私敏感、要求内容不出本机的用户，使用本地 CPU 运行的 rules 或 mechanical provider。

如何安装或部署这个 Agent？

需要 Python 3.11+。用 pip 安装包并为精确 token 计数加装 tiktoken 附加项：

pip install "local-context-compiler[tiktoken]"
lcc fetch-tokenizer

lcc fetch-tokenizer 是唯一联网命令，会下载 tiktoken 编码文件一次；不执行时计数会被标记为近似。

Claude Code 插件方式（需 Claude Code 2.1.274+ 并开启 function hooks）：

export CLAUDE_CODE_ENABLE_FUNCTION_HOOKS=1
claude plugin marketplace add lucasmartins-ai/lcc
claude plugin install lcc@lcc --config provider=rules --config rulesMode=stashed

安装后需允许 mcp__plugin_lcc_lcc__recall，agent 才能取回被移除的输出。

如何使用这个 Agent？

先测量自己最近一次会话的削减效果（离线、仅打印计数）：

lcc measure-session "$(ls -t ~/.claude/projects/*/*.jsonl | head -1)"

对会话文件或普通文档执行压缩，并写出压缩结果与 JSON 报告：

lcc compact ~/.claude/projects/<project>/<session>.jsonl -q "finish the parser fix" \
  --mode tool-calls --provider rules --rules-mode stashed -o compacted.json -r report.json

lcc compact notes.md -q "what is wrong with the booking flow?" \
  --provider mechanical -o compacted.md -r report.json

取回被移除的输出（读取时重新校验哈希），并查看每个块的去留理由：

lcc recall <id>
lcc explain report.json --source notes.md

作为 MCP 服务器接入任意 stdio 客户端：

{"mcpServers": {"lcc": {"command": "lcc", "args": ["mcp"]}}}

如需远程 jev provider，需设置 TYPESAFE_API_KEY 并显式指定 --provider jev；LCC_DISABLE_NETWORK=1 可禁用网络出口。

这个 Agent 有哪些优点和局限？

这个 Agent 与同类方案有什么区别？

与相关度最高的同类 agent 并排比较关键指标。

FollowAgents 如何评估这个 Agent？

最近版本

来自该项目 GitHub Releases 的最新发布记录，说明为上游原文摘录，未经本站改写或测试。

1. v1.3.0 2026-10-31
   发布说明摘录

   lcc 1.3.0 ```sh pip install -U "local-context-compiler[tiktoken]" lcc fetch-tokenizer # once: exact token counts ``` If you use the Claude Code plugin, update it from /plugin as well, so the hook and the lcc it calls are both 1.3.0. First run is fast and exact - lcc measure-session runs the two rules modes by default; auto needs --auto. On 1.2.0 the auto arm took 247 s of a 4 min 15 s run on a 10,559-message session, so the README's first command looked hung. On a ~520k-token session the default now returns in about 2 s …

   在 GitHub 查看 ↗
2. v1.2.0 2026-10-20
   发布说明摘录

   Added - lcc measure-session <session.jsonl>: runs rules:lossless, rules:stashed and auto on one Claude Code session, offline, and prints counts only (messages, tool calls, tokens before/after, texts kept, time). --markdown is ready to paste into an issue, --json is lcc-session-report/1. It never writes to the real stash. - lcc compact --mode tool-calls --rules-mode <mode> (with --provider rules): the CLI can now select stashed, recoverable or lossy; before, only MCP and Python could. …

   在 GitHub 查看 ↗
3. v1.1.0 2026-10-19
   发布说明摘录

   Added - Claude Code plugin: rulesMode: "stashed". The plugin accepted only lossless, recoverable and lossy, so the stashed mode could not be picked from Claude Code. Docs now recommend stashed with the recall tool, with the one measured run (INFERIDO) in docs/TOOL_CALLS.md. - rules_mode: "stashed" and lcc recall. Tool-call compaction can now remove what lossy drops or trims and what recoverable replaces without losing it: the exact bytes go to a local content-addressed stash (~/.cache/lcc/stash, 0700/0600, LCC_STASH_DIR) …

   在 GitHub 查看 ↗

常见问题