产品骨架(Product Skeleton) 产品与架构
别名:
v01 快照
把阶段一拆好的零件组装成可运行、可演进的产品所需的框架:拼装、配置、日志、分层四样缺一不可。ch15–ch23 将在这套代码上逐章演进。见[第 14 章](/chapters/14-product-v01-cli/)。
它是什么
产品骨架(Product Skeleton)是把阶段一拆好的零件组装成可运行、可演进的产品所需的框架。零件不是产品:demo 之间参数各写各的、没有统一入口、没有日志、没有退出处理,更没有可长期演进的代码骨架。从零件到产品,隔着四样东西——拼装(零件接线)、配置(环境变量 + 默认值)、日志(trace 可见性)、分层(core 与界面解耦、依赖单向),缺一不可。
v01 快照
它是产品的 v01 快照:一个能对话、能查天气/时间/算数、能看清自己在干什么的 CLI Agent。代码组织为 core 四模块(config 参数 / provider 传输 / tools 注册表 + 错误协议 / loop 主循环)+ 界面层 cli(组合根)。ch15–ch23 将在这套代码上逐章演进——服务化换一个界面(server)、断线恢复加一层存储、Web 前端加一个消费方,core 一行不改。
在本教程的位置
第 14 章是阶段二「装配整机」的起点;后续每一章在它上面加一个能力并保留可运行快照(v02 事件协议、v03 断线恢复……),读者可对比任意两个版本之间的 diff。