# Agent 框架层

`framework/` 只拥有可替换 Agent 宿主需要的执行接缝：可移植任务包、宿主适配器和框架事件归一入口。它不拥有作品、角色业务、数据库事实、额度或用户决策。

```text
framework/
├── primitives/             # FrameworkExecutionRequest/Event/Result 与工件工具
├── adapters/pi/            # Pi argv、事件流和显式扩展桥
├── adapters/dsh/           # DSH headless、session JSONL 和通用事件归一
└── adapters/claude/        # Claude Code argv 与策略（与 Pi/DSH 同消费 FrameworkExecutionRequest，见 tests/adapters/）
```

Muse 业务侧先解析角色合同、模型策略、冻结输入和输出契约，再把通用执行请求交给端口；框架适配器不直接决定创作流程，也不绕过 Muse 的证据与主权链。全仓技能发现完全由 `AGENTS.md` 与渐进式目录契约驱动，彻底废除对宿主私有目录扫描（如 `.pi/skills`、`.dsh/skills`）的物理投影依赖。

当前生产默认仍是 Pi。DSH 适配器是 opt-in 的 headless 对照接缝：它只开放无工具 fresh 任务，读取 flush 后的 append-only session 工件；可通过 `framework.adapters.dsh.load_pi_ai_route()` 复用 PI 的 provider 协议和地址，但 key 仍由当前进程环境提供。尚未形成 Muse 只读工具闭集和完整生产业务旅程接入前，不得把 DSH 当作生产宿主。