以前：七步，还容易错
- 截图，存到桌面
- 想一个文件名
- 开一个新终端标签
scp ~/Desktop/xxx.png kk@server:~/- 回到 AI 的窗口
- 把路径手敲一遍（经常敲错）
- 想不起来"刚才那张"是哪张
给用 Claude Code · Codex · Gemini CLI 的你 · 内部版 1.1.0
截图 ⌘C，
服务器上的 AI 立刻看到
KKSnap 常驻菜单栏。你在 Mac 上截图、⌘C 的那一刻，图已经传到你 ssh 的服务器；在终端里按 ⌥⌘3，截图3: /home/kk/kksnap/shots/….png 就打进了 AI 的输入框。不用 scp、不用拖文件、不用描述"那个报错长什么样"。
3.1 MB · dmg macOS 13 起 Apple 芯片 + Intel 服务器只要能 ssh 苹果公证
截图3 已传 ✅脚本机 · 派单机 · 15:30:12
⌘C复制即上传
╭──────────────────────────────────────────╮ │ ✻ Claude Code · /home/kk/project │ ╰──────────────────────────────────────────╯ > 截图3: /home/kk/kksnap/shots/20261017-153012-3.png ⏺ Read(kksnap/shots/20261017-153012-3.png) 看到了：弹窗的 z-index 比底部按钮栏低，被 .footer 盖住了……
为什么做这个
AI 在服务器上，截图在你的 Mac 上
Claude Code、Codex、Gemini CLI 都在远程服务器里跑，它们读不到你本机的剪贴板、看不到你的屏幕。每次想让它"看一眼"，都是一轮折腾。
现在：两步
- ⌘C 截图（任何截图工具，复制即触发）
- ⌥⌘3 在终端里按一下，
截图3: 路径已经在输入框里了
编号自动 +1，所有服务器上同名同号；菜单栏 📎 里有今天每一张的缩略图，点「下次粘这张」就粘它。
怎么工作
三步，全程不离开你正在做的事
- 截图，⌘C ⌘⇧4 框选后 ⌘C，或 Shottr / CleanShot 点「复制」。KKSnap 只认剪贴板里的图片数据，文字、文件一律不碰。
- 自动传到你的服务器 压缩、编号、传到每台开着「同步」的服务器，右上角闪一下「截图3 已传 ✅」。同一张图在所有服务器上文件名一字不差。
-
终端里按 ⌥⌘3
截图3: /home/kk/kksnap/shots/20261017-153012-3.png打进 AI 的输入框，不自动回车——想粘几张按几次，补一句话再回车。在哪个终端窗口按，就粘哪台服务器的路径。
用在哪
只要你需要让 AI"看一眼"
UI 哪里不对，框出来给 Claude Code
页面上错位的一块、换行怪异的按钮、深色模式糊掉的文字：框选 → ⌘C → ⌥⌘3 →「这里为什么换行了」。比打字描述快十倍，也准十倍。
报错弹窗、日志截图给 Codex / Gemini CLI
复制不出来的报错、别人微信发来的截图、监控大盘的一角，统统 ⌘C 一下。AI 读路径看图，你不用手敲一行。
几台服务器，一张图都有
脚本机和派单机都开着同步，截图3 在两台上都是同一个文件名。在脚本机的终端按热键粘脚本机的路径，切到派单机的窗口按就粘派单机的。
本机的 AI 也能用
本机终端里开着 Claude Code？窗口标题命中本地模式时，⌥⌘3 粘的是本地路径。一个工具两头用。
功能
傻瓜式：粘个地址，剩下的它来
登录名自动找
只粘 1.2.3.4。它读你的 ssh 配置、按常见用户名并发探测，5 秒内变绿；实在找不到才让你填一次用户名和密码。
服务器端全自动
点「连接」就装好：目录、接收脚本、一把只能放图的受限钥匙。不要 sudo、不碰 cron，每一行命令都能在「高级」里看到。
多台同名同号
编号是本机全局计数，每天 0 点归 1。后加的服务器从当前号继续，清空不重置，所有服务器上永远对得上。
面板看今天每一张
📎 或 ⌥⌘4 打开：缩略图、截图N: 路径、传到了哪几台。「下次粘这张」「复制路径」「补传」「删除」一键。
在哪个窗口按，粘哪台
按终端窗口标题判断是哪台服务器（匹配串自动生成，可改）；都不命中就粘默认台。只在终端类 app 前台时生效，不会打进别的地方。
断了自动补
网络抖一下没传上？按 ⌥⌘3 时先补传再粘；面板里每张都有每台的 ✅ / ⏳ / ❌，点「补传」补上。重启不丢、不重传。
自己收拾
本地和每台服务器各留 24 小时 / 200 MB，单张压到 5 MB 以内；到期自动删，不占你硬盘，也不占服务器。
快捷键随你改
⌥⌘3 粘路径、⌥⌘4 开面板都能改；标记格式 截图%d: %s 也能改成你的 AI 工具喜欢的写法。
零权限模式
不想给「辅助功能」？切到零权限模式：按 ⌥⌘3 只把路径复制到剪贴板，你自己 ⌘V。其余一切照常。
安全
装在你服务器上的东西，
你每一行都看得见
它只做一件事。代码开源、零第三方依赖（只用系统自带的 ssh）、苹果公证。下面这六条写进了软件的「关于」页，也写进了安装说明。
- 只在你刚复制了一张图片时，才把那张图传到你添加的服务器；每次都在右上角闪一下，没有静默上传。
- 不看剪贴板文字、不记录键盘、不截屏、不读你的文件；除了你添加的服务器，只连 KKSnap 官网（登录、每 6 小时报到 + 检查更新、你主动发的反馈），报到只带版本和机型。
- 服务器上只有一把「只能放图」的钥匙（
authorized_keys里一行restrict,command=…）：开不了 shell、改不了配置；想收回，删那一行就行，或在 KKSnap 里点「移除并清掉服务器上的 KKSnap」。 - 安装到服务器上的每一行命令都先给你看（高级 → 查看安装脚本全文），可以复制了自己跑。
- 图片两边各只留 24 小时 / 200 MB，单张不超过 5 MB，自动清理。
- 自动更新的包要过三道校验：SHA-256、版本号、代码签名必须和你装着的这个 KKSnap 是同一个开发者；服务器被动了也换不进别人的程序。
哪些电脑能装
你的 Mac 和你的服务器，基本都行
你的 Mac
- macOS 13 Ventura 或更新
- Apple 芯片和 Intel 都支持（通用版）
- 能 ssh 到你的服务器（密钥或密码都行）
- 一项权限：「辅助功能」（用来把路径打进终端；不想给就用零权限模式）
- 任何截图工具：系统自带 ⌘⇧4、Shottr、CleanShot…复制即可
你的服务器
- 能 ssh 登录的 Linux / macOS（Ubuntu、Debian、CentOS…都行）
- 用户目录能写（装进
~/kksnap/，不要 sudo，不碰 cron） - 服务器上的 AI 工具不限：Claude Code、Codex、Gemini CLI……能读本地文件路径就行
- 几台都可以，每台一个「同步」开关
- 1
下载安装
打开 dmg，把 KKSnap 拖进「应用程序」，从「应用程序」打开，菜单栏出现 📎。
- 2
注册并登录
在 KKSnap 里点「用邀请码注册」（或在这个网站注册），邀请码找管理员要；之后用这个账号登录。
- 3
粘地址，点连接
粘
1.2.3.4或kk@1.2.3.4→ 连接 → 卡片变绿。终端里正 ssh 着的服务器会直接列出来，点一下就加。 - 4
开权限，截一张
点「去开启」给辅助功能权限，截一张图 ⌘C，到终端里按 ⌥⌘3。引导窗口会一步步带你，每步做好自动打勾。
常见问题
你可能想问
它会不会上传我剪贴板里的文字或别的东西？
不会。只在剪贴板里出现「图片数据」时才动，文字、文件、PDF 一律不看；每次上传右上角都会闪一下，没有静默上传。暂停上传一键可点。
要什么权限？不给「辅助功能」能用吗？
只要「辅助功能」一项——按 ⌥⌘3 把路径打进终端要用，它不读你的键盘（只注册了两个全局快捷键）。不想给就用「零权限模式」：按 ⌥⌘3 只把路径复制到剪贴板，你自己 ⌘V。
它在我服务器上装了什么？怎么卸载？
用户目录下一个 ~/kksnap/（接收脚本 + 图片）和 authorized_keys 里一行受限钥匙（restrict,command=…，只能放图、删图，开不了 shell、转发不了端口）。不碰 cron、不 sudo、不改系统配置。卸载：在 KKSnap 里点「移除并清掉服务器上的 KKSnap」，或自己删那一行 + rm -rf ~/kksnap。
支持 Intel 的 Mac 吗？
支持。通用版，Apple 芯片和 Intel 都行，macOS 13 Ventura 起，不需要升级到最新系统。
支持哪些终端和 AI 工具？
终端：iTerm2、Terminal、kitty、Ghostty、Warp、WezTerm、Alacritty、VS Code / Cursor 内置终端（白名单在设置里可改）。AI 工具不限：Claude Code、Codex、Gemini CLI、OpenCode……只要它能读本地文件路径。标记格式也能改。
多台服务器怎么办？
加几台就同步几台，每台一个「同步」开关；所有服务器上文件名一字不差。在哪个终端窗口按热键就粘哪台的路径（按窗口标题判断，匹配串自动生成、可改）；都不命中就粘设置里的默认台。
图保留多久？会不会占满硬盘？
本地和每台服务器各保留 24 小时 / 200 MB，单张自动压到 5 MB 以内，每天最多 500 张，到期自动清理；都可以在设置里调。
怎么更新？
不用管。KKSnap 每 6 小时检查一次，有新版本会先下载好、核对签名，再问你一句；点「立即更新」自动换好重新打开，设置和服务器都保留。官网这个下载按钮永远是最新版。
「账号已停用」是怎么回事？
管理员可以在后台停用账号。停用后 KKSnap 会在下一次检查时锁上（最晚 6 小时，重开 KKSnap 立即生效），提示「你的账号已停用」。重新启用后自动恢复，不用重装。
邀请码在哪？忘记密码怎么办？
邀请码找管理员要。忘记密码也找管理员，后台可以重置。现在是内部版，凭邀请码免费使用。
和 Shottr / CleanShot 冲突吗？
不冲突，配合最好：用它们截图后点「复制」，KKSnap 就接手上传；它们在前台时面板不会自动收起，方便你截面板本身。
遇到问题怎么反馈？
菜单栏 📎 右键 →「反馈问题…」，写两句、附上截图（可勾选附上运行日志，日志里没有图片和密码），管理员在后台直接看到；也可以在这个网站的「反馈」页提交。
更新记录
每一版改了什么
- 官网上线 kksnap.amangoapp.com：注册（邀请码）/ 登录后使用，管理员可在后台停用账号
- 每 6 小时自动检查新版本：下载好、过 SHA-256 / 版本号 / 签名三道校验再问你一句，点「立即更新」自动换好重开
- 菜单栏 📎 右键「反馈问题…」/ 面板 💬：写两句、附截图（可带运行日志）直接到开发者后台
- 设置 → 关于新增「账号与更新」；安全承诺更新：除你添加的服务器外只连 KKSnap 官网