CLI

0.22.2 更新（相较 0.22.1）

• 修复打开历史、频道菜单、Forum 或 Spire 期间收到新消息，返回聊天后不同发送者的消息之间缺少空行的问题。
• 延迟消息保留发送者、API 来源和日期信息，返回后与实时消息使用相同的分组规则，发送预览与确认后的间距保持一致。
• 修复延迟消息的编辑、撤回更新丢失，以及切换频道后旧频道消息重新显示的问题。

安装与启动

需要 Node.js 24（含 npm）。支持 macOS、Linux 和 Windows 的交互式终端。

安装或从旧 npm 版本迁移（只需执行一次）：

npm install -g https://docs.linkchat.online/releases/linkchat-cli/0.22.2/linkchat-cli-0.22.2.tgz --ignore-scripts
linkchat

npm 仅负责安装与第三方依赖，不需要 npm 账号。旧版客户端仍查询 npm，需要先执行上面的迁移命令。

默认服务为 https://linkchat.online；私有服务使用 linkchat --server https://你的域名。仅本机开发允许 HTTP 地址。

启动后直接进入聊天界面。未登录时输入框上方提示 /login 登录、/register 注册；注册必须填写邮箱并完成 6 位邮件验证码验证（10 分钟有效），无需注册邀请码。成功后在本机保存会话令牌，不保存密码；再次启动自动恢复上次账号、服务器和频道。正常退出保留登录，/logout 注销并清除该账号缓存。

LinkForum 全站论坛

使用 /forum 进入 LinkForum，无需加入聊天频道。首页顶部一行是 LinkForum 和分类，通知分类显示未读数；下方横线右端显示当前版块、搜索词和页码，‹ › 可点击翻页。帖子列表沿用聊天频道的选择方式：上下键选择，Enter 进入，左右键翻页；标题、作者、版块和回复数直接显示，置顶帖以金色「置顶」标记并用虚线与其他帖子分隔，最近进入的帖子标记 ✔。底部无占位文字的 Chat 同款输入框直接搜索帖子及回复，输入停顿 250 毫秒后查询；命中正文或回复时，第二行显示匹配内容。版块及通知页则筛选当前列表。Ctrl+R 强制刷新。

列表只显示帖子，进入时默认选中第一条。发帖点分类栏右端的「＋ 发帖」，或在列表和帖子里按 Ctrl+N（终端较窄时不显示按钮，Ctrl+N 仍可用）。在任一列表页按 Ctrl+D 直接返回聊天，不受当前分类、版块筛选或搜索影响；帖子内和发帖页不响应 Ctrl+D。发帖页像文档一样整页直接编辑，没有底部输入框：上方是标题和版块，下方「正文」区域即写即显示 Markdown 样式（粗体、斜体、标题、引用、代码、链接等，符号变暗但保留在原位）。打开后光标先在标题，Enter 进入版块列表（上下键选择、Enter 确认），随后光标落在正文；也可以手工输入 /new 标题 跳过标题。上下键在标题、版块、正文之间移动（正文第一行再按 ↑ 回到版块），Tab / Shift+Tab 循环切换，鼠标可直接点击；正文中 Enter 发布，Shift+Enter、Alt+Enter 或 Ctrl+J 换行，键入的 / 按正文处理。版块默认选中正在浏览的版块，其次是上次发帖用的版块（本机客户端会记住），都没有时由你选择。

进入帖子后，顶部一行显示标题、版块和回复数，正文与回复按顺序连续显示。每层楼的标题行是楼层编号（#0 为首帖，#1 起为当前加载的后续楼层）、作者和时间，楼主的回复标注「楼主」，首帖与回复之间以一条「N 条回复」分隔线隔开；标题行右侧是操作：△ / ▲ 表示未赞 / 已赞并带赞数，#0 另有 ☆ / ★ 收藏帖子、⚐ / ⚑ 关注新回复，以及引用和编辑。操作平时为灰色，已赞、已收藏、已关注保持高亮；鼠标移入时高亮，并在底栏说明用途。从通知进入时自动定位到对应回复并短暂高亮该楼。讨论区下方复用 Chat 的输入框样式：直接输入并按 Enter 回帖；与 Chat 相同，Shift+Enter、Alt+Enter 或 Ctrl+J 换行（Windows Terminal 中 Ctrl+Enter 也可），支持多行 Markdown 粘贴。正文中的粗体、斜体、删除线、标题和链接样式与 Chat 一致。↑ / ↓ 或鼠标滚轮阅读（多行编辑时上下键移动光标，清空输入后恢复阅读）；/more 加载后续回复。

鼠标可点击分类、翻页箭头、帖子和楼层操作，点击回复区可以定位光标。无鼠标时，Tab / Shift+Tab 只轮换顶栏分类并立即加载对应列表，不经过搜索、帖子列表或操作按钮。上下键选帖，Enter 打开，直接打字搜索。帖子内上下键阅读，Esc 返回列表，输入 / 使用命令；命令菜单打开时 Tab 仅补全命令。

底栏默认显示 ? for shortcuts，空输入时按 ? 查看当前页面的快捷键和命令；通知出现时顶替提示，消失后恢复。帖子内输入 / 会显示 Chat 同款命令菜单（首页不显示），上下键选择、Tab 补全并收起；Enter 直接执行无参数命令，有参数命令先补全，再输入参数执行。常用命令：

执行楼层操作后，列表显示编号、作者和内容摘要；上下键或鼠标选择，Enter 确认，输入文字可筛选，Esc 取消。编辑和删除只列出自己的可见内容；/more 可加载更多回复后再选择。

直接输入正文后按 Enter 发布。引用或编辑时，Esc 先取消引用（保留已输入的文字）或放弃编辑；再按 Esc 返回列表；正文不为空时会先在底栏询问是否放弃，Enter 确认放弃、Esc 继续编辑。需要输入或确认的操作没有按钮，按键提示统一显示在底栏。Ctrl+C 清空当前输入。当前帖子内点赞、收藏等操作保留输入框内容；网络失败也保留当前输入，再次 Enter 使用相同幂等键，避免重复发布。粘贴的 /命令 按普通正文处理；手工输入以 / 开头的正文时使用 // 转义。

本版暂时禁用 Forum 附件，相关命令不显示且拒绝执行；代码和已有文件保留。Chat 附件不受影响。/status → API Key 可创建论坛读写权限，名称会公开显示为来源标记。撤销的 Key 在查看菜单中以暗色显示，仍可查看和复制历史记录。

更新

在本地聊天界面输入 /update，会检查并更新 CLI 和已安装扩展，然后自动重启，恢复已保存的登录和频道。未安装的扩展不会自动安装；某项更新失败会显示原因并继续其他项。SSH 网关由管理员更新。

linkchat --version
linkchat update --check
linkchat update

启动后异步查询 docs.linkchat.online 最新稳定版本，超时 3 秒，结果缓存 24 小时，不影响登录；只发送公开包名。使用 --no-update-check 或环境变量 LINKCHAT_NO_UPDATE_CHECK=1 禁用自动检查。

linkchat update 仅升级当前 npm 全局安装，下载文档站精确版本并验证 SHA-256 后安装，不自动提权。权限错误请修复自己的 npm 全局目录权限后重试。更新命令会显示新版的 Node.js 要求。

卸载

npm uninstall -g linkchat-cli

卸载不会删除本机的登录信息和聊天缓存，位置见下文“本地数据与缓存”。linkchat cache info 查看缓存位置、数据量和同步时间，linkchat cache clear 清理聊天缓存并保留登录信息。