KP Agent Memory 索引

更新日期：2026-08-14

本目录是 KP 仓库共享、已提交的 agent memory（与 gitignored 的 .memory/、~/.claude 全局 memory 不同——见 README.md）。所有 agent 在 AGENTS.md §3.0 上下文发现时检索此索引，命中即复用。

用户偏好 (user)

• 用户是 quant 架构者及其验收偏好 — peer-level 直接评估、可证伪验收、诚实负结果记账、中文沟通
• Plan/spec 文件名使用中文 — 后续新增 docs/plan/ 下的 plan/spec/PRD/runbook 等 Markdown，用中文语义文件名和中文链接显示名
• 外部研究默认优先 DeepSeek V4 Flash — 新研究入口默认使用 deepseek-v4-flash；Pro 仅用于显式指定、兼容验证或 A/B 对照

纠错 / 反馈 (feedback)

• 股票池历史数据包必须包含逐标的历史 — 用户要求若干标的的历史数据时，指数日线和成分表不能替代逐标的日线；交付必须包含合并/逐标的文件、覆盖率与截断检查
• 页面/API 取证必须绑定已验证运行面 — dev、本地后端和 Docker 必须分栏取证，并区分新回归与被新入口暴露的存量缺陷
• 浮点证据 hash 必须做跨架构语义规范化 — 区分 raw/semantic hash，持久 cache 绑定 numeric policy/runtime fingerprint，并做跨架构 golden test
• Freshness 漏检按 P0 真实性风险处理 — 仅靠 mtime/size 的落盘 cache 会让过期证据跨重启/重建延续，必须用 manifest/content hash 回归
• Authority 清理按数据考古估算 — 标记冲突、路径丢失和测试污染时必须预留取证、quarantine 与人工复核
• 按模型可见 treatment 路由评测 — 模型不可见的内部 Python 重构用 canonical request 等价与差分回放验证，powered 因子预算只用于真实模型可见变化
• 保持 KP runtime 为 Python 原生 — 外部框架只作设计与行为参考，KP 不增加 TypeScript、Node.js、npm 运行依赖或跨语言 sidecar
• 使用本地 Pi 源码作只读参照 — Pi 已在本机 clone；优先绑定本地 commit 并只读对照，不重复联网、修改或引入其 runtime
• 引入框架前先做原生归因对照 — 默认先用最小原生对照和 residual gate；owner 明确批准的 Python 原生基础能力可作为登记例外，但仍不得引入外部 runtime
• 已批准 goal 必须连续完成 — 设计 bundle 在启动前批准后，同一 goal 连续完成全部已授权里程碑，不重复等待 Review 或设置计划性暂停
• 优先验证因子发散与因子发现能力 — KP loop 以发散挖掘和尽快进入验证为主，最小 canary 后立即研究，非必要前置校验与治理后置
• RD loop 默认调用 deepseek-v4-flash 且不设次数上限 — 每一轮至少一次真实、可审计的 deepseek-v4-flash 调用；不预设调用次数上限，只有 Owner 明确授权该轮不调用时才允许 Provider wire budget 为 0
• RD loop 只挑战当前最佳并采用双研究轨 — 正式 BEAT 只比较唯一权威当前最佳；Track A 深挖现有策略，Track B 探索不同或正交维度
• 所有 Loop Goal 必须明确目标与方法论 — Goal Plan、Spec 首页、review 包和对外汇报都先讲清目标、挑战对象、因果方法、LLM 角色、验证与成功失败标准，工程治理细节后置
• Provider credential 不以 quota/限额为启动 gate — 只检查 credential 配置与真实调用认证结果，不把 quota、余额或限额未知列为 blocker，也不为此额外探测
• Loop Goal 统一称为生成六大原则 — 六轨反思与 Goal 投影统一使用“Loop Goal 生成六大原则”，不再使用旧组合命名
• 未经核实不得断言自动/保证生效 — 声称 check 会自动拦截前，先验证 CI/hook/test 触发接线
• 先沉淀约定再建强制器 — 新约定先写进 AGENTS.md 单源，不急于建 CI/test/hook（除非明确要求）
• KP B+/A spec 推进中不要把前端 dashboard 作为完成阻塞项 — 本轮验收面是后端 API、artifact、CLI、runbook 和真实证据，不修改 frontend/
• 外部/日历/人工证据缺口可标记 blocked，不阻塞 B+/A spec loop 核心工程收口 — 先保证 8 个 spec 的模块、CLI、API、artifact、fail-closed 合同、测试和文档完成；真实数据、fresh 周、native metrics、人工演练等不可由本轮伪造的缺口标记 blocked
• 维护性 gate 必须被消费为真 blocker — 新增维护性 / silent-failure / god-file / 预算类 gate 时，必须验证 weekly review、dashboard、real-money gate 或等价入口读取并阻断；artifact-only 不算生效
• 只有真实 gate passed 后才能称 complete — 恢复计划或治理任务收口前必须跑真实 gate；若用 line-budget waiver，只能是有期限、有上限、可审计的人工放行，到期不默认续
• 目标停止线变更后必须同步证据行 — 修改 plan/spec 的评级定义、停止线或完成口径后，必须同步复核状态跟踪、证据行和 README 摘要，不能保留被证伪的旧断言
• B+/A/RD gate 研发必须先过 MD spec review — 涉及 B+/A、RD loop、治理 gate 或评级提升的研发，必须先落 docs/plan/ spec 并经用户 review 通过后再写代码
• ratchet 阈值锚定 artifact 权威基线 — maintainability / god-file / line-budget 下行阈值必须锚定 gate artifact 字段，不用临时 scoped find 结果
• 治理术语必须维护中文解释 — DSR-N、residual IC、replay seal/auth、lifecycle 等术语必须在对应 plan/spec/runbook 写清中文解释、风险、非声明、代码/artifact 锚点和验收口径
• 官方回测前复算策略文件持仓与实验持仓逐周一致 — 生成脚本信号方向/回退/索引 bug 会把错误持仓送进引擎；提交前逐周比对持仓集合并用管线口径重估 navΔ
• 策略命名和状态只能是既有事实视图 — 注册表只存静态事实，L0-L4 状态由 gate 推导，lineage 必须有证据，display name 不替指标或 gate 下判断
• 最佳策略是前向运营结果 — V3 / checker / naming 等治理升级只让裁判诚实，不能替代 12 周 fresh、native metrics、低相关和 challenger 燃料；若用户要求 V3 后能挖 alpha / 诞生最佳，完成态必须升级为 v3_alpha_birth_capable_completed
• A 股燃料优先 AkShare/StockAutoCN，iFind fallback — 龙虎榜、大宗交易、限售解禁、ETF 份额/申赎、股东户数、回购增减持等燃料优先经 StockAutoCN 的 AkShare 运行面进入 KP；iFind 用作 fallback / cross-check / 字段发现；KP 侧负责 contract / provenance / PIT gate
• 认证级真实回测必须下一根 K 线成交 — prediction、decision、fill、mark 四个时间点必须分清；认证级策略证据只能使用下一根 K 线成交语义，成交时点不明或同根 K 线成交只能是 diagnostic-only
• 能力评级不使用研究编号表达 — 评级只写能力、证据状态和门槛；R71、D12H 等编号仅留在证据索引、附录或执行待办
• .ua 产物不得进入 KP 分支 — Understand Anything 的 .ua/ 必须外置保存，并禁止 stage、commit、merge 或 push 到任何本地/远程分支
• 放弃 QuantSkills PoC — 相关代码、runner、测试、产物和规格说明均不得并入 KP 分支或项目能力；未来重启必须重新授权

可复用结论 (project / reference)

• 12 年每日截面原始数据已持久化到 kp_all_daily — 权威价格源在 data/stock_autocn_runtime/kp_all_daily/；重建 1681 qfq 回测数据必须先读该目录，勿回退到已删除的 /tmp/kp_all；~/Downloads/*.zip 保留为最后原始备份
• Plan / runbook 类文档默认放入 docs/plan — 新增计划、spec、PRD、执行计划、里程碑、runbook、goal 验收或阶段执行包时，默认放入 docs/plan/
• KP Spec 是三层执行包 — Spec 中文名是执行规格说明，但必须同时包含工程/编码规范、执行规格说明、runbook，并显式列出 implementation/check context
• qlib daily 数据候选源：chenditc/investment_data — 本地 2026-06-21 / 2026-06-30 release 已审计；2026-06-30 release 解除 D13A tradability calendar gap，但触发 3 只票 limit_up；artifact 机器声明支持 price/ADV、不支持 R71 score；仍不能补 target/incumbent/native metrics
• LLM / iFind 等后端 key 以 backend/.env 为准 — 本地后端/RD loop 连通性测试前先安全加载 backend/.env，只输出非敏感状态；2026-07-02 用户确认该文件是 LLM / iFind 等 key 权威源；LLM_API_KEY 为空不代表 Kimi / fallback / FactorAgent / iFind 不可用
• kph 工作副本与 develop 分支 — kph 是从 knowledge-pipeline 物理拷贝出的独立开发副本（本仓库），全新 git + develop 初始提交，不设 remote；新开发默认在 kph；Owner 2026-08-14 确认 kph 自建 data/outputs/tmp/.kp/logs 运行目录，不回指原仓库
• kph 已按路线 A 作为 DSH 插件接入 — kp preset + .dsh/skills/ symlink 技能面 + kp-tools.js 薄工具层（P0 直通 / P1 审批拦截）已实施并本机验证；git diff backend/ 为空；B1 仍 REJECT，M3 待执行