Kickbacks CLI

Kickbacks CLI 全面指南：在终端实时掌控 Kickbacks.ai 收益

对于使用 Kickbacks.ai 的开发者和用户来说，实时监控收益和系统状态是提升效率的关键。Kickbacks CLI 作为一款功能强大的独立伴侣工具，允许用户直接在 macOS 终端内查看 Kickbacks.ai 的实时状态、实时收益以及广告历史记录。它秉持“本地优先、默认安全、无隐藏操作”的设计理念，为用户提供了一个透明且高效的管理界面。

什么是 Kickbacks CLI？

Kickbacks CLI 是一款专门为 macOS 用户打造的命令行界面工具。它不仅是 Kickbacks.ai 官方扩展的强力补充，更是一个独立的监控中心。通过 Kickbacks CLI，用户可以无需频繁打开浏览器或编辑器插件，即可获取最新的收益数据和广告投放历史。该工具由 Kickbacks.ai 驱动，但作为独立工具运行，确保了操作的灵活性和轻便性。

该工具支持 macOS 13 及更高版本，并经过 Apple 签名和公证，确保了软件的安全性。无论是偏好命令行的极客，还是喜欢点击操作的用户（通过菜单栏应用），Kickbacks CLI 都能完美适配。

Kickbacks CLI 的核心特性

Kickbacks CLI 提供了多项实用特性，旨在优化用户的使用体验并确保数据安全：

• 实时收益展示：直接查看今日收益及累计寿命收益，数据源自 Kickbacks.ai 后端。
• 本地优先架构：所有核心操作均在本地完成，确保响应速度和隐私安全。
• 广告历史记录：追踪广告轮播情况，并生成直观的每日收益图表。
• 菜单栏集成：通过 Kickbacks Bar，用户可以在 macOS 菜单栏一目了然地看到收益，并一键调用完整的 CLI 功能。
• 安全防护机制：默认关闭所有写入权限，仅在用户授权后开启特定功能。
• 无代码入侵：Kickbacks CLI 绝不读取您的源代码，不干扰提示词或补全内容。
• 透明的配置管理：所有设置均存储在 ~/.config/kickback/config.json 中，用户可随时手动修改。

如何安装与配置 Kickbacks CLI (How to Use)

安装 Kickbacks CLI 非常简单，您可以根据个人喜好选择菜单栏版本或纯命令行版本。

1. 安装菜单栏应用 (推荐)

如果您更倾向于直观的界面，可以使用 Homebrew 安装包含 CLI 的菜单栏应用：

brew install --cask gabeperez/kickback/kickbacks-bar

或者直接下载官方提供的 .zip 压缩包。初次启动时，如果您的 Mac 尚未安装 Python，它会提示您安装 Apple 的免费命令行工具（Command Line Tools）。

2. 纯命令行安装

对于终端重度用户，可以使用以下一行命令进行快速安装：

curl -fsSL https://gabeperez.github.io/kickback-cli/install.sh | bash

或者通过 Homebrew 安装：

brew install gabeperez/kickback/kickback

3. 初始设置

安装完成后，您需要将 Kickbacks CLI 与您的 Kickbacks.ai 账户关联：

• 运行 kickback setup 安装必要的扩展。
• 运行 kickback login 完成登录授权。

4. 常用命令与配置

• 查看状态：只需输入 kickback 即可查看当前收益和状态。
• 诊断工具：运行 kickback doctor 检查令牌格式、后端连接、钥匙串权限等是否正常。
• 修改配置：运行 kickback config 可以查看并切换各项功能的开关。

典型使用场景 (Use Case)

Kickbacks CLI 在以下场景中能发挥巨大作用：

• 实时监控：在编写代码的同时，通过侧边终端窗口或菜单栏实时关注 Kickbacks.ai 的收益波动。
• 收益审计：通过 sampler 功能记录广告轮播历史，分析不同时间段的收益情况。
• 多设备同步：通过 CLI 快速确认不同 macOS 设备上的 Kickbacks.ai 状态是否同步。
• 自动化通知：开启 notifications 功能，每日定时接收 macOS 推送的收益报告，无需手动查询。

安全性与隐私保护 (Safe by Default)

Kickbacks CLI 将安全放在首位，遵循以下严格的隐私原则：

数据读取范围：工具仅读取本地扩展文件、~/.claude/settings.json（用于确认状态线连接）、编辑器本地数据库（读取访问令牌）以及 macOS 钥匙串（解密令牌）。

网络传输规范：仅向 Kickbacks.ai 官方后端发送您的令牌和版本号。绝不向工具作者或任何第三方发送数据。

它绝不会执行的操作：

1. 不读取代码：您的提示词和补全内容是绝对私密的。
2. 不涉及资金变动：工具为只读模式，无法移动资金或点击广告。
3. 无身份绑定：所有账号信息均在运行时动态发现，不硬编码任何个人信息。
4. 无遥测数据：不包含分析脚本或任何形式的“打电话回家”行为。

常见问题解答 (FAQ)

Q: 为什么显示的单条广告收益是近似值？ A: Kickbacks.ai 后端仅公开聚合收益（总收益和今日收益），不提供 CPM 或具体的计费展示次数。因此，Kickbacks CLI 通过将收益变化归功于当前显示的广告来推算单条广告价值。这些数据代表您的分成，而非广告商的实际支出，并在工具中明确标注为近似值。

Q: 如果 Kickbacks.ai 官方扩展更新了，CLI 会崩溃吗？ A: Kickbacks CLI 具有优雅降级机制。如果官方扩展更改了令牌格式或后端端点，CLI 可能会显示“earned — unavailable”，但不会崩溃。您可以使用 kickback doctor 快速定位问题，或通过修改配置文件进行修复。

Q: 开启 token_refresh 功能安全吗？ A: token_refresh 默认是关闭的。开启后，它可以在编辑器关闭时刷新即将过期的令牌并写回。为了安全起见，它在写入前会自动保存备份。您可以根据需求通过 kickback config enable token_refresh 开启此功能。

Q: 如何离线使用？ A: 如果您希望完全离线查看本地状态，可以在配置中关闭 network 功能。此时 CLI 将不再联系后端，仅展示本地存储的缓存数据。

Kickbacks CLI 为 Kickbacks.ai 用户提供了一个透明、安全且高效的终端管理方案。无论您是为了追求极简的监控流程，还是需要更深入的收益分析，这款工具都是您的不二之选。