跳转至

代码地图

Status: Current
Last verified: 2026-07-01

本文是源码导览。历史交付、slides 和 release notes 中的模块名可能已经变化,以本页为准。

Rust Workspace

crates/
  aios-spec/       # 协议和跨层数据结构
  aios-collector/  # Android JSONL + daemon/system source ingress
  aios-core/       # privacy / context / policy / lifecycle
  aios-agent/      # decision router and backends
  aios-action/     # action adapters
  aios-daemon/     # dipecsd runtime
  aios-cli/        # replay / audit / socket tooling

依赖方向:

aios-spec
  ├─ aios-collector
  ├─ aios-core
  │   └─ aios-agent
  └─ aios-action (also depends on aios-core)

aios-collector ─┐
aios-core ──────┼─ aios-daemon
aios-agent ─────┤
aios-action ────┘

aios-cli 复用 core/agent/action 做离线 replay

aios-action 和 aios-agent 都额外依赖 aios-core(前者为了 ActionAdapter trait 和 AuthorizedAction 类型,后者为了 ModelMemoryStore、PolicyEngine 等)。其余 library-layer crates 只依赖 aios-spec。

aios-spec

文件 职责
event.rs RawEvent、CollectorEnvelope、IngestedRawEvent、source tier 和原始事件子类型。
sanitized.rs SanitizedEvent 和脱敏后的事件枚举。
context.rs StructuredContext、ContextSummary。
intent.rs IntentBatch、Intent、SuggestedAction、CapabilityLevel、DenialReason。
governance.rs ActionProposal、ActionState、AuditRecord、ActionOutcome、PolicyActionDecision。
trace.rs Golden trace / replay validation 数据结构。
bridge.rs Android localhost bridge 线协议(BridgeExecuteRequest、BridgeAuth、BridgeStatus 等),零依赖。

aios-spec 不应包含业务逻辑、平台 API 或运行时状态。

aios-collector

文件 职责
android_jsonl.rs 解析 Android CollectorEvent JSONL,tail append-only actions.jsonl。
proc_reader.rs 扫描 /proc,生成进程资源事件。
system_collector.rs 系统状态快照。
binder_probe.rs Binder/eBPF 预留接口;当前为 stub,不产生真实事件。
fanotify_monitor.rs Fanotify 文件系统监控接口;接口存在,当前未接入 daemon loop。
collection_stats.rs 按 raw event kind 统计窗口内采集数量。

aios-core

文件 职责
collector_ingress.rs 校验 external envelope,给内部 source 打 SourceTier::Daemon。
privacy_airgap.rs RawEvent -> SanitizedEvent,隐私边界。
context_builder.rs WindowAggregator,SanitizedEvent -> StructuredContext。
policy_engine.rs 逐 action 策略裁决,不构造 AuthorizedAction。
action_lifecycle.rs 唯一授权状态机,生成 AuthorizedAction 和 AuditRecord。
governance/mod.rs 私有字段 AuthorizedAction 和 ActionAdapter trait。
context_memory.rs ModelMemoryStore、ProfileSummarizer、FeedbackEngine — 从脱敏窗口和审计记录构建隐私保护模型记忆。
text_analysis.rs 文本和文件路径分析(ScriptHint、SemanticHint、ExtensionCategory),不保留原文。
action_bus.rs raw event / intent mpsc 通道封装。
trace_engine.rs Golden trace 验证。

aios-agent

文件 职责
router.rs DecisionRouter、routing reason、circuit breaker、privacy sensitivity fallback。
backends/rule_based.rs 当前默认本地规则后端。
backends/local_evaluator.rs 无云 LLM 时的中高复杂度 fallback 评估后端。
backends/fallback.rs 熔断后的 Idle + NoOp 安全后端。
backends/cloud_llm/* 可选云端 LLM 后端、provider config、HTTP client、模型输出翻译。
backends/prefetch_target.rs cloud output 到 Android prefetch target 的保守映射。

aios-action

文件 职责
lib.rs DefaultActionExecutor,纯确定性 stub,不访问网络或环境变量。
android_adapter.rs AndroidAdapter,经 localhost socket 转发 Android-safe action(HMAC、TCP 请求/响应协议)。
offline_adapter.rs replay / golden 使用的 deterministic adapter。

DefaultActionExecutor 只接收 AuthorizedAction。它不能自行 seal action。

aios-daemon

文件 职责
main.rs dipecsd 二进制入口。
lib.rs runtime 装配、collection task、processing loop、CLI/env 参数解析。
pipeline.rs process_window 和 runtime trace recorder。
daemon.rs Linux daemonize 和 signal handling。

aios-cli

文件 职责
main.rs replay、send-authorized-action、send-action CLI。
replay.rs JSONL replay、stage output、canonical audit hash。
android_bridge.rs Android socket ping/health-check。

Android App

路径 职责
storage/EventStore.kt append-only actions.jsonl 写入、导出、清理。
model/AndroidRawEventMapper.kt Kotlin 事件到 Rust RawEvent JSON shape 的映射。
collectors/UsageCollector.kt UsageStatsManager 采集。
collectors/DeviceContextCollector.kt 设备上下文采集(电量、网络、屏幕等)。
services/NotificationCollectorService.kt 通知到达/移除采集。
services/CollectorForegroundService.kt heartbeat、collector lifecycle、manual action service entry。
services/AccessibilityCollectorService.kt AccessibilityService 采集入口(screening source)。
services/ActionMaintenanceJobService.kt KeepAlive(work:*) 的 JobService 实现。
services/BootReceiver.kt 开机自启 collector。
actions/AuthorizedActionSocketServer.kt localhost action socket、token、TTL、HMAC、rate limit。
actions/ActionExecutorBridge.kt Android-side action dispatch(含 handleExecuteEnvelope / BridgeExecuteProtocol)。
actions/AccessibleContentPrefetcher.kt url:https:// / uri:content:// prefetch。
actions/ActionMaintenanceScheduler.kt KeepAlive(work:*) 的 JobScheduler 实现。
actions/CacheTrimmer.kt ReleaseMemory(cache:*) 的 app-owned file/volatile cache 清理。
actions/VolatileMemoryCache.kt #99 使用的 app-owned volatile memory cache seed/release 机制。
actions/SystemActionExecutors.kt 系统级 action 执行器(需要 platform 签名/root 时才能启用完整能力)。
actions/SystemPrewarmActivity.kt 系统预装 app / 自身资源预热 activity。
actions/SystemPrewarmActivity.kt 系统预装 app 预热 activity。
actions/UserVisibleActionNotifier.kt 用户可见动作提示(非静默执行的安全确认)。

测试脚本 (tests/scenarios)

路径 职责
action-loop-e2e.sh 动作回路模拟器 end-to-end 验证。
emulator-e2e.sh Android 模拟器端到端采集验证。
lib/action-loop-stages.sh 动作回路分阶段验证逻辑。
lib/action-loop-selftest.sh 动作回路 selftest。
lib/emulator-e2e-stages.sh 模拟器分阶段验证逻辑。
lib/emulator-e2e-selftest.sh 模拟器 selftest。
lib/action-forensic-sender.py 动作取证消息发送器(mock socket)。

数据与实验

路径 职责
data/traces/ replay / golden fixture。
data/evaluation/ 动作回路和模拟器 e2e 评估结果(.md / .ndjson 报告)。
data/schemas/ CollectorEnvelope / RawEvent 等 JSON schema。
lab4/ 课程 Lab4 llama.cpp、RPC、Ray 实验;不是 DiPECS runtime 主链路。
docs/src/ MkDocs 文档。
docs/academic-src/ LaTeX 学术报告源。