chore: create Multica handoff checkpoint
This commit is contained in:
leefer
@@ -0,0 +1,42 @@
|
||||
# ISSUE-001：问师界面与动态追问收口
|
||||
|
||||
- 状态：待人工验收/提交
|
||||
- 优先级：P0
|
||||
- 来源：当前工作区问师改造、产品规格 L06、14.3
|
||||
|
||||
## 目标
|
||||
|
||||
收口当前未提交的经典 QQ 式 PC 三栏问师界面和同次 LLM 调用动态追问，保持既有权限、流式、额度、对话隔离和错误回退行为。
|
||||
|
||||
## 已有实现
|
||||
|
||||
- 联系人、会话、资料/证据三栏。
|
||||
- `<XIAOBAI_FOLLOW_UPS>` 机器块剥离，最终 NDJSON `meta.follow_ups` 返回 2 至 3 条。
|
||||
- 点击追问只预填输入框；停止按钮不重新播放答案；没有第二次业务 LLM 调用。
|
||||
- 相关 Python 和 Playwright 测试已加入工作区。
|
||||
|
||||
## 范围外
|
||||
|
||||
不在本 Issue 内加入问师自动联网取数、金融爬虫、真人身份暗示或新的交易建议能力。
|
||||
|
||||
## 依赖
|
||||
|
||||
本地 LLM 主/辅助凭据、会员账号、可用的真实市场快照，以及 Issue 002 的公共 Shell 视觉状态。
|
||||
|
||||
## 验收标准
|
||||
|
||||
1. 会员可以切换模型、加载历史、发送问题、停止生成、清空当前会话。
|
||||
2. 流式正文只出现一次；主模型首字前失败最多辅助回退一次；已输出后失败不重放。
|
||||
3. 成功回答显示 2 至 3 条相关追问；点击不自动发送、不增加额度；下一轮、换模型、清空后旧追问消失。
|
||||
4. 追问结构无效、回答失败或用户停止时不显示追问。
|
||||
5. 日间/夜间及 1920×1080、3840×2160 无白边、遮挡、超长弹窗和输入区不可达。
|
||||
6. 普通用户不能发起 LLM 调用；账号甲乙对话互不可见。
|
||||
|
||||
## 验证
|
||||
|
||||
```powershell
|
||||
python -m unittest tests.test_mentor_stream tests.test_llm_stream tests.test_llm_gateway
|
||||
python tools/verify_baseline.py --e2e
|
||||
```
|
||||
|
||||
通过人工验收后单独提交并推送，记录回档提交号。
|
||||
@@ -0,0 +1,35 @@
|
||||
# ISSUE-002：当前 PC 全站视觉改动验收与回档
|
||||
|
||||
- 状态：待审查/提交
|
||||
- 优先级：P0
|
||||
- 来源：工作区现有 37 个修改文件和 `bd97ba1` 之后的视觉调整
|
||||
|
||||
## 目标
|
||||
|
||||
逐页确认当前公共 Shell、令牌、夜间模式和 16 个页面的视觉修改，保留用户认可的 PC 变化，拆出或回退无关变化，并建立可以人工回档的提交。
|
||||
|
||||
## 范围
|
||||
|
||||
检查 `frontend/shared/`、所有 `frontend/pages/*/foundation.css`、页面 HTML/JS、架构清单和对应 E2E 测试。重点是夜间白块、边距/滚动、表格对齐、弹窗层级、图表背景和问师三栏。
|
||||
|
||||
## 范围外
|
||||
|
||||
不以本 Issue 重写业务算法，不删除未确认的旧代码，不开始移动端独立设计；移动端另见 Issue 003。
|
||||
|
||||
## 验收标准
|
||||
|
||||
1. 16 个页面均可从默认情绪周期进入，功能和权限与提交前一致。
|
||||
2. 日间/夜间主题一次切换完成，不出现白闪、白色表头/搜索框/弹窗或 Hover 反色不可读。
|
||||
3. 1920×1080 和 3840×2160 下页面内容、固定状态栏、全页滚动和局部滚动符合规格，无双滚动冲突。
|
||||
4. 交易日明细、股池、天梯、轮动、竞价、题材、龙虎榜和选股的列宽/对齐/空态可读。
|
||||
5. 每个修改文件都有明确原因；提交不包含 `.env`、数据库、日志、缓存、截图或私有 Skill。
|
||||
6. 自动化、人工验收和 Git diff 检查均通过，提交可独立回退。
|
||||
|
||||
## 验证
|
||||
|
||||
```powershell
|
||||
python tools/verify_baseline.py --e2e
|
||||
git diff --check
|
||||
```
|
||||
|
||||
人工截图至少覆盖日间/夜间、1920×1080、3840×2160；验收结论写回 `docs/HANDOFF.md`。
|
||||
@@ -0,0 +1,26 @@
|
||||
# ISSUE-003：移动端独立重设
|
||||
|
||||
- 状态：明确延期，PC 稳定前不启动
|
||||
- 优先级：P2
|
||||
- 来源：产品规格第 20 节；当前移动端人工验收未通过
|
||||
|
||||
## 目标
|
||||
|
||||
在不改变 PC DOM、API、权限、数据口径和业务结果的前提下，单独设计移动 Shell、底部五入口、行情子导航、对话输入、抽屉和宽表摘要视图。
|
||||
|
||||
## 范围外
|
||||
|
||||
不能把桌面页面缩小、不能用 Hover 作为唯一入口、不能通过隐藏页面解决不可达问题，也不修改 PC 视觉作为“移动适配”。
|
||||
|
||||
## 验收标准
|
||||
|
||||
1. 320、375、390、430、768px 及手机横屏无页面横向溢出和内容遮挡。
|
||||
2. 底部行情/选股/问师/问天/复盘五入口可触控，目标不小于 44×44px。
|
||||
3. 行情子页面通过选择器或抽屉切换；宽表在 320px 使用摘要+详情或局部横滚，页面本身不横滚。
|
||||
4. 弹窗改为底部抽屉或全屏页后仍有关闭/返回路径；键盘弹出不遮挡问师/复盘输入区。
|
||||
5. 问天动画、表格状态、日夜主题和权限锁定在窄屏可读。
|
||||
6. 用户人工逐页验收后，才能把 `pages.config` 的移动意图标为完成。
|
||||
|
||||
## 依赖与验证
|
||||
|
||||
依赖 Issue 002。需要 Playwright 视口回归、真实手机人工操作和产品规格第 25.8、27.3 验收案例。
|
||||
@@ -0,0 +1,34 @@
|
||||
# ISSUE-004：完整 IC 动态多因子
|
||||
|
||||
- 状态：未实现，当前仅有基础动态多因子
|
||||
- 优先级：P1
|
||||
- 来源：产品规格 17.6、24.2；当前实现基线明确不得夸大
|
||||
|
||||
## 目标
|
||||
|
||||
把五类因子（估值、成长、质量、动量、情绪）从基础合成升级为可复现的 IC 动态加权模式，同时保留用户手动权重的专业模式。
|
||||
|
||||
## 必须实现
|
||||
|
||||
- 行业内去极值。
|
||||
- 因子 z-score 标准化。
|
||||
- 行业和市值中性化。
|
||||
- 使用过去 12 个月“因子值与下一期收益”的 Rank IC 均值定权。
|
||||
- 每季度重算、记录算法版本和样本覆盖。
|
||||
- 综合得分前 5% 输出；数据不足时逐因子说明缺失。
|
||||
|
||||
## 范围外
|
||||
|
||||
不使用 LLM 计算分数，不把缺失当 0，不将基础动态权重 UI 改名为 IC 完整版。
|
||||
|
||||
## 验收标准与验证
|
||||
|
||||
1. 固定样本可复现每个因子预处理、IC、权重和排名。
|
||||
2. 严格按公告时点和下一期收益计算，无未来函数。
|
||||
3. 季度边界、行业小样本、缺因子、负 IC 和极端值均有测试。
|
||||
4. UI 明确“基础动态权重/IC 自动权重”差异及数据日期。
|
||||
5. 回测结果保存输入快照、算法版本和输出版本。
|
||||
|
||||
```powershell
|
||||
python -m unittest discover -s tests
|
||||
```
|
||||
@@ -0,0 +1,25 @@
|
||||
# ISSUE-005：政策、宏观与隔夜消息数据
|
||||
|
||||
- 状态：数据源未定
|
||||
- 优先级：P1
|
||||
- 来源：产品规格 14.4、17.6、23.3；当前字段注册表尚无稳定计算来源
|
||||
|
||||
## 目标
|
||||
|
||||
为宏观思维模型、集合竞价和问师补充可授权、可归档、带时间戳的政策、公告、指数、ETF、汇率、利率、商品和隔夜资讯数据。
|
||||
|
||||
## 验收标准
|
||||
|
||||
1. 每个字段登记来源、授权、发布时间、交易日、单位、新鲜度、覆盖率和显示/计算用途。
|
||||
2. 历史结果能按快照和版本复现，公告发布时间晚于目标时点的数据不能进入过去结果。
|
||||
3. 消息去重、来源冲突、撤回/修订和上游失败有明确规则。
|
||||
4. 竞价量化只使用已经登记且在目标时点可见的消息证据；无数据显示“数据缺失”，不显示“暂无信号”。
|
||||
5. 问师宏观模型只追加适用上下文，不把政策新闻强塞给其他流派。
|
||||
|
||||
## 范围外
|
||||
|
||||
不接入未经授权的网页爬虫，不把金融爬虫 Skill 作为正式 Provider。
|
||||
|
||||
## 依赖
|
||||
|
||||
供应商授权和 Issue 010 的数据质量/凭据核验。
|
||||
@@ -0,0 +1,20 @@
|
||||
# ISSUE-006：分析师一致预期数据
|
||||
|
||||
- 状态：数据阻塞（`research.consensus` 为 `unresolved`）
|
||||
- 优先级：P2
|
||||
|
||||
## 目标
|
||||
|
||||
提供按公告时间可追溯的盈利预测、一致预期、预测修正、评级变化、目标价和研报数量，供策略因子和问师宏观/基本面上下文按需使用。
|
||||
|
||||
## 验收标准
|
||||
|
||||
1. 字段包含来源、分析师/机构（如授权允许）、公告时间、报告期、单位、币种和版本。
|
||||
2. 目标日期只能读取当时已发布的数据；修正保留历史，不覆盖旧快照。
|
||||
3. 缺失、过期、覆盖不足和无命中状态可区分。
|
||||
4. 策略候选与回测固定输入下可复现；不能把缺失预测当 0 或中性。
|
||||
5. 权限和授权边界经过审计，私有/授权数据不进入浏览器或普通日志。
|
||||
|
||||
## 范围外
|
||||
|
||||
没有稳定授权来源前，不在 UI 中显示伪造的“分析师共识”指标。
|
||||
@@ -0,0 +1,20 @@
|
||||
# ISSUE-007：Level-2 与动态竞价深度
|
||||
|
||||
- 状态：授权阻塞（`market.level2` 为 `unresolved`）
|
||||
- 优先级：P2
|
||||
|
||||
## 目标
|
||||
|
||||
在取得正式授权后，接入逐笔成交、逐笔委托、委托队列、未匹配量和开板深度，增强集合竞价与盘中观察。
|
||||
|
||||
## 验收标准
|
||||
|
||||
1. 供应商、授权、字段、时间精度、单位和保留期限登记在数据配置。
|
||||
2. 动态快照标出采集时间；断线、延迟和部分覆盖不会伪装成实时完整数据。
|
||||
3. 9:15–9:25 动态观察与 9:25 最终竞价归档分开保存；不能用最终快照冒充动态过程。
|
||||
4. Level-2 数据不进入未授权的历史回测；重连和重复消息幂等。
|
||||
5. UI 在数据缺失时保留已有成功快照并给出可执行提示。
|
||||
|
||||
## 范围外
|
||||
|
||||
未获得授权前不使用公开网页抓取或模拟队列填充。
|
||||
@@ -0,0 +1,20 @@
|
||||
# ISSUE-008：游资档案历史画像
|
||||
|
||||
- 状态：低优先级，基础名录和详情已存在
|
||||
- 优先级：P3
|
||||
|
||||
## 目标
|
||||
|
||||
完善游资名录、席位别名、历史上榜、买卖倾向、常见题材和证据来源，支持龙虎榜页面左名录右详情，不再依赖超长弹窗。
|
||||
|
||||
## 验收标准
|
||||
|
||||
1. Tushare 已收录席位完整展示；未知或无法识别席位保留原名并标记待归类。
|
||||
2. 别名合并有来源、人工修订记录和可回退历史。
|
||||
3. 历史画像按日期、股票、方向和金额可追溯；不把单日行为直接概括为稳定风格。
|
||||
4. 点击名录进入详情，桌面/夜间/低分辨率可读，无异常空弹窗。
|
||||
5. 龙虎榜出现“有股票上榜但席位不可识别”时，展示该状态而不是“无数据”。
|
||||
|
||||
## 依赖
|
||||
|
||||
依赖稳定龙虎榜席位数据和人工别名维护；不阻塞其他市场页面。
|
||||
@@ -0,0 +1,26 @@
|
||||
# ISSUE-009：活跃文档和状态漂移
|
||||
|
||||
- 状态：待整理
|
||||
- 优先级：P1
|
||||
|
||||
## 目标
|
||||
|
||||
让活跃文档、配置注册表、启动端口和完成状态与正式 `app/` 实际一致，历史迁移材料继续保留但明确仅用于审计。
|
||||
|
||||
## 检查范围
|
||||
|
||||
- `README.md`、`docs/README.md`、`docs/maintenance/人工维护指南.md`。
|
||||
- `config/pages.config.json` 的移动端意图与实际验收状态。
|
||||
- 默认端口 8765、局域网验收端口 8797 及 Docker 文档的区分。
|
||||
- 迁移文档中的“待人工验收”等历史表述是否被误读为当前状态。
|
||||
|
||||
## 验收标准
|
||||
|
||||
1. 活跃文档只描述当前正式源码和真实启动方式，过期内容链接到历史说明并标注日期。
|
||||
2. 文档声明移动端仍延期，不能把媒体查询或 `dedicated` 注册值当作已完成。
|
||||
3. 端口、健康检查、数据目录、备份和回退命令在干净环境可执行。
|
||||
4. `docs/HANDOFF.md` 与 Issue 索引同步更新，所有相对链接有效。
|
||||
|
||||
```powershell
|
||||
python tools/verify_baseline.py
|
||||
```
|
||||
@@ -0,0 +1,26 @@
|
||||
# ISSUE-010：数据源与 LLM 在线就绪核验
|
||||
|
||||
- 状态：待运行核验
|
||||
- 优先级：P0
|
||||
|
||||
## 目标
|
||||
|
||||
在不把任何密钥写入仓库的前提下，恢复本地/局域网服务并分别证明进程、数据库、Tushare、iFinD、LLM 主/辅助模型和后台任务的健康状态。
|
||||
|
||||
## 验收标准
|
||||
|
||||
1. `0.0.0.0:8797`（或部署指定端口）可访问 `/api/health`，健康响应区分进程、数据库、数据源、任务和模型。
|
||||
2. 登录后能读取最近真实交易日；无快照时显示等待同步，不显示演示数字。
|
||||
3. 管理员诊断页可看到脱敏的来源、错误类型、关联 ID 和最后成功时间；普通用户看不到 Token、URL、模型名或堆栈。
|
||||
4. Tushare/iFinD/LLM 单独测试成功或给出明确缺失/授权/网络原因；失败不清空已有成功数据。
|
||||
5. 重启后账号、行情、问师/问天历史、选股和复盘记录不丢，盘后任务不重复产出。
|
||||
|
||||
## 验证
|
||||
|
||||
```powershell
|
||||
powershell -ExecutionPolicy Bypass -File tools/start_local.ps1 -Port 8797
|
||||
Invoke-RestMethod http://127.0.0.1:8797/api/health
|
||||
python tools/verify_baseline.py --e2e
|
||||
```
|
||||
|
||||
凭据只从管理员系统设置或受保护环境注入，不能写入 Issue、截图或日志。
|
||||
@@ -0,0 +1,24 @@
|
||||
# ISSUE-011：公网部署加固
|
||||
|
||||
- 状态：未来范围，局域网版不阻塞
|
||||
- 优先级：P3
|
||||
|
||||
## 目标
|
||||
|
||||
在真正转向外网和商业授权前，将当前单实例局域网部署升级为可审计的公网部署方案。
|
||||
|
||||
## 必须完成
|
||||
|
||||
- 反向代理、TLS、可信 Host、Secure Cookie、CSRF、限流和审计。
|
||||
- PostgreSQL 或等价正式数据库迁移，连接池和并发写入策略。
|
||||
- 后台任务队列、分布式锁、缓存、健康检查、集中日志和告警。
|
||||
- 多实例数据一致性、密钥托管、备份恢复和升级回退演练。
|
||||
- 会员/激活码/授权模型的服务端鉴权和额度审计。
|
||||
|
||||
## 范围外
|
||||
|
||||
在没有部署决策和容量指标前，不为局域网版本预先拆微服务或引入云依赖。
|
||||
|
||||
## 验收标准
|
||||
|
||||
公网威胁模型、ADR、压测、故障注入、备份恢复、跨实例重复任务和安全扫描全部有记录；局域网数据边界和产品行为不变。
|
||||
@@ -0,0 +1,19 @@
|
||||
# 未完成事项 Issue 索引
|
||||
|
||||
这些 Issue 是仓库内的可审计任务说明，供人工维护或后续智能体执行。它们不是通过 Gitea API 创建的远端工单；需要远端协作时，应在确认范围后逐项复制到 Gitea，并保留本地文件作为产品交接记录。
|
||||
|
||||
| Issue | 标题 | 状态 | 优先级 |
|
||||
|---|---|---|---:|
|
||||
| [001](ISSUE-001-finalize-mentor-redesign.md) | 问师界面与动态追问收口 | 待人工验收/提交 | P0 |
|
||||
| [002](ISSUE-002-checkpoint-current-pc-visual-work.md) | 当前 PC 全站视觉改动验收与回档 | 待审查/提交 | P0 |
|
||||
| [003](ISSUE-003-mobile-redesign.md) | 移动端独立重设 | 明确延期 | P2 |
|
||||
| [004](ISSUE-004-full-ic-multifactor.md) | 完整 IC 动态多因子 | 未实现 | P1 |
|
||||
| [005](ISSUE-005-policy-macro-overnight-data.md) | 政策、宏观与隔夜消息数据 | 数据源未定 | P1 |
|
||||
| [006](ISSUE-006-analyst-consensus-data.md) | 分析师一致预期数据 | 数据阻塞 | P2 |
|
||||
| [007](ISSUE-007-level2-auction.md) | Level-2 与动态竞价深度 | 授权阻塞 | P2 |
|
||||
| [008](ISSUE-008-hot-money-profile-history.md) | 游资档案历史画像 | 低优先级 | P3 |
|
||||
| [009](ISSUE-009-documentation-status-drift.md) | 活跃文档和状态漂移 | 待整理 | P1 |
|
||||
| [010](ISSUE-010-live-provider-llm-readiness.md) | 数据源与 LLM 在线就绪核验 | 待运行核验 | P0 |
|
||||
| [011](ISSUE-011-public-deployment-hardening.md) | 公网部署加固 | 未来范围 | P3 |
|
||||
|
||||
关闭任一 Issue 前，必须更新 `docs/HANDOFF.md` 的状态、验证日期和回档提交；不能只改 Issue 标题。
|
||||
Reference in New Issue
Block a user