chore(zcode): 移除 .zcode 工具配置并更新忽略规则

删除 .zcode 下的 hooks 与 plans 配置，将 .zcode/ 和
.zcodeignore 加入 .gitignore；同时重写试玩问题记录文档，
用新条目替换垂直切片 v1 的旧内容。

.gitignore

@@ -1,6 +1,8 @@
 # === Godot 4 ===
 # 编辑器生成的缓存（imported 资源、shader cache、编辑器状态），可由 project.godot 重建
 .godot/
+.zcode/
+.zcodeignore
 # Godot 4 的 .uid 文件必须提交，不要忽略
 # 导入元数据
 *.import

.zcode/config.json

@@ -1,47 +0,0 @@
-{
-  "hooks": {
-    "enabled": true,
-    "events": {
-      "PreToolUse": [
-        {
-          "matcher": "Edit|Write|MultiEdit|NotebookEdit|Bash",
-          "hooks": [
-            {
-              "type": "process",
-              "command": "bash",
-              "args": ["${ZCODE_PROJECT_DIR}/.zcode/hooks/worktree-guard.sh"],
-              "timeoutMs": 10000,
-              "statusMessage": "worktree 铁律守卫(主工作区直改/提交拦截)"
-            }
-          ]
-        }
-      ],
-      "SessionStart": [
-        {
-          "hooks": [
-            {
-              "type": "process",
-              "command": "bash",
-              "args": ["${ZCODE_PROJECT_DIR}/.zcode/hooks/session-snapshot.sh"],
-              "timeoutMs": 10000,
-              "statusMessage": "记录会话工作区快照(active.md 收口检查用)"
-            }
-          ]
-        }
-      ],
-      "Stop": [
-        {
-          "hooks": [
-            {
-              "type": "process",
-              "command": "bash",
-              "args": ["${ZCODE_PROJECT_DIR}/.zcode/hooks/stop-active-md-guard.sh"],
-              "timeoutMs": 10000,
-              "statusMessage": "active.md 会话收口检查"
-            }
-          ]
-        }
-      ]
-    }
-  }
-}

.zcode/hooks/session-snapshot.sh

@@ -1,15 +0,0 @@
-#!/usr/bin/env bash
-# 会话开始:快照工作区状态(status 哈希 + diff 内容哈希)与 active.md 内容哈希,供 Stop 收口检查对比
-# 2026-09-18 强判据升级:active.md 判据由 mtime 改内容哈希——touch/意外改时间不再蒙混,内容真变才算登记
-proj="${ZCODE_PROJECT_DIR:-$PWD}"
-sid="${CLAUDE_SESSION_ID:-default}"
-state="/tmp/zcode-active-md-guard"
-mkdir -p "$state"
-{
-  date +%s
-  git -C "$proj" status --porcelain 2>/dev/null | sort | sha1sum | cut -d' ' -f1
-  git -C "$proj" diff HEAD 2>/dev/null | sha1sum | cut -d' ' -f1
-  sha1sum "$proj/active.md" 2>/dev/null | cut -d' ' -f1 || echo 0
-} > "$state/$sid.snap"
-rm -f "$state/$sid.reminded"
-exit 0

.zcode/hooks/stop-active-md-guard.sh

@@ -1,25 +0,0 @@
-#!/usr/bin/env bash
-# 会话结束收口检查:工作区相对会话开始有改动(status 行或 diff 内容任一变化)、
-# 且 active.md 内容哈希未变(本会话内未真更新——mtime 不可信,touch 也算未登记)时,
-# 以 exit 2 阻止停止并经 stderr 注入登记提醒(每会话至多一次)
-# 2026-09-18 强判据升级:active.md 由 mtime 比对改内容哈希比对
-proj="${ZCODE_PROJECT_DIR:-$PWD}"
-sid="${CLAUDE_SESSION_ID:-default}"
-state="/tmp/zcode-active-md-guard"
-snap="$state/$sid.snap"
-active_md="$proj/active.md"
-[ -f "$snap" ] || exit 0
-[ -f "$state/$sid.reminded" ] && exit 0
-start_status=$(sed -n 2p "$snap")
-start_diff=$(sed -n 3p "$snap")
-start_content=$(sed -n 4p "$snap")
-now_status=$(git -C "$proj" status --porcelain 2>/dev/null | sort | sha1sum | cut -d' ' -f1)
-now_diff=$(git -C "$proj" diff HEAD 2>/dev/null | sha1sum | cut -d' ' -f1)
-[ "$now_status" = "$start_status" ] && [ "$now_diff" = "$start_diff" ] && exit 0
-now_content=$(sha1sum "$active_md" 2>/dev/null | cut -d' ' -f1 || echo 0)
-[ "$now_content" = "$start_content" ] || exit 0
-touch "$state/$sid.reminded"
-cat >&2 <<'MSG'
-[会话收口检查] 本会话产生了工作区改动,但 根目录 active.md 内容未变(本会话内未真更新)。若本会话包含实质工作(代码/文档/数值/设计拍板/缺陷修复),请:① 先更新根目录 active.md 顶部「当前状态快照」节(在飞/可做/阻塞/锚点/下一步——先改快照再记账);② 再在根目录 active.md 末尾追加一条编号批次条目(做了什么·拍板了什么·验证结果·遗留与下一步)。完成后结束;若本次确无可登记事项(纯问答、只读核查),忽略本提醒直接结束。另:待办事项登记 design/gdd/06-待办清单.md(裁决后改状态列留痕),不要写进 active.md 条目表。
-MSG
-exit 2

.zcode/hooks/worktree-guard.sh

@@ -1,209 +0,0 @@
-#!/usr/bin/env bash
-# worktree 铁律守卫（PreToolUse，2026-09-19 台账 87 用户立规；2026-10-15 扩合回闸）
-# 拦两路：①Edit/Write 类落在主工作区（白名单外）且主工作区检出 master/main
-#         ②Bash 在主工作区 git commit
-#         ③Bash 在主工作区 git merge/rebase/cherry-pick 进 master 且无 tools/run_all_gates.sh 全量回执
-# 退出码 2 = 拦截（stderr 回传模型）；0 = 放行；任何解析异常一律放行（守卫是兜底，不能挡死会话收口）
-proj="${ZCODE_PROJECT_DIR:-$PWD}"
-tmp="$(mktemp)"
-cat > "$tmp"
-projw="$(cygpath -w "$proj" 2>/dev/null || echo "$proj")"
-python - "$projw" "$(cygpath -w "$tmp" 2>/dev/null || echo "$tmp")" <<'PY'
-import json, os, re, subprocess, sys
-
-try:
-    sys.stderr.reconfigure(encoding='utf-8', errors='replace')
-except Exception:
-    pass
-
-def winpath(p):
-    # MSYS 风格路径（/d/...）原生 Windows Python 不识别，统一转 Windows 形式
-    if isinstance(p, str) and re.match(r"^/[A-Za-z](/|$)", p):
-        try:
-            r = subprocess.run(["cygpath", "-w", p], capture_output=True, text=True, timeout=5)
-            return r.stdout.strip() or p
-        except Exception:
-            return p
-    return p
-
-proj = os.path.abspath(winpath(sys.argv[1]))
-try:
-    with open(sys.argv[2], encoding='utf-8') as f:
-        d = json.load(f)
-except Exception:
-    sys.exit(0)
-
-tool = d.get("tool_name") or d.get("tool") or ""
-ti = d.get("tool_input") or {}
-cwd = os.path.abspath(winpath(d.get("cwd") or proj))
-
-def in_dir(p, root):
-    p = os.path.normcase(os.path.abspath(p))
-    root = os.path.normcase(os.path.abspath(root))
-    return p == root or p.startswith(root.rstrip('\\/') + os.sep)
-
-def trunk_branch(repo):
-    try:
-        r = subprocess.run(["git", "-C", repo, "branch", "--show-current"],
-                           capture_output=True, text=True, timeout=5)
-        return r.stdout.strip()
-    except Exception:
-        return ""
-
-TRUNK = {"master", "main"}
-WHITELIST = [os.path.abspath(winpath(os.path.join(proj, "active.md"))),
-             os.path.abspath(winpath(os.path.join(proj, ".zcode")))]
-
-if tool in ("Edit", "Write", "MultiEdit", "NotebookEdit"):
-    fp = ti.get("file_path") or ti.get("notebook_path") or ""
-    if not fp:
-        sys.exit(0)
-    fp = os.path.abspath(winpath(fp))
-    if not in_dir(fp, proj) or any(in_dir(fp, w) for w in WHITELIST):
-        sys.exit(0)
-    b = trunk_branch(proj)
-    if b in TRUNK:
-        sys.stderr.write(
-            "[worktree 铁律] 主工作区（%s 分支）禁止直接改动：%s\n"
-            "先建独立 worktree 再改：git worktree add ../g-plan2-<任务名> -b <任务分支>；"
-            "收尾在主工作区 git merge --no-ff 合回。豁免面仅根目录 active.md 与 .zcode/。\n" % (b, fp))
-        sys.exit(2)
-
-elif tool == "Bash":
-    cmd = ti.get("command", "") or ""
-    toks = cmd.split()
-    has_commit = False
-    has_merge = False
-    for i, t in enumerate(toks):
-        if t.rstrip(';') != 'git':
-            continue
-        j = i + 1
-        while j < len(toks) and j - i <= 5:
-            u = toks[j].rstrip(';')
-            if u == "commit":
-                has_commit = True
-                break
-            if u in ("merge", "rebase", "cherry-pick"):
-                has_merge = True
-                break
-            if u.startswith("-"):
-                if u in ("-C", "--git-dir", "-c") and j + 1 < len(toks):
-                    j += 2
-                    continue
-                j += 1
-                continue
-            break
-    # 主工作区判定：cwd 在内，或命令文本里显式指到主工作区路径（不含 worktree 兄弟目录）
-    norm = cmd.replace("\\", "/").lower()
-    ref_main = re.search(r"/d/code/g-plan2(?![\w-])", norm) or re.search(r"d:/code/g-plan2(?![\w-])", norm)
-    # 兄弟 worktree 豁免（2026-10-03 用户授权修复）：harness 上报 cwd 恒为项目根，原判定把
-    # git -C <worktree> commit 一并误拦，与「提交在任务 worktree 分支上完成」的放行语义相抵；
-    # 命令文本以路径形态（斜杠前缀）显式指向兄弟 worktree 且不含主区路径时放行——显式主区
-    # 路径引用优先走下方拦截判定（ref_main 命中即不豁免，防「主区提交夹带 worktree 提及」绕行）。
-    ref_wt = re.search(r"/g-plan2-[\w-]+", norm)
-    sibling = bool(ref_wt) and not ref_main
-    on_trunk = trunk_branch(proj) in TRUNK
-    in_main = (in_dir(cwd, proj) or bool(ref_main)) and on_trunk
-    if not in_main or sibling:
-        sys.exit(0)
-    if has_commit:
-        sys.stderr.write(
-            "[worktree 铁律] 主工作区（master）禁止直接 git commit——提交在任务 worktree 分支上完成，"
-            "收尾在主工作区 git merge --no-ff 合回 master。\n")
-        sys.exit(2)
-    # 合回闸（2026-10-15 用户令「迭代完成前必须全量跑一遍所有测试」）：merge/rebase/cherry-pick
-    # 进 master 前校验 tools/run_all_gates.sh 的回执——回执缺失、quick 模式、或含红项即拦。
-    # 起因：iter27 台账只记 probe --click 未记 --full，t17_defer_probe 红了整个迭代无人发现，
-    # 根因是闸清单散落三份文档彼此不一致且无机器校验（清单唯一事实源已收敛为 run_all_gates.sh）。
-    if has_merge:
-        # 回执在「跑闸的那个 worktree」里（闸在 worktree 跑、回执随 worktree 落地），
-        # 主工作区自己那份是上一次合回前的旧件。故按 merge 的目标分支反查 worktree 路径，
-        # 找不到就在所有 sibling worktree 里找「回执 commit == 分支 tip」的那一份。
-        def git_out(*args, **kw):
-            return subprocess.run(["git", "-C", proj] + list(args),
-                                  capture_output=True, text=True, timeout=kw.get("timeout", 8)).stdout.strip()
-
-        merge_branch = None
-        for t in toks:
-            u = t.rstrip(';')
-            if u and not u.startswith("-") and u not in ("git", "merge", "rebase", "cherry-pick"):
-                merge_branch = u
-                break
-        tip = git_out("rev-parse", merge_branch) if merge_branch else ""
-        if not tip:
-            tip = git_out("rev-parse", "HEAD")
-
-        # 纯文档合入豁免（2026-10-16 用户令「改了代码的合入才做测试验证，文档的合入不验」）：
-        # merge-base..分支尖 的改动不触碰 game/（游戏工程本体）＝纯文档/开发工具面合入，
-        # 跑游戏测试无意义，直接放行；触碰 game/ 的代码合入仍走下方回执校验。
-        if merge_branch:
-            _base = git_out("merge-base", "HEAD", merge_branch)
-            _touched_game = git_out("diff", "--name-only", _base, merge_branch, "--", "game/") if _base else "x"
-            if not _touched_game:
-                sys.exit(0)
-
-        cands = []
-        if merge_branch:
-            try:
-                wl = git_out("worktree", "list", "--porcelain")
-                blocks = [b for b in wl.split("\n\n") if b.strip()]
-                for b in blocks:
-                    if ("branch refs/heads/%s" % merge_branch) in b:
-                        head_line = [l for l in b.split("\n") if l.startswith("worktree ")]
-                        if head_line:
-                            cands.append(os.path.abspath(winpath(head_line[0][9:])))
-            except Exception:
-                pass
-        # 兜底：主区 + 所有 sibling worktree
-        cands.append(proj)
-        parent = os.path.dirname(proj)
-        try:
-            for name in os.listdir(parent):
-                p = os.path.join(parent, name)
-                if os.path.isdir(os.path.join(p, ".git")) or os.path.isfile(os.path.join(p, ".git")):
-                    cands.append(os.path.abspath(p))
-        except Exception:
-            pass
-
-        receipt = None
-        for base in cands:
-            p = os.path.join(base, "game", "tests", ".gates", "receipt.json")
-            if not os.path.exists(p):
-                continue
-            try:
-                import json
-                with open(p, encoding="utf-8") as f:
-                    r = json.load(f)
-            except Exception:
-                continue
-            # 只认「回执 commit == 将要合入的分支 tip」的那一份
-            if r.get("commit") == tip:
-                receipt = (base, r)
-                break
-        why = None
-        if receipt is None:
-            found = any(os.path.exists(os.path.join(b, "game", "tests", ".gates", "receipt.json"))
-                        for b in cands)
-            why = ("无与分支 %s（tip %s）匹配的回执%s"
-                   % (merge_branch or "?", tip[:8],
-                      "（worktree 内存在回执但 commit 对不上＝闸跑完后代码又变了）" if found else ""))
-        else:
-            base, r = receipt
-            if r.get("quick_mode"):
-                why = "回执是 --quick 模式（跳过渲染闸/静态扫描），收口出库必须跑全量"
-            elif not r.get("all_green"):
-                reds = [g["name"] for g in r.get("gates", []) if g.get("exit") != 0]
-                why = "回执含新增红项：" + ("、".join(reds) if reds else "见 receipt.json")
-        if why:
-            sys.stderr.write(
-                "[合回闸] 拦截 %s 进 master——%s。\n"
-                "在任务 worktree 内跑全量闸：tools/run_all_gates.sh（不带 --quick），"
-                "跑完回执自动写入该 worktree 的 game/tests/.gates/receipt.json，再合。\n"
-                % (cmd.split()[0], why))
-            sys.exit(2)
-
-sys.exit(0)
-PY
-rc=$?
-rm -f "$tmp"
-exit $rc

.zcode/plans/m3-iter10-addendum-task-2026-10-01.md

@@ -1,34 +0,0 @@
-# M-3 迭代 10 追加批任务书：奖励节点共享池 + 七项代拍板裁决（2026-10-01）
-
-> 触发 = 用户 2026-10-01 对迭代 10 代拍板 7 项的逐条裁决 + 新增范围指令（「奖励节点其实也是一个三选一的奖励获取,和通关关卡得到的这个三选一奖励是相同的,他们共享同一个池子；把需要补充的文档,还有迭代的任务书和代码实现都补充上」）。本批在迭代 10 worktree（m3-iter10-20261001）内执行，不合入 master、渲染层验证冻结口径不变。
-
-## 一、裁决记录（2026-10-01 用户逐条）
-
-| # | 代拍板 | 裁决 |
-|---|---|---|
-| a | Boss 钥石子选项 | **用备选**：复杀按关 2/2/3 递进（首杀 3 三关统一；L3 3/3 系 first≥repeat 合法端点）——原代拍板「复杀统一 2」推翻，meta.tres/registry 随改 |
-| b | 三选一件值 provisional | 认同（1/5/1/GP20/AP1/道具 1 件，归调参批重投） |
-| c | AP 件兑现语义 | 认同（每场战斗首轮基线 +1） |
-| d | 钥石增量行呈现位 | 认同（战斗总结结算框；三选一面零钥石） |
-| e | 同调位过渡形态 | **已追认（2026-10-01 用户确认）**：过渡键挂临时上限+渠道形态两路；战斗内沉没面归同调实施批收口 |
-| f | MC 三选一策略 | 暂定维持 + **登记调研待办**（06 新条目）：随机选取奖励是否会对角色能力有较大影响——首件 vs 按权重随机双窗对照 |
-| g | save 版本兼容 | 对齐 semantic version 向后兼容口径：旧档可读可玩、断点可续、缺新键合法空态；v2→v3 兼容断言随批（存档序列化.md v1.3 成文） |
-
-## 二、新增范围：奖励节点三选一共享池
-
-**设计**：奖励节点到达即开与通关三选一相同的选择面——提升池六种同权重、同全冒险次数上限（两渠道合计判上限）、同 reward_pick 封闭流；道具件满位触发替换子交互（与通关面同构）；「池空直通」合法态退役（GP/道具件无上限，牌库恒非空）。
-
-**落地面**：
-- AdventureRunner：node_bonus_candidates / present_node_bonus / apply_node_bonus / resolve_bonus_replace（分发节点句柄与通关序号两轨）+ _node_bonus_pending（断点不载——续玩重建重抽，计数器保证同候选）
-- AuxItems：holding_records / discard_item（节点替换的库存句柄面）
-- main.gd：奖励节点分支改走 BonusPickOverlay 共用面（_bonus_context 分派 continue）；node_overlay 道具三选一面退役（保留恢复点用途）；_reward_node_choices/_on_reward_item_chosen 退役
-- autoplay：节点三选一确定性驱动（首件/放弃新件）+ resolved 上下文分派
-- narrator：node_bonus_header
-- 冒烟：⑫ v2 兼容三断言 + ⑬ 节点共享池三断言 + ② 节点计数/上限集扩；_adv_drive_to_shop 节点驱动
-- reward_overlay_test 随面迁移改写（守 BonusPickOverlay：两段式/确认外发/替换两路/结果态）
-
-**文档**：关卡节点地图.md（节点奖励节改写+行表）、冒险结构.md（提升池冒险级单例句）、node-reward.md v2.0（重写）、魔法道具.md v0.7（渠道改写注记）、存档序列化.md v1.3（semver 口径）、06（调研待办新条）、registry（meta_table a 裁备选值）
-
-## 三、验证义务
-
-冒烟全量 + run_all 15 套 + 五探针 + doc 三闸零新增 + 熵增闸 + MC 重锚三跑（追加批改经济面——读数报告更新 v2 段）。

design/research/playnote.md

@@ -1,21 +1,20 @@
 # 试玩问题记录
 
-## 垂直切片 v1
+- 一开始不能让角色的成长系数太高.比如在没经过升级之前,你的成长系数是跟不上关卡怪物难度提升的;但是后续能力解锁之后,成长系数才能匹配得上
 
-### 核心循环
+- UI优化,第二第三关的棋盘看着太累了;不知道是因为亮度还是对比度的原因,看着非常费劲,非常不舒服;
 
-- 每次开图就是开了片面积；
-    是否有生成图计算如此？
-- 关卡结束的大奖励太丰厚了,可以考虑去掉或者减少,只保留商店的增强; 或者结合关卡做一些比较特色的加强
+- 第一关的第二个节点数值有问题
 
-- 扫雷棋盘增加视野限制; 联动道具“魔法提灯”可以看到所有的棋盘视野,或者视野范围变大
+- 现在的立绘太丑了,像素化的粒度太低了,导致根本看不清立绘; 看是否可以改回用较为高清的图片?
+还有一个问题是大小的问题.我们或许可以调整一下不同怪物的大小,因为现在地精的图片看起来比熊地精还要大,这并不合理;
 
-- 有什么办法可以让玩家去标雷? 比如,我怪物触发了某个状态,你正常打开安全格,普通伤害会变得非常低,但是标雷可以造成满的,甚至是倍率的伤害; 这样是否可以让玩家主动去标雷; 不然的话,玩家肯定是尽可能地开更多安全格,将资源投入到获得清图奖励的伤害了;
 
-- 清图奖励的伤害类型现在是什么类型的? 是否增加一个全能类型,对所有护甲都是100%的伤害?
+- 修改地图的奖励类型
+战斗节点增加不同的地图类型，比如有些图踩雷受到更多的伤害，有些图标雷可以造成更多的伤害，有些图伤害会减半需要凑更多清图奖励（这些都是暂时的设定）
 
-- 踩地雷的惩罚太小了,我在一张图踩了三个地雷,竟然还有3/4以上的血,这不合理;
+- 关卡的节点还是太少了; 需要统计一下第 123 关 path 的路径长度,路径长度需要递增,并且后续关卡的节点数增幅应该更大;
 
-- 结束战斗,直接跳到关卡选择页面太突兀了.如果可以的话,中间应该有一个战斗结算的框;
+- 关卡界面中的"状态"界面不需要有具体的解锁内容,只需要看到自己选了哪些密保,有哪些专长就可以了.只显示跟当前冒险有关的内容,不需要有跨关的这种解锁信;
+比如带的秘宝,获取的专长,当前的属性, 现有的GP, 总共的钥石;
 
-- 现在还没有战斗特效结算, 轮次和轮次之间没有一个结算的过程展示, 直接就到了下回合, 完全没有体验