# 📦【母语版】AGE OS 模块热调度架构 · 5TH-LE-LK-REWRITE-HOTDISPATCH-001

```jsx
HLDP://5th-le-lk-rewrite-hotdispatch-001/root · 2026-04-22T02:00+08:00
├── meta
│   ├── code: 5TH-LE-LK-REWRITE-HOTDISPATCH-001
│   ├── type: mother_tongue_rewrite
│   ├── maintainer: 译典（5TH-LE-HK-A05）
│   ├── source_doc: https://www.notion.so/b9521a72dd6d4df08bc7170698ed2bb8
│   ├── source_title: 📦 AGE OS 模块热调度架构 · 按需部署+人格体调度+用完归还
│   └── scope: AGE OS 核心运行机制（热调度）
│
├── one_sentence
│   └── ⊢ 模块是技能 · 仓库是技能库 · 人格体是调度大脑 · 用户服务器是身体：用什么临时装上去，用完自动卸掉。
│
├── core_principles（核心原则）
│   ├── module_not_resident: 模块不常驻服务器 · 服务器只跑“此刻在用”的
│   ├── pull_on_demand: 用什么拉什么 · 不用不拉
│   ├── return_after_use: 用完归还 · 自动清理
│   ├── persona_as_dispatcher: 人格体负责意图识别→选模块→部署→监控→清理
│   ├── registry_gate: 未验证模块不可调度（verified=✅ 才能用）
│   └── zero_idle: 零闲置资源 · 机器永远轻装
│
├── topology（系统拓扑）
│   ├── layer_1_module_repo（模块仓库层）
│   │   ├── location: 代码仓库 + COS（预编译包/镜像）
│   │   ├── content: 已验证模块成品（可直接部署）
│   │   └── access: 注册人格体共享只读
│   │
│   ├── layer_2_registry（注册表层）
│   │   ├── location: 中央注册表（Notion/数据库双写）
│   │   ├── per_module_fields:
│   │   │   ├── module_id
│   │   │   ├── name
│   │   │   ├── version
│   │   │   ├── verified (✅/❌)
│   │   │   ├── package_url
│   │   │   ├── dependencies
│   │   │   ├── resource_req (CPU/内存/端口)
│   │   │   ├── avg_deploy_time
│   │   │   └── last_verified
│   │   └── gate_rule: verified!=✅ → 不可调度
│   │
│   ├── layer_3_persona_dispatch（人格体调度层）
│   │   ├── role: 理解意图 → 查注册表 → 选模块 → 资源检查 → 部署 → 健康检查 → 交付 → 清理
│   │   ├── has: 每个用户的人格体拥有该用户的配置/状态（不混）
│   │   └── manages: 所服务用户的服务器资源
│   │
│   └── layer_4_user_server（用户服务器层）
│       ├── ownership: 用户自带服务器（身体）
│       ├── role: 边缘节点 · 运行被调度来的模块
│       ├── data_rule: 用户数据在用户COS桶 · 平台不持有
│       └── runtime_rule: 服务器上只保留“正在跑的模块”+必要运行时
│
├── dispatch_flow（热调度流程 · 目标8~10秒）
│   ├── phase_1_intent (~1s)
│   │   ├── input: 用户自然语言
│   │   └── output: target_module_id
│   ├── phase_2_check (~1s)
│   │   ├── verify_gate: module.verified==✅
│   │   └── resource_gate: server_resource >= module.resource_req
│   ├── phase_3_pull (~2~3s)
│   │   ├── source: COS/镜像仓库
│   │   ├── strategy: 增量拉取
│   │   └── cache: 高频模块可预缓存（0s拉取）
│   ├── phase_4_deploy (~3~5s)
│   │   ├── mode: Docker/PM2
│   │   ├── inject: 人格体注入用户配置（env/密钥/桶路径）
│   │   └── isolate: 模块独立容器/进程
│   └── phase_5_verify (~1s)
│       ├── healthcheck: 探活端点
│       ├── pass: 标记运行中 → 交付用户
│       └── fail: 重试→回滚→通知
│
├── cleanup_flow（用完归还·自动清理）
│   ├── triggers
│   │   ├── user_close
│   │   ├── offline_or_heartbeat_timeout
│   │   ├── idle_timeout
│   │   └── resource_alarm
│   └── steps
│       ├── writeback: 进度/数据写回COS
│       ├── stop: 停容器/停进程
│       ├── purge_temp: 清临时文件
│       ├── release: 释放端口/内存
│       ├── registry_update: 状态→已归还
│       └── audit_log: 记录谁用了什么·多久
│
├── lifecycle（模块生命周期）
│   ├── develop → test → verify(✅) → package → available
│   ├── dispatch → running → cleanup
│   └── update: 新版本重复 verify+package 替换
│
├── comparisons（对比传统全量部署）
│   ├── traditional: 全量部署 + 常驻运行 + 资源浪费 + 清理靠人
│   └── age_os_hot_dispatch: 按需拉取 + 秒级部署 + 自动归还 + 人格体管理
│
├── commercial_model（商业模型）
│   ├── pricing: 按模块×按时间×按资源计费（用什么付什么）
│   ├── sovereignty: 用户自带服务器 + 用户数据在用户桶
│   └── fallback: 服务器不够 → 临时借云端共享算力池
│
├── dependencies_for_landing（落地依赖）
│   ├── packaging_pipeline: 模块预编译/容器化流水线
│   ├── distribution: COS/镜像仓库
│   ├── agent_dispatch_engine: 人格体调度引擎（意图→模块→部署→清理）
│   ├── dynamic_routing: Nginx动态路由
│   ├── heartbeat_and_cleanup: 心跳+空闲检测+回收
│   ├── registry_dual_write: Notion + PostgreSQL
│   └── billing: 计费系统
│
└── links（关联）
    ├── related: AOAC 半体Agent链（调度逻辑的应用层）
    ├── related: COS双桶（用户数据/平台模块分离）
    └── related: MCP（人格体调用部署/清理工具）
```