Skip to content

docs: 定位与同类项目对比 + 消费端复权指南#37

Merged
xbfighting merged 2 commits into
masterfrom
docs-issue-36-positioning
Jul 7, 2026
Merged

docs: 定位与同类项目对比 + 消费端复权指南#37
xbfighting merged 2 commits into
masterfrom
docs-issue-36-positioning

Conversation

@xbfighting

Copy link
Copy Markdown
Owner

Summary

README 集中说清 tdx2db 的差异化定位(附同类项目事实性对比表);AGENTS.md 给需要复权的消费端官方指引。对标调研的批次 B。

Related Issue

Closes #36

What Changed

  • README「定位与同类项目」:四条差异化要点 + 对比表(easy_tdx / tdx-api / rustdx / mootdx+pytdx,仅陈述数据来源/产出形态/维护状态,注明为 2026-07 快照)
  • AGENTS.md「需要复权时」:涨跌幅复权 factor 法三步 + rustdx 参考链接 + 口径差异提醒;数据契约一节同步加交叉引用

Why This Approach

  • 对比表中性事实化(不评优劣,只讲分工),并给出"什么场景选谁"的一句话
  • 复权指南只进 AGENTS.md 不碰代码:守住"不复权"数据契约,同时不让消费端自己踩 rustdx 已踩过的口径坑

How to Test

纯文档。检查对比表链接可点、表述与各项目 README 自述一致。

Risks / Tradeoffs

  • 对比表含维护状态快照,随时间可能过时——已标注快照日期

🤖 Generated with Claude Code

xbfighting and others added 2 commits July 7, 2026 15:51
- README 新增"定位与同类项目":差异化四要点(增量幂等自愈/status
  可观测/无幸存者偏差/agent 契约)+ 五个同类项目事实性对比表
- AGENTS.md 新增消费端复权指南:涨跌幅复权 factor 法(引 rustdx
  实现与原理文章),注明与券商口径的已知差异;数据契约不变
- 来源:2026-07-07 对标调研(easy_tdx/tdx-api/rustdx/mootdx)

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@xbfighting
xbfighting merged commit cd64147 into master Jul 7, 2026
5 checks passed
@xbfighting
xbfighting deleted the docs-issue-36-positioning branch July 7, 2026 07:59
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.

README 差异化定位 + 同类项目对比 + 消费端复权指南

1 participant