看盘侠 — Fund & Gold Tracker for MioIsland

Real-time OTC fund and gold tracker for the macOS notch. Built as a native .bundle plugin for MioIsland.

Features

持仓 (Holdings)

• Live intraday fund estimates (~1 min granularity from 天天基金).
• Hero card with 总市值 / 今日盈亏 / 累计盈亏 / 收益率 — only computed for funds where you've filled in shares + cost basis.
• Per-fund row with name, code, latest NAV, day rate %, day ¥ P&L.
• Click any row to inline-edit shares + cost basis (or clear).

黄金 (Gold)

• Realtime SHFE 沪金 quote (RMB/g) as the primary chart.
• Daily K-line with 1月 / 3月 / 1年 / 全部 range tabs.
• Reference cards for 伦敦金 (XAU/USD) and 纽约金 (COMEX GC) with realtime price + day change.
• Historical chart back to 2008.

添加 (Add)

• Search 26,000+ public funds by code, name, or pinyin (东方财富 suggest API).
• Category-coded chips (ETF / 指数 / 股票 / 混合 / 债券 / QDII / etc).
• Already-added state with checkmark.

Data sources (no API keys, no Python, no servers)

Endpoint	Provider	Format
fundsuggest.eastmoney.com/.../FundSearchAPI.ashx	东方财富	JSON
fundgz.1234567.com.cn/js/{code}.js	天天基金	JSONP
api.fund.eastmoney.com/f10/lsjz	东方财富	JSON
hq.sinajs.cn/list={symbol}	新浪财经	CSV (GB18030)
stock2.finance.sina.com.cn/.../IndexService.getInnerFuturesDailyKLine	新浪财经	JSON array

All endpoints are 10+ years old, used by every Chinese fintech app. No auth.

Install

From source

git clone <this repo>
cd mio-plugin-fund
./build.sh install
# Restart Mio Island (Cmd+Q + reopen)

From marketplace

(After release: install via miomio.chat plugin store.)

Development

./build.sh           # produce build/fund.bundle + build/fund.zip
./build.sh install   # build + copy to ~/.config/codeisland/plugins/

Project structure

Sources/
├── MioPlugin.swift             # protocol (verbatim from host)
├── FundPlugin.swift            # principal class
├── data/
│   ├── Models.swift            # WatchlistFund, FundEstimate, GoldQuote, …
│   ├── FundClient.swift        # search + estimate + history
│   ├── GoldClient.swift        # 4 realtime gold sources
│   ├── GoldKlineClient.swift   # daily K-line history
│   └── SinaQuoteParser.swift   # GB18030 → GoldQuote parser
├── storage/
│   └── Watchlist.swift         # persisted JSON watchlist + positions
├── engine/
│   ├── RefreshScheduler.swift  # trade-hour-aware refresh cadence
│   └── FundStore.swift         # @MainActor state surface
└── ui/
    ├── Theme.swift             # design tokens (lime / gold / red-up / green-down)
    ├── ExpandedView.swift      # 380×540 panel, 3-tab strip + footer
    ├── HeaderSlotView.swift    # 20×20 notch icon
    ├── HoldingsView.swift      # 持仓 tab
    ├── GoldView.swift          # 黄金 tab
    ├── AddView.swift           # 添加 tab
    ├── PositionEditor.swift    # inline shares + cost form
    └── SparkLine.swift         # SVG-equivalent line chart

Refresh cadence

Tier	When	Interval
Funds intraday	09:30-11:30, 13:00-15:00 (CST, Mon-Fri)	60s
Funds idle	Otherwise	30 min
Gold	24/7	30s
Gold K-line history	On launch + manual refresh	—

Pricing (planned)

Tier	Content
Free	3 funds, daily NAV only, no gold, no AI
Pro (¥49 once / ¥99 yearly)	Unlimited watchlist, intraday estimates, gold panel, AI 解盘

Not enforced yet — v0.2 is the UI shell. Paid gating goes in v0.3.

License

MIT — see LICENSE.