💡 知识卡片
原始会话经 LLM 提炼后的结构化知识。比原始会话更好读、更好搜。
主题
LLM Key 配置：BYOK 改服务端默认
- 现状是 BYOK 模式：浏览器 localStorage 存 API Key，经 /api/ask 传给服务器，服务器不持久化 key
- 痛点：每个员工首次使用都要在右上角 ⚙️ 手动填 Key；只有管理员知道 Key 来源，新员工不会配；key 存在用户浏览器有泄露风险
- 推荐方案：服务端环境变量 DEFAULT_LLM_API_KEY 作为默认 key，员工打开即用；localStorage 仍可覆盖以支持自带 key
- 改造成本低：ai_web_v4.py 改 5-10 行读取默认 config，docker-compose.yml 加 2 个环境变量，重启容器生效
- 备选方案 A（只改文档）：提示未配置请联系管理员，体验差但改动小
- 模型选型：MiniMax-M3（base_url https://api.minimax.chat/v1）、DeepSeek（更便宜、中文好）、通义千问 Qwen（阿里云稳定）
问答
排查知识卡片功能未生效
问题：auto_cards.py 脚本和任务计划 NAS-Auto-Cards 都已安装，但知识卡片从未生成，cards.db 数据库不存在，auto_cards.log 无任何记录。
方案：逐项排查：1) 检查 auto_cards 进程是否在运行；2) 检查 cards.db 是否存在；3) 检查 LLM 配置中 api_key 是否为空——auto_cards.py 第34行 `if not cfg.get('api_key'): return` 会直接跳过；4) 检查任务计划触发方式，当前为 At system startup 只启动一次，应改为每10分钟重复触发；5) 检查 auto_cards.log 是否有记录。修复：配置 LLM api_key（如 DeepSeek，约¥1/百万token，38个会话成本约¥0.01），并将任务计划改为每10分钟循环，或直接运行 `python auto_cards.py --daemon --interval 600`。