命令行版 · Gorner CLI

Install

一条命令装好

安装器会自动检查 Node 版本、下载主程序、并把 gorner 命令放进 PATH。

🍎 macOS / Linux

在「终端」中粘贴这一行

curl -fsSL https://www.gorner.kdns.fr/cli/install.sh | bash

🪟 Windows

在 PowerShell 中粘贴这一行

irm https://www.gorner.kdns.fr/cli/install.ps1 | iex

⚡ 不安装，直接跑

只需要 Node，下载即用

curl -fsSL https://www.gorner.kdns.fr/cli/gorner.mjs -o gorner.mjs node gorner.mjs --help

📦 离线安装包

下载 ZIP 解压后 bash install-local.sh，全程不联网

bash install-local.sh

前置条件：Node.js 18 或更高版本（nodejs.org）。安装器会先检查版本，不满足会直接告诉你。

如果安装命令执行失败？
个别网络对 *.workers.dev 存在 DNS 污染或连接封锁，会导致上面的 curl 命令无法下载。此时：

换一个网络（手机热点通常可用）后重试；
或下载 CLI 离线安装包，解压后执行 bash install-local.sh（无需联网）；
或把 gorner.mjs 与 install.sh 放同一目录，执行 bash install.sh（同目录有文件时安装器自动跳过下载）。

装好后先跑 gorner doctor，它会逐层诊断 DNS / TCP / HTTP 并告诉你卡在哪一层。

身份

命令	说明
`gorner login [用户名]`	登录；随后自动用 SSO 换取聊天会话
`gorner whoami`	查看当前身份（用户名 / UID / 角色 / 星币）
`gorner logout`	清除本机保存的凭据

星际超联中心

命令	说明
`gorner status`	总览：身份 / 余额 / 签到 / 联通状态
`gorner wallet`	星币余额与最近 30 条流水
`gorner signin`	每日签到领星币
`gorner pay <用户名> <金额>`	转账星币给对方
`gorner shop`	商城商品列表
`gorner buy <商品ID> [数量]`	购买商品
`gorner lottery [次数]`	抽奖（每次 100 星币）
`gorner notice`	查看系统通知（未读会用 ● 标出）

GornerChat

命令	说明
`gorner chat ls`	会话列表，含最后一条消息与成员数
`gorner chat open <会话ID>`	进入会话，实时收发（输入 `/quit` 退出）
`gorner chat say <会话ID> <内容>`	不进入会话，直接发一条
`gorner chat dm <用户名>`	发起私聊并直接进入
`gorner chat group <群名> <成员,成员>`	创建群聊

会话内还支持 /ls 列出会话、/refresh 重载历史。

诊断与配置

命令	说明
`gorner doctor`	逐项检测 DNS / TCP / HTTP 与登录态，并给出修复建议
`gorner config`	查看当前服务地址与登录状态
`gorner config api <地址>`	修改身份中心地址（chat / ai 同理）
`gorner config local` / `cloud`	一键切换到本地开发服务 / 恢复云端地址
`gorner api <路径> [JSON]`	原始 API 调用，便于调试
`gorner --help`	完整帮助

设计说明

单文件零依赖。整份客户端就是一个 gorner.mjs，只用 Node 内置模块，没有 npm 依赖树，不会因为依赖升级而失效。
凭据只存令牌。登录后写在 ~/.gorner/config.json，权限 600（仅本机当前用户可读），保存的是服务端签发的会话令牌，不含密码。清除用 gorner logout。
不做自己的账号体系。命令行版复用星际超联中心的统一身份：先登身份中心，再经 SSO 换取聊天会话，与网页端是同一套账号和数据。
时间戳双向兼容。身份中心的流水用毫秒数、聊天消息用 ISO 文本，客户端统一解析并换算成本机时区显示。
实时消息走同一条 SSE 流。与网页端共用基于 D1 轮询的无状态推送，断线自动重连。
中文终端对齐。表格按字符实际显示宽度排版（中文按两格计算），不会错行。

连不上云端？

先运行诊断，它会明确告诉你是哪一层断了：

gorner doctor

如果结果是 DNS 正常但 TCP 连接超时，通常是所在网络无法访问 *.workers.dev。可选方案：

绑定自有域名：在 Cloudflare 控制台为 Worker 添加自定义域，之后用 gorner config api <你的域名> 切换；
换网络或使用代理：移动网络、公司网络、校园网的封锁策略常不相同，可以换一个试试；
本地回退：先在对应目录起本地服务，再切过去，功能完全一致 ——

# 终端 1（星际超联中心目录）
npx wrangler dev --port 8787
# 终端 2（gornerchat 目录）
npx wrangler dev --port 8788

gorner config local     # 切到本地地址
gorner config cloud     # 想回云端时切回来

终端里的星际超联中心