Skip to content

docs(research): 新增量化与投资科学分组暨凯利公式投资数学文献,并收口指令源上移遗留死链 - #1121

Merged
ThreeFish-AI merged 3 commits into
feature/1.x.xfrom
ThreeFish-AI/kelly-formula-stock-betting
Sep 4, 2026
Merged

docs(research): 新增量化与投资科学分组暨凯利公式投资数学文献,并收口指令源上移遗留死链#1121
ThreeFish-AI merged 3 commits into
feature/1.x.xfrom
ThreeFish-AI/kelly-formula-stock-betting

Conversation

@ThreeFish-AI

Copy link
Copy Markdown
Owner

背景

调研仓库缺少「投资决策数学」这一独立主题。本 PR 新建 quant-finance/ 分组并落地首篇文献,同时顺带收口了前一次「Agent 指令源上移用户级配置」提交在全仓遗留的死链。

变更内容

一、新增调研文献与分组(41bd8854

  • 新增 docs/research/quant-finance/150-kelly-criterion-and-investment-math.md:以凯利公式 f* = (bp − q)/b 为起点,梳理七块在其假设下严格成立的投资数学基石——凯利仓位、统计功效、期望值与破产风险、波动拖累、复利年金、Markowitz 分散化、Sharpe 主动管理算术;配合 SPIVA、巴菲特十年赌局、Barber & Odean、上交所全账户研究等公开实证,推导中国市场 2026 时点的可执行操作路径与避坑清单。全文严格区分 A 类(数学恒等式,附成立假设)与 B 类(实证统计,附样本与时间范围),18 条 IEEE 引用。
  • 新增分组 _category_.jsonposition: 7「量化与投资科学」),同步 docs/research/readme.md 第七分组入口与 docs/.agents/knowledge-map.md 索引。

二、审查发现的 5 处缺陷修正(00075566

位置 问题 修正
§5 马丁格尔 算例数字少一位,把「有限资金撑不住翻倍序列」的论证削弱了一个数量级 10,240102,400 元(100 × 2¹⁰),补注累计已投入 102,300 元
§3 Step 1 节税额与同句刚立的净额口径不一致(给的是未扣领取端 3% 的毛额) 展开为 2,400 − 360 = 年净节税 2,040 元
§0 立论 与 §1.7 自述边界冲突——Sharpe 恒等式约束资金加权平均,并不排除个别人跑赢 条件收紧为「人人靠某公式跑赢市场」才违反恒等式
§1.4 「精确 7.82%」依赖未声明的口径切换(σ 与 s 混用) 补齐 σ/s 定义及 s² = ln(1+σ²/(1+A)²) 换算,精确值重算为 8.23%e^{−s²/2}exp(−s²/2),消除裸花括号在 react-markdown 下原样显示
§5 杠杆 ETF 以文字形式引用「FINRA 09-31」,致参考文献 [18] 成为唯一无正文锚点的条目 补 IEEE 编号引用

三、死链全量收口(55ab5ebb

四份协作协议文档(AGENTS.md / CLAUDE.md / browser-validation.md / reference-specifications.md)上移用户级配置后已从仓库移除,docs/ 下仍有 42 处相对链接指向不存在的文件,发布到 wiki 后全部为死链。按文档性质分三类处理:

  • 本仓自有文档(25 处 / 15 文件):改指用户级规范路径 ~/.claude/CLAUDE.md~/.agents/docs/browser-validation.md~/.agents/docs/reference-specifications.md,保留原句的锚点作用;
  • 历史 Issue 记录(13 处):仅去链接,原文表述与当时的仓内路径原样保留,不改写历史事实;
  • perceives 镜像(4 处):该目录描述的是上游仓库结构,同样仅去链接、不改指向,避免把本仓路径错误断言给上游。

验证

  • 数值独立复算(Python):凯利 f*/g(f)、样本量 271/617/1077(含精确二项功效 78.7% / 80.7%)、破产概率 13.4% / 1.8%、年金终值 462,041、组合波动 24.19%、QDII 溢价 −3.81%、马丁格尔 102,400、G = 8.23% —— 全部吻合;
  • 引用完整性:18 条参考文献编号双向闭合(无孤儿、无未定义);
  • 外链可达性:14 条外链全 200(SSRN / S&P 的 403 为 Cloudflare 反爬,浏览器可访问);
  • 死链:四份文档的仓库内死链 42 → 0git diff 未新增任何链接(只做减法);
  • 渲染安全:受改文件表格列数无回归;正文零裸花括号;wiki 走 react-markdown(非 MDX),不存在构建风险;
  • 导航拾取:实跑 build_docs_packquant-finance / 「量化与投资科学」/ 150-kelly-criterion 均已进入 nav_tree,其余文档导航正常构建。

影响面

纯文档变更,不触碰任何源码、配置或迁移,无运行时影响。与 origin/feature/1.x.x 无冲突(快进合并)。

已知遗留(本 PR 未处理)

仓库内另有约 619 处其他死链,大头为 docs/.agents/issue.md(186 处)、docs/reference/cognizes/engine/030-the-perception.md(53 处)、docs/reference/perceives/framework.md(42 处)——多数是 issue.mddocs/ 移入 docs/.agents/../apps/... 相对路径未跟进所致,属独立历史债,建议单独开轮收口。

🤖 Generated with Claude Code

- 新增 docs/research/quant-finance/150-kelly-criterion-and-investment-math.md:
  以凯利公式 f*=(bp−q)/b 为起点,梳理七块严格成立的投资数学定理
  (凯利仓位/统计功效/期望值与破产风险/波动拖累/复利年金/Markowitz
  分散化/Sharpe 主动管理算术),配合经多智能体交叉核验的实证数据
  (SPIVA/巴菲特十年赌局/Barber & Odean/上交所全账户研究),推导
  中国市场 2026 时点可执行操作路径与避坑清单;全文严格区分 A 类
  恒等式与 B 类实证统计,18 条 IEEE 引用;
- 新增分组 _category_.json(position 7「量化与投资科学」);
- 同步 docs/research/readme.md 新增第七分组阅读入口;
- 同步 docs/.agents/knowledge-map.md 研究文献索引,并顺带清理
  协同协议小节三条历史死链(PR #1120 前协议文档已上移用户级配置);
- 已验证 build_docs_pack 正确拾取新文档与分组标签。

🤖 Generated with [Claude Code](https://github.com/claude), [CodeX](https://openai.com), [Gemini](https://github.com/apps/gemini-code-assist)
Co-Authored-By: Aurelius Huang<threefish.ai@gmail.com>
代码审查发现 5 处问题,逐条修正:

- §5 马丁格尔算例数字少一位:100 元起注连输 10 次后下一注为
  100 × 2¹⁰ = 102,400 元(此前累计已投入 102,300 元),原值 10,240
  把「有限资金撑不住翻倍序列」的论证削弱了一个数量级,方向与结论相反;
- §3 Step 1 个人养老金节税额与同句口径不一致:前半句以「税前抵扣 −
  领取时 3% 单独计税」定义净收益,但 2,400 元为未扣领取端税负的毛额;
  改为展开净额推导 2,400 − 360 = 年净节税 2,040 元;
- §0 立论与 §1.7 自述边界冲突:Sharpe 恒等式约束的是全体主动资金的
  资金加权平均,并不排除个别人跑赢(§1.7 原文即如此),故「存在预测
  公式」本身不违反该恒等式;条件收紧为「人人靠某公式跑赢市场」;
- §1.4「精确 7.82%」依赖未声明的口径切换:补充 σ 为简单收益率标准差、
  s 为对数收益率标准差及 s² = ln(1+σ²/(1+A)²) 换算关系,精确值按 σ
  口径重算为 8.23%;同时将 e^{−s²/2} 改写为 exp(−s²/2),消除正文裸
  花括号在 react-markdown + rehype-katex 下原样显示的问题;
- §5 杠杆 ETF 行以文字形式引用「FINRA 09-31」,致参考文献 [18] 成为
  全篇唯一无正文锚点的条目,按 IEEE 格式补上编号引用。

验证:全部 18 条引用编号双向闭合(无孤儿、无未定义);表格列数一致;
正文无裸花括号;G = 8.23% 与 102,400 元经 Python 独立复算确认。

🤖 Generated with [Claude Code](https://github.com/claude), [CodeX](https://openai.com), [Gemini](https://github.com/apps/gemini-code-assist)
Co-Authored-By: Aurelius Huang<threefish.ai@gmail.com>
协作协议文档上移用户级配置后(AGENTS.md / CLAUDE.md /
browser-validation.md / reference-specifications.md 四份已从仓库移除),
docs/ 下仍有 42 处相对链接指向这些不存在的文件,发布到 wiki 后全部为死链。
前一次仅清理了 docs/.agents/knowledge-map.md 的 3 处,本次全量收口:

- 本仓自有文档(concepts / research / i18n / reference/wiki,共 25 处):
  改指用户级规范路径 `~/.claude/CLAUDE.md`、
  `~/.agents/docs/browser-validation.md`、
  `~/.agents/docs/reference-specifications.md`,保留原句语义与锚点作用;
- 历史 Issue 记录(docs/.agents/issue.md,13 处):仅去链接、原文表述
  与当时的仓内路径一并保留,不改写历史事实;
- perceives 镜像目录(4 处):该目录描述的是另一仓库的结构,同样仅去
  链接、不改指向,避免把本仓路径错误地断言给上游。

同步修正去链接后残留的两处中文排版空格。

验证:四份文档的仓库内死链归零(改前 42 处);diff 未新增任何链接;
19 个受改文件表格列数无回归;build_docs_pack 重跑,wiki 导航正常构建。

🤖 Generated with [Claude Code](https://github.com/claude), [CodeX](https://openai.com), [Gemini](https://github.com/apps/gemini-code-assist)
Co-Authored-By: Aurelius Huang<threefish.ai@gmail.com>
@ThreeFish-AI
ThreeFish-AI merged commit cf00993 into feature/1.x.x Sep 4, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant