使用
ZikaronDesk
留证基础设施
交给有云端电脑的 AI Agent，它会自己装好。
交给你电脑上的 AI Agent，它会带你装好客户端，打开一次之后不必再开。
需要 Apple 芯片的 Mac，macOS 11 或更新的版本。
需要 x86_64 的 Windows 10 或 11。
需要 x86_64 的 Linux，glibc 2.31 或更新（Ubuntu 20.04、Debian 11 起）。其他架构从源码构建。
简单上手
- 复制提示词上面的按钮一次复制全文。
- 交给 AI Agent云端电脑上的、或你电脑上的 AI Agent 都行，提示词各有一份。它会照着装好，进入可用状态。
- 和它对话往它给你的地址充一点 ETH 付 gas，之后用平常的话让它做事。
把这份合同记一条存证。
采购合同-v3.pdfPDF · 238 KB记好了：第 12 条，内容指纹 0x3fa9…c2e1。等你说上链时一起发。
把今天记的几条一起上链。
第 12 到 14 条装进一笔交易发出，已经进了第 26,214,903 块。交易 0x8c1e…77a0，费用 0.00041 ETH。
这张插画授权给 0x7d2e…19b4 商用，期限一年。
小树.png授权签好写进账本了，把下面的授权码转给对方就行。
授权码zikaron-grant:eyJhdXRob3IiOiIweDNiZTYiLCJib2R5Ijp7Imdy…Q2Rk4xR2VrM3dVc19sQ0这张插画现在授权给了哪些人？
两份：给 0x7d2e…19b4 的商用授权，到 2027-10-21，有效；给 0x51ac…e0f3 的展示授权，9 月 30 日已到期。
提示词全文
ZIKARON 最简上手（给 AI agent）
1. 拉取并安装：从 https://github.com/kaptonia/zikaron 的 Releases 下载最新安装包，用 SHA256SUMS.txt 校验后安装。Linux 用：sudo DEBIAN_FRONTEND=noninteractive apt-get install -y -o Dpkg::Options::=--force-confold ./zikaron-desk_*_amd64.deb
2. 读说明：README.md（网络和合约地址）和 CLI-SCHEMA.md（命令用法）。装好后运行 zikaron contract，以它列出的子命令、参数和退出码为准。
3. 进入工作状态：
- 用户本机已经有 ZIKARON 桌面版的话，优先用 --home 或「经凭据操作」，私钥留在用户电脑上。
- 否则：zikaron keygen 生成私钥，存进 600 权限的文件，绝不显示；问用户要不要把这个私钥文件交给他保管一份，要的话以文件交付，不贴进聊天，并提醒他存到离线的地方；然后 zikaron init 建账本；请用户往这个地址充一点 ETH 付 gas。
4. 日常：history --file 记录 → anchor 上链 → scan 后 audit 核验；要分享就 kit-export 导出记录包，对方用 kit-verify 核验；要只给对方看，kit-export 加 --to-key <公钥>(或 --to <地址> 并给 --endpoint)；kit-verify 加 --originals-to <文件夹> 取出原件。几条记录攒在一起上链，一笔交易只付一次 gas。
5. 升级：定期查看 Releases。有新版本时，先读发布说明和 CHANGELOG 里的「升级」一节，再用 SHA256SUMS.txt 校验，然后照第 1 步覆盖安装。命令行的账本目录跨版本照常读写。发布说明要求手工迁移的话，先告诉用户，得到同意再动手。升级后运行 zikaron contract，确认命令有没有变化。每次升级时提醒用户下载一份账本备份（把账本目录打包成一个文件交给用户），并和用户约好以后定期备份。
6. 用户想换用更安全的桌面版时，一步一步带用户做：
- 打开下载页 https://kaptonia.github.io/use.html，按用户的系统下载，先核对 SHA-256 再安装。Mac 第一次打开前要去掉隔离标记，下载页有可以照抄的命令。
- 第一次打开：设口令，把助记词抄在纸上，放在离线的地方。助记词只由用户自己保管，不要让用户发给你。
- 把这本账带进桌面，二选一：
· 把私钥交给用户，让用户在桌面版「导入密钥」，再用「收编已有账本目录」收进来。收编后，原目录由桌面接管。
· 用 hand-over 把账本写成交接件交给用户，用户在桌面一侧 take-over 收下，之后账本在两处之间轮流写。
- 之后请用户在「设置 › 命令行与 AI 控制」打开「经桌面 App 操作」或「经凭据操作」，你改用 --home 或凭据工作，云端的私钥文件随后删掉。
7. 规矩：私钥和助记词不进聊天和日志；一本账同一时间只能有一处写，换地方写用 hand-over / take-over。ZIKARON 最简上手（给本机的 AI agent）
1. 装客户端：问用户电脑上有没有装 ZIKARON 桌面版。没装的话，带用户从 https://kaptonia.github.io/use.html#desktop 下载，核对 SHA-256 后安装。
2. 第一次打开，一步一步带用户做完这几件事，之后客户端就可以关掉，不必再开：
- 设口令，把助记词抄在纸上，放在离线的地方。助记词和口令只由用户自己保管，不要让用户发给你。
- 在「设置 › 命令行与 AI 控制」打开「启用 zikaron 命令」。
- 在同一页「自动控制等级」里打开「经凭据操作」：输口令，有效期由用户自己选，也可以选「不过期」，按「打开」。
- 告诉你「设置 › 本机数据」的「详细信息」里「数据目录」那一行的路径。
- 关掉客户端。
3. 开始工作：运行 zikaron contract，以它列出的子命令、参数和退出码为准，细节读仓库里的 CLI-SCHEMA.md。写账本的命令都带 --ledger "<数据目录里的 ledger 文件夹>"，不带 --key、--key-file 或 --home；上链用 zikaron anchor --ledger "<同一个文件夹>"。私钥一直在客户端的密钥库里，你不生成也不保管私钥。
4. 日常：history --file 记录 → anchor --ledger 上链 → audit 核验；要分享就 kit-export 导出记录包，对方用 kit-verify 核验；要只给对方看，kit-export 加 --to <地址> 或 --to-key <公钥>；kit-verify 加 --originals-to <文件夹> 取出原件。几条记录攒在一起上链，一笔交易只付一次 gas。地址里的 ETH 不够付 gas 时，请用户充一点。
5. 什么时候才需要再开客户端：
- 答 E_CREDENTIAL_EXPIRED 或 E_CREDENTIAL_MISSING：凭据到期了或被关掉了，请用户打开客户端，重新打开「经凭据操作」。
- 有新版本：提醒用户安装，照发布说明升级，要手工迁移的先说明，用户同意再动手。
- 每次因为上面两件事打开客户端时，顺手提醒用户做一次整机备份。
6. 规矩：私钥、口令和助记词都不进聊天和日志；答 E_HOME_HELD 时说明客户端正在写入，稍后再试；一本账同一时间只能有一处写，换地方写用 hand-over / take-over。密钥与升级
- 云端电脑上，AI Agent 用一把专用的密钥写账本，地址里只放够付 gas 的少量 ETH。
- 你电脑上，私钥留在客户端的密钥库里，AI Agent 凭「经凭据操作」的凭据工作。有效期由你自己选；这台电脑上以你的系统账户运行的程序都能用上这份凭据，用不着时到「设置 › 命令行与 AI 控制」关掉。
- 想让私钥留在自己电脑上，装上，再让 AI Agent 经「经凭据操作」或 --home 替你做。提示词第 6 条写了它怎样一步步带你换过去。
- 新版本发布时，AI Agent 照提示词第 5 条自己校验并升级。
全部文件
发布清单：SHA256SUMS.txt · 第三方许可：THIRD-PARTY-LICENSES-macos.txt
发布清单：SHA256SUMS.txt · 第三方许可：THIRD-PARTY-LICENSES-windows.txt
发布清单：SHA256SUMS.txt · 第三方许可：THIRD-PARTY-LICENSES-linux.txt
安装
- 核对 SHA-256，结果应与下方「核对」里列出的一致：
shasum -a 256 ~/Downloads/ZIKARON-0.1.5-macos-arm64.dmg - 在「终端」里去掉下载时系统加上的隔离标记：
xattr -d com.apple.quarantine ~/Downloads/ZIKARON-0.1.5-macos-arm64.dmg这一步在打开 dmg 之前做。
- 打开 dmg，把 ZIKARON.app 拖进「应用程序」，再打开它。
已经先拖进去了的，改为运行这一条：
xattr -dr com.apple.quarantine /Applications/ZIKARON.app命令行 zikaron 在应用包内：ZIKARON.app/Contents/MacOS/zikaron。要在终端里直接敲 zikaron，打开应用「设置 › 命令行与 AI 控制」的「启用 zikaron 命令」：它在 /usr/local/bin 放一个链接，需要时 macOS 弹出自己的管理员口令框。
- 核对 SHA-256，结果应与下方「核对」里列出的一致：
shasum -a 256 ~/Downloads/ZIKARON-0.1.5-macos-arm64.pkg - 在「终端」里去掉下载时系统加上的隔离标记：
xattr -d com.apple.quarantine ~/Downloads/ZIKARON-0.1.5-macos-arm64.pkg这一步在双击安装之前做。
- 双击安装。
安装程序把应用装进 /Applications，把命令行装到 /usr/local/bin/zikaron，装完即可在终端里敲 zikaron。
命令里的路径按你实际下载的位置改。
为什么有这一步：应用由 Kaptonia 的自签证书签名，在 Apple 公证之外发出。从浏览器下载的文件带着 macOS 的隔离标记，系统会拒绝打开；在较新的 macOS 上，「系统设置 › 隐私与安全性」里的「仍要打开」时常失灵。先核对文件，再去掉隔离标记，就是向系统确认你信任这份核对过的文件。
升级时，用新版覆盖安装即可，0.1.4、0.1.3 的机器目录与数据目录照用。从 0.1.2 或更早的版本升级，早先版本的账本照下面几步带过来：先在旧版里「导出账本镜像」到机器目录之外的文件夹，然后退出；把旧的机器目录 ~/.zikaron-desk.d/ 连同指针文件 ~/.zikaron-desk 一起挪开；启动本版，设口令，用同一组助记词导入身份；向导走到「创建账本」时点「收编已有账本目录」，选镜像里的 author 文件夹，按「原位收编」；最后在账本页跑一趟账本检查，看它答「正常」。
- 在 PowerShell 里核对 SHA-256，结果应与下方「核对」里列出的一致：
Get-FileHash ~\Downloads\ZIKARON-0.1.5-windows-x86_64.zip -Algorithm SHA256PowerShell 用大写字母显示，比对时不分大小写。
- 解压到任意文件夹，双击 zikaron-desk.exe。
不用安装，程序自带运行库。命令行是同一文件夹里的 zikaron.exe，要在终端里运行：在文件夹空白处按住 Shift 再右键，选「在终端中打开」（Windows 10 为「在此处打开 PowerShell 窗口」），输入 .\zikaron.exe 加动词和参数。在资源管理器里双击它，只会一闪而过。
- 首次打开时如果提示「Windows 已保护你的电脑」，按「更多信息」，再按「仍要运行」。
命令里的路径按你实际下载的位置改。
为什么有这一步：程序没有签名。Windows 11 开着「智能应用控制」时，未签名的程序会被直接拦下，没有「仍要运行」，也不能单独放行这一个程序；要用就先在「Windows 安全中心 › 应用和浏览器控制 › 智能应用控制设置」里把它关掉。
本机数据在 %LOCALAPPDATA%\ZIKARON\，与解压的文件夹分开存放。开始菜单项与桌面快捷方式要自己加；要在任何终端里直接敲 zikaron，打开应用「设置 › 命令行与 AI 控制」的「启用 zikaron 命令」，它把命令行所在的文件夹加进本用户的 PATH。升级时，用新版的文件夹替换旧的，0.1.4、0.1.3 的机器目录与数据目录照用。从 0.1.2 或更早的版本升级，早先版本的账本照下面几步带过来：先在旧版里「导出账本镜像」到机器目录之外的文件夹，然后退出；把旧的机器目录 %LOCALAPPDATA%\ZIKARON\.zikaron-desk.d\ 连同指针文件 %LOCALAPPDATA%\ZIKARON\.zikaron-desk 一起挪开；启动本版，设口令，用同一组助记词导入身份；向导走到「创建账本」时点「收编已有账本目录」，选镜像里的 author 文件夹，按「原位收编」；最后在账本页跑一趟账本检查，看它答「正常」。
- 核对 SHA-256，结果应与下方「核对」里列出的一致：
sha256sum ~/Downloads/zikaron-desk_0.1.5_amd64.deb - 安装：
sudo apt install ~/Downloads/zikaron-desk_0.1.5_amd64.deb用于 Debian、Ubuntu 及其衍生版。窗口程序是 zikaron-desk，应用菜单里也有；命令行是 zikaron，两者都装在 /usr/bin，装完即可在终端里敲 zikaron。
- 核对 SHA-256，结果应与下方「核对」里列出的一致：
sha256sum ~/Downloads/ZIKARON-0.1.5-x86_64.AppImage - 加上可执行权限，再运行：
chmod +x ~/Downloads/ZIKARON-0.1.5-x86_64.AppImage ~/Downloads/ZIKARON-0.1.5-x86_64.AppImage不用安装，打开的是窗口程序。系统没有 FUSE 时，在命令后面加 --appimage-extract-and-run。包里的命令行不能直接调用，要用命令行请装 .deb。
命令里的路径按你实际下载的位置改。
两个包都没有签名，以 SHA-256 核对。系统的选档框经由桌面门户，需要装 xdg-desktop-portal 和一个后端，如 xdg-desktop-portal-gtk；没有门户时，可以把文件直接拖进窗口。拖放要经 X11：有 X 显示时（包括 Wayland 桌面上的 XWayland）照常可用，没有 X 显示的纯 Wayland 会话收不到拖进来的文件。
升级时，装新版即可，0.1.4、0.1.3 的机器目录与数据目录照用。从 0.1.2 或更早的版本升级，早先版本的账本照下面几步带过来：先在旧版里「导出账本镜像」到机器目录之外的文件夹，然后退出；把旧的机器目录 ~/.zikaron-desk.d/ 连同指针文件 ~/.zikaron-desk 一起挪开；启动本版，设口令，用同一组助记词导入身份；向导走到「创建账本」时点「收编已有账本目录」，选镜像里的 author 文件夹，按「原位收编」；最后在账本页跑一趟账本检查，看它答「正常」。
别的架构或发行版：按开发者指南 · 从源码构建构建。
核对
应用和 dmg 都由这张证书签名。装好之后在终端里查看，输出里的 Authority 应为 Kaptonia:
codesign -dvv /Applications/ZIKARON.apppkg 以 SHA-256 核对。终端里的更多核对方法，见开发者指南 · 校验。
程序没有签名，以 SHA-256 核对。解压出的文件夹里有 zikaron-desk.exe、zikaron.exe、LICENSE.txt 与 THIRD-PARTY-LICENSES.txt。终端里的更多核对方法，见开发者指南 · 校验。
两个包都没有签名，以 SHA-256 核对。把发布清单和下载的文件放在同一个文件夹，可以一次核对：
sha256sum -c --ignore-missing SHA256SUMS.txt终端里的更多核对方法，见开发者指南 · 校验。