FinDataHub
b777f4e241
## 待办清单 - L2 标记完成，并记录「为什么不在脚本里写 try/except 双路径，而是给 paths.py 补函数」 - T5 标题更新为「842 → 800 行，第 1–2 步已完成」，补第 2 步完整记录 （含 SyncSession 的取舍、证伪结果、以及第 3 步为何仍不做） - 新增 T8：生产入口生成随机 API_KEY 导致受保护端点恒 401， 含根因对照表、修复、部署位实测、防回退锁 ## DEVLOG 追加本轮三段记录。其中两个坑值得单独留档： 1. `pgrep -f "FinDataHub.app/Contents/MacOS"` 会匹配到 Bash 工具自身命令行 → kill 自己（exit 143），链式命令中断。部署片段已全部改为 `pgrep -x FinDataHub`。 这是本项目第二次踩同类问题（第一次是 pkill -f）。 2. Swift 编译报 `failed to produce diagnostic for expression` 时，错误位置会退化到 文件**最后一行**，真正原因藏在中间的 #Preview 固件里。 ## MEMORY.md 同步三处约束：API_KEY 必须走共享加载函数（第二处双入口分叉）、 paths.service_dir 用于服务资源定位、SyncSession 已是状态唯一来源 + `replaceSession` 的用途与其编译陷阱。 ## VERSION 1.6.0 → 1.6.1（patch）：本轮为内部重构 + 缺陷修复，无新增用户可见功能。
FinDataHub 文档中心
更新于 2026-08-09 | P1-P4 全部完成 | P5 远期规划
目录结构
Docs/
├── README.md ← 你在这里
├── pipeline/ # 🟣 数据管道架构设计
├── macos/ # 🍎 macOS App 设计
└── tracking/ # 📋 项目管理追踪
🟣 pipeline/ — 数据管道架构设计
| 文件 | 类型 | 说明 |
|---|---|---|
findatahub-data-pipeline.html |
设计手册 | 核心架构 + 架构规范：三层 Medallion、7 步 Pipeline、4 级门控、依赖铁律、组件契约、代码质量标准 |
rate_limit_pull_plan.md |
方案文档 | 限流方案：6 接口分析 + 新浪/东财降级 + 北交所重拉 |
EXECUTION_PLAN.md |
已归档 | 重构执行方案（2026-07 阶段，已执行完毕） |
🍎 macos/ — macOS App 设计
| 文件 | 类型 | 说明 |
|---|---|---|
DESIGN.md |
设计规范 | Apple HIG 设计 Token + Liquid Glass 改造方案（附录） |
DEVLOG.md |
开发日志 | SwiftUI App 每日开发记录 |
📋 tracking/ — 项目管理追踪
| 文件 | 类型 | 说明 |
|---|---|---|
TODO.md |
待办 + 完成记录 | 13 项任务 + P1-P4 完成明细 + 架构重构项 |
进度总览
| 阶段 | 内容 | 状态 |
|---|---|---|
| P1 | 采集层：双源交叉验证 + AKShare 修复 + 北交所重拉 | ✅ |
| P2 | 预处理层：7 步 Pipeline + 4 级门控 + 策略画像 | ✅ |
| P3 | 使用层：SDK 11 方法 + API 14 端点 | ✅ |
| P4 | AI 接入：Skills + MCP 7 工具 | ✅ |
| P5 | 云端扩展：阿里云同步 / Redis 缓存 / 数据血缘 | 📅 未来 |