Wiki · Zikaron

AI 代理与远程操作

AI 代理能在终端里调用命令行，也能经 MCP 直接接入，替你做 Zikaron 的日常操作；把应用放在另一台机器上，还能远程去做。命令行的三种用法，各有一套做法。

经 MCP 接入

AI 代理支持 MCP（模型上下文协议）时，不用终端也能调用命令行。

复制配置。到「设置 › 命令行与 AI 控制」的「终端」一组，在「接入 AI 应用」一行按「复制配置」。配置里写着本机命令行的完整路径，用不着先打开「启用 zikaron 命令」。
贴进 AI 代理。把配置贴进 AI 代理的 MCP 服务器设置。
照常设开关。每次写入，开着「经凭据操作」即经凭据写，否则交给桌面写（桌面要开着并解锁），下面两节的做法照用；上链照「命令行上链」，选「自动发送」时会花这个身份的 gas。

写入的工具要给数据目录的完整路径。经 MCP，AI 代理能存证、授权、撤销、加注记、删除存证、导出与核验记录包、上链，以及做各种只读核验；生成密钥、移交账本与加价重发留在桌面或终端里做。

经桌面 App 操作时

AI 代理的命令交给你正在运行的桌面去执行。私钥和口令留在桌面里，AI 代理只递请求，它做的每件事，窗口里马上看得到。

接上终端。在「设置 › 命令行与 AI 控制」打开「启用 zikaron 命令」。同一页「自动控制等级」里的「经桌面 App 操作」默认开着。
打开并解锁桌面。左栏顶上选好身份和角色。AI 代理工作期间，桌面要一直开着、保持解锁。
找到数据目录。「设置 › 本机数据」的「详细信息」里，「数据目录」一行就是它的路径，告诉 AI 代理。
选上链模式。「设置 › 命令行与 AI 控制」「上链操作」里的「命令行上链」：选「自动发送」，AI 代理可以从头做到尾，费用从地址里直接付；选「仅加入队列」，AI 代理只管写，每一笔上链由你在桌面上确认。
关掉自动锁定。桌面按你的键盘和鼠标计算闲置时间，AI 代理的请求不算在内；闲置满「闲置时长」桌面就会锁上，通道随之关闭。要让 AI 代理一直工作，到「设置 › 身份密钥」关掉「自动锁定」，或把闲置时长调长。AI 代理做完后，按左栏「锁定」。

把下面这段交给 AI 代理，换上你的数据目录路径：

你可以用 ZIKARON 的命令行 zikaron 操作我的 Zikaron。
先运行 zikaron contract，它列出全部子命令、各自的参数和退出码。
要写进我账本的操作，每条命令都带 --home "<数据目录>"，交给正在运行的桌面去做。
每条命令在标准输出给一个 JSON 值，结论看退出码：
  0 完成；1 被拒或未通过；2 命令写错；3 部分结果，或已加入队列等我在桌面上发；4 没有答案，例如桌面没有作答、连不上节点。

AI 代理可以先做完好几件事，最后上链一次，让它们装进同一笔交易，只付一笔的费用。

经凭据操作时

AI 代理凭你在桌面上授权的一份限期凭据，直接写桌面托管的账本、发它的待上链队列；桌面关着、锁着都行，用的是桌面密钥库里的钥。

接上终端。在「设置 › 命令行与 AI 控制」打开「启用 zikaron 命令」。
授权凭据。同一页「自动控制等级」里打开「经凭据操作」，输口令，有效期按 AI 代理要工作的时长设，按「打开」。
选上链模式。同一页「上链操作」里的「命令行上链」，两种模式的意思同上。
找到账本文件夹。「设置 › 本机数据」的「详细信息」里「数据目录」一行，是这个身份这一角色的数据目录；把其中 ledger 文件夹的路径告诉 AI 代理。

把下面这段交给 AI 代理，换上这个路径：

你可以用 ZIKARON 的命令行 zikaron 操作我的 Zikaron。
先运行 zikaron contract，它列出全部子命令、各自的参数和退出码。
写账本的命令都带 --ledger "<账本文件夹>"，不带 --home、--key 或 --key-file。
上链：zikaron anchor --ledger "<账本文件夹>"，发这本账的待上链队列。
每条命令在标准输出给一个 JSON 值，结论看退出码：
  0 完成；1 被拒或未通过，例如凭据过期 E_CREDENTIAL_EXPIRED、桌面正在写 E_HOME_HELD(稍后再试)；2 命令写错；3 部分结果，或已加入队列等我在桌面上发；4 没有答案，例如连不上节点、交易还没入块。
凭据过期时告诉我。

桌面开着时，AI 代理写进的条目随即出现在窗口里。AI 代理做完，到「设置 › 命令行与 AI 控制」关掉「经凭据操作」，凭据即删。

纯命令行时

AI 代理用一把专用的密钥独立写一本账，用不着桌面；主机重启后照常工作，全程不用你管，地址里的钱不够时再充一点。重要的身份交给桌面托管，这里只用一把专用的钥。

在你自己的终端里运行 zikaron keygen，把私钥那一串存进一个只有这个用户能读的文件。
往地址里转一点 ETH，够付 gas 即可。
建好账本目录（zikaron init），把四样东西告诉 AI 代理：账本目录、私钥文件的路径、节点地址、登记合约地址（以太坊主网上是 0x36Ea8A857a5FE813429d4D9947000C644A88809A）。

把下面这段交给 AI 代理，换上这几样：

你可以用 ZIKARON 的命令行 zikaron 操作一本专用的 Zikaron 账本。
先运行 zikaron contract，它列出全部子命令、各自的参数和退出码。
写账本的命令都带 --ledger "<账本目录>" --key-file "<私钥文件>"。
上链：zikaron anchor --key-file "<私钥文件>" --endpoint 1=<节点地址> --form registry --registry <登记合约地址> --hash <条目编号>
  --hash 可以重复，一笔交易锚多条；记下写入时输出的条目编号，攒几条一起发。
每条命令在标准输出给一个 JSON 值，结论看退出码：0 完成；1 被拒或未通过；2 命令写错；3 部分结果；4 没有答案，例如连不上节点。
上链被拒时，把原因告诉我；余额不够就请我充值。

这把钥由 AI 代理使用，风险限于这本专用的账和地址里的 ETH。这本账日后可以用「导入密钥」和「收编已有账本目录」接进桌面；要让它在远程主机与你的电脑之间来回写，见交接账本。私钥文件的保管办法见明文的文件。

远程操作

把应用放在家里的一台迷你主机，或一台云主机上，AI 代理就能远程替你操作。命令行只和同一台机器上的同一个用户打交道，所以 AI 代理要在那台主机上执行命令：用这个用户经 SSH 登录进去，或者直接装在那台主机上。要处理的文件，也先放到那台主机上。

经桌面 App 操作: 主机要有图形界面：接上显示器，或开远程桌面。应用的窗口在 Windows 与 Linux 上要 OpenGL，在 macOS 上要 Metal；没有显卡的 Windows 或 Linux 主机得靠虚拟显示加软件渲染，先实测一次窗口能否打开。你经远程桌面打开应用、输口令、关掉自动锁定，之后日常交给 AI 代理。主机重启或应用退出后，要你再经远程桌面打开并输一次口令；选了「仅加入队列」时，上链的确认也经远程桌面来做。
经凭据操作: 图形界面只在授权时用一次：经远程桌面打开应用、输口令、打开「经凭据操作」。之后应用可以关掉，AI 代理经 SSH 运行命令，主机重启也照常工作，直到凭据到期；到期后再经远程桌面打开一次。
纯命令行: 主机用不着图形界面，也就省去了解锁与重启后重输口令，一台无界面的 Linux 就够。AI 代理经 SSH 运行命令，私钥文件放在主机上。

放在哪台主机上。经桌面 App 操作时，桌面解锁期间主钥在内存里；经凭据操作时，主钥封在主机磁盘上的凭据文件里；纯命令行时，私钥就在主机的文件里。云主机的厂商能从宿主机那一层读到虚拟机的内存与磁盘，放在云上就要信任厂商；家里自己的主机更稳妥。

安全

能以这个用户身份登录主机的人或程序，都能让桌面替你操作，或用上凭据，或读到那把专用私钥。SSH 只许密钥登录，主机开启全盘加密。
经桌面 App 操作时，关掉了自动锁定，就记得在 AI 代理做完、或你离开时按「锁定」。想让每一笔上链都经你确认，用「仅加入队列」。
凭据打开这台电脑上每个身份的数据目录，写条目、发上链交易、把账本移交给另一把钥都能做。有效期按需要设，用完就关；改口令不收回凭据，收回要关掉开关。整机备份里不带凭据。
重要的身份经桌面托管。纯命令行给 AI 代理的那把钥单独用，地址里只放少量 ETH。
同一本账任何时候只在一处写：交给远程主机写时，你自己的电脑上只用来看；要换一处写，用交接账本。
整机备份和私钥文件的副本，放在主机以外的地方。