# 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` 对象会被忽略，后续保存时不再写回。

## 当前意图边界

聊天意图优先级固定为：

```text
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 和设置页，避免残留不可达代码。