Files
sanguo_vnpy_v2/docs/superpowers/specs/2026-10-08-pipeline-console-ux-redesign.md
T
claude_dev 69cff60d8f
CI/CD / test (push) Successful in 40s
CI/CD / nas-deploy (push) Successful in 7s
CI/CD / nas-verify (push) Successful in 9s
docs(pipeline): UX重设计spec补变更记录节——备案81adfbc标签缺漏(纯文档,不触VPS运行时) [nas]
2026-10-08 21:52:48 +08:00

7.5 KiB
Raw Blame History

流水线控制台 UX 重设计 · v0.5 工作稿

状态:0.5 草案。骨架与理念已由用户拍板(2026-10-08),细节逐节讨论中——本稿是讨论载体。 归宿:定稿后收编进 2026-09-22-research-to-trading-pipeline-design.md(流水线唯一活文档),本稿届时标注「已收编」。 来历:用户端到端走查四痛点(环节割裂 / 自动过程看不见 / 参数写死 / 出生无入口)→ spec 审计定案 4 项 UI 级缺口(②权重过程透明 / ③策略出生流 / ④回测考窗可配 / ⑤事件时间线)→ 本重设计。

1. 设计宪法(用户定调,不可协商)

  1. 按人类用户体验标准重设计,参考业界优秀实践(调研=docs/superpowers/reports/2026-10-08-ux-redesign-survey.md,七工具 21 模式)。
  2. 人工卡点保留不动:五问 / 研判 / 毕业口令 / 出生确认——宪法「关键 promotion 永不自动化」。重设计 ≠ 全自动,是人类界面变厚。
  3. 其余环节尽量自动化,但参数可配(粒度三层提案见 §6,逐项待裁定)。
  4. 过程透明 = 核心诉求:「看不到就无法判断是不是真的做了、做得对不对」。透明厨房/透明车间理念:自动化过程本身在 UI 上可观看、可回放、可回溯。
  5. 透明 ≠ 说明文字(v3 弯路教训):给用户看的不是描述后厨的菜单,而是明厨亮灶——过程用 UI 串起来,边和状态是「跑出来的」,不是写出来的。

2. 已拍板决策

# 决策 日期
D1 骨架=混合型:流程站做导航 + 对象详情页做落点;方案三独立形态废弃,地铁图融入总览 10-08
D2 透明车间:每个自动任务=可观看的执行(任务状态墙 + 分步执行详情 + 回放) 10-08
D3 「车间·运行」与「总览·待办」合并为一页(布局细节=开放问题 #1) 10-08
D4 边一等公民:每条迁移边四问全答——从哪来 / 什么条件 / 谁触发(自动=青 / 人工=琥珀,全站统一)/ 到哪去;以过程与状态呈现,不以文本说明书呈现 10-08
D5 对象详情页=过程真相载体:一生时间线 + 权重演进 + 参数 + 证据链 + 血缘;自动事件带「▶ 看执行」回跳当时那次 run 10-08
D6 出生页=表单即策略(模板型配参 + 非标登记两入口);提交=登记待办(人工卡点)→ 自动排考 10-08(形态定,细节待议)

3. 术语(本稿内精确使用)

  • 对象:因子 / 合成因子 / 策略 三类,均有一等详情页(同构:时间线 + tabs)
  • 站:流程节点(假设池→工厂→评审→合成→出生→梯子→实盘)
  • 边:对象在站间的迁移(含条件+触发方式)
  • run:一次自动任务的执行实体(有状态/分步/时长/参数快照/产物)——本设计新增的一等概念

4. 信息架构(D3 合并后)

侧栏(流水线组): 总览(地铁图 + 待办 + 车间任务墙) / 假设池 / 因子工厂 / 晋级评审 / 合成层 / 策略出生 / 孵化梯 / 实盘 +(现有页保留待议:归因·研判 / 闸门阈值 / 设置)

合并后的总览页四块(排序待议):① 流水线全景地铁图(边条件标注+卡点脉冲)② 等你决策(卡点待办)③ 车间任务墙(每台自动机器:灯[运行中/绿/黄/红]+上次用时+调度+一句产出;点进执行详情)④ 健康水位。

高保真参考稿:.superpowers/brainstorm/5810-1791437951/content/ia-hifi-v4.html(v1 双案对比→v2 方案一+地铁图→v3 边条文本弯路→v4 透明车间;复活方式=python3 -m http.server 8823 --bind 127.0.0.1 --directory <该目录>)。

5. 透明车间(本设计灵魂)

三层透明:

  1. 任务墙:全部后台任务在岗可见。初版清单:因子月度批评估 / 月度批评双机对拍 / 合成层考场 / 回测跑批(考卷)/ 影子跑 / 衰减检测 / 待办聚合 + 上游供数三 lane(daily / backfill / funnel——车间只看供数健康,详情归 data-monitor 域)。
  2. 执行详情(run):分步过程——每步输入/输出/判定规则可展开;末尾列本次产物清单;**「▶ 回放」**分步重演当时发生了什么。
  3. 回跳链(数据溯源):对象时间线的自动事件「▶ 看执行」→ run;工厂页 t 值标注出处批 run——数字是谁算的、哪天算的,点得回去。

实现根基(调研最收敛结论):运行台账(6/7 工具同构)——需后端把每次执行落库为 run 记录。现有 registry_events.jsonl 是雏形,缺分步/时长/参数快照/产物指针(开放问题 #4 定模型)。

车间只看不管:任务仍由调度驱动,人看得到每一步,但放行权在卡点。

6. 参数可配三层(提案,逐项待裁定)

层 例 页面形态
全局 评审门 t≥2 / 统一考窗 2022-2024 闸门阈值页(已存在,扩容);考窗保可比性 → 页面只读 🔒 显示
族默认 重评频率=年 / 族压缩 0.7 合成层族详情
对象 策略出生参数 top_n/调仓日/缓冲带;权重方法=档案制(非手调数字) 出生表单 / 对象详情参数 tab

待裁定分叉:哪些参数允许对象级覆盖?非标考窗=显式豁免+标注「与统一考卷不可比」是否成立?

7. 开放问题清单(compact 后逐节过)

  1. 合并页布局:地铁图/待办/任务墙/健康四块的密度与排序(一屏 vs 分区)
  2. 执行详情分步粒度:多少步合适、日志/产物挂多深
  3. 回放形态:步骤快照重演(v4 演示款)/ 日志时间轴 / 真回放(重跑)?
  4. run 落库模型:新表 vs 扩 registry_events;谁写(各 job 自记 vs 统一 wrapper);跨域任务(数据 lane)怎么进墙
  5. 参数粒度逐项裁定(§6 分叉)
  6. 入族登记待办化(替代手工改 composite_library.py)——factor 域实现项
  7. 假设卡 ↔ 因子回链字段设计
  8. 权重演进视图数据源:weight_profiles 已落库(git 白名单),缺 UI 读出
  9. 现有九页映射迁移:改哪些 / 废哪些(归因·研判 / 设置去留)
  10. 窄屏要不要管(倾向 YAGNI 不管)

8. 落地路径(草案,定稿后细化)

spec 逐节拍板 → writing-plans 出实施计划 → 分域派单:②权重透明=factor 域;③出生流/④考窗/⑤时间线+车间=strategy 前后端(run 台账=infra+strategy 共建,是地基,先于一切页面——调研 §8 同结论)。

铁律:spec 先行 + 用户拍板再动代码(10-08「不要乱改」已立);人工卡点不动;设计变更档随码走(本稿收编后回归总设计 spec 单档原则)。

9. 引用

  • 调研报告:docs/superpowers/reports/2026-10-08-ux-redesign-survey.md(Top5 收敛:运行台账 / 生效参数回显 / 勾选对比只看差异 / 数字落库即成曲线 / 人工卡点内嵌主线——GitHub 正例「审批在流程页内黄条」,GitLab 反例)
  • 总设计:docs/superpowers/specs/2026-09-22-research-to-trading-pipeline-design.md(§4.3 晋级闸门 / §4.4 合成层 / §11 术语与归属)
  • 缺口审计与三矛盾修复:issue #92、commit 118c9df..8ed8432、memory pipeline-ux-redesign-20261008

10. 变更记录

  • 2026-10-08 v0.5 初稿落档(81adfbc,与调研报告同 commit;本条所在 commit=补挂 [nas] 标签备案,首条标题漏标签,工法沿用 5bb2d62 先例)