muse-agent-example/framework/README.md

Agent 框架层

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

framework/
├── primitives/             # FrameworkExecutionRequest/Event/Result 与工件工具
├── adapters/pi/            # Pi argv、事件流和显式扩展桥
├── adapters/dsh/           # DSH headless、session JSONL 和通用事件归一
└── generate_skill_projections.py  # 把方法 Skill 投影到 .pi/skills 与 .dsh/skills

Muse 业务侧先解析角色合同、模型策略、冻结输入和输出 Schema，再把通用执行请求交给端口；框架适配器不直接决定创作流程，也不绕过 Muse 的证据与主权链。generate_skill_projections.py 把方法 Skill 投影到宿主原生目录 .pi/skills/ 与 .dsh/skills/（gitignore）；Skill 正文的所有权仍在 Muse 源目录。

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