docs(research): 新增量化与投资科学分组暨凯利公式投资数学文献,并收口指令源上移遗留死链 - #1121
Merged
ThreeFish-AI merged 3 commits intoSep 4, 2026
Conversation
- 新增 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>
4 tasks
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
背景
调研仓库缺少「投资决策数学」这一独立主题。本 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_.json(position: 7「量化与投资科学」),同步docs/research/readme.md第七分组入口与docs/.agents/knowledge-map.md索引。二、审查发现的 5 处缺陷修正(
00075566)10,240→102,400元(100 × 2¹⁰),补注累计已投入 102,300 元2,400 − 360 = 年净节税 2,040 元s² = ln(1+σ²/(1+A)²)换算,精确值重算为8.23%;e^{−s²/2}→exp(−s²/2),消除裸花括号在 react-markdown 下原样显示[18]成为唯一无正文锚点的条目三、死链全量收口(
55ab5ebb)四份协作协议文档(
AGENTS.md/CLAUDE.md/browser-validation.md/reference-specifications.md)上移用户级配置后已从仓库移除,docs/下仍有 42 处相对链接指向不存在的文件,发布到 wiki 后全部为死链。按文档性质分三类处理:~/.claude/CLAUDE.md、~/.agents/docs/browser-validation.md、~/.agents/docs/reference-specifications.md,保留原句的锚点作用;验证
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%—— 全部吻合;git diff未新增任何链接(只做减法);build_docs_pack,quant-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.md从docs/移入docs/.agents/后../apps/...相对路径未跟进所致,属独立历史债,建议单独开轮收口。🤖 Generated with Claude Code