快速开始
Persona 是本地优先的身份材料管理器：密码库是你设备上的一个加密 SQLite 文件，联网能力（同步、审计副本）全部是可选附件。本页带你从零跑起来。
两条使用路径
| 路径 | 适合 | 上手方式 |
|---|---|---|
| 桌面应用（主推） | 日常管理凭据，图形界面 + 浏览器扩展 + SSH Agent | 源码构建 deb 安装，或 dev 模式 |
| CLI | 脚本化、服务器环境、喜欢终端 | cargo build --workspace |
两者共用同一套本地密码库格式与加密体系，可混用。
桌面应用
构建与安装
bash
git clone git@github.com:cuihairu/persona.git
cd persona
pnpm install
# 可复现构建 deb（约 15–25 分钟，产物在仓库根）
scripts/build-repro.sh
sudo dpkg -i Persona_0.1.0_amd64.deb开发调试可直接跑 dev 模式：
bash
pnpm --filter desktop run dev构建细节与逐字节可复现口径见 REPRODUCIBLE_BUILDS.md。
首次使用
- 启动 Persona，创建密码库并设置主密码——主密码派生加密密钥， 库文件全程加密落盘。主密码丢失无法找回（没有后门），请牢记。
- 在主界面添加凭据（密码、API key、TOTP 等），敏感字段默认掩显。
- 锁定即断密钥：锁屏后主密钥不驻留内存，解锁需重新输入主密码。
CLI
bash
# 构建 CLI 与 SSH agent
cargo build --workspace
# 初始化加密工作区
persona init --path ~/Persona --yes --encrypted --master-password "你的主密码"
# 身份与凭据
persona add # 新增身份
persona list # 列出身份
persona switch <name> # 切换活跃身份
persona credential add --identity alice --name "GitHub" \
--credential-type password --prompt-secret
persona credential list --identity alice --format table
persona credential show --id <UUID> --reveal条目历史（1Password 风格）：每次增删改都带时间戳记录，可回溯。
身份到底是什么
"身份"是凭据的分组单位，不是账号也不是加密边界——切换身份不会换主密码、 不会重新解锁、不会改变加密层级。它同时是旅行模式打包的最小单位（整套带走）， 也是跨端共享的"当前身份"指针的载体。完整语义见 身份（Identity）。
备份（建议立刻做）
主库之外只有加密导出文件是补救手段——主密码丢失、库文件损坏均无其他 恢复途径。备份口令独立于主密码：
bash
persona export --encrypt --out vault-backup.persenc # 加密导出
persona import vault-backup.persenc --decrypt --mode merge --backup # 恢复自托管服务器用户还可用 persona backup push 把整库快照异地保管。 完整实操（含网盘冷备警告、恢复语义）见 STORAGE_AND_SYNC.md 的备份章节。
可选：多设备端到端加密同步
默认纯本地、零联网。要在多台设备间同步凭据：
- 自托管一台 Persona Server（Docker 镜像，服务器只见密文）；
- 桌面端「设置 → 同步设备」加入并逐台授权。
离线并发修改同一凭据不会丢数据（双版本保留，由你裁决）。部署步骤、 诚实边界与冲突裁决详见 STORAGE_AND_SYNC.md。