Accio 上下文知识库

一个全面的开发知识库和指南仓库，专为Accio项目设计，旨在确保整个开发团队在代码质量、架构模式和开发实践方面的一致性。

项目概述

本知识库作为Accio应用程序开发标准、架构指南和最佳实践的中心仓库。它提供结构化文档，涵盖从基础继承模式到高级缓存策略和分析实现的各个方面。

架构模式: 文档驱动开发，采用模块化规范结构 核心技术: Android SDK、iOS SDK、Web前端技术栈、Java后端技术栈、MVP/PART架构、MTOP网络框架、FastJSON、DX框架 主要特性: 全栈开发规范、分层架构规范、代码风格强制执行、记忆驱动学习系统

User Growth Agent System

The repository now includes a sophisticated User Growth Agent System located in accio-agent-task/user_growth/, which implements a multi-agent architecture for intelligent user growth services.

Key Features

• 🤖 Intelligent Agent Routing: LLM-based intent recognition and agent selection
• 🔄 Multi-modal Processing: Unified handling of text and image inputs
• ⚡ Async Streaming: Real-time SSE event streaming for immediate response
• 📊 Full-chain Monitoring: Complete execution tracking and performance analysis
• 🧵 Thread Pool Management: Custom thread pool executor for high concurrency

Architecture Documentation

• Architecture Diagram: UserGrowth_Architecture.drawio - Complete system architecture visualization
• Technical Documentation: UserGrowth_Architecture_Documentation.md - Comprehensive technical specifications

目录结构

accio-context/
├── rules/                   # 开发规范和指南
│   ├── android/            # Android开发规范
│   │   └── .cursor/
│   │       └── rules/
│   │           ├── 00-page-development-index.mdc
│   │           ├── 01-base-inheritance.mdc
│   │           ├── 02-mvp-architecture.mdc
│   │           ├── 03-part-architecture.mdc
│   │           ├── 04-network-requests.mdc
│   │           ├── 05-cache-strategy.mdc
│   │           ├── 06-analytics-tracking.mdc
│   │           ├── 07-dx-framework.mdc
│   │           ├── 08-image-loading.mdc
│   │           ├── 09-recyclerview-usage.mdc
│   │           ├── 10-router.mdc
│   │           ├── 11-dx-default-template-update.mdc
│   │           ├── accio-android.mdc
│   │           ├── async-framework-usage.mdc
│   │           ├── fastjson-usage.mdc
│   │           ├── memory-guidelines.mdc
│   │           ├── multilingual-adaptation.mdc
│   │           ├── nahida-unit-testing.mdc
│   │           └── ui-styling-rules.mdc
│   ├── iOS/                # iOS开发规范
│   │   └── .cursor/
│   │       └── rules/
│   │           ├── dynamicx-usage.mdc
│   │           ├── font.mdc
│   │           ├── image-assets.mdc
│   │           ├── learned-memories.mdc
│   │           ├── memory.mdc
│   │           ├── network.mdc
│   │           ├── objetive-c.mdc
│   │           └── user-track.mdc
│   ├── web/                # Web开发规范
│   │   └── .cursor/
│   │       └── rules/
│   │           ├── 00-page-development-index.mdc
│   │           ├── 01-project-structure.mdc
│   │           ├── 02-network-requests.mdc
│   │           ├── 03-analytics-log.mdc
│   │           ├── 04-icon.mdc
│   │           ├── 05-img.mdc
│   │           ├── 06-responsive.mdc
│   │           ├── 07-code-formatting-rules.mdc
│   │           ├── 08-dependency-architecture.mdc
│   │           ├── 09-stylelint-configuration.mdc
│   │           └── monorepo.mdc
│   ├── java/               # Java后端开发规范
│   │   └── .cursor/
│   │       └── rules/
│   │           ├── 01-overview.mdc
│   │           ├── 02-code-style.mdc
│   │           ├── 03-ddd.mdc
│   │           ├── 04-hsf.mdc
│   │           ├── 05-mybatis.mdc
│   │           ├── 06-api-standards.mdc
│   │           ├── 07-unit-testing.mdc
│   │           ├── 08-interaction.mdc
│   │           ├── async-reactive-patterns.mdc
│   │           ├── configuration-management.mdc
│   │           ├── database-tddl-patterns.mdc
│   │           ├── error-handling-patterns.mdc
│   │           ├── hsf-service-patterns.mdc
│   │           ├── logging-monitoring-patterns.mdc
│   │           ├── messaging-patterns.mdc
│   │           ├── pandora-boot-patterns.mdc
│   │           └── switch-config-patterns.mdc
│   └── common/             # 通用开发指南
│       └── .cursor/
│           └── rules/
│               ├── coding-principles.mdc
│               ├── linux-torvalds.mdc
│               ├── prd_review.md
│               ├── r2c_workflow.mdc
│               ├── readme-guidelines.mdc
│               └── ux_design.md
├── specs/                  # 产品规格和设计文档
├── technical-design/       # 技术设计文档
├── templates/              # 文档模板
├── test-cases/            # 测试用例
├── collaboration/         # 协作文档
├── tools/                 # 开发工具
├── todo/                  # 待办事项
└── README.md

关键目录用途

• rules/: 所有开发规范和指南的根目录
  • android/: 全面的Android开发规范和架构模式
  • iOS/: iOS开发规范和最佳实践
  • web/: Web前端开发规范和指南
  • java/: Java后端开发规范和架构模式
  • common/: 跨平台的通用开发指南和原则
• specs/: 产品规格和设计文档
• technical-design/: 技术架构和设计文档
• templates/: 文档模板和规范
• test-cases/: 测试用例和测试规范
• collaboration/: 团队协作文档和流程
• tools/: 开发工具和脚本
• todo/: 待办事项和任务跟踪

功能和特性

🏗️ 架构规范

• 基础继承模式: 标准化的Activity/Fragment基类选择
• MVP架构: 完整的MVP模式实现，包含presenter生命周期管理
• PART架构: 用于复杂UI的高级基于组件的架构
• 模块化设计: 分层架构，关注点清晰分离

🌐 网络和数据管理

• MTOP框架: 全面的网络请求处理和API集成
• 四层缓存策略: 内存、磁盘、数据库和网络缓存实现
• FastJSON集成: 类型安全的JSON解析和错误处理模式
• 数据模型标准: 强类型模型优于JSONObject使用

📊 用户体验和分析

• 分析跟踪: 完整的用户行为和性能跟踪系统
• 图片加载: 优化的图片加载，集成LoadableImageView
• RecyclerView标准: 使用AccioDpl框架的标准化列表实现
• DX框架: 用于灵活UI渲染的动态模板系统

🧠 记忆驱动学习系统

• 项目记忆: 常见错误及其纠正的持久存储
• 代码风格强制执行: 反模式的自动检测和预防
• 最佳实践文档: 真实世界的示例和实现指南
• 持续改进: 基于开发经验的迭代优化

🤖 User Growth Intelligence System

• Multi-Agent Architecture: Specialized agents for different types of user growth tasks
• Intelligent Routing: LLM-powered agent selection based on query intent and complexity
• Streaming Processing: Real-time SSE responses for enhanced user experience
• Performance Monitoring: Comprehensive tracking of agent performance and user interactions
• Thread Pool Management: Custom executor for high-concurrency multi-agent operations

🌍 Development Support

• Multilingual Adaptation: Guidelines for internationalization and localization
• Complex Task Processing: Structured approach to large feature development
• README Standards: Comprehensive documentation requirements and templates
• Memory Management: Efficient knowledge retention and retrieval system

开始使用

前置要求

• Android Studio Arctic Fox或更高版本
• JDK 8或更高版本
• 对Android开发概念的基本理解
• 熟悉MVP/MVVM架构模式

设置说明

1. 克隆仓库

   git clone http://gitlab.alibaba-inc.com/accio/accio-context.git
   cd accio-context

2. 与Cursor IDE集成

   • .cursor/rules/目录包含所有开发指南
   • Cursor IDE将自动加载这些规则以提供上下文感知的协助
   • 确保您的Cursor设置引用此知识库

3. 审查核心指南

   • 从android/00-page-development-index.mdc开始，了解全面概述
   • 阅读genera/project-memory.mdc了解常见陷阱和解决方案
   • 查看android/accio-android.mdc了解开发工作流程

4. 环境配置

   • 无需额外的构建配置
   • 知识库仅为文档
   • 将指南集成到您现有的Android项目工作流程中

CLI 工具使用

为了方便团队在其他项目中安装和使用这些规范，我们提供了 CLI 工具。

安装 CLI 工具

# 全局安装
npm install -g accio-context

# 或使用 npx（无需安装）
npx accio-context install

基本使用

列出可用的资源

accio-context list

交互式安装

accio-context install

这个命令会：

1. 自动从 git 仓库克隆或更新 accio-context 到 ~/.accio-context/repo
2. 显示交互式菜单，让你选择要安装的 rules、skills 和 templates
3. 将选中的资源安装到当前项目（或指定的目标目录）

交互方式：

• 使用箭头键导航
• 回车进入目录或安装文件
• 选择"返回"选项返回上一级
• 在主菜单选择"完成安装"执行实际安装

安装选项

accio-context install [options]

Options:
  -t, --target <path>    Target project path (default: current directory)
  -r, --repo <url>        Repository URL (default: auto-detect)
  -c, --config <path>     Config file (json/yaml)
  --overwrite              Overwrite existing files
  --dry-run                Show what would be copied
  --json                   Output summary as JSON

自定义仓库

默认情况下，工具会：

• 如果当前目录就是 accio-context 仓库（开发模式），使用当前目录
• 否则，克隆默认仓库到 ~/.accio-context/repo

你可以指定自定义仓库 URL：

accio-context install --repo http://gitlab.alibaba-inc.com/accio/accio-context.git

或通过环境变量设置：

export ACCIO_CONTEXT_REPO=http://gitlab.alibaba-inc.com/accio/accio-context.git
accio-context install

工作原理

1. 工具获取 accio-context 仓库（从 git 或使用本地副本）
2. 扫描可用的 rules、skills 和 templates
3. 提供交互式菜单选择要安装的内容
4. 将选中的文件复制到你的项目：
   • Rules → .cursor/rules/
   • Skills → .cursor/skills/
   • Templates → templates/

开发模式

如果你在本地开发 CLI 工具：

# 安装依赖
npm install

# 本地运行
node bin/accio-context.js install

使用指南

对于新开发者

1. 从这里开始: 阅读android/00-page-development-index.mdc了解完整的开发工作流程
2. 架构理解: 查看02-mvp-architecture.mdc和03-part-architecture.mdc
3. 常见模式: 学习project-memory.mdc了解经常遇到的问题和解决方案

对于有经验的开发者

1. 快速参考: 使用规范文件作为实现细节的快速查找
2. 代码审查: 在代码审查过程中参考指南
3. 架构决策: 在做出架构选择之前咨询相关规范文件

API文档

知识库提供以下规范：

• MTOP API集成: 完整的请求/响应处理模式
• 分析API: 用户行为跟踪和性能监控
• 缓存API: 多层缓存管理和失效
• DX框架API: 动态模板渲染和事件处理

实现细节

架构概述

知识库遵循分层规范架构：

┌─────────────────────────────────────┐
│           视图层                    │
├─────────────────────────────────────┤
│           逻辑层                    │
├─────────────────────────────────────┤
│           服务层                    │
├─────────────────────────────────────┤
│           框架层                    │
└─────────────────────────────────────┘

• 视图层: UI组件、Activities、Fragments
• 逻辑层: Presenters、ViewModels、业务逻辑
• 服务层: 数据管理器、缓存处理器、API客户端
• 框架层: MTOP、DX、分析、图片加载

数据流模式

1. 请求流: 视图 → Presenter → 服务 → 网络/缓存
2. 响应流: 网络/缓存 → 服务 → Presenter → 视图
3. 错误处理: 一致的错误传播，提供用户友好的消息
4. 分析流: 用户操作 → 分析服务 → 后端跟踪

关键设计模式

• MVP模式: 视图和业务逻辑的清晰分离
• 仓库模式: 具有多个源的统一数据访问层
• 观察者模式: 响应式数据更新和UI同步
• 工厂模式: 标准化对象创建和依赖注入
• 策略模式: 用于缓存和图片加载的可插拔算法

性能考虑

• 内存管理: 高效的对象生命周期和垃圾回收
• 网络优化: 请求批处理、缓存和重试机制
• 图片加载: 懒加载、内存池和大小优化
• 列表性能: ViewHolder模式和数据绑定优化

开发指南

代码风格标准

1. 导入管理: 始终使用import语句，不要使用完整类路径
2. 类型安全: 对于已知结构，优先使用数据类而非JSONObject
3. 错误处理: 全面的try-catch块，提供有意义的消息
4. 文档: 为复杂业务逻辑提供详细注释
5. 命名约定: 清晰、描述性的名称，遵循Android约定

测试程序

1. 单元测试: 测试presenters和services中的业务逻辑
2. 集成测试: 测试API集成和缓存行为
3. UI测试: 验证用户交互和导航流程
4. 性能测试: 监控内存使用和响应时间

最佳实践

• 记忆驱动开发: 在实现之前始终检查project-memory.mdc
• 规范合规: 在开发过程中参考相关的.mdc文件
• 代码审查: 在同行审查过程中使用指南作为检查清单
• 持续学习: 用新发现和解决方案更新记忆文件

要避免的常见陷阱

1. FastJSON误用: 不要将Android JSONObject的opt*方法与FastJSON一起使用
2. 数据覆盖: 永远不要用分布式数据覆盖原始业务数据
3. 状态管理: 使用明确的状态标志，不要依赖数据字段存在
4. 架构违规: 维护清晰的层边界和职责

开发工作流程

项目理解阶段

• 分析现有代码以理解架构和模式
• 识别关键设计模式和编码约定
• 确保与已建立的项目模式一致

需求分析阶段

• 从用户角度思考以识别实际需求
• 通过深思熟虑的讨论解决需求差距
• 选择简单有效的解决方案而非复杂方案
• 为复杂概念创建可视化图表

代码实现阶段

• 在实现之前充分规划
• 应用SOLID原则和适当的设计模式
• 使用具有明确里程碑的逐步方法
• 为重要代码块编写全面注释
• 实现适当的错误处理和监控

问题解决阶段

• 彻底分析相关代码以理解功能
• 识别根本原因而非解决症状
• 提出具有清晰推理的解决方案
• 基于反馈迭代直到问题解决
• 在记忆文件中记录解决方案以供将来参考

参考资料和资源

内部文档

• Android页面开发索引
• MVP架构指南
• 网络请求规范
• 缓存策略实现
• Web开发索引
• Java开发概览
• iOS开发指南
• 通用编码原则

外部资源

• Android架构组件
• MVP模式最佳实践
• FastJSON文档
• MTOP框架指南

开发工具

• Cursor IDE: 具有上下文感知的AI驱动开发环境
• Android Studio: 具有插件支持的主要开发IDE
• Git: 版本控制，使用约定式提交消息
• Gradle: 构建自动化和依赖管理

贡献

知识库更新

1. 为新指南遵循已建立的.mdc文件格式
2. 用新学习和解决方案更新project-memory.mdc
3. 保持与现有文档结构的一致性
4. 用真实实现示例测试指南

记忆管理

• 在记忆文件中添加新的错误和纠正
• 保持信息通用和可重用
• 使用清晰的标题和分类进行结构化
• 定期清理过时或被取代的信息

质量保证

• 验证所有代码示例都能正常工作并经过测试
• 确保文档与当前实现匹配
• 审查清晰度和可访问性
• 维护所有规范文件的一致性

本知识库基于真实世界的开发经验和团队反馈持续发展。如有问题或建议，请参考项目记忆系统或咨询开发团队负责人。