Please enable JavaScript.
Coggle requires JavaScript to display documents.
AI 守门人（MACC）+ 智能知识库（灵犀） 协同体系 - Coggle Diagram
AI 守门人（MACC）+ 智能知识库（灵犀）
协同体系
MACC 系统
AI 执行护栏与编排层
核心守卫角色
（五环模型）
Planner（规划师） — 自然语言 → 结构化 plan.json；强制读取 USER_PROFILE；后处理注入 validators（C9）
Archivist（档案员） — 任务前原子快照（git / tar.zst）；提供回滚基础与 diff 来源
Executor（执行器） — 调用 Claude CLI 走 MiniMax 执行代码；子进程隔离；指数退避重试
Gatekeeper（守门人） — 纯规则审查 diff（paths_allowed / freeze_list / 改动规模）；零 LLM
Reviewer（复核官） — 异源模型语义复核；C10 强制 validator FAIL 覆写；防自我辩护
Scribe（书记员） — O_APPEND 物理锁追加 OPERATIONS_LOG；防篡改审计
编排与管控子系统
Pipeline Orchestrator — 长时任务断点续跑（start/resume/abort）；状态持久化与崩溃恢复
RunLock（并发锁） — 基于 portalocker 的跨进程互斥；防并发冲突
Budget & HITL — MiniMax 调用预算控制；高风险任务文件闸（requires_hitl）
Cleanup Suite — 纯 SQLite 实现的安全清理（chroma_rebuild / vacuum-orphans）；A4 主进程禁 import chromadb
契约与验证体系
（Wave 1-3 成果）
单一真源契约 — kb_pipeline_contract.yaml（C1-C10 硬契约 + M1-M5 元契约）
验证器框架 — kb_id_chain / kb_batch_size / kb_trial_ledger 等机械断言
审计 CLI — macc kb-contract verify --all（AUDIT2 关门命令，AI 不可糊弄）
KB 测试框架 — macc kbtest run（T1-T10 黑盒契约巡检）
灵犀系统
目标业务与知识库
知识库核心管线
（ZIP 入库三位一体）
向量入库（Ingest） — zip_trial_pipeline.py 解压切片 + Ollama Embedding → Chroma；生成 graph_input.json
图谱提取（Graph） — graph_batch_extractor.py 调 Mac 远端模型抽取三元组；batch_size=1 防溯源断裂
一致性契约落地 — C1 三位一体 ID 交集校验；C2 向量文档级计数对等；C7 孤儿零容忍
业务与接入子系统
企业微信桥接 — bridge.js（Node）维持 WebSocket；per-user 队列；消息去重与重试
API 服务与驾驶舱 — FastAPI 提供检索/健康接口；Windows 下 MACC 只读代理接管 Chroma 统计
定时任务调度 — APScheduler 管理爬虫/日结/图谱合并；MACC 接管生命周期（lingxi-scheduler up/down）
运维与治理体系
命脉 5 终端 — Ollama / 灵犀 API / Scheduler / MACC Serve / WeCom Bridge
自检与门禁 — lingxi_doctor（6 项健康检查）；startup_gate（启动前置阻断）；release_gate（发布串联）
仓库卫生与清理 — Wave 0 仓库归零（untracked 1113→0）；A6 脏度阻断 mutating 任务
技术债与异常追踪 — tech_debt_tracker；exception_sampler（去重采样）；health_reporter 日报
架构决定与关键演进
里程碑
核心架构决定
（ADR 精选）
ADR-001 物理防护 — 能力由 Adapter 物理限制；O_APPEND 防覆盖；Reviewer 只看 diff
ADR-004/008 异源裁决 — Planner / Reviewer / Executor 分属不同模型家族或厂商
ADR-009 执行器完整性 — 不阉割 Agent 能力；MACC 靠事后护栏（Gatekeeper + Archivist）兜底
重大演进阶段
Phase 0-2 奠基 — 环境就绪、五环模型跑通、macc run 合龙
Phase A-C 外挂防护 — 灵犀知识库路径冻结（FREEZE）、内容验证器落地、长时流水线样板间
Phase D 内收接口 — 灵犀端类型强化接口占位（pending_user_unblock）
Wave 0-3 硬契约闭环 — 仓库清空 → 单一真源 yaml → 10 条契约代码化 → M5 审计关门
关键故障与修复实录
Chroma 崩溃隔离 — 主进程禁 import chromadb（A4）；改走子进程或 MACC 代理
依赖地狱与版本锁定 — numpy / huggingface_hub 降级；requirements.lock 与 dependency_matrix 落地
WeCom 消息串话与崩溃 — SessionStateStore per-user 隔离；AnswerContract chromadb 加载异常修复
多 ZIP 并发图谱超时 — 定位为 MACC 调度层并发打爆 Ollama；暂归为单 ZIP 串行策略