配置参考
完整可下载实例: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 治理节。