修复: design/结构批——diagrams 迁入 dev/architecture(案甲,熵增闸红灯清零)+旧档 GDD 引用全量摘除(31处/29文档+code/schema头注13文件+registry 5行)+doc双工具摘design/ux死路径(工作日志 412)
This commit is contained in:
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 点),全局向下取整",
|
||||
"百分比仅保留三处既有粗档修正,新增数值系统默认走整数"
|
||||
]
|
||||
}
|
||||
]
|
||||
}
|
||||
@@ -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 文档名的事实约定,
|
||||
|
||||
@@ -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 改指两条维持 |
|
||||
Reference in new issue
Block a user