Hua/Hua.Todo
1
0
Fork 0
Code Issues Wiki Activity
Files
65cee2000635dbae4a6a9acc3771c6c7f27620f8
Hua.Todo/.trae/rules/项目/04-即时状态记忆.md
T
ShaoHua 65cee20006 docs: 重组 docs/manual/ 指南结构，区分普通用户与开发者双入口 
- 新增 00-目录与导读.md 双入口导航

- 用户面(01-04)：项目介绍、安装指南、版本记录、其他信息

- 开发者面(05-10)：技术栈、构建、架构、云同步、代码规范、MCP

- 拆分旧01为 01(用户)+05(开发者)；旧02为 02(用户)+06(开发者)

- 合并旧08+09 MCP文档为 10-MCP服务集成

- 同步更新 README.md 与 .trae/rules/项目/ 交叉引用
2026-06-16 01:46:46 +08:00

7.1 KiB
Raw Blame History

即时状态记忆（Hua.Todo 专属）

适用范围：本规则属于 项目规则（仅 Hua.Todo 项目生效）。

本文档保存"当前实现到哪一步、未完结事项、临时决策"等短期快照，用于跨会话/跨智能体快速对齐。 与 .trae/memory/ 的差别：memory 偏长期沉淀，此处偏即时状态，更新频率高。

维护要求：智能体每完成一个研发工单或观察到状态变化时，必须更新本文件的对应章节。

一、当前活跃版本

二、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 辅助 已完成（核心基础设施） 待验证 Core 接口（IVoiceInputService/IVoiceOutputService/IVoiceIntentParser）、VoiceIntent 枚举与 DTO、LLM 客户端（LlmClientService）、双策略意图解析器（LlmIntentParser + RuleIntentParser + HybridVoiceIntentParser）、VoiceCommandExecutor、AiBreakdownService、VoiceService（Dynamic API）、DI 注册；26 个单元测试通过；平台 STT/TTS 实现待补
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.Id UNIQUE 约束冲突；新增 7 个测试（含 5 个 SQLite 集成测试）

  • v1.3.0 工单01 - MCP 服务转换已完成（2026-06-16）：DynamicMcpToolExtensions 自动扫描所有 IDynamicApiService 接口并生成 MCP 工具；当前覆盖 ITaskService（9 个工具）+ IVoiceService（4 个工具）= 13 个 MCP 工具；新增 4 个测试（描述验证、InputSchema 验证、服务调用、工具调用端到端），共计 17 个测试全部通过；CloudSync 服务因未实现 IDynamicApiService 暂未覆盖，记录为已知缺口

六、最近一次重大重构（如有）

  • 术语统一与目录中文化（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 不带序号（入口文件）
  • docs/manual/ 指南重组（2026-06-16）：
    • 新增 00-目录与导读.md 双入口导航（普通用户 / 开发者）
    • 拆分用户面与开发者面：01-02 为用户安装使用；05-10 为开发者架构/构建/规范
    • 合并重叠与过时内容，精简用户文档篇幅
    • 同步更新 README.md 与 .trae/rules/项目/ 中的交叉引用

更新约定：每次智能体修改本文件时，必须更新顶部的"进行中版本"和"工单状态快照"两节，确保信息不过时。

Reference in New Issue View Git Blame Copy Permalink