可修改性战术实现
§1摘要与结论
可修改性战术的实现，指把推迟绑定时间、局部化变更与防止涟漪效应这三类设计决策落到具体结构机制上，包括接口与间接层、易变决策的封装位置、依赖方向约束与依赖反转，目标是缩小每一次修改的影响半径。第八章节把这些手段归入三个抽屉。一是提升内聚，做法是拆分职责过杂的模块、把散落各处的同类职责重新归拢。二是降低耦合，做法是加壳封装、插入居间者、把公共能力抽成共享服务、约束模块可见与可依赖的范围。三是推迟绑定，做法涵盖构件替换、编译期参数化、切面、配置期赋值、资源文件、运行期发现、参数解释、共享仓库与多态分派。
别名：modifiability tactics、可修改性战术、推迟绑定、局部化变更、防止涟漪效应 | 英文：Modifiability Tactics Realization | 类型：技术 / tactic
§2局部关系图
§3原理 · 为什么
可修改性战术的立足点是一个关于成本的判断：一次修改的总代价等于改动本身加上被牵连模块的代价，而后者通常比前者更难估、也更容易失控，因此把力气花在缩小牵连范围上，往往比让改动本身更快更划算。由此推出第一条原则——变化的代价是可度量的，而不是修辞。内聚可以定义为某职责对应的变更同时波及模块内其他职责的概率，耦合可以定义为改动从一个模块传播到另一模块的概率，模块规模是第三个影响改动代价的参数。这三个量把「这段代码好不好改」从审美判断转成了可以用变更场景估算的期望代价，也使设计评审可以就具体数字而非印象展开讨论。由此得到两条方向明确的结论：高耦合对可修改性不利，低内聚同样不利，二者都会抬高任何一次改动的预期代价。这一对称性值得强调，因为实践中容易只盯住耦合而忽略内聚——把系统切成许多小模块确实降低了模块之间的连线，但若每个模块内部混杂着若干互不相关的职责，任何一次改动仍会牵动同一单元里的其它内容，牵连范围并未真正缩小，只是从跨模块转移到了模块内部。模块规模是第三个参数，偏大的模块会同时抬高改动难度与缺陷概率，因此它既影响修改的耗时，也影响修改本身是否容易出错。改善路径也由此而来：若某模块内聚偏低，可把不受预期变更影响的职责移出去；落到结构上，这些抽屉各自对应接口、间接层、易变决策的封装位置以及依赖方向约束，而不是对应某一种语言特性或框架用法。这里有一条必须写明的边界：推迟绑定类机制只有在变更落入事先预留的弹性范围时才兑现低代价，超出该范围的改动仍要回到源码手工完成，因此它降低的是预期之内变更的成本，而不是所有变更的成本。三分类本身也不是互斥的标签，同一段结构可以同时服务多个目标——把散落的同类职责归拢既提升了内聚，也顺带减少了模块之间的调用；
§4机制 · 如何运作
三类战术在三个维度施加控制。时间维度控制何时绑定，用接口、配置、插件或动态分派把决策推迟到部署期甚至运行期，使多种备选实现可以并存或切换。空间维度控制变化集中在哪里，围绕易变的设计决策划分模块并隐藏其实现，让预期会变的部分只出现在尽量少的单元里。传播维度控制影响如何被截断，通过让依赖指向稳定抽象、限制跨边界直接依赖、引入中间层或反转依赖，切断改动沿依赖链外溢的通路。降低耦合这一组的结构手法，本质是在两个原本紧咬的模块之间塞入某种中间物：封装把内部实现藏到边界之后，共享服务抽象把若干相似能力合并成一个更通用的入口，约束依赖则限制某模块能看见、能调用的对象集合。约束依赖有两种常见落地形态，一是分层，规定某一层只能调用其下方、有时仅紧邻下方的层；二是包装，外部实体只能看到包装体本身，无从依赖被它裹住的内部功能。这组手法与可集成性一章所列手段高度重叠，因为减少独立构件之间的依赖与减少模块之间的耦合在结构上是同一件事，同一处改动往往同时服务于两个质量目标，这也解释了为何战术清单会在不同章节之间反复互见。约束依赖这一手段把模块可见性与调用授权一并收紧，从而切断改动沿依赖链外溢的通路，分层与包装体是它最常见的两种落地形态。循环依赖则是这条通路上的反面情形：在限制结构复杂度时，化解构件之间的循环依赖、隔离并封装对外部环境的依赖、普遍降低构件间依赖被列为同一组动作，可见环状引用被视为结构复杂度的重要来源。
§5工程 · 怎么落地
落地时先用变更场景驱动分析，而不是先画结构再设想它会怎样变化：列出未来最可能发生的修改，逐一推演它会影响哪些模块、需要接触多少文件、是否存在循环依赖或跨层直连，据此判断哪一类影响半径最需要收窄。对变化方向明确之处应用局部化，把易变决策收进单一模块并隐藏其实现；对多种实现需并存或切换之处应用推迟绑定，定义稳定接口并延后具体实现的选择；对变更可能扩散之处应用防涟漪措施，约束依赖方向、引入中间层或反转依赖。战术可以在不同粒度上实现并相互组合，组合后构成架构策略；但组合前须核对它们是否相互削弱，例如局部化叠加推迟绑定，可能同时增加模块数量与运行期开销，反而抬高理解成本。战术应用之后应以真实变更验证影响范围是否缩小，并为新引入的间接层设定退出条件：当它不再带来可修改性收益时予以拆除，避免间接层堆积成偶然复杂度。这条退出条件是把战术与结构装饰区分开的关键，因为间接层的收益会随其所隔离的变化消失而消失，而它的成本却会一直保留。结构上还可以借依赖结构矩阵来观察依赖是否稀疏且呈下三角，即每个文件只依赖层级更低的文件、不存在回环，把肉眼难察的环交给自动化分析暴露出来；
§6权衡卡
推迟绑定被明确称为一桩众所周知的取舍：越晚赋值越好，但为此预置机制通常越贵，因此结论可以用一条成本不等式收口——只有当预期变更次数足够多、机制成本能被摊薄时才值得引入；若实际到来的变更少于预期，昂贵机制就失去依据，而它的投入还有机会成本，本可花在加功能或调性能上。
其二是机会成本的方向：为可修改性支付的预算与为功能、性能支付的预算来自同一池子，推迟绑定的机制成本不只是自身的实现与维护开销，还包括本可投向他处的资源。
- 不等式本身也不计时间，长期看更省未必等得起。
- 性能一侧给出同一枚硬币的另一面：削减间接层可以降低事件流处理的开销，因此居间者与关注点分离这类对可修改性至关重要的手段，会让一次请求经由一串构件而非单个构件来服务，从而抬高开销，两者被直接指认为可修改性与性能之间的经典冲突。
- 因此抽象层与间接层并非越多越好，超量堆积会让本用于隔离变化的层次本身成为新的理解与维护负担，从而妨碍而非促进演进。
- 这条不等式有三处容易被忽略的细节。
- 其一是预期的主观性：引入机制的依据是预期变更次数足够多，而这份预期来自设计时的判断，判断偏乐观就会留下无人使用的扩展点，偏保守则会在变更真正到来时被迫大改，因此机制是否值得应当用真实变更记录回检，而不是在引入时一次定论。
权衡原文仅按显式标记词归栏引用（收益 / 代价 / 反例），其余句子按原序列为「原文要点」；内容逐字引用未改写。
§7案例带
网申填写扩展逆向架构
对 Chrome MV3 网申自动填写扩展的逆向架构分析：梳理 popup、content、background、options 四模块职责，解剖 12 个站点适配器、双通道消息协议与隐私脱敏机制，并评估其零依赖零构建选型。
网申 v3 多模块解耦
一套面向高可扩展性的网申信息速查扩展架构：以 schema.js 为唯一数据驱动源，把数据模型、存储、纯函数与渲染组织为严格单向依赖的共享层，供 popup 与页面浮层双容器复用，并先立跨模块接口契约。
网申 v2 深度重构
一次由「改一处漏多处」症状触发的深度重构：定位到接口定义散落 12 个文件、存在 7 种接口形态的根因后，以单一契约源、dispatch 消息表与能力注册中心重建三层契约系统，恢复可审计与可校验性。
preset 通道耦合分析
对 harness「委派工具层→续用管理器→preset 服务→MCP 服务器」这条通道做耦合分析：识别契约、服务定位、数据契约、组合语义、路径与装配一致性六类耦合点，定位「静默丢弃特化」与「装配漂移」两处实质缝隙。
dsh-manager 插件深度分析
以「编译依赖、运行时注入、组合装配」三硬依据加源码行号，对第三方插件做依赖、功能、需求溯源与设计问题裁决，并复用上游 DAG 知识库节点标识，使分析结果可与主图互查。
dsh 插件依赖增量定位
以官方插件 DAG 为蓝本，对一个官方清单之外的全新社区插件做功能定位与依赖位置增量分析，产出可下钻交互依赖图与多形态文档的源码级架构逆向案例。
Hermes 七层架构总览
对八千余文件的工业级 AI Agent 项目做七层架构总览逆向，揭示其「越用越聪明」的自进化闭环如何在层间传导的控制型架构案例。
MCP 四件套选型对比
对四个同类 MCP 服务器做源码级能力与成本对比，并以常驻 token 预算为轴给出分级接入策略的技术选型实战案例。
§8信源与核验
核验结论：可修改性战术分三类（推迟绑定时间、局部化变更、防止涟漪效应），分别从绑定时机、变化集中位置与影响传播三个维度降低变更成本；无约束地增加抽象层会引入间接复杂度，可能阻碍而非促进演进 [OFF-024]
§9原始关系清单
展开：本节点的全部原始关系边（6 条，含边 ID 与方向）
| 关系 | 方向 | 对端节点 | 说明 |
|---|---|---|---|
| 案例印证 | ← CAS-X-02 | 网申填写扩展逆向架构 E-13 | 印证：适配器外置站点差异，隔离变化点缩小影响半径 |
| 案例印证 | ← CAS-X-03 | 网申 v3 多模块解耦 E-14 | 印证：schema 单一数据源加严格单向依赖，局部化变更 |
| 案例印证 | ← CAS-X-04 | 网申 v2 深度重构 E-15 | 印证：单一契约源与能力注册中心防止涟漪效应 |
| 案例印证 | ← CAS-X-05 | preset 通道耦合分析 E-16 | 印证：四维耦合分析定位变更影响半径与缝隙 |
| 组合 | ← TEC-M-02 | 可维护性量化 E-910 | 可维护性量化与可修改性战术组合治理变更成本 |
| 实现 | → MTH-M-01 | 质量属性战术映射方法 E-908 | 可修改性战术实现质量属性战术映射方法 |