Lians Agent Memory

恢复任务。拒绝过时状态。阻止未经支持的完成声明。

快速入门 · 为什么选择 Lians · ContinuityBench · 安装 · 文档 · 问题

Lians Guard

面向 AI 编码 Agent 的当前状态与完成守卫。

Lians 可恢复中断的 Agent 工作、拒绝过时的任务状态，并在当前任务准备好交由人工审查之前阻止 done。

Agent 可以忘记聊天记录，但不会忘记哪些工作已经完成、有哪些 变更，以及还有哪些检查必须通过。

• 恢复。 跨受支持的 Claude Code 和 Codex 会话，继续执行范围明确的当前任务。
• 拒绝过时状态。 将检查点绑定到当前仓库和任务状态， 避免静默地重复使用旧证据。
• 守卫完成状态。 将经测量的证据与 Agent 自身的声明区分开来， 在工作缺失、未知、失败或受阻时保持关卡关闭。
• 要求审查。 READY FOR HUMAN REVIEW 表示移交给人工处理，绝不表示 工作正确、已获批准或可以安全部署。
• 保持本地运行。 免费的恢复路径不需要 Lians 账户、AI 密码或 服务商 API 密钥。

Lians 可与现有的 AI 账户和编辑器配合使用。它不会取代你的 模型、Git、CI、仓库说明或人工审查。

两层架构，一个 Agent 工作循环

开源的 Lians Guard 层通过 MCP、技能、钩子和仓库状态在 Codex 中运行。它会记住修正意见并提供证据， 而不会接管模型。可选的 Lians Mission Control Beta 版是本地控制层：为其指定一个任务，让它选择一条范围明确的 Codex 执行路径，并要求它在返回 PASS 之前由真实验证器进行验证。

在受支持的 Codex 版本中，一个 Mission Control 任务现在使用一个 Codex app-server 线程，而不是为每个阶段启动新进程并重放摘要。Codex 仍负责身份验证、工具、沙盒和执行； Lians 负责持久任务、用量策略和凭证。App-server 目前仍处于实验阶段，因此仍可使用一次性适配器。

查看 Mission Control 源码、阅读 桥接边界，或查看 外部证明关卡协议。

每次 Agent 会话后，都能得到清晰结果

RECOVERED
Task: Fix OAuth callback handling
Next: Re-run the callback integration test

STALE
Reason: The authentication requirement changed after this checkpoint

BLOCKED
Missing: OAuth callback integration test
Untrusted: "tests passed" was reported by the agent, not measured

READY FOR HUMAN REVIEW
Measured locally: callback tests passed
Measured by CI: required checks passed

信任模型刻意设定得很严格。measured_local、measured_ci 和 human_confirmed 证据可以满足某项标准。agent_attested 和 inferred_activity 记录仍可作为有用的背景信息，但不能通过审核 关卡。Agent 不能将自己的检查点提升为可信类别。可信的 CI 证据需要精确匹配 GitHub 证明和提交，并进行交互式检查到标准的映射；人工证据则需要交互式确认。请阅读 Lians 的存在意义、完整的 Lians Guard 产品契约，以及当前的市场 压力测试。

两分钟快速体验

选择你已经在使用的 AI 工具：

工具	最快设置方式
Codex app、CLI 或 IDE	一条命令
Claude Code	两条插件命令
Cursor	一键安装 MCP
其他 MCP 客户端	最简 MCP 设置

例如，安装 uv 后，使用以下命令连接 Codex：

codex mcp add lians --env LIANS_MCP_ENABLED_TOOLS=remember,recall,list_memories,correct_memory,forget_memory -- uvx --from "lians-sdk[mcp]" lians-mcp

重启 Codex，然后保存一条安全的项目事实，并在新聊天中恢复它。 默认情况下，本地记忆存储在 ~/.lians/mcp.db 中。这是可用的 免费恢复方案；完整的 Guard 工作流目前仍处于开发者预览阶段。

查看完整快速入门，了解设置、恢复、 修正、删除以及 Guard 预览范围。

新的编码 Agent 会收到什么

Lians 可以生成范围明确的项目交接内容，而不是重放对话记录：

Reported complete; verify:
- migrated the orders API to /v2/orders

Still open:
- verify the migration against current Git state
- update documentation

Decisions:
- keep pytest

Changed:
- /v1/orders is stale; use /v2/orders

Next:
- update documentation before touching unrelated UI

交接内容根据 Lians 当前状态生成，而非依赖人工维护的 摘要。Agent 报告的工作仍会清晰呈现，不会被误标为 已验证完成。

为什么这不是又一个通用记忆层

如果工作始终在同一款产品中进行，原生记忆会很方便。通用记忆已不再是稀缺类别。Lians 使用本地记忆来恢复上下文， 然后专注于成本高昂的缺口：当前任务状态和有证据支持的就绪状态。

当前竞争格局通过对照 Claude Code、Codex、Cursor、GitHub Copilot、 Entire、Factory 和 AI 审查工作流，检验这一定位。

方案	最适用场景	局限
工具原生记忆	单一 AI 工具，设置简单	通常局限于该厂商的产品内
AGENTS.md 或 CLAUDE.md	稳定的仓库说明	必须手动维护
对话记录重放	重建单次对话	内容庞大、杂乱，还可能让过时决策重新生效
Lians 免费恢复方案	在受支持的工具间恢复当前项目上下文	需要分别与每个工具建立本地连接
Lians Guard	检测过时状态，并用类型化证据把关就绪状态	团队工作流仍处于开发者预览阶段

Lians 并未声称每个项目都需要单独的记忆层。请参阅 客观比较与决策指南。

项目状态

Lians 正在积极开发中。此处将可用的恢复功能与预览版 Guard 功能分开列出，以免让仓库造成尚不存在的生产保障承诺。

能力	状态
通过 MCP 和 Python 使用本地记忆	可用
Codex、Claude Code 和 Cursor 本地恢复设置	可用
检查、更正和经确认的永久删除	可用
有界上下文和签名选择回执	可用
自动进行 Claude 到 Codex 的项目交接	Beta
类型化证据和证据支持的任务门禁	开发者预览版
检查点中的本地 Git 工作区指纹	开发者预览版
自动使过时证据失效	开发中
经证明的 GitHub Actions 证据接入	开发者预览版
本地 Guard 报告	开发者预览版
共享团队队列	计划中
跨平台全新安装 CI	新 Guard 工作流要求；等待首次托管运行
引导式桌面安装程序和本地控制中心	发布候选版
Mission Control Protect 与 Maximum Beta	候选；证明门槛已预注册
持久化的单任务/单 Codex 线程桥接	Beta；app-server 为实验性功能

macOS 和 Windows 桌面版本仍为发布候选版，等待平台签名和公证。请参阅桌面预览版边界。

当前证据

随附的 Claude 到 Codex 连续性测试样例恢复了 10/10 个预期事实，将 0 个过时事实显示为当前事实，并生成了 231 个 token 的交接内容。这些是有限范围内的 Beta 测试结果，并不保证每个实际编码会话都能完美提取信息。运行实验。

正在开发的 ContinuityBench v0.1 发布了拟议中的跨 Agent、新鲜度、更正、擦除、来源追溯和范围界定测试契约。当前的 Lians 测试样例仅能证明该测试样例本身，并未作为已完成的竞争对手排行榜呈现。

另一项实时测试通过 Cursor 保存了一条合成项目事实，并在新的 Cursor 聊天和全新的 Claude Code 会话中将其调出；删除后确认该事实已消失。阅读测试方法。

Guard 正确性基准测试涵盖证据缺失、条件未知、约束未通过、阻碍项、过时更新和偏移信号。这是针对已配置策略进行的本地确定性测试，并不能证明语义正确性或生产环境中的结果。运行 packages/lians-easy/benchmarks/task_contract_correctness.py 查看测试用例。

使用 Lians 构建

在应用程序中使用本地 Python SDK：

pip install "lians-sdk[local]"

from datetime import datetime, timezone
from lians import LocalLiansClient

memory = LocalLiansClient(db_path=".lians/memory.db")
memory.add(
    agent_id="my-agent",
    content="The project uses Python 3.12 and pytest.",
    event_time=datetime.now(timezone.utc),
)

result = memory.recall(
    agent_id="my-agent",
    query="Which Python version and test runner should I use?",
)

有关 TypeScript、Go、Java、C、框架集成和自托管的详细信息，请参阅安装指南。

正在组织课程、俱乐部、黑客马拉松或校园开发者团体？请使用学生和社区套件。贡献者和软件包集成者可以从支持的路径和仓库状态开始。

高级能力

Lians 还提供项目范围内的 Agent 交接、签名选择和审核回执、本地研究和浏览器简报、时间重建、来源追溯、信息屏障、经确认的擦除以及有界形式化检查工具。这些能力适用于高级部署或受管部署，但并非入门记忆工作流所必需。

• 记忆引擎
• 跨 Agent 连续性实验
• Agent 工作验证
• 安全模型
• 社区与托管产品边界
• 支持的路径和仓库状态

## 开发

git clone https://github.com/Lians-ai/Lians.git
cd Lians
python -m pip install -e ".[dev]"
python scripts/test_all.py

提交拉取请求前，请阅读 CONTRIBUTING.md。欢迎在 GitHub Issues 中提出功能建议、集成请求和可复现的错误报告。

如果 Lians 有助于你的工作流，请为仓库加星， 让其他 AI 工具用户也能发现它。

许可证

Apache 2.0。详见 LICENSE。