.gitignore

# ── 构建 / 依赖 / 缓存 ──────────────────────────────────────
node_modules/
dist/
# Android/Gradle modules generate local intermediates and compiled artifacts.
**/android/build/
# browser-control-runtime 的 fs-safe dist 是运行时源码，不是构建产物。
!packages/browser-control-runtime/src/_generated/vendor/fs-safe/dist/
!packages/browser-control-runtime/src/_generated/vendor/fs-safe/dist/**
.output/
coverage/
*.tsbuildinfo
.prototools
__pycache__/
*.py[cod]

# ── 环境变量 / 凭证（样例白名单豁免）────────────────────────
.env
.env.*
!.env.example
!.env.*.example
*.secret
*.key
*.pem
*.p8
*.p12
*.pfx
*.jks
*.keystore
*.mobileprovision

# ── Electron / desktop 构建与暂存产物 ────────────────────────
out/
.vite/
apps/desktop/release/
apps/desktop/resources/tools/
# Generated at package time and embedded in the installed app's Resources.
apps/desktop/resources/cindy-source.json
# build-remote-bundles.mjs 会在 dev/package/build 前重新生成这些目录。
apps/desktop/resources/cc-manager/
apps/desktop/resources/pi-manager/
apps/desktop/resources/anthropic-compat-proxy/
apps/desktop/resources/remote-file-service/
# Windows 打包时由 prePackage 现场 cargo build 生成并覆盖(forge.config.ts
# buildCindyUpdater);源码在 apps/desktop/cindy-updater/,不入仓避免 4.5MB
# 二进制持续消耗 Git LFS 流量。
apps/desktop/resources/cindy-updater.exe

# ── Agent CLI 本地二进制 ─────────────────────────────────────
# 实体文件按 tools/<kind>/latest.json 的 pin 下载，不进 Git/LFS。
apps/claude-code-bin/
apps/codex-bin/
apps/codex-package-bin/
apps/pi-bin/
apps/ripgrep-bin/
# Android platform-tools 的二进制同理：Windows 打包前按 source.properties 的 pin
# 版本下载并校验 sha256（apps/desktop/scripts/ensure-android-platform-tools.mjs）。
# 只忽略已知的三个二进制文件——同目录的 NOTICE.txt（许可清单要读）与
# source.properties（版本事实源）是文本，必须继续入仓。不使用通配符，防止
# 意外文件被隐藏后经 stageAndroidPlatformTools 混入安装包。
apps/android-platform-tools-bin/win32-x64/adb.exe
apps/android-platform-tools-bin/win32-x64/AdbWinApi.dll
apps/android-platform-tools-bin/win32-x64/AdbWinUsbApi.dll
tools/claude/updates/
tools/codex/updates/
tools/codex-package/updates/
tools/ripgrep/updates/
tools/pi/updates/

# ── 日志 / 下载 / 本地运行态 ─────────────────────────────────
logs/
*.log
npm-debug.log*
pnpm-debug.log*
yarn-debug.log*
yarn-error.log*
downloads/
# CODEX_HOME：包含 auth.json 与本机 skill symlink。
apps/desktop/codex-home/
# .cindy：本地私人配置与知识库，不入仓。
.cindy/

# ── 设计与开发临时产物 ───────────────────────────────────────
docs/superpowers/

# ── IDE / 本地知识工具 ───────────────────────────────────────
.idea/
.vscode/
.vs/
.fleet/
.zed/
.nova/
.metadata/
.history/
.ionide/
xcuserdata/
*.xcuserstate
*.sublime-workspace
**/nbproject/private/
.codegraph/
.obsidian/

# ── 系统杂物 ─────────────────────────────────────────────────
# macOS
.DS_Store
._*
# Windows
Thumbs.db
ehthumbs.db
[Dd]esktop.ini
$RECYCLE.BIN/
*.stackdump
*:Zone.Identifier
# POSIX 命令在非 Windows shell 中误写出的 Windows null device 文件。
nul

# ── AI coding agent 本地状态 ──────────────────────────────────
# 国际主流
# Agent 工具私有目录整体忽略；共享说明只通过 AGENTS.md / CLAUDE.md 提交。
# 本机覆盖不入仓：CLAUDE.local.md（Claude 叠加）。
# AGENTS.override.md 会整份替换 AGENTS.md，不得当本机备注用；出现也不入仓。
.agents/
.learnings/
.claude/
.pi/
AGENTS.override.md
CLAUDE.local.md
.codex/
.cursor/
.windsurf/
.gemini/
.continue/
.aider*
.cline/
.clinerules
.roo/
.roomodes
.opencode/
.crush/
.kiro/
.amazonq/
.augment/
.specstory/
.copilot/
# 国内主流
.lingma/
.qwen/
.iflow/
.trae/
.comate/
.marscode/
.codebuddy/
.codegeex/

# AGENTS.md / CLAUDE.md 等共享 agent 指令有意提交，不在忽略范围。
# 若以后需要共享某个 agent 的项目配置，用 ! 规则逐项反向豁免。

# GitHub 代码审查自动生成的产物（含会话级 review 数据），永不入仓。
github-result-*.json

# ── Cindy/XDMaker 开发者本地工作区 ───────────────────────────
# local 模式的端点清单(restart:desktop:local 从 config/endpoint.json 生成,api/auth/device-link 指 localhost)
config/endpoint.local.json
# dev 区端点清单为本地文件(内部/自托管环境各自维护,不入仓)。
# mobile 打包静态引用该文件;缺失时从 config/endpoint.dev.json.example 复制一份。
config/endpoint.dev.json
# 发布机本地地区 / 签名配置；仓库只保留对应的 .example 文件。
apps/mobile/scripts/self-host-regions.json
apps/desktop/scripts/release-regions.json
# iOS Simulator WDA archives and native sidecars are generated locally.
apps/desktop/resources/ios-simulator/*.tar.gz
apps/desktop/resources/ios-simulator/*.tmp
apps/desktop/resources/ios-simulator/native/arm64/
apps/desktop/resources/ios-simulator/native/x86_64/
apps/desktop/resources/ios-simulator/helper/
# 客户端日志上报目标(SLS project / logstore / 区域)。真值唯一事实源在
# cindy-build-scripts 仓根,打包机由 sync-desktop-release-kit.sh 拷回;
# 仓内只保留 config/log-upload.json.example。缺失时 cn/global 打包会硬失败,
# dev 缺失则该渠道的日志上报整体关闭。
config/log-upload.json
# 视觉基线截图是开发者本地对照数据(可能截到真实会话内容),不入仓;
# 本地跑 visual-baseline-check 时会自动生成。
apps/mobile/e2e/visual-baselines/
.cindy-worktrees/
# 品牌迁移前已创建的 worktree 仍需保持 ignored。
.xdt-worktrees/
.xdtworktreeinclude
/start-claude-clean.bat
/start-claude-clean.ps1
/dev-*.bat
/dev-*.ps1

# worktree 回收豁免哨兵(会话工具生成,永不入仓)
.worktree-keep

# 会话工具临时产物(永不入仓)
tmp/
github-result-*.json

# 内置插件种子已废弃(改走 plugin-store 安装);历史克隆含私有插件与凭证,永不入仓。
apps/desktop/resources/builtin-ghosts/