修复: design/结构批——diagrams 迁入 dev/architecture(案甲,熵增闸红灯清零)+旧档 GDD 引用全量摘除(31处/29文档+code/schema头注13文件+registry 5行)+doc双工具摘design/ux死路径(工作日志 412)

This commit is contained in:
DKChan committed 2026-10-09 03:29:09 +08:00
1 parent 683d81f6da
commit 442cd511a0
49 files changed
+32 -63

No files matched your search

File diff suppressed because it is too large. Load diff
@@ -0,0 +1,262 @@
{
"schema_version": 1,
"diagram_type": "architecture",
"meta": {
"title": "Dungeon Sweeper 系统架构总图",
"output": "design/dev/architecture/gdd-architecture.html",
"quality_profile": "showcase",
"locale": "zh-CN"
},
"components": [
{
"id": "ap",
"type": "backend",
"label": "行动经济",
"sublabel": "每轮AP·停手刷新",
"tag": "ACTION_ECONOMY",
"pos": [
24,
300
],
"size": [
140,
64
]
},
{
"id": "minesweeper",
"type": "frontend",
"label": "排雷循环",
"sublabel": "挖格·插旗·连锁展开",
"tag": "MINESWEEPER_CYCLE",
"pos": [
236,
300
],
"size": [
150,
64
]
},
{
"id": "status",
"type": "database",
"label": "增益状态",
"sublabel": "状态容器·叠层衰减",
"tag": "STATUS_EFFECT",
"pos": [
458,
300
],
"size": [
150,
64
]
},
{
"id": "combat",
"type": "backend",
"label": "战斗循环",
"sublabel": "轮末自动结算",
"tag": "COMBAT_CYCLE",
"pos": [
680,
300
],
"size": [
160,
64
]
},
{
"id": "adventure",
"type": "backend",
"label": "冒险循环",
"sublabel": "关卡节点链·一条命",
"tag": "ADVENTURE_CYCLE",
"pos": [
912,
300
],
"size": [
160,
64
]
},
{
"id": "meta",
"type": "database",
"label": "跨局循环·元进度",
"sublabel": "钥石解锁永久提升",
"tag": "META_PROGRESS",
"pos": [
1144,
300
],
"size": [
160,
64
]
},
{
"id": "enemy",
"type": "backend",
"label": "敌人系统",
"sublabel": "技能池·出招意图",
"tag": "ENEMY_SYSTEM",
"pos": [
680,
570
],
"size": [
160,
64
]
},
{
"id": "curio",
"type": "frontend",
"label": "奇物",
"sublabel": "三分类×三渠道",
"tag": "ADVENTURE_CURIO",
"pos": [
912,
570
],
"size": [
160,
64
]
},
{
"id": "support",
"type": "cloud",
"label": "表现与支撑",
"sublabel": "HUD·数据配置·存档",
"tag": "PRESENTATION_SUPPORT",
"pos": [
1144,
570
],
"size": [
160,
64
]
}
],
"boundaries": [
{
"kind": "region",
"label": "局内 · 一条命的冒险",
"wraps": [
"ap",
"minesweeper",
"status",
"combat",
"adventure",
"enemy",
"curio"
],
"pad": 20
},
{
"kind": "region",
"label": "局外 · 存档层",
"wraps": [
"meta"
],
"pad": 20
}
],
"connections": [
{
"from": "ap",
"to": "minesweeper",
"label": "每轮AP"
},
{
"from": "minesweeper",
"to": "status",
"label": "扫雷攒因"
},
{
"from": "status",
"to": "combat",
"label": "轮末兑现",
"variant": "emphasis"
},
{
"from": "combat",
"to": "adventure",
"label": "胜利·GP"
},
{
"from": "adventure",
"to": "meta",
"label": "掉钥石"
},
{
"from": "meta",
"to": "adventure",
"label": "解锁永久提升·下一局",
"variant": "emphasis",
"fromSide": "top",
"toSide": "top",
"via": [
[
1224,
180
],
[
992,
180
]
]
},
{
"from": "enemy",
"to": "combat",
"label": "技能池出招"
},
{
"from": "curio",
"to": "adventure",
"label": "三渠道注入"
},
{
"from": "support",
"to": "meta",
"label": "存档承载",
"variant": "dashed"
}
],
"cards": [
{
"dot": "cyan",
"title": "核心循环",
"items": [
"下洞 → 扫雷攒筹码 → 自动战斗兑现 → 变强再下洞;死了,从头再来",
"扫雷的因=战斗的果:增益打出、控制的巢穴变虚弱、惊动的巢穴变先手",
"关底 Boss 掉钥石入存档;冒险之间用钥石解锁永久提升,存档逐局变厚"
]
},
{
"dot": "emerald",
"title": "循环 × 子系统(systems/)",
"items": [
"排雷循环:棋盘生成 · 排雷玩法 · 行动经济 · 地形变异 · 秘宝",
"战斗循环:战斗结算 · 敌人系统 · 增益状态 · 地图战斗资源 · 战斗表现",
"冒险循环:关卡节点地图 · 关卡节点图生成 · 冒险结构 · 难度曲线与Boss · 奇物",
"跨局循环:元进度 | 表现与支撑:HUD框架 · 数据配置 · 存档序列化 · 音频 · 教学"
]
},
{
"dot": "amber",
"title": "数值语言",
"items": [
"伤害与成长一律整数加减(+1/−1 点),全局向下取整",
"百分比仅保留三处既有粗档修正,新增数值系统默认走整数"
]
}
]
}
+1 -1
View File
@@ -34,7 +34,7 @@
### 1.4 命名 = 领域命名,禁止系统 ID 前缀
文件名与类名禁止 `a1_`/`b1_`/`c1_` 等系统 ID 前缀(`a1_board_generator.gd` → `board_generator.gd`)。
设计追溯不靠前缀:每个核心实现文件头注必须带一行
`# 实现 GDD:design/archive/gdd-2026-09-14/<id>-<slug>.md(系统 ID Xn)`(2026-09-14 起旧 GDD 体系封存于归档,头注指归档路径;对应新 systems 文档定稿后再改指 `design/gdd/systems/` 新文档);系统 ID 只作为文档与 registry 的追溯锚。
`# 实现 GDD:design/gdd/systems/<循环>/<系统文档>.md(系统 ID Xn)`;系统 ID 只作为文档与 registry 的追溯锚。
豁免:D2 schema 类与 autoload(本就领域命名);文档/夹具登记名(如 b4_golden)属文档层。
> **反面案例(2026-09-11,用户:"是没有代码规范吗")**:ID 前缀是跟随 GDD 文档名的事实约定,
+1 -1
View File
@@ -156,7 +156,6 @@
## 9. 归档与事实源
- `design/archive/gdd-2026-09-14/` 是旧版 GDD 体系的只读归档:不维护、不修改,**禁止作为事实引用**。
- 旧文档里的概念写进现行文档时,必须翻译成现行术语与现行决策口径(例:雾格已从设计中移除,不得作为现行机制引用)。
- registry 中 owner 仍指向旧 GDD 路径的条目,在对应新系统文档定稿后逐条改指新路径。
@@ -198,3 +197,4 @@
| v9 | 2026-10-02 | **文档生命周期条款(2026-10-01 用户立规「吸收即死」落文)**:新增第 11 节——中间文档寿命=迭代寿命,结论吸收进正主即删、未决先迁再死、永不入库、引用面口径、台账记结论不记指针、sim-data 白名单、迭代出口清理项、design/research 与 design/qa 为暂存地非档案库;第 10 节补台账记结论口径;文首地位/适用范围两处过期路径修正(`docs/`→`design/dev/`、`production/` 会话记录→根 `active.md`) |
| v10 | 2026-10-04 | **台账去压缩条款(用户立规)**:第 10 节废除「每条 ≤3 行」——能看懂比字数少更重要;条目改用完整白话句子写结论,长度服从可读性;第 4 节黑话禁令对台账同等生效。起因:2026-10-04 黑话审计证实 ≤3 行压缩压力迫使台账条目使用自造缩略语(收口/落籍/在飞等约 15 个流程动词、530 条自造短语),并渗入正式文档;CLAUDE.md 规范导航表「会话进度记录」行同步改写 |
| v11 | 2026-10-04 | **第 4 节补强:自造词三形态禁令(用户令,黑话审计后)**:新增自造词三种固定形态禁令表(工作包代号 / 机制造词 / 流程造词,各带本仓真实反例与正确写法)+ 通行检验标准(读者 = 业内人但没读过项目历史,需要作者解释的词即不合格,展开才算改)+ 写后自查动作;同批 CLAUDE.md 硬性红线新增「用语红线」一行。起因:原第 4 节禁令过于抽象、执行失效(全仓 530 条自造短语),且未明确覆盖对话输出与工作日志命名 |
| v12 | 2026-10-09 | §9 摘除 design/archive/gdd-2026-09-14/ 归档列项(目录已删,2026-10-09 用户令旧档引用全量摘除);旧概念翻译与 registry 改指两条维持 |