工具索引 我最近在做什么 / Custos
开源工具 · 03 · OSS INDEX
Custos · 守者 应用标

Custos · 守者

Local-first Privacy Workbench · Windows + Web

把密码、API Key、MT5 交易账户收进同一个加密工作台:数据存在你自己手里 —— 桌面版零联网、可离线;云端版多端同步、服务端只见密文。

v1.0.10 Windows 10 / 11 桌面 + 云端 MIT 开源 零外链 · 可离线
仓库:cnb.cool/balakov-2026/Custos · 云端版已上线 custos.app.workbuddy.host · 截图均为真实运行(示例数据)
01 · Capabilities

功能一览

三类最不该躺在记事本里的东西 —— 账号密码、AI API Key、交易账户 —— 放进一个加密工作台,外加 Dashboard、待办与日历。加密这一层,按「数据文件被拿走也打不开」的标准做。

三类卡片 · 一处安放

账号密码 / AI API Key(多组端点 · 多组 Key · 多组模型)/ MT5 交易账户(只读密码 · 服务器 · 关联卡),外加 Dashboard、待办与日历。

真加密存储

PBKDF2-SHA256 60 万轮派生密钥 → AES-GCM-256 加密,附 HMAC-SHA256 校验;数据文件被拷走也打不开。

dataKey 双包裹

主密码与助记词各包一份数据密钥:找回一步到位;改主密码零重加密(原理见 03 节)。

助记词找回

BIP-39 24 词(自实现、含词表与校验位);首次登录 4 步留存向导,未留存会反复提醒。

3 槽位轮换写盘

每次保存双写 + 64 字节头(时间戳 / 计数 / SHA-256);读盘校验失败自动回退上一槽。

加密备份闭环

单卡 / 全库导出 .custos 加密备份,登录页直接导入恢复;API Key 卡恢复时预填多组界面。

自动锁定 · 剪贴板自律

无操作自动锁屏(6 档可选);复制敏感内容后,剪贴板按秒自动清空。

三套皮肤 · 双轴主题

Fluent 2 / shadcn 简约 / 墨印(朱砂印色);明暗可跟系统,皮肤随时可切。

托盘常驻 · 单例锁

关窗最小化到托盘;重复启动拉起已有窗口;单文件构建,断网可用。

02 · Interface

界面实拍

以下截图均取自真实运行(示例数据)—— 明暗双主题与三处界面细节。

暗 · 亮双主题

暗色主题的 Custos 工作台首页 亮色主题的 Custos 工作台首页
同一份数据 · 仅切换主题;三套皮肤(Fluent 2 / shadcn 简约 / 墨印)另可在设置里切换

三处界面细节

03 · Security

加密设计与边界

关于加密,能讲的都放在这里;不能防的也直说 —— 一份诚实的安全声明,比一堆形容词有用。

DATAKEY · 双包裹

一个数据密钥,两把钥匙各包一份

dataKey = 随机 32 字节(真正用来加密数据的 AES-256 密钥) wrappedByPassword = AES-GCM( PBKDF2(主密码, 60 万轮), dataKey ) ← 解锁 wrappedByMnemonic = AES-GCM( SHA-256(助记词), dataKey ) ← 找回 你的数据 = AES-GCM( dataKey, 明文 )

最直觉的做法是「用主密码直接加密数据」—— 但那样忘记密码就等于数据没了,「找回」只能重置成空库。双包裹之后:找回 = 验证身份 + 解锁数据,一步完成;改主密码只需重换一层包裹,数据零重加密。

BOUNDARIES · 边界

说清楚它不防什么

  • 已解锁状态下,本机运行的恶意软件读内存 —— 不防。
  • 键盘记录器(输入主密码时)—— 不防。
  • 你主动把助记词泄露给别人 —— 不防。

它保护的是硬盘上的那份数据文件:被拿走,也打不开。助记词是绕过主密码的完整后门 —— 请离线抄写,不要截图、不要存云笔记。

04 · Cloud

云端版 · 已上线

同一套工作台,多一种存法:登录账号 → 解锁 → 自动同步。云端与桌面共用同一份加密格式,服务端只见密文。

云端版登录页:邮箱验证码 / 手机验证码 / 登录密码三种方式
登录页 · 三种方式邮箱验证码 / 手机验证码 / 登录密码,任选其一;「两套密码互不影响」直接写在页面上。
云端版工作台设置页:明示云端只保存密文,主密码与助记词永不上云
云端工作台浏览器里还是同一个工作台;设置页明示「云端只保存密文,主密码与助记词永不上云」。

入口:https://custos.app.workbuddy.host/ · 桌面版无需注册、永久可单独使用;云端版只为「多设备」场景准备 —— 同一份加密格式,两种存法。

05 · Setup

运行与上手

桌面版两条路线:下载 exe 直接用,或从源码跑(浏览器模式零依赖,适合先试玩)。

路线 A · 单文件(推荐)

下载 → 解压 → 双击

Releases 下载 Custos-<版本>.zip,解压到任意目录,双击 Custos.exe;设一个主密码,抄下 24 个助记词。

整个目录就是全部 —— 卸载时直接删掉文件夹即可;数据在同目录 data/vault.Custos。

路线 B · 从源码

三行命令跑起来

# 浏览器模式(零依赖试玩,数据存浏览器) cd dist && python -m http.server 8899 # 桌面模式(正式使用形态,数据落盘) python desktop/app.py

打包 exe 用 desktop/build.bat,需要装了 pywebview 的 Python 环境。

操作速查
操作功能
主密码解锁每次启动的入口;建议 8 位以上 —— 无法找回,只能靠备份的 24 词助记词。
搜索栏搜卡片、备注、服务名(Dashboard 顶栏常驻)。
眼睛 / 复制按钮临时显示或复制任意字段;复制敏感内容后,剪贴板按设置自动清空。
一键锁屏主窗口内即时锁定,不必退出程序。
自动锁定无操作超时锁屏,6 档时长可选(登录页 / 留存向导 / 改密弹窗 / 编辑态豁免)。
托盘右键显示主窗口 / 退出;关窗默认最小化到托盘,单例锁防重复启动。

数据都在你手里:data/vault.Custos(3 槽位轮换冗余,任一损坏自动回退)· data/debug.log(6 类错误源)· .custos 加密备份(离线保管)

06 · Reliability

可靠性与版本

桌面与云端两套体系,按同一套标准在做:发版前全套自动化测试,云端跨域逐字节对账。

81 项单测断言(加密栈 / 数据格式 / Web 外壳),发布前实跑全绿
25 块内联脚本语法门禁,逐块检查、0 失败
9 套端到端冒烟(启动时序 / 首启 / 剪贴板 / 自动锁定 / 托盘…)
28/28云端两域(测试 ↔ 生产)产物逐字节对账全等
版本与里程碑
版本日期要点
云端版2026-10-08生产域上线:邮箱 / 手机 / 密码三种登录 + 加密多端同步;与测试域同版收官
v1.0.102026-10-05第三皮肤「墨印」(朱砂印色)+ 图标三集规范化(Fluent / Lucide / Phosphor)
v1.0.9.02026-09-05V2.0 UI 重构:16 个源文件拆分 + 组件库 + 单一状态中心,行为零变化
v1.0.5–1.0.62026-09 上旬vault 三步原子写 + 自愈恢复;3 槽位轮换写盘治本;自定义确认框
v1.0.0–1.0.42026-09 上旬起步迭代:托盘常驻 / 单例锁 / 自定义右键菜单 / 写盘抖动加固
07 · FAQ

常见问题

数据存在哪里?

桌面版完全在本地:程序目录 data/vault.Custos(3 槽位轮换冗余);云端版为 AES-GCM-256 加密后上传,本机保留密文缓存,服务端只存密文。

忘了主密码怎么办?

用 24 词助记词找回:验证身份与解锁数据一步完成,数据完整保留。主密码与助记词都丢失时,数据无法恢复 —— 这是真加密的代价,也是它的保证。

云端版是必须的吗?

不是。桌面版永久可单独使用、无需注册;云端版只为「多设备」场景准备:登录同一账号,解锁即同步。桌面与云端用的是同一份加密格式。

手机上能用吗?

移动端在规划中;当下换设备用云端版即可 —— 浏览器打开、登录、解锁、读回。

它不防什么?

已解锁状态下的内存读取、键盘记录器、主动泄露助记词 —— 三条不防,详见 03 节。它保护的是硬盘上的数据文件:被拿走,也打不开。

开源吗?

开源,MIT 协议,桌面与云端在同一仓库:cnb.cool/balakov-2026/Custos。欢迎反馈与贡献。

站内信 · CONTACT

有问题,或想谈谈合作?

工具的问题与建议、功能想法,或合作意向 —— 都欢迎发站内信(说明是哪个工具即可),我会尽快联系你。

写站内信