Indiana CLI

安装包由 Indiana 官网公开提供。macOS/Linux 推荐 curl 安装：依赖已包含在下载中，安装过程不调用 npm、不需要 npm 账号或 sudo。请先安装 Node.js 22 或更高版本；当前安装包不包含 Node.js 运行环境。

curl 支持 macOS arm64/x64，以及 Linux arm64/x64 的 glibc/musl 环境。脚本自动选择系统与架构并校验 SHA-256，默认安装到 ~/.local/bin/indiana，版本文件放在 ~/.local/share/indiana/releases；请按上例将 ~/.local/bin 加入 PATH。可用绝对路径 INDIANA_BIN_DIR、INDIANA_INSTALL_ROOT 修改位置。重复执行 curl 命令即可升级，脚本不会覆盖非本安装器管理的已有命令。安装包及校验记录见 https://tinker.cash/downloads/cli/portable.json。

也可以使用 npm，Windows 请使用这一方式。以下命令从官网下载 CLI，再从 npm 公共仓库安装依赖；不需要代码仓库权限或 npm 账号。

0.3.3 起支持更新检测和 indiana update。交互终端中的成功命令每天最多查询一次官网版本，有新版时提示升级；检查最长 1.5 秒，离线不影响命令结果。JSON、CI、非交互、help 和 version 不触发提示。INDIANA_NO_UPDATE_CHECK=1 可关闭自动检测，update --check --json 可主动检查。升级校验下载文件和安装后的版本，保留 curl 自定义目录或 npm 全局安装位置，以及配置和登录凭据。更新源固定为官网，不受 --server 影响。

已安装 0.3.2 或更早版本的用户，请先执行一次本页 curl 或 npm 安装命令升级到 0.3.3；之后即可收到新版本提示并直接运行 indiana update。源码或无法识别的安装方式会给出安装指引。

curl 默认安装的卸载：删除 ~/.local/bin/indiana 和 ~/.local/share/indiana；配置和登录凭据仍会保留。npm 安装的卸载：npm uninstall -g @indiana/cli；也可重新执行本页当前版本安装命令升级。npm 包元数据见 https://tinker.cash/downloads/cli/latest.json。公开安装不扩大账号权限，管理操作仍需登录并审批授权。

设置目标服务地址和已有 Organization／App 的 ID，运行 doctor 检查连接与登录配置。登录时选择所需的 Account、Organization、App 或 Environment 授权；context use 保存当前选择，访问范围由账号与审批结果决定。

config init 创建 indiana.config.json，不覆盖已有文件。作用域优先级为显式参数、项目配置、所选 profile；context use 更新已有项目配置，否则更新 profile。配置可提交，但不要写令牌或 SDK Key。用 INDIANA_CLI_CONFIG_DIR 更改用户配置目录。

• CLI 打开系统浏览器，以现有控制台账号登录并确认 OAuth 身份授权。
• 浏览器再显示本设备请求的 App、环境和权限。核对设备说明与请求范围后确认。
• CLI 等待审批通过，随后保存凭据。待审批请求有效期为 10 分钟，管理授权有效期为 30 天；刷新令牌不延长授权期限。

默认登录只请求 project.read。需要资源读取时，在登录命令中显式加入 --permissions project.read,coupons.read,rewards.read；写入另需对应的 customers.write、features.write、plans.write、platform.write 等资源权限。只请求本次工作所需权限，现有授权不会自动扩大。

登录需要浏览器，并临时监听本机 http://127.0.0.1:43187/callback。端口被占用时先释放端口再重试。

CLI 使用控制台账号登录，自动刷新已保存的登录凭据。账号、成员资格或设备授权失效后需重新登录。不支持用浏览器 Cookie、SDK Key 或 CI 服务账号登录。

凭据默认写入系统凭据库，并绑定管理 origin、profile、issuer、客户端、用户和会话。系统凭据库不可用时明确失败，不会自动回退到文件。仅 POSIX 系统可显式选择 --credential-store file，目录权限为 0700、文件权限为 0600；Windows 不支持此文件模式。

whoami 返回服务端核验过的身份与授权范围，不显示 token。没有本地凭据时 logout 直接成功；有凭据时先确认服务端已撤销本设备的准确授权，再删除本地凭据。网络失败时保留凭据并报告撤销未完成。logout --local 仅清理本地，服务端授权仍可能有效。在所选管理服务的 /cli/sessions 页面可逐设备查看和撤销；撤销一台设备不影响其他设备。

operations describe 的 requiredPermissions 列出完整权限依赖。Customer 创建还需要 plans.read、features.read；Feature 修改需要 plans.write、balances.read；Product 写入还需要 features.read、customers.read、balances.read、rewards.read。缺少依赖时在写入前明确拒绝，避免遗漏默认 Product 或既有引用。

customer-create.json 内容为 { "input": { "externalUserId": "user-42", "name": "Alex" } }；更新文件为 { "requestId": "<新 UUID>", "patch": { "name": "Alex Updated" } }。App/环境从已审批选择解析，冲突值会被拒绝。设计操作继续使用控制台当前 DTO，并保留 revision、requestId 和发布校验。

查询参数使用可重复的 --query key=value，例如 features list --query id=<feature-uuid>。--file - 从 stdin 读取。call <operationId> --input envelope.json 接收 {params,query,body}，只能选择目录内操作，不能指定任意 URL 或 RPC。--input 不与其他输入参数混用。

需要扩大权限时先 logout，再按本次操作所需资源重新 login --permissions；已有设备授权不会自动扩大。--out <新文件> 以 0600 权限保存 JSON，不覆盖已有文件；失败时删除本次未完成输出。写入失败不会自动重试。

校验当前 Funnel 可编辑文档、Paywall 文档和 Offering（lookupKey / displayName / items / metadata），严格校验 UTF-8 和 JSON，最大 1,000,000 字节。draft 允许未完成草稿，publish 检查发布结构；validate 的 --file - 可从 stdin 读取。旧格式被明确拒绝。

校验结果标注 validation=local 和 serverChecks=not_run。结构通过不代表可以发布；租户权限、固定引用、提供商和当前状态仍需服务端校验。diff 输出 JSON Pointer、改动种类和稳定 SHA-256，不输出文档值；最多显示 100 项，并提供 total / truncated。

使用新的输出目录。screen.json 保存结构、文案和动作；HTML/CSS 在 html/<node-id>/ 下按语言编辑。indiana.source.json 保留目标、App/环境及拉取基线。可以使用本地编辑器或 AI 工具修改，然后校验、审阅并提交草稿；也可导入网页代码编辑器审阅。

pull 使用 platform.read，push 使用 platform.write 并保留原有作者角色检查。check/diff 离线运行；push 保留原始修订检查，冲突不覆盖本地文件，模板库目标另存私有模板。命令不发布、不监听文件，也不启动本地预览服务器。