Skip to content
View ferretgeek's full-sized avatar

Block or report ferretgeek

Report abuse

Contact GitHub support about this user’s behavior. Learn more about reporting abuse.

Report abuse
ferretgeek/README.md

ferret — 自己遇到的麻烦,自己做个工具解决

中文 · English

你好

这里的每一个项目,都是我自己先被某件事烦到了,才动手做的。

比如我在手机上想看电脑里的电影,得先传过去;比如我开了个帕鲁服务器,每次改设置都心里没底;比如我有一堆邮箱要收验证码,一个个登录要���半小时。这些事都不难,但都够烦。烦到第三次,我就会把它做成一个工具。

所以这些项目看起来八竿子打不着——一个是帕鲁配种表,一个是 Outlook 令牌续期。但它们有三件事是一样的:

  • 装在自己的机器上就能用。 不需要注册账号,不需要谁的服务器还活着。
  • 你的东西不会离开这台机器。 邮件、存档、提示词、账号,都留在本地。没有遥测,没有"匿名统计"。
  • 删掉它,不会带走你的数据。 所有东西都能导出,也都能备份。

不懂代码也能用其中一部分(下面标了 🟢);剩下的需要你会开个终端、复制一条命令。


挑几个先看

1 · CPA-X — CLIProxyAPI 管理面板

CPA-X 管理面板界面

CLIProxyAPI 能把 Codex、Claude Code、Gemini CLI 的订阅额度变成标准 API,很多人拿它统一调度自己手上的几个号。麻烦不在跑起来,而在跑起来之后:哪个号被限流了?这个月的 token 花在谁身上?我升级到新版本之后,服务到底还活着吗?

CPA-X 把这几件事收进一个页面。它读 CLIProxyAPI 自己的日志和管理接口,展示实时请求量、按模型的 token 与成本、每个账号��状态,并接管升级流程。

技术上值得一提的: 自动升级不是"下载完就报成功"——先校验 SHA-256、原子替换文件、真的去打一次带认证的管理接口拿到 HTTP 200 才算成功,失败则指数退避并回滚。日志按增量解析(不重读整个文件),支持宿主机与容器时区不一致时反推无偏移量的时间戳。配置区默认只读,主配置回写需要显式开 CLIPROXY_PANEL_CONFIG_WRITE_ENABLED

Python · Flask · Linux / Windows / Docker · ⭐ 62

仓库 · 下载 · 中文文档


2 · 局域网影片播放器 🟢

局域网影片播放器界面

家里的电影都在电脑或 NAS 上,想在手机、平板上看,通常要么先传一份,要么装一整套媒体服务器。

其实不用。Windows 共享文件夹、群晖、任何开了 SMB 的设备,这个 App 直接连进去,点开就播。字幕会自动配对(乱码时可以换字符集),看到哪儿自动记住,历史、书签、标签都在手机本地。没有账号,没有云,没有转码服务器。

技术上值得一提的: SMB 2/3 原生实现,不走 WebDAV 或第三方网关。播放走双内核——Media3 为主,遇到冷门编码自动回退 libVLC,支持硬解、倍速和帧率匹配。凭据在设备上加密保存,日志主动脱敏。另外附一个可选的 PC 端刮削器,提前生成海报和元数据写回共享目录,手机端只读结果,不额外开服务。

Kotlin · Jetpack Compose · Media3 · libVLC · Android 8+

仓库 · 使用说明


3 · 帕鲁配种图鉴 🟢

帕鲁配种图鉴界面

《幻兽帕鲁》里想要某只帕鲁,配种表在网上到处都有,但它们只告诉你"A + B = C"。真正的问题是:我现在手上就这些,怎么配最快?中间要不要先去抓一只?

这个工具读你自己的存档(只读,不改),看一眼你实际有什么,然后给出可执行的路线:先配什么、第几步会出什么、哪一步必须去补一只。也可以反过来问——"我手上这些,能配出什么值得练的"。不想连存档也行,287 只图鉴和四万多条配种关系可以直接翻。

技术上值得一提的: Level.sav 的解析是纯只读的,zlib 每一层输出、存档输入体积和库存 JSON 都有解析前的硬上限(可通过环境变量放宽),避免畸形存档打爆内存。新格式存档需要系统里已合法安装的 Oodle DLL,仓库不分发它,找不到时会明确告知而不是静默失败。同一套静态资源可以用 server_publish.py 发布成自托管站点,源存档只读、输出走临时目录原子替换。

Python · Windows 启动器 + 浏览器界面 · 完全离线

仓库 · 数据来源


4 · Codex 额度悬浮窗 🟢

Codex 额度悬浮窗界面

用 Codex 写代码的时候,最怕的是写到一半额度没了。

这是桌面上一个小小的悬浮窗,一直显示 ChatGPT 套餐里 Codex 还剩多少、几点回满。快用完了会提示你,回满了也会提示你。可以做成迷你条、圆环,或者干脆让鼠标穿过去当背景。

技术上值得一提的: 它不读 auth.json,不要你复制任何 Token——而是按需拉起一个隐藏的本机 codex app-server 子进程,通过标准输入输出拿官方额度通知,认证和刷新全部交给 Codex 自己。服务端通知不可用时,退回只读扫描最近会话日志尾部的 rate_limits 记录兜底。Codex App、CLI、PATH、IDE 扩展、Windows 安装包和 WSL 六种运行时都会自动发现,装了任意一种就能用。

C# · WPF · .NET Framework 4.8 · Windows 10/11

仓库 · 下载 · 架构说明


5 · Obsidian AI 写作助手 🟢

Obsidian AI 写作助手界面

大部分 AI 笔记插件有两个让人不敢用的地方:它偷偷读了你整个库,以及它直接改了你的文件。

这个插件反过来做。上下文是你自己挑的——这几篇笔记、这个标签、这段选中的文字、这张图,每一项都列在旁边,随时能删掉。它要改笔记时先给你一份 diff,你点确认才写回;写错了能撤销,删除只进 Obsidian 废纸篓。

模型接口随你选:OpenAI Responses、任何 OpenAI 兼容接口、Anthropic Messages,或者本地跑的 Ollama。

技术上值得一提的: API Key 与自定义 Header 默认只在内存中,远程接口强制 HTTPS,危险 Header 直接拒绝。写入路径挡掉路径穿越、绝对路径、.trash 和 Vault 配置目录。流式回复、思考过程折叠、图片理解、历史搜索与导出、斜杠工作流、提示词缓存都做完了。

TypeScript · Obsidian 1.8.7+

仓库 · 在线演示 · 隐私说明


全部 18 个项目

🟢 = 不用写代码也能上手

AI 与开发

项目 一句话 技术栈
CPA-X · CLIProxyAPI 管理面板 ⭐62 一页看清哪个账号还活着、token 花在哪、升级有没有成功 Python Flask
Codex 额度悬浮窗 🟢 桌面小窗随时显示 Codex 还剩多少、几点回满 C# WPF
Codex 额度总览 几十上百个号一次导入,批量查额度,导出 CSV Go React
CLIProxyAPI 凭证体检 凭证池里哪个号该换了,默认只读,停用要输确认短语 Python
大模型接口测速台 首字等多久、每秒多少字、缓存命中多少、这次花了多少钱 Python FastAPI
提示词手账 🟢 和 AI 一轮轮改出来的提示词,离线存本机,能搜能备份 Tauri Rust React
Obsidian AI 写作助手 🟢 只读你指定的笔记,改动先给你看,确认才写回 TypeScript

邮箱与隐私

项目 一句话 技术栈
自建域名收件箱 让自己的域名真能收信,任意 名字@你的域名 都收得到 Python 标准库 SQLite
邮件取件链接 每个邮箱一条独立网页链接,对方打开就能收码,随时撤销 Python 标准库 SQLite
Outlook 批量收件台 一次看 50 个 Outlook 邮箱的新邮件和验证码,只用 OAuth Python 标准库
iCloud 验证码查找 从 iCloud 最近的邮件里直接捞出验证码,用完即忘 Python 标准库
隐私邮箱地址管理 🟢 Apple「隐藏邮件地址」建多了记不住,导入打标签搜索备份 Python SQLite
Outlook 令牌续期 一批授权账号的令牌到期前自动续,并验证邮箱还连得上 Python FastAPI PostgreSQL
邮箱别名生成器 🟢 批量生成 名字+标签@域名,纯浏览器本地,什么都不上传 JavaScript 纯前端

游戏

项目 一句话 技术栈
帕鲁配种图鉴 🟢 从手上现有的帕鲁出发,算出配到目标最省事的路线 Python 离线
帕鲁服务器面板 自己开的服,网页里看状态、改设置、备份、更新 Python systemd

影音与网络

项目 一句话 技术栈
局域网影片播放器 🟢 手机直接播电脑/NAS 共享里的影片,字幕进度都在本地 Kotlin Media3 libVLC
代理节点体检 真的走一遍代理再判断通不通,而不是 ping 一下就说好 Python FastAPI sing-box
展开看剩下 13 个的界面

以下截图全部来自专为开源展示生成的合成数据,不包含任何真实账号、邮件、存档或主机信息。

提示词手账
帕鲁服务器面板
Codex 额度总览
大模型接口测速台
CLIProxyAPI 凭证体检
代理节点体检
自建域名收件箱
邮件取件链接
Outlook 批量收件台
Outlook 令牌续期
iCloud 验证码查找
隐私邮箱地址管理
邮箱别名生成器

我做东西的几条规矩

先想清楚人会在哪一步卡住。 界面上每一个空状态、加载中、出错、"我是不是点错了",都要有人管。做完功能只是一半。

默认值必须是安全的那一个。 只监听本机;账号和邮件默认打码;能只读就只读;停用、删除、完整���出这类不可逆操作要求逐次输入确认短语——而不是"你确定吗"点一下就过。

假的成功比失败更糟。 备份要能真的恢复回来(带成员清单和哈希);升级要真的打一次健康检查才算成功;测速要以完整 usage 为准,不能把并发吞吐伪装成单请求速度。

每个项目都能装在你自己的地方。 本地跑和自己服务器托管共享同一套核心逻辑与数据格式,不做只能用云的版本。

界面值得认真做。 每个带界面的项目都有一套完整主题(深灰暗色 + 三到五套浅色配色),覆盖弹窗、表格、表单、编辑器和全部交互状态,选择会记住。手机上也是完整可用,不是"能打开"。

2026 年 8 月的一次集中加固(技术读者向)

15 个公开项目做了一轮逐库威胁建模和从源到危险操作的数据流复核,重点在认证与会话、请求体与导入资源预算、可信代理边界、SSRF 与 DNS 重绑定、敏感错误与日志落盘、CSV 公式注入、归档恢复路径、并发生命周期状态,以及 CI 供应链。

确认的 51 个问题全部在代码、测试和维护文档里关闭。高权限 GitHub Actions 固定到审核过的 commit;部署默认值保持本机回环优先、远程强制 TLS、显式认证、最小权限。


Python Go TypeScript Kotlin Rust C# Tauri Docker

有想法、有问题、想一起做,去对应项目的 Issues 或 Discussions 找我。

以上都是独立的社区项目。Codex 和 CLIProxyAPI 相关工具与 OpenAI 没有隶属、授权或背书关系,也不绕过任何额度限制;帕鲁相关工具与 Pocketpair 无关;Outlook、iCloud、Hide My Email 相关工具与 Microsoft、Apple 无关。各自的商标归其权利人所有。

Pinned Loading

  1. cliproxyapi-dashboard cliproxyapi-dashboard Public

    CLIProxyAPI 的管理面板:一页看清哪个账号还活着、token 用了多少、钱花在哪,升级失败能自动回滚。A web dashboard for CLIProxyAPI — account health, usage, cost, logs, and verified updates with rollback.

    Python 62 7

  2. codex-quota-widget codex-quota-widget Public

    桌面上的一个小窗,随时告诉你 ChatGPT 套餐里的 Codex 还剩多少、几点回满。A Windows desktop widget for live Codex quota from your ChatGPT plan, plus the time until it resets.

    C#

  3. domain-mail-inbox domain-mail-inbox Public

    让自己的域名真的能收信:任意「名字@你的域名」都收得到,网页里读信、复制验证码、下附件。A self-hosted receive-only inbox for your own domain, with a web UI, HTTP API, and code extraction.

    Python

  4. android-smb-player android-smb-player Public

    手机直接打开电脑或 NAS 共享文件夹里的影片,字幕、进度和观看记录都只留在本机。An Android player that streams video straight from SMB shares, with subtitles, resume, and local history.

    Kotlin 1

  5. palworld-breeding-atlas palworld-breeding-atlas Public

    想要某只帕鲁,从手上现有的开始怎么配最快?287 只图鉴、配种路线,还能只读分析你自己的存档。A Palworld breeding route planner with a 287-entry atlas and read-only analysis of your own save.

    Python

  6. prompt-journal prompt-journal Public

    把你和 AI 一轮一轮改出来的提示词留下来,全程离线保存在自己电脑上,可搜索、可备份。An offline Windows workspace that keeps every AI-coding prompt iteration searchable on your own machine.

    TypeScript