帮助文档

开发者工作流

编程时怎么用 Nokuo 录入、导入、导出、复制和使用开发资源。

不只是存起来

密码管家把开发资源塞进"安全笔记"的文本框 - 一个标题、一坨内容,没有字段,没有结构。Nokuo 不一样:录入、导入、导出、复制、使用都为开发者而建。

结构化录入

每类资源有自己的字段模板,不是一坨文本:

  • API Key:key、secret、有效期、权限范围
  • 数据库:host、port、db、user、password、sslmode
  • SSH:私钥、端口、用户、主机地址
  • 代码片段:语言、标签、内容

按字段录入,就能按字段检索和复制。不用在一段文本里找哪个是密码、哪个是端口。

开发工作台中的结构化资源预览

批量导入

导入不是单一路径,而是几条入口合在一起。最常用的是工作区包、官方模板、密码库 CSV、结构化配置文件和直接粘贴识别。

1. 先选择导入来源

导入向导里先选入口,再决定后面的解析方式。

导入向导的来源选择页

2. 读取配置文件或模板文件

.env、JSON、YAML、SSH Config、官方 CSV 模板和 XLSX 模板都先经过文件读取,再进入解析。

配置文件导入选择文件页

3. 确认识别结果并处理重复项

系统会把文件内容解析成字段卡片;如果命中已有条目,会在审阅页提示重复和覆盖风险,导入前可以逐项确认。

导入审阅页

4. 执行导入

确认后直接执行,导入完成会给出新增、更新和跳过的统计。

导入完成页

5. 粘贴一段配置

零散配置不必先整理成文件,直接粘贴即可识别。

适合数据库连接串、SSH 配置、JSON、YAML、.env 和私钥片段。

粘贴识别输入页 粘贴识别结果页

单个配置复制

每张配置卡右上角都有复制菜单,先选当前条目的输出格式,再直接复制到剪贴板。

单个配置的复制菜单

常见格式包括:

  • 数据库:连接串、.env 片段、JSON。
  • SSH:SSH config、SSH 命令、.env 片段、JSON。
  • API Key、AI 配置、网站、面板、账号、对象存储:.env 片段或 JSON。
  • 代码片段、证书、DevAccess:纯文本、YAML、.env 或 JSON。

这一层是“按单条配置复制”,不是“整组导出”。

按项目导出

项目级导出从工作台顶部的“导出环境变量”进入,面对的是整个项目的配置聚合,而不是单个条目。

1. 打开导出面板

导出面板会先汇总当前项目里所有可导出的配置。

2. 选择输出格式

在 .env 和 Docker Compose 之间切换;.env 里还能选择是否按配置分组。

导出环境变量页

3. 复制或保存文件

可以直接复制整段结果,也可以在桌面端保存成文件。Docker Compose 模式会输出 environment: 块,方便放进 compose 配置。

工作区包迁移

如果你要迁移整个开发工作台,而不只是导出某个项目,可以使用“工作区包”。

  • 导出工作区包:生成 dev-workspace-package.json,包含元数据和整个工作区数据。
  • 恢复工作区包:导入 JSON 后会先显示项目数和条目数,再执行覆盖式恢复。
  • 这条线适合整包备份、换设备或迁移,不适合单个条目的复制。

为使用而组织

  • 按项目分组:每个项目一个分组,相关资源放一起。
  • 类型筛选:只看 API Key、只看数据库、只看 SSH。
  • 标签:跨项目打标签(如 production、staging)。
  • 快速检索:按名称、字段值或标签搜索。
  • 最近使用:快速回到刚用过的资源。
  • 资源模板:新建资源时套用字段模板,不用每次从头填。

日常节奏

桌面端工作流围绕"用的时候解锁,用完即锁"展开:

  1. 解锁 Vault:用主密码在桌面端解锁本地 Vault。
  2. 检索资源:按项目、类型或标签快速定位。
  3. 复制使用:按字段复制到终端、编辑器或 CI 配置,用完即弃明文。
  4. 用完即锁:离开时锁定 Vault,敏感内容不留在剪贴板和内存。
桌面端解锁页

安全习惯

  • 离开座位前锁定 Vault。
  • 复制敏感内容后尽快清空剪贴板。
  • 不要把明文密钥贴进聊天记录或文档,从 Vault 取用即可。
  • 定期检查哪些资源已经不再使用,及时清理。

本页目录