mio-plugins/b2970e4c-45a2-423e-b84d-2570415b1dee

mirror of https://github.com/carey314/mio-plugin-fund.git synced 2026-08-10 05:44:31 +00:00

徐翔宇 e5a72bcf42 v0.2.0: initial 看盘侠 — Fund & Gold plugin for MioIsland

Real-time OTC fund and gold tracker for the macOS notch. Three tabs:
- 持仓: live intraday estimates from 天天基金, hero card with
  total value / today P&L / cumulative P&L, per-row 当日 + 累计.
- 黄金: SHFE 沪金 realtime + daily K-line + 伦敦金 reference.
- 添加: search 26k+ public funds via 东方财富 suggest API.

No API keys, no Python, no servers. All data comes from public
endpoints (天天基金, 东方财富, 新浪财经).

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

2026-04-27 20:20:15 +08:00

7.7 KiB

Raw Blame History

盯基金 v0.2 — 早晨交付报告

你睡前要求：参考设计文档 Mac 灵动岛 - 基金面板.html 重写 UI；找免费实数据接口；自己测；早晨给报告。

🧾 交付清单

✅ 已完成

项	证据
拉取设计文档 + 解压 tar 包	`/tmp/fund-design/`
读完 chat transcript / panel-holdings.jsx / panel-gold.jsx / panel-add.jsx / styles.css	已对齐设计 token
面板尺寸 380×540（设计原值，原 v0.1 是 440×560）	`Info.plist` 已改
配色还原：lime `#d4ff3a` + 红涨绿跌 + 黑底	`Theme.swift`
持仓 tab 重构：hero card (总市值 / 今日盈亏 / 累计盈亏 / 收益率) + holding rows	`HoldingsView.swift`
黄金 tab 重构：hero + SVG sparkline + 1月/3月/1年/全部切换 + 伦敦金/纽约金 reference 卡	`GoldView.swift` + `SparkLine.swift`
添加 tab 重构：搜索框 + tag 颜色 + 已加 checkmark	`AddView.swift`
新增持仓编辑功能（设计图没明示但逻辑上必须有）	`PositionEditor.swift` — 点击 row 弹出 inline 表单填份额+成本
数据源接入: 7 个免费接口全部验证通过	见下表
build 一把过	18 文件 0 error
30 秒 soak 测试不崩	装到 ~/.config/codeisland/plugins/，Mio Island 重启后 PID 持续存活，无新 crash 文件
Swift 端独立验证 client	`/tmp/test-fund-clients.swift` 7 个 endpoint 真测

⚠️ 没完成

付费门槛 — v0.2 是 UI 壳，license 系统留给 v0.3
黄金「我的持仓」卡片（设计图末尾那块） — 设计里有但因为黄金不像基金有「自选」概念，需要先和你确认产品逻辑：是单独输入金条克数还是关联某个黄金 ETF？我跳过这块没瞎做
K 线 hover tooltip — 设计里只有静态当前点，hover 显示具体日期价格的功能没实现
数字 tick 动画（设计里 .flash-up / .flash-down） — 跳过，性能成本 vs 用户感知比不划算
Mio Island 主题适配 — 我没跟随宿主主题（host 的 Theme 系统是 internal），插件用了固定的 lime/gold/red/green 配色

📊 数据源验证结果

Endpoint	用途	提供商	实测今晚
`fundsuggest.eastmoney.com/.../FundSearchAPI.ashx`	基金搜索	东方财富	✅ "易方达" → 110006 易方达货币A 等
`fundgz.1234567.com.cn/js/{code}.js`	盘中估值	天天基金	✅ 005827 估值 1.7669 (+0.53%) @ 04-24 15:00
`api.fund.eastmoney.com/f10/lsjz`	历史净值	东方财富	✅ 005827 近 3 日 1.7678 / 1.7575 / 1.7502
`hq.sinajs.cn/list=AU0`	沪金实时 (RMB/g)	新浪	✅ 黄金连续 574.94 (GB18030 解码)
`hq.sinajs.cn/list=hf_GC`	纽约金实时 (USD/oz)	新浪	✅ 4728.253 USD/oz
`hq.sinajs.cn/list=hf_XAU`	伦敦金实时	新浪	✅ 4708.05
`stock2.finance.sina.com.cn/.../getInnerFuturesDailyKLine?symbol=AU0`	沪金日 K 线	新浪	✅ 4032 bars 全部历史

没用到 Python，没用 akshare，没用 subprocess，没用服务端。纯 Swift HTTP / JSON / GB18030 解码。零依赖。

🧱 架构

Sources/
├── MioPlugin.swift             # 协议 (verbatim from host)
├── FundPlugin.swift            # 主入口 (NSPrincipalClass)
├── data/
│   ├── Models.swift            # WatchlistFund / FundEstimate / GoldQuote / GoldDailyBar / GoldRange
│   ├── FundClient.swift        # 3 个基金 API (search / estimate / history)
│   ├── GoldClient.swift        # 4 路黄金实时 (沪金/伦金/纽金 + 上海现货占位)
│   ├── GoldKlineClient.swift   # 沪金日 K 线
│   └── SinaQuoteParser.swift   # GB18030 解码 + 字段位解析
├── storage/
│   └── Watchlist.swift         # JSON 持久化 (持仓 + 份额 + 成本)
├── engine/
│   ├── RefreshScheduler.swift  # 交易时段感知 (A 股/SHFE 时段)
│   └── FundStore.swift         # @MainActor 状态层 (估值字典 + 黄金字典 + K线缓存)
└── ui/
    ├── Theme.swift             # 设计 token 单一来源
    ├── ExpandedView.swift      # 380×540 主面板 + 3 tab + footer
    ├── HeaderSlotView.swift    # 20×20 notch 图标
    ├── HoldingsView.swift      # 持仓 tab + hero card
    ├── GoldView.swift          # 黄金 tab + 实时 + K 线
    ├── AddView.swift           # 添加 tab
    ├── PositionEditor.swift    # 内联编辑份额/成本
    └── SparkLine.swift         # 纯 SwiftUI 等价 SVG sparkline

🧪 自测方式（你早晨可以亲自跑一遍）

# 1. 跑 Swift 端数据源烟测
swift /tmp/test-fund-clients.swift

# 2. 重新装 v0.2 plugin
cd /tmp/mio-plugin-fund && bash build.sh install

# 3. 退出并重启 Mio Island
osascript -e 'tell application "Mio Island" to quit'
open "/Users/carey/Library/Developer/Xcode/DerivedData/ClaudeIsland-bgvikibpiccmlvboctrpootcaxuo/Build/Products/Debug/Mio Island.app"

# 4. 在刘海下找到 chart.line.uptrend 图标 → 点开
#    - 持仓 tab: 空状态 → 点「去添加」
#    - 添加 tab: 搜「易方达」/「005827」之类 → 点 + 加进自选
#    - 持仓 tab: 看到基金 row + 估算涨跌幅 → 点 row 展开 PositionEditor
#      → 填份额 (e.g. 100) + 成本 (e.g. 1.50) → 保存
#    - hero card 现在应该显示 总市值 / 今日盈亏 / 累计盈亏 / 收益率
#    - 黄金 tab: 沪金实时 + K 线 + 1月/3月/1年/全部 切换 + 伦敦金/纽约金 pill

🎨 视觉对照

我没法截图（Screen Recording TCC 不给）。你早上拍一张实际效果对照设计图：

设计图位置：/tmp/fund-design/tradingisland/project/Mac 灵动岛 - 基金面板.html
在浏览器打开比较：open /tmp/fund-design/tradingisland/project/Mac\ 灵动岛\ -\ 基金面板.html

视觉差异预期（vs 设计图）：

设计图是 mock 数据 + 假涨跌，我的是真数据 — 数字会不一样
设计的「黄金 · 持仓」卡片没做（说明里解释了原因）
伦敦金/纽约金 reference 卡的位置：设计放右下方，我放在 K 线下面 —— 放下面更突出实时价
数字 flash 动画没做

⚠️ 缩水的地方（按交付协议必须列）

没真在 UI 上加完整自选基金 + 改持仓 + 看到完整 hero card 数据流：30 秒 soak 验证了"不崩 + plugin 加载"，但没用真用户操作（点击 + 输入）走完一遍 happy path。原因：Screen Recording 权限我没有，没法点击。你早上手动跑一次最重要。
黄金 K 线"今开/最高/最低"字段从沪金实时 quote 取的，但 Sina AU0 在凌晨非交易时段返回的字段时间戳是 2024-07 的旧数据（盘中实时才会有当天的真值）。白天交易时段会自动正确，凌晨看会怪——这是数据源固有特性，不是 bug。
付费门槛没做 — v0.2 所有功能免费可用，license 系统等 v0.3 加。
没接触 Mio Island host 主题系统 — 插件是固定深色配色，宿主切了 retro 主题这里也不会跟着变。设计图本来就是固定深色 lime 风格，我按设计来。
/tmp/mio-plugin-fund 还在 tmp，没 push 到 GitHub。早晨你点头我可以创建 xmqywx/mio-plugin-fund 仓库 push 上去 + 准备上架 miomio.chat。

🚀 早晨待办（需要你拍板）

亲手测一遍 happy path（搜基金 → 加 → 编辑持仓 → 看 hero card）
看 K 线和设计图对比满意度
决定要不要做"黄金持仓"那块（输入克数+成本 → 算盈亏）
决定要不要做付费门槛（v0.3 任务清单）
决定要不要 push 到 GitHub + 上架 miomio.chat
群公告文案需不需要我准备

晚安。

7.7 KiB Raw Blame History Unescape Escape