docs(FEAT-DS-001): 记录采集器后置与本地数据源方案

2026-08-14 03:05:23 +08:00
parent a398bc418d
commit 551fe5e5e7
9 changed files with 223 additions and 0 deletions
@@ -0,0 +1,37 @@
+# TDX 数据接入 PoC PRD
+
+## 用户问题
+
+TDX 客户端运行在家中 Windows 虚拟机，并且接口只监听 Windows 本机 `127.0.0.1:17709`。公网平台和人在外面的开发设备都不能直接访问该端口，需要验证一套不暴露 TDX、可 7×24 小时运行的数据上报链路。
+
+## 目标
+
+在不提前引入公网部署和 Windows 常驻程序的前提下，先确定 TDX 数据源边界、标准化 Provider 契约和 Mac 本地联调方式。Windows 采集器、托盘 GUI、目标推送和公网接收入口延期，避免在生产部署形态尚未确定时锁定技术栈。
+
+## 范围
+
+- Mac 本地开发使用固定样本回放作为默认数据源，并保留通过 Tailscale SSH 隧道调用家中 Windows TDX 的人工联调方式。
+- 只定义与运行时无关的 `DataProvider`、标准化事件和数据新鲜度字段，不实现 Windows 常驻采集程序。
+- 记录未来公网模式的单次采集、多目标隔离推送、地址可变和目标启停原则，但不在本功能实现。
+- 只读验证指数、单股 K 线、快照、分时和板块接口中实际可用的字段。
+- 通过 Tailscale + SSH 隧道从外部 Mac 远程验证家中 Windows TDX；验证结果只用于 Provider 契约，不写入生产链路。
+
+## 非目标
+
+- 不在本功能中开发 Windows 采集应用、Electron/Tauri GUI、开发/生产接收 API、目标队列或公网推送。
+- 不在本功能中开发市场概览页面、AI 分析、正式 Worker 消费或生产接入。
+- 不开放 TDX `17709`、SSH 或 RDP 到公网。
+- 不写入自选、交易、账户或 TDX 状态。
+- 不把通达信数据授权问题解释为已解决；商业展示和再分发授权仍需单独确认。
+
+## 成功指标
+
+- 固定样本能够覆盖 Provider 的 K 线、快照、分时、板块和错误映射测试。
+- 通过 SSH 隧道完成至少一次真实 TDX 只读请求，并保存脱敏字段报告。
+- Provider 契约不依赖 Node、Electron、Python 或具体传输方式；未来采集器可独立替换。
+
+## 风险
+
+- TDX 客户端协议和返回字段可能变化；代理必须保留原始字段版本和来源标识。
+- 未来公网部署会增加采集节点、推送认证和再分发风险；延期期间不把这些风险误标为已解决。
+- 行情数据的展示、再分发和商业使用权利不由代码许可证自动授予。