kph-fork-develop-copy.md

August 14, 2026 · View on GitHub

事实: 2026-08-14 按 Owner 指示,把 knowledge-pipeline 完整物理拷贝为 /Users/louis/Documents/louisliu/kph(排除 .gitdata/outputs/tmp/.venvnode_modulesdist 与各类可再生缓存),并在 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_ROOTbackend/cli/rd_dynamic/preflight.py fallback(改为仓库根相对 data/stock_autocn_runtime/raw)、experiments/codex/kp_*.pyREPO(改为 Path(__file__).resolve().parents[2])、docs/operations/system-deployment-operations-manual.zh.mdbackend/example/kp-cli/ 操作文档的 cd 路径。
  • 后端解释器固定 3.12pyqlib==0.9.7 只有 cp311/cp312 wheel,系统默认 Python 3.14 下 uv syncDistribution 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]]