Windows 上做这件事的路子通常有三条——打开笨重的图像软件、用在线转换网站（图片得上传到别人服务器）、或者装一堆用不上的东西。我想要的是一条都不用走的方案：一个双击就开的本地小窗口，用完关掉，图片不离开这台电脑。

图片压裁器（Image Cropper） 就是这么个东西。

它做什么

• ✂️ 裁剪：自由比例，或者 1:1 / 4:3 / 16:9 / 3:2 / 2:3 等常见比例，可锁定比例
• 🔍 缩放：滑块或直接输入宽高，可锁定宽高比
• 🗜️ 格式转换与压缩：JPEG / PNG / WebP，质量可调
• 📊 实时输出大小估算：改参数时立刻告诉你压完多大，并和原文件对比
• 🖼️ 本地预览：拖拽、粘贴、点击三种方式选图
• 🌍 中 / 英 / 日三语界面，Fluent 2 风格，浅色 / 深色主题

核心是实时反馈：拖动质量滑块的时候，输出体积的估算会跟着变，你不用反复导出再去看文件大小。这个循环一快，调参数就从「试错」变成了「手感」。

技术选型

用 pywebview 的好处是：界面能用 Web 技术写，但跑起来是原生窗口，用系统自带的 WebView2（Edge Chromium）渲染，不需要打包一个浏览器内核，也不需要起本地服务器。整个程序单机离线运行。

关于那个 17.7 MB

打包体积是这类小工具最容易失控的地方，所以 build.spec 上花了点功夫：

• 用 UPX 压缩 .pyd 原生扩展——但排除 *.dll，避免损坏 .NET 托管程序集；
• 排除 tkinter / setuptools / pip 等运行时用不到的模块。

最终单文件 exe 约 17.7 MB，可以改成中文名（比如 图片压裁器.exe）直接用，是绿色版。

pip install -r requirements-dev.txt
pyinstaller build.spec --clean --noconfirm

产物在 dist\PicCropper.exe。

下载

最新版 v1.1.0：

→ 打开图片压裁器发布页下载

运行环境要求：

• Windows 10 / 11
• Microsoft Edge WebView2 Runtime（Windows 11 自带；Windows 10 可从官方安装页获取）
• .NET Framework 4.8

从源码运行

# 1. 安装依赖
pip install -r requirements.txt

# 2. 运行（Windows 也可直接双击 run.bat）
py -3 main.py

目录结构很扁平：

image-cropper/
├── main.py               # 入口（pywebview 窗口与 JS 桥接）
├── image_processor.py    # 图像处理逻辑（Pillow）
├── build.spec            # PyInstaller 打包配置
├── run.bat               # 源码运行脚本（自动选择 Python）
├── requirements.txt      # 运行时依赖
├── requirements-dev.txt  # 打包依赖
├── ui/                   # 前端资源
│   ├── index.html        # 主页面
│   ├── styles.css        # 样式（浅色/深色主题）
│   ├── app.js            # 交互逻辑
│   └── i18n.js           # 多语言（zh / en / ja）
└── icon.ico              # 应用图标

改界面只动 ui/ 下的东西就行，不用碰 Python 那侧。

关于 AI 辅助

这个项目的大部分代码是 AI 编程助手（Claude Code / opencode 等）辅助编写和审查的，包括前后端代码生成与重构、Bug 定位（图层 alpha 合成、裁剪竞态、pywebview 版本兼容）、PyInstaller 打包体积优化与 UPX 配置调优、多语言界面与无障碍改进。

需求梳理、验收测试和关键决策由人工完成。

协议

MIT，欢迎使用与改进。

Akiyuki1130/image-cropper

ZCode 有一套 provider 配置，DeepSeek Harness 有另一套，格式不同、位置不同、字段名也不一样。想在两个工具之间共用一个供应商，就得手动改 JSON / YAML，还要担心把注释和缩进搞乱、把 API Key 写进一个不该提交的文件。

Agent Provider Manager（简称 APM）就是来解决这件事的：一个 Windows 桌面窗口，直接管理这些 agent 的 provider、模型、API Key、备份和迁移。

它是什么，不是什么

先说清楚边界，免得误会：

APM 不是代理服务器，不是模型网关，也不做云端密钥托管。

它做的事很朴素——直接读写你指定的配置文件，然后在上面套一层图形界面：provider 列表、模型卡片、批量编辑、模型自动匹配、导入、迁移、备份恢复、API Key 钥匙串。

它不做的事情也很明确：不存在模型代理，没有计费，没有遥测，不会把你的配置或凭据上传到任何地方。

支持的 Agent

OpenCode 的入口已在应用内隐藏（暂不适配）。相关代码与历史还原点数据保留，但顶部栏、迁移页和编辑器里都不会再出现它。

这里有个值得单独说的点：DSH 0.2 把用户配置从单个 settings.yaml 改成了 profile patch 层。provider 写在 patch 里 id: llm-pi-ai 条目的 config.providers 上，而 API Key 只写引用（apiKeyEnv），密钥本体落到 ~/.dsh/.credentials.yaml 的 version: 1 + refs 布局里。

APM 完整跟上了这套机制：写 llm-pi-ai 时只重写真正变化的节点，未被改动的 provider 子树连同其中的注释和 !!js 表达式原样保留。如果 llm-pi-ai 被 home 级 patch（~/.dsh/cordis.patch.yml）覆盖了，程序会拒绝写入并告诉你原因，而不是写一份看起来生效、实际被覆盖的配置。

能做什么

provider 管理：创建、编辑、删除、重命名；改名称、ID、类型、Base URL、API Key 和 options JSON。支持 openai-compatible、anthropic、responses 三种类型。

模型卡片：添加、删除、搜索和批量编辑模型；能改 reasoning、variants、context window、output token、modalities、headers 和额外 options。常用模型的上下文长度和输出长度可以自动匹配，在导入页或管理页批量执行。

从服务商拉模型：填 Base URL 和 API Key，点「获取模型列表」，程序会规范化 Base URL 后访问 /v1/models，并限制响应大小、模型数量和重定向次数。

API Key 钥匙串：在 Windows 上用 DPAPI 加密保存。旧版本那种可逆 Base64 数据只用于一次性迁移读取，新的保存不会再静默降级成 Base64。

跨 Agent 迁移：ZCode（新版 / 旧版）与 DeepSeek Harness（0.2 patch / 0.1 settings）之间可以互为源和目标，选择「追加 / 合并」或「覆盖」。

我最看重的一块：还原点

配置文件是那种改坏了很麻烦的东西，所以 APM 在这上面做得比较重。

每次修改前，它自动保存改动前文件的原文——逐字节保留注释和键序——并记录 Agent、绝对路径、格式、文件当时是否存在、大小、SHA-256、操作类型等元数据。

「还原点」页可以任选一个时间点回滚。而且回滚本身也能再回滚：回滚前会先给当前状态再建一个还原点。

容量上，单个目标保留最近 50 个还原点、合计不超过 64 MB，超出按最旧优先清理。

除此之外还有同级 .bak_<时间戳> 备份、SHA-256 指纹检查和「恢复最近备份」，默认每个文件最多保留 2 份同级备份。

安全边界

这部分 README 里写得很细，我挑几条：

1. 只允许 http / https，且默认仅允许 HTTPS。要访问外部 HTTP 地址，得显式打开「允许 HTTP」——那会明文传输 API Key 和请求内容。
2. 发请求前以及每一次重定向都会校验 host，默认拒绝 localhost、环回、私有、链路本地、未指定和其他保留地址；要访问本机模型服务得显式打开开关。这是防 SSRF，不等同于完整网络隔离。
3. 还原点只写在本机 %LOCALAPPDATA%\AgentProviderManager\restorepoints，文件权限 0600，不上传、不写日志——但仍是明文副本，别把这些文件提交到 Git 或发给别人。
4. 写入采用临时文件 + 重命名 + SHA-256 指纹 + 同级备份轮转 + 还原点，但不是数据库事务，不能替代你自己的离线备份。

下载

最新正式版是 2.0.7（v2.0.8 目前是 pre-release，想尝鲜可以选它）：

→ 打开 Agent Provider Manager 发布页下载

解压 / 放到有执行权限的目录，确认系统装了 Microsoft Edge WebView2 Runtime（Wails 窗口依赖它），然后启动 AgentProviderManager.exe。

程序不会自动上传配置，也不会自动修改你没选中的 agent 文件。第一次保存前，建议先确认顶部栏里的 Agent、目标配置路径和备份状态都对。

「选项」页可以手动检查更新，也能打开自动更新（默认关闭）。开启后只从固定的 Akiyuki1130/AgentProviderManager 正式 Release 检查下载；下载完不会突然退出，而是弹确认框，点了「更新并重启」之后更新助手才等旧进程退出、校验 SHA-256、替换 EXE 并用原文件名启动。失败了会尝试回滚。

已知限制

• 仅 Windows，依赖 WebView2；目前没有 Linux / macOS 发布包。
• 保存会重新序列化配置文件，注释和原始格式可能变化（ZCode 新版会按严格 schema 重编码；DSH 的 llm-pi-ai 条目里的注释也可能变）。
• ZCode 遇到未知键会把整份配置当空，所以程序宁可报错也不写出这样的文件——这个检查在唯一的写盘入口，任何写入路径都绕不过去。
• 大量模型会产生较多 DOM，2000 个模型接近上限时低配机器可能不够流畅。
• 没有内置前端 E2E 测试，发布前需要在真实 Wails 窗口里验证剪贴板、WebView2、DPAPI 和配置备份恢复。

技术栈

Go + Wails + Vue 3，前端用 Pinia 管状态，UI 走 Fluent 风格设计语言。源码以 MIT 协议发布。

cd frontend
npm ci
npm run build
cd ..
go test ./...
go vet ./...
wails build

需要 Go 1.25+、Node.js 18+ 和固定版本的 Wails CLI。

Akiyuki1130/AgentProviderManager

旧的 ZCodeProviderManager 是 v1.x 的 Python 版历史存档，已不再更新，全部开发都在 AgentProviderManager 继续。

要么是悬浮窗，一直飘在所有窗口上面；要么藏在托盘里，用一次要点两下。我想要的是一条长在桌面上的顶栏——它存在感很低，但伸手就能用。

这就是 YukiDesk。

一条「桌面层」的顶栏

YukiDesk 最核心的设计决定，是它住在桌面层，而不是普通窗口层。

具体说，它是一条 46px 高的透明分层窗口，通过 SetWindowPos 钉在桌面装饰层（壁纸引擎、桌面整理软件画的图标和挂件）正上方、所有普通软件窗口之下，并且每 3 秒兜底重钉一次——万一被别的软件误加了置顶标志，会被防御性地撤掉。

听起来只是个细节，但它直接决定了使用手感：

• 你打开任何窗口，顶栏都会被自然盖住，永远不会挡着你干活；
• 你回到桌面，它就在那儿，不用切窗口、不用翻托盘；
• 开机自启，秒出。

所以它的语义不是「悬浮小工具」，而是桌面的一部分。

顶栏本体就是上面这一条。左侧是设置、电源、回收站、小文件夹，右侧是时间、性能监测、音频频谱、音乐播放器和音量。

上面都装了什么

小文件夹

悬停选项卡向下展开一个文件面板（最高半屏，滚轮翻页，东西少时自动缩小），48px 图标，单击直接打开。

把文件拖到选项卡或面板上，默认是移动语义——来源只允许复制时会拒绝拖放，不会偷偷复制一份、让你回头找不到原件。同名项目可以替换，也可以自动编号保留为副本。

回收站

圆形垃圾桶按钮，单击展开（悬停不展开，避免误触），列出当前用户回收站的内容，包含可移动盘。

双击项目还原回原位置——用的是 $I 元数据里记录的原始路径，原位置被占了会自动加 (1) 后缀。右键单个项目可以还原 / 复制 / 永久删除；右键按钮可以「清空回收站」，带确认弹窗。

时间

悬停展开星期、日期和农历。

折叠态显示哪几项（秒数 / 日期 / 星期）和靠右还是居中，都能在设置里调。

音乐播放器

播放音乐时自动出现。数据来自 Windows 的 SMTC 全局媒体会话，所以 QQ 音乐、网易云、Spotify 乃至浏览器里播放的音乐都能识别。悬停展开大封面、歌名、歌手和播放控制。

面板不显示时间轴和进度条——在 46px 的条上，你要的是「一眼看见在放什么」，而不是又一个播放器。

音频频谱

播放器左边那条胶囊频谱，16 根对数频段柱跟着节拍跳。

实现是 WASAPI 共享模式环回采集系统播放流（专用后台线程）→ 2048 点 FFT 加汉宁窗 → 按 40Hz~15kHz 对数划分成 16 个频段 → CompositionTarget.Rendering 驱动自绘，UI 线程零阻塞。自动增益做得比较足，音量很小的时候柱子也看得出起伏。

它只读系统音频，不写音量、不影响播放。用不上可以在设置里关掉。

性能监测

频谱左边四枚胶囊：CPU 占用、GPU 占用（多显卡可指定监测哪块）、内存占用、网络上下行。鼠标放上去自动展开详情——CPU / GPU 给占用、温度、频率，内存给占用 / 已用 / 容量 / 频率，网络给上下行速率。

温度这块做得比较克制。数据源：GPU 温度/频率在 AMD 上走显卡驱动 ADL，NVIDIA 走 NVML；CPU 温度默认按 原生 Tctl → APU 真 CPU 温度 → ACPI 热区 → CPU 侧 SoC 传感器 依次降级，读不到就往下退，不显示没有依据的数字。

AMD 平台想要原生 Tctl 核心温度（与 AIDA64 / HWiNFO 同源），可以在设置里一键安装开源的 PawnIO 驱动运行时：一次管理员授权，创建一个登录时运行的提权温度任务，可随时停用，卸载 YukiDesk 时自动清理。

每项都能单独开关，全部隐藏时不采样。

音量

右侧圆形喇叭按钮，展开后只调 Windows 当前默认输出设备。这里没有做设备切换下拉框——那个操作在 Windows 自带的音量面板里更顺手。

外观几乎都能改

设置窗口分外观、时间、小文件夹、模块显示、通用、关于几页，改完实时生效：

• 外观：统一选项卡与展开页的色盘、文字与图标颜色、透明度、缩放、边框开关与颜色，还有壁纸明暗自动适配（一旦手动指定颜色，自动适配会自动关闭）。设置窗口本身也能单独跟随 Windows 深浅色，最小化 / 最大化 / 关闭按钮可自定义。
• 小文件夹：存储路径（默认 %LocalAppData%\YukiDesk\MiniFolders，可改）、新建 / 重命名 / 移除。
• 通用：开机自启、悬停关闭延迟、动画时长、桌面顶部空间预留，以及模块显示开关。开启「预留」后会通过 Shell AppBar 向资源管理器注册顶栏占用的区域，最大化窗口就不会压到顶栏上。
• 关于：版本、项目主页、更新设置。

托盘图标右键可以打开设置、显示 / 隐藏顶栏、打开数据目录或退出；顶栏被隐藏时也能从托盘重新叫回来。

下载

安装包在 GitHub Releases 发布，最新版 v1.0.8：

→ 打开 YukiDesk 发布页下载

每次发布有 4 个包 —— x64 / ARM64 两种架构 × full / slim 两种运行时类型：

普通 Intel / AMD 电脑选 x64，Windows on ARM 选 arm64；不确定就选文件名带 full 的完整版。发布页同时提供 SHA256SUMS 校验文件。

安装是每用户模式，不需要管理员权限。卸载时会一并清理登录温度任务、开机自启注册表值和 %TEMP% 里的更新残留；配置和日志留在 %AppData%\YukiDesk，可手动删除。

程序内也内置了更新检查（设置 → 关于）：可自动检查、自动下载，或手动检查；系统开了代理会自动走系统代理。发现新版本后先下载再询问，确认了才装。

已知边界

几个容易踩到的地方：

• 顶栏只覆盖主屏，多屏暂不支持。
• 音量模块始终跟随当前默认播放设备，不提供设备切换。
• 回收站只显示当前用户的回收站（其他用户的目录需要管理员权限）。
• 音乐选项卡依赖播放器上报 SMTC，个别播放器关掉这个功能就检测不到。

技术栈

C# / .NET 8 / WPF，目标框架 net8.0-windows10.0.19041.0，引用 Windows SDK 的 WinRT 投影。全部用原生 Windows API + 托管代码实现，没有任何第三方 UI 框架依赖，支持 x64 与 ARM64。

唯一的可选内核组件就是上面提到的 PawnIO，需要你主动启用。

cd DesktopBar
dotnet build -c Release

要求 Windows 10 1809+ / Windows 11，以及 .NET 8 SDK。

配置存在 %AppData%\YukiDesk\settings.json，日志在 %AppData%\YukiDesk\log.txt。

项目使用 AI 辅助完成，需求梳理、验收测试与关键决策由我负责。源码在这里：

Akiyuki1130/YukiDesk