.gitignore

# =============================================================================
# AgentOS .gitignore 文件
# 版本：9.0.0
# 最后更新：2026-04-19
# 说明：规范化排除所有不应纳入版本控制的文件和目录
#
# 设计原则：
# 1. 构建产物一律排除（CMake 缓存、编译产物等）
# 2. 运行时生成的文件一律排除（数据库、日志、模型等）
# 3. 本地开发配置一律排除（.env.local、IDE 配置等）
# 4. 空目录通过 .gitkeep 保留，但排除目录内容
# 5. 项目必需文件使用否定规则明确保留
# 6. 通配符规则限定作用范围，避免意外排除项目必需文件
#
# V9.0.0更新（全面强化版）：
# - 强化构建产物排除规则
# - 增加本地文档/临时脚本防护
# - 明确项目必需文件白名单
# - 防止意外追踪非源码文件
#
# V8.3.0更新：
# - 添加 **/CTestTestfile.cmake 排除CMake测试配置文件
# - 添加 agentos/daemon/*/agentos-* 排除daemon编译可执行文件
# - 添加 agentos/daemon/gateway_d/gateway_d 排除gateway可执行文件
#
# 项目模块结构（2026-04-14 V8.1 校正后）：
# 核心模块 (agentos/)
#   - atoms/       : 原子内核 (40,917行, A+评级)
#   - atomslite/   : 轻量级原子模块
#   - commons/     : 统一基础库 (S级, 97.1分)
#   - cupolas/     : 安全穹顶 (A++评级, 97.5分)
#   - daemon/      : 用户态服务 (S+评级, 96.5分)
#   - gateway/     : 统一网关 (A+评级)
#   - heapstore/   : 运行时数据存储 (A评级, 98%生产就绪)
#   - manager/     : 统一配置管理
#   - openlab/     : 开放生态 (已移动到 agentos/)
#   - protocols/   : 行业协议适配
#   - toolkit/     : 多语言 SDK 工具 (35,638行, 4语言)
#   - interfaces/  : 统一接口定义
#
# 文档模块
#   - docs/        : 项目文档 (原 manuals/)
#
# 辅助模块
#   - scripts/     : 构建和运维脚本
#     - desktop-client/ : 桌面客户端 (Tauri)
#   - tests/       : 测试框架 (A+认证, 98.5分)
#   - .gitcode/    : CI/CD配置 (V3.0优化后，统一管理)
# =============================================================================

# =============================================================================
# 本地文档（不追踪，仅保留在本地）
# =============================================================================

CHANGELOG.md

# =============================================================================
# 修复记录目录（本地工作记录，不追踪）
# 注意：.bendiwenjian/ 目录整体排除，但总线检查报告需保留
# Git 机制要求：父目录排除后，必须逐级否定才能重新包含子文件
# =============================================================================

.bendiwenjian/
.bendiwenjian/总线检查/
.bendiwenjian/总线检查/*.md
.cargo/
.atomcode/
datalog/
build_no_daemon/
# =============================================================================
# 1. CMake 构建系统（构建产物，不追踪）
# =============================================================================

CMakeCache.txt
CMakeFiles/
cmake_install.cmake
cmake_install.*
CMakeUserPresets.json
CMakePresets.json

# CMake生成的Makefile（递归排除所有子目录）
**/Makefile

# CMake自动生成的版本配置文件
**/AgentOSConfigVersion.cmake

# CMake自动生成的测试配置文件
**/CTestTestfile.cmake

# 编译生成的可执行文件（无扩展名，按daemon命名规则）
agentos/daemon/*/agentos-*
agentos/daemon/gateway_d/gateway_d

# CMake 构建目录
build/
build_test/
build_test_protocol/
_build/
cmake-build*/
cmake-build-debug/
cmake-build-release/
cmake-build-coverage/

# 外部构建目录（Out-of-Source Build）
# 所有构建产物统一输出到此目录，保持源码仓库纯净
AgentOS-build/

# CMake 构建输出目录（库和可执行文件）
agentos/lib/
agentos/bin/

# 编译器数据库（IDE 工具生成）
compile_commands.json
compile_flags.txt
compile_commands/*.json

# =============================================================================
# 2. 编译产物（构建时生成，不追踪）
# =============================================================================

# 目标文件
*.o
*.obj
*.so
*.so.*
*.dll
*.dll.a
*.dylib
*.lib
*.a
*.la
*.lai
*.d

# 可执行文件
*.exe
*.exe.manifest
*.out
*.app

# 预编译头
*.pch
*.gch
*.pch.gch

# =============================================================================
# 3. Python 相关（运行时生成，不追踪）
# =============================================================================

# Python 缓存
__pycache__/
*.py[cod]
*$py.class
*.pyo
*.pyd
.Python
*.pyc
*.pyc.*

# 虚拟环境
venv/
env/
ENV/
.venv/
.python-version
.venv.bak/

# Python 包管理产物
*.egg-info/
*.egg
*.dist-info/
*.pydist-info/
dist/
wheels/
*.whl

# Poetry
.poetry/
poetry.lock

# Pipenv
Pipfile.lock

# 测试和覆盖率
.pytest_cache/
.coverage
.coverage.*
coverage/
htmlcov/
coverage.xml
.tox/
.nox/

# Jupyter
.ipynb_checkpoints/
profile_default/
ipython_config.py
ipython_kernel_config.py

# 类型检查缓存
.mypy_cache/
.dmypy.json
dmypy.json
.ruff_cache/

# =============================================================================
# 4. Go 语言 SDK（构建产物，不追踪）
# =============================================================================

agentos/toolkit/go/vendor/
agentos/toolkit/go/go.sum
agentos/toolkit/go/*.exe
agentos/toolkit/go/testsuite/
agentos/toolkit/go/coverage/
agentos/toolkit/go/*.test
cover.out
cover.html

# =============================================================================
# 5. Rust 语言 SDK（构建产物，不追踪）
# =============================================================================

agentos/toolkit/rust/target/
Cargo.lock
agentos/toolkit/rust/debug/
agentos/toolkit/rust/release/
agentos/toolkit/rust/doc/
agentos/toolkit/rust/target/doc/

# =============================================================================
# 6. TypeScript/JavaScript SDK（构建产物，不追踪）
# =============================================================================

agentos/toolkit/typescript/node_modules/
agentos/toolkit/typescript/dist/
agentos/toolkit/typescript/build/
agentos/toolkit/typescript/coverage/
agentos/toolkit/typescript/.tsbuildinfo
agentos/toolkit/typescript/.pnpm-store/
agentos/toolkit/typescript/tsbuildinfo/
.next/
.nuxt/

# =============================================================================
# 7. 环境变量和敏感配置（本地配置，不追踪）
# =============================================================================

# 环境文件
*.env
.env.local
.env.*.local
.env.dev
.env.test
.env.production

# 密钥和证书
*.pem
*.key
*.crt
*.cer
*.der
*.p12
*.pfx
*.jks
*.keystore
secrets.json
secrets.yaml
secrets.yml
credentials.json
service_account.json
oauth/
.token

# 本地配置覆盖
manager.local.yaml
manager.local.yml
manager.*.local.yaml
manager.*.local.yml
settings.local.py
local_settings.py
override.yaml

# =============================================================================
# 8. IDE 和编辑器配置（本地开发配置，不追踪）
# =============================================================================

# Visual Studio Code
.vscode/
*.code-workspace
*.code-snippets
.vscode-test/

# JetBrains 系列
.idea/
*.iml
*.ipr
*.iws
out/
*.hprof
*.heap
*.clion/

# Vim
*.swp
*.swo
*~
.netrwhist
*.un~
.\#*
*.elc

# Sublime Text
*.sublime-project
*.sublime-workspace

# Xcode
*.xcodeproj/
*.xcworkspace
*.xcuserstated
*.xccheckout
*.pbxuser
*.perspectivev3

# Visual Studio
*.suo
*.user
*.userosscache
.sln.docstates
[Dd]ebug/
[Rr]elease/
x64/
x86/
bld/
[Bb]in/
[Oo]bj/

# Eclipse
.classpath
.project
.settings/

# =============================================================================
# 9. 日志、数据库和运行时文件（运行时生成，不追踪）
# =============================================================================

# 日志文件
*.log
logs/
*.logs
agentos/heapstore/logs/

# 数据库文件
*.db
*.db-shm
*.db-wal
*.sqlite
*.sqlite3
*.db.sqlite
*.db-journal
agentos/heapstore/registry/*.db
agentos/heapstore/registry/*.sqlite
agentos/heapstore/db/
registry.db
registry.sqlite

# 追踪和性能数据
agentos/heapstore/traces/
*.trace
*.spans
*.prof
*.profraw
*.gcda
*.gcno

# 缓存
.cache/
*.cache
tmp/
temp/
*.bak
*.backup
*.orig

# =============================================================================
# 10. agentos/heapstore/ 运行时目录（运行时生成，仅保留空路径）
# =============================================================================

# kernel/ 子目录（排除内容，保留 .gitkeep）
agentos/heapstore/kernel/ipc/binder/*
!agentos/heapstore/kernel/ipc/binder/.gitkeep
agentos/heapstore/kernel/ipc/channels/*
!agentos/heapstore/kernel/ipc/channels/.gitkeep
agentos/heapstore/kernel/memory/index/*
!agentos/heapstore/kernel/memory/index/.gitkeep
agentos/heapstore/kernel/memory/meta/*
!agentos/heapstore/kernel/memory/meta/.gitkeep
agentos/heapstore/kernel/memory/raw/*
!agentos/heapstore/kernel/memory/raw/.gitkeep
agentos/heapstore/kernel/memory/patterns/*
!agentos/heapstore/kernel/memory/patterns/.gitkeep

# services/ 子目录（排除内容，保留 .gitkeep）
agentos/heapstore/services/llm_d/*
!agentos/heapstore/services/llm_d/.gitkeep
agentos/heapstore/services/market_d/*
!agentos/heapstore/services/market_d/.gitkeep
agentos/heapstore/services/tool_d/*
!agentos/heapstore/services/tool_d/.gitkeep

# models/ 子目录（排除内容，保留 .gitkeep）
agentos/heapstore/models/*
!agentos/heapstore/models/.gitkeep

# 其他运行时目录
agentos/heapstore/logs/*
agentos/heapstore/traces/*
agentos/heapstore/registry/*
agentos/heapstore/db/*
!agentos/heapstore/logs/.gitkeep
!agentos/heapstore/traces/.gitkeep
!agentos/heapstore/registry/.gitkeep
!agentos/heapstore/db/.gitkeep

# =============================================================================
# 11. 测试相关（测试结果不追踪，测试代码保留）
# =============================================================================

# 测试结果和报告
test-results/
test_output/
*.spec
*.snapshot

# 测试覆盖率
*.gcov

# 测试数据（运行时生成）
test_data/generated/
*.test.data
tests/fuzz/*.fuzz
tests/fuzz/corpus/
tests/fuzz/seeds/
tests/fuzz/hangs/

# 基准测试结果
tests/benchmarks/**/results/
tests/benchmarks/**/plots/
tests/benchmarks/**/reports/
*.benchmark
benchmark_results/
perf_results/

# tests/benchmarks/concurrency/report/（排除内容，保留 .gitkeep）
tests/benchmarks/concurrency/report/*
!tests/benchmarks/concurrency/report/.gitkeep

# =============================================================================
# 12. 文档生成（构建产物，不追踪）
# =============================================================================

manuals/_build/
manuals/.doctrees/
manuals/doctrees/
doxygen/
xml/
html/
latex/
man/
site/
manuals/architecture/diagrams/*.svg
manuals/architecture/diagrams/*.png
manuals/architecture/diagrams/*.pdf
toolkit/go/doc/

# =============================================================================
# 13. 操作系统文件（系统生成，不追踪）
# =============================================================================

# macOS
.DS_Store
.AppleDouble
.LSOverride
._*
.fseventsd
.Spotlight-V100
.TemporaryItems
.Trashes
.VolumeIcon.icn
.apdisk

# Windows
Thumbs.db
ehthumbs.db
Desktop.ini
$RECYCLE.BIN/
@eaDir/
*.lnk
*.url

# Linux
.fuse_hidden*
.Trash-*
.nfs*

# =============================================================================
# 14. 依赖管理（本地安装，不追踪）
# =============================================================================

vendor/
vendor/bundle/
Gemfile.lock
composer.lock
Carthage/Build/
.swiftpm/

# =============================================================================
# 15. 大型文件和二进制文件（运行时生成，不追踪）
# =============================================================================

# FAISS 索引
agentos/heapstore/models/*.faiss
agentos/heapstore/models/*.index
agentos/heapstore/models/*.pkl
agentos/heapstore/models/*.pickle

# 模型权重
agentos/heapstore/model/
agentos/heapstore/models/*.bin
agentos/heapstore/models/*.pth
agentos/heapstore/models/*.h5
agentos/heapstore/models/*.pt
agentos/heapstore/models/*.onnx
*.tflite

# 向量和嵌入
*.npy
*.npz
*.parquet
*.arrow
*.feather

# 数据集（仅排除根目录数据目录）
/data/
/datasets/

# 压缩包（仅排除构建和部署目录下的）
deploy/**/*.tar.gz
deploy/**/*.tar.bz2
deploy/**/*.tar.xz
deploy/**/*.zip
deploy/**/*.rar
deploy/**/*.7z

# Docker 和 Kubernetes
deploy/docker/*.tar
deploy/docker/*.tar.gz
deploy/docker/.docker-*/
docker-compose.override.yml
.docker/
*.kubeconfig
.kube/

# =============================================================================
# 16. 部署和安装（构建产物，不追踪）
# =============================================================================

deploy/artifacts/
deploy/packages/
scripts/deploy/artifacts/
scripts/deploy/packages/
install/
installed/
VERSION
version.txt
build_version.txt

# =============================================================================
# 17. 代码质量工具缓存（运行时生成，不追踪）
# =============================================================================

.pre-commit-manager.local.yaml
.eslintcache
tools/eslint/.eslintcache
.prettierrc.local
.prettierignore.local
.flake8
*.flake8
.pylintrc.local
.pylint.d/
cppcheck.local.xml
.semgrep.local.yaml
.lizard.out
.jscpd/
.jscpd-store/
.scannerwork/
sonar-report.json
.clangd/
.cache/clangd/

# =============================================================================
# 18. 本地开发文档（临时文件，不追踪）
# =============================================================================

*.draft
*.todo
*.notes
DRAFT*
NOTES*
TODO*
CHANGELOG.local.md
CHANGELOG.local
*.md.bak
*.md.backup
README.local.md
README.local
*.tmp
*.tmp.sh
*.tmp.bat
*.tmp.ps1
temp_*
tmp_*
*.personal
*.private
*.local
settings.local
override.local
docs/local/
docs/private/
wiki/
agentos/heapstore/reports/
reports/
test_reports/
coverage_reports/

# 本地生成的分析/检查报告（非项目必需）
*检查报告*.md
*验证报告*.md
*分析报告*.md
*评估报告*.md
*穷尽检查*.md

# 本地工作记录目录（历史档案除外）
.bendiwenjian/
.bendiwenjian/总线检查/
.bendiwenjian/总线检查/*.md

# =============================================================================
# 19. 桌面客户端（Tauri 构建产物，不追踪）
# =============================================================================

# Tauri 构建产物
scripts/desktop-client/src-tauri/target/
scripts/desktop-client/dist/
scripts/desktop-client/node_modules/

# 前端构建缓存
scripts/desktop-client/.vite/
scripts/desktop-client/.turbo/
scripts/desktop-client/.cache/
scripts/desktop-client/.temp/
scripts/desktop-client/coverage/

# Tauri 配置和生成文件
scripts/desktop-client/src-tauri/WixTools/
scripts/desktop-client/src-tauri/gen/
scripts/desktop-client/src-tauri/Cargo.lock

# 包管理器日志
scripts/desktop-client/npm-debug.log*
scripts/desktop-client/yarn-debug.log*
scripts/desktop-client/yarn-error.log*
scripts/desktop-client/pnpm-debug.log*

# 环境文件
scripts/desktop-client/.env
scripts/desktop-client/.env.local
scripts/desktop-client/.env.production.local

# =============================================================================
# 20. docker/ 和 docs/ 目录（保留配置文件，排除运行时产物）
# =============================================================================

# docker/ 目录（保留配置文件，排除运行时产物）
docker/*.log
docker/*.tar
docker/*.tar.gz
docker/volumes/
docker/.docker-*/

# docs/ 目录（保留源文件，排除构建产物）
docs/_build/
docs/.doctrees/
docs/doctrees/
docs/html/
docs/latex/
docs/man/
docs/site/
docs/*.svg
docs/*.png
docs/*.pdf

# Doxygen API 文档输出（保留源文件 mainpage.dox）
docs/api/html/
docs/api/xml/
docs/api/latex/
docs/api/man/

# =============================================================================
# 21. 必须保留的例外（项目必需文件）
# =============================================================================

# 环境模板
!.env.example

# agentos/manager/ 配置文件
!agentos/manager/*.yaml
!agentos/manager/*.yml
!agentos/manager/*.template
!agentos/manager/*.schema.json
!agentos/manager/.env.template

# 关键文档
!docs/**/*.md
!CONTRIBUTING.md
!AUTHORS.md
!SECURITY.md
!SUPPORT.md
!CODE_OF_CONDUCT.md
!NOTICE
!ACKNOWLEDGMENTS.md

# 构建和运维脚本
!scripts/**/*.sh
!scripts/**/*.py
!scripts/**/*.bat
!scripts/**/*.ps1
!scripts/**/*.yml
!scripts/**/*.yaml
!scripts/deploy/docker/.gitignore

# scripts/development/ 开发配置
!scripts/development/config/.clang-format
!scripts/development/config/.clangd
!scripts/development/config/.editorconfig
!scripts/development/config/.lizardrc
!scripts/development/config/.jscpd.json
!scripts/development/config/.pre-commit-config.yaml
!scripts/development/config/vcpkg.json
!scripts/development/quickstart.sh
!scripts/development/validate.sh

# 测试框架
!tests/**/*.py
!tests/**/*.sh
!tests/**/*.yaml
!tests/**/*.yml
!tests/**/*.c
!tests/**/*.h
!tests/**/*.go
!tests/**/*.rs
!tests/.coveragerc
!tests/.gitkeep
!tests/benchmarks/**/*.gitkeep
!tests/benchmarks/concurrency/report/.gitkeep
!tests/unit/sdk/python/.gitkeep
!tests/unit/sdk/rust/.gitkeep
!tests/unit/services/llm_d/.gitkeep
!tests/unit/services/tool_d/.gitkeep
# 手写Makefile（非CMake生成，需保留）
!tests/Makefile
!scripts/deployment/docker/Makefile

# Docker 配置
!Dockerfile*
!docker-compose*.yml
!deploy/docker/Dockerfile*
!agentos/openlab/Dockerfile
!agentos/gateway/docker/Dockerfile*
!agentos/daemon/Dockerfile.ci
!scripts/deploy/docker/Dockerfile*
!docker/Dockerfile*
!docker/docker-compose*.yml

# CMake 构建配置
!agentos/atoms/**/CMakeLists.txt
!agentos/atomslite/**/CMakeLists.txt
!agentos/commons/**/CMakeLists.txt
!agentos/commons/tests/CMakeLists.txt
!agentos/cupolas/CMakeLists.txt
!agentos/daemon/**/CMakeLists.txt
!agentos/gateway/CMakeLists.txt
!agentos/heapstore/**/CMakeLists.txt
!tests/unit/**/CMakeLists.txt

# 根目录项目配置
!pyproject.toml

# agentos/toolkit/ 配置文件
!agentos/toolkit/python/pyproject.toml
!agentos/toolkit/python/setup.py
!agentos/toolkit/go/go.mod
!agentos/toolkit/rust/Cargo.toml
!agentos/toolkit/typescript/package.json
!agentos/toolkit/typescript/tsconfig.json
!agentos/toolkit/typescript/jest.config.js

# openlab/ 配置文件
!agentos/openlab/pyproject.toml
!agentos/openlab/requirements.txt

# 空目录 .gitkeep
!agentos/commons/utils/types/.gitkeep

# =============================================================================
# 22. 平台模板目录（项目必需，保留）
# =============================================================================

# .gitcode/ 是平台模板目录，随仓库同步
# 包含 CI/CD 工作流、Issue 模板、PR 模板等

# =============================================================================
# 23. 强化防护规则（V9.0新增）
# =============================================================================

# 23.1 防止意外追踪非源码文件（白名单模式）
# 只有以下类型的文件应该被git追踪：
# - 源码: *.c, *.h, *.py, *.ts, *.tsx, *.rs, *.go, *.js
# - 配置: CMakeLists.txt, *.yml, *.yaml, *.json, *.toml
# - 文档: *.md (仅项目必需文档)
# - 脚本: *.sh, *.bat, *.ps1
# - 其他: Dockerfile*, .gitignore, .gitkeep, LICENSE, NOTICE

# 23.2 本地生成的临时脚本（不追踪）
*.local.sh
*.local.py
*.local.bat
*debug*.sh
*test-local*.sh
*quick-test*.sh

# 23.3 IDE/编辑器工作区文件（强化排除）
*.workspace
*.code-workspace
.vscode/*.json
!.vscode/settings.json
!.vscode/tasks.json
!.vscode/launch.json

# 23.4 操作系统元数据（强化排除)
.fuse_hidden*
.nfs*
.Trashes*
.apdisk
._*

# 23.5 项目根目录特殊文件（明确保留）
!LICENSE
!NOTICE
!.gitattributes
!.gitcode/CODEOWNERS

# =============================================================================
# 结束
# =============================================================================
#
# V9.0.0 维护说明：
# 1. 添加新规则时，必须验证不会误排除项目必需文件
# 2. 使用 git check-ignore -v <file> 验证规则生效
# 3. 定期运行 git status --porcelain 检查是否有意外追踪的文件
# 4. 项目必需文件必须在第21节有明确的否定规则(!前缀)
#