kph-fork-develop-copy.md
August 14, 2026 · View on GitHub
事实: 2026-08-14 按 Owner 指示,把 knowledge-pipeline 完整物理拷贝为 /Users/louis/Documents/louisliu/kph(排除 .git、data/、outputs/、tmp/、.venv、node_modules、dist 与各类可再生缓存),并在 kph 内新建 git 仓库:默认分支 develop,以拷贝时的完整工作区状态(含原 KP 未提交的 experiments / docs 改动)为初始提交。kph 不设 remote、不 push,除非 Owner 另行指示。原 knowledge-pipeline 仓库保留为事实源与历史证据库。
Why: Owner 决定新开发基于 kph 的全新 develop 分支推进,与原仓库隔离;排除项均为 gitignored 的运行数据、历史证据或可再生产物,不影响源码完整性。
How to apply:
- 后续新开发默认在 kph 的
develop分支进行;在 kph 工作同样遵守本仓库 AGENTS.md(§0.1 仓库根目录已更新为 kph 路径)。 - 数据策略(Owner 2026-08-14 确认):kph 全部自建运行目录(
data/、outputs/、tmp/、.kp/、logs/,均在 gitignore 内),不回指原仓库。权威价格源kp_all_daily与历史证据包仍在原仓库data/stock_autocn_runtime/kp_all_daily/与outputs/;需要真实历史数据时按需从原仓库 rsync 到 kph 对应目录。 - 2026-08-14 已把悬空的原仓库绝对路径改为 kph 本地语义:AGENTS.md §6 挂载路径、
infra/stock_autocn.kp-data.override.yml默认KP_STOCK_AUTOCN_DATA_ROOT、backend/cli/rd_dynamic/preflight.pyfallback(改为仓库根相对data/stock_autocn_runtime/raw)、experiments/codex/kp_*.py的REPO(改为Path(__file__).resolve().parents[2])、docs/operations/system-deployment-operations-manual.zh.md与backend/example/kp-cli/操作文档的cd路径。 - 后端解释器固定 3.12:
pyqlib==0.9.7只有 cp311/cp312 wheel,系统默认 Python 3.14 下uv sync报Distribution pyqlib ... doesn't have a source distribution or wheel;kph 已落backend/.python-version(内容3.12,当前未提交),uv sync前先确保该文件在。 - 涉及 Docker / StockAutoCN 部署时,kph 内 compose 的
/app/data、/app/logs挂载路径以 AGENTS.md §6(kph 路径)为准。
相关:[[put-plan-runbook-docs-under-docs-plan]]、[[keep-kp-runtime-python-native]]