v0.4.0 —— PositionGuard 持仓保护 + 策略原型库 + 防过拟合 + 公开刷新

承接 v0.3.0(D-12 因子库闭环),本版补齐 D-12 的风控与策略生成能力,并完成一轮公开刷新。仍是模拟盘阶段,不接真金。

🛡️ 风控

• 框架级 PositionGuard:−20% 硬止损贯通 backtest / paper / live,回测一视同仁;风控豁免三重签名(SELL · guard 标签 · guard- 前缀)防仿冒(ADR-0052)
• 保护性出场透出 API 响应 + agent 工具;回测/live 一致性回归

🧬 策略生成

• 策略原型库 4 骨架(趋势/均值回归/波动/多因子)+ GET /archetypes(ADR-0051)
• agent 写策略链路升级:因子实测前置 + 质量门 + 不达标自动 pivot 重写
• 单次回测 Bootstrap Sharpe 95% CI 防过拟合(ADR-0027)

🔬 研究 / 语言

• agent 输出与过程旁白严格随用户最近一条消息的语言;research 按提问语言兜底 + 最终报告语言强化(CR #92 四轮,含 language 参数 prompt 注入加固)

🌐 公开刷新

• 官网落地页同步 D-12 已落地功能(因子库深度 / Position Guard / 原型库+质量门 / agent skills)+ footer 朱印 logo 水印
• README 重写至 D-12 定位,改用控制台截图
• 默认 LLM 升级 anthropic 4.8 / zhipu glm-5.2

🔧 加固 / 修复

• 多轮 CR 收口(#88 / #89 / #91 / #93 / #94):PositionGuard pending-exit 去重与死锁修复、trailing 仅持仓盈利后激活、SharpeCI 异常不拖垮主回测等
• dashboard 总览布局 + 风控事件列修复

---

🤖 release notes drafted with Claude Code

v0.3.0 —— D-12 因子库闭环 + agent skills + 审批审计落库

继 v0.2.0（D-10/D-11）后的版本，覆盖 D-12 因子库闭环 及当期支撑性收口，共 256 个提交。站点 rev 同步至 0.12-D12。

D-12 · 因子库闭环（ADR-0043 / 0044 / 0047）

• 因子血缘：author_strategy 接 factorContext，血缘随策略落库；live runner 衰减巡检告警（只告警不动仓）
• 衰减三态 decay_state 下沉服务端单一权威，dashboard 衰减徽章改读服务端
• monthly FRED 宏观因子 8 个（发布滞后对齐），因子库扩至 70；macro 计算单因子隔离，一条配错不再整批静默消失
• null IC 选择效应基准透出——「选出来的因子比随机好多少」可量化
• 因子发现 L1 三连：自定义因子表达式 DSL + /custom/score 一站式评估（P1）→ factor_candidates 候选池 + 人工审核 register 门（P2）→ factor_discovery workflow + factor.run_discovery（P3，BH 校正用真实批大小）

Agent skills + 研究工具（ADR-0046）

• 产品内 skill 加载机制 + skill.read 按需读取；audit matcher 纳入 skill.*，触发率可观测
• vendor serenity 投研方法论（市场无关化 + freshness 适配）+ equity-research 子集（earnings-analysis / thesis-tracker）
• web.fetch 正文抓取 + symbols.search 公司名→代码解析接入 orchestrator，证据纪律升级

审批审计 + 上下文工程

• ask 审批审计历史落 Postgres + 重启 sweep；活动流接终态，决策重启后可回看
• 上下文 token 双层防线（tool 输出上限 + TokenLimiter 兜底）、equity_curve 降采样、历史预算 250k→500k
• workingMemory 常驻小抄（ADR-0049 第 1 层试点）；pending-plan-check 接生产

操作者控制台

• 回测 run 详情页；模拟盘详情持仓 + 决策时间线并排；活动流接模拟盘生命周期事件 + 行内迷你指标 chip；长列表分页
• 内嵌对话栏：AG-UI + CopilotKit → mastra，工具输出结构化渲染
• 总览改「执行/研究」分排

基础设施 / 安全 / 网站

• 单机生产部署：docker compose + Python/Mastra 镜像，容器非 root、Redis 认证、镜像版本钉死、healthcheck 链路
• 本地数据自动备份 + 落盘路径 CI 红线（ADR-0048）
• 安全修复：web_fetch 逐跳跟随重定向封堵 SSRF、skill 路径穿越改 relative() 判定、审批历史凭据/PII 脱敏落库
• 官网：神社×审计链改版、hero 审批阈线 + 品牌朱印、移动端适配（审批管道纵排 / Coverage 纵向流）、巨型序号统一、容器加宽至 96rem、CTA GitHub 数字修复（构建配 token 根治限流）

下一步：research-hub（#6）、E2 策略演化（#7）。

🤖 Generated with Claude Code

v0.2.0 —— D-10 多市场研究 + D-11 模拟盘 / 控制台 / 因子库

继 v0.1.0（首发）后的大版本，覆盖 D-9 收尾 → D-10 多市场 → D-11 模拟盘 共 130 个提交。

D-11 · 模拟盘 / 操作者控制台 / 因子库

• 接现成因子库（#52）：新增 services/factor（:8004），封装 pandas-ta / WorldQuant Alpha101 / qlib Alpha158 三源 + 前瞻收益分位 + 时序 Rank IC 有效性打分；factor.timing / score / catalog tool；research analyst 引用经验证的有效因子做择时
• 策略多样性：strategy_hint 扩 breakout / volatility 两族 + donchian_breakout / atr_channel 内置策略；candidate 结构指纹去重
• 操作者控制台 dashboard（#52/#56）：只读运行时看板（6 看板 + 双主题），BFF Route Handler 聚合后端、JWT 不出 server
• paper live runner（#34/#50 等）：promoted 候选按行情自动跑 + 决策复盘 + 跨重启 resume + 单笔 notional 上限 + 账户级风控熔断 + TTL 兜底
• 跨币种 cash model（#32）：账户多币种桶 + FX 折算 equity

D-10 · 多市场数据 + 研究链路

• web 搜索 + 财报基本面端点（多市场数据源扩展）
• 投资大师 persona 库 + deep_dive 韧性 + 网关超时
• analyst 接入 web / 基本面，orchestrator 多市场编排
• MarketHoursRule 接 exchange_calendars 全市场真生效

基础设施 / 网站 / CI

• 官网 landing page 大改 + SEO/GEO（JSON-LD schema）+ 架构图重设计
• Claude Code CR 非阻塞 + sticky 评论防邮件洪水
• 统一 .env + 多 LLM provider

做空（margin/perp 模式）规划见 issue #51。

🤖 Generated with Claude Code

v0.1.0 — Inalpha 首个 release

Inalpha v0.1.0 — 首个 release

从空仓库走到「user → orchestrator agent → 三 Python 内核 → 真实数据 → 回测 / 研究 / 模拟盘闭环」的端到端 MVP。

架构（三层）

• 前端：Next.js + CopilotKit（外部，未入本仓）
• 编排层：Mastra (TypeScript) — orchestrator agent + hooks / permissions / plan-exec / Swarm
• 内核层：三个独立 Python service — data / paper / research

核心能力

编排（packages/orchestration）

• Mastra runtime + orchestrator agent（单 agent + 全 tool，D-8a' 简化拓扑）
• ADR-0010 hooks 中间件 + Stop hook 3 handler + StopHookRunner
• ADR-0011 permissions 中间件 + PII 脱敏 + assertScopedRequest 多用户隔离
• ADR-0012 plan-exec 工具
• ADR-0025 Swarm S1 并行回测 + idempotency + date-inject 护栏
• scheduler 模块（定时任务）
• @mastra/observability 全链路追踪 + LibSQLStore traces 持久化

数据（services/data）

• FastAPI + CCXT
• D-9 多 venue：crypto（Binance）+ 美股 + A 股 + 港股 + 日韩澳印巴英德等单股 + 全球指数 + FRED 宏观
• /bars 读写、/backfill/bars 补数、/ticker 服务端最新价

回测内核（services/paper）

• 内存撮合 + 执行链 + 引擎
• 策略：SMA cross / BuyAndHold / 布林带 MeanReversion
• D-7+ 报表指标增强
• D-8a 单笔下单 /orders/submit（ref_price optional，服务端自取）
• D-8b/D-8c 持久化 + 用户级回溯 + research→策略→回测闭环

研究（services/research）

• Multi-analyst LLM debate
• D-9 金融时效性硬约束（fresh data 默认 + as_of 锚定 + 真新闻引用）

工程

• bash scripts/dev.sh：一键起 data:8001 + paper:8002 + mastra:4111，端口预检 + verify_ready + status
• bash scripts/check-consistency.sh：跨文件一致性检验（CI 红线之一）
• 完整 CI：pnpm typecheck + vitest + ruff + consistency
• 安全审计：B/C 级 review 高/中风险已修（Portfolio round-trip PnL、execute_plan 顺序、http/hooks/permissions 6 个安全问题、JWT 白名单 / leeway 等）

协议

GNU AGPL-3.0（从 PolyForm Noncommercial 升级）

下一阶段

• D-9 收尾：RiskEngine 规则化 + paper 真接入；strategy_authoring 闭环
• E1（ADR-0020）：LLM 真实改策略