跨体系对照
母库 ↔ 12factor 子库逐条映射（38 行）。
§1逐条映射表
12factor 为母库首个子库/实例库，不内联进母库主 DAG；下表逐行给出 12factor 节点 ↔ 母库节点的映射与关系类型，深链直达子库节点页。
| 12factor 节点 | 关系类型 | 母库节点 | rationale |
|---|---|---|---|
| 代码库 | 跨体系对照 | DRY 单一知识来源 | 代码库作为版本控制下的单一权威来源，与母库『DRY/单一知识来源』同源 |
| 依赖 | 跨体系对照 | 封闭构建、依赖倒置与依赖规则 | 显式声明并隔离依赖对应母库『封闭构建』与『依赖倒置/依赖规则』 |
| 配置 | 跨体系对照 | 配置外置与显式化、开发生产一致性 | 母库『配置外置与显式化』与 12factor『配置』同源；配置差异是环境漂移主因 |
| 后端服务 | 跨体系对照 | 边界与接口隔离、配置外置与显式化 | 外部后端资源经窄接口隔离、经配置挂接，才可随时替换 |
| 构建·发布·运行 | 跨体系对照 | 构建发布运行分离、部署流水线 | 构建/发布/运行三阶段严格分离，对应母库同源本质与部署流水线 |
| 进程 | 跨体系对照 | 不可变基础设施、故障不可避免性与容错 | 无状态进程即以可替换的实例承载运行，对应不可变基础设施与容错 |
| 端口绑定 | 跨体系对照 | 边界与接口隔离、Kubernetes 部署编排 | 自含导出服务即边界/接口隔离；容器编排的端口暴露为其技术落地 |
| 并发 | 跨体系对照 | 可演化性与可扩展性、粒度与边界设定 | 以进程模型横向扩展对应可演化/可扩展性与粒度边界设定方法 |
| 可处置性 | 跨体系对照 | 故障不可避免性与容错、不可变基础设施 | 快速启动与优雅终止服务容错；进程视为可丢弃的不可变实例 |
| 开发/线上等价 | 跨体系对照 | 开发生产一致性、部署流水线 | 母库『开发生产一致性』与 12factor『开发/线上等价』同源 |
| 日志 | 跨体系对照 | 可观测性本质、四大黄金信号监控方法、可观测性信号采集 | 日志即事件流，对应可观测性本质、黄金信号方法与信号采集技术 |
| 管理进程 | 跨体系对照 | 部署即变更管理、容量规划与变更管理方法 | 一次性管理/维护进程属于部署即变更管理与变更管理方法范畴 |
| 自然语言→工具调用 | 跨体系对照 | 边界与接口隔离、自动化方式选择 | 自然语言→结构化工具调用是稳定的接口契约，属自动化方式选择 |
| 掌控你的 Prompt | 跨体系对照 | 配置外置与显式化、开发生产一致性 | Prompt 作为代码之外的可变部分，需外置、版本化并保持环境一致 |
| 掌控上下文窗口 | 跨体系对照 | 覆盖与精度的不对称权衡 | 上下文窗口是受限预算，取舍即母库『覆盖与精度的不对称权衡』 |
| 工具即结构化输出 | 跨体系对照 | 模块化与分解、粒度与边界设定 | 工具即可组合单元，对应模块化分解与粒度/边界设定 |
| 统一执行/业务状态 | 跨体系对照 | DRY 单一知识来源 | 执行状态与业务状态统一为单一事实源，等同母库单一知识来源 |
| 启动/暂停/恢复 | 跨体系对照 | 故障不可避免性与容错、不可变基础设施 | 启动/暂停/恢复的生命周期管理对应容错与可替换实例 |
| 工具调用联系人类 | 跨体系对照 | 干系人与需要、干系人识别与分析 | 把人类接入作为工具调用、主动寻求批准，对应干系人及其需要 |
| 掌控控制流 | 跨体系对照 | 关注点分离、自动化方式选择 | 控制流由代码决定、LLM 仅作决策点，属关注点分离与自动化方式选择 |
| 压缩错误进上下文 | 跨体系对照 | 可观测性本质、度量与反馈闭环、度量驱动的反馈闭环 | 错误压缩回上下文是可观测性本质与度量反馈闭环的具体化 |
| 小而专注的 Agent | 跨体系对照 | 模块化与分解、粒度与边界设定 | 小而专注的 Agent 对应模块化分解与细粒度单元边界 |
| 随处触发 | 跨体系对照 | 准入与触发时机选择、边界与接口隔离 | 随处触发对应准入/触发时机选择与自含入口边界 |
| 无状态 Reducer | 跨体系对照 | 不可变基础设施、DRY 单一知识来源 | 无状态 reducer 以不可变演算（state,event)→state 保持单一事实源 |
| 无状态性 | 跨体系对照 | 故障不可避免性与容错、可靠性与可用性 | 无状态性是传统应用与 Agent 共有的可靠运行基石 |
| 生命周期与可处置性 | 跨体系对照 | 故障不可避免性与容错、不可变基础设施 | 进程可处置与 Agent 可暂停恢复本质同源，指向容错与不可变实例 |
| 配置与可变性外置 | 跨体系对照 | 配置外置与显式化、开发生产一致性 | 环境变量与 prompt 同为代码之外的可变部分，对应配置外置与环境一致 |
| 可观测性与错误可见性 | 跨体系对照 | 可观测性本质、度量驱动的反馈闭环、可观测性信号采集 | 传统日志与 Agent 错误压缩共同指向可观测性与信号采集 |
| 依赖与工具显式化 | 跨体系对照 | 封闭构建、依赖倒置与依赖规则 | 显式声明依赖/工具，不隐式依赖环境，对应封闭构建与依赖倒置 |
| 控制流与阶段治理 | 跨体系对照 | 构建发布运行分离、自动化方式选择 | 确定性控制流/阶段分离保证可预测交付，对应阶段分离与自动化选择 |
| 自含入口与触达 | 跨体系对照 | 边界与接口隔离、准入与触发时机选择 | 自含导出服务与随处触发都不依赖宿主，对应边界隔离与触发时机 |
| 规模化与单元粒度 | 跨体系对照 | 可演化性与可扩展性、粒度与边界设定 | 进程模型扩展与小 Agent 组合皆单元化扩展，对应可扩展性与粒度设定 |
| 人为交互边界 | 跨体系对照 | 干系人与需要、干系人识别与分析 | 一次性管理任务与人类批准同为协作边界，对应干系人及其需要 |
| 环境一致性 | 跨体系对照 | 开发生产一致性、部署流水线 | 开发与生产一致：传统靠环境等价，对应开发生产一致性与流水线 |
| create-12-factor-agent 脚手架 | 跨体系对照 | — | 12factor Agent 官方脚手架工具，母库技术层暂无 Agent 脚手架类目，无对应节点（标注空） |
| Walkthroughgen 教程生成器 | 跨体系对照 | — | 12factor 专属教程生成器，母库无同类工程节点，无对应（标注空） |
| 官方工作坊材料 | 跨体系对照 | — | 12factor 官方工作坊材料，属子库专属资产，母库无对应（标注空） |
| 12factor.net 站点源码 | 案例印证 | 不可变基础设施、架构文档化方法 | 12factor.net 站点自身是 App 原则的参考实现（不可变静态构建）与文档化载体 |