git-upload.md 3.9 KB
Git 上传范围
断网服务器现在可使用单文件离线部署包：在准备机上打包代码、锁文件、模型、知识快照及用户明确要求的.env，通过受控文件传输直接上传服务器。Python依赖由部署人员按锁文件安装。下面的Git忽略规则仍用于开发仓库；它们不会阻止offline_release.py把所需文件放进离线包，也无需在服务器拉取Git。
代码仓库保存可维护、可复现的项目文件及 reference/ 原始知识资料；模型与运行结果在仓库外单独备份和分发。
| 不上传的路径 | 原因 |
|---|---|
.env、.env.*（保留 .env.example 例外） |
本地服务地址、账号和密钥；示例只能使用占位值 |
.venv/、.uv-cache*/ |
本机解释器、安装依赖与下载缓存 |
models/ |
本地模型资源，单独获取 |
knowledge/prepared/、knowledge/token_stats/ |
生成的知识、摘要、统计及相关缓存 |
knowledge/prepared-talent/ 及其历史/临时发布目录 |
人才客服生成知识、摘要和向量缓存；原始资料在 reference/人才客服/ 中随仓库维护 |
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/按Agent分目录存放原始知识；现有15份资料在reference/营商助手/，其他Agent后续分别使用同级目录。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，缺少检查器时会明确报错。
上传前执行：
git status --short
git ls-files --others --exclude-standard
git check-ignore -v .env models/ knowledge/prepared/
.gitignore 只影响未跟踪文件；已跟踪文件和历史提交不会自动消失。检查暂存内容后再自行提交与推送。本次整理不构成完整秘密扫描或历史审计。