配置参考

完整可下载实例:skeleton.globalconfig——家族构建骨架全文件(CS/CA 严重级策略 + 命名规范全集 + loom_* 规则族注释态最小配置,全中文注释),下载复制到仓根改名 .globalconfig 即用。本页 = 逐键语义参考。

Ef——LoomEfOptions(运行时选项,AddLoomEf* 回调)

EF 扩展的配置面是选项对象而非配置键——Audit/QueryGuard/Naming/Validation/Watch/ReadSplit 六组 + 观测阈值全键表(含默认值与语义)见 EF 配置参考。

模型型选项(命名策略/枚举存储/字符串长度等)进入冻结模型指纹——optimize 时点漂移即 fail-fast, 同源纪律见 EF 冻结模型。

Endpoints——MSBuild 属性(消费方 csproj 直设,零代码)

属性 缺省 用途
LoomEndpointsNamespace Loom.Generated 生成物命名空间
LoomEndpointsClassName LoomEndpoints 接线桩类名(品牌层选择,方法名随行:Add<Cls>/Map<Cls>)
LoomEndpointsConsumerOnly false 纯消费工程:只发代理,抑制配对告警、不发宿主侧产物
LoomEndpointsServiceLifetime Singleton 端点类/切面注册生命周期(Singleton|Scoped|Transient)

非法值 = KLSG078 编译错误(绝静默)。

Di——analyzer config(.globalconfig / .editorconfig 节内)

键 值 缺省
loom_di.registration_face interop | declarative interop
loom_di.unused_registration off | warn off
loom_di.lifetime_conventions 箭头规则表:<类型名正则> => <Lifetime>,; 分隔 (无)

⚠️ 键必须落在节内:写在 .editorconfig 任何节头之前的"无节键"被 Roslyn 静默忽略 (家族实测判例:无节键 0 命中 / 移入 [*] 节后命中)。.globalconfig(is_global = true)无节键即全局生效,无此问题。

Analyzers——loom_layer.* / loom_forbidden.* / loom_async.* / loom_logger.*

逐键全参考;坏配置(未知键/坏令牌/坏值/规则依赖双向缺失)一律 KLSG139 编译错误 fail-fast。 声明即启用——未声明的键族零诊断(装包未配置零打扰)。

loom_layer.*(分层依赖——KLSG130-133)

键 值 缺省
loom_layer.forbidden_reference 箭头规则表:<左值程序集> => <禁引用目标1 \| 目标2>,; 分隔多条(KLSG130) (无)
loom_layer.zero_internal_refs 程序集名列表——声明者不得引用族内其他程序集(KLSG131) (无)
loom_layer.internal_assembly_prefix 族内程序集前缀——zero_internal_refs 判定范围 (无——zero_internal_refs 已声明而本键缺失 = KLSG139)
loom_layer.allowed_reference 箭头规则表:<左值> => <白名单目标>——白名单外引用即 KLSG132 (无)
loom_layer.namespace_prefix 箭头规则表:<左值> => <归属命名空间前缀>——越界即 KLSG133 (无)

loom_forbidden.*(禁用模式——pack 令牌驱动,KLSG134-138/152)

键 值 缺省
loom_forbidden.pack 令牌列举(\|/; 分隔):reflection(禁反射,KLSG136)| sync_over_async(禁同步等待,137)| fire_and_forget(禁丢弃 Task,138)| bare_threads(禁裸线程原语,134)| hotpath_discipline(热路径分配纪律,135)| zero_copy_loss(ROM 源禁 ToArray,152) (无——零报告)
loom_forbidden.scope.hotpath_discipline members_with([<特性FQN>])(唯一形态)——热路径检查作用域 (无——pack 含 hotpath_discipline 时必配,双向绑定缺一即 KLSG139)
loom_forbidden.exempt.bare_threads 类型全名前缀列表(实现组件本体豁免) (无)
loom_forbidden.exempt.sync_over_async 同上 (无)
loom_forbidden.exempt.fire_and_forget 同上 (无)
loom_forbidden.bare_threads.additional 裸线程构造类型追加清单(精确类型全名,无通配,add-only——内建底线不被覆盖) (无)

loom_async.*(异步纪律——pack 未声明零报告)

键 值 缺省
loom_async.pack naming_suffix | naming_reverse | async_void | ct_last_param 列举(\|/; 分隔) (无——零报告)
loom_async.scope.namespace 命名空间前缀列表(命中声明类型全名;容忍尾点写法) (无——与 pack 双向绑定,缺一即配置非法 KLSG139)
loom_async.ct.parameterless require | allow(零参可等待方法是否必须有 CT) require
loom_async.exempt.<pack 令牌> 类型全名前缀列表(四令牌各自独立豁免) (无)

loom_logger.*(装配注入点 logger 尾随——KLSG163 常开不依赖配置)

键 值 缺省
loom_logger.types logger 类型全名列表(\|/; 分隔,追加语义;泛型闭合构造自动匹配——ILogger<T> 命中 ILogger 条目) Microsoft.Extensions.Logging.ILogger(内置恒在)
loom_logger.factory_types logger 工厂类型全名列表(追加语义) Microsoft.Extensions.Logging.ILoggerFactory(内置恒在)

KLSG164(带参构造无 logger)执法面 = 类型级 opt-in:类型标注 [RequireLoggerInjection] (KernLab.Loom.Abstractions 内置特性)才检查,未标注零报告——"构造不传 logger"是正常写法, 分析器执法不得对正确代码报告。loom_logger.scope.namespace 键已移除——声明即 KLSG139 fail-fast。

等级键(严重级旋钮——与语义键正交)

全部 KLSG 诊断的等级走标准 Roslyn 通道,按路径分段:

[*/*.cs]
dotnet_diagnostic.KLSG159.severity = error        # 生产面
[tests/**/*.cs]
dotnet_diagnostic.KLSG159.severity = none         # 测试面

描述符缺省值:治理族多数 Warning;139(配置非法)/158(端序)/163(logger 尾随)/165(空 catch)为 Error; 164 为 Info(suggestion 位)。Warning ≠ 可忽略——家族零警告红线下 Warning 同样致命, "可配置关闭"才是其语义。逐规则缺省值与七字段说明见 diagnostics.md 治理节。