📈 GH Trending Explorer 🎲 Surprise me

← all repos

ydflow / Trail

git clone https://github.com/ydflow/Trail.git

研迹 Trail|本地优先的 AI 投资研究工作台。连接行情、K 线与深度研究,让判断可追溯、风险可复核。Local-first AI investment research desktop with an evidence-grounded copilot.

—
stars, 24h
+95
stars, 7 days · #572
+95
stars, 30 days · #2,472
95
★ total · +95% this week
24
forks · 0 open issues

Star history starts 2026-10-20; the chart appears after the second daily snapshot.

LanguageTypeScript
License—
Created2026-10-16 (4d ago)
Last push1d ago
Watchers11
OwnerUser

GitHub topics

Links

README excerpt
Trail · 研迹 
 English · 简体中文 
 从市场线索到投资判断,让每一次研究都有迹可循。 
 本地优先的 AI 投资研究桌面工作台,连接行情、图表、Agent、证据与持续复核。
 产品预览 · 核心功能 ·
 快速开始 · 系统架构 ·
 参与贡献 
## 为什么做研迹
价格、新闻、财报和聊天回答往往散落在不同窗口里。研究完成后,留下的通常只有一句结论:当时依据什么、哪些数据已经过时、下一次变化是否推翻原判断,都需要重新整理。
**研迹把这条工作链放回同一个桌面:发现线索 → 查看证券 → 发起研究 → 核验证据 → 保存投资逻辑 → 持续复核。** 面向需要反复研究公开市场标的的个人投资者,也为 Agent 应用开发者提供一套可检查的桌面工程实现。
**研迹=研+迹。研究留下痕迹。** Trail 既是一条研究路径,也是一条能回头核验的证据轨迹。
> 当前为 Beta,提供 Windows x64 安装版与便携版。Trail 提供只读研究与决策支持,不提供下单或自动交易。模型分析与置信度不代表投资收益或正确率保证。
## 产品预览
### 深度研究:行情、证据与判断,在同一工作区
以证券为中心展开 K 线、研究依据和判断侧栏;报告完成后可以查看分项结论、风险、催化剂,并继续保存为投资逻辑。
### 证券工作台与 AI 副驾驶
自选、报价、财务、新闻与图表共享当前证券上下文。右侧助手可以读取结构化数据,以流式回答补充解释;来源入口保留在回答旁边。
### 数据来源可以打开检查
从引用进入来源检查器,查看数值、提供商、获取时间、规范化链路与快照哈希。价格时间缺失、来源过期与数据不可用会保留在可见状态中。
### 更多工作区
| 今日概览 | 机会发现 |
| --- | --- |
| | |
| 自选异动、事件、简报与下一步研究入口。 | 按市场、基本面、技术与事件组织筛选任务。 |
| 投资组合 | 事件与催化剂 |
| --- | --- |
| | |
| 资产配置、持仓和进入研究的操作。 | 财报、宏观事件与研究上下文。 |
| 技能中心 | 评测中心 |
| --- | --- |
| | |
| 按能力依赖显示技能就绪情况。 | 实验、基线、失败模式与人工反馈入口。 |
| 设置中心 | 追踪与隐私设置 |
| --- | --- |
| | |
| 模型、语言、主题、连接与诊断。 | 可选 Langfuse / LangSmith 连接与隐私控制。 |
### 结构化回答:行情、组合与风险
| 组合持仓表 | 组合风险对比 |
| --- | --- |
| | |
以上三种回答均在当前 Electron 客户端实际运行,由本地确定性 Agent 和示例数据生成,包含数据来源与证据入口。
**截图说明:** 以上均来自当前源码构建的真实 Windows Electron 界面。研究、证券工作台与来源检查器使用长桥公开证券数据和已配置的 DeepSeek 模型;今日、组合、发现与事件展示独立演示配置下的内置示例内容,组合金额与持仓不是实际账户资产。评测中心展示 15 个离线 fixture 案例的样例实验;设置图片仅展示配置入口,不代表真实模型质量或云端追踪验收。截图中的价格、新闻、报告立场及置信度均为采集当时的快照,详见截图记录。
## 核心功能
### 1. 以证券为中心的研究工作台
- 自选列表与证券搜索,联动报价、K 线、概览、财务和新闻。
- 图表支持多周期、OHLCV 读数与均线;刷新、浅色/深色主题和助手收起入口常驻顶部。
- 新研究界面把图表、依据表、判断、置信度、风险和下一步放在同一视野;未形成结论的目标价、周期等字段保留为 `—`。
- 2–4 只标的横向对比,覆盖估值、成长、盈利能力、股息、评级及动量等维度;可用字段取决于提供商覆盖。
### 2. 深度研究:先收集事实,再综合分析
- **8 种策略**:全面、价值投资、成长、技术面、财报、事件驱动、风险复核、稳健收益。
- 策略选择类型化能力计划,按有界并发获取数据,再交给 Agent 综合;支持超时、取消和部分完成状态。
- 报告包含总体立场、置信度、分项判断、看多/看空理由、催化剂、风险与能力执行依据。
- 报告历史与 Research Diff 支持复查结论、估值、风险和置信度的变化;支持 Markdown 导出及分享卡片。
- 持久化 checkpoint 保存执行计划与已完成依据;意外中断后可以恢复、重新开始或丢弃。恢复会复用已保存的结果,保留不确定请求的重试与预算记录。恢复机制
### 3. 上下文感知的 Agent 副驾驶
- Pi runtime 驱动持久会话、流式输出、模型切换、思考等级与停止操作;本地确定性 runtime 用于开发和演示。
- 当前证券、页面与选中持仓作为工作区上下文传入,减少反复解释“正在看什么”。
- 支持 Markdown、结构化行情/组合卡片、工具执行状态与运行追踪入口;格式不合法的数据块会降级显示。
- 会话、消息和运行由主进程管理,重启后可重新加载;内部研究综合会话不混入可见聊天记录。
### 4. 引用与证据链
- 金融数据经过提供商规范化和能力层进入 UI 与 Agent,共享同一套数据契约。
- 引用可定位到工具来源;来源检查器展示数值、来源、时间、新鲜度、证据链和快照哈希。
- 缺失数据、失败能力与部分报告保留显式状态,避免把“没有数据”写成“负面结论”。
- 外部新闻按不可信内容处理,相关防护与验证边界见提示注入防护。
### 5. 从发现线索到持续复核
- **17 个确定性筛选任务**覆盖异动、基本面、技术与事件;候选携带依据和理由进入研究、对比或自选。规则在所选证券范围内运行,不等同于全市场扫描。
- 今日概览聚合自选异动、市场脉搏、组合关注事项、提醒、事件、近期研究与待复核投资逻辑。
- 报告可保存为可编辑的投资逻辑,结合新数据重新评估;提醒覆盖价格、新闻、财报、评级、股息、持仓权重和回撤。
- 投资组合支持券商只读接入与手动导入,查看配置、集中度、大额持仓、敞口及风险信号。
### 6. 能扩展,也能评测
- 单一能力注册表连接提供商、Agent 工具、研究流程、UI 与技能就绪状态。
- `SKILL.md` 技能包声明能力依赖,按需加载指令与参考资料,支持启用/禁用。
- 内置评测中心支持实验、基线、模型对比、失败模式、案例详情与人工反馈;`trail-agent-v1` 基准集含 **86 个案例**,另有深度研究黄金案例集。
- 可运行离线 fixture 评测与真实模型实验;可选 Langfuse / LangSmith 追踪。评测工作流当前为手动触发,离线结果与真实模型结果分别核验。评测文档 · Langfuse 接线
## 工作原理
 [code] 
**主进程拥有业务状态,渲染进程负责展示与交互。** React/Jotai 是视图层,预加载桥只暴露白名单接口;市场数据与研究工作流通过统一能力契约衔接提供商,供应商细节留在适配器内。会话和研究采用本地文件持久化,凭证由主进程通过 Electron `