# Git 上传范围

断网服务器现在可使用[单文件离线部署包](deployment.md#断网服务器单压缩包部署)：在准备机上打包代码、锁文件、模型、知识快照及用户明确要求的`.env`，通过受控文件传输直接上传服务器。Python依赖由部署人员按锁文件安装。下面的Git忽略规则仍用于开发仓库；它们不会阻止`offline_release.py`把所需文件放进离线包，也无需在服务器拉取Git。

代码仓库保存可维护、可复现的项目文件及 `reference/` 原始知识资料；模型与运行结果在仓库外单独备份和分发。

| 不上传的路径 | 原因 |
| --- | --- |
| `.env`、`.env.*`（保留 `.env.example` 例外） | 本地服务地址、账号和密钥；示例只能使用占位值 |
| `.venv/`、`.uv-cache*/` | 本机解释器、安装依赖与下载缓存 |
| `models/` | 本地模型资源，单独获取 |
| `knowledge/prepared/`、`knowledge/token_stats/` | 生成的知识、摘要、统计及相关缓存 |
| `data/`、`output/`、`session/` | 运行数据、验证报告、备份及历史会话 |
| `.idea/`、`__pycache__/`、`*.py[cod]`、`*.log` | IDE 本地状态、Python 缓存和日志 |
| `.pytest_cache/`、`.ruff_cache/`、`.mypy_cache/`、`.coverage*`、`htmlcov/` | 测试、检查和覆盖率产物 |
| `build/`、`dist/`、`*.egg-info/` | Python 构建产物 |
| `~$*`、`.DS_Store`、`Thumbs.db`、`Desktop.ini` | Office 锁文件和系统元数据 |
| `AGENTS.md`、`feature_list.json`、`development-progress.md`、`session-handoff.md`、`quality-document.md`、`evaluator-rubric.md` | 本地 Harness 约定、功能证据、进度、交接和评审记录 |
| `docs/harness.md`、`scripts/check-harness.ps1`、`scripts/tests/test_init.py` | 本地 Harness 说明、检查器及配套初始化回归 |

以上规则见根目录 `.gitignore`，不会删除本地文件。

## 应保留

- `reference/` 原始知识 JSON、CSV、Excel 等资料，按用户要求随仓库保留；其中 Office 临时锁文件 `~$*` 仍忽略。
- `src/` 全部业务代码、提示词、分类配置与合成测试数据；`scripts/` 和 `init.ps1`。
- `pyproject.toml`、`uv.lock`、`.python-version`、`.gitignore`。
- `knowledge/` 中的 Markdown 说明和 `templates/` 模板。
- `README.md`、`docs/`；其中 `docs/法人标签表.xlsx` 是标签快照的来源，分类测试核对它的哈希及内容，需与 `src/company_classification/taxonomy.json` 一起维护。
- `init.ps1` 和 `scripts/check-runtime.py` 保留，供克隆仓库后初始化环境。`scripts/` 中上述 Harness 检查器和配套回归除外。

不要按扩展名整体排除 JSON、Excel 或 Markdown，否则会漏掉配置、测试样例、标签源表或提示词。

## 新机器与上传前检查

克隆仓库后按 README 初始化依赖，另行配置 `.env`、获取模型，再使用仓库内的 `reference/` 按知识整理与入库说明生成本地知识及检索快照。只克隆代码不能直接完成真实知识问答；被忽略的运行资料仍需独立备份。

Harness 文件仅本地保留，不随仓库上传。`init.ps1` 在本地检查器存在时继续执行检查；克隆仓库不含检查器时直接初始化环境。`-CheckOnly` 专用于本地 Harness，缺少检查器时会明确报错。

上传前执行：

```powershell
git status --short
git ls-files --others --exclude-standard
git check-ignore -v .env models/ knowledge/prepared/
```

`.gitignore` 只影响未跟踪文件；已跟踪文件和历史提交不会自动消失。检查暂存内容后再自行提交与推送。本次整理不构成完整秘密扫描或历史审计。