一个以"桌宠"为情感与交互核心的、高度模块化和可扩展的个人桌面AI助理平台。采用"桌宠-总线"插件式架构和"包驱动Monorepo"技术栈，基于Flutter构建。
设计哲学: "是桌宠，更是应用 (A Pet, and an App)" - 桌宠为平台注入生命和情感，强大的功能模块赋予平台真正的实用价值。
- Phase 1.6 完成: 平台基础设施 ✅ (2025-06-27)
- Phase 2.0 完成: 双端自适应UI框架 ✅ (2025-06-27)
- 当前阶段: Phase 2.1 - 核心功能完善与持久化 (准备中)
- 架构: "桌宠-总线"插件式架构 + "包驱动Monorepo"
- 测试状态: 52个测试 100% 通过，零错误零警告
- 平台支持: Android/iOS、Windows/macOS/Linux、Web
-
PC端 (Windows/macOS/Linux): "空间化OS (Spatial OS)"模式
- WindowManager窗口管理系统: 支持拖拽、缩放、最小化/最大化
- FloatingWindow浮窗组件: ≥60fps流畅体验，智能边界约束
- AppDock应用程序坞: 模块启动中心，支持≤300ms快速启动
- 智能吸附系统: 15px精准吸附，专业级窗口管理体验
- DevPanel开发者工具: 实时窗口状态监控，性能数据可视化
-
移动端 (Android/iOS): "沉浸式标准应用"模式
- StandardAppShell标准外壳: Material Design 3原生体验
- 自适应导航系统: 抽屉导航+模块切换无缝体验
- 响应式布局: 完全适配移动端交互范式
- 核心系统应用: 设置中心、虚拟文件系统、创意工坊
- 初始功能应用: 事务管理中心、健康系统、打卡模块
- 长期AI集成: RAG知识库、OCR模块、n8n自动化
- 框架: Flutter 3.32.4 + Material Design 3
- 架构: "桌宠-总线"插件式架构
- 路由: go_router (声明式路由)
- 状态管理: EventBus + RxDart + Streams
- 依赖注入: get_it
- 数据层: Repository模式 + 内存存储(规划升级Drift)
- 安全: "城堡防御模型"(JWT认证 + AES加密 + 多层防护)
- core_services: 核心服务框架(Logging/Error/Performance/Module管理)
- app_config: 环境配置和特性开关系统
- app_routing: 声明式路由和导航服务
- ui_framework: Material Design 3主题和双端UI框架
- desktop_environment: ✨ 新增 - 空间化OS桌面环境
- WindowManager窗口管理系统
- FloatingWindow/AppDock/SpatialOsShell核心组件
- DevPanel开发者工具和性能监控面板
- notes_hub: 事务管理中心模块
- workshop: 创意工坊模块
- punch_in: 打卡系统模块
每个功能模块都是物理隔离的独立包，通过事件总线进行解耦通信，支持:
- 完整的模块生命周期管理
- 依赖解析和拓扑排序
- 事件驱动的状态通知
- 模块热插拔能力(规划中)
- Flutter 3.32.4+
- Dart 3.5.4+
# 获取依赖
flutter pub get
# 运行应用
flutter run
# 运行测试
flutter test本项目采用约定式提交规范：
<type>(<scope>): <中文简短描述>
[可选的详细描述]
feat: 新功能fix: Bug修复docs: 文档更新refactor: 代码重构test: 测试相关style: 格式调整
platform: 平台架构、核心基础设施core: 核心服务ui: 界面组件modules: 业务模块notes_hub: 事务中心模块punch_in: 打卡模块workshop: 创意工坊模块
test: 测试docs: 文档
git commit -m "feat(platform): 实现双端自适应UI框架"
git commit -m "fix(modules/workshop): 修复创意项目编辑功能"详细规范请参见 Decisions.md
- Phase 0 - 架构奠基 ✅
- Phase 1 - 平台骨架 ✅
- Phase 1.5 - 架构升级与i18n ✅
- Phase 1.6 - 最终收尾 ✅
- Phase 2.0 - 双端UI框架 ✅ 已完成
- 分层测试架构: 单元测试(包级) + Widget测试(组件级) + 集成测试(应用级) + 性能基准测试(NFRs级)
- platform_app应用层: 18个测试 (端到端流程验证)
- desktop_environment包: 10个测试 (WindowManager核心功能)
- ui_framework包: 11个测试 (主题和UI组件)
- app_config包: 13个测试 (配置管理系统)
- core_services基础: 已有LoggingService和ServiceLocator测试
- 总计: 52个测试用例，100%通过率，≥80%核心服务覆盖率
# 运行所有测试
flutter test
# 运行特定测试
flutter test test/core/services/
flutter test test/integration/- 静态分析:
flutter analyze(零错误零警告) - 格式化:
dart format . - 测试覆盖率: 核心功能100%覆盖
- 代码分析:
flutter analyze - 格式化:
dart format . - 交互式审查:
python final_review_gate.py
pet_app/
├── apps/platform_app/ # 主应用(平台整合)
├── packages/ # 包驱动Monorepo
│ ├── core_services/ # 核心服务框架
│ ├── app_config/ # 配置管理
│ ├── app_routing/ # 路由服务
│ ├── ui_framework/ # UI框架
│ ├── desktop_environment/ # ✨ 空间化OS桌面环境(Phase 2.0新增)
│ ├── notes_hub/ # 事务中心模块
│ ├── workshop/ # 创意工坊模块
│ └── punch_in/ # 打卡模块
├── Docs/ # API文档体系
│ └── APIs/ # 按服务分类的API文档
├── Archived/ # 历史版本归档
├── .tasks/ # 开发任务记录
├── Diagrams/ # 图表和可视化资源
├── Design.md # ✨ 设计文档(Phase 2.0新增)
└── tech_debt_review_sprint_2_0d.md # ✨ 技术债务审查报告
- ✅ Sprint 2.0a: 移动端验证与基础奠基
- ✅ Sprint 2.0b: 空间化桌面核心实现
- ✅ Sprint 2.0c: 交互深化与服务集成
- ✅ Sprint 2.0d: 质量保障与开发者工具
- 核心成果: 双端自适应UI框架、WindowManager系统、DevPanel工具、52个测试100%通过
- ✅ Sprint 1: 关键业务缺陷修复 (编辑功能、设置导航)
- ✅ Sprint 2: 核心服务建设 (Drift数据库、i18n重建)
- ✅ Sprint 3: 设置功能完善 (主题切换、语言设置、模块管理)
- 🚀 Sprint 4: 兼容性迁移+新架构验证 (当前阶段)
- 模块化基础设施建设 (脚手架工具、验证器、创意工坊MVP)
- 现有包适配层 (保持结构，添加模块接口)
- 主题系统验证案例 (第一个真正模块化实现)
- 创意工坊应用商店、插件开发框架
- 后端服务、AI模块集成、开发者生态
- 遵循约定式提交规范
- 新功能需要包含对应测试
- 更新相关API文档
- 通过所有测试和代码检查
- 参考项目发展蓝图V2.0进行功能规划
This project is licensed under the MIT License.
相关资源: