alethech

alethech

可验证的 Agent 连续性协议——本地优先、零大模型、零区块链。 揭示传输完整性的艺术。

Copyright (c) 2026 AliceLabs LLC.

经维护者依据代码审查相关声明后，已被收录于 TeleAI-UAGI/Awesome-Agent-Memory（新兴项目）。

现已进入 官方 MCP Registry：io.github.eddyflores100-lang/alethech——只读的 alethech-mcp 桥接工具，任何支持注册表发现的 MCP 客户端均可发现它。

如果 alethech 对你有帮助，点一个 ★ star，就能帮助其他人及其 Agent 找到它。

名称源自希腊语 ἀλήθεια（aletheia，“作为揭蔽的真理”）+ τέχνη（techne，“艺术、技艺”）。 揭示记忆在签名后未被修改的艺术。

这是 docs/implementacion-nucleo-minimo.md（第 2 版 + 第 3 版身份层）中所述协议的参考实现。

这是什么

alethech 为 AI Agent 提供可通过密码学验证、可移植的记忆连续性。它使用 Ed25519 为记忆提交签名，以哈希链接构成有向无环图（DAG），轮换密钥时不丢失身份，还可以将经过验证的历史记录封装到一个加密的 .aleth 文件中，以便在兼容的运行时和设备之间传输。

本仓库包含：

• 一个密码学协议实现（Ed25519 + SHA-256 + JCS RFC 8785）
• 一个加密的可移植记忆容器（.aleth，scrypt + AES-256-GCM）
• 一个中立且经过验证的适配器视图，供插件和聊天集成使用
• 一个只读的 MCP stdio 桥接工具（python -m alethech.mcp_memory，或在执行 pip install alethech 后使用 alethech-mcp），用于提供经过验证的记忆上下文和验证工具——凭据和路径通过配置设置，绝不会作为工具参数传入
• 9 个 CLI 命令（init、commit、evidence、verify、export、import、migrate、key rotate、key revoke）
• 一个带有变异防护路径的测试套件（每项保证都有一个测试，可在检查失效时失败）
• 采用 MIT 许可证，并以 alethech 为名发布于 PyPI

本仓库不包含：

• 协议核心不是托管式检索平台；可移植技能增加了本地加密记忆工作流和有界词法检索
• 它不是旧版 memex 项目（Python/ChromaDB 记忆服务）
• 不包含 Docker、自动更新或大模型调用，也不要求使用云服务
• 仅依赖 cryptography 和 click——不依赖 mem0ai、chromadb 或 ollama

旧版 memex 代码库（167 次提交，AliceLabs 专有许可证）保存在单独的仓库中：eddyflores100-lang/memex-legacy。它不是本仓库的一部分，也不会通过 pip install alethech 安装。

该属性

这组记忆构成了与特定身份相关联、可通过密码学验证的历史记录的一部分，其提交可独立验证其完整性、密码学作者身份和来源关系。

如果存在参考检查点，还可以验证所呈现的历史记录是否延续自该检查点。

该协议不能证明 Agent 的声明属实——只能证明这些声明由声称作出声明的身份签名。未被隐藏的真相指的是传输完整性，而非内容真实性。

状态

已发布版本 0.9.1——可移植加密记忆（.aleth v2，支持 Python、TypeScript 和 Rust 之间的 ALETH002 恢复）以及将聊天捕获到可移植记忆的功能现已可用。CI 会在 Python 3.10–3.13 上运行 Python 测试套件，并进行跨语言一致性测试以及 Python、Rust 和 TypeScript 之间的 .aleth 互操作性测试。无需大模型、无需云服务、无需区块链、无需共识机制。

安装可移植记忆技能

npx skills add eddyflores100-lang/alethech --skill alethech --global

让你的 Agent 保存检查点、继续项目，或将记忆带到另一台 AI 设备。首次保存时会自动创建加密本地记忆。无需 API 密钥、账户、大模型下载、服务端或 MCP 配置。需要 Python 3.10+ 和支持脚本的 Agent Skills 宿主；缺少的协议依赖项会在私有环境中安装一次。之后的记忆操作均可离线运行。可选的云文件夹备份只会复制密文，并保留远程端发生变更的修订版本。仅支持浏览器的聊天可使用现有扩展程序／离线查看器。

参阅可移植技能的设置和限制以及一手来源替代方案评估。

安装

pip install alethech

开发环境：

git clone https://github.com/eddyflores100-lang/alethech.git
cd alethech
pip install -e ".[dev]"

用法

alethech init                              # generate identity + genesis commit
alethech commit --content <json-file>      # create signed MemoryCommit
alethech evidence --tool <name>            # create signed EvidenceCommit
  --input <file> --output <file>
alethech verify                            # verify the whole store, offline
alethech export --output <dir>             # portable package
alethech import --input <dir>              # import external memory
alethech key rotate                        # rotate operational key
alethech key revoke --key-id <id>          # revoke a key
alethech migrate --to v0.2                  # migrate identity layer

捕获聊天，携带文件

使用 Alethech 工具栏图标捕获已加载的对话、查看内容，并使用新的本地身份和恢复码创建加密的 .aleth 文件。将该文件带到另一台设备、聊天客户端或 IDE。扩展程序会导入文件，并且只会在收到请求后，将选定的上下文插入空白聊天编辑器；它绝不会发送任何内容。对于任何支持文本的客户端，可导出 context.txt。MCP 客户端可以使用本地只读记忆连接器。单个离线 alethech.html 文件也可以打开／创建文件，无需安装扩展程序或注册账户。

参阅完整的捕获与传输指南以及IDE/MCP 设置。捕获仅需 activeTab 和 scripting，无需全局主机权限或存储权限。捕获已渲染的聊天内容无法获取提供商隐藏的记忆或尚未加载的对话历史。

可移植加密记忆（.aleth）

Alethech 0.9 开发版新增了单个加密文件，专为拖放传输而设计：

from alethech import Alethech

agent = Alethech.initialize("./working-store")
agent.commit({"fact": "portable memory"})
agent.seal("memory.aleth", "your-passphrase")

# Plugin-style path: dropped file -> unlock -> verify -> neutral context
context = Alethech.drop_context("memory.aleth", "your-passphrase")

.aleth 容器使用 scrypt + AES-256-GCM。在 CI 中，Python、Rust 和 TypeScript 实现均可逐字节一致地打开其经过身份验证的载荷。可移植文件可以携带加密的操作签名密钥，以便在另一台设备上继续历史记录，但不包含 root.key 和 recovery.key。

参阅 docs/ALETH_CONTAINER_SPEC.md 和 docs/ADAPTER_CONTRACT.md。

它不会做什么

• 它不能证明 Agent 的声明属实，只能证明这些声明由声称作出声明的身份签名。
• 没有外部检查点时，它无法检测回滚。
• 本地工作存储不会静态加密；可移植 .aleth 容器已加密。
• 它不会在 Agent 之间委派权限。
• 它不会调用任何大模型。

名称含义

alethech 源自：

• aletheia（ἀλήθεια） — 希腊语，意为“真理”，更准确地说是“去遮蔽”（海德格尔的解读：真理是揭示被隐藏之物的行为）
• techne（τέχνη） — 希腊语，意为“艺术、工艺、技艺”

因此，alethech =“去遮蔽的艺术”。该协议揭示：

• 一段记忆在签名后是否被修改
• 谁签署了它
• 记录了什么签名时间戳（不是实际签名时间——仅指记录在制品中的时间戳）
• 它的来源
• 保管链是否完整

它不会揭示内容是否属实——这是 Agent 的职责，而非协议的职责。

测试

python -m pytest tests/

Python 测试套件涵盖：

• 加密原语（Ed25519、SHA-256、base64url、base32）
• JCS 规范化（RFC 8785）——56 个一致性测试向量，包括：
  • 根据 ECMAScript Number.prototype.toString() 进行整数/浮点数序列化
  • -0 序列化为 "0"（根据 RFC 8785 勘误，不予保留）
  • 科学计数法格式（正指数保留 '+'，负指数去除前导零）
  • 十进制与科学计数法的阈值（1e21 / 1e-6）
  • 使用代理对进行 UTF-16 键排序
  • 字符串转义（控制字符、保留非 ASCII 字符）
  • 拒绝 NaN/Infinity
• agent_id 派生（与 public_key 的加密绑定）
• MemoryCommit 签名、防篡改检测、拒绝错误密钥
• EvidenceCommit 签名（支持旧版和 V2 身份）
• 全部 9 个 CLI 命令（init、commit、evidence、verify、export、import、migrate、key rotate、key revoke）
• 检查点生成 + 回滚检测 + 因果连续性（祖先关系检查）
• identity_mismatch 检测
• 导出/导入往返保留
• 拒绝被篡改的清单
• 密钥轮换与 cutoff_head 可达性保证
• ancestry_check 修改防护（3 种代码级绕过方式）
• recall-seam 绕过方式（2 种数据级修改：篡改 active-keys、修改 cutoff_head）
• root_id 绑定（RootAuthority ↔ IdentityRecord ↔ ControlEvent）
• 检查点连续性（检查点 HEAD 必须是当前 HEAD 的祖先）
• IdentityRecordV2 签名验证（使用根公钥验证）
• 导入因果连续性（写入前进行祖先关系检查）
• 导入加固（符号链接、路径遍历、归档炸弹、制品哈希验证）

仓库结构

alethech/                    # this repo — cryptographic protocol only
├── alethech/                # source: crypto, objects, store, verify, cli, canonical
│   └── integrations/        # langchain + memex hooks
├── alethech-rs/             # Rust SDK (31 tests, cross-validation)
├── alethech-ts/             # TypeScript SDK (15 tests, Web Crypto API)
├── tests/                   # Python behavioral, adversarial, mutation and conformance tests
├── conformance/             # 15 adversarial conformance vectors
├── docs/                    # protocol specification
├── examples/                # basic_usage.py + memory_writeback.sh (ops pattern)
├── INTEGRATION.md           # how to integrate with memex via MemexAlethechHook
├── INTEGRATION-VIGIL.md     # fail-closed memory verification for watchdogs
├── CHANGELOG.md             # version history
├── SECURITY.md              # threat model + vulnerability policy
├── CONTRIBUTING.md          # dev setup + PR process
├── CODE_OF_CONDUCT.md      # Contributor Covenant
├── CITATION.cff             # academic citation
├── LICENSE                  # MIT
├── README.md                # this file
└── pyproject.toml           # alethech 0.9.1, deps: cryptography + click only

跨语言验证

该协议由三种相互独立的语言实现：

语言	测试	依赖项
Python	CI 套件	cryptography + click
Rust	31	ed25519-dalek、sha2、serde
TypeScript	15	0（仅使用 Web Crypto API）

三种实现均使用相同的 NIST SHA-256 测试向量、RFC 4648 base32 测试向量和 RFC 8785 JCS 一致性测试向量。跨语言一致性由一个可执行的测试工具验证：

python conformance/cross_language_check.py

该工具使用 conformance/ 中的共享测试数据运行全部三种实现，并断言对于通过验证的测试数据，规范化字节完全一致。默认运行采用失败关闭策略：退出码 0 = 三种实现均已运行且结果一致，1 = 结果不一致，2 = 某个实现/运行时不可用。CI 会构建 Rust 辅助程序并执行三运行时测试工具。有关约定和如何添加第 4 种实现，请参阅 conformance/CROSS_LANGUAGE.md。

许可证

MIT。

相关仓库

• eddyflores100-lang/memex-legacy — 旧版 Memex 代码库（167 次提交，AliceLabs 专有许可证）。采用 Python/ChromaDB 的记忆系统，集成 MCP。保留供历史参考。通过 pip install alethech 不会安装此项目。

---

版权所有 (c) 2026 AliceLabs LLC。MIT 许可证。