docs(readme): AI 助手章节补动作能力 — 19 查询 + 4 动作工具(确认卡)、数据健康检查、共用同步触发路径说明

- 能问什么表新增「数据健康」与「动作(须确认)」两行, 回测归入动作类
- 交互设计新增「动作确认卡」条目(完整待执行参数 + 确认/取消/120s 超时)
- 解耦说明改为如实描述: 数据补全与数据页共用核心层抽取的触发函数
- 功能总览 bullet / 对比表 / 快速开始示例问句 / 路线图行同步更新
This commit is contained in:
shy3130
2026-09-26 15:13:26 +08:00
parent 1d855de03b
commit 6b233ed95f
+10 -7
View File
@@ -70,7 +70,7 @@
| 数据源绑死,换一家要重写整套拉数代码 | **能力路由矩阵**:6 类数据集按源能力独立路由,随时换源,指标与回测口径不变 |
| 选股、回测、监控各用一套工具,口径对不上 | 全站统一 **enriched 数据口径**:选股 → 回测 → 监控 → 复盘一条链 |
| 盘中异动靠人盯盘,错过就是错过 | **竞价/盘中/偏移**全时段异动 + 实时弹窗、语音播报、飞书推送 |
| 想查个数据要在几个页面之间来回点 | **AI 对话助手**:一句话问出全站数据,取数过程逐条可见、可展开核对 |
| 想查个数据要在几个页面之间来回点 | **AI 对话助手**:一句话问出全站数据,取数过程逐条可见、可展开核对;还能经确认卡放行生成信号、跑回测、补数据 |
| 想基于面板数据做自己的工具/机器人,只能爬页面 | **开放接口 + MCP**:Token 六档权限、61 端点契约化、SSE 事件流,AI 客户端即插即用 |
| 付费终端贵、云端平台数据出不了本地 | **自托管**:Docker 单容器,数据全部落在本地 Parquet,零运维 |
@@ -206,7 +206,7 @@
- **设置** Settings — 数据源与能力检测(能力路由矩阵、档位徽章)、AI 接口、实时监控、扩展页面、开放接口(Token 管理)、菜单与系统设置
**🤖 AI 助手**
- **AI 对话助手** — 悬浮球 / 侧栏 AI 徽标旁入口 / ⌘K 呼出; 18 个只读工具覆盖个股·大盘·板块·自选·持仓·信号·策略·因子, 逐字流式输出 + 工具调用足迹卡(参数与耗时可展开核对), 每条回答附风险与数据口径提示; 完全解耦的扩展模块, 删除目录即卸载
- **AI 对话助手** — 悬浮球 / 侧栏 AI 徽标旁入口 / ⌘K 呼出; 19 个查询工具覆盖个股·大盘·板块·自选·持仓·信号·策略·因子·数据完整性, 外加 4 个**动作工具**(生成信号策略 / 回测 / 加自选 / 数据补全)——写操作先弹**确认卡**(完整待执行参数可见, 确认/取消/120s 超时自动取消)才执行; 逐字流式输出 + 工具调用足迹卡(参数与耗时可展开核对), 每条回答附风险与数据口径提示; 完全解耦的扩展模块, 删除目录即卸载
</details>
@@ -445,7 +445,7 @@ curl -H "Authorization: Bearer tsp_xxxx" \
| **AI 徽标旁入口** | 侧栏顶部模型徽标右侧, 一键展开 |
| **⌘K / Ctrl+K** | 全局快捷键随时呼出, Esc 关闭 |
**能问什么** — 18 个只读工具覆盖全站页面能力:
**能问什么** — 19 个查询工具覆盖全站页面能力, 4 个动作工具经确认卡放行:
| 类别 | 覆盖能力 |
| :--- | :--- |
@@ -453,19 +453,22 @@ curl -H "Authorization: Bearer tsp_xxxx" \
| **大盘** | 看板总览(涨跌家数·成交额·涨停连板·情绪雷达) · 指数行情 · 市场环境(regime) · 异动监控 |
| **板块** | 概念/行业板块盘中轮动、切换事件与资金排名 |
| **我的数据** | 自选列表(含备注与实时涨跌) · 持仓提醒 · 信号库 |
| **策略与因子** | 策略目录 · 执行选股策略取标的 · 因子目录 · 因子全市场排名 · 策略回测 |
| **策略与因子** | 策略目录 · 执行选股策略取标的 · 因子目录 · 因子全市场排名 |
| **数据健康** | 完整性检查(日线/enriched/分钟K 覆盖区间与停更、财务表缺口、单标的滞后) · 同步任务进度 |
| **动作(须确认)** | 生成信号策略(声明式白名单条件, 落库即用) · 运行策略回测 · 加入自选 · 数据补全(盘后管道/财务表/分钟K扩展, 后台执行·单飞去重) |
**交互设计**
- **逐字流式输出** — 文本按 token 逐步渲染, 长回答不再"整段蹦出"
- **工具足迹卡** — 每次调用的工具名、参数、耗时、结果摘要均可展开核对; 取数可核对是设计铁律
- **动作确认卡** — 生成信号/回测/加自选/数据补全等写操作先弹确认卡: 动作名 + 影响说明 + **完整待执行参数**, 你点「确认执行」才会真正运行; 拒绝或 120 秒超时自动取消, 模型被明确告知此时不得重试
- **非模态面板** — 从页面右缘滑入, 默认 720px, 左缘拖拽调宽(宽度记忆), 边看行情边问
- **会话历史** — 本地保存, 支持多会话切换与删除, 刷新不丢
- **固定合规提示** — 每条回答完成后附风险提示与数据口径提示
**完全解耦的扩展模块**
助手是项目扩展系统的参考实现, **零核心文件修改**: 后端 `app/custom/assistant/`(启动时自动发现并注册独立路由)与前端 `src/custom/assistant/`(构建时自动挂载到插槽)各自独立, **删除目录即整体卸载**。未配置 AI Key 或使用不支持工具调用的供应商(如 Codex CLI)时 fail-closed, 直接提示前往设置页。
助手是项目扩展系统的参考实现: 后端 `app/custom/assistant/`(启动时自动发现并注册独立路由)与前端 `src/custom/assistant/`(构建时自动挂载到插槽)各自独立, **删除目录即整体卸载**。数据补全工具与数据页**共用同一条触发路径**(为此在核心 API 层抽取了两个共用触发函数, 端点行为不变), 单飞去重与进度上报天然一致。未配置 AI Key 或使用不支持工具调用的供应商(如 Codex CLI)时 fail-closed, 直接提示前往设置页。
> ⚠️ 助手是数据分析工具, 不提供买卖指令; 涉及交易决策的问题会转换为客观的技术/财务状态、关键价位、风险因素与条件情景。
@@ -563,7 +566,7 @@ cp .env.example .env # 按需填 TICKFLOW_API_KEY(留空 = None 模式)
3. **自选**页加标的 → **选股**页点策略卡片扫描 / 配自定义信号
4. **回测**页选策略 + 区间 → 看净值 / 夏普 / 交易明细(SSE 实时进度),结果可导出 CSV、存候选一键复测
5. **监控中心**配规则,盘中实时弹窗 + 持久化记录;**异动监控**覆盖竞价/盘中/偏移全时段
6. 配好 AI Key 后,**悬浮球 / ⌘K** 呼出 **AI 对话助手**,直接问「今天市场怎么样」「我的自选表现如何」
6. 配好 AI Key 后,**悬浮球 / ⌘K** 呼出 **AI 对话助手**,直接问「今天市场怎么样」「我的自选表现如何」,或让它「生成一个放量站上 20 日线的信号」「检查一下数据完整性」——写操作会先弹确认卡, 你点确认才执行
7. 想接自己的程序?**设置 → 开放接口**建个 Token,照着 [examples/open-api](./examples/open-api/README.md) 十分钟跑通第一个脚本;AI 玩家直接配 [MCP](./mcp-server/README.md)
---
@@ -592,7 +595,7 @@ PORT=3018 # 服务端口
| 6 | 个股分析(专用日 K + 9 类关键价位 + AI 四维分析) | ✅ |
| **v0.2** | 因子挖掘全链路 · 市场阶段与主线识别 · 异动监控 · 数据源插件化 | ✅ |
| **v0.3** | 能力路由矩阵 · fuyao 数据源(财务/龙虎榜/风向标) · 分钟策略与回测 · 交易日探针 · 全时段异动中心 · 回测导出与候选复测 | ✅ |
| **AI 助手** | 对话式数据问答: 18 个只读工具覆盖全站页面 · 逐字流式 + 工具足迹卡 · 完全解耦扩展模块 | ✅ |
| **AI 助手** | 对话式数据问答与操作: 19 查询 + 4 动作工具(确认卡放行, 含生成信号/回测/加自选/数据补全) · 逐字流式 + 工具足迹卡 · 完全解耦扩展模块 | ✅ |
| **v0.3.2 开放能力版** | API Token + 六档 scope 网关 · 61 端点契约(快照+CI 守护) · 扩展数据读写闭环 · SSE 事件流 · MCP 服务器 · 核心/扩展域边界标注 | 🚧 0.3.2 分支 |
| **v2** | Webhook 推送· 板块异动 · 早晚报 · 全市场竞价采集 · 更多扩展 | 🚧 |