复盘(v3 唯一日更)
一次交互回答三个问题:今天盘面什么环境 · 哪些主线活着/新生/垂死 · 我的机动仓和主线状态对不对得上。
产品设计与决策合同见仓库 docs/;本文件只保存运行时必需流程。
v3 与 v2 的根本差别:绩效永久交给同花顺,本地不算净值、TWR、回撤、仓位、集中度;不维护逐笔账本;不做券商截图算术核对。断更零债务——复盘结论本身无状态依赖,哪天跑哪天新,不需要把过去的复盘补齐。唯一的例外是板块逐日缓存:它是逐日累积的,断更期间的缺行大概率补不回来,缺了就按下文降级为「本项未验证」,不因此拒绝出复盘。
运行时配置与固定相对路径
运行前读取环境变量 ASM_CONFIG 指向的 JSON;未设置时读取 ~/.config/a-share-mainline/config.json。文件不存在、JSON 非对象或缺 vault_root 时立即停止,列出缺失项与配置方法,不得猜测路径或沿用记忆。
- Vault:配置键
vault_root;下列路径都从它派生。 - 问财 CLI:优先用可选配置键
wencai_cli,否则按当前 skills 根目录下的同级hithink-market-query/scripts/cli.py自动发现。找不到时标记该适配器不可用并按三源规则降级。 - commit 前缀:从
git_identity取当前平台 adapter 键(claude/codex),其次取default,均无则使用中性[ai]。下文以<git_identity>表示解析结果。 - 硬护栏:
00-系统/AI操作规则.md(数据熔断六条,v3 全文有效) - 纪律卡:
01-纪律卡.md(三条线的唯一事实源,每次重读,阈值绝不固化在本文件) - 持仓卡:
03-持仓跟踪/持仓.md(标的 / 角色 / 所属主线 / 止损位) - 主线目录:
05-主线追踪/(活跃主线页;归档/为已退潮) - 主线页模板:
05-主线追踪/_主线页模板.md - 输出目录:
02-盘面日志/ - 首页:
投资笔记.md - 板块逐日缓存:本 Skill 自带
scripts/board_fund_flow_cache.py(本仓库自有代码,不属于上游a-stock-data)。库文件默认在A_STOCK_DATA_HOME指向的目录下,未设置时回落到该脚本内置的用户级数据目录。缓存不存在或覆盖不足时按下文一律降级为「本项未验证」,不阻断其余复盘区。 - 判定器:本 Skill 自带
scripts/mainline_validation.py,提供退潮判定真值表与提名影子观察的确定性实现;行为回归入口见文末「行为回归与研究复跑」。 - 取数通道(三条,调用顺序见下「数据源:调用顺序与权威性」):
a-stock-dataskill(东财 / 腾讯 / 通达信 / 百度,零鉴权、无额度)hithink-financeCLI(同花顺 iFinD,额度独立于问财)- 问财 CLI:运行时解析出的
wencai_cli(每日额度有限、三个 skill 共用,仅限正面清单四类场景)
硬边界
- 只在人在场时手动触发;不做定时、不创建 automation、cron 或后台监控。
- 不下单、不碰委托、不动钱,不替用户作买卖决定。纪律只产生提示,不冻结、不自动卖出。
- 不编数据。每个行情数字必须带来源和数据日;缺失写
未取得,不猜。 - 不写未来行情。次日日期与待观察项可以写,不得附带未来价格、涨跌幅或资金数据。
- 不建主线页。提名只写进当日复盘等用户拍板;用户说「跟」才建页,那是另一轮的事。
- 不算账户绩效:净值、TWR、回撤序列、仓位、集中度一律不碰。
- 白名单只有四类:
02-盘面日志/当日复盘、05-主线追踪/活跃主线页的证据流增量、03-持仓跟踪/持仓.md(仅当用户本轮报了成交或改了止损位)、投资笔记.md(仅当首页 callout 事实变化)。超出立即停止并说明。 - 写
未取得之前必须先走完下面的调用顺序三条通道。单一通道失败或额度耗尽 ≠ 熔断:- 三条通道都拿不到该数据项 → 该数据项熔断,写
未取得(三源均失败:<逐条列出>),任务其余部分照常完成。 - 整轮任务停止只在两种情况:① 关键数据项全部熔断致结论无依据;② 数据日异常或晚于系统当天。
- 涨跌家数以问财为写入源、并必跑东财影子对账(见下 §1「涨跌家数:问财为写入源 + 东财影子强制校验」);问财耗尽时改用影子值写入并标注,不再熔断该项。
- 三条通道都拿不到该数据项 → 该数据项熔断,写
数据源:调用顺序与权威性(两条独立规则)
三条通道额度与鉴权互相独立,任一条能取到就不许写「未取得」。
问财额度纪律的唯一事实源:
00-系统/AI操作规则.md§问财额度纪律(三个投资 skill 共用一个额度池,运行时读那里,本节只是本 skill 的调用顺序)。摘要:问财正面清单只有 ETF 主题检索 / ETF 技术指标与资金流 / 复合条件筛股问句 / 涨跌家数四问句这四类,清单外一律走前两条通道;额度耗尽先降级,按上面的两分判该项熔断,而非整轮停止。
调用顺序(为省问财额度,从上往下试)
| 调用顺位 | 通道 | 覆盖 | 额度 / 鉴权 |
|---|---|---|---|
| 1 | a-stock-data(东财 / 腾讯 / 通达信 / 百度) |
指数与个股行情(腾讯批量)、行业涨跌排名(§3.7)、板块资金流 行业×今日/5日/10日(§3.8)、涨停四池(§8)、个股资金流、龙虎榜、K线 | 零鉴权、无额度,只有东财限流(em_get 已内置) |
| 2 | hithink-finance CLI(同花顺 iFinD) |
行情快照 / 日线历史 / 交易日历 / 指数目录与成分 / 涨停池等特色榜 / 财务 | 额度独立于问财;Key 由用户按 hithink-finance 官方方式配置,hithink-finance auth status 应为 configured:true |
| 3 | hithink-market-query(问财 openapi.iwencai.com) |
仅限正面清单四类:ETF 主题检索 · ETF 技术指标与资金流 · 复合条件筛股问句 · 涨跌家数四问句(code_count) |
每日次数有限、三个 skill 共用,会耗尽;Key 在环境变量 IWENCAI_API_KEY(本机环境变量) |
权威性(同一数字多源冲突时以谁为准)
hithink-finance(T1 官方结构化) > 问财(T2) > a-stock-data(T3 公开爬取)。写入 vault 的数字,若 T1 取得到则以 T1 为准并标注来源。
这两条不是同一个排序。 调用顺序管的是「先问谁省钱」,权威性管的是「打架听谁的」。不得把
a-stock-data说成比hithink-finance更权威,也不得把问财说成应该优先调用。
判定口径必须与历史一致:涨跌家数用问财全池口径写入,并按 §1 跑东财影子对账(口径已实测逐位一致;问财耗尽时用影子值写入并标注);其余数据跨通道补数时,若分类口径不同(如东财行业 vs 同花顺行业),在页面上标明来源与口径差异,不混算。
认证检查:以
hithink-finance auth status的configured字段或一次只读请求为准;不得仅凭某个环境变量缺失就推断服务不可用。
⚠️ 沙箱网络:Bash 环境设了
HTTPS_PROXY,Pythonrequests走代理连东财会ProxyError/RemoteDisconnected,但curl直连正常。取东财数据时用curl拉 JSON 再交 Python 解析,或给 session 设trust_env = False。
运行前检查
cd到 vault,读真实文件:纪律卡、持仓卡、05-主线追踪/全部活跃主线页、02-盘面日志/最近一篇。不沿用会话摘要。- 用系统时间确认当前日期。数据日默认「今天」;用户明确要补跑历史交易日时才用指定日期。
source ~/.zshrc,只检查IWENCAI_API_KEY是否存在,绝不打印密钥。- 查上证指数、深证成指、创业板指、沪深300、科创50 的收盘价与涨跌幅,核对返回字段的数据日。指数收盘价不在问财正面清单内,走
hithink-finance market snapshot(T1,优先作为写入值)或a-stock-data的腾讯批量行情,不得为此消耗问财额度。 - 拿不到「今天」的完整收盘数据时,停止所有写入,回复
未跑(今日非交易日、尚未收盘或当日收盘数据不可验证)。不得把上一交易日数据冒充今天。 - 确认收盘后,跑一次
scripts/board_fund_flow_cache.py snapshot --trade-date YYYY-MM-DD续接全板块逐日缓存;只有返回的行业/概念/地域分页都完整且数据日一致,才进入主线判定。失败则记录具体类型,不得用残页覆盖缓存;其余不依赖该项的复盘区照常完成。该命令幂等且自带交易日守卫,同日重复跑直接走幂等分支。用户可以自行在系统里加定时任务提前跑,本 Skill 只调用、永不替用户创建定时任务或后台监控(见「硬边界」)。 缺行大概率补不回来:公开逐日历史端点已不稳定,Tushare 补洞需要用户自备 token,当日快照端点只给当日值。补不回就在当日复盘写明「板块逐日缓存缺 YYYY-MM-DD」,后续凡依赖连续序列的判定(连续 N 日 / MA20 / 误报回测)一律写「本项未验证」,不得默认判「未触发」。
编排
0. git 快照(前)
git status --short
git add -A
git commit --allow-empty -m "<git_identity> 复盘前快照 YYYY-MM-DD"
git rev-parse --short HEAD
这是 vault 规则里唯一允许 git add -A 的场合。提交失败即停止所有写入——没有回滚点不继续。
1. 盘面十行
采集并核对:主要指数收盘与涨跌幅 · 上涨/下跌家数 · 涨停/跌停家数 · 两市成交额及较前一日变化 · 行业涨跌前三与后三 · 主力资金方向。
**家数口径固定:沪深A股全池、含 ST,不加「非ST」过滤。**问句固定为
沪深A股 今日涨跌幅大于0/沪深A股 今日涨跌幅小于0/沪深A股 今日涨停/沪深A股 今日跌停,取各自的code_count。 加非ST会改变样本池与历史可比性。五档矩阵与全部历史记录都用全池口径,不要改问法。
额度预算与取数分工:按调用顺序收敛后,复盘正常只需 4 次问财查询——就是涨跌家数四问句。指数收盘、行业涨跌榜、板块资金流(
a-stock-data§3.7 / §3.8,零鉴权无额度,还多给 5 日/10 日周期)、个股行情与资金流全部走a-stock-data/hithink-finance,不占问财额度。只有当日确需 ETF 主题检索、ETF 技术指标与资金流或复合条件筛股问句时才追加,且仍限在正面清单内。 清单外的数据项某条通道失败时,按调用顺序走完三条通道再判该项熔断,不是直接写「未取得」,也不整轮停止。真要取舍时的优先级:④ 持仓对照(纪律执法)> ① 盘面判定 > ③ 提名的资金佐证。
涨跌家数:问财为写入源 + 东财影子强制校验(2026-08-07 起,取代旧的「只认问财、不许换源」)。 四问句仍是唯一写入源、口径不动,但本步必须同时跑一次影子值并对账——
a-stock-data§3.11market_breadth()+breadth_reconcile(),零额度、约 60–80 秒。对账结果写进当日复盘脚注(这是「⑤ 是否已双源校验」的唯一证据,缺了后段复核会退回)。
- 一致 → 照常写问财值,正文不占版面,脚注注明「涨跌家数已双源校验」;
- 涨跌家数差 ≠ 0 → 报「口径异常」,不得静默写入:先查当日新股 / 停牌 / 分类调整,查不清则两个值都写并标注冲突,环境判定取更保守一档;
- 涨停家数差 ≠ 0 → 逐股核对
detail.limit_up与腾讯字段 47/48,未定位原因就按上一条处理;limit_up_st仅为描述字段,不再自动放行差异;跌停差 >1 同样按上一条处理;- 问财额度耗尽 → 改用影子值写入并标注
来源:a-stock-data §3.11 影子口径(问财额度耗尽),不再写「未取得」、不再因此降档;- 完整条款与 2026-08-11 纠偏记录(「问财涨停不含 ST」假设已证伪)见
00-系统/AI操作规则.md§问财额度纪律 ⑤——该节是唯一事实源。影子源用于发现口径漂移;任何差异都必须逐项解释,不能静默吸收。
按五档矩阵判定当日环境(信号冲突时取风险更高、条件更保守的一档):
| 环境 | 识别线 |
|---|---|
| 强势扩量 | 多数主要指数上涨,涨/跌家数比 ≥ 约 1.5,成交额较前日增加约 10% 以上 |
| 震荡轮动 | 主要指数大致在 ±1% 内,行业分化明显,资金集中流入少数板块 |
| 超跌修复 | 连续下跌后市场宽度转正,指数或主线重新站上短期均线 |
| 缩量弱势 | 下跌家数明显占优、成交缩量、无清晰资金主线 |
| 大跌或恐慌 | 主要指数约跌 1.5% 以上,或下跌家数超过上涨家数约 3 倍 |
不能只按上证指数单一涨跌定档。
2. 主线动态
对 05-主线追踪/ 每条活跃主线:
- 读该页的死亡条件与载体清单,取载体当日表现、所属行业涨幅排名、资金方向。
若某条死亡条件依赖逐日连续序列而当日无法判定(例如断更后缺中间交易日),不得默认判为「未触发」——先查本地缓存:
python3 scripts/board_fund_flow_cache.py history <板块代码> --limit 120 --end-date <数据日> --provider cache;仍取不到才如实写「该条件本日不可判定(原因)」并提示用户,建议用stock-buddy复核或把该条件改写成聚合窗口口径(如改看 5 日聚合是否转负)。凡涉及指数或价格阈值的条件,主线页状态头缺基线三要素(标的/指数代码 · 基线点位 · 基线数据日)中任一项,同样按「不可判定」处理,不猜基线。**板块逐日史的事实源是本地缓存,不是远端端点。**缓存存逐日主力净额、四档资金与板块收盘点位,每日收盘后由全板块当日快照增量续接。必须传
--end-date锁定判定交易日——行数够但末日不是判定日,等于拿旧数据冒充当日判定。指定数据日未精确覆盖、行数不足或跨源冲突时一律写「本项未验证」。不同分类口径的板块序列不得互相拼接(换口径等于改死亡条件本身)。 - 判定阶段:
启动 / 发酵 / 分歧 / 警戒 / 退潮,并给出依据(带数据日与来源)。 - 触发清仓级死亡条件才判退潮——这是纪律①的触发信号,必须在复盘的持仓对照区置顶红字,并联动第 4 步。红字固定附一句:「本判定为单源机械触发,建议先用
stock-buddy做退潮复核再决定处理。」复核结论为虚警时,须回改该主线页 frontmatter 的阶段字段并在证据流补记一行轨迹 + 一个折叠明细块,不得让页面停在错误的退潮状态。 机械判定先走确定性真值表:读主线页 frontmatter 的判定规则版本;写着double_key_v1的按双钥匙判,没有该字段的旧页按legacy_any与页面原文执行,不得代为升级或降级。实现与回归入口是scripts/mainline_validation.py::classify_retreat。任一必需键缺数据必须返回unverified / data_block,不得把缺失静默当成false。double_key_v1中:资金键单独成立 =warning,资金键与价格键同时成立 =retreat_review_required;已预注册的纯价格单键仍可独立触发。 双钥匙与警戒态:清仓级死亡条件是「资金键 + 价格键」双钥匙。**只有资金键成立、价格键(当日收盘 < MA20 或 < 基线触发线)未落下时,判的是警戒不是退潮**——写橙字(warningcallout)、**不写退潮红字、不联动纪律①**,动作限于「本主线冻结加仓 + AI 给上移止损建议(待用户确认)」。警戒解除(连续 2 个交易日资金键反向且收盘 > 触发日收盘)或升级(任一日价格键落下 → 转退潮)都要回改阶段并补记证据流。纯价格条件可单键,它本身就是价格键。为什么要加这一档:纯资金符号条件(连续 N 日净流出、聚合窗口转负)在板块逐日史上的底率极高——作者自己按预注册 Gate 跑过一次 120 日全池回放,这类条件既没通过与基线的区分门槛,触发后的前向收益也与不触发几乎无差别。警戒态不是给「留仓」找豁免票,而是防止低特异度的单源传感器直连不可逆动作:一个隔几天就误响一次的清仓信号,迟早会教会人在关键时刻不信任触发器。任何条件都不因叙事被豁免,双钥匙只改结构、不改现役阈值。回放方法见文末「行为回归与研究复跑」,可用自己的缓存复现。 复活哨(本区强制项):对
05-主线追踪/归档/里已退潮的主线,若判定日后 15 个交易日内锚板块连续 2 个交易日主力净流入且收盘高于判定日收盘,本区必须置顶「疑似误杀提示」,列出两日资金、当前收盘与判定日收盘之差、该主线在05-主线追踪/归档/_退潮判定台账.md里的暂定分类。提示的动作是请用户决定是否重新评估,不是买回信号,不得据此给开仓建议;重评走新立项流程(新页、新死亡条件、新基线)。断更期间漏发的提示,用上面的缓存回填补发,不因断更作废。 T+N 台账回填(本区顺手做):_退潮判定台账.md里未终裁的每一行,按其写死的检查点日期填当日读数;到 T+7 按该页预注册的分类判据机械归类,不得为了归类另换指标。归为「误杀」不改变任何已执行的纪律动作,只进样本池。 - 写回该主线页「证据流」——双层,两样都写才算完成:上层轨迹表插一行在最上面(固定 4 列
数据日 / 阶段 / 死亡条件锚点当日值 / 一句话结论,锚点 ①②③ 与该页死亡条件逐条对应、未触发也要写当日值),下层加一个默认折叠块> [!note]- YYYY-MM-DD 明细 · 〈阶段〉(按 资金 / 涨幅 / 宽度 / 载体 / 来源 分行,结尾的-是折叠开关不要漏)。折叠块只写本主线自己的判定依据,全市场指数、涨跌家数、行业总榜、成交额留链接指回当日复盘,不转录。阶段变化时同步改 frontmatter 的阶段字段(首页状态灯靠它)。 - 复盘正文里,无变化的主线只写「延续」一行,有变化才展开细节。
活跃主线为 0 条时,本区写「当前无活跃主线」,不占篇幅。
3. 主线提名(分角色:前段出候选池、后段出提名)
本区按 AGENTS.md §Codex ↔ Claude 分工协议拆成两步,两段各写各的,不得互相覆盖:
前段(Codex)—— 写「③ 候选池(机械扫描,未取舍)」
只做机械筛,不做取舍、不写反方、不叫「提名」。筛法:行业板块与概念板块各扫一遍,取三周期(今日/5日/10日)主力净流入全正且今日排名靠前者,上限 5 条。每条固定给:
- 板块名与层级(东财行业 / 概念,标明口径)
- 三周期金额与排名一起给(缺一不可)
- 涨跌家数宽度
- 加速度:
前5日 = 10日 − 5日,标「加速 / 减速」
候选池不是提名,用户不得据此拍板;只跑了前段的日子,本区停在候选池状态并显式标注「未提名」。
后段(Claude)—— 写「③ 主线提名」,替换候选池
先独立扫一遍再看候选池(防锚定,同 §分工协议的取数顺序);
与候选池合并去重,取并集——两边各自漏的都要捞回来;
催化剂核查是提名的必做前置,零额度三源全走:
a-stock-data§8.2 同花顺涨停揭秘(涨停原因题材词频)· §5.2 财联社电报(拉满整个交易日,不能只拉收盘后那几十条)· §3.8 概念板块t:3三周期资金。三源都核不到行业级催化 → 该候选降为观察,不得提名;输出 0–3 条,每条必须写全:一句话叙事逻辑 · 证据(带数据日与来源)· 反方理由(没有反方的提名无效)· 死亡条件雏形(必须断更可判定)· 第 N 次提名。
每条正式提名再强制写四项
shadow_only观察,缺失写未验证,不得省略:- 涨停梯队映射:映射到该主线的涨停股数量与名单;0 只标
zero_limit_up_mapping。 - A 股催化落点:是否落到具体 A 股上市主体、订单、产品验证或业绩事件;否标
no_a_share_catalyst_landing。 - 锚板块名次稳定性:锚板块成分数;成分
<50且死亡条件使用全市场绝对名次时标narrow_absolute_rank_anchor。 - 次日证伪条件:提名当轮预写一条下一交易日可机械核对的反向条件;次日填
未证伪 / 已证伪并退回观察 / 未验证。
四项不自动阻断现役提名,也不改死亡条件或退潮阈值——它们是修订窗口内的采样,不是门禁。但
zero_limit_up_mapping与no_a_share_catalyst_landing同时出现时,必须醒目标注 「A 股执行链未验证,证据高风险」,不得包装成「A 股承接已成立」。判定语义见scripts/mainline_validation.py::assess_nomination_shadow,行为样例见tests/fixtures/mainline_cases.json。- 涨停梯队映射:映射到该主线的涨停股数量与名单;0 只标
没有合格候选就提 0 条,不为凑数硬提。提名只是候选——用户说「跟」才建页,复盘本身不写 05-主线追踪/。
4. 持仓对照(三条纪律唯一的日常执法点)
先从 01-纪律卡.md 读当前三条线的定义与数值,不使用本文件或会话记忆里的任何旧阈值。再从持仓卡读角色与止损位。
- 机动仓逐只:收盘价 · 止损位 · 距止损位
(收盘价 / 止损位 - 1) × 100%· 所属主线当前阶段。 - 纪律②:收盘价 ≤ 止损位即触发 → 置顶红字,要求用户次日给处理决定。读上一篇复盘,若同一标的连续两日破位未处理,每次复盘继续置顶重复。
- 纪律①:所属主线被判退潮 → 该主线全部机动仓置顶红字,红字固定附一句:「本判定为单源机械触发,建议先用
stock-buddy做退潮复核再决定处理。」 所属主线被判警戒(只有资金键成立)→ 不触发纪律①、不置顶红字,改用橙字(warningcallout)写:本主线冻结加仓 + AI 给上移止损建议(待用户确认);未确认前纪律②仍按原止损位执行,AI 不自动移动止损位。 - 纪律③:读纪律卡的触发线金额。用户本轮提供当日总资产时直接比对;未提供就写
未核对(需你报当日总资产),绝不用持仓市值估算总资产。 - 底仓一行带过:只写整体涨跌与是否出现异常,不逐只展开、不做纪律判定(纪律②③只约束机动仓与账户整体)。
- 止损位为「未生效」或空缺的机动仓,如实写「止损位未生效,纪律②对该仓不执行」。
全程只写 触发 / 未触发 / 无法核对,不写买卖指令。
5. 次日关注
≤3 条,只写可验证的观察点(某价位能否站上、某资金方向能否延续、某待你确认的事项)。不写未来价格预测,不写买卖建议。
6. 写盘面日志
创建或更新 02-盘面日志/YYYY-MM-DD 复盘.md。自动内容包在 <!-- stock-daily:auto:start --> 与 <!-- stock-daily:auto:end --> 之间。
frontmatter 必须含(首页 dataview 靠这两个字段取最新一篇):
---
type: market-log
数据日: YYYY-MM-DD
created: YYYY-MM-DD
updated: YYYY-MM-DD
环境: 强势扩量 / 震荡轮动 / 超跌修复 / 缩量弱势 / 大跌或恐慌
tags:
- 投资/盘面日志
---
正文固定五区,目标 ≤40 行、5–10 分钟读完:
- 页首
abstractcallout:一句话环境结论 + 今天最需要你处理的一件事(没有就写「无待处理」)。 ## ① 盘面—— 关键数字紧凑表 + 环境判定与依据。## ② 主线动态—— 每条一行;有阶段变化才展开。已归档主线触发复活哨时,「疑似误杀提示」置顶本区(infocallout,不是danger——它不是纪律事件);_退潮判定台账.md有未终裁的行时,本区末尾用一行带过回填结果。## ③ 主线提名—— 0–3 条,每条含证据、反方理由与一行shadow_only四项观察;0 条时一行写明。前段只跑到候选池时不补定性影子字段。## ④ 持仓对照—— 机动仓表(标的/收盘/止损位/距止损位/主线阶段/状态)+ 底仓一行 + 纪律③一行。任何触发项用dangercallout 置顶到页首 abstract 下方。## ⑤ 次日关注—— ≤3 条。- 末尾固定一行:
本工具仅用于研究与决策支持;提供方非持牌证券投资咨询机构,本工具及其输出不构成投资建议,不代下单,使用者风险自担。数据来源:<本轮实际使用的数据源>;数据日:YYYY-MM-DD,均以本次运行输出为准。数据边界不再另写长文,必要缺口直接标未取得。
版式只用 Obsidian 原生 Markdown、callout、表格;不依赖 CSS 或新插件,移动端优先,表格尽量不超过 6 列,不堆装饰性 emoji。
同一数据日重复触发时更新原文件的自动块,保留块外的人工批注,不追加第二篇、不整篇覆盖。
7. 首页与 git 快照(后)
- 仅当首页 callout 陈述的事实发生变化(活跃主线数量、持仓角色/止损位、纪律状态)时才改
投资笔记.md;两条 dataview 会自动取最新复盘,不需要手改链接。 - 只暂存本轮白名单文件:
git add -- '02-盘面日志' '05-主线追踪' '03-持仓跟踪/持仓.md' '投资笔记.md'
git commit -m "<git_identity> 复盘 YYYY-MM-DD"
git rev-parse --short HEAD
git status --short必须为空;白名单外还有未提交内容时,在回告里逐条列出交给用户决定,不自行提交也不自行丢弃。- 提交失败即视为未完成,报告 git 阻塞,不得声称复盘已完成。
回告给出:数据日、环境判定、各区完成/未取得状态、纪律触发摘要、提名条数、变更文件、前后 commit hash、所有缺口。结尾固定写:本工具仅用于研究与决策支持;提供方非持牌证券投资咨询机构,本工具及其输出不构成投资建议,不代下单,使用者风险自担。数据来源:<本轮实际用到的通道,逐条列出,如 a-stock-data(东财/腾讯)、hithink-finance、同花顺问财>及投资笔记已验证记录;数据日:YYYY-MM-DD,均以本次运行输出为准。(不得把没用到的源写进来)
熔断与幂等
- 单一通道额度耗尽 / 认证失败 / 网络错误 / 空数据 ≠ 熔断:先按调用顺序走完三条通道;三条都拿不到该数据项,才判该数据项熔断,写
未取得(三源均失败:<逐条列出>),绝不改用猜测值,任务其余部分照常完成。涨跌家数按 §1 的双源规则处理(问财为写入源,必跑影子对账;额度耗尽改用影子值写入并标注,不写「未取得」)。 - 整轮停止只在两种情况:① 关键数据项全部熔断致结论无依据;② 数据日异常或晚于系统当天(含「运行前检查」第 5 条的今日收盘数据不可验证)。
- 同一数据日重复触发:查重复盘文件、主线页证据流的轨迹行与同日折叠块、首页 callout;更新而不重复追加。
- 运行结束后用
git diff HEAD^ --name-only核对实际变更;出现白名单外文件即判定失败并报告,不自行删除用户文件。
行为回归与研究复跑
涉及双钥匙、警戒、正式提名证据字段或次日证伪语义的改动,必须先跑:
python3 -m unittest discover -s tests -p 'test_*.py'
python3 scripts/mainline_validation.py cases --fixtures tests/fixtures/mainline_cases.json
cases 用一组结构化合成案例覆盖:资金键单独成立(旧规则会清仓、双钥匙只进警戒)· 聚合窗口口径的同类读数 · 双键同日成立 · 未预注册的价格半边单独落下 · 已预注册的纯价格单键 · 提名影子三旗全亮 · 次日证伪成立。改判定语义就要同轮补案例,不许改案例迁就实现。
想用自己的数据复核双钥匙的立论,先把缓存养到足够长的历史,再跑:
python3 scripts/mainline_validation.py study --db <缓存库路径> --output-dir <输出目录>
它输出板块历史回放报告与预注册验收 Gate。Gate 一旦预注册就不得按结果改门槛;失败后追加的切片只能标 post_gate_diagnostic_only,不得反过来当成立论证据。这条命令只用于系统验收,不是日常复盘步骤。
明确不做的事(v2 遗留,已停用)
净值 / TWR / 最大回撤 / 月内回撤计算 · 券商截图算术核对 · 持仓账本(数量/成本/市值/盈亏)刷新 · 账户快照表 · 绩效状态表 · 基金账户跟踪 · 逐笔交易记录 · 07-交易决策/ 建页 · 08-下个交易日/ 单独建页 · 数据边界长文。
策略选股批次 T+N 不在复盘内运行:v3 只跟踪「主线载体名单」,记录写回对应主线页。复盘不写 09-选股池跟踪/。