mirror of
https://github.com/carey314/mio-plugin-fund.git
synced 2026-08-10 05:44:31 +00:00
Mirror of carey314/mio-plugin-fund for plugin review
e5a72bcf42
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> |
||
|---|---|---|
| Sources | ||
| .gitignore | ||
| build.sh | ||
| HANDOFF.md | ||
| Info.plist | ||
| LICENSE | ||
| README.md | ||
看盘侠 — 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.