AIPass
一个让 AI 智能体拥有持久记忆、彼此协作、跨会话不再从零开始的多智能体工作区操作系统。
- Star 数
- ★ 312
- 最近更新
- 2 天前
- License
- MIT
- 主语言
- Python
- FA 评分
- 50/100 · 缺口较多
30 秒速览
- 运行形态
- 可在哪里用
- 兼容但需适配Codex · Claude Code
- 费用
- 软件免费，模型调用费用自付
- 上手难度
- 中 · 需要几步配置
- 开始前需要
- 典型场景
- 个人开发者使用 Claude Code，希望智能体跨会话记住项目决策和上次做过的事，而不是每次重新解释上下文。
- 不适合
- 使用原生 Windows 且无法安装 WSL2 的用户
- 没有包含 Claude Code 的 Claude 付费计划、且不想订阅的用户
- 需要云托管多租户方案而非本地单机部署的团队
- 源码审查
- 50/100 · 缺口较多
这个 Agent 能做什么，适合哪些场景？
AIPass（AIOSAI/AIPass）是一个本地运行的持久化智能体工作区，通过 pipx 安装后以 aipass 和 drone 两个命令驱动。它在同一文件系统上为 18 个参考智能体各自分配主目录、护照（.trinity/passport.json）、邮箱（.ai_mail.local/）和持久记忆，智能体可通过 drone @agent 总线互相派发任务并唤醒对方。执行模型是把 Claude Code 作为官方子进程运行在你的现有 Claude 订阅上（可选接入 Codex 和 OpenCode 作为第二 CLI）；所有记忆、邮件都是本机文件，溢出的记忆滚动进可语义搜索的本地向量库。写操作由钩子门控（edit gate、git gate）限制，只有项目管理员可写 git，标准审计由 drone @seedgo audit 执行。它面向在自己的仓库里使用 Claude Code、Codex 或 OpenCode、希望智能体记住上周工作并把任务互相交接的个人开发者。
安装时执行 pipx install aipass 后运行 aipass install：克隆仓库到 ~/AIPass、构建环境、设置 18 个智能体并运行健康检查。日常工作流：aipass new my-project --template python 创建带常驻管理员智能体的新项目，或 aipass init run 在已有目录中做引导式接入。你用自然语言与管理员对话（如"给 report 命令加 CSV 导出"），它用 drone @flow create . "任务" 写下携带上下文的工作计划，再用 drone @ai_mail dispatch @agent "主题" "正文" 派发任务并唤醒负责该代码的智能体；该智能体在自己的目录中醒来，读取自己的提示词、.trinity/ 记忆、刷新的 DASHBOARD.local.json 和任务邮件，完成后回复落入管理员收件箱。drone @spawn create src/my_project/analyst --role "Analyst" --purpose "Reports" 可新增智能体，drone @seedgo audit aipass 运行与 CI 相同的标准审计，drone @daemon install-timer 启动定时调度，drone @memory roots add <path> 把你自己的仓库接入舰队派发范围。记忆以纯 JSON 文件持久化，满了以后滚动进本地向量存储供语义搜索。
- 个人开发者使用 Claude Code，希望智能体跨会话记住项目决策和上次做过的事，而不是每次重新解释上下文。
- 在同一个仓库中想要多个分工明确的智能体（如 analyst、管理员）互相派发任务、交接工作的人。
- 已有项目目录的用户，想通过
aipass init run在不重建项目的情况下为现有代码库加入智能体团队。 - 需要把智能体写权限限制住的人：钩子门控决定哪个智能体可编辑哪些文件，git 只经一道门，原始删除被拒绝。
- 想让重复性工作（日志、备份、定时任务）自动运行的维护者，可用
drone @daemon install-timer给每个智能体配置自己的调度。 - 想在手机上查看和管理本地智能体舰队的人，通过配套的 BAUD 手机端在自家机器上提供服务。
如何安装或部署这个 Agent？
前置条件：Python 3.10+、包含 Claude Code 的 Claude 计划（Pro/Max/Team/Enterprise）、Linux 或 macOS（Windows 需 WSL2）。安装：
pipx install aipass
aipass install第一条命令把 aipass 和 drone 放入 PATH；第二条克隆仓库到 ~/AIPass（用 --path 自选）、构建环境、设置 18 个智能体、运行健康检查，并以 AIPass 礼宾智能体的对话收尾（--no-baud 可跳过手机端服务）。无 API 密钥需求：核心功能运行在你现有的 Claude 订阅上；可选的 OpenRouter 集成才需要密钥。开发 AIPass 本身可从克隆安装：
git clone https://github.com/AIOSAI/AIPass.git && cd AIPass && ./aipass install如何使用这个 Agent？
- 创建或接入项目：
aipass new my-project --template python # 新项目：脚手架、常驻管理员智能体、首次提交
aipass init run # 已有目录：在其内运行，引导式设置- 在管理员目录中运行
claude，用自然语言下达需求（如"给报告命令加 CSV 导出"），它会写计划并派发给负责相应代码的智能体。手动等效操作：
drone @flow create . "Add CSV export" # 携带上下文的工作计划
drone @ai_mail dispatch @agent "Subject" "Body" # 发送任务并唤醒智能体- 扩展与检查：
drone @spawn create src/my_project/analyst --role "Analyst" --purpose "Reports"
drone @seedgo audit aipass
aipass doctor要让舰队向你已有的项目派发工作，先声明一次 drone @memory roots add <path>。也可直接与 devpulse（管理席位）或 aipass（礼宾/机器维护）对话。
这个 Agent 有哪些优点和局限？
- 记忆持久化是具体设计而非口号：每个智能体有
.trinity/记忆目录和护照文件，溢出记忆滚动进可语义搜索的本地向量库。 - 协作有真实机制：
ai_mail邮箱与派发、flow计划携带上下文、trigger事件总线唤醒出错的责任智能体。 - 权限边界明确：编辑门控、git 单门（仅项目管理员可写）、原始删除拒绝、提供商设置更改需业主同意。
- 全部本地化：记忆与邮件是本机文件，无云账户；18 个核心智能体在 CI 中按同一成文标准被审计。
- 必须拥有包含 Claude Code 的 Claude 付费计划；虽然 Codex 和 OpenCode 可作为第二 CLI，但 Claude Code 是必需前提。
- 原生 Windows 不支持，仅能在 WSL2 内运行；macOS 虽在 CI 测试但不是日常使用的平台。
- 安装会改动仓库之外的文件：用户级 Claude Code 设置（含适用于全机所有项目的 deny 规则）、shell rc、
pull.rebase、密钥环条目和 systemd 服务——卸载需逐项清理。 - 单个维护者项目（一名人类与智能体协作构建），外部贡献很少，长期演进速度取决于该项目本身。
这个 Agent 与同类方案有什么区别？
README 把 AIPass 与常见的"每个智能体一个沙箱或 worktree"的多智能体搭建方式对比：那种方式下智能体彼此看不到对方刚构建的内容，任务结束智能体即消失；AIPass 则让智能体作为"公民"共享同一文件系统，拥有持久身份、记忆和邮箱。
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| AIPass 当前 | 50 · 缺口较多 | 命令行工具免费 + 模型费 | ★ 312 | 2 天前 | Python | Codex · Claude Code |
| Compartment | 76 · 表现良好 | 命令行工具免费 | ★ 580 | 15 天前 | Python | Codex · Claude Code |
| zer0dex 本地双层记忆 | 84 · 表现良好 | 命令行工具免费 | ★ 64 | 16 天前 | Python | — |
| Mnemo Cortex | 75 · 表现良好 | 自托管服务免费 | ★ 159 | 1 天前 | Python | Codex · Claude Code · Claude.ai |
FollowAgents 如何评估这个 Agent？
查看各维度的扣分理由
README 明确列出安装会修改的每一处外部文件（~/.claude/settings.json、shell rc、keyring、systemd 单元等），并说明 deny 规则、备份与 receipts.jsonl 审计、doctor --fix 先展示 diff 再询问，属于较好的最小权限与确认设计，故 least_privilege/user_confirmation/rollback 给 2。但安装默认会写入用户级 Claude Code 设置、全局 git pull.rebase、启动本地 host API 服务并可能 sudo 放置 /usr/local/bin 符号链接，这些外部副作用范围大且默认开启，external_effects 仅 1。数据流方面 README 声称“一切本地”，但实际会把上下文发送给 Claude/Codex/OpenCode 提供方，且 BAUD 通过 tailnet 暴露，透明度只算部分，给 2。敏感数据处理有 keyring 与 ~/.secrets 隔离、deny 读取 ~/.secrets，但 SECURITY.md 与 README 对 secrets 路径描述不一致（~/.secrets/aipass/ 与 keyring 迁移），且未见具体代码佐证，给 2。依赖安全方面 CI 使用 hash 固定（--require-hashes）与固定 action SHA，但 pyproject 依赖仅下限约束、无锁文件，给 2。来源归属方面 README 引用大量内部文档与徽章，但未给出可核验的第三方来源或数据出处，且发布者身份未验证，给 1。
CI 配置完整（lint、多版本 test、standards、coverage、e2e-wheel），测试 conftest 显示对真实邮件、trigger 总线、central 文件做了隔离，说明有一定自洽性；但 README 声称“Stable”而 SECURITY.md 只支持 2.1.x、pyproject 版本为 2.8.32，版本口径不一致，self_consistency 扣至 1。依赖可用性方面声明了 Python 版本范围与可选 extra，CI 覆盖 3.10–3.13，给 2。失败信息方面 README 提到 aipass doctor 与错误提示，但未见具体错误消息设计或代码证据，给 1。
README 明确目标用户（Claude Code/Codex/OpenCode 用户）、场景（多 agent 协作、记忆持久化）与平台限制（Linux/macOS，Windows 仅 WSL2），audience_and_scenarios 给 2。能力边界方面描述了 gates、owner seat、无索引等，但“18 个 agent”与“用户自建 agent”的边界、权限模型细节仅靠 README 断言，capability_boundaries 给 1。触发精度方面 drone @agent 命令与 hooks 触发机制有描述，但缺少具体触发条件与冲突处理证据，给 1。环境适配方面给出 Python 3.10+、可选 Node/npm、sudo 回退、macOS 无沙箱等，environment_fit 给 2。
信息架构清晰，README 分节完整并链接各 agent 文档，给 2。安装说明非常详尽，列出每一步外部改动与清理方式，给 3。命名稳定性方面存在版本号不一致（SECURITY.md 2.1.x vs pyproject 2.8.32）且 README 中多处“2026”日期与当前时间线可疑，naming_stability 给 1。示例与 FAQ 有命令示例和 demo 脚本链接，但无独立 FAQ，给 2。已知限制有平台与 Windows 说明，给 2。许可证为 MIT 且 LICENSE 文件完整，给 3。版本与变更日志方面仅有 PyPI 徽章，无 CHANGELOG 文件，给 1。维护责任方面作者为“AIPass”且发布者未验证，无明确维护者承诺，给 1。
输出可用性方面 README 给出命令与预期结果，但缺少实际输出样例或可复现的端到端示例，给 1。边际价值方面“持久记忆、多 agent 协作”是常见卖点，但未提供与现有方案的量化对比或独特证据，给 1。成本效益方面安装会修改大量系统文件、启动服务、可能 sudo，收益描述较泛，给 1。
claim_traceability：README 大量断言（如“audited at 100%”“stable”）但未给出可追溯的测试报告或第三方验证，给 1。cross_source_corroboration：仅有 README、CI 配置与测试文件，缺少独立来源交叉印证，给 1。fact_inference_separation：README 将设计意图与事实混写（如“everything local”与“CLI 发送给提供方”并列），未清晰区分，给 1。
- 安装默认会修改用户级 Claude Code 设置、全局 git 配置、shell rc、keyring 与 systemd 单元，并可能使用 sudo；请在隔离环境或容器中先行评估。
- README 声称“一切本地”，但实际会把上下文发送给 Claude/Codex/OpenCode 提供方，且 BAUD 通过 tailnet 暴露，需自行评估数据边界。
- SECURITY.md 仅支持 2.1.x，而 pyproject 版本为 2.8.32，版本口径不一致，可能影响安全更新覆盖判断。
- 发布者身份未经验证，维护责任与更新路径不明确。
- README 中多处“2026”日期与当前时间线不符，需谨慎对待其时效性声明。
最近版本
来自该项目 GitHub Releases 的最新发布记录，说明为上游原文摘录，未经本站改写或测试。
-
发布说明摘录
[2026-11-02] — v2.8.34: seedgo is sentry, Beo is Seed, the settings gate asks on a write Changed - sentry (was seedgo): the standards citizen is renamed, whole, because the old name could not be said to a speech recognizer. Package aipass.sentry, address @sentry, directory src/aipass/sentry, every branch's .sentry/ bypass dir and .sentryignore, sentry_json/, the CI audit script .github/scripts/sentry_audit.py and its job sentry-audit, the # sentry: no-test-needed(...) markers and the three checkers that parse them, the SENTRY: label on hook auto-fixes, the passp …在 GitHub 查看 ↗ -
发布说明摘录
[2026-11-01] — v2.8.33: an empty .git is not a repo, dispatch stop from the deck, hook sounds off by default, the Stop gate for the watchdog wire Added - devpulse: a Stop hook (watchdog_wire_gate) refuses to end a devpulse turn while a dispatch it sent is out and no watchdog wire is armed for the session; the refusal is the arm command. …在 GitHub 查看 ↗ -
发布说明摘录
[2026-11-01] — v2.8.32: compass recall for managers only, a hook mute that survives reboots, seedgo finds the tests that pin a file, spawn owner moves, api run with a scoped key Added - seedgo: drone @seedgo tests pinning <path ...> prints every test file that names a path (as one string or as trailing Path parts), one per line, ready for pytest before a commit; .py inputs are skipped. - spawn: drone @spawn owner moves a project's owner seat to another citizen; a mint never invents a registry. …在 GitHub 查看 ↗
常见问题
除了订阅还需要付费或 API 密钥吗？
我的代码和记忆会上传到云端吗？
安装会不会动我机器上的其他配置？
git pull.rebase、系统密钥环和（启用时）systemd 用户服务。README 列出了每个被改动的文件，aipass doctor --fix 可诊断并修复，所有设置写入都有备份回执。出问题时怎么排查？
aipass doctor 命名问题所在，aipass doctor --fix 修复可修复项。每个智能体有自己的日志，prax 智能体负责监控和失控日志检测；备份系统提供可恢复的本地快照。我已有项目能接入吗？还是只能建新项目？
aipass new 创建带常驻管理员的新项目；aipass init run 在已有目录中做引导式接入，其 aipass_framework 模板会顺带加入第一个智能体。接入后用 drone @memory roots add <path> 声明，舰队即可向它派发工作。