TraceLog 拾迹

向内运行的 AI 社交媒体，也是一台陪你成长的记忆引擎。

TraceLog 是一个本地优先的陪伴型 AI 应用。你像发朋友圈一样记录生活，几个性格各异的 AI 人格（SOUL）会来评论、和你私聊；与此同时，一台 "成长记忆引擎"在后台安静运转，把这些零散的表达沉淀成关于你的长期记忆。

出发与愿景

很多人有表达欲，却越来越不敢在真实的社交媒体上说话——怕没人看，怕被评价，怕说错。于是那些细碎的心情、小小的进展、犹豫和决定，大多没有留下痕迹。

TraceLog 想提供另一个方向的出口：向内表达。这里没有陌生人围观，只有几个始终在场、始终善意的 AI 读者。你可以随手记录，不用组织语言成"值得发"的样子。

而真正让陪伴成立的是记忆。一个每次都从零开始的 AI 只是工具；一个记得你在准备什么考试、上周搬了家、说过讨厌咖啡的 AI，才谈得上陪伴。所以 TraceLog 的核心不是聊天，而是那台记忆引擎——它让你的每一条随手记录都变成"拾迹"：被拾起、被记住、可回看的成长痕迹。

记忆引擎的三个承诺

1. 记得对：每条记忆都能追溯到你的原话；矛盾不会被粗暴覆盖，而是在私聊里自然地向你求证。
2. 有生命周期：过期的状态会淡出，反复验证的认知沉淀为画像——记忆像人的记忆一样新陈代谢，而不是无限堆积。
3. 由你掌控：记忆全部可见、可编辑、可"忘记"、可找回；私聊内容永远不会泄露给其他人格或公开场景。所有数据都在你本地。

功能一览

• Web 时间线、评论线程与 SOUL 私聊，图片附件与图片理解
• memory-v2 记忆引擎：证据 → 记忆单元 → 画像，全程可追溯
• 记忆工作台：查看、编辑、忘记、找回、控制每条记忆的使用方式
• 待办与目标抽取、混合检索（全文 + 语义）
• 全部数据存本地 SQLite，向量索引可随时重建

安装

项目统一使用 conda 环境 tracelog：

conda run -n tracelog pip install -r requirements.txt
cd frontend && npm install

运行

conda run -n tracelog python main.py        # Web（推荐）
conda run -n tracelog python main.py cli    # 终端模式

Web 前端默认 127.0.0.1:5173，API 默认 127.0.0.1:8000；端口被占用时会自动换下一个可用端口。

CLI 常用命令：

/souls                       列出人格
/soul create <name> [描述]   创建人格
/chat <soul>                 进入私聊
/comment <post_id> <soul>    进入评论对话
/quit                        退出

测试

conda run -n tracelog python -m unittest discover tests
cd frontend && npm run build

文档

• 系统概览——一分钟建立整体图景
• 架构——系统结构与记忆系统完整规格
• 数据库——表结构与事务不变量
• API——记忆工作台与其他端点