Important

This is a mirror of 114August514/DiPECS. Please contribute there.

DiPECS

DiPECS (Digital Intelligence Platform for Efficient Computing Systems) 是一个面向 Android/Linux 的 AIOS 原型。它把设备侧观测、隐私脱敏、上下文聚合、决策路由、策略审查和动作执行拆成明确边界，让本地系统保留安全和实时性，并在需要时把脱敏后的结构化上下文交给更强的推理后端。

当前代码以 v0.2 最小闭环为基线，并通过 RFC-0001 收紧采集、脱敏、决策和动作边界。更完整的架构说明见 架构概览 和 代码地图。

Status

已落地：

• aios-spec 定义 RawEvent、CollectorEnvelope、SanitizedEvent、StructuredContext、IntentBatch、CapabilityLevel 和 AuthorizedAction。
• apps/android-collector 验证 Android 用户态采集能力，并导出 JSONL trace 样本。
• aios-collector 作为 Rust 采集层入口，统一产出 CollectorEnvelope / RawEvent。
• aios-core 完成隐私脱敏、窗口聚合和策略审查。
• aios-agent 提供 DecisionRouter、RuleBasedBackend 和 FallbackNoOpBackend。
• aios-daemon 提供 dipecsd 长驻运行时。

仍在推进：

• app 到 aios-collector 的生产接入通道。
• 本地小模型和云端 LLM 后端。
• 真机动作执行和完整 Golden Trace 回归。

Architecture

flowchart TD
    App["apps/android-collector<br/>Android API capability"]
    System["daemon / system sources<br/>(later phases)"]
    Collector["aios-collector<br/>ingress + normalize"]
    Raw["CollectorEnvelope / RawEvent"]
    Core["aios-core<br/>PrivacyAirGap + WindowAggregator"]
    Context["StructuredContext"]
    Agent["aios-agent<br/>DecisionRouter"]
    Intent["IntentBatch"]
    Policy["PolicyEngine + CapabilityLevel"]
    Action["aios-action<br/>AuthorizedAction only"]
    Trace["ActionResult / Trace"]

    App -- "JSONL / JNI / socket" --> Collector
    System -- "/proc / Binder / status" --> Collector
    Collector --> Raw --> Core --> Context --> Agent --> Intent
    Intent --> Policy --> Action --> Trace

Loading

核心边界：

• apps 提供采集能力，aios-collector 负责接入与 RawEvent 规范化。
• RawEvent 不越过 PrivacyAirGap；推理层只接收 StructuredContext。
• 推理后端只能输出 IntentBatch；动作层只执行 AuthorizedAction。

Quick Start

运行 Rust 测试：

cargo test --workspace

以前台模式运行 daemon：

RUST_LOG=info cargo run -p aios-daemon --bin dipecsd -- --no-daemon

配置 Android 交叉编译：

source scripts/setup-env.sh
cargo android-release

构建 Android collector：

cd apps/android-collector
./gradlew :app:assembleDebug

完整开发命令见 开发指南，Android collector 细节见 apps/android-collector/README.md。

Repository Map

Path	Purpose
crates/aios-spec	跨层协议和 trait。
crates/aios-collector	Rust 采集层入口。
crates/aios-core	脱敏、聚合、策略审查。
crates/aios-agent	决策路由和模型后端。
crates/aios-action	授权动作执行。
crates/aios-daemon	dipecsd 运行时装配。
apps/android-collector	Android 采集能力验证工具。
docs/src	MkDocs Material 工程文档。
docs/academic-src	未来正式学术报告的 LaTeX 源码空壳。

Documentation

完整工程文档使用 MkDocs Material 管理，CI 自动部署至 GitHub Pages。

本地预览：

cd docs
uv sync                    # 首次：创建 .venv + 安装依赖
PYTHONPATH=. uv run mkdocs build        # 构建
PYTHONPATH=. uv run mkdocs serve        # 本地预览 (http://127.0.0.1:8000)

• 架构概览
• 设计哲学
• Daemon 架构
• Android 接口 MVP
• RFC 流程
• RFC-0001 分层采集与决策路由
• 学术材料
• 参考资料
• 开发指南
• 贡献指南

License

DiPECS 使用 Apache License 2.0 授权。