gliding_horse（流马）项目深度分析报告（最终版）

一、项目概览1.1 项目定位gliding_horse流马是一个用Rust编写的Agent OS智能体操作系统作者将其定位为以 CPU 架构为隐喻的智能体编排系统。项目试图将操作系统的设计理念缓存层次、进程调度、内存一致性、指令流水线引入大语言模型LLM智能体的编排中解决传统 Agent 框架在长程任务中的上下文膨胀、记忆丢失、工具滥用等问题。项目包含三个应用层gliding_codeRust CLI/TUI 工具面向个人开发者的编程助手software_engineering_single单机版软件工程 AgentGo 后端 React 前端software_engineering_team分布式团队协作版Go center Rust edge daemon Temporal 工作流引擎1.2 代码规模统计维度数量Rust 源码不含 target~32,000 行Go 源码~10,800 行TypeScript/TSX 前端~12,000 行Proto 定义~500 行Markdown 文档~4,000 行测试函数#[test]#[tokio::test]1,098 个Git 提交数94 次开发周期2026-05-26 ~ 2026-06-26约 1 个月1.3 贡献者情况贡献者提交数角色sshb_online~80主要代码实现者doiito~11博客作者/架构设计二、编译验证结果2.1 编译环境组件版本说明Rust1.96.0 (stable)rustup 安装protoc25.1手动下载安装gRPC 代码生成libclang18.1.1pip 安装oxrocksdb-sys bindgen 依赖2.2 编译验证过程与结论最新代码commit 50e1acb相比之前版本的重大改进问题之前版本最新版本状态PR-res/open-ontologies依赖缺失阻断编译内联为crates/ontologies1,646 行✅ 已解决qdrant-client外部服务依赖需要运行 Qdrant 服务替换为自研hyperspace-engine嵌入式 HNSW✅ 已解决vector_store.rs依赖 Qdrant709 行代码依赖外部服务删除替换为hyperspace_store.rs649 行embedding_service.rs292 行✅ 已解决open-ontologiesfeature 门控可选 feature依赖缺失ontologyfeature 默认启用本地 crate✅ 已解决protoc 系统依赖需要手动安装同⚠️ 常见系统依赖libclang 系统依赖需要手动安装同⚠️ 常见系统依赖编译验证结论之前版本的阻断性问题缺失依赖已全部解决。最新代码的依赖结构完全自包含不再需要外部目录或外部服务。完整cargo check未能完成。原因是oxrocksdb-sysOxigraph 的 RocksDB C 后端编译需要 30 分钟超出了单次工具调用的超时限制。这是 Rust 生态中使用 Oxigraph 的常见情况并非项目本身的问题。剩余编译前提为标准系统依赖protoc、libclang在正常 Linux 开发环境中通常已预装或可通过包管理器一键安装。代码中 qdrant 引用仅存于注释hyperspace_store.rs中的向后兼容说明PR-res 引用仅存于设计文档注释中均不影响编译。2.3 依赖结构变化之前版本: 最新版本: ┌─────────────────────┐ ┌─────────────────────┐ │ glidinghorse (main) │ │ glidinghorse (main) │ ├─────────────────────┤ ├─────────────────────┤ │ qdrant-client (外部) │ → 删除 │ hyperspace-engine │ ← 本地 crate │ PR-res/open-ontolog │ → 删除 │ ontologies │ ← 本地 crate (新增) │ vector_store.rs │ → 删除 │ hyperspace_store.rs │ ← 新模块 │ │ │ embedding_service.rs │ ← 新模块 └─────────────────────┘ └─────────────────────┘三、架构设计与实现分析3.1 核心架构PDCA 编排引擎在src/core/sa/mod.rsSupervisor Agent3,144 行中实现了完整的四阶段编排7 种任务复杂度级别Instant / Simple / Standard / Complex / Exploratory / Emergency / Recursive4 种智能体角色PAPlan/ DADo/ CACheck/ AAAct递归 PDCARecursive 级别支持 DA 内部微观递归子循环DAG 工作流支持 JSON-LD DAG 定义条件分支、重试、并行3.2 五层记忆架构层级实现代码行数说明L0l0_store.rs1,590redb 持久化MESI 缓存一致性L1l1_session.rs842上下文窗口管理cosine 相似度淘汰L2l2_blackboard.rs2,138Oxigraph 内存 RDF任务树权限矩阵L3l3_projection.rs1,259SPARQL CONSTRUCT JSON-LD Frame 投影向量hyperspace_store.rs649新增HNSW 嵌入式向量搜索替换 Qdrant3.3 HyperspaceEngine自研向量引擎最新版本的重大改进用自研的嵌入式向量引擎替换了对外部 Qdrant 服务的依赖。组件代码行数功能hnsw.rs671HNSW 近似最近邻搜索Malkov Yashunin 算法engine.rs847统一编排层open → insert → search → checkpointwal.rs535CRC32 校验的 WAL3 种同步模式metric.rs356运行时可切换度量Cosine/Poincaré/Lorentz/Euclideantangent.rs207Poincaré 球面切空间剪枝Fréchet 均值jsonld_meta.rs403JSON-LD 元数据 RoaringBitmap 倒排索引snapshot.rs196bincode 序列化快照检查点3.4 Ontologies Crate本体论引擎最新版本新增将之前缺失的open-ontologies代码内联为本地 crate。模块代码行数功能shacl.rs467SHACL 形状约束验证reason.rs531OWL 推理引擎RDFS/RL/EL 等配置文件graph.rs441SharedGraphStoreArc无 Mutexontology.rs172Turtle 验证、lint、differror.rs30错误类型四、六大子系统完整度评估4.1 感知系统Perception项目数据代码行数1,732 行测试数~20完整度~95%核心实现ProactiveEngine1,147 行实现了 10 种触发类型TaskStart/PlanCompleted/ProgressAnomaly/CheckCompleted/TaskEnd/CycleTimeout/AgentBlocked/ResourceConflict/QualityDegradation/UserFeedback含异常去重窗口、5W2H 约束检查deadline/budget、ISO8601 duration 解析、缓存淘汰LRUTTL。4.2 Batch 后台系统项目数据代码行数4,296 行测试数27完整度~90%核心实现完整流水线SlidingWindow → TriggerSystem → ExtractorPipeline → OutputValidator → KnowledgePersister含 8 个维护处理器skill_merge/fragment_refine/entity_resolution/failure_mining/skill_health/memory_compact/link_recommend/template_analyze和 12 个 prompt 模板。支持 4 种窗口类型MessageCount/TimeWindow/Hybrid/Manual和 5 种触发器WindowFull/CronSchedule/IntentShift/MessageThreshold/CustomEvent。4.3 工作区文件监控项目数据代码行数3,338 行测试数51完整度~95%核心实现5 状态文件状态机Undiscovered→Discovered→ReadFresh→ReadStale→WrittenUnread4 种读取模式Full/Diff/ChangedOnly/ForceRefreshLRUredb 版本存储快照回滚unified diff基于 similar crate.gitignore 支持notify 原生文件监听。4.4 Hook 系统项目数据代码行数1,920 行测试数12完整度~90%核心实现20 个 HookPoint 覆盖全生命周期AgentInit→AgentEnd/TaskStart→TaskEnd/LlmRequest→LlmResponse/MemoryWrite→MemoryRead/SkillBefore→SkillAfter/BlackboardWrite→BlackboardRead/PhaseStart→PhaseEnd/CycleStart→CycleEnd/McpToolCall→McpToolResult含 3 个内置 HookRateLimitHook/MetricsHook/HumanApprovalHook支持优先级排序和 Abort 控制。人工审批含超时机制和 Channel 通知器。4.5 MCP 集成项目数据代码行数1,934 行测试数15完整度~90%核心实现ServerClient 双模实现。Server 端实现 JSON-RPC 2.0 协议tools/list, tools/call, resources/list, prompts/list。Client 端支持 HTTP 和 Stdio 双传输含进程管理spawn/kill、连接回退fallback tools、工具自动注册到 SkillRegistry。skill_graph 中的 MCPIntegration 支持工具同步add/update/remove和信任级别管理。4.6 Skills 工具系统项目数据代码行数8,847 行测试数100完整度~95%核心实现36 个类型定义SkillGraphNode 含 5W2H/links/graph_meta/content/security_info/storage_tier6 种进化建议AddLink/UpdateSuccessRate/CreateFragment/Deprecate/Merge/Split6 种冲突检测ResourceAccess/DependencyCycle/PermissionOverlap/SemanticDuplicate/VersionMismatch/TemporalOrder10 种查询模板MocScan/SkillByTag/SkillByStack/SkillByRole 等渐进式 3 层加载Basic/Schema/FullPreAggregatedIndex 多维索引tag/stack/role/maturitySkillCreator 支持 LLM 生成和 Markdown 转换。4.7 汇总模块代码行数测试数完整度感知系统1,732~20~95%Batch 系统4,29627~90%工作区文件监控3,33851~95%Hook 系统1,92012~90%MCP 集成1,93415~90%Skills 工具系统8,847100~95%合计22,067225~93%五、博客宣称与代码实现一致性5.1 一致性评估博客宣称代码实现一致性PDCA 四阶段编排sa/mod.rs3,144 行完整实现✅ 一致五层记忆架构L0-L3 向量存储全部实现✅ 一致JSON-LD 数据总线jsonld/2,712 行完整实现✅ 一致技能图谱skill_graph/7,583 行完整实现✅ 一致知识图谱knowledge_graph/3,601 行完整实现✅ 一致丰田安灯绳阶段门禁methodology/gate.rs1,192 行✅ 一致MESI 缓存一致性consistency_engine.rs316 行✅ 一致双曲空间向量引擎hyperspace-engine/4,851 行✅ 一致SHACL 本体验证ontologies/shacl.rs467 行✅ 一致后台 Batch Agentbatch/4,296 行✅ 一致MCP 协议支持mcp.rsmcp_client.rs1,138 行✅ 一致工作区文件监控workspace_monitor/3,338 行✅ 一致结论博客宣称的核心功能在代码中均有真实实现一致性很高。六、客观评价6.1 正面架构设计有深度CPU 隐喻缓存层次/MESI/流水线贯穿且自洽代码实现真实不存在画饼现象所有宣称功能均有对应代码技术含量高HNSW 双曲空间 MESI JSON-LD SHACL 的组合在开源 Agent 框架中独一无二测试覆盖充分1,098 个测试在个人项目中属上乘博客与代码高度一致作者诚实描述了实现内容六大子系统均有完整实现非空壳代码每个模块都有完整功能和测试最新版本显著改进移除了外部服务依赖Qdrant内联了缺失依赖ontologies使项目完全自包含6.2 负面项目仅 1 个月远未达到生产成熟度编译时间过长oxrocksdb-sysRocksDB C编译需 30 分钟无 Docker 部署方案运维复杂度高无性能基准数据高性能组件的实际表现未知核心贡献者极少长期维护存在风险部分安全功能为占位实现签名验证verify()直接返回Ok(true)系统依赖未文档化protoc 和 libclang 的需求未在 README 中说明6.3 最终结论评估问题结论博客说的内容是否真正实现了是核心宣称均有真实代码实现一致性高实现完整度如何高核心功能完整六大子系统均有完整实现最新版本是否可以编译依赖结构已自包含剩余为标准系统依赖protoc/libclang完整 cargo check 因 RocksDB C 编译耗时而未能在单次会话中完成性能是否可以信赖未知缺少基准数据稳定性是否可以信赖尚不可信赖项目过新未经生产验证是否可以用于生产环境不可以成熟度不足 无部署方案有什么特点和值得学习的地方很多CPU 隐喻架构、PDCA 编排、MESI 记忆、双曲向量、技能图谱、SHACL 本体验证等均有学习价值