~Alter 是一个个人身份协议，其命令行工具 cli 用于在协议上声明并管理一个属于自己的名称。名称以 ~ 开头（如 ~yourname），是一个地址，背后对应一份记录，记录内容来自用户实际做过的事情，而非用户自行填写或模型推测。
用途 该工具的核心用途是让个人拥有一个可被解析的身份名称，并围绕该名称控制他人可读取的信息、查看谁查询过自己以及每次读取产生的收益。名称在协议内所有支持该协议的工具中通用，无需重复设置或粘贴密钥。
主要能力
- 注册与持有名称：运行 alter register 选择名称并确认年满十八岁，本机花费数秒证明请求背后是真人，随后名称即存在。无需浏览器、密码、邮箱或银行卡。
- 属性级读取控制：通过 alter discovery preset 设置 minimal、recognition、open 等预设，并可用 alter discovery set 逐项调整；alter discovery preview 可在他人读取前预览调用者将收到的记录及价格。
- 连接数据来源：alter pair 支持 GitHub、GitLab、Discord、Mastodon、Bluesky、ORCID、Steam、Lichess、自有域名、Obsidian 库等，读取的是用户在这些来源的实际行为，且数据不归属于来源，离开来源后仍保留。
- 查询与收益记录：alter queries 显示谁查询、支付了多少、自己保留了多少；alter earnings 显示余额。读取他人记录需付费，费用归被读取者。
- 代理接入：alter wire 可发现本机已安装的 AI 工具并将其接入身份轨道，代理以用户名称行事，其行为会出现在 alter queries 中。
- 本地审计与检查：alter audit 读取本机并打印 ~Alter 可能获知的信息后停止，不发送、不创建任何内容；alter doctor loom 在无网络情况下检查文件夹中的密钥、编码问题和失效链接。
- 其他命令：alter ask 按情境而非姓名查询，每次 1.00 美元；alter verify 免费验证某人是否存在；alter status 显示六步进度；alter consent revoke 撤销访问；alter wallet register 注册提现钱包。
使用方式 安装方式包括：macOS/Linux/WSL 的安装脚本、Windows PowerShell 脚本、Homebrew、Arch Linux AUR（truealter-cli）、npm（包名 @truealter/cli，需 Node 20 或更新）。安装器在机器无 Node 时自带 Node，不通过 sudo 运行，不创建账户、不发送数据。安装后运行 alter 打开菜单，按六步流程操作：alter audit 本地审计、alter register 注册、alter discovery preview 预览、alter pair 配对来源、alter discovery enable 使名称可解析、alter queries 查看查询、alter earnings 查看余额。
适用场景 适用于希望拥有独立于平台登录的身份名称、控制个人数据读取权限、从被读取中获得收益、以及让本机 AI 代理以本人身份行事的个人用户。也适用于团队、工会、俱乐部等集体以相同方式持有记录并为其成员背书。
限制 注册免费，但读取他人记录需付费；提现需满足两个条件：确认邮箱并注册提现钱包，且提现需达到 Augmented 级别（四级中的第三级）。名称的根种子（root seed）由本机生成并仅显示一次，服务器不保存，无法代为补发。安装器拒绝以 root 运行。源代码在独立分支由自动化编写，不接受针对该分支的拉取请求。安全报告应发送至 security@truealter.com，而非公开 issue。许可证为 Apache-2.0。
