聚合多个券商账户的净资产与持仓详情，通过 macOS 菜单栏单一面板查看，并原生支持股息、交易与存入的即时通知，省去逐一登录各平台的繁琐操作。https://github.com/chang-07/sylvester…

chang-07/sylvester

来源：https://github.com/chang-07/sylvester

Sylvester 是一款 macOS 菜单栏应用，可展示您在 SnapTrade (https://snaptrade.com) 中关联的所有券商账户的净资产与分账户明细——包括持仓、资产配置、净资产趋势以及活动动态，并原生支持新股息、交易与存入的通知。它是一个纯本地客户端：令牌存储在 macOS 钥匙串中，数据直接从 SnapTrade API 获取。

安装

Homebrew（推荐）：

brew install --cask chang-07/tap/sylvester  

或从发布页（https://github.com/chang-07/sylvester/releases/latest）下载 .dmg 文件，将 Sylvester 拖入 应用程序 文件夹。
Sylvester 使用临时签名（未公证），首次运行需解除下载隔离：

xattr -dr com.apple.quarantine /Applications/Sylvester.app  

（或使用 HOMEBREW_CASK_OPTS="--no-quarantine" brew install --cask chang-07/tap/sylvester 跳过此步骤）。启动后，图标将出现在菜单栏中。需 macOS 14+（Apple Silicon）。
也可从源码构建：./install.sh。

设置

点击菜单栏图标，选择 使用 SnapTrade 登录——浏览器将打开以登录您的 SnapTrade 账户并授权读取权限。无需手动粘贴内容；令牌将存储在 macOS 钥匙串 中。
随后 连接账户 会打开 SnapTrade 门户以关联您的券商账户。
若您使用合作伙伴 API 密钥，可在向导中展开 高级 选项，粘贴 clientId + consumerKey（HMAC 流程）代替。

配置

非敏感设置位于 ~/.config/sylvester/config.json（权限设为 600）：

• baseCurrency — 净资产显示货币（默认 USD）
• refreshMinutes — 自动刷新频率（默认 15 分钟）
• fxRates — 手动设置 {货币: 每单位基准货币} 的汇率备选值，例如 {"CAD": 0.73}；实时汇率来自 frankfurter.dev
• apiBaseURL — API 主机覆盖（默认生产环境；可设置为指向预发布环境）

备注

• 只读权限。 个人登录使用 SnapTrade 的 OAuth2 令牌流程（PKCE，read 权限）；合作伙伴密钥采用规范 JSON 的 HMAC-SHA256 签名。两者均无法执行交易或转移资金。登出时将清除钥匙串并请求 SnapTrade 撤销令牌。
• 无 Sylvester 服务器。 官方构建版本内置预注册的公共 OAuth 客户端，因此即使是登录令牌交换也直接与 SnapTrade 通信（PKCE，无需客户端密钥）。broker/ 目录包含一个可选的无状态令牌交换代理，仅在您基于自身保密 OAuth 客户端从源码构建时需要——官方构建不使用它。
• 余额数据来自 SnapTrade 的缓存读取（不强制刷新券商数据），因此更新频率取决于券商同步节奏（通常为每日）。超过 36 小时的数据会在行内标记提醒。
• 通知功能需使用 .app 安装包（直接运行 swift run 无法发送通知）。
• 登录启动 选项位于 ⋯ 菜单中。macOS 可能需要您在 系统设置 → 登录项 中批准 Sylvester 后，该功能才能生效。

开发

./make-app.sh && open dist/Sylvester.app # 构建并运行应用包  
./install.sh # 构建并安装到 /Applications  
./release.sh # 构建可分发的 .dmg 文件