71 lines
3.8 KiB
Markdown
71 lines
3.8 KiB
Markdown
# 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 和设置页，避免残留不可达代码。
|