Repository navigation
Releases: suoha888/suoha-serenity-skill
Release list
v9.1.0 — 估值必须填净债务、数据警告不能删掉了事
这一版堵上了两个“报告不该通过却通过了”的漏洞（感谢社区开发者的反馈）。
1. 估值用 EV/Sales 时必须填净债务
以前没填净债务会默认按 0 计算，报告照样通过校验；对现金很多或负债很重的公司，估值会明显偏差。现在只要有情景用 EV/Sales、而当前数据缺少净债务，校验直接不通过。
2. 数据快照里的警告必须逐条说明处理方式
取数时发现的问题（例如财报来自备用来源、外国发行人、过期数据被剔除）会预填进报告草稿。以前把这些条目删掉也能通过；现在完成报告时会对照原始快照，缺了哪条就报出哪条。旧报告找不到原始快照时，跳过这项检查。
另外
- 新增对应测试（共 262 个测试全部通过）。
更新方法：重新运行安装命令即可，已有的 work/ 报告和缓存会保留。
方法来源：Serenity（X：@aleabitoreddit），独立 AI/半导体供应链研究员，推荐关注。本项目只根据其公开内容做中文转述与框架提炼，不包含任何订阅内容。
免责声明：本项目用于研究与学习，报告由框架生成，不代表 Serenity 本人观点，亦非投资建议。
v9.0.2 — 分阶段体检、公开言论档案、Serenity 自己承认看错的案例
v9.0.2：README 加入方法来源 Serenity（@aleabitoreddit）的介绍和 X 主页链接，功能没有变化。
v9.0.1：公开言论档案更准——只是在板块名单里被顺带列出的公司，不再算作表态，也不会混进它的论点和 KPI。下面是 v9 的全部更新。
v9：先像框架那样看公司，再独立找反例
- 分阶段体检：先判断公司处在哪个阶段（认证/放量期、周期高利润期、亏损不增长、常规经营）。放量期不再拿当期亏损、ROE 一票否决，改看订单、认证、产能、现金跑道和融资方式；资产负债表和流动性风险在任何阶段都不豁免。新增现金跑道（R1）、按阶段打分的 P/S（V1）、“每股收入增长快于稀释”的例外。
- 数据不足不再显示为“干净”：能打分的项目少于 3 项时明确提示“数据不足”。
- 公开言论档案：
python suoha.py timeline <代码>查看 Serenity 对某只股票公开说过什么、立场什么时候变过、盯哪些 KPI；--as-of 日期只看当时已公开的内容。直接相关的约 2,400 条、覆盖 329 个代码（只是在名单里被顺带列出的不算表态），全部是中文转述 + 公开帖编号，不含原文和订阅内容。 - 21 条规则例外（references/serenity-exceptions.md）和 22 条 Serenity 自己承认看错或时机偏早的案例（案例库新增一节，新增归因代码
F-TIMING、F-FACT），每条写清对应的规则或体检项。 - 报告新增可选三块：阶段 KPI、稀释分类、财务需核实清单；研究包自动预填。旧报告不受影响。
- 合规检查加严：提交前自动检查公开文件与原文没有 8 词（中文 8 字）连续重合，并拦截任何订阅帖编号；新增“回测不偷看未来”测试。
回看对比（132 只 Serenity 公开表态过的股票；这是规则自检，不是收益回测）：
| 指标 | v8.2.2 | v9.0.0 |
|---|---|---|
| 跑不出结果（含数据不足） | 17.4% | 9.1% |
| 看多股 ≥ 2 红旗或跑不出 | 43.3% | 30.9% |
| 看空股 0 红旗（漏判） | 29.0% | 26.7% |
机械体检仍会漏掉一部分看空理由（多数是估值、竞争或叙事层面），这部分要靠红队。详见 docs/CHANGELOG.md。
更新方法：在项目文件夹里 git pull（或重新下载 ZIP），然后再运行一次 ./install.sh（Windows：.\install.ps1）。
方法来源：Serenity（@aleabitoreddit），独立 AI/半导体供应链研究员，在 X 上免费分享研究，推荐关注。
本项目是研究框架，不构成投资建议；内容是对 Serenity 公开帖子的转述，不是 Serenity 本人的话。
Contributors
Assets 2
v9.0.1 — 分阶段体检、公开言论档案、他自己承认错了的案例
v9.0.1：公开言论档案更准——只是在板块名单里被顺带列出的公司，不再算作表态，也不会混进它的论点和 KPI。下面是 v9 的全部更新。
v9：先像框架那样看公司，再独立找反例
- 分阶段体检：先判断公司处在哪个阶段（认证/放量期、周期高利润期、亏损不增长、常规经营）。放量期不再拿当期亏损、ROE 一票否决，改看订单、认证、产能、现金跑道和融资方式；资产负债表和流动性风险在任何阶段都不豁免。新增现金跑道（R1）、按阶段打分的 P/S（V1）、“每股收入增长快于稀释”的例外。
- 数据不足不再显示为“干净”：能打分的项目少于 3 项时明确提示“数据不足”。
- 公开言论档案：
python suoha.py timeline <代码>查看他对某只股票公开说过什么、立场什么时候变过、盯哪些 KPI；--as-of 日期只看当时已公开的内容。直接相关的约 2,400 条、覆盖 329 个代码（只是在名单里被顺带列出的不算表态），全部是中文转述 + 公开帖编号，不含原文和订阅内容。 - 21 条规则例外（references/serenity-exceptions.md）和 22 条他自己承认错了/早了的案例（案例库新增一节，新增归因代码
F-TIMING、F-FACT），每条写清对应的规则或体检项。 - 报告新增可选三块：阶段 KPI、稀释分类、财务需核实清单；研究包自动预填。旧报告不受影响。
- 合规检查加严：提交前自动检查公开文件与原文没有 8 词（中文 8 字）连续重合，并拦截任何订阅帖编号；新增“回测不偷看未来”测试。
回看对比（132 只他公开表态过的股票；这是规则自检，不是收益回测）：
| 指标 | v8.2.2 | v9.0.0 |
|---|---|---|
| 跑不出结果（含数据不足） | 17.4% | 9.1% |
| 看多股 ≥ 2 红旗或跑不出 | 43.3% | 30.9% |
| 看空股 0 红旗（漏判） | 29.0% | 26.7% |
机械体检仍会漏掉一部分看空理由（多数是估值、竞争或叙事层面），这部分要靠红队。详见 docs/CHANGELOG.md。
更新方法：在项目文件夹里 git pull（或重新下载 ZIP），然后再运行一次 ./install.sh（Windows：.\install.ps1）。
本项目是研究框架，不构成投资建议；内容是对 Serenity 公开帖子的转述，不是他本人的话。
v9.0.0 — 分阶段体检、公开言论档案、他自己承认错了的案例
v9.0.0：先像框架那样看公司，再独立找反例
- 分阶段体检：先判断公司处在哪个阶段（认证/放量期、周期高利润期、亏损不增长、常规经营）。放量期不再拿当期亏损、ROE 一票否决，改看订单、认证、产能、现金跑道和融资方式；资产负债表和流动性风险在任何阶段都不豁免。新增现金跑道（R1）、按阶段打分的 P/S（V1）、“每股收入增长快于稀释”的例外。
- 数据不足不再显示为“干净”：能打分的项目少于 3 项时明确提示“数据不足”。
- 公开言论档案：
python suoha.py timeline <代码>查看他对某只股票公开说过什么、立场什么时候变过、盯哪些 KPI；--as-of 日期只看当时已公开的内容。覆盖 474 个代码、约 3,600 条，全部是中文转述 + 公开帖编号，不含原文和订阅内容。 - 21 条规则例外（references/serenity-exceptions.md）和 22 条他自己承认错了/早了的案例（案例库新增一节，新增归因代码
F-TIMING、F-FACT），每条写清对应的规则或体检项。 - 报告新增可选三块：阶段 KPI、稀释分类、财务需核实清单；研究包自动预填。旧报告不受影响。
- 合规检查加严：提交前自动检查公开文件与原文没有 8 词（中文 8 字）连续重合，并拦截任何订阅帖编号；新增“回测不偷看未来”测试。
回看对比（132 只他公开表态过的股票；这是规则自检，不是收益回测）：
| 指标 | v8.2.2 | v9.0.0 |
|---|---|---|
| 跑不出结果（含数据不足） | 17.4% | 9.1% |
| 看多股 ≥ 2 红旗或跑不出 | 43.3% | 30.9% |
| 看空股 0 红旗（漏判） | 29.0% | 26.7% |
机械体检仍会漏掉一部分看空理由（多数是估值、竞争或叙事层面），这部分要靠红队。详见 docs/CHANGELOG.md。
更新方法：在项目文件夹里 git pull（或重新下载 ZIP），然后再运行一次 ./install.sh（Windows：.\install.ps1）。
本项目是研究框架，不构成投资建议；内容是对 Serenity 公开帖子的转述，不是他本人的话。
v8.2.2 — 更新重装不再失败，保留你的报告
修复：更新重装失败
- 装好后用过一次（会产生行情缓存和
work/里的研究报告），再运行安装脚本更新时会失败。现在可以随时重装或更新，work/里的报告和行情缓存会自动保留；旧版本仍会完整备份到.runtime-backups/。 - 如果你手动改过安装目录里的技能文件，更新时会停下并用中文提示先改名备份，不会覆盖你的改动。
- 自动检查新增“安装 → 运行 → 再安装一次”的 Windows / macOS / Linux 实测。
更新方法：在下载的项目文件夹里 git pull（或重新下载 ZIP），然后再运行一次 ./install.sh（Windows：.\install.ps1）。
v8.2.1
- 修复：用 GitHub 的 “Download ZIP” 下载后，解压出的文件夹叫
suoha-serenity-skill-main，安装脚本会因为文件夹名不一致而失败，而且什么都不提示。现在任何文件夹名都能装；安装出错时会直接显示原因。 - 首页和手册加入“没装 Git 怎么装”和“非官方项目，与 Serenity 本人没有隶属或背书关系”的说明；安全问题改为通过 GitHub 私密漏洞报告提交。
- 自动检查新增 Windows / macOS / Linux × Python 3.10 / 3.13 的真实安装测试。
v8.2.0
根据外部评审意见做的一轮“防看错”改进：
- 结论和证据类型要对得上：判定“真瓶颈”、瓶颈正在发生、或“卡点中的卡点”已确立，必须有财报/公司公告/电话会/行业数据支持，光有股价不行；判定“便宜且去风险”必须同时有行情数据和基本面来源。校验器会直接报错。这只是类型检查，引用的那句原文是否真能证明结论，仍要靠红队复核。
- 证据日期改为“信息公开的日期”：SEC 财报数字按提交日期记，不再按季度期末日期记（期末日另存为
period_end），回测时不会用到当时还没公布的数字。 - 净负债：现金或负债有一项查不到时不再当成 0，而是留空并给出警告，要求从资产负债表补上。
- A+H 公司市值：改为 A 股数 × A 股价 + H 股数 × H 股价，不再用总股本 × 单边股价。以比亚迪为例（2026-10-20），按 H 股价算的旧市值低估约 16%，按 A 股价算的高估约 11%；修复后两边市盈率一致。
- 修复：港股行情把“本条上市线的股数”当成了总股本，导致比亚迪、小米等出现错误的“股本差异”警告。
- 结果回看：最高/最低价和复权收盘价统一到同一口径；原来的“最大回撤”实际是“相对入场价的最深跌幅”，现在两个都给，并新增真正的峰谷回撤。案例库表格已按新口径重算（例如 AXTI 60 日内最高 +386%，但峰谷回撤仍有 −37%）。
- 失败归因：新增 6 类失败原因代码（需求判断错、瓶颈不存在、认证/订单未兑现、没变现到报表、已提前定价、融资稀释）和 2 类非失败代码（环境压缩、未到验证期），结果回看表中的不及预期案例已标注暂定归因。
- 卡点地图：每个节点显示状态最后核验日期，超过 180 天提示必须重新核验；研究时要求用实时数据主动质疑图谱状态。
- 首页文案更新。
- 计划中：固定截止日期的真实盲测集（成功、失败、假瓶颈、证据冲突、数据不足各类案例），用来检验方法本身。
v8.1.0
- 知识库扩到 7,153 条公开推文（2025-07 至 2026-10，含回复），原来是 1,505 条。
- 理论全书新增第 18 章“论点兑现与失效”（PB-EXIT-01 至 14）：什么情况算论点失效、降级、需要重新立论或已经兑现，哪些只是噪音。报告里每条证伪条件可以标上对应编号。
- 卡点地图新增两条链：AI 算力租赁（电力托管 → 服务器 CPU → 整机 → GPU 云 → 超大厂资本开支）和太空（发射 / 卫星网络）；光子链加入 Scale-up 互连（ALAB、CRDO）和 JBL，存储链加入 ESMT。现在共 10 条链、46 个节点。
- 案例库新增新云、服务器 CPU、互连、JBL、ESMT、太空等案例，并加入“后来怎样了”结果回看：用
forward_returns.py按发帖后下一交易日收盘计算，成功和失败都列出。 - AXTI 示例接入新档案：Serenity 7 月仍看多，10 月回看认为论点基本兑现。
- 修复：私人档案里含 U+2028 字符的推文会被错误断行；公开清单只统计公开推文；言论时间线摘要里的持仓状态显示成占位符。
- 修复（NBIS 实测发现）：改过注册地或换过报告币种的公司（如前 Yandex 的 NBIS：2023 年前是卢布、之后是美元），SEC 数据会取到旧币种的旧数字，把 2023 年的卢布现金当成今天的美元现金。现在每个科目取最新的币种，停更超过约 400 天或币种不一致的科目会被丢弃并写进数据质量警告。
- 修复：资产负债表期末和收入期末相差超过 100 天时，应收/存货增速对比（W1/W2）只作参考，不再亮红旗。
- 修复：6-K 很多的外国公司，20-F 年报会被挤出文件列表，导致“一手文件摘录”为空。
- 修复：
research生成的 lens 草稿产业链图只有 1–2 层，finish一定会因为“至少 3 层、至少 1 个上游层”失败；现在按图谱自动排出下游 → 本公司 → 上游，缺的层留 TODO。finish校验失败时直接显示 ERROR 行，不再只提示“操作未完成”。
v8.0.1
v8.0.0
首个正式公开版本。
- 学理论：Serenity 卡脖子理论全书、方法手册和历史案例库，每条规则只附帖子编号。
- 研究个股：A 股、港股、美股任意一只股票，自动抓取 SEC、巨潮、披露易等官方数据，先给结论再给证据。
- 公司体检：按公司类型逐项检查成长、盈利、现金、负债、股东和估值，标出财务红旗，每项附公式。
- 一键安装：支持 Claude Code、Codex 等客户端，不需要 API Key。
安装：
git clone https://github.com/suoha888/suoha-serenity-skill.git && cd suoha-serenity-skill && ./install.sh本工具仅供研究，不构成投资建议。