node_modules/
.pnpm-store/

dist/
build/
coverage/
.next/
.turbo/
.vite/

.env
.env.*
!.env.example

.idea/

# ── IDEA 共享项目配置：允许提交模块、Maven、检查器、运行配置；个人状态仍由 .idea/.gitignore 忽略 ──
!.idea/
!.idea/.gitignore
!.idea/*.iml
!.idea/*.xml
!.idea/inspectionProfiles/
!.idea/inspectionProfiles/*.xml
!.idea/jsLinters/
!.idea/jsLinters/*.xml
!.idea/runConfigurations/
!.idea/runConfigurations/*.xml
*.log
.DS_Store
.gstack/

# ── 本地个人环境配置：仅本机生效，绝不入库（机器画像 / 工具链 / 本地端口属个人配置）──
# 与 AGENTS.md §10 配套：AGENTS.md 用 @localagents.md 可选引用，文件缺失不影响共享文档。
localagents.md

# ── 例外 1：源码树（src/）下名为 build 的目录是合法源码，绝非构建产物 ──
# 第 5 行笼统的 build/（为构建产物设计）会误吞 Java/前端源码中名为 build 的包/目录，例如：
#   后端 com.wanxiang.huijing.game.module.runtime.{dal.dataobject,dal.mysql,service}.build（编译任务域，4 文件）、
#   前端 game-admin/src/views/infra/build。
# 构建产物绝不落在 src/ 下，故一律豁免 src/ 下的 build/，避免克隆/CI 缺源码而编译失败。
!**/src/**/build/
!**/src/**/build/**

# ── 例外 2：game-admin（huijing 前端 fork）模块根级例外 ──
# huijing 约定将「模块根」build/（vite 插件配置源码，不在 src 下，故需单独豁免）与 .env*（前端构建配置，非密钥）纳入版本库。
!game-admin/build/
!game-admin/build/**
!game-admin/.env
!game-admin/.env.dev
!game-admin/.env.local
!game-admin/.env.prod
!game-admin/.env.stage
!game-admin/.env.test

# ── 例外 3：game-studio 联调 env（staging 后端地址 + studio token，非密钥，须入库供 mini-desktop 克隆联调）──
# 同 gitignore-swallows-frontend-source 记忆：根 .env.* 笼统忽略会吞掉 game-studio/.env.staging，
# 致 mini-desktop 匿名克隆后拿不到联调配置、vite --mode staging 起不来。故显式豁免。
!game-studio/.env.staging

# ── Python 字节码缓存：QA 编排器/评估脚本运行即生成，纯缓存可重建；目录名固定，无误吞源码风险（不同于上面 build/ 的教训）──
__pycache__/
.pytest_cache/

# ── 存储分层 H3（2026-06-16 agent-specs 目录治理，配套 .agents/rules/engineering-conventions.md §10.3）──
# docs/agent-specs/ 只放文档(*.md)；spike 代码/批跑证据(hash 目录/jsonl/截图)/模型原始输出等可重生成产物不入文档树。
# __pycache__/ 与 node_modules/ 已由上方全局规则拦截；新 spike 原始 json/png 默认 untracked、勿 git add 批量产物。
# 注意（遵 gitignore-swallows-frontend-source 教训）：此处不设 *.json/*.png 笼统忽略，以免误吞 contracts/ 等业务目录下的合法同类文件——分层靠规范 + 收口第 8 步执行，不靠笼统 glob。

# ── 游戏内容存储边界：Git 只放平台代码，具体游戏全部进入对象存储（2026-07-29）──
# 具体游戏的源码、素材、bundle、证据和参照游戏都不再作为平台源码进入 Git。
# 下列豁免只包含通用生成壳、平台模板和共享工具；它们不绑定任何一款具体游戏。
# 已跟踪的历史游戏不会因 ignore 自动消失，必须在对象存储消费切换和下载对账后独立删除。
/game-runtime/games/*
!/game-runtime/games/_generic/
!/game-runtime/games/_generic/**
!/game-runtime/games/_template/
!/game-runtime/games/_template/**
!/game-runtime/games/_template-feiyi/
!/game-runtime/games/_template-feiyi/**
!/game-runtime/games/_template-puzzle/
!/game-runtime/games/_template-puzzle/**
!/game-runtime/games/_template-shop/
!/game-runtime/games/_template-shop/**
!/game-runtime/games/_template-story/
!/game-runtime/games/_template-story/**
!/game-runtime/games/_template-trpg/
!/game-runtime/games/_template-trpg/**
!/game-runtime/games/_wg1-gen/
/game-runtime/games/_wg1-gen/*
!/game-runtime/games/_wg1-gen/_shared/
!/game-runtime/games/_wg1-gen/_shared/**
/game-runtime/games/_wg1-gen/_shared/**/__pycache__/
!/game-runtime/games/_wg1-gen/.agent
/tier2/games/*

# cheap-worker 本地虚拟环境与批跑结果不入库。
cheap-worker/.venv/
cheap-worker/results/

# ── 本机个人配置:localagents.md 自声明"绝不提交、已在 .gitignore 忽略",但此前无对应忽略行(声明未被机器执行);2026-07-06 补真 ──
/localagents.md

# ── AgentScope 源码库(本机开发直读参考,克隆自 github tag v2.0.2 = 已装运行版,2026-07-01)──
# clone 到 skill 目录供本机直接读 agentscope 2.0.2 源码(src/ + 已装 .venv 没有的 examples/docs/tests);
# 非本仓产物、~17MB、含自带 .git、可随时重克隆,不入库。遵「专一不笼统」:只忽略这一个克隆子目录,
# 不碰 skill 其余已跟踪文件(SKILL.md / references/ / scripts/ 共 9 文件)。版本要与 cheap-worker/.venv 装的对齐。
.claude/skills/agentscope-skill/agentscope/