Loci – AI代理的本地内存层

它是什么

Loci是一款开源工具，为您提供个人、本地化的“大脑”，多个AI代理可以在此读取和写入共享上下文。所有数据都以纯文本Markdown、JSON和附件的形式存储在您自己的计算机上，因此您可以完全控制数据，并使用任何编辑器浏览或编辑数据。

核心功能

功能	使用方法
个人记忆	保存您的姓名、语言偏好、反思、决策等，并让任何连接的代理稍后检索它们。
任务与日程	创建待办事项、会议记录和时间块。带时间的任务仍然是任务——Loci不会自动将它们推送到日历中。
项目上下文	在项目存储库中维护项目状态、技术决策和开发工单的轻量级索引；完整细节保留在本地大脑中。
联系人与地点	记录人物、关系、过去的互动和位置。
知识库	为链接添加书签，存储片段，附加文件，并为自己的研究笔记建立索引。
日记与回顾	浏览活动日志，总结最近的工作，并查看保存的信息。

您可以通过向已连接到系统的代理发送自然语言命令来与Loci交互，例如：

以后用中文回复我。
明天上午9点提醒我发材料。
把这个链接收藏起来，标注“面试参考”。
记住这个项目，再告诉我目前做到哪里了。

代理根据LOCI‑RULES.md中定义的规则将这些命令转换为文件读取/写入。

支持的代理

Loci提供了一个简短的“安装”提示，您可以将其粘贴到以下任何代理中，之后该代理即可读取/写入大脑：

• Claude Code
• Codex
• Hermes
• 千问工作
• 豆包工作
• Qoder
• WorkBuddy

首次运行该提示时，您选择安装；后续代理只需连接到现有大脑即可。

架构概览

1. LOCI.md – 简短入口点 – 告诉代理大脑的位置以及如何获取偏好设置。
2. LOCI‑RULES.md – 完整手册 – 一套结构化的规则（任务、联系人、项目等），代理在第一次需要行动时读取一次。
3. 按需数据加载 – 仅读取请求所需的信息；整个数据集永远不会加载到内存中。
4. 仪表板（Node.js） – 在您的机器上运行的本地Web UI，无需接触代理即可查看、编辑和搜索Markdown/JSON文件。
5. 挂钩 – 可选脚本，自动注入简写偏好；如果缺少它们，代理将回退到通用入口点。

如何运行

• 前提条件：Node.js 18+、Git，以及允许代理执行文件/命令操作的本地环境。
• 无需安装npm包；存储库包含Node服务器和数据模式。
• 安装通过让代理获取并执行docs/AI‑INSTALL.md来完成。连接新工具使用docs/AI‑CONNECT.md。

数据与隐私

所有记录都保留在您的文件系统中（Markdown、JSON、附件）。您可以备份它们、与云存储同步，或自由移动它们。Loci本身不会向远程服务发送任何数据，但您使用的底层AI模型（如Claude、Codex等）仍可能根据其自身政策传输提示。

开始使用与贡献

• 完整用户指南：https://www.tryloci.com/handbook/ （或 docs/user-guide.md 中的Markdown版本）。
• 快速入门文档：docs/getting‑started.md（英文）/ docs/getting‑started.zh‑CN.md。
• API参考：docs/api.md。
• 示例大脑：examples/alex/ 显示目录布局。
• 欢迎通过Issues和Pull Requests贡献；该项目采用MIT许可证。

---

简而言之：Loci是一个轻量级的基于文件的内存层，允许多个AI代理在您自己的计算机上共享一个通用的、可编辑的知识库，并提供简单的本地仪表板供人工监督。