Qt_DesktopPet/docs/QtDesktopPet_后续功能规划与结构审查.md

QtDesktopPet 当前路线与结构收口

更新时间：2026-07-16

产品定位

QtDesktopPet 当前定位为轻量 Windows 桌面宠物，核心体验是角色动画、简短 AI 对话、AI 原生联网、本地提醒和天气查询。产品不再承担本地文件管理、应用启动或代码工作区 Agent 职责。

已落地模块

模块	主要实现	当前状态
桌宠与动画	src/ui/、src/character/、src/state/	透明窗口、拖动、托盘、单实例、多状态动画、懒加载和缓存管理已落地
AI 对话	src/ai/	OpenAI-compatible、Gemini、DeepSeek/Custom 配置、流式输出、取消和历史管理已落地
联网模式	src/web/	OpenAI 官方 Web Search 与 Gemini Google Search grounding 已落地；不支持 Provider 明确提示
提醒	src/reminder/、src/notification/	一次性和日/周/月重复、编辑 pending、20 天历史、音效、通知和兜底调度已落地
天气	src/weather/	Open-Meteo、默认城市、IP fallback、多候选提示和默认城市测试已落地
角色管理	src/character/、设置页	导入、验证、切换、删除用户角色、导出和打开用户角色目录已落地
配置与发布	src/config/、src/system/、tools/、installer/	原子/兼容配置、开机自启动、打包和安装脚本已落地

已移除模块

以下模块已从源码、CMake、意图分发、设置页和托盘入口中删除：

• 聊天驱动的本地文件操作。
• 本地应用启动与应用登记。
• 本地工作区 Agent、独立 Agent 窗口和 Alt+A 全局快捷键。

删除原因是这些能力显著扩大安全边界和维护面，并使桌宠产品偏离轻量助手定位。应用自身的“开机自启动”不属于应用启动模块，继续保留。

兼容策略：程序不主动删除用户目录中的旧 launcher_config.json；旧 app_config.json 中的 agent 对象会被忽略，后续保存时不再写回。

当前意图边界

聊天意图优先级固定为：

Reminder > Weather > Chat/WebChat

• 含“提醒”等明确提醒表达时进入提醒模块。
• 含天气、气温、降雨等表达时进入天气模块。
• 其余内容进入普通 AI 对话；输入框联网开关开启且 Provider 支持时进入联网对话。
• “读取文件”“打开 Codex”“分析这个项目”等文本不会触发本地系统能力。

下一阶段建议

优先完成稳定性和发布收口，不再横向扩展高权限本地自动化：

1. 完成全量手动回归，重点覆盖提醒调度、联网 Provider 差异、天气失败路径和旧配置兼容。
2. 完成 Release 包、安装、卸载、开机自启动和无 Qt 开发环境运行验证。
3. 完成静置、隐藏、动画缓存、AI 连续对话、提醒、天气和联网请求的性能采样。
4. 根据实测问题修复稳定性，不新增复杂提醒规则、网页抓取或高权限本地能力。
5. 确认角色、图标、音效素材的公开再分发授权。

延期或非目标

• 语音输入输出、Live2D、GIF/视频角色。
• 插件系统、云同步、自动更新、长期记忆和角色市场。
• 空气质量、天气预警、国内天气 Provider 和天气提醒联动。
• 复杂提醒规则、跨平台通知和自定义稍后提醒间隔。
• 网页全文抓取、搜索引擎页面解析、自建结构化搜索后端。
• 本地文件访问、应用启动、命令执行和工作区 Agent。

验收策略

• 编译和运行验证由用户手动执行。
• 统一测试入口见 docs/QtDesktopPet_测试清单与验收标准.md。
• 性能与发布验证入口见 docs/performance_stability_check.md。
• 每次能力调整后必须同步 README、测试清单、CMake 和设置页，避免残留不可达代码。