https://github.com/sherlockgougou/vixmenubar

👻100% AI Coding：轻量、开源的 macOS 菜单栏应用，用于显示 VIX（恐慌指数）最新数值（数据来源：Yahoo Finance）。
https://github.com/sherlockgougou/vixmenubar

ai macos swiftui vix

Last synced: 8 months ago
JSON representation

👻100% AI Coding：轻量、开源的 macOS 菜单栏应用，用于显示 VIX（恐慌指数）最新数值（数据来源：Yahoo Finance）。

• Host: GitHub
• URL: https://github.com/sherlockgougou/vixmenubar
• Owner: SherlockGougou
• Created: 2025-10-30T06:37:14.000Z (8 months ago)
• Default Branch: main
• Last Pushed: 2025-10-30T08:29:15.000Z (8 months ago)
• Last Synced: 2025-10-30T08:43:15.280Z (8 months ago)
• Topics: ai, macos, swiftui, vix
• Language: Swift
• Homepage:
• Size: 548 KB
• Stars: 4
• Watchers: 0
• Forks: 1
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

          


# VIXMenuBar

轻量、开源的 macOS 菜单栏应用，用于显示 VIX（恐慌指数）最新数值（数据来源：Yahoo Finance）。

[![platform](https://img.shields.io/badge/platform-macOS-000000?logo=apple&logoColor=white)](#)

[![swift](https://img.shields.io/badge/Swift-5.7%2B-FA7343?logo=swift&logoColor=white)](#)

[![xcode](https://img.shields.io/badge/Xcode-14%2B-1575F9?logo=xcode&logoColor=white)](#)

[![ui](https://img.shields.io/badge/SwiftUI-%2B%20AppKit-43a047)](#)

[![license](https://img.shields.io/badge/License-MIT-44CC11)](#license)



> 在菜单栏展示最新 VIX 数值；点击图标可打开弹出面板查看详情（最新值、更新时间、手动刷新与退出）。

## 介绍与特性

- 菜单栏图标 + 实时数值显示

- 弹出面板展示最新数值与更新时间，支持手动刷新

- 自动周期拉取（默认 60 秒）

提示：本项目仅读取 Yahoo Finance 公开接口，不收集或上传任何用户隐私数据。

## 效果预览

![预览占位图](docs/image1.png)

## 环境要求

- macOS 12+（建议更高版本）

- Xcode 14+（Swift 5.7+）

## 安装与使用（普通用户）

将来发布到 GitHub Releases 后，普通用户可直接下载 `.dmg` 或 `.zip`。在此之前，你可以通过“从源码构建”自行使用。

首次启动后：

- 菜单栏会出现图标与数值。

- 默认每 60 秒自动刷新；也可在弹出面板中手动刷新。

登录时启动（Launch at Login）

- 从 macOS 13 起，应用通过系统提供的 ServiceManagement API 将自身添加到“系统设置 → 通用 → 登录项”。

- 第一次开启时，系统可能需要你的批准；若需要，会自动跳转到“登录项”页面，请在列表中允许该应用。

- 之后系统会在你登录 macOS 时自动启动本应用。

关于来自“未知开发者”的提示：

- 如果是未签名应用，macOS 可能会阻止启动；可在“系统设置 → 隐私与安全 → 仍要打开”放行，或使用 Finder 中“右键 → 打开”。

- 推荐后续使用开发者 ID 进行签名与公证，详见下文“打包与分发”。

## 从源码构建（开发者）

1) 打开项目

- 双击 `VIXMenuBar.xcodeproj` 或在 Xcode 中手动打开。

2) 选择运行目标

- Target：`VIXMenuBar`，运行目标为你的 My Mac。

3) 运行

- 点击 Run（⌘R）。首次运行会立即拉取一次数据并显示在菜单栏。

### 打包与分发（可选）

1. 签名与沙盒（App Sandbox）

   - 若在沙盒环境发布，需在 Signing & Capabilities 中启用 `App Sandbox`，并勾选 `Outgoing Connections (Client)`（`com.apple.security.network.client`）。

   - 使用 `SMAppService.mainApp` 无需额外的登录项辅助程序；建议使用开发者 ID 对应用进行签名以获得最佳用户体验。

2. 代码签名与公证（推荐）

   - 使用 Developer ID 对应用签名与公证（notarize），避免 Gatekeeper 阻止用户启动。

   - 参考 Apple 文档完成公证流程；签名示例命令请根据你的证书调整（可在 README 历史版本中查看样例）。

### 刷新间隔

- 默认 60 秒。若需修改，可在代码中调整对应常量（后续可加入 UI 配置）。

## 隐私与数据来源

- 仅访问 Yahoo Finance 公开接口（https://query1.finance.yahoo.com）获取行情数据；不采集、不上传任何本地用户数据。

- 若你扩展或更换数据源，请遵守相应服务的使用条款并在文档或应用内告知用户。

## 贡献与开发

欢迎 Issue / PR！

## 许可证

本项目采用 MIT 许可证发布。你可以自由地使用、修改和分发本软件。若将来在仓库中添加 `LICENSE` 文件，GitHub 将自动识别许可协议。

---