开发者文档

SNX 文件格式规范

SNX 是 DeepSeal 的标准加密文件格式，基于 JSON 结构，完全开放可解析。文件扩展名为 .snx。

SNX 文件结构：

{
  "version": "1.0",
  "algorithm": "AES-256-GCM",
  "kdf": "PBKDF2-HMAC-SHA256",
  "kdf_iterations": 100000,
  "salt": "<base64-encoded 128-bit salt>",
  "encrypted_dek": "<base64-encoded DEK ciphertext>",
  "nonce": "<base64-encoded 96-bit nonce>",
  "ciphertext": "<base64-encoded note ciphertext>",
  "tag": "<base64-encoded 128-bit auth tag>",
  "metadata": {
    "created_at": "2026-06-25T10:00:00Z",
    "notebook": "Personal"
  }
}

字段说明：

• version：格式版本号，当前为 "1.0"
• algorithm：数据加密算法，固定为 "AES-256-GCM"
• kdf：密钥派生函数，固定为 "PBKDF2-HMAC-SHA256"
• kdf_iterations：KDF 迭代次数，固定为 100000
• salt：Base64 编码的 128-bit 盐值
• encrypted_dek：由 KEK 加密的 DEK 密文（Base64）
• nonce：96-bit 随机 Nonce（Base64）
• ciphertext：笔记明文经 AES-256-GCM 加密后的密文（Base64）
• tag：128-bit GCM 认证标签（Base64）
• metadata：可选的元数据字段，不包含敏感信息

命令行工具

DeepSeal 提供命令行工具 deepseal-cli，支持加密、解密、导出和列表操作。

加密笔记

$ deepseal-cli encrypt \
  --input note.md \
  --output note.snx \
  --password "your-password"

解密笔记

$ deepseal-cli decrypt \
  --input note.snx \
  --output note.md \
  --password "your-password"

导出所有笔记

$ deepseal-cli export \
  --format snx \
  --output ./backup/ \
  --password "your-password"

列出笔记

$ deepseal-cli list \
  --notebook "Personal"

未来 API 路线

DeepSeal 计划在 2027 年推出 REST API，面向团队版用户，支持以下能力：

• 团队密钥策略管理
• 用户角色与权限控制
• 审计日志查询
• 批量加密/解密操作

REST API 当前处于规划阶段，尚未发布。关注 路线图 获取最新进展。