df59fc0c83523a25d5fa0d6703584e5482539171
包含从项目创建至今的全部代码首次入库: 核心框架: - 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>
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.183,rk3588=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_delivery(tasks.db) ─> developer / architect / tester
base_opt(base_opt_tasks.db) ─> 算法专项 / 调研 / 硬件优化 Agent
insight(insight_tasks.db) ─> market-pm / planner / productizer
↓ 调研结论写入 ProjectMemory
__research__.rtp.* / __research__.net.* / __research__.kernel.*
└─> Dashboard"基础技术调研"区块自动展示
__market__.{goal}.*(运动 / 适老 / AI安全)
└─> Dashboard"市场洞察"目标卡片自动更新
执行模式
| 模式 | 行为 | 飞书审批 |
|---|---|---|
auto |
直接修复 + 运行测试 | 结果摘要推送 |
confirm |
每步写操作需 claude-wx hook 审批 | 飞书卡片逐一确认 |
report |
只读分析,不修改文件 | 报告摘要推送 |
文档
- DEVELOP.md — 开发指南、架构、添加新 Agent/项目
- RELEASE.md — 变更日志
Languages
Python
79.4%
TypeScript
19.7%
Shell
0.6%
JavaScript
0.1%
CSS
0.1%