架构 / 代码审计

只看机制,不靠隐喻。

本页只展示当前代码审计能够支持的关系:哪些机制已经实现,哪些限制仍然存在。它不是一张未来人工生命的概念图。

组件已经实现,不代表它名称所暗示的更广泛能力已经成熟。

软件包adami-kernel 0.1.0
工程成熟度第 1 级——早期实验系统
审计日期2026-08-20
查看状态与项目

01 / 系统图

先看职责,再看流程。

第一张图按职责归纳九个公开子系统。审计只证明组件存在、没有证明通用关系的地方,不画箭头。

组件职责图按已审计职责分组,不表示通用数据流。

文字说明

经审计架构把 Kernel 归入连续性,Nexus 归入事件与感知输入,Cortex 和 Orchestrator 归入认知与规划,Hippocampus 和 SkillManager 归入记忆与能力,Peripheral 归入通道与集成。Guardian 与 Observability 提供具体支撑机制。这张图不表示它们会包围或管控每个组件。

02 / 已验证路径

事件如何进入决策。

这是审计能够确认的一条窄主路径:发布事件、生命周期接收、决策路由,再进入三类已记录的分支。

已审计主路径实线只表示代码审计已经确认的关系。
  1. 01
    外部或内部来源通道、Shell、调度器或内部发布方
  2. 02
    AdamiEvent发布到 EventBus 的 system.events 主题
    事件总线边界存在 DLQ 处理机制。
  3. 03
    LifecycleManager 消费者要求非空的 payload.task
    有界并发 · 对话级锁 · 任务持久化 · 取消 · 超时 / 预算控制
  4. 04
    DecisionProcessor在内部与队列处理后调用 SemanticIntentRouter
  5. 05
    受支持的决策分支
    • DIRECT_ANSWER直接响应路径
    • SYSTEM_ACTION受支持的系统动作分派器
    • COMPLEX_TASKTaskPlanner / WorkflowEngine → 选定的已实现工具或技能

文字说明

外部或内部来源把 AdamiEvent 发布到 EventBus 的 system.events 主题。LifecycleManager 会忽略没有任务载荷的事件,并用并发、对话级锁、任务队列、取消与超时控制处理符合条件的事件。DecisionProcessor 通过 SemanticIntentRouter 分派直接回答、系统动作或复杂任务。复杂任务可以调用 TaskPlanner 和 WorkflowEngine,再进入选定的工具或技能路径。这里不表示经验到学习的完整闭环已经成立。

03 / 路由架构

两条路径,不是两个心智。

“双脑”只是对两类技术分离的简称:有序的快速意图路由,以及独立的思考 / 动作模型列表。

“双脑”只是两类路由这个说法指意图与模型路径分离,不是两个心智。

A · 快速语义路由

  1. 1敏感 / 实时 / 强制 / 系统 / 长度规则
  2. 2快速模式
  3. 3复杂模式
  4. 4路由不明确时回退到动作模型
直接回答系统动作复杂任务 → 规划

B · 模型路径分离

思考模型按路由结果处理复杂推理与规划请求
动作模型根据路由结果处理动作型请求,并在路由不明确时承担回退判断
回退行为

云端模型调用失败时,可以回退到本地 Ollama。MLX 支持已经存在,但默认关闭,且只在启用后的 Darwin 环境中可用。

文字说明

SemanticIntentRouter 按顺序执行规则,只在路由仍不明确时调用动作模型。结果可能是直接回答、系统动作,或交给规划器的复杂任务。另一条路径由 HybridLLMRouter 分别维护思考与动作模型列表,并支持从云端回退到本地。这套架构只分离路由与计算角色,不能证明存在两个自主心智。

04 / 子系统

九个领域,进度各不相同。

这里不为整个子系统贴一个笼统标签,而是分别列出已验证机制、尚不完整的部分与开放问题。

01

持续运行

Kernel

负责系统生命周期与持续运行;认知仍在内核之外。

已实现核心生命周期已实现。

已验证机制

  • AdamiKernel
  • ComponentInitializer
  • BootManager
  • LifecycleManager
  • TaskQueueStore
  • KernelContext
  • 重启控制

如何接入已审计路径

初始化组件、协调启动,并把任务载荷不为空的事件交给生命周期与决策路径。

研究
  • 在更长运行周期和更多故障模式下,系统应如何保持连续?
核验日期2026-08-20
审计源码路径src/adami_kernel/kernel.pysrc/adami_kernel/core/
查看相关证据
02

事件 / 感知输入

Nexus

负责事件发布、通道输入与系统感知机制。

已实现实验中事件基础设施与适配器已实现。

已验证机制

  • EventBus
  • AdamiEvent 与 EventPriority
  • DLQ 行为
  • CLI
  • Telegram 与 Discord 适配器
  • 神经注册表
  • 本体感受与感知模块
  • 健康服务器
  • 脉冲 / 自主系统

如何接入已审计路径

将 AdamiEvent 对象发布到 system.events;LifecycleManager 从该主题消费包含任务的事件。

实验中
  • 适配器是否可用,仍取决于服务配置与可选运行环境。
研究
  • 如何评估更丰富的事件源,同时避免暗示主观感知?
核验日期2026-08-20
审计源码路径src/adami_kernel/nexus/
03

认知 / 路由

Cortex

负责意图路由、模型选择,并协调决策与工具调用。

已实现实验中核心路由已实现;扩展仍不完整,兼容逻辑较多。

已验证机制

  • DecisionProcessor
  • SemanticIntentRouter
  • HybridLLMRouter
  • ToolboxManager
  • JSON 提取
  • 提示词与自适应意图机制

如何接入已审计路径

DecisionProcessor 接收生命周期事件,调用 SemanticIntentRouter,再分派到直接回答、系统动作或复杂任务分支。

实验中
  • DecisionProcessor 包含模拟 / 黄金追踪分支。
  • JSON 修复未列为必需依赖。
  • 多模态导入与可选依赖较脆弱。
  • MLX 默认关闭。
  • 内置工具与注册工具的 Schema 尚未统一。
研究
  • 成熟的持续自我模型与广义智能尚未得到证明。
04

规划 / 执行

Orchestrator

把支持的复杂任务分支转为计划并交给工作流执行。

已实现实验中核心规划已实现,但诊断路径尚未接入。

已验证机制

  • TaskPlanner
  • WorkflowEngine
  • SkillComposer
  • 多智能体编排模块
  • 反思循环模块

如何接入已审计路径

COMPLEX_TASK 分支可调用 TaskPlanner 与 WorkflowEngine,后者可能选择已实现的工具或技能。

实验中
  • 启动流程没有调用 SystemDiagnostics;它还会检查 ComponentInitializer 未创建的属性。
研究
  • 开放式、无监督的长周期自主运行仍未验证。
05

记忆

Hippocampus

负责存储、检索与情景记忆相关机制。

已实现实验中记忆模块已实现;成熟的记忆生命周期仍待探索。

已验证机制

  • LayeredMemory
  • SecondBrainManager
  • SubconsciousRAG
  • EpisodicMemory

如何接入已审计路径

系统会初始化记忆组件,但审计不能证明主路径上已有完整的经验巩固闭环。

实验中
  • 评估、巩固、主动遗忘及影响未来行为的完整链路尚未得到端到端验证。
研究
  • 如何让保留的经验真正影响后续行为,而不只是被存下来?
核验日期2026-08-20
审计源码路径src/adami_kernel/hippocampus/src/adami_kernel/telemetry/experience_sink.py
查看相关证据
06

能力

SkillManager

负责加载、路由与创建技能,并管理技能生命周期元数据。

已实现实验中核心机制已实现,自测部分尚未完成。

已验证机制

  • SkillManager 与 SkillRouter
  • 加载器、工厂与生命周期
  • SKILL.md 导入器
  • Chroma 向量存储
  • SkillBuilder
  • 运行时生成技能文件约定

如何接入已审计路径

规划器与技能创建路径可以调用技能系统;验收可能依赖运行时技能文件。

实验中
  • TDD Generator 与 SelfTestRunner 集成仍是 TODO。
  • 部分验收路径依赖约定的运行时文件。
研究
  • 由经验稳定推动能力提升,尚未得到证明。
07

安全控制

Guardian

负责具体的权限、超时、限流、过滤、密钥存储与脱敏机制。

已实现实验中控制机制已实现,但不构成全面安全保证。

已验证机制

  • ImmunitySystem 超时处理
  • RBACMatrix
  • TokenBucketLimiter
  • LocalSecretVault
  • 敏感内容过滤
  • PolicyLoader
  • RedactingSpanExporter

如何接入已审计路径

各项控制用于有明确记录的边界;审计不能证明每个动作都会经过这些控制。

实验中
  • 现有证据不足以证明系统整体安全,也不足以证明策略在所有路径都会执行。
研究
  • 随着自主性增强,权限、监督与停止策略应如何扩展?
核验日期2026-08-20
审计源码路径src/adami_kernel/guardian/src/adami_kernel/policy/src/adami_kernel/observability/otel_export_policy.py
查看相关证据
08

通道 / 集成

Peripheral

承载调度、报告、外部通道、市场、控制台与协议集成。

已实现实验中集成接口已实现,提供方覆盖仍不完整。

已验证机制

  • CircadianNerve
  • Report Studio
  • last30days bridge
  • Skill Market
  • Web 控制台
  • McpManager
  • 通道适配器

如何接入已审计路径

完成配置后,适配器与调度机制可以发布事件,或支持工具与技能工作流。

实验中
  • 部分 mcp-agent 提供方路径尚未实现。
  • 各项集成依赖外部服务与可选包。
研究
  • 未来接入公开系统时,需要独立、受权限控制且只读的边界。
核验日期2026-08-20
审计源码路径src/adami_kernel/peripheral/src/adami_kernel/integration/src/adami_kernel/market/src/adami_kernel/web/src/adami_kernel/mcp/
查看相关证据
09

可观测性

Observability

负责超时上下文、追踪、脱敏、采集、重放与评估。

已实现实验中相关机制已实现,但完整测试套件仍缺少稳定证据。

已验证机制

  • ContextVar 超时预算
  • OpenTelemetry 初始化与回退
  • 遥测脱敏
  • ExperienceSink
  • 黄金样本采集
  • 重放与评估 CLI
  • AGL 兼容边界

如何接入已审计路径

这些机制服务于部分运行时与评估路径,但本身不能证明系统行为正确。

实验中
  • 审计不能证明完整测试套件能够持续通过。
研究
  • 代码库持续变化时,如何让证据保持最新?
核验日期2026-08-20
审计源码路径src/adami_kernel/observability/src/adami_kernel/telemetry/src/adami_kernel/integration/sim/src/adami_kernel/web/otel.py
查看相关证据

05 / 审计限制

已知缺口与接入限制。

这些限制都有源码依据,不藏在脚注里。明确写出缺口,比暗示不存在的能力更有价值。

实验中

DecisionProcessor 兼容分支

主要决策组件同时包含生产行为以及面向模拟和黄金追踪的硬编码分支。

查看证据
实验中

启动诊断接入

SystemDiagnostics.perform_startup_check 已存在,但经审计的启动路径没有调用它。

它还会检查 ComponentInitializer 并未创建的属性。

查看证据
实验中

可选 JSON 修复回退

解析器会探测第四阶段 json_repair 回退,但该包未声明为项目必需依赖。

查看证据
实验中

多模态依赖路径

文档、视觉与音频路径已经存在,但依赖可选包,且顶层 transformers 导入较脆弱。

没有 torch 时视觉能力受限;没有 transformers 时模块导入可能失败。

查看证据
实验中

长期目标相关机制

MetaCortex 及相关类已经存在,但审计不能证明完整的长期目标机制。

经审计实现依赖好奇心相关元素,其运行时连接尚未得到确认。

查看证据
实验中

生成技能的 TDD 与自测

SkillBuilder 仍明确保留集成 TDD Generator 与 SelfTestRunner 的 TODO。

查看证据
实验中

运行时技能验收

部分生成技能的验收路径要求仓库或运行时数据目录中存在对应技能文件。

查看证据
实验中

MLX 提供方支持

MLX 支持已经存在,但默认禁用,且仅限启用后的 Darwin 环境。

查看证据
实验中

工具 Schema 统一

注册的外部工具使用通用执行路径,内置工具使用独立方法,两套 Schema 尚未完全统一。

查看证据
实验中

MCP 提供方覆盖

MCP 管理与可选 mcp-agent 集成已经存在,但部分已配置提供方路径尚未实现。

查看证据
实验中

完整测试套件稳定性

静态审计不能证明完整测试套件在不同执行顺序与环境中都能持续通过。

查看证据

证据边界

每项声明都要有依据。

“状态与项目”页面分别列出已实现机制、实验中 / 尚不完整的工作与研究方向,也说明这次审计不能证明什么。

查看状态与项目