v1.16.2

本版完善 LLM 配置管理、持久会话身份和四协议客户端请求 Profile，为规划中的 1.16.5“向 Minecraft 致敬”彩蛋版本奠定基础。

Note

1.16.1 → 1.16.2 升级说明：包含破坏性变更

LLM 配置由 config/llm.toml 迁入 data/llm_config.db，后续通过 Web Admin 或 JSON／CLI 维护，旧 TOML 作为迁移与回退材料保留。四类协议的默认请求 Profile 和模型定价方式也有变化，请按以下顺序升级。

1. 停服并备份。 停止旧 Bot 和 Web Admin，备份根 .env、config/ 与 data/。其中包含旧 LLM 配置、人格、多模态配置，以及会话和追踪数据库，作为升级与回退的依据。
2. 准备新版程序和部署配置。 更新代码、依赖及对应启动方式；容器部署同步 prod.example/ 中的初始化与挂载要求。旧配置中直接填写的认证密钥，先放入根 .env，再将配置值改为环境变量引用。
3. 初始化并迁移配置。 源码部署在项目根使用新版 Python 环境运行 python -m quickquip.llm.config_cli init；Windows 懒人包和容器的执行方式见初始化与升级。首次初始化自动迁移旧 TOML，保留源文件，并在 data/llm-config-migration/ 保存资产备份和迁移报告。已有独立人格和多模态配置继续使用；需要提取的旧内联配置写入对应文件。
4. 检查迁移结果。 查看报告，核对渠道、默认模型、人格及各渠道的模型价格。默认请求 Profile 按协议采用 OpenCode 2（Chat）、Codex（Responses）、Claude Code（Anthropic）和 Gemini CLI（Gemini）；使用手工请求体、请求头或本地模板的部署，按Profile 说明检查兼容性。初始化遇到受管字段冲突时，按迁移冲突流程处理后重试。
5. 启动并确认生效。 启动新版 Bot 和 Web Admin，确认 Bot 已加载发布配置，再在常用会话验证一次模型回复。后续配置修改需先“保存草稿”，再“应用到 Bot”，等待实际运行版本更新。模型验证按渠道计费。

定价变化： 价格按“渠道 + 模型 ID”维护。迁移会转换可归属的旧价格，并在报告中列出移除项；升级后补齐需要的价格，重新导出配置时使用新版 JSON 格式。

回退至 1.16.1： 先停止新版 Bot 和 Web，恢复 1.16.1 程序及迁移前的 TOML、人格和多模态配置。升级后修改的 LLM 配置保留在新数据库中，回退使用迁移前备份；新库到旧 TOML 的自动反向迁移未提供。

已使用 1.16.2 开发版： 配置库为 schema 1／2 的部署，需停服备份后用新版运行 python -m quickquip.llm.config_cli init --services-stopped 升至 schema 3。

回退后再次升级： 回退运行旧版本后，先停服并备份当前会话库，按再次升级步骤重置 Session 身份字段，保留消息与存档。

新增

• LLM 配置数据库：提供修订草稿、独立应用、发布快照、JSON 导入导出与预览、历史恢复和一致备份；后台展示草稿、已发布与 Bot 实际加载版本。
• 持久会话身份：聊天会话身份跨轮与重启延续，私聊归档恢复保留原会话；新建或清空会话建立新身份。
• 客户端请求 Profile：新增可编辑 TOML 模板和渠道选择，内置 QuickQuip、OpenCode 2、Codex、Claude Code 与 Gemini CLI 策略，支持请求身份、Header、Body、缓存亲和及本地覆盖。
• 会话关联追踪：HTTP 调用记录关联业务会话身份、模型调用与具体请求尝试，便于排查连续对话、重试和协议问题。
• 请求结构排障指南：集中说明配置、历史消息、工具回合、Responses 回放及 Trace 的检查方法。

变更

• 配置工作台：按渠道与模型、对话与上下文、工具与技能、报告与路由、模型价格、发布与历史组织；展示参数继承关系，支持模型探测、版本备注、导入预览及冲突反馈。
• 渠道模型定价：价格面板按渠道分组，支持从模型清单选择及复制价格；费用按实际请求模型匹配，响应中改写模型名时保持原定价。
• 四协议默认请求策略：采用对应客户端模板，默认选择与显式客户端选择共用本地覆盖；Gemini CLI 使用 Header API Key 鉴权及持久会话模型标识，提供通用兼容模板。
• 配置与资源快照：新任务使用已应用配置，进行中的任务保持开始时的模型与资源；MCP 改动后，新任务使用新连接，进行中的任务继续使用原连接。
• 响应解压：支持 Brotli 和 Zstandard 响应解码。
• 部署与教程：补齐首次启用 LLM、服务器后台访问、正则规则上线、Skill 编写及 MCP 接入的跟做步骤，提供完整练习和预期结果。
• 公开文档规范与发布审查：统一文档的读者定位、示例、生效步骤及文风要求；普通累积版本按发布专项审查核对升级、交付与集成情况。

移除

• LLM 全渠道兜底价格配置，统一按渠道与模型维护。

修复

• 修复配置编辑时对象替换或刷新造成编辑状态与选择丢失的问题；配置应用与诊断结果按 Bot 实际任务和加载状态展示。
• 修复私聊归档、清空和会话失效后，迟到工具结果进入错误会话的问题，并结束失效的工具循环。
• 修复历史消息裁剪或删除后残留失效执行记录引用，导致业务会话库升级失败的问题；升级时清理引用并保留执行记录，部署健康检查识别业务存储不可用状态。
• 修复大体积 Trace 数据库重启后首次读取调用索引缓慢的问题，为待完成记录的过期查找增加索引。
• 修复 Windows WebView 启动器的 IPv6 后台访问链接。
• 修复 Windows 首次初始化和备份 LLM 配置数据库时的文件同步错误。
• 配置 CLI 统一输出 UTF-8 JSON，修复 Windows 重定向中文结果时的编码错误。
• Windows 懒人包安装项目版本元数据，使 Bot 版本状态与请求身份使用实际发行版本。
• 私聊开启提示统一推荐 /start_session，历史拼写入口继续可用。

预置 Skill 变动

self-docs 同步配置管理、客户端 Profile、排障、公开文档规范和教程。升级后可通过 Web Admin 或 scripts/sync_preset_skills.py 更新已安装副本，覆盖前自动备份，操作见 Skill 管理。

已知限制

Trace 会随历史请求重复存储内联媒体，多模态请求较多的部署请监测追踪数据库大小；相关存储优化见 #291。真实渠道与 QQ 端到端补验按系列计划安排到 1.16.5。