完成人:Atlas🐻 | 日期:2026-03-07 | 任务:虚拟办公区语音日记入口(后端)
在 09-虚拟办公区系统/app.py 第 4809 行前新增端点 POST /api/v11/diary/append。
插入位置:# ============ Changelog API ============ 注释块之前(第 4809 行附近)
端点规格:
- 路由:POST /api/v11/diary/append
- 接收:{"content": "文字内容", "timestamp": "可选"}
- 写入:BASE_DIR / "00-日记" / "YYYY-MM-DD-日记.md"(当日自动生成)
- 格式:\n\n## 🎙️ HH:MM 语音记录\n\n{content}\n
- 目录不存在时自动创建(mkdir parents=True)
- 异常捕获:app.logger.error 记录,返回 500
# 执行命令
curl -X POST http://localhost:8082/api/v11/diary/append \
-H 'Content-Type: application/json' \
-d '{"content": "测试语音日记条目——Atlas #119验收"}'
# 返回结果
{"appended": "\n\n## 🎙️ 09:18 语音记录\n\n测试语音日记条目...", "file": ".../00-日记/2026-03-07-日记.md", "success": true}
日记文件末尾确认写入:
## 🎙️ 09:18 语音记录
测试语音日记条目——Atlas #119验收
所有验收项通过:
- [x] API 返回 success: true
- [x] 日记文件正确追加带时间戳的条目
- [x] 格式符合 ## 🎙️ HH:MM 语音记录 规范
- [x] 空 content 返回 400 错误
- [x] 异常路径有 app.logger.error 保护
Flask 服务当前运行在 8082 端口(非简报中的 8080)。前端调用路径:
await fetch('/api/v11/diary/append', {
method: 'POST',
headers: {'Content-Type': 'application/json'},
body: JSON.stringify({ content: text })
});
同域调用不需要指定端口,简报中的 JS 代码可直接使用。
Atlas🐻 完成 | 2026-03-07 09:18