# cat

**Repository Path**: frankliugang/cat

## Basic Information

- **Project Name**: cat
- **Description**: 111111111111111
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-02-10
- **Last Updated**: 2026-03-10

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# cat

这是一个 macOS 的托盘（Status Bar）小程序：
- 通过全局快捷键在两个窗口（PowerOne / Teams）之间切换显示/隐藏
- 托盘提供退出与隐藏/显示程序坞图标
- Dock 图标按星期显示不同字形，并在不同模式显示不同底部线条效果

## 安装

### 1) 准备环境
- macOS
- Python 3（建议 3.9+）

### 2) 安装依赖
在项目根目录执行：
```bash
python3 -m venv .venv
source .venv/bin/activate
python -m pip install -U pip
python -m pip install -r requirements.txt
```
#### 安装教程
## 运行（开发模式）
1.  xxxx
```bash
source .venv/bin/activate
python3 test_mac.py
```
#### 使用说明
### 权限说明（macOS 必须）
由于程序会监听全局键盘/鼠标事件，需要在：
系统设置 -> 隐私与安全性 -> 辅助功能
把“运行该程序的 Terminal / IDE / 打包后的 App”加入并启用。
1.  xxxx
## 打包（macOS）
#### 参与贡献
项目内置了 macOS 打包脚本 `build_mac.sh`（使用 PyInstaller 生成 `.app`）：
1.  Fork 本仓库
```bash
bash build_mac.sh
```

打包产物在：
`dist/PowerOne.app`
#### 特技
### 运行打包后的 App
```bash
open dist/PowerOne.app
```
1.  使用 Readme\_XXX.md 来支持不同的语言，例如 Readme\_en.md, Readme\_zh.md
如果第一次打开无响应/快捷键不生效，优先检查“辅助功能”权限。

## 隐藏程序坞图标（后台运行）
有两种方式：
- 运行后从托盘菜单点击“隐藏程序坞图标”
- 启动时设置环境变量：
```bash
HIDE_DOCK_ICON=1 python3 test_mac.py
```