Repository navigation
研迹 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版本发布回执。