ShaoHua
9223ceca50
- 规则重组：全局/ 下 8 个规则合并为 6 个（01+02→01，05+06→04），序号顺延 - 新增项目规则 05-多入口功能同步规范（UI/语音入口覆盖检查） - 新增 MCP 服务基础设施：Mcp/ 目录（DI 注册、端点扩展、动态工具描述符）、单元测试 - v1.3.0 工单文档：03 系列（会议任务拆分）、04（富文本描述与附件管理） - MCP 接口与前端集成指南：docs/manual/08、09
5.9 KiB
5.9 KiB
即时状态记忆（Hua.Todo 专属）
适用范围：本规则属于 项目规则（仅 Hua.Todo 项目生效）。
本文档保存"当前实现到哪一步、未完结事项、临时决策"等短期快照，用于跨会话/跨智能体快速对齐。 与 .trae/memory/ 的差别：memory 偏长期沉淀，此处偏即时状态，更新频率高。
维护要求：智能体每完成一个研发工单或观察到状态变化时，必须更新本文件的对应章节。
一、当前活跃版本
- 进行中版本：v1.2.0（收尾中）、v1.3.0（规划中）
- v1.2.0 研发工单总览：docs/project/研发工单-v1.2.0/00-工单总览.md
- v1.3.0 研发工单总览：docs/project/研发工单-v1.3.0/00-工单总览.md
- PRD：docs/project/产品需求文档-1.2.0.md
二、v1.2.0 工单状态快照
| 子工单 | 实现状态 | 验证状态 | 简要说明 |
|---|---|---|---|
| 01 - Linux Avalonia 入口 + WebView | 已完成 | 待验证 | WebView.Avalonia + WebView.Avalonia.Desktop；Linux 依赖 GTK + WebKitGTK |
| 02 - Linux 打包/交付 | 已落地 | 待验证 | publish-linux.ps1 产 .tar.gz；Flatpak 基础结构在 pack/linux/ |
| 02.1 - 版本统一打包 | 已落地 | 待验证 | Directory.Build.props 统一版本；Avalonia 新增 setup.iss |
| 03 - Search 关键词检索 | 已完成 | 待验证 | 主界面搜索框，按 Todo 标题包含匹配；Esc 清空；英文不分大小写 |
| 04 - 云同步 服务端基础能力 | 已完成 | 已验证 | API 契约固化；Tasks 表加 UserId 隔离；RBAC + step-up |
| 05 - 云同步 客户端配置/工作流 | 已完成 | 待验证 | 新增"云同步设置"弹窗：地址保存探测、登录/登出、登录后只读展示云端 Todo |
| 06 - 安全与可控落盘 | 未标注 | 待验证 | 框架就绪（SecurityPolicy），客户端落盘策略尚未充分覆盖 |
| 06.1 - 服务端安全设计 | 已设计 | 待实现 | Argon2id/JWT/审计日志/Admin 管理后台规划 |
| 07 - 文档同步与验收 | 进行中 | 进行中 | README/docs 已基本对齐；术语对照刚完成 |
| 08 - cloud_sync 重构 | 已设计 | 待实现 | "同源 Host"方案，Vite proxy 补 /auth /tasks /sync /security /cloud-sync |
| 09 - CloudSync 同步策略改进 | 已实现 | 待验证 | TaskEntity 继承 ABP 基类；软删除修复（SaveChangesAsync）；前端类型和 cloudSync.ts 已更新；新增 guid.ts |
三、v1.3.0 工单状态快照
| 子工单 | 实现状态 | 验证状态 | 简要说明 |
|---|---|---|---|
| 01 - HTTP 服务转换 MCP 服务 | 进行中 | 待验证 | 将现有 HTTP API 映射为 MCP 工具描述符 |
| 02 - 语音控制与 AI 辅助 | 待开始 | 待验证 | STT/TTS + 语音指令解析 + AI 辅助任务拆分 |
| 03 - 会议任务拆分 | 待开始 | 待验证 | 会议类型入口 + 录音/文字输入 + AI 拆分建议 + 确认批量创建 |
| 03-01 - 会议数据模型与 API | 待开始 | 待验证 | TaskType 枚举、MeetingNotes/AudioDuration 字段、MeetingController |
| 03-02 - 音频录制与转写 | 待开始 | 待验证 | 前端 MediaRecorder 录音 + 后端 STT 转写 |
| 03-03 - AI 任务拆分服务 | 待开始 | 待验证 | 会议专用 LLM prompt + 批量创建子任务 |
| 03-04 | 任务建议与确认 UI | 待开始 | 待验证 |
| 04 | 富文本描述、附件与外部链接 | 待开始 | 待验证 |
四、关键临时决策
- MAUI 端不暴露云同步端点：
MauiProgram.cs仅注册AddApplicationServices()，不调AddCloudSyncServer()。云同步端点只在Hua.Todo.Host暴露。 - 本地用户 ID 固定为
"local"：嵌入式模式下Tasks.UserId = TodoUserIds.LocalUserId，与云端用户隔离逻辑共存而不冲突。 - SQLite WAL 模式：嵌入式宿主启动时强制开启 WAL，降低锁冲突。
- 数据库路径：默认
LocalApplicationData/Hua.Todo/Hua.Todo.db（避免安装目录无写权限）；Host 模式使用src/Hua.Todo.Host/Hua.Todo.db（开发/测试）。
五、已知未完结事项 / 待办
- 06 客户端"内存模式"在
allowPersist=false时的端到端落盘清理（含 token、同步队列）尚未充分验证 - 06.1 设计中的 Admin 管理后台前端（位于
Hua.Todo.Host/wwwroot/admin/）当前仅有index.html占位，需 Vue 3 + Vite 实现 - 08 同源 Host 改造：
cloudClient.ts的 baseURL 解耦、Vite proxy 端点补全 - Linux Flatpak/AppImage 自包含产物在干净环境的实测验证（v1.2.0 验收 Linux 部分仍为"待验证"）
- CloudSync UNIQUE 约束修复（2026-06-14）：修复了
existingTasks查询在事务外导致并发重同步时T_Tasks.IdUNIQUE 约束冲突；新增 7 个测试（含 5 个 SQLite 集成测试）
六、最近一次重大重构（如有）
- 术语统一与目录中文化（2026-06）：
.trae/rules/全部中文文件名 + 拆分为全局/和项目/两个子目录docs/project/v1.2.0-tasks/→docs/project/研发工单-v1.2.0/，00-任务总览.md→00-工单总览.md- 在 PRD 顶部加入"研发工单 vs Todo 待办项"术语对照表
- 业务代码
Task/SubTask标识符保持不动（已固化于 API、DB、UI）
.trae子目录文件序号化（2026-06）：.trae/rules/全局/、.trae/rules/项目/、.trae/coordination/、.trae/memory/下所有文件加NN-序号前缀.trae/索引.md不带序号（入口文件）
更新约定：每次智能体修改本文件时，必须更新顶部的"进行中版本"和"工单状态快照"两节，确保信息不过时。