Repository navigation
Releases: ydflow/research-trail
Release list
研迹 v1.0.0:Windows 本地 AI 投资研究工作台
研迹 v1.0.0
研迹是运行在本机的 AI 投资研究工作台:从证券资料与研究计划,到可追溯报告、论点复审、提醒与后续结果,保留每次判断的来源和时点。
本版功能
- Python 管理会话、消息、事件、研究、规则、评测和 SQLite 状态;Electron 管理桌面、白名单通信、通知和所属后端进程。
- 证券/自选/组合工作区、风险与标的对比、八种研究策略、17个有界筛选任务、带来源的事件日历,以及 Today 六来源聚合。
- 逐能力采集、部分失败、超时/取消与显式恢复;引用回读、报告 Markdown、报告 Diff、论点与复审。
- 可选主观概率、价格/时点校验、结果窗口冻结、足量样本下的 Brier/分箱及参数版本/回滚。样本不足、行情缺失、窗口未到不虚报评价。
- 原创12个离线工程案例、实验/基线/工具轨迹/失败分类/反馈;同一冻结资料的模型 A/B 与八项完整人工质量量表。工程正确率、研究质量和投资结果分别显示。
- 前端、Python3.12、依赖、迁移、技能、TLS/时区和来源/许可随 Windows x64 安装包提供,启动无需开发环境。
下载与核验
ResearchTrail-1.0.0-windows-x64-setup.exe,142270088字节。
SHA256:
a630d520d40efe6a901fb6fc87e5a572508a13b3dde5eaf59ca06a451b3315cd
Windows PowerShell:
Get-FileHash .\ResearchTrail-1.0.0-windows-x64-setup.exe -Algorithm SHA256安装器源码提交 edc2e601e008798be132fdc8deeae69b5a1d7ea5,已提交且干净;后续测试夹具、CI和验收文档修改不改变打包的应用代码。版本标签提交以本 Release 对应提交为准,保留分类提交及普通合并记录。
实际验收
- 干净源码导出与重新安装锁定依赖:696 Python、15 Node、58实际Electron通过,根CMD启动/取消/退出/重启历史一致,不新增运行。
- 指定SHA安装包:15个开发机实际NSIS阶段通过,包含首装、资源、受限PATH与仓库外启动、单实例、页面、离线研究/评测/A-B、正常与异常退出清理、精确重启、原创0017→0020迁移、卸载库SHA不变及重装回读。开发机成功不代表独立干净Windows。
- Longbridge真实AAPL.US采集14项成功、2项失败,仍为partial。step-3.7-flash / step-3.5-flash使用同一冻结数据,两份报告的结构与引用通过;按用户授权累计10次请求,无自动重试。真实报告尚未人工质量评审,无质量delta。
- SDK精确官方编译版本的263个外部crate/9个本地crate、471份许可与MPL源码供应链接、Rust许可及官方wheel/本机扩展字节一致性已核对。原声明保持;不宣称密码学验证SDK构建或整仓MIT。
使用边界
- 默认规则演示是假模型,固定行情是模拟数据,不是实时行情。真实数据和真实模型需分别配置,真实失败不会自动冒充模拟成功。
- 独立干净Windows按用户明确要求跳过/未验证。安装器未签名;SmartScreen/杀毒/其他Windows版本、长期压力和非ASCII用户名未验证。
- 真实报告质量、足量真实校准/投资表现、完整账户、其他市场/CLI日历/财务、Massive及LangSmith/Langfuse真实连接和长期重连未验证。外部追踪默认关闭,上传前脱敏;CI只有确定性离线评测。
- 本版不提供下单或盈利承诺。提醒与自动化仅在应用运行时调度,关闭期间不常驻、不假称已执行。
- 卸载默认保留用户数据库和系统凭证;升级前退出并备份。安装资源与用户数据分离,彻底清除步骤见项目安装说明。
两张展示图来自同一打包应用的独立模拟目录,实际界面截图,不是设计稿、真实账户或真实模型质量证明。具体功能/来源及完整证据见仓库 docs/ACCEPTANCE-v1.0.0.md、docs/FEATURE-AUDIT-step24.md、docs/WINDOWS-INSTALL.md 与 docs/BUNDLE-NOTICE.md。
标签与远程验收
版本标签提交:6e2025437588e3e26748496ca324262e59296b10(PR #25普通合并,保留分类提交)。完整Windows离线CI:37910204557,696 Python / 15 Node / 58 Electron及契约/类型/构建/迁移通过。前两次CI等待超时保留记录,修复夹具后重新完整验证,未跳过失败案例。
研迹 v0.1.0:假模型与模拟数据源码首版
研迹 v0.1.0:假模型与模拟行情源码首版
本版为Windows开发源码交付,覆盖第1—7步。模型使用确定性规则的 FakeModelProvider(规则演示/假模型),行情使用独立的 FixtureMarketProvider(模拟数据)。没有真实LLM推理或实时行情接入,不应作为投资决策或交易依据。
提交:716543305ba5d74f57336c589c4b2dffaf6e3592,第7步通过 PR #6普通合并,保留分类提交和来源历史。此次只创建版本标签及源码Release,没有新增业务功能。
已实现
- Electron/React桌面与Python 3.12/FastAPI后端:所属Python子进程管理、随机本机端口与启动令牌、白名单preload、健康状态、失败原因及重试。
- AAPL.US、NVDA.US、MSFT.US、TSLA.US固定行情和K线,选股/卡片/图表一致,未知代码明确报错;固定市场时间和独立获取时间,界面标记模拟数据。
- SQLite/SQLAlchemy/Alembic持久会话、消息、运行和事件:创建、列表、选择、删除及历史恢复。Python统一管理业务状态,前端维护显示缓存;Pydantic/OpenAPI生成前端TypeScript契约。
- 最小规则Agent通过Python注册工具读取模拟行情/K线,显示工具过程和结果卡片;未知意图说明支持范围,工具错误传播为失败,不由模型写死价格。
- 主动取消、工具/运行超时、唯一终态、删除活动会话前取消、重启标记未结束运行为中断;保留已保存内容,不自动重调工具或模型。
- 数据库快照后订阅SSE,事件先持久化再发送;按运行ID/单调序号续读与去重,切会话解除旧订阅,历史读取不重新执行工具。
- 根
start-dev.cmd、统一check.cmd、干净源码验收脚本,以及只读Windows GitHub Actions。安装准备允许下载依赖,验收仅本机通信,不调用真实模型/行情服务,无定时付费评测。
验证
- 此版本提交已在隔离Git检出中按README重新安装锁定依赖及准备Electron:Python 73、Node 8、真实Electron 12 项全部通过且无跳过;契约、类型、构建、重复迁移通过。Python有一条上游Starlette/TestClient httpx弃用提示。
- 从副本根
start-dev.cmd实际启动:选股票→创建会话→查询行情→取消→关闭/重启查看历史通过;4条消息/2次运行、重启快照相同、获取时间不变、没有新增运行,所属子进程归零,源码工作区保持干净。 - 发布提交的 main CI已成功。验收和Windows检出/断流测试修复记录见 EVIDENCE第20—21节;用户亲自操作清单仍由用户本人填写,不把自动实窗验收代记为用户操作。
获取与启动
使用本页GitHub自动生成的 Source code (zip / tar.gz),或:
git clone --branch v0.1.0 --depth 1 https://github.com/ydflow/research-trail.git
cd research-trail
call start-dev.cmd需预先安装Node.js 24、Bun和uv;Python 3.12由uv管理,首次依赖/Electron准备需要网络。详见版本内 README。验证环境为Windows、Node 24.19.0、Bun 1.4.2、uv 0.12.8、Python 3.12.14、Electron 44.5.1,可复用本机下载缓存;不等同于空缓存或无开发工具的干净机器安装。
验证边界与来源
真实LLM、实时行情、账户/持仓/下单、完整研究/组合/提醒等后续能力未实现或未验证。安装包、其他操作系统、真实外部Provider阻塞取消、迁移降级/备份恢复、大历史分页及长时重连压力未验收;普通响应/单SSE帧仍有256KiB限制。
本版不上传安装包、运行数据库、密钥、账户数据、日志、缓存或截图,只交付Git源码。未来v1.0.0只有通过安装包验收后才附Windows安装包与SHA256,本版不承诺该能力已完成。
Folio局部UI适配保留固定来源及用户确认的原作者复用授权记录,第三方LICENSE/NOTICE保留;不据局部许可证宣称全仓MIT。仓库内验收文档记录的是标签创建前的开发/PR交付阶段,本页是v0.1.0版本发布回执。