附录 D：核心模块代码索引
本附录是各章「实现剖析」小节的取材索引：给出所摘代码的源模块、关键符号与所印证的原理，便于读者从书回到代码。索引只列正文真正摘取或明确点名的模块，不把"框架有什么"写成"书讲了什么"。
行数口径：正文各「实现剖析」小节标注的模块行数均为非空行数（不含空行，含注释与文档字符串），即
wc -l结果减去空行数。
表 D-1 章节 ↔ 模块 ↔ 关键符号映射
| 章 | 实现剖析小节 | 源模块 | 关键符号 | 印证原理 |
|---|---|---|---|---|
| 第 2 章 | 2.7 适配层契约、工厂与字段映射 | integrations/__init__.py、integrations/field_mapping.py |
BaseERPAdapter、get_adapter、get_mapping |
2.3 三层架构与适配器模式 |
| 第 6 章 | 6.6 模块地图与依赖边界的代码落点 | runtime/__init__.py、runtime/database.py |
公开导入面 __all__、set_database、get_database |
6.4 模块地图、6.5 零第三方依赖 |
| 第 7 章 | 7.10 条件谓词的形式化 | runtime/condition_engine.py |
_tokenize、_Parser、evaluate、StepGateResult |
7.7 约束机制、11.4 沙箱边界 |
| 第 8 章 | 8.8 统一契约、规则后置与降级 | runtime/base_agent.py |
AgentResponse、process、_apply_rules |
8.2 统一契约、8.3 规则后置、8.5 降级 |
| 第 9 章 | 9.9 上下文隔离、指代消解与参数确定性 | runtime/coordinator.py、runtime/intent_recognition.py |
_isolate_context、_resolve_pronouns、_merge_params、_filter_by_exclude_regexes |
9.2 上下文隔离、9.5 参数确定性 |
| 第 10 章 | 10.8 三层记忆、递归意图状态与延续判定 | runtime/conversation_memory.py、runtime/pending_state.py |
add_turn、_compress_to_summary、_update_intent_state、should_continue_pending |
10.2 跨轮记忆、10.3 延续判定、10.5 状态形式化 |
| 第 11 章 | 11.8 三态裁决与沙箱在引擎中的落地 | runtime/rule_engine.py |
RuleEngine、execute、_execute_step、visit_Attribute、visit_Call |
11.1 动作白名单、11.2 三态裁决、11.4 沙箱边界 |
| 第 12 章 | 12.8 RBAC+ABAC 双判定、SOD 与输入防线 | runtime/permission.py、runtime/sod.py、runtime/agent_security.py |
check_permission、SODChecker.check_user_sod、check_injection |
12.2 双层访问控制、12.3 职责分离、12.4 输入防线 |
| 第 13 章 | 13.10 链式 Gate、发起校验与签字链完整性 | runtime/chain_gate.py、runtime/workflow_enforcer.py |
check_predecessor_completeness、_validate_starter、validate_sig_chain、validate_sig_chain_parallel |
13.3 三道发起校验、13.4 迁移守卫、13.5 签字留痕 |
| 第 14 章 | 14.9 待训练提案、审批门禁与参数热加载 | training/pending_training.py、runtime/param_loader.py |
add_pending、approve、_load_config、get_param |
14.2 反馈闭环、14.3 可训练边界、14.4 热更新 |
| 第 15 章 | 15.7 实体索引的信度升降与学习闭环 | runtime/entity_index.py |
increase_entity_weight、decay_weights、propose_from_corrections |
15.3 长期记忆、15.5 记忆时效性 |
| 第 16 章 | 16.10 事件总线的统一契约与两级降级 | runtime/event_bus.py |
EventBus、RedisStreamBus、publish、subscribe、_init_redis |
16.3 解耦与顺序性、16.4 降级容错 |
| 第 17 章 | 17.6 缓存的击穿、穿透与雪崩三防 | runtime/cache.py |
get_or_build、_get_build_lock、set_empty、_jitter_ttl |
17.2 共享状态防护、17.3 热路径优化 |
| 第 18 章 | 18.1.1 最小可运行示例 | runtime/base_agent.py、runtime/rule_registry.py |
BaseAgent.process、BaseRule.check、RuleRegistry.get_shared |
8.2 统一契约、8.3 裁决后置、11.2 三态裁决 |
| 第 18 章 | 18.5 测试策略与防回归 | eval/session_golden.py、eval/route_eval.py |
extract / diff_golden / commit_golden、路由评测主流程 |
18.5 验收门槛（principled_error = 0） |
| 第 18 章 | 18.8 流程 / 算子 / 原子函数与统一执行流水线 | runtime/operation_registry.py、runtime/workflow_executor.py、runtime/operations/primitives.py |
OperationKind、OperationDef、WorkflowExecutor.execute、authorize、transfer_stage |
18.3 接入路径、11.1 动作能力不可训练、13.10 编排 |
| 第 19 章 | 19.8 灰度开关、单例并发与「模块关闭即降级」 | runtime/module_toggles.py |
ModuleToggleManager、is_enabled、_load_from_db、require_module |
16.4 降级容错、16.6 模块开关 |
表 D-2 未在正文展开、可作延伸阅读的模块
| 模块 | 可延伸的主题 |
|---|---|
runtime/syntax_analyzer.py |
AST 白名单沙箱（11.4 节的完整实现） |
runtime/operations/（create_order / stock_in / stock_out / return_order 等） |
各领域写算子的完整实现（18.8 节七个回调位的真实填法） |
runtime/workflow_effect_executor.py |
审批生效（13.5 节签字链的下游动作） |
runtime/drift_detector.py |
漂移检测（10.3 节延续/脱离判定的运行时实现） |
runtime/profile_extractor.py |
用户画像提炼（15.3 节长期记忆的画像侧） |
runtime/scheduler.py |
调度与模块开关（16.6 节运行期编排） |
runtime/artifact_validator.py |
产物校验（16.4 节降级容错） |
core/file_storage.py |
文件存储与 S3 降级（16.4 节） |
api/auth.py |
认证与"身份/授权分离"（16.5 节） |
runtime/tenant.py |
租户隔离（多租户边界） |
prog/rules/ |
业务规则包（质检/排产/库存/折扣/信用等真实规则，11.3 节） |
取材原则：本索引只收录正文实际引用的模块；若需通读框架，建议从 6.4 节的模块地图出发，再按本索引定位到具体章节。