念念 (Nian)

念念是一个轻量的情绪陪伴聊天 App,跟你平时用来工作的 AI 助手是分开的——单独留给你说心里话的地方。

架构:Flutter 客户端 + FastAPI 服务端。LLM 调用全部在服务端进行,客户端不持有任何 API key。

当前状态

• 服务端部署在 https://torqtac.tech:8000(systemd nian-server,Postgres 16)。
• 客户端 release 构建默认指向该地址;debug 构建默认 http://localhost:8000。--dart-define=NIAN_BACKEND_URL=... 可覆盖。
• 注册需邀请码(Phase I);聊天为 SSE 流式(Phase J);设置→高级→记忆 可查看/删除 AI 记下的事(Phase K)。
• 当前 LLM:DeepSeek V4 Flash 默认;Claude Sonnet 4.6 已接线但因预算暂未启用。

客户端运行

拉依赖

flutter pub get

Android 真机/模拟器

flutter build apk --release
adb install -r build/app/outputs/flutter-apk/app-release.apk

debug 模式连本地后端:

flutter run --dart-define=NIAN_BACKEND_URL=http://10.0.2.2:8000

测试

flutter analyze
flutter test

服务端运行

详见 server/README.md。本地起服务:

cd server
.venv/bin/uvicorn app.main:app --reload

测试:

cd server
.venv/bin/python -m pytest -q

安全

• 服务端永不持久化用户的 LLM API key(当前用户也无法 BYO,统一走服务端账户)。
• _safetyReply / safety_reply_for_language 在高风险输入下绕过 LLM 直接返回,不许削弱。
• 邀请码、登录错误统一返回不区分原因的 400,避免枚举泄露。
• server/.env 永远不提交;rsync 部署也必须 --exclude='.env'。

路线图

见 agent/phase-jklmn-roadmap.md。当前进度:Phase I/J/K 完成,Phase L(历史同步)在制。