feat: v2.1 - Prompt模板独立化 + 决策日志

- 新建templates/目录,将daily_digest的System Prompt从代码中提取为独立模板文件
- 新建DECISION_LOG.md,记录架构决策和踩坑记录
- 模板与代码分离,换LLM时只需改模板文件
This commit is contained in:
Beast
2026-06-14 20:19:08 +08:00
parent 1b35dea285
commit c7e485f5de
3 changed files with 104 additions and 0 deletions

47
DECISION_LOG.md Normal file
View File

@ -0,0 +1,47 @@
# 决策日志 (Decision Log)
记录项目关键设计决策、踩过的坑、经验教训。替代智能体记忆(MEMORY.md),确保换智能体/大模型时知识不丢失。
## 架构决策
### D-2026-06-14: 卡片系统设计 — 原始素材与AI加工并行保留
**决策**每条Memos灵感生成独立`.md`卡片文件(`cards/`)AI分析结果存`ai-insights/`。两条线互不覆盖。
**原因**AI分析可能出错或失真保留原始素材确保失真可追溯。卡片文件支持Obsidian双链引用。
**替代方案**只在AI分析中引用原文被否决因为原文会被AI改写而丢失原始语境
### D-2026-06-14: 仓库拆分 — todo/brief/nav独立
**决策**:将待办系统(todo-system)、每日要闻(daily-brief)、导航页(nav-page)从灵感收集器拆分为独立仓库。
**原因**:单一仓库职责过重,拆分后各仓库独立部署、独立迭代。
**教训**:拆分前确保每个子系统的依赖关系和部署脚本同步更新,避免"拆了代码但没拆部署"。
### D-2026-06-14: Prompt模板从代码中分离
**决策**将硬编码在分析脚本中的LLM Prompt提取到`templates/`目录作为独立配置文件。
**原因**换用不同LLM时只需修改模板文件不需改代码。模板可以独立版本管理和迭代优化。
**教训**以后所有AI分析脚本的Prompt都应该从模板文件加载不要硬编码。
### D-2026-06-12: Memos API 数据获取策略
**决策**通过Memos REST API获取灵感数据而非直接读数据库。
**原因**Memos可能有数据库迁移API接口更稳定。不依赖数据库内部结构。
## 踩坑记录
### P-2026-06-13: 时区混乱
**问题**Memos返回UTC时间戳但分析脚本按北京时间解读导致"今天的灵感"实际包含昨天下午的内容。
**解决**所有时间戳统一加UTC+8转换在System Prompt中明确告知AI所有时间都是北京时间。
**预防**任何涉及时间的系统必须在文档和Prompt中明确时区约定。
### P-2026-06-13: AI分析内容过长被截断
**问题**每日灵感较多时AI返回的分析文章超过token限制被截断。
**解决**设置max_tokens=4096并在Prompt中要求"宁长勿短"的同时对超长输入做智能截断保留最近N条+摘要前N条
### P-2026-06-14: 课程分析模板硬编码在Skill中
**问题**课程学习记录的分析模板写在智能体Skill里不是仓库文件。
**解决**:待固化到`templates/course_analysis_prompt.txt`
**教训**所有分析模板都应该在仓库里有备份智能体Skill只是调用入口。
## 设计原则
1. **原始素材不可篡改** — cards/目录是只增不改的AI分析出错不影响原始数据
2. **模板与代码分离** — Prompt模板独立于代码跨模型迁移
3. **所有自动化在服务器** — cron/shell脚本不依赖智能体
4. **Gitea是唯一真相来源** — 所有产物入仓,不依赖本地文件