OctoPunk 完全指南：AI 原生的 GitHub 桌面客户端，告别浏览器标签页
如果你每天花大量时间在 GitHub 上管理 Issue、审查 PR、回复讨论，你一定经历过这种场景：Chrome 里开了十几个 GitHub 标签页，通知小图标永远在闪但你早就学会了无视它，想快速找到三天前看过的一个 PR 却要在一堆标签页里翻来翻去。GitHub 的网页体验在 2010 年也许够用，但在 2026 年，开发者值得更好的工具。
OctoPunk 就是为此而生的一款 GitHub 桌面客户端——为 macOS、Windows 和 Linux 打造，把你会从编辑器里爱上的体验（模糊搜索、命令面板、键盘快捷键、主题系统）全部带到了 GitHub 上，还内置了一个 AI 助手。
核心痛点：GitHub 的浏览器体验到底哪里不好？
在深入 OctoPunk 之前，先梳理一下 GitHub 网页端真正让人头疼的几个点：
- 通知系统是消防水管：你收到所有事件，但没有好的方式来筛选真正需要关注的通知。团队级 Review Request 和个人级混在一起，很难区分。
- 首页是社交媒体信息流：打开 github.com 首先看到的是 Star、Follow、Fork 的动态，而不是你需要处理的 PR 和 Issue。
- 代码审查体验有限：一个 PR 超过 200 行差异，在浏览器里逐行看就很吃力了。没有 LSP 支持——你不能悬停看类型，不能跳转到定义。
- 标签页地狱：打开 15 个 Issue/PR 就是 15 个标签页，浏览器占用的内存和找标签的时间一起增长。
OctoPunk 的创始团队（ldelossa，之前开发了 gh.nvim 和 nvim-ide）太熟悉这些痛点了——他们决定用一个原生桌面应用来解决这些问题。
Dashboard：你说了算的工作台
OctoPunk 打开后不是社交信息流，而是一个可自定义的 Dashboard。这个 Dashboard 由多个 Widget 组成，每个 Widget 可以自由拖拽排列成 2×2 或 1×2 布局。
Search Widget（搜索部件）是最核心的组件——你写一个 GitHub 搜索查询（和 GitHub 搜索语法完全一致），比如 is:pr is:open review-requested:me，Widget 就会实时显示匹配的最新结果。你可以创建多个 Search Widget，每个命名一个颜色标签，放在 Dashboard 上——等于你为自己构建了一个定制的「工作监控面板」。
Feed Widget（信息流部件）保留了 GitHub 的社交功能，如果你还想看谁的 Star 了你的仓库，可以放在角落里不干扰主要工作区。
Activity Graph（活动图）在自定义时间范围内显示你在 GitHub 上的活动量。
Card Deck（卡片栏）是 Dashboard 左侧的列表区，包含通知收件箱、最近查看的页面等。每个卡片都支持搜索过滤。
通知系统：从消防水管到精准投递
OctoPunk 对通知系统做了彻底的重构。它的核心思路是用过滤器（Filter）替代原始的消防水管。
你创建一个 Filter 的时候需要给它三个东西：一个搜索查询（query）、一个名字（name）、一个颜色（color）。比如创建一个叫「我的 Review」的 Filter，查询为 review-requested:me，颜色设为红色。然后点击铃铛图标订阅这个 Filter——所有匹配的通知就会出现在 Dashboard 的收件箱里，每条通知带上一个颜色标签让你一眼就能看出属于哪类。
OctoPunk 还额外增加了几个网页版没有的通知过滤查询：
review-requested-direct:me：只匹配直接指派给你的 Review Request，排除团队级指派review-requested-team:team-name：只匹配特定团队的 Review Request
有了这些过滤能力，你终于可以把通知红色小圆点从一个「让人焦虑的噪声源」变成一个「精确的任务列表」。
AI 助手：自带 API Key，按需使用
OctoPunk 内置了一个 AI 助手，但它的设计理念和市面上大多数「AI First」产品不一样——它不搞自动化循环、不搞 Agent 背景执行，而是在你需要的时候精确地给出帮助。
使用方法很直接：打开 AI 助手（默认快捷键），在页面上点击某个对象（一个评论、一个 PR、一个文件）——AI 助手会自动感知你选中了什么，把选中内容作为上下文。你可以问「这个 PR 到底改了啥」「帮我草拟回复」「总结这个对话」。
支持的 AI 提供商包括 Anthropic、Gemini 和 OpenAI。你必须自带 API Key，这意味着你的对话数据只在你信任的提供商那里，OctoPunk 不会用你的对话训练模型。
AI 助手配备了几种工具：代码审查（理解 PR diff 并给出分析）、评论草拟（根据上下文生成回复）、代码获取（为了更好分析而 clone 代码）等。
而且它不会额外收费——API Key 是你自己的，OctoPunk 只是提供了一个更自然的对话界面。
代码智能：在代码审查中拥有 LSP
这是 OctoPunk 最让我惊喜的功能。在 GitHub 网页端审查代码时，你看到的就是纯文本差异——不能在函数名上悬停看类型签名，不能点击跳转到定义，不能搜索符号。
OctoPunk 在文件浏览器中集成了 LSP（语言服务器协议）支持。它会自动检测你系统 PATH 中的语言服务器（TypeScript 的 tsserver、Rust 的 rust-analyzer、Python 的 pyright 等），然后在打开一个仓库的文件时提醒你是否要启用代码智能。
启用后：
- Hover Details：把鼠标悬停在变量或函数上，显示类型签名和文档
- Go to Definition：跳转到符号定义的位置
- Symbol Search：跨文件搜索符号
OctoPunk 对效率做了优化：同一个仓库的同一种语言只跑一个 LSP 实例，切换仓库或账号时自动关闭。你还可以为每个 LSP 配置 pre-launch 命令——比如有些项目需要先跑 npm run build:types 才能让 LSP 正常工作。
Omnibar 与命令面板
Omnibar（⌘+K）是 OctoPunk 的全局搜索入口——跨仓库搜索 GitHub 内容、查看最近访问的项目、管理打开的标签页。
命令面板（Command Palette）是上下文感知的——你在看 PR 时打开它，显示的命令和你在看 Issue 时不同。PR 相关的命令包括「合并 PR」「添加 Reviewer」「关闭 PR」等，每个命令都有快捷键。
两个都是模糊搜索（fuzzy search），快速定位不依赖鼠标。
多账号支持
OctoPunk 支持同时登录多个 GitHub 账号。每个账号有完全隔离的视图——独立的 Dashboard、通知收件箱、最近访问记录。通过快速切换按钮在不同身份之间跳转，适合同时管理个人项目和组织项目的开发者。
安装与定价
OctoPunk 的安装因平台而异：
- macOS：下载
.dmg文件，拖到 Applications 文件夹 - Linux：Flatpak 格式，
flatpak install --user OctoPunk-*.flatpak - Windows：NSIS 安装器，运行后从开始菜单启动
首次启动后，你可以通过 OAuth 流程或个人访问令牌（Token）来认证。推荐使用 OAuth——更安全、更简便。令牌支持 Classic 和 Fine-grained 两种类型。
定价策略很简单：
- 公开仓库：完全免费，所有功能不限
- 私有仓库：需要 Pro 订阅
目前处于 Beta 阶段，Beta 构建版本在官网的「Looking for the beta?」链接下可以找到。
总结：谁适合用 OctoPunk？
OctoPunk 不是 Git 客户端——它明确说「Git 是版本控制工具，GitHub 是协作平台，这是两件事」。它推荐的搭配是用你喜欢的 Git 工具（CLI、Lazygit、Fork 等）处理本地版本控制，用 OctoPunk 处理 GitHub 平台操作：Review PR、管理 Issue、追踪通知。
适合以下开发者：
- 每天花 2 小时以上在 GitHub 上协作的团队开发者
- 被 GitHub 通知系统烦到不行的人
- 想在代码审查时有 LSP 支持的开发者
- 想要一个键盘驱动的 GitHub 体验的人
- 对 AI 辅助有需求但希望自控数据隐私的人
如果你是重度 GitHub 用户，OctoPunk 值得一试——它不会让你在浏览器里同时开 15 个标签页了。
相关链接：