技术路线

从本地工具,到可扩展的投资 SaaS

股励 AI 以个人实盘看板为起点,逐步构建 AI 驱动的投资记录与分析平台。 这里是完整的技术开发进度与规划路线。

15已完成功能
2进行中
9未来规划
v13当前 Schema

P0 · 已完成

营销主页
Hero 区、功能介绍、定价表、注册入口全部落地。Apple Light 设计语言贯穿始终,深色模式支持。
Next.js 15App RouterCSS Variables
手机号注册 / 登录
任意手机号 + 任意验证码即可注册,cookie 双写,middleware 路由保护。JSON 文件后端已迁移至 SQLite 11 张规范化表。
SQLitebetter-sqlite3Cookie Auth
运营后台 /admin
token-gated 独立入口。5 张统计卡(含累计 AUM)+ 11 列用户表 + 520px 抽屉(KV 面板 / 前 5 持仓 / 最近 5 交易 / 运营编辑 / 删除二次确认)。CSV 18 列导出(UTF-8 BOM)。AI Agent API Key 可视化配置。
Admin ConsoleAPI Key 配置CSV 导出
交割单导入(FIFO · 双账户)
券商 xlsx 拖入,自动识别信用/普通账户。子串匹配覆盖港股通变体(沪/深)。增量上传 dedupe by (date|time|code|type|qty|netAmount),券商导出滚动窗口无需全量重传。
SheetJSFIFO 算法增量去重
持仓 & 资金看板
净资产曲线(Hero 玻璃卡 + 蓝色 3D 光泽折线 + 时间轴重放)、6 张指标卡、资金面积图、仓位 Donut、风险雷达、今日操作时间线(分页 5 条/页)。
CanvasChart.js动画重放
历史盈亏 · 4 视图
完全清仓战绩 / 交易流水 / 打新记录 / 融资成本,独立排序/筛选/分页。CSV 导出含 UTF-8 BOM,Excel 打开不乱码。
CSV 导出4 视图分页
新用户空态看板 + 一键生成
未上传交割单时展示 10 张灰色占位卡(上传后显示);拖入 xlsx → FIFO 计算 → 800ms 后 reload 全看板亮起。按手机号 namespace 持久化,换设备自动恢复。
空态体验一键生成手机号 namespace
偏好设置(主题 + 单位)
齿轮菜单 → 右抽屉 segmented 控件:浅色/暗色(Claude 暖色深色盘)+ 货币单位 万/元。anti-FOUC inline 脚本首帧挂 data-theme,无白闪。per-phone 命名空间。
Dark Mode货币切换anti-FOUC
每日复盘 AI v2
Qwen-Flash 主力(¥0.3/¥0.6 per 1M tokens)+ DeepSeek fallback。schema:按账户分块 + 归因优先 + 事件日历 + 个股新闻。硬性规则:维持担保比率仅 credit;单股+杠杆组合风险强制高亮;新闻 title/url 逐字复制(不允许编造);合规词过滤(不推票 / 不给目标价 / 不写止损)。
Qwen-Flash按账户分块合规过滤
服务端 Synthesize(Phase B)
POST /api/user/synthesize-portfolio 读取 prices.sqlite 真实 EOD 收盘价做 MTM。backgroundResynthIfStale 首屏 3s 后 + 每 10 分钟自动后台升级,用户无需手动刷新。
prices.sqliteEOD MTM自动后台同步
港股汇率归一化(HK Connect)
per-trade fxRate 从交割单反推(amount / price × qty)。HK Connect 港股通成本统一按 CNY 现金发生额/股。clamp 防御(fxRate ≥ 0.98 → 0.93 兜底)。FIFO 港股通变体子串匹配(沪/深后缀)。
HKD→CNYHK Connect CNYBug 6.5/8
信用账户精细化算账
debt 事件穿透修复:偿还融资本金 / 利息 / 利息归本 在 synthesize 内独立处理,不再被 FIFO 白名单丢弃。维持担保比率从错误的 158.75% 校正到真实的 661%(vs 券商 660.99%,偏差 0.03%)。
Debt Events担保比率Bug 9
Price Worker(AKShare)
Python sidecar,A 股 + 港股全市场 EOD。WAL SQLite,日线 UPSERT 幂等。pm2 5 次/天 cron(01 / 04 / 08 / 17 / 21 点)自动更新,12 个月历史已回填(A 股 5509 只 / 港股 2755 只)。
AKShareSQLite WALpm2 5×/天
日历工作日补全
服务端与浏览器双路径均已实现首末交易日之间工作日 gap-fill,非交易日持仓 carry-forward,EOD 价格正确反映每日涨跌。
Gap-fill工作日补全
生产部署方案
pm2 cluster(4 worker 共享 3000 端口)+ Nginx 反代 + 限流 + 静态资源加速 + Let's Encrypt TLS。SQLite .backup 热备 + gzip + 14 天滚动。autocannon 三场景压测(p99 < 200ms @ 500 并发)。阿里云 ECS 部署 runbook 完整。
pm2 clusterNginxSQLite 热备

P1 · 进行中

新闻 / 披露日历数据管道
接 AKShare stock_news_em + 巨潮资讯披露日历(未来 14 天财报/分红/股东大会)+ 行业事件 RSS,抓进 news.sqlite。aggregator 把真实新闻池 + 日历注入 AI 复盘,LLM 的 calendarHighlights 和 perStockNews 从「空数组」变成「可点击跳转原文」。
AKShare 新闻披露日历news.sqlite
社区 & 公开主页
/u/username 个人公开看板,「实盘透明」徽章,发现频道。publicOptIn 字段由用户主动勾选,隐私前置设计。
公开主页绿 V 认证发现频道

P2 · 下一阶段

AI 复盘缓存与去重
aggregator 输出 inputHash(滚动哈希),agent_runs 表按 user_id、scenario、inputHash 做幂等。同一持仓和同一价格切片重复点击 AI 生成复盘时直接返回已有 run,不再重复调用 LLM。
inputHashagent_runs幂等缓存
移动端 PWA + 跨端深入
已有 Expo RN(iOS/Android)+ Taro 3(微信/支付宝)骨架,@gupiao/core 共享。下阶段深入响应式细节 + 原生手势 + 小程序发布审核。
Expo RNTaro 3PWA
付费订阅 + 收款
专业版(¥39/月)+ 高级版(¥99/月)。AI 额度管理,年付折扣。微信支付 + Stripe 双通道。
Stripe微信支付额度管理
年报自动解读
上市公司年报 PDF 拆解,自动提炼营收/利润/现金流/管理层风险提示,与持仓仓位联动分析。
PDF 解析LLM 摘要财报日历
风险预警推送
当持仓个股发生重大公告(停牌 / 退市风险 / 大股东减持超 5%)时,实时推送微信 / 短信告警。
Supabase Realtime微信模板消息

P3 · 未来规划

数据导出 API
RESTful API 开放持仓快照、历史盈亏、每日复盘数据,支持第三方工具(表格/BI)集成。API Key 管理 + 速率限制。
REST APIAPI KeyOpenAPI 文档
汇率精细化
按日期查询人民银行 HKD/CNY 中间价,MTM 从「建仓口径」切换到「市场中间价口径」,pnl 语义更贴近真实。
人民银行汇率hkd_cny_daily 表
多账户 & 多组合
一个用户管理多个独立投资组合(家庭账户 / 不同策略)。组合间净资产聚合汇总图。
多组合家庭账户
Supabase 迁移
从 SQLite 单机方案升级到 Supabase(PostgreSQL + Auth + Realtime + Storage)。backend/migrations/0001_init.sql 已备好 Postgres schema。
SupabasePostgreSQLRLS

技术栈

核心依赖与架构层次

前端
  • Next.js 15 App Router
  • React 19
  • TypeScript 5
  • Canvas / Chart.js
数据层
  • SQLite + WAL(schema v13)
  • better-sqlite3
  • prices.sqlite(行情)
  • gupiao.sqlite(用户)
算法核心
  • FIFO 对账
  • per-trade fxRate
  • debt 事件穿透
  • 工作日 gap-fill
AI Agent
  • Qwen-Flash(主力)
  • DeepSeek R1(fallback)
  • GPT-4o-mini / Claude Haiku
  • 合规后处理 + inputHash 幂等
行情数据
  • AKShare(A 股 + 港股)
  • EOD 收盘价
  • pm2 5×/天 cron
  • 12 个月历史
运维
  • pm2 cluster(4 worker)
  • Nginx 反代 + 限流
  • SQLite .backup 热备
  • autocannon 压测

现在开始记录你的实盘

导入交割单,马上看到属于你自己的净资产曲线

免费创建看板 →