Files
nmfs-agents/README.md
T
qiuruiandClaude Sonnet 4.6 df59fc0c83 feat: NMFS Agents 全量入库(org v2 + dashboard + 多队列 + 组织架构)
包含从项目创建至今的全部代码首次入库:

核心框架:
- TaskQueue(SQLite,6 种状态,原子 dequeue)
- Executor(asyncio 并发,semaphore 限流,agent_role 路由)
- Scheduler(APScheduler,三队列独立调度)
- Watchdog(超时检测 + 优先级防饥饿)
- Scanner(项目扫描,README/TODO/CLAUDE.md 提取)

Agent 体系(20+ 角色):
- 项目交付组:architect/developer/tester/productizer
- 基础技术组:base-architect/validator/hw/os/kernel/lowlevel/system-tester
- 算法组:algo-antishake/position/nav
- 洞察组:planner/vision-analyst/media-producer
- 市场组:market-pm/sport/elder/safety
- 组织层:boss/group-leader/senior-dev/ops
- 平台扩展:nrf-dev/esp32-dev
- 三专项调研:rtp-researcher/net-researcher/kernel-analyzer

工具层:
- ProjectMemory(goals/facts/history SQLite)
- VersionPipeline(并行版本流水线 + 反幻觉门控)
- EventBus(Redis Streams,5 consumer groups)
- DailyReport(append-only 日报 + Boss 决策视图)
- AgentScorer(4 维评分:完成度/质量/自主性/协作)
- DeviceAgent(SSH rsync + 板端执行)
- EnvCollector(本机+SSH 环境采集)
- ArchVersion(快照/优化/promote/rollback)

Dashboard(React + Vite + Tailwind):
- 看板/项目/配置/洞察/日报/Visual 六标签页
- WebSocket 实时更新
- Markdown 渲染(react-markdown + remark-gfm)

测试:314 passed

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-03-10 07:24:19 +08:00

7.4 KiB
Raw Blame History

NMFS Agents

基于 Claude CLI 的 AI 项目自动化维护与调研系统,运行在 RK3588 NPU 开发平台上。 支持代码修复、板端测试、成熟度评估、架构整合、市场洞察与基础技术调研。

组织架构

AI 自动化平台
│
├── 基础技术组(base_opt + project_delivery 队列)
│   ├── 架构设计   base-architect   — 平台架构整合,跨组技术决策
│   ├── 架构验证   base-validator   — 基准测试,架构方案验证
│   ├── 硬件工程   hw-engineer      — 硬件选型,功耗/算力权衡
│   ├── OS 系统    os-engineer      — 内核参数,驱动框架
│   ├── 内核开发   dev-kernel       — 驱动开发,DTS/BSP
│   ├── 底层开发   dev-lowlevel     — 嵌入式固件,硬件 bring-up
│   ├── 系统测试   system-tester    — 集成测试,端到端验证
│   ├── 算法专项
│   │   ├── algo-antishake   防抖算法(IMU/滤波/卡尔曼)
│   │   ├── algo-position    定位算法(GNSS/视觉里程计)
│   │   └── algo-nav         导航算法(路径规划/避障)
│   └── 技术专项(架构师/高级研发,有独立专项记忆)
│       ├── rtp-researcher   — RTP/RTCP 实时传输协议(__research__.rtp.*
│       ├── net-researcher   — 网络栈优化调研(__research__.net.*
│       └── kernel-analyzer  — 内核调度分析(__research__.kernel.*
│
├── 项目交付组(project_delivery 队列,1h 扫描)
│   ├── architect   — 跨项目架构分析,技术债识别
│   ├── developer   — 代码修复/重构(含 dev-refactor/dev-embedded
│   └── tester      — 本地 pytest + 板端 SSH 测试
│
└── 产品洞察组(insight 队列,6h 扫描)
    ├── planner       — 差距分析,洞察任务规划
    ├── productizer   — 成熟度评估(100分制,规则引擎)
    ├── market-pm     — 市场分析,竞品调研,众筹追踪
    ├── vision-analyst   — 视觉效果分析,截图回归
    └── media-producer   — 技术内容生产

人员矩阵

角色 所属组 队列 memory goals memory facts 设备访问 主要项目
base-architect 基础技术 base_opt W W 跨平台架构
base-validator 基础技术 base_opt R W rk3566/rk3588 算法验证
hw-engineer 基础技术 base_opt R W 硬件设计
os-engineer 基础技术 base_opt R W rk3566/rk3588 OS 调优
dev-kernel 基础技术 base_opt R W rk3566/rk3588 内核驱动
dev-lowlevel 基础技术 base_opt R W rk3566/rk3588 嵌入式固件
system-tester 基础技术 base_opt R W rk3566/rk3588 集成测试
algo-antishake 基础技术 base_opt R W rk3566(默认) algo-base
algo-position 基础技术 base_opt R W rk3566(默认) algo-base
algo-nav 基础技术 base_opt R W rk3566(默认) algo-base
rtp-researcher 基础技术 project_delivery R W rtp-research
net-researcher 基础技术 project_delivery R W net-research
kernel-analyzer 基础技术 project_delivery R W kernel-analysis
architect 项目交付 project_delivery W W 全项目
developer 项目交付 project_delivery R R 全项目
tester 项目交付 project_delivery R R rk3566/rk3588 全项目
planner 产品洞察 insight R W insight
productizer 产品洞察 insight W W 全项目
market-pm 产品洞察 insight R W 市场调研
vision-analyst 产品洞察 insight R W rk3566/rk3588 视觉验证
media-producer 产品洞察 insight R R 内容输出

W=可写 R=只读 ─=不访问 | 设备栏:rk3566=192.168.123.183rk3588=192.168.123.181

托管项目

项目 路径 模式 主要负责组
yolo /data/company/yolo confirm 项目交付
mediapipe /data/company/mediapipe auto 项目交付
embedding /data/company/embedding report 项目交付
info-privacy /data/company/info-privacy confirm 项目交付
logodetect-x86 /data/company/logodetect-x86 auto 项目交付
rtp-research /data/company/os-base/rtp-research auto 调研
net-research /data/company/os-base/net-research auto 调研
kernel-analysis /data/company/os-base/kernel-analysis auto 调研
claude-wx /data/company/claude-wx auto 项目交付
ui-tars /data/company/ui-tars auto 基础技术

快速开始

python3.10 -m venv venv && source venv/bin/activate
pip install -e ".[dev]"
claude login                        # CLI OAuth 认证
bash scripts/start_daemon.sh        # 启动多队列调度器
python scripts/run.py status        # 查看任务状态

工作原理

系统有两条触发路径,均汇入同一个三队列执行引擎:

┌─ Web Dashboard(主操作入口,http://localhost:9080)────────────────────────┐
│  提交需求(修复/重构/文档)  →  project_delivery 队列  →  developer/architect│
│  技术攻关(RTP/网络/内核)   →  base_opt 队列          →  专项研究 Agent     │
│  触发市场洞察                →  insight 队列           →  market-pm/planner  │
│  刷新项目指导(CLAUDE.md   →  project_delivery 队列  →  architect 分析写入 │
└────────────────────────────────────────────────────────────────────────────┘

┌─ APScheduler(定时自动)───────────────────────────────────────────────────┐
│  Scanner 扫描 README/TODO/CLAUDE.md → 自动入对应队列(1h/6h 间隔)          │
└────────────────────────────────────────────────────────────────────────────┘

                         ↓ 三队列并发执行

project_deliverytasks.db  ─> developer / architect / tester
base_optbase_opt_tasks.db ─> 算法专项 / 调研 / 硬件优化 Agent
insightinsight_tasks.db   ─> market-pm / planner / productizer

                         ↓ 调研结论写入 ProjectMemory

__research__.rtp.*   / __research__.net.*   / __research__.kernel.*
  └─> Dashboard"基础技术调研"区块自动展示

__market__.{goal}.*(运动 / 适老 / AI安全)
  └─> Dashboard"市场洞察"目标卡片自动更新

执行模式

模式 行为 飞书审批
auto 直接修复 + 运行测试 结果摘要推送
confirm 每步写操作需 claude-wx hook 审批 飞书卡片逐一确认
report 只读分析,不修改文件 报告摘要推送

文档