忆笔 MemoryPen

AI 驱动的回忆录创作助手 — 通过采访式对话，将人生故事转化为文学章节

快速开始

Docker（推荐）

docker compose up -d

本地开发

cp .env.example .env  # 编辑填入 API Key
pip install -r requirements.txt
uvicorn app.main:app --reload --port 8000

访问 http://localhost:8000/docs 查看 API 文档。

核心能力

功能	说明
🎙️ 引导式采访	AI 以温暖对话引导回忆，自动维护记忆档案
📝 文学化生成	将采访素材转化为小说/回忆录章节
🧠 跨会话记忆	多次采访间保持连贯，自动引用历史细节
🔄 Provider 切换	改 .env 即切模型供应商（DeepSeek/Moonshot/GLM）

三步骤流程

1. 采访 — AI 像老朋友聊天一样引导用户回忆
2. 生成 — 将对话素材转化为文学化章节
3. 阅读 — 在档案中回顾完整回忆录

技术栈

• 后端：FastAPI + aiosqlite (WAL) + Pydantic v2
• LLM：Provider 自发现架构，改环境变量即切换
• 模板：Jinja2 模板化 Prompt
• 部署：Docker + docker compose

环境变量

详见 .env.example。核心变量：

• DEFAULT_LLM — 默认模型名
• PROVIDER_DEEPSEEK_API_KEY — DeepSeek API Key
• PROVIDER_MOONSHOT_API_KEY — Moonshot/Kimi API Key
• PROVIDER_GLM_API_KEY — 智谱 GLM API Key

项目结构

memory-pen/
├── app/
│   ├── main.py           # FastAPI 入口
│   ├── config.py         # 配置管理
│   ├── database.py       # aiosqlite + WAL
│   ├── routers/          # API 路由
│   ├── models/           # 数据模型
│   ├── schemas/          # Pydantic 校验
│   ├── prompts/          # Jinja2 模板
│   └── services/         # 业务逻辑
├── Dockerfile
├── docker-compose.yml
└── .env.example

开发状态

🏗️ 比赛开发中 — SPEC v1.0 对齐进行中