v0.1.26: 墨规清辉——MOD 规范范式 + 灾因注册表 + 页面提亮(1047 全绿)

【MOD 规范与范式(核心命题)】
- docs/MOD_GUIDE.md:完整作者守则——命名/id 规约/semver/schema:1/五数据口
  (事件/模板/词库/灾因/配方)/依赖冲突/安全红线(无脚本·禁碰 rng·不动核心时序)/
  打包分发(.cotymod 单文件)/行为承诺
- validateMod 深度校验:category/weight/境界/负成本/非空/options.eff 形状
- modPreflight 权威冲突检测:findEvent(池+动态分支 raid/渡劫/大比/传薪全量)
- MOD_SCHEMA_VERSION=1 + schema 声明与升级提示;PluginStatus.author 展示

【灾因归一化(平衡版落地)】
- calamities 由 as const 死表→聚合注册表(calamityNames/calamityFamilyOf/calamityEffectOf+addCalamity)
- WorldSim 灾签/生产/Market 全链路走聚合读口——MOD 灾因(剑灾/灵潮湍变)进入世界循环
- 默认表不变→基准世界指纹零漂(clock.test 全绿实证)

【页面可读性(有点暗)】
- .dim #6d6150→#a99c80(3.4:1→7+:1)、.dim2 #96896e→#c3b595、.help-text 提亮、
  .feed-item 显色 #efe4c9 + 灰金系 8 处提亮(styles.css 12+/11- 纯色值)
- tests/contrast-readability.test.ts:WCAG 对比度审计(≥4.5:1)+ 历史暗色迁移断言

【测试】1047 全绿(47 套件):mod-system 9(+validate/灾因/冲突/预检)、contrast 3;
【金钟罩】0.1.25 基线零漂;build 通过
This commit is contained in:
2026-08-23 16:37:11 +08:00
parent 5d9c333c76
commit ba9766e152
16 changed files with 354 additions and 27 deletions
+37 -3
View File
@@ -155,10 +155,13 @@ export const WORLDSIM = {
newsKeep: 120
}
export type CalamityName = (typeof WORLDSIM.calamities)[number]
export type CalamityName = string
/** 默认灾因集(聚合读口:默认+MOD/插件扩展——默认表和不变 → 基准世界指纹不漂) */
export const DEFAULT_CALAMITIES = ['旱灾', '涝灾', '蝗灾', '疫病', '兽潮', '寒潮'] as const
/** 灾因 → 家族实际生产乘量(1 = 正常) */
export const CALAMITY_FAMILY: Record<CalamityName, Partial<Record<string, number>>> = {
export const CALAMITY_FAMILY: Record<string, Partial<Record<string, number>>> = {
: { lingcao: 0.7 },
: { lingcao: 0.8, lingkuang: 0.95 },
: { lingcao: 0.55 },
@@ -168,7 +171,7 @@ export const CALAMITY_FAMILY: Record<CalamityName, Partial<Record<string, number
}
/** 灾因 → 资源方向 */
export const CALAMITY_EFFECT: Record<CalamityName, Partial<Record<string, number>>> = {
export const CALAMITY_EFFECT: Record<string, Partial<Record<string, number>>> = {
: { lingcao: -0.3 },
: { lingcao: -0.2, lingkuang: -0.1 },
: { lingcao: -0.45 },
@@ -176,3 +179,34 @@ export const CALAMITY_EFFECT: Record<CalamityName, Partial<Record<string, number
: { beastcore: 0.3 },
: { lingcao: -0.2, beastcore: -0.15 }
}
/** 扩展灾因注册表(MOD/插件 addCalamity)——名字唯一;与默认集聚合 */
const EXTENDED_CALAMITIES: string[] = []
const EXTENDED_FAMILY: Record<string, Partial<Record<string, number>>> = {}
const EXTENDED_EFFECT: Record<string, Partial<Record<string, number>>> = {}
export function addCalamity(
name: string,
opts: { family?: Partial<Record<string, number>>; effect?: Partial<Record<string, number>> }
): boolean {
if (DEFAULT_CALAMITIES.includes(name as never) || EXTENDED_CALAMITIES.includes(name)) return false
EXTENDED_CALAMITIES.push(name)
if (opts.family) EXTENDED_FAMILY[name] = opts.family
if (opts.effect) EXTENDED_EFFECT[name] = opts.effect
return true
}
/** 聚合读口(WorldSim 灾签/体感/生产/Market 读取) */
export function calamityNames(): string[] {
return [...DEFAULT_CALAMITIES, ...EXTENDED_CALAMITIES]
}
export function calamityFamilyOf(name: string): Partial<Record<string, number>> {
return EXTENDED_FAMILY[name] ?? CALAMITY_FAMILY[name] ?? {}
}
export function calamityEffectOf(name: string): Partial<Record<string, number>> {
return EXTENDED_EFFECT[name] ?? CALAMITY_EFFECT[name] ?? {}
}
/** 灾因中文描述(MOD 灾因缺省用名本身) */
export function calamityDescOf(name: string): string {
return `${name}——灵植减产,市价将行。`
}