Activity Memory System

本地化"活动感知 AI 记忆系统"：持续采集电脑使用活动 → 本地大模型总结向量化 → AI 对话时自动检索，做到"AI 记得你做过什么、了解你的工作方向"。

100% 本地运行，无外部网络依赖；开机自启，崩溃自动恢复。

快速上手

# 启动全部服务（后台守护）
D:\projects\lemon\ai\supervisor\target\release\supervisor.exe

# 查看状态
D:\projects\lemon\ai\supervisor\target\release\supervisor.exe status

# 让 AI 带着记忆对话（Web UI）
# 浏览器打开 http://127.0.0.1:8080

系统组成

组件	端口	职责
persona-proxy	8080	透明代理，自动注入猫娘人设（对话入口，彩蛋功能）
activity-logger	8082	采集窗口/输入/进程/文件活动 → 事件流 + txt 日报
memory-engine	8083	分层总结 (L1/L2/L3) → 向量入库；空闲扫描高频文件
memory-mcp	stdio	把记忆检索包装为 MCP 工具
llama-server ×2	8081/8085	Qwen3-Embedding 向量化 + Qwen2.5-7B 对话（经代理）
supervisor	—	进程守护：崩溃自动重启、开机自启

⚠️ 彩蛋说明：persona-proxy 的猫娘人设属于娱乐性质的功能（彩蛋），仅建议个人娱乐场景使用，正式场合（工作、生产、对外服务）不建议使用。关闭方法：移除 supervisor 托管并直连 8085。

能力

• 对话即记忆：模型自动调用 search_memory / get_profile 查询你的历史
• 分层记忆：15 分钟增量总结 → 每日总结 → 周报/月报 (L4) → 长期用户画像
• 文件洞察：空闲时读取高频修改文件与项目文档（白名单优先），理解你的工作内容（敏感文件自动排除）
• 模型可换：支持任何 OpenAI 兼容本地模型（Ollama/LM Studio/vLLM/llama.cpp）
• 猫娘人设（彩蛋）：对话经 persona-proxy 自动注入人设，AI 以"绒绒"的口吻与主人交流——娱乐功能，正式场合不建议使用
• 安全加固：API Key 鉴权 + 入库敏感内容过滤 + 日志按天轮转（保留 30 天）
• 无人值守：开机自启 + 崩溃自动恢复 + 指数退避防风暴
• 可测试：15 个单元测试覆盖过滤/白名单/注入/退避逻辑（cargo test）

文档

文档	内容
docs/SYSTEM.md	系统详解：架构、组件、数据流、部署、运维、FAQ
docs/API.md	接口参考：REST / OpenAI / MCP 全部端点与示例

常用命令

# 语义问答（向量检索 + AI 回答）
memory-engine.exe query 我最近在做什么

# 手动触发高频文件扫描
memory-engine.exe scan

# 服务管理
supervisor.exe status    # 状态
supervisor.exe stop      # 停止全部
supervisor.exe install   # 注册开机自启
supervisor.exe uninstall # 移除自启

项目结构

activity-logger\   采集器 (Rust)
memory-engine\     记忆引擎 (Rust)
supervisor\        进程守护 (Rust)
docs\              文档

系统要求

• Windows 10/11 x64
• NVIDIA GPU（CUDA 12.4+，8GB 显存）或纯 CPU
• 磁盘：模型 ~5GB + 数据若干

许可证

GNU Affero General Public License v3.0 (AGPL-3.0)

本项目基于 AGPL-3.0 授权。如果你修改本项目并提供网络服务，需以 AGPL-3.0 开源你的修改版本（见许可证第 13 节）。