~Alter Identity

~alter CLI

认领一个属于你的名称，并在有人阅读时获得收益

什么是 ~alter？ · 安装 · 前五分钟

运行 alter register，选择一个名称，并确认你已年满十八岁。你自己的机器只需几秒钟，就能证明请求背后确实有一个人，然后 ~yourname 就创建好了。

就在运行这条命令前一秒，这个协议上还没有你；运行之后，就有了一个属于你的身份。没有打开浏览器，没有设置密码，没有询问电子邮件地址，也没有收取银行卡信息。

~alter 就是这个名称所指向的内容。~yourname 是一个地址，其背后保存着你实际做过的事情的记录。下面的每条命令都会读取或写入其中的一部分，而任何其他使用该协议的对象都会将同一个地址解析为同一份记录。

这一步就这么简单，也是这里其他一切的起点。你在这台机器上接入的 Agent 会以这个名称行事，因此它们替你做的事情也会归属于你。任何想了解你更多信息的人，都必须按照你预先设定的条款付费；alter queries 会列出每项查询，以及你保留了什么。

整个技术栈中，没有其他东西能让名称从无到有。网站阐述其理念，运行时会在你自己的机器上保留一个已知的句柄，而 SDK 会从你编写的代码中读取句柄。它们都以一个已经存在的名称为起点，而这条命令会创建名称。

Go to truealter.com, find the genesis and the origin
papers, and read all of them. Then start a discussion
with me in my own language, no jargon.

Ask me one question at a time and wait for my answer.
Follow what I am curious about, not the order the site
is written in.

Do not only read the pages. Connect to their interface
directly and call get_started. That tells you where I am
and what comes next, and we work the rest of this from
there.

If I have a ~handle I will give it to you. If I do not
and I decide I want one, set it up with me here.

What I want to understand is what ~Alter is, how it
applies to me, and what it means for everyone else. Find
me somewhere in it, and not the version written for
people who work in technology. Find the life nearest
mine and walk me through it, including what it would
cost me.

Try to prove them wrong. Go and find where they show
their working, and if something is unclear or does not
hold up, say so.

一个二进制文件，里面的每条命令都以你自己的名义运行。无需粘贴任何内容，也不用在不同机器之间携带密钥，整个过程不需要打开浏览器。

它涵盖六件事：持有属于你的名字并确保其安全；逐项决定谁可以读取你的信息；连接读取你行为数据的来源；查看谁查找过你，以及每次读取为你带来了多少收入；以你的名义运行 Agent，让它们的行为也归于你名下；当你不知道谁能认识某个人时，向这个领域询问此人。

其中两件事完全不需要账号。alter audit 会读取这台机器，打印 ~Alter 能从中了解到的信息，然后停止。alter doctor loom 会检查一个文件夹中的机密信息、错误编码和损坏的链接，不会联网。这两项都可以在你做任何决定之前运行。

本页其余内容介绍安装方法和最初五分钟的操作。

安装

无需预先进行任何设置。如果机器上没有 Node，安装程序会自带 Node。选择与你正在使用的 shell 对应的命令。

macOS、Linux 和 WSL

curl -sSf https://truealter.com/install.sh | bash

Windows PowerShell

irm https://truealter.com/install.ps1 | iex

安装后会在你的机器上添加什么

安装会添加四样东西。本节其余部分会说明不会添加什么。

• alter 命令，即全局安装的 npm 包 @truealter/cli。
• 一个位于你的 PATH 中的目录，这样你打开的每个 shell 都能使用 alter。
• 仅当这台机器上没有 Node 时才会安装 Node。macOS 和 Linux 会下载官方构建版本，根据 nodejs.org 发布的校验和进行校验，然后解压到 ~/.local/share/alter/node。Windows 会通过 winget 安装 Node LTS；如果没有 winget，则使用 Chocolatey。机器上已有的 Node 会保持原样。
• 安装程序本身的校验和，分别位于 install.sh.sha256 和 install.ps1.sha256，方便你在运行脚本前检查它。

整个过程不会以 sudo 运行。安装程序拒绝以 root 身份运行，因为这样 Node、npm 和 alter 都会归 root 所有，你将无法运行该命令。macOS 会要求输入一次密码，以便将二进制文件链接到 /usr/local/bin；两个平台上的其他操作都不需要管理员权限。所有内容都只会安装在你的主目录中。

安装不会创建账号，也不会发送任何内容。安装完成后，~Alter 尚未读取任何与你或这台机器有关的信息。第一个会读取信息的命令是 alter audit，而且它只在本地读取。第一个会创建内容的命令是 alter register，且只有你亲自运行它才会创建。

brew install true-alter/tap/alter

yay -S truealter-cli

npm install -g @truealter/cli

单独运行 alter。

菜单会显示开启收益所需的四个命令。

之后只需记住一个命令。今天开始操作，中途被打断，下周回来时不记得还剩什么步骤，运行 alter status 就会告诉你当前处于六个步骤中的哪一步，以及接下来该做什么。这六个步骤就是下面的各节。

在创建任何内容之前，先读取自己的机器

运行 alter audit。

你还没有做任何决定，想先看看它会从自己的机器上读取什么。它会读取这台机器，打印出 ~Alter 能从中了解到的内容，然后停止。不会发送任何内容，也不会创建任何内容。

此时关闭终端，你就完全回到了起点。

1. 注册并领取句柄

运行 alter register。

免费，无需账户、银行卡或申请。如果这个句柄已经属于你，请改用 alter login。

不会打印任何需要你记下的内容。系统会认领该句柄，将成员凭据签发到这台机器上，并为你保存会话。值得妥善保管的秘密是根种子，它由 alter key device register 签发，并且只会在签发时显示一次。运行 alter key seed export 可在这台机器上再次查看，运行 alter key seed import 可将它导入新机器。服务器不会保存它，因此没有人能为你重新签发。

2. 预览调用者将获得的记录

先运行 alter discovery preview。

假设你愿意因自己从事的交易而被找到，但不想因其他任何事被找到。此命令会按调用者收到的方式打印你的记录，并显示本次读取的价格，而且此时还没有人能够进行读取。

alter discovery preset recognition 用于设置各级别。共有四个级别，并且会逐项属性生效。

minimal、recognition 和 open 是三个起始预设；alter discovery set 可将某个属性调整到你所选预设之外的级别。

3. 连接你已在使用的平台

运行 alter pair。

不带其他参数运行时会显示菜单。GitHub、GitLab、Discord、Mastodon、Bluesky、ORCID、Steam、Lichess、你拥有的域名，以及 Obsidian 知识库都可以连接。指定一个平台，例如 alter pair github，即可跳过菜单。无论采用哪种方式，都不会打开浏览器，而是提供一个供你输入的代码。

你已经在某处开展工作。返回的内容是你在那里做过的事，而不是你对自己的描述。它们不属于源平台，因此即使离开源平台，也会保留下来。使用 alter connections 列出连接，使用 alter pair status 查看各连接返回的内容，并使用 alter unpair <id> 删除连接。

4. 让句柄可解析

运行 alter discovery enable。

运行此命令之前，你的句柄完全无法解析。运行之后，调用者只能获得第 2 步允许显示的内容。运行 alter discovery disable 即可退出，同时保留设置。

5. 每次读取，都附带价格

运行 alter queries。

你没有申请任何内容，却有人查阅了你。是谁发起的、支付了多少、你得到了多少。这是完整的日志，而不是摘要，而且你可以免费读取。任何人对你的访问都可以通过 alter consent revoke 从此终止。

6. 余额，以及开放提现所需的两件事

运行 alter earnings。

无论你现在能否提现，余额都会增加。满足两项条件后即可提现，菜单中的准备状态行会显示每项条件的进展。

你必须确认电子邮件，因为针对未确认地址的查询不会产生任何收益；此外，还必须通过 alter wallet register 注册收款钱包。达到四个级别中的第三级 Augmented 后，即可提现；在此之前，余额会持续累积。

接入这台机器上已有的 Agent

运行 alter wire。

你每天都会用到其中一个，也不想每次打开它时都解释自己是谁。它会查找安装在这里的 AI 工具框架，并将它们逐一接入网络。此后，Agent 以你的名义执行的操作都会带上你的标识，并像其他读取记录一样出现在 alter queries 中。

https://mcp.truealter.com/api/v1/mcp

npm update -g @truealter/cli

本仓库是已发布命令行工具的公开存放处，npm 发布也在此进行。源代码会由自动化写入单独的分支，因此无法接受针对该分支的拉取请求。 请通过问题联系我们。 安全问题请发送至 [email protected]，切勿提交公开问题；详情请参阅 SECURITY.md。 采用 Apache-2.0 许可证，详见 LICENSE。