quant-buddy-view

quant-buddy-view · 量化看板发布

把「已验证的量化数据与公式」沉淀成一个公开可分享、实时取数的网页看板/落地页。本技能不做一次性行情查询或回测探索；默认执行路线是：

feishu-group 渠道：打包渠道为 feishu-group 时，direct/fork/unmatched/update 等所有分支禁止发送非终态链接；终态 contract 统一把 pages.quantbuddy.cn/pages/<owner>/<page_id>.html 转成 www.quantbuddy.cn/playground/<owner>/<page_id>，内部发布与验收仍使用原始托管 URL。

最高优先级：既有活页解读。 用户给出 pages.quantbuddy.cn/pages/... 的 QuantBuddy 活页 URL，且意图是“解读 / 分析当前活页 / 看这页数据”时，先且只运行：

python scripts/static_page.py interpret '{"url":"用户提供的页面 URL"}'

这是只读数据路径，不要运行 trace_context.py、templates、template、direct_deliver、new_page、fork、download、浏览器或 HTML 搜索，也不要创建、更新、发布页面。它调用 getPageDetail?need_data=true；服务端使用页面绑定的公式包和 Data Grant 取最新数据，并附加 interpretation_bundle，不返回 signature。直接按用户的自定义要求解读详情与 interpretation_bundle.runtime_data。未指定格式时，依次输出一句话结论、关键指标及变化、风险/异常、3 个继续追问方向。详见 workflows/interpret-existing-page.md。

若 interpretation_bundle.runtime_data.grants[].data.mode="csv"，先返回的 csv_fields[].csv_url 是短期下载链接而非可直接计算的数据。必须紧接着运行一次 python scripts/static_page.py interpret_csv '{}'：它只下载该次 interpret 已返回的 CSV、保留链接并补出 results[].fields[].series，然后再计算和解读；禁止重跑 interpret、另查数据接口或把 CSV 链接给用户。

1. 除上述既有活页解读分支外，在任何后端请求前运行 scripts/trace_context.py begin，保存唯一 task_id 并在后续命令中复用。这步本身就是后端写入调用，必须和后续命令带同一个身份（QBV_API_KEY 环境变量或参数里的 api_key），不带会被记成 skill 默认账号。
2. 若用户只是要简单分析一只 A 股并返回页面，且没有定制栏目/版式、额外指标/公式/图表、对比或多标的要求，直接运行一次 scripts/static_page.py new_asset_page。成功结果包含完整数据草稿 agent_reply_markdown_draft；当前 Agent只需依据用户原问题和草稿前五章数据补写综合观察，不再查 templates，也不另跑 QBS 验证或注册 Grant。
3. 除上述快速场景外，运行一次 scripts/static_page.py templates，查询统一 public 命中池（服务端一次返回官方精选+社区）。
4. direct 只有在范式、范围和全部请求维度三轴均有证据时成立；direct_deliver 必须提交 dimension_check。缺维度改走 fork + same_paradigm_augment_dimension。
5. fork/unmatched 调用 new_page 时由 Agent 根据 items_summary 显式传 routing_decision；fork 还必须声明 borrow_mode=inherit|inherit_augment|compose。fork 一旦判定只能继承、增强继承或 Compose，禁止改判 unmatched。
6. new_asset_page 成功后，按 agent_summary_request 用当前 Agent补写草稿中的唯一 summary_marker，保持其余内容不变并立即发送；direct、fork/unmatched 仍按 agent_reply_contract 和回复模板生成证据绑定草稿，再运行返回的 reply_validation_command，只有 valid=true 才最终回复。

多轮追问：首次用户消息运行 scripts/trace_context.py begin；同一 task_id 的每条后续用户消息先运行 scripts/trace_context.py beginTurn。正常 Agent 必须同时传本轮可选 agent_intent：简洁展开上下文指代并写清对象、动作、约束和期望页面/产物，推荐 20～160 字；不得复制用户原话、输出内部推理或提前编造结论。老调用方可省略并按 null 继续。一轮内所有 QBV/QBS 工具共享同一 turn_id。Turn 是审计旁路：服务端记录失败会返回 tracking_recorded:false，但不得阻断建页、更新、取数或发布；业务上下文继续切换到真实 user_query / agent_intent，attempted turn_id 不保存、不传播，后续按无 Turn 模式继续。更新既有活页必须继续复用原 page_id 与公开 URL。

QBS 并行 Handoff：收到 qbs_qbv_handoff_v1 时运行 scripts/trace_context.py beginHandoff（兼容 begin-handoff），传入 Handoff object 或绝对 handoff_file。必须原样复用其中真实 task_id + turn_id + source_skill_id，不得再次 begin/beginTurn、不得在 QBV 重做 QBS 路由分类。create/existing_page 之后仍进入本 Skill 完整 SOP，由 QBV 判断 direct/fork/unmatched、查询 ownership 并执行本人原位更新或他人复制；高风险持久状态未确认时 beginHandoff 必须拒绝。