跳转至

代码地图

DiPECS 采用严格的”机制与策略分离”架构（详见架构概览和设计哲学）。本文档是代码仓库的导览地图，说明每个目录和文件的用途。

核心工作区 (Crates)

依赖按边界自下而上组织：aios-spec 是共同协议层，collector、core、action、agent 都保持窄职责；daemon 负责把这些能力装配成 dipecsd 长驻运行时。

aios-spec
  ├─► aios-collector
  ├─► aios-core
  ├─► aios-action
  └─► aios-agent

aios-collector ─┐
aios-core ──────┼─► aios-daemon (dipecsd)
aios-action ────┤
aios-agent ─────┘

aios-cli (独立工具入口)
  • crates/aios-spec/ src/lib.rs — 核心数据结构、Trait 接口和跨层协议。禁止业务逻辑或平台依赖
  • crates/aios-core/ src/lib.rs + src/context_builder.rs — 脱敏引擎、窗口聚合、策略引擎、ActionBus。接收 collector 输出的 RawEvent, 生成 SanitizedEvent / StructuredContext
  • crates/aios-action/ src/lib.rs — 授权动作执行层与 DefaultActionExecutor 骨架
  • crates/aios-collector/ src/lib.rs — Rust 采集层入口。对接 app 侧采集能力与后续 system 下沉来源，统一规范化并输出 CollectorEnvelope / RawEvent
  • crates/aios-agent/ src/lib.rs — DecisionRouter 与本地/云端模型后端，不含 daemon 生命周期
  • crates/aios-daemon/ src/main.rs + src/daemon.rs — daemon 二进制入口 (dipecsd)，含长期运行主循环、采集循环和完整处理管道
  • crates/aios-cli/ src/main.rs — 命令行交互工具

文档生态 (Docs)

双轨知识库体系，供工程协作与学术验收。

  • docs/src/: MkDocs Material 站点源码和公开资料。
  • design/states.md: 系统状态机核心设计文档。
  • team/dev.md: 开发者指南。
  • design/rfc/: 架构设计提案 (Request for Comments) 存放处。
  • docs/academic-src/: 未来正式学术报告的 LaTeX 源码空壳。
  • 01_Survey_Report/ 至 04_Final_Report/: 课题调研、可行性、中期及结题报告的 LaTeX 入口。
  • docs/src/academic/, docs/src/refs/, docs/src/slides/: 站点公开的学术材料、参考资料和演示材料。

脚本与工具 (Scripts)

  • scripts/android-runner.sh: 用于在 Android (NDK/API 33) 上的交叉编译部署与运行脚本。
  • scripts/check-all.sh: 核心 CI 脚本，执行格式化、Clippy 验证、构建与测试。
  • scripts/setup-env.sh: 初始化 Rust 工具链和预编译环境的脚本。

数据与测试 (Data & Tests)

  • data/traces/: 收集的离线系统轨迹数据，用于离线回放、状态机回归与验证。
  • data/evaluation/: 系统性能与准确性评估数据集。
  • tests/integration/: 跨 Crates 的集成测试用例，确保状态转移的正确性。

根目录配置文件

  • Cargo.toml: Cargo Workspace 配置文件，统筹所有 Crates。
  • rust-toolchain.toml: 锁定 Rust 版本（要求 1.95.0）及交叉编译 Target。
  • deny.toml: 依赖项审计配置，防止引入不安全的重型大体积 Crate。
  • rustfmt.toml: 全局代码格式化规范。
  • README.md & CONTRIBUTING.md: 项目门面介绍及贡献指南。