Bossanova

开始使用

Bossanova 是一款数字保险库，可在您的电脑上加密存储文本和图片。您必须登录应用，包括使用免费账户登录。账户登录与用于打开保险库的主密码彼此独立。

如果 Google 提示“此账号已存在于您的设备上”而无法继续，请返回此处，使用相同的 Google 邮箱地址选择“通过邮箱继续”。如果您已使用相同邮箱地址注册 Bossanova，这样会登录您已有的账号。您也可以尝试其他浏览器。

当前安装程序适用于Windows 10/11 x64。暂不提供32位Windows和原生ARM64安装程序。安装或更新WebView2可能需要联网。

从下载页面获取适合您操作系统的安装程序并安装。
完成安装，然后从开始菜单打开 Bossanova。支持 Windows 10/11 x64。如果缺少 WebView2，安装程序会将其安装好。如果工作电脑阻止安装，请联系管理员。
在应用的登录页面上使用 Google、Apple 或电子邮件注册或登录，然后批准此设备。免费账户可以保存 10 个数据项。
在首屏创建保险库并设置足够长的主密码，妥善保管。迁移现有保险库时，请在创建前选择从其他设备导入。备份文件使用单独的从备份恢复操作。
先保存一个无害的示例。试着搜索、查看和复制它，然后添加真实信息并创建外部备份。

开发者无法恢复忘记的主密码。使用 Google、Apple 或电子邮件登录也无法重置主密码。

保存和整理数据

Bossanova 保险库按文件夹 → 分组 → 数据项进行组织。一个数据项由一个名称和一个值（文本或图片）组成；分组用于归纳相关数据项。文件夹可以包含分组和未分组的数据项，而保险库则由这些文件夹组成。例如，您可以在“API 密钥”文件夹中创建“bossanova”分组，并在其中放入“OpenAI API 密钥”和“续订日期”数据项。每个文本或图片数据项都计为 1 个。

文件夹用于整理分组和数据项。拖动手柄可调整顺序。删除文件夹时，可以选择保留或删除其中的内容。

点击星形图标开关 AI 访问。悬停可查看名称，浅绿色背景表示已开启，图标保持线条样式。列表、详情、数据编辑及群组创建和编辑使用相同按钮。全部数据和文件夹共用排序：默认、最新、最旧、最常用、最少用、名称升序和降序。最后一次选择保存在此保险库中，下次启动仍适用。名称按界面语言排列，数字 2 排在 10 前。要在文件夹内拖动调整顺序，请选择默认；其他排序不会覆盖手动顺序。

设置 → AI → AI 访问中的新数据默认访问最初关闭。它适用于新增文本、图片、创建或编辑分组时添加的数据、模板及 .env 导入。保存前仍可分别调整 AI 图标。现有数据、非机密共享及执行批准不会改变，选择保存在此保险库中。

在左侧菜单中使用“添加和管理文件夹”创建文件夹，然后拖动手柄调整顺序。
使用“添加数据”输入名称、类型（文本或图片；较早创建的数据项会保留其密码、数字或日期类型）和值。未选择分组时，数据项会直接放在文件夹中。图片（PNG, JPEG, GIF, WebP, BMP, ICO, TIFF, TGA, PNM, QOI, HDR，最大 10MiB）可以拖入或粘贴。点击数据项会打开其详情，点击“编辑”会打开已填入已保存值的编辑对话框（使用“显示值”进行检查）。
将一个数据项拖到另一个数据项上可以创建分组，将一个分组拖到另一个分组上可以合并分组。使用手柄可以调整所有项目的顺序。
需要使用数据项的值时，使用其查看或复制操作。目标应用或文档可以看到粘贴的值，因此请确认粘贴位置。
Plus 和 Pro 包含常用分组的模板。但实际值仍需由您自行输入。

请只将机密放入值输入框。根据您的设置，数据项名称、描述以及分组和文件夹名称可能会共享给 AI。

导入 .env 文件

您可以一步将项目 .env 文件中的机密移入保险库。在“新建分组”对话框左下方点击“导入 .env”，或将文件拖到保险库页面上。一个文件会成为一个分组，每个变量会成为一个以变量名命名的数据项。数据仍作为机密保存；AI 访问遵循新数据默认设置。

预览中只显示变量名，值绝不会出现在屏幕上。选择分组名称（例如 web .env），然后检查列表。
端口或公共 URL 等可能不是机密的值会标记为“非机密”候选项。默认情况下所有内容都是机密；只有您亲自选中的项目在确认警告后才会标记为“非机密”。
如果您通过文件选择器导入，可以选择删除原始 .env 文件。拖入的文件不会被删除。
导入会作为一个整体步骤保存。如果导入后会超过套餐的数据上限，则不会保存任何内容，并会显示升级提示；现有信息不会受到影响。

AI 可以在“注入运行”中整体使用导入的分组：分组中每个已开启 AI 访问权限的数据项都会作为以该数据项名称命名的环境变量注入。留在项目中的 .env 文件可能会被 AI 读取，因此其内容进入保险库后，请清理该文件。

查找信息

在保险库解锁时，在搜索框中输入名称或关键词。无需按 Enter，结果就会更新。可以先输入名称的一小部分；完全匹配的结果会优先于部分匹配和相似匹配。

搜索使用本地算法执行，不会将查询发送给 AI 或账户服务器。默认搜索名称和描述。启用同时搜索值内容的选项后，也会搜索文本值；匹配到的机密值不会出现在结果预览中。图片不会通过 OCR 搜索。选择结果后，查看或复制所需的数据项。

如果没有匹配结果，请缩短查询词或调整空格。清除查询词即可返回完整列表。保险库锁定时无法使用搜索。

语言

设置 → 常规 → 语言 — 屏幕显示所用的语言。选择后会立即应用，并保存到此保险库。锁定屏幕使用电脑的语言。

锁定和退出

离开电脑时请锁定保险库。新保险库默认在闲置 5 分钟后锁定；现有保险库会保留原有设置。您可以在设置中更改时间。保险库锁定时，使用机密值的 AI 任务无法继续。AI 发出请求期间，保险库解锁后自动锁定最长可延后 12 小时；即使您离开电脑，最后一次 AI 请求后的 60 分钟内保险库也不会自动锁定。这样可以避免长时间构建过程被锁定中断。

关闭窗口后，Bossanova 仍会在系统托盘中运行。点击托盘图标即可重新打开；如果要完全退出，请从托盘菜单中选择“退出”。电脑关机或 Bossanova 已退出时，AI 无法使用本地保险库。

如果关闭自动锁定，请在离开座位前锁定金库或按 Ctrl/Cmd+L。

自动启动与解锁

在设置 → 常规 → 自动启动与解锁中开启“登录电脑时启动”。Bossanova 会在您下次登录时打开。此选项默认关闭。

“电脑登录后自动打开保险库”是单独的设置。请阅读提示，并使用主密码确认，以便将解锁凭据存储在此设备的安全存储中。两个设置都开启后，Bossanova 会在下次登录电脑时从托盘启动，不打开窗口。

自动打开功能在每次操作系统登录时只运行一次。手动锁定、睡眠、屏幕锁定以及重新启动应用都需要输入密码。更改密码或重置安全设置会关闭自动打开功能。设备解锁凭据不会随备份转移。

开启自动打开会增加拥有您操作系统用户权限的程序访问保险库的风险。请勿在公用电脑上使用。请继续保管主密码和外部加密备份。

设备间传输与加密备份

保险库位于操作系统用户的应用数据文件夹和安全存储中，而不在 EXE 文件旁边的文件夹中。只移动可执行文件不会移动保险库。设备之间不会自动同步。

日常设备迁移使用同一 Wi-Fi/LAN 内的直接传输。金库和图片均加密传输，只在两台设备之间流动，不经过 Bossanova 服务器。无需用 USB 搬运备份文件。Bossanova (Windows) 的传输上限为整个加密金库 2 GiB，包含图片。两台设备都需要使用支持此备份格式的版本。

首次接收的设备会加入同一个金库。之后导入时会合并文件夹、分组和数据的更改；只有两台设备分别修改了同一项且内容不同时，才需要选择保留哪一版。这不是自动同步，每次交换更改都需要执行导入。AI 连接和批准不会传输。

加密备份是用于灾难恢复的独立副本。可在桌面应用的设置 → 备份中创建或恢复。请在磁盘故障后仍能保留的安全位置存放单独副本。恢复会回到备份时的状态，因此请先备份当前状态，并在确认恢复成功前保留原件。

如果图片损坏或丢失导致保险库无法打开，请在锁定页面选择“从备份恢复”。选择同一保险库的正常备份，分别输入当前主密码和备份时的密码，两者可能不同。替换前会保留损坏的原始文件及剩余加密文件，但无法重建已丢失的内容。恢复后回到备份时的内容，当前主密码保持不变。请重新检查 AI 连接、授权和值公开设置。

自动备份是存放在这台电脑（应用数据文件夹）中的副本，用于恢复误删的信息。更改密码或执行安全重置后，请重新导出保管库。

恢复备份时的信息，之后添加或更改的信息将被替换。恢复前，会先在这台电脑上自动保存当前金库的加密副本。现有访问记录会保留；AI 连接和值的分享设置会被重置。

将两台设备连接到同一普通 Wi-Fi/LAN，并登录同一个 Bossanova 账户。打开两端应用，解锁已有金库。若接收设备尚无金库，从首屏的“从其他设备导入”开始。
在发送设备上选择设置 →“发送此金库”。显示的代码仅可使用一次，3 分钟后失效。
在接收设备上选择“从其他设备导入”，输入发送设备的代码和该金库的主密码。应用会自动查找同一 LAN 内的发送方。
完成前请保持两端应用显示在前台，并让已有金库保持解锁。切换到后台或锁定金库可能取消传输。检查导入内容；若有冲突，选择要保留的版本后合并。

访客 Wi-Fi 的设备隔离、VPN 或防火墙可能导致找不到对方。请将两端连接到同一普通 Wi-Fi，允许本地网络访问后重试。不会自动改用互联网中继。设备间复制也会传播删除或误操作，因此不能代替独立备份。

安全

设置 → 安全 → 更改主密码 — 普通更改只会修改用于解锁金库的密码。内部加密密钥和旧备份不会改变。如果怀疑信息已泄露，请使用“泄露应对 · 重置安全设置”。

设置 → 安全 → 泄露应对 · 重置安全设置 — 使用新的加密密钥和新密码保护当前信息。字段和值会保留；所有 AI 连接、访问权限和值的分享设置都会被重置。新的访问记录将从此开始，之前的记录会保留在更改前的备份中。

更改前的加密备份会保留在这台电脑上。旧备份仍可使用旧密码打开，不能直接覆盖新金库。你可以在单独的空白存储位置恢复它。

如果怀疑电脑已感染恶意软件，请先在可信设备上处理。在已感染的电脑上仅更改密码并不能提供保护。

已泄露的历史内容无法收回。请在相应服务中更改或撤销已泄露的服务密码和 API 密钥。完成后请创建新的外部备份。

永久删除保险库需要主密码，会不可撤销地删除此 PC 的保险库及内部备份。其他位置的外部备份仍保留。

账户、套餐和设备

包括 Free 在内的所有套餐都要求登录应用。使用 Google、Apple 或电子邮件登录，并批准显示的设备。如果您已经登录，可以在设置中的账户和订阅部分检查状态。

在 Apple 中选择“隐藏我的电子邮件”可能会创建一个不同于您现有 Google 或电子邮件账户的独立账户。要继续使用现有订阅，请使用该账户原先采用的登录方式登录。

套餐的数据数量限制适用于新增和编辑内容，不限制 AI 查询或使用已保存的数据。即使数据为只读，也能分别开启或关闭“AI 访问”和“非机密”设置。公开值仍需本人同意；实际执行仍需解锁保险库、批准连接、启用设备并批准操作。

订阅结束后，仍可查看、搜索、复制、备份和恢复现有数据。固定的 10 个免费基础字段仍可编辑，附加字段为只读。重命名或重新排序不会改变基础/附加归类。模板仅限 Plus 和 Pro。

在应用的设置 → 账户与订阅 → 优惠码，或网站的账户页面中兑换免费使用券。选择套餐后，可在 Paddle 结账窗口中输入折扣码。

免费使用券无需绑卡，到显示的日期即结束，不会自动扣款。同一套餐等级的使用券会延长剩余期限。已有付费权限或其他等级的使用券时，请在到期后使用。如果有未完成的付款，请先在账户页取消未付款订单。

应用折扣码后，请选择适用的套餐并完成Paddle付款。需要提供付款方式，订阅会持续自动续费，直到取消。请确认折扣比例、适用的付款次数和全年总价。优惠结束后将按原价续费。您可以在管理付款中更改付款方式、查看收据或取消订阅。

登录价格页面即可更改套餐或付款周期。核对并确认金额后立即生效。取消订阅请使用订阅管理。使用体验券期间也可选择 Plus 或 Pro，预约订阅。现在不会扣款，请登记付款方式并确认首次扣款日期和续费金额。体验券到期且首次付款成功后，所选套餐才会生效。取消预约不影响原体验券的剩余时间。添加新体验券前请先取消预约。部分限定价格的折扣不适用于预约。在韩国等需要额外同意的地区，Paddle 会在首次付费续订前请求确认。未同意时，预约将被取消，不会扣款。

已登录设备列出连接到此账户的应用。套餐设备上限只计算可编辑保险库的设备。“停用编辑”会在下次检查账户时将设备设为只读；设备旁的“退出登录”要求该设备重新登录。两项操作均不删除保险库文件或备份。

套餐	数据项	已连接设备
Free	10	1
Plus	100	2
Pro	无限	5

退出登录会锁定保险库；再次登录后才能使用。您的原始保险库和备份不会被删除。如果无法登录，请在登录页面使用“紧急备份导出”，通过主密码导出一次加密备份。保持登录状态时，已过期的付费套餐仍允许您编辑 10 个基本数据项；其他数据项会保留为只读。付费功能最多可离线运行 7 天。

连接 AI

AI 是可选功能。连接后，任何需要值的工作都会由 AI 交给 Bossanova 处理，而 AI 始终不会收到该值。为数据项开启 AI 访问权限后，AI 只能看到其名称、描述和分组，看不到值。值可以被用于什么位置，由您在 AI 首次尝试使用它时，通过应用中的批准卡决定。

授权右上角的垃圾桶仅撤销该条授权。“连接排查与手动添加”用于修复连接或添加列表以外的 AI，正常使用无需修改。

解锁 Bossanova，在设置 → AI →“查找此电脑上的 AI”中启用 Claude 桌面版。完全退出并重新打开 Claude。ChatGPT 普通 Chat 请在“ChatGPT”卡片中单独连接。
通过各 AI 的开关连接。Claude 应用也会为本地 Code 标签页安装 bsnv：用 /mcp 检查连接，用 /bsnv 查看指南。Chat 使用 + → 连接器，并通过 MCP 接收指南。应用更新后，解锁 Bossanova 时会更新现有连接的技能。“全部连接”为避免重复会跳过原生 Claude Code，但包含 WSL。
“Codex”一项配置的是 Codex 主机，仅此配置不会连接普通 Chat。ChatGPT 应用和网页版的普通 Chat 使用 OpenAI 官方隧道。
对于 CLI 主机，请开始新的对话，并确认列表中显示 Bossanova 工具。为要使用的数据项开启 AI 访问权限，然后像平常一样让 AI 执行任务（例如：“使用存储在 Bossanova 中的部署令牌进行部署”）。AI 会根据名称和描述选择数据项。
AI 首次尝试使用数据项时，Bossanova 中会显示批准卡。请检查数据和目标（某项服务，或可执行文件、文件夹、变量名和传递载体），然后选择“拒绝”、“仅这一次”、“24 小时”、“7 天”、“30 天”或“始终”。批准后，不会再次询问同一目标。

项目控制仅支持 ChatGPT 应用和网页版的普通 Chat，以及 Claude 桌面版。不支持 Claude 网页版。使用保险库数据和访问项目需要分别授权。登录和连接同意须由您完成。若看不到工具，请刷新工具列表或开始新对话；旧对话可能保留旧连接。无法保证 OpenAI 权限、可用性或免费额度。WSL 和 Windows 的连接彼此独立。

AI 如何使用值

AI 永远不会收到值。需要值的工作由 Bossanova 代表 AI 通过以下两种方式之一完成。

“代我发送”：AI 会提供一个 HTTPS 请求（方法、URL、标头和正文），并在值应出现的位置放置占位符；Bossanova 自行发送请求，仅在该位置插入值。值不会出现在 AI 的代码、请求或响应中。首次使用某项服务时，批准卡会列出数据项和该服务的主机集合（GitHub 等知名服务会将其主机归为一组）；同一服务的其他路径和方法不会再次询问。只允许通过 https 使用 443 端口访问公共地址，不会跟随重定向；返回给 AI 的响应中，任何回显的值都会被遮盖。对于部署令牌以及发送到服务器的支付、邮件或云 API 密钥等机密，应使用此方式。

“注入运行”：AI 会指定一个可执行文件（绝对路径；脚本按其文件指定）、工作文件夹、本次运行的参数和环境变量名。首次使用时会显示批准卡；批准后，Bossanova 会自行启动程序，并仅通过卡片所示的传递载体传入值。每次运行的参数可以自由变化，不属于批准范围；可执行文件、文件夹、变量名、传递载体或脚本内容发生变化时，会再次询问。传递载体有四种：环境变量（原样传递值）、临时文件（将文件路径放入变量中，运行后删除）、代理（进程只会得到一个虚假令牌；Bossanova 的按次运行 HTTPS 代理仅在向卡片所列主机发出的请求中将其替换为真实值）以及 SSH agent（密钥仅在 Bossanova 内部签名）。使用代理和 agent 传递载体时，进程永远不会收到值本身（如果响应中回显了值，也会将其转换回虚假令牌）。与“代我发送”不同，进程会先看到响应；使用 SSH agent 时，程序可以让任意服务器使用该密钥完成签名，批准卡会对此进行提示。

必须进入应用内部的值（例如构建工具和客户端 SDK 密钥）应使用环境变量传递载体。此时值位于该进程内部，可能会留在程序、其子进程和输出中。已经通过“代我发送”绑定到某项服务的数据，不能通过环境变量或临时文件传递载体注入（这样可以避免服务器机密进入 AI 编写的代码）。从 .env 导入的分组可以整体注入；对于开发服务器等不会自行结束的命令，会作为会话运行，以便 AI 读取运行日志并请求停止。WSL 中的 Linux 路径会在对应发行版内部运行。一次运行最长为 24 小时。

AI 会收到退出代码、耗时以及已遮盖值的运行日志（会遮盖纯文本、base64 和 URL 编码形式，并删除看起来像机密的字符串）。如果命令输出了值，则不会将日志发送给 AI，只会返回原因；您可以在 AI 标签页的“最近运行”中查看已遮盖的日志。

每个数据项和目标只有一个批准，与发起请求的 AI 无关（请求 AI 只会记录在访问日志中）。期限包括“仅这一次”、“24 小时”、“7 天”、“30 天”和“始终”，可以在 AI 标签页的批准列表中撤销批准。撤销无法取消已经到达目标的请求，也无法收回已经交给运行中程序的值。

印章、签名等图片用于由您查看和复制，并没有让 AI 自动使用这些图片的功能。同样也没有代您填写浏览器表单或完成文档的功能。

env 或 file 会让获准进程收到真实值。即使使用 send、proxy、agent，如果把机密保存到获准服务中，也可能经其他途径读回。不要把机密写入 AI 可读的文档、日志或消息。操作系统、应用和获准目标必须可信。

关闭 AI 访问会暂停使用秘密值，并保留按时限授予的批准（包括“始终允许”）。重新开启后，若值和使用目标未变，新请求可继续使用有效批准，原到期时间不会延长。先前等待中的请求和“仅限本次”批准不会恢复。如需撤销批准，请选择“撤销批准”。“非秘密”共享是独立设置。

更新和文件验证

在设置 → 常规 → 应用更新中开启自动检查和下载，或手动检查。下载期间仍可继续使用保险库。准备好的更新会在下次打开应用时安装；也可以在完成编辑后选择“更新并重启”立即安装。如果签名更新尚未准备好，请检查官方下载页面。

更新会锁定保险库并替换应用文件，同时保留已保存的信息。要手动更新，请运行新的官方安装程序，并保留现有安装位置。对于已签名的公开版本，请在 Windows 文件属性的“数字签名”中检查发布者。未签名的内部测试版本不是已签名的公开版本。SHA-256 是额外的完整性检查方式。

从 Bossanova 0.1.41 起，在 Windows 上卸载应用会退出登录。如果保留了保险库，请在重新安装后登录同一账户，并使用主密码打开保险库。卸载默认会保留保险库数据。在 Windows 卸载程序中选择删除数据，也可能删除保险库。外部备份不受影响。迁移到新 PC 时可使用同一 Wi-Fi 内的导出与导入，也可恢复外部备份。

更新将在后台准备，不会发送保险库内容或账号信息。

Get-FileHash .\Bossanova-Setup.exe -Algorithm SHA256

请勿删除保险库数据文件夹。如果签名或校验和不匹配，请勿运行该文件；请检查官方发布状态。

遇到问题时

如果应用无法打开，请检查 Windows 版本、x64 支持情况以及是否显示 WebView2 提示。在处理安全警告之前，请先检查官方下载页面上的发布状态和文件。
如果搜索结果为空，请检查锁定状态和查询词。如果无法添加数据或导入 .env，请检查套餐的数据上限（Free 为 10 个）和订阅状态。
如果缺少 AI 工具，请在设置 → AI 中确认该 AI 的连接开关已开启，然后开始新的对话。WSL 和 Windows 中的 AI 会分别列出，因此请连接您实际使用的那一个。Claude 应用和 ChatGPT 应用连接后需要重新启动，工具才会显示。
在设置 → AI 中打开连接，即可授权该连接，不会再显示单独的连接审批卡片。数据使用仍需单独授权。旧的待审批或已拒绝连接需要手动开启。收到 DENIED 时，请检查 reason、detail 和 connection。重新连接本身不会授予权限。
如果 AI 表示没有收到运行日志，说明命令输出了值。请在 AI 标签页的“最近运行”中查看已遮盖的日志，并修改命令使其不输出值。
使用 Schannel 的 Windows curl 会忽略 SSL_CERT_FILE。请在获准进程中用 --cacert 传入该路径。仅在撤销列表缺失或离线时使用 --ssl-revoke-best-effort，不要使用 --insecure。Windows gh 可考虑 WSL。AWS 请求签名需要 env、file 等合适载体。docker login 可由获准进程将 file 载体文件读入 --password-stdin。使用临时 DOCKER_CONFIG 并在结束后删除。
如果问题仍未解决，请发送错误文本、操作系统、应用版本和复现步骤以寻求帮助。请勿发送密码、保险库文件、机密值或连接令牌。

Bossanova 不会控制操作系统或其他程序。如果向 AI 授予管理员功能、文件、屏幕或内存等广泛权限，或者电脑已遭入侵，信息可能会通过其他途径泄露。详情请参阅机密保护说明。

秘密保护指南联系返回顶部