软件构建、交付与运行

连接依赖、产物、检查、环境、发布、恢复和观测，并说明人和 Agent 参与的交付责任。

一个版本怎样进入环境

源码和配置描述待交付的软件，构建把它们与依赖转换成产物，发布把指定产物交给目标环境，运行反馈说明实际发生了什么。源码提交、构建成功、部署成功和用户得到可用结果，需要各自的证据。

版本身份应能连接源码、依赖、产物和环境。同一源码在不同依赖或配置下可以得到不同结果；同一个标签也可能被覆盖。锁文件、构建记录和不可变产物可以减少这种歧义，但还需说明环境输入和秘密的取得方式。

依赖图说明一个对象使用哪些接口和构建结果。共享包提供显式公开接口，消费者通过声明的依赖使用；读取另一个应用的内部源码会让维护边界与依赖声明分离。

构建任务也有图：生成契约后才能生成客户端，库产物就绪后才能构建消费方。缓存复用要求输入、输出和环境变量范围准确；遗漏输入可能复用过期结果，输出声明过宽或过窄也会影响恢复。工作区并没有自动保证任务图正确。

格式、类型、测试和构建各检查不同对象。流水线把它们组合成前置条件；实际是否有依赖，要读取工作流而非根据文件名称推测。并行能减少等待，相关任务的输入输出仍需按依赖排序。

配置决定连接目标、功能和资源。启动时校验缺失或非法配置，可以让失败出现在取得流量之前。服务器秘密与可公开构建变量需要明确边界；公开变量一旦进入产物，不能靠部署后的隐藏来收回。

本地、测试和生产环境可能使用不同数据库、网络、权限和容量。说明操作时给出目标环境和版本。验证某个环境的可用，不等于另一个环境也满足同样条件。

发布先保存待交付产物和可恢复基线，再改变目标环境，确认实际版本与关键行为。恢复软件版本需要旧产物存在；恢复数据还需要备份、模式兼容和写入边界。应用回滚成功可能仍无法读取新模式。

模式演进可以采用扩展、迁移、收缩：先增加兼容结构，再迁移读写者和数据，最后删除旧结构。每阶段需要观测、终止条件和恢复策略。迁移在多个实例启动时同时执行，会引入协调问题，应由明确的操作所有者控制。

首次部署没有旧版本，外部依赖故障也可能不由应用回滚解决。恢复动作执行过、版本已经恢复、恢复后功能正常，应分别检查。

日志记录离散事件，指标汇总数量与分布，追踪连接一次操作跨对象的路径。请求或任务关联标识让不同记录接回同一工作；单纯堆叠日志无法建立因果链。

延迟、错误和资源指标需要单位、时间窗、分母及聚合方式。平均延迟可能遮住慢请求；没有流量也可能产生“零错误”。告警应对应需要行动的条件，并能定位影响范围。

诊断信息有公开边界。令牌和个人信息需要控制，外部输入不能直接变成不可控日志内容。监控采样和丢弃也会限制能确认的事实。

使用模型生成代码后，交付责任仍围绕需求、实现、评审、验证和公开范围。规格说明目标行为、约束、禁止变化区域和完成判断；计划说明将改变哪些对象、怎样验证；diff 让实际变化可审；结果记录说明实际完成到哪里。

任务按可独立判断的边界拆分，主责任者核对接口和整合结果。子任务结论需要附依据和未知，不能以“Agent 审过”替代源码或运行证据。自动规则可以处理机械约束，人仍需判断需求、结构和证据是否匹配。

工具权限限制可产生的效果。只读研究、代码编辑、实际应用操作和外部发布应按授权范围执行。沙箱和确定性权限强制形成模型外约束，提示文本只参与决策。上下文材料可能陈旧或不可信，使用前要区分指令、输入数据和来源事实。

归档 AI-native 材料给出规格、计划、验证和上下文管理的实践线索，同时含未逐项复核的事故、比例与经验阈值。本页保留方法关系，不采用固定“可审行数”、角色工时比例或统一提速结论。代码组织研究中的产码量、发布量、使用量和自我感受也不视为同一种效能指标。

记录实际变更、目标、检查、运行观察和未完成项。旧测试、模拟环境和教学示意保留各自基线。这个版本是否公开、外部工作流是否运行、线上流量是否切换，均需要对应状态证据。

本页整合 TS 工程底座、手册、可观测、仓库协作与 AI-native 材料，建立一般交付链。具体命令属于对应实践；仓库当前命令、平台设置和授权以维护手册为事实来源。