# Python-related files
__pycache__/
*.py[cod]
*.egg-info/
.eggs/
*.tgz
*.tar.gz
*.ini

# Virtual Environment
.venv/
venv/

# Lock files
uv.lock

# Enviroment Variable Files
.env
.env.backup.*
deploy/.env.rag
.env.local

# Generated Docker Compose files (output of setup wizard)
docker-compose.*.yml
deploy/docker-compose.yml.bak*
!docker-compose.podman.yml

# Build / Distribution
dist/
build/
site/

# Logs / Reports
*.log
*.log.*
*.logfire
*.coverage/
log/

# Caches
.cache/
.mypy_cache/
.pytest_cache/
.ruff_cache/
.gradio/
.history/
temp/

# IDE / Editor Files
.idea/
.vscode/
.vscode/settings.json

# Framework-specific files
local_neo4jWorkDir/
neo4jWorkDir/

# Data & Storage
inputs/
output/
rag_storage/
data/

# Runtime-provided entity type prompt profiles (keep sample files only)
prompts/entity_type/

# Evaluation results
lightrag/evaluation/results/

# Miscellaneous
.DS_Store
TODO.md
ignore_this.txt
*.ignore.*

# Project-specific files
/dickens*/
/book.txt
/ag2_demo_workdir/

# Frontend build output (built during PyPI release)
/lightrag/api/webui/

# temporary test files in project root
/test/
/test_*
/tests/

# Cline files
memory-bank
.claude/CLAUDE.md
.claude/

# Claude Code
CLAUDE.md
.planning/
claude_ignore

# Test files — keep local, never commit
mcp_server/tests/
tests/unit/
.beads

# Google Jules
.jules/

# native_parser/docx CLI output (audit JSONL + image dir)
/parse_output/
*/*/node_modules/
*/node_modules/
__pycache__/
*.py[cod]
*$py.class
*.so

# ===== 测试 / 覆盖率 / 工具缓存 =====
.pytest_cache/
.coverage
.coverage.*
coverage.xml
htmlcov/
.tox/
.mypy_cache/
.ruff_cache/
.hypothesis/

# ===== 打包产物 =====
build/
dist/
data/
*.egg-info/
*.egg
*.tar
*.tar.gz
*.whl
*.zip

# ===== uv 包管理器 =====
# 例外：uv.lock 纳入版本控制，供团队/CI/镜像构建共用同一份（uv 官方推荐），
# 保证依赖解析可复现
!/uv.lock
!mcp_server/uv.lock
!Reference/Rag-anything/uv.lock
!Reference/JonexWiki/uv.lock

# ===== 虚拟环境 =====
.venv/
.venv-atomic-rag/
venv/
env/

# ===== IDE / 编辑器 =====
.idea/
.vscode/
.kiro/
*.sw?
*.suo
*.ntvs*
*.njsproj
*.sln

# ===== 系统垃圾 =====
.DS_Store
Thumbs.db

# ===== 日志 =====
logs/
*.log

# ===== 本地数据 =====
*.sqlite
*.sqlite3
*.db

# ===== 前端 (frontends) =====
frontends/**/node_modules/
frontends/**/dist/
frontends/**/dist-ssr/
frontends/**/*.local
frontends/**/npm-debug.log*
frontends/**/yarn-debug.log*
frontends/**/yarn-error.log*
frontends/**/pnpm-debug.log*
frontends/**/lerna-debug.log*


# ===== 环境变量（保留 .env.example） =====
.env
.env.*
!.env.example
!.env.local.example

!.env.rag.local.example
deploy/.env
deploy/.env.*

# Local-only scratch files
yuexi.ps1.bak
frontends/dev-gateway/package-lock.json
!deploy/.env.example
!deploy/.env.rag.example
!mcp_server/.env.mcp.example
!deploy/.env.mcp.example
!deploy/.env.openkb.example
!deploy/.env.jonex_wiki.example

# ===== Reference 引用项目（排除非项目文件） =====
Reference/Rag-anything/.github/
Reference/Rag-anything/output/
Reference/Rag-anything/rag_storage*/
Reference/Rag-anything/.claude/

# LightRAG 源码集成（保留 lightrag/ 与 lightrag_webui/ 源码及构建元数据，
# 排除 .git / 虚拟环境 / 生成数据 / 缓存等运行期产物）
# 例外：uv.lock 属于镜像构建元数据，须纳入版本控制（lightrag-source.Dockerfile
# 会 COPY 并 uv sync --frozen，否则首次 clone 后构建镜像会因缺文件报错）
!Reference/LightRAG/uv.lock
Reference/LightRAG/.git/

# OpenKB 源码集成 — 同上，openkb-source.Dockerfile 构建需要 uv.lock
!Reference/OpenKB/uv.lock
Reference/LightRAG/.github/
Reference/LightRAG/.venv/
Reference/LightRAG/venv/
Reference/LightRAG/data/
Reference/LightRAG/rag_storage*/
Reference/LightRAG/inputs/
Reference/LightRAG/output/
Reference/LightRAG/output_complete/
Reference/LightRAG/dickens/
Reference/LightRAG/reproduce/
Reference/LightRAG/**/__pycache__/
Reference/LightRAG/**/*.egg-info/
Reference/LightRAG/.pytest_cache/
Reference/LightRAG/.mypy_cache/
Reference/LightRAG/.ruff_cache/
Reference/LightRAG/.env
Reference/LightRAG/lightrag_webui/node_modules/
Reference/LightRAG/lightrag_webui/dist/
rag_service_data/

# ===== Git Worktrees =====
.worktrees/

# ===== CodeGraph =====
.codegraph/

# ===== Claude / Memory（保留原约定） =====
/.claude/
/memory/
test-results
.mcp.json
.playwright-mcp
capability_runtime.local.yaml
.lightrag_data

# Beads / Dolt files (added by bd init)
.dolt/
.beads-credential-key

# Agent 配置文件
AGENTS.md

# Husky 内部框架文件
.husky/_/
CLAUDE.md.orig

# ===== Superpowers（SDD 运行账本与规格/计划文档，不入库） =====
# 仅根级：Reference/ 引用仓库的历史 superpowers 文档不受影响
/.superpowers/
/docs/superpowers/
poc

# Beads / Dolt files (added by bd init)
.beads/proxieddb/

# 本地 dolt 全局配置重定向（沙箱内 HOME 规避用，非项目状态）
.bd-home/
.codex
.agents
.pnpm-store
deploy/.env-aws

# ===== TLS 证书与私钥 =====
# 一律不进版本库。证书由运行期 volume 挂载（TLS_CERT_DIR 指向仓库外路径），
# 见 docs/https-domain-access-plan.md 5.6 / 5.10
*.key
*.crt
*.pem
*.csr
*.pfx
*.p12
certs/
**/certs/

# ===== 内部文档与内部资料（本地保留，禁止入库/推送公开仓库） =====
# —— 仓库根的内部资料 ——
/ARCHITECTURE_REFACTOR_SUMMARY.md
/PROJECT_ISSUES_AND_TODO.md
/README_GITHUB.md
/backend-development-standard.md
/frontend-development-standard.md
/dev-guide.macos.md
/dev-guide.windows.md
/server-local-frontend-dev-guide.md
/frontends/core-business/CLAUDE.md
# —— docs/ 下为内部设计文档与执行计划（仅公开素材与既有文档入库）——
/docs/*
!/docs/assets/
!/docs/assets/**
!/docs/dev/
!/docs/examples/
# —— 其余内部文档 ——
# 各引用项目自带的 docs/ 一律不入库（vendored 项目的内部文档，防止同步时漏网）
/Reference/*/docs/
# 客户定制领域本体（含真实业务语料引用），不入库
/deploy/config/ontology/nanfang_publishing.yaml
# 视频/OCR 部署栈（内部环境专用，不入库）
/deploy/ocr-stack/
/deploy/mineru-video/
# frontends/ 下的误提交杂项
/frontends/_tc.txt
# frontends/ 内部文档（设计/i18n 计划等，不入库）
/frontends/docs/
/frontends/translateDocs/
/frontends/i18n-status.md
# —— 发布台账（记录每次同步/发布的改动与 dev 基线，本地保留，不入库）——
/.release-log/
