stock-analysis v5.0.0 — 先证据，后叙事

stock-analysis v5.0.0

从投资问题到可行动的研究报告：先验证证据，再形成观点。

本次发布

• 7 类研究场景 × Quick / Standard / Deep，共 21 份确定性报告契约；
• 内置公开网络补证、来源与时点校验、确定性指标派生；
• 15 种专家投资框架，以及单框架、并列、对抗与投委会研究；
• 个股、基金、大盘、财报、异动与组合的投资者可读报告；
• 中英文 README、架构图、流程图和 72 秒产品介绍视频；
• 真实业务验收 21/21 通过，最低 85 分；650 项测试与 Ruff 全部通过。

详见仓库中的 docs/release-acceptance-v5.0.0.md。
stock_analysis-5.0.0.tar.gz

stock-analysis-demo-en-v5.0.0.mp4

stock-analysis-demo-zh-CN-v5.0.0.mp4

v4.17.0 — Deterministic Agent Command Protocol

What changed

v4.17.0 makes the Agent integration a stable, deterministic public protocol while keeping the investor research engine evidence-first.

• Eight formal commands: /market, /snapshot, /analyze, /earnings, /move, /screen, /portfolio, and /thesis.
• One production boundary: HostRequest → ResolvedRequest → Workflow.
• Host Agents structure requests; the Python Router consumes structured objects only and makes deterministic decisions.
• --input remains available only for debugging and test fixtures.
• Generated Codex Skills + Prompts, Claude commands, and generic Skills come from one canonical catalog with drift checks.
• Safe stock-analysis-agent install, dry-run, doctor, guarded uninstall, and a unified manifest.
• Thesis history, portfolio/move routing, schemas, run manifests, and a 280-case bilingual/adversarial route matrix.
• Reframed English and Simplified Chinese READMEs for investors, including introduction videos and updated animated architecture diagrams.

Release scope

This release stops at P1 and stays focused on the command protocol, multi-host compatibility, and deterministic routing. The original four P2 items—dedicated Hermes adapters, host-side Web/PDF enrichment, opt-in anonymous telemetry (off by default), and route optimization from real failure data—move together to the Future Roadmap.

Verification

• 8 canonical commands and 80 generated managed entrypoints are in sync.
• Full pytest suite passed (612 tests).
• Ruff passed.
• Both architecture diagrams passed showcase geometry/composition at score 100 and their GIF motion contract at 115 unique frames.

Research only; not investment advice and not an automatic trading system.

stock-analysis v4.16.0

stock-analysis v4.16.0

本版本把公司与基金深度研究从“缺什么就反复说明什么”升级为“只发布当前证据能够支持的命题”，同时全面更新中英文项目主页、架构动画、流程图和双语演示视频。

可支持命题发布层

• 公司和基金 --market research 默认使用确定性命题发布层。
• 命题只使用五个离散状态：strongly_supported、supported、unsupported、speculative、conflicted_unresolved。
• 普通证据缺口只过滤命题或缩窄适用范围，不再自动转化为看空、中性、谨慎或观望信号。
• 价格、总市值或流动性缺失只阻断相关估值或执行行动；身份、口径完整性、一手证据冲突、前视偏差或完全没有可发布命题时阻断报告。
• 保留公司和基金既有八段式报告，不自动生成仓位，也不输出无条件买卖指令。

可审计研究产物

Research Workspace 新增并固定保留：

• evidence_manifest.json
• claim_ledger.json
• coverage_report.json
• unpublished_claims.json

这些文件与原有冻结证据和阶段产物同时存在，用于追踪证据、已发布命题、覆盖范围及未发布命题。

全新项目主页与演示

• 全面重写中英文 README 的产品定位、用户路径、安装、Agent 使用、CLI、数据源和能力边界。
• 新增可复现的双语架构 GIF、完整 Mermaid 系统架构及命题发布流程图。
• 更新双语视频封面与 72 秒、1080p Remotion 演示视频。
• 架构动画附带语义输入、SVG、布局验证和动效契约报告。

兼容性

• 日报、stock-review、earnings、price-move、快照和持仓报告继续保留原有正文缺口说明契约。
• 15 个投资 Lens 配置保持不变。
• 支持 Python 3.9 及以上版本。

发布附件

• Python wheel
• Python source distribution
• 英文 72 秒演示视频
• 简体中文 72 秒演示视频

完整变更见仓库中的 CHANGELOG.md。

stock-analysis v4.15.0

中文

• 新增免费免登录的日股/韩股接入、XTKS/XKRX 交易日历与跨市场时段语义。
• 美股接入 SEC Company Facts filing-date 财务；港股与日韩保留条件性财务边界，并新增发行人/交易所/监管原文证据回填。
• 修复盘前与集合竞价、涨跌家数、成交量、北向资金等可用性状态，避免把尚未产生或不可验证的数据写成事实。
• 补强基金运营状态、规模变化、组合相关性、逐日汇率归因、本币 ADV/波动率和全球交易成本边界。
• 更新双语 README、可审计架构图、社交预览及 72 秒中英文演示视频。

English

• Added free, login-free Japan/Korea market routes, XTKS/XKRX calendars, and cross-market session semantics.
• Added SEC Company Facts financials with filing-date cutoffs, conditional HK/JP/KR financial boundaries, and issuer/exchange/regulator primary-evidence reach.
• Corrected pre-market/call-auction availability, breadth, volume, and northbound-flow semantics so unavailable evidence remains explicit.
• Expanded fund operating evidence, AUM changes, portfolio correlations, daily FX attribution, local-currency ADV/volatility, and global execution-cost boundaries.
• Updated both READMEs, the auditable architecture, social preview, and bilingual 72-second demo videos.

完整变更 / Full changes: CHANGELOG.md

stock-analysis v4.14.0

中文

• 拆分研究入口编排，并让公司/基金研究共用可恢复工作区能力，降低耦合与流程漂移。
• 区分数据源异常和正常缺失，保留失败类型，避免把连接故障误解为“没有数据”。
• 改进中英文自然语言问题匹配，让投委会更贴近投资者真正关心的护城河、现金流、风险与交易成本。
• 中英文 README 新增面向非技术投资者的酷炫架构动画。

English

• Separated research command orchestration and shared recoverable workspace primitives across company and fund workflows.
• Distinguished source failures from valid-but-unavailable data while preserving failure types.
• Improved bilingual, plain-language investor-question matching for dynamic committee selection.
• Added investor-friendly animated architecture overviews to both English and Chinese READMEs.

完整变更 / Full changes: CHANGELOG.md

stock-analysis v4.13.0

v4.13.0

本次版本把 Company 估值从单向敏感性分析升级为“正向搭模型 + 逆向验市值”的双向预期系统。

主要更新

• 新增前提审计与同口径证据仲裁，错误、歧义或尚未验证的用户输入不会被升级为公司事实。
• C6 自动用当前总市值和明确估值倍数反推市场隐含净利润；通过 --expectations-file 可进一步建立产品线收入、利润和 SOTP 正向模型。
• 新增正向利润与市场隐含利润的 expectation-gap 对账，并把市值剩余价值翻译为期权业务需要实现的收入与净利润。
• 新增防重复计价：内部配套产品只能归入一个分部；SOTP 超配产生的负剩余价值保持为负，不静默归零。
• C8 新增指标、基准、下次检查日期和观点变化条件，让研究从解释当期延伸到下一次观点验证。
• Company Evidence schema 升级至 1.2；中英文 README、Mermaid 架构图与 72 秒双语视频同步更新。

验证

• 218 个 Python tests 通过
• Ruff 检查通过
• 双语 Remotion composition 检查通过（1920×1080、30 fps、72 秒）
• wheel 与 sdist 均由 v4.13.0 提交的干净副本构建

完整变更请参阅 CHANGELOG.md。

stock-analysis v4.12.0

v4.12.0

本次版本将个股与基金研究升级为可恢复的机构化 Research Workspace，同时保留原有投委会式深度分析。

主要更新

• 新增问题驱动的动态 6 人投委会，让净利率、经营现金转化、治理、资本配置、结构化估值等证据进入每位委员的投资框架。
• Company 研究接入发行人一手披露，并强化财务历史、估值敏感性、治理与股东回报分析。
• Fund 研究接入 CSI 官方完整指数样本、权重、估值与指数日线，重算收益、回撤、波动、beta、tracking error 和主动收益。
• 股票、ETF 与组合共用完整交易成本情景，覆盖价差、佣金、经手/过户费、印花税、成交额参与率、波动冲击、ETF 费率与折溢价。
• 中英文 README、How the system works、安装/提示词场景与 72 秒双语视频全面更新。
• 新增 600519 个股与 512480 ETF 的机构化深度报告示例。
• 项目已通过合并的 PR #232 收录到 0xNyk/awesome-hermes-agent。

验证

• 211 个 Python tests 通过
• Ruff 检查通过
• 双语 Remotion composition 检查通过
• wheel 与 sdist 均由 v4.12.0 tag 的干净副本构建

完整变更请参阅 CHANGELOG.md。

stock-analysis v4.5.0

Agent-native research workflows

• Adds 11 canonical scenario workflows generated for Codex Skills, Codex prompts, and Claude Code commands.
• Adds the C1-C8 Company Evidence Pack, deterministic stock review, earnings review, price-move, and thesis create/review CLI workflows.
• Adds exact Decimal calculators, a metric registry, JSON schemas, and user-first README architecture and installation guides.

Verification

• Full pytest suite and Ruff passed.
• Built sdist and wheel successfully.
• Real-data validation completed for 600519 company review, price-move, thesis lifecycle, and 2026-07-10 market recap.

stock-analysis v4.4.2

Validated ETF evidence release.

• Split-normalized listed ETF premium/discount series from Tencent daily closes and paginated official NAV.
• Disclosed benchmark and annual tracking-error metadata with explicit non-recomputed label.
• Strict northbound, fund-profile, price-volume, and board-taxonomy evidence validation.

v4.3.11

Summary

• Added A-share microstructure evidence via Sina best bid/ask snapshots, including spread bps, five-level depth, volume, and turnover.
• Added _meta.stock_microstructure and _meta.stock_trading_costs to Evidence Pack for A-share holdings.
• Split Simons readiness into microstructure_costs, crowding_proxy, and slippage_sensitivity, keeping crowding and slippage conditional where full data is unavailable.
• Added stock snapshot output for A-share bid/ask spread and trading-cost limitations.
• Bumped CLI release metadata to 4.3.11 and stock-analysis skill metadata to 4.5.3.

Validation

• PYTHONPATH=/tmp/stock-analysis-release-4311/src /Users/yjw/agent/stock-analysis-v42/.venv/bin/python -m pytest → 149 passed
• PYTHONPATH=/tmp/stock-analysis-release-4311/src /Users/yjw/agent/stock-analysis-v42/.venv/bin/python -m ruff check src tests → All checks passed
• git diff --check → clean
• Real CLI probe: stock_analysis --market stock --symbol 600519 --date 20260709 returned Sina bid/ask spread 0.01 / 0.0846 bps