glmcode 0.1.10 → 0.1.12

package/CHANGELOG.md

@@ -1,5 +1,24 @@
 # CHANGELOG
 
+## 0.1.12 (2026-08-28)
+
+- **新增 `COMPATIBILITY.md` 跨平台兼容性说明**：覆盖 Windows / macOS / Linux / Android(Termux) / FreeBSD 等全部支持系统，含功能支持矩阵、各平台安装方式、跨平台自动适配机制、已知限制与自测清单
+- **新增 `glmcode --selftest` 跨平台自检**：通过改写 `process.platform` 虚拟模拟 linux / darwin / win32 / freebsd / openbsd / android / sunos 七种平台，逐一验证 shellInfo、buildShellArgs、openUrlCandidates、包管理器探测与安装命令；并在真实平台验证 run_shell、配置存取、文件读写、SKILL.md 技能加载、zip 技能解压、TUI 命令过滤与状态栏。当前 35 项全部 PASS
+- 修复 `run_shell` 严重 bug：`buildShellArgs` 返回 `args` 属性但调用处误解构为 `a`，导致所有平台 `/run` 实际以无参数方式调用 shell（静默无输出）。已修正解构，该 bug 由本次 `--selftest` 抓出
+- 修复 `run_shell` 对 fish / csh / tcsh 等 shell 的兼容：这类 shell 不支持 `-lc` 参数，现自动改用 `-c`
+- 修复 `PACKAGE_ROOT` 路径解析：改用 `fileURLToPath`，避免 Windows 下 `import.meta.url` 路径带前导斜杠导致技能目录定位异常
+- `/install` 更稳健：Windows 检测 `winget`、macOS 检测 `brew` 是否真实存在，不存在时不再误报可用
+- 版本升级至 0.1.12，`COMPATIBILITY.md` 纳入 npm 发布包
+
+## 0.1.11 (2026-08-28)
+
+- **真 TUI 交互层**：引入 `terminal-kit`，彻底替换 readline
+- 输入 `/` 立即弹出**悬浮命令菜单**（不回车也显示），输入字母**实时过滤**命令
+- **↑/↓ 方向键**直接选择菜单中的命令，Enter 执行，Tab 补全
+- 底部**常驻状态栏**（反色条）：思考开关 / 模型 / 技能数 / 当前目录
+- 支持命令历史（↑/↓ 无菜单时浏览）、Home/End/DEL、Ctrl+L 清屏
+- 修复 `term.height` 未就绪时菜单无法绘制的问题
+
 ## 0.1.10 (2026-08-28)
 
 - 移除 `postinstall` 脚本，消除 npm `install-scripts / allowScripts` 警告

package/COMPATIBILITY.md

@@ -0,0 +1,153 @@
+---
+AIGC:
+    Label: "1"
+    ContentProducer: 001191440300708461136T1XGW3
+    ProduceID: 71f570a12158158e965e493bb4836f3f_e104f8d2a29e11f192a2525400287e28
+    ReservedCode1: AgUVRG+diiMzAe/cS7waYAmhNStXQ2B/ks40W+DvMkeOdMLZ/iLUbP0FZZ28KCIW/jyxAA9UrTMBKscXFN2z2sq7NCobd3t4Dx9i49BsjmFok10emFN4Aw8REwEWYrFrxB0yEWvUDxY/7+hq5CQE0w4bkZQbSOseEEeoOB8XyQvo/8hG0ZnIjUi2Sms=
+    ContentPropagator: 001191440300708461136T1XGW3
+    PropagateID: 71f570a12158158e965e493bb4836f3f_e104f8d2a29e11f192a2525400287e28
+    ReservedCode2: AgUVRG+diiMzAe/cS7waYAmhNStXQ2B/ks40W+DvMkeOdMLZ/iLUbP0FZZ28KCIW/jyxAA9UrTMBKscXFN2z2sq7NCobd3t4Dx9i49BsjmFok10emFN4Aw8REwEWYrFrxB0yEWvUDxY/7+hq5CQE0w4bkZQbSOseEEeoOB8XyQvo/8hG0ZnIjUi2Sms=
+---
+
+# GLMCode 跨平台兼容性说明
+
+本文档说明 GLMCode 在各操作系统下的支持情况。**设计目标：所有平台上的所有功能均可用**，差异仅在底层系统提供的工具（包管理器 / Shell / 打开浏览器命令）不同，GLMCode 已做自动适配。
+
+## 一、支持的系统
+
+GLMCode 基于 Node.js 18+ 运行，凡能安装 Node.js 18+ 并支持 TTY 终端的系统均可运行。已显式适配与验证的平台：
+
+| 平台 | process.platform | 安装方式 | 推荐包管理器 | 默认 Shell |
+|------|------------------|----------|--------------|------------|
+| Linux（主流发行版） | `linux` | npm | apt / apt-get / dnf / pacman | bash / zsh / sh |
+| Alpine Linux 等 | `linux` | npm | apk | ash / sh |
+| FreeBSD / OpenBSD | `freebsd` / `openbsd` | npm | pkg | sh / csh / tcsh |
+| Android（Termux） | `linux` | npm | pkg | bash |
+| macOS | `darwin` | npm | brew | zsh / bash |
+| Windows | `win32` | npm | winget | PowerShell / cmd |
+
+> 其他类 Unix 系统（如 Solaris 等）：只要 Node.js 可运行，功能同样可用；GLMCode 按通用 POSIX 分支处理，不依赖特定发行版。
+
+## 二、各平台安装步骤
+
+统一通过 npm 全局安装，全部平台共用一条命令：
+
+```bash
+npm install -g glmcode
+```
+
+- **Android（Termux）**：先 `pkg install nodejs npm` 装好 Node，再执行上面的安装命令。
+- **Windows**：先安装 [Node.js](https://nodejs.org/)（自带 npm），再执行安装命令；`glmcode` / `glm` / `gc` 三个命令自动加入 PATH。
+- **macOS**：先 `brew install node` 或从官网安装 Node，再执行安装命令。
+- **Linux**：用发行版包管理器安装 Node.js 后执行安装命令。
+
+安装后运行：
+
+```bash
+glmcode auth set <你的智谱API_KEY>   # 首次设置 API Key
+glmcode                              # 启动对话
+```
+
+API Key 也可以不写盘，直接用环境变量注入：
+
+```bash
+export ZHIPU_API_KEY=sk-xxx    # 或 GLM_API_KEY
+```
+
+## 三、功能支持矩阵
+
+以下所有功能在**全部受支持平台**上均可使用。✅ 表示原生支持，注释列说明平台差异点。
+
+| 功能 | Windows | macOS | Linux | Android(Termux) | 平台差异说明 |
+|------|:---:|:---:|:---:|:---:|------|
+| 流式对话 + 思考模式 | ✅ | ✅ | ✅ | ✅ | 纯网络请求，无差异 |
+| `/run` 执行 Shell 命令 | ✅ | ✅ | ✅ | ✅ | 自动识别 cmd/PowerShell/POSIX shell |
+| `write_file` / `read_file` 读写文件 | ✅ | ✅ | ✅ | ✅ | 使用系统原生路径 |
+| 技能系统（SKILL.md 目录 / zip 自动解压） | ✅ | ✅ | ✅ | ✅ | zip 解压依赖 `adm-zip`（自动安装） |
+| 真 TUI 悬浮菜单 / 状态栏 / 方向键 | ✅ | ✅ | ✅ | ✅ | 需 TTY 终端；Windows 建议用 Windows Terminal |
+| 命令历史 / Tab 补全 / Ctrl+L | ✅ | ✅ | ✅ | ✅ | 需 TTY 终端 |
+| `/install` 自动安装程序 | ✅ | ✅ | ✅ | ✅ | 自动选用 winget / brew / pkg 等 |
+| `auth login` 打开浏览器 | ✅ | ✅ | ✅ | ✅ | Windows: start；macOS: open；Linux: xdg-open/gio；Android: termux-open-url |
+| `auth set/status/logout` | ✅ | ✅ | ✅ | ✅ | 凭据存于 `~/.glmcode/auth.json`（权限 600） |
+| 配置持久化 | ✅ | ✅ | ✅ | ✅ | 存于 `~/.glmcode/config.json` |
+| 环境变量注入 API Key / 技能目录 | ✅ | ✅ | ✅ | ✅ | `ZHIPU_API_KEY` / `GLM_API_KEY` / `GLM_SKILLS_DIR` |
+| 依赖缺失自动安装（ensureDeps） | ✅ | ✅ | ✅ | ✅ | 需要本机已有 npm |
+| `glmcode shell` 系统信息 | ✅ | ✅ | ✅ | ✅ | 输出 OS / 架构 / Shell |
+| `glmcode --version` / `--help` | ✅ | ✅ | ✅ | ✅ | 无差异 |
+
+## 四、跨平台自动适配机制
+
+GLMCode 内部按平台自动选择底层命令，无需用户手动配置：
+
+1. **Shell 识别（shellInfo）**
+   - Windows：检测 `PWSH` / `POWERSHELL` 环境变量，存在则用 PowerShell，否则用 `ComSpec`（cmd.exe）。
+   - 其他系统：读取 `$SHELL` 环境变量，缺省回退 `/bin/sh`。
+
+2. **Shell 命令拼装（run_shell）**
+   - Windows + PowerShell：`powershell -NoProfile -Command <命令>`
+   - Windows + cmd：`cmd /d /s /c <命令>`
+   - POSIX shell（sh/bash/zsh/dash/ash）：`<shell> -lc <命令>`（登录 shell 执行）
+   - fish / csh / tcsh：`<shell> -c <命令>`（这三种 shell 不支持 `-lc` 组合参数）
+
+3. **打开浏览器（openUrl）**，按优先级自动挑选本机可用的命令：
+   - Windows：`cmd /c start "" <url>`
+   - macOS：`open <url>`
+   - Linux / 其他：`xdg-open` → `termux-open-url`（Android）→ `gio open`
+   - 逐个探测，找到可用的就执行；全部不可用时提示"当前环境无法自动打开浏览器"。
+
+4. **包管理器探测（detectInstaller）**，供 `/install` 使用：
+   - Windows：`winget`（未安装则提示无可用包管理器）
+   - macOS：`brew`（Homebrew）
+   - Linux / BSD / Android：按 `apk` → `apt-get` → `apt` → `dnf` → `pacman` → `pkg` 顺序探测
+   - 每个平台只会调用真实存在的包管理器，避免"找不到命令"报错。
+
+5. **命令存在性探测（commandExists）**
+   - Windows：`where <命令>`
+   - 其他系统：`which <命令>`
+
+6. **安装命令构建（/install）**
+
+   | 平台 | 实际执行 |
+   |------|----------|
+   | Windows | `winget install <包>` |
+   | macOS | `brew install <包>` |
+   | Alpine | `apk add <包>` |
+   | Debian/Ubuntu | `apt-get install -y <包>` 或 `apt install -y <包>` |
+   | Fedora/RHEL | `dnf install -y <包>` |
+   | Arch | `pacman -S --noconfirm <包>` |
+   | FreeBSD / Termux | `pkg install -y <包>` |
+
+## 五、路径约定
+
+- 配置与凭据目录：`~/.glmcode/`（即各系统用户主目录下的 `.glmcode`，Windows 为 `%USERPROFILE%\.glmcode`）。
+- `auth.json` 与 `config.json` 创建时权限为 `0600`（仅当前用户可读写），目录权限 `0700`。
+- 技能目录：默认取包安装目录下的 `skills/`，可用环境变量 `GLM_SKILLS_DIR` 指向自定义目录（支持相对/绝对路径）。
+- 所有路径拼接使用 Node.js `path` 模块，自动适配 Windows（`\`）与类 Unix（`/`）分隔符。
+
+## 六、已知限制与注意事项
+
+1. **真 TUI 需要真实 TTY**：TUI 悬浮菜单、状态栏、方向键交互依赖终端。通过管道/重定向或 CI 无 TTY 环境运行时，交互层不可用（`terminal-kit` 会退化），但 `auth`、`shell`、`--version` 等子命令不受影响。
+2. **Windows 建议使用 Windows Terminal / ConEmu**：GLMCode 使用 ANSI 转义序列渲染颜色与状态栏，旧版 `cmd.exe` 控制台可能显示异常；Windows Terminal 与 PowerShell 7 无此问题。
+3. **`/install` 需要对应权限**：Linux 上 `apt/dnf/pacman` 需要 root（一般以 `sudo` 启动 GLMCode 或自行以 sudo 安装）；Termux 的 `pkg`、Windows 的 `winget`、macOS 的 `brew` 不需要 root。
+4. **openUrl 依赖桌面环境**：无图形界面的 Linux 服务器若未安装 `xdg-utils` 等工具，`auth login` 无法打开浏览器，但可通过 `auth set` 手动配置。
+5. **Android 存储目录**：Termux 直接读写 `/storage/emulated/0/...` 需要 `termux-setup-storage` 授权一次存储权限；读写自身私有目录（`~/...`）无需授权。
+6. **`/run` 命令 60 秒超时**：所有平台统一限制，超长命令会被终止并返回部分输出。
+7. **依赖自动安装需要 npm**：`ensureDeps` 在缺失 `adm-zip` / `terminal-kit` 时调用 `npm install` 兜底，因此本机需存在 npm（安装 GLMCode 时已隐含该前提）。
+
+## 七、已验证 / 建议自测清单
+
+每个平台可运行以下命令快速验证：
+
+```bash
+glmcode --selftest     # 一键跨平台自检：虚拟模拟 7 种平台 + 真实平台功能验证
+glmcode --version      # 版本输出
+glmcode shell          # 显示 OS / 架构 / Shell
+glmcode shell list     # 列出可用 Shell
+glmcode --help         # 帮助（含 TUI 用法说明）
+glmcode auth status    # 认证状态
+```
+
+`glmcode --selftest` 会虚拟模拟 **linux / darwin / win32 / freebsd / openbsd / android / sunos** 七种平台，逐一验证 Shell 识别、Shell 命令拼装、打开浏览器候选命令、包管理器探测与安装命令；并在当前真实平台验证 `run_shell` 实际执行、配置存取、文件读写、SKILL.md 技能加载、zip 技能自动解压、TUI 命令过滤与状态栏渲染。全部通过会显示 `PASS 35 / FAIL 0`。
+
+启动对话后依次测试：`/` 弹出菜单 → ↑↓ 选择 → Enter 执行 → `/run echo ok` → `/ls` → `/install`（视平台）。
+*（内容由AI生成，仅供参考）*

package/README.md

@@ -11,9 +11,9 @@ npm install -g glmcode
 - 流式对话（支持思考模式）
 - 四个内置工具：`run_shell` / `write_file` / `read_file` / `use_skill`
 - 技能系统：把 `SKILL.md` 目录或 `.zip` 技能包放进 `skills/` 自动加载
-- 斜杠命令菜单：输入 `/` 或前缀即弹出菜单，Tab 补全
-- 底部状态栏：实时显示思考开关 / 模型 / 技能数 / 当前目录
-- 自动安装依赖：缺失 `adm-zip` 等依赖时启动自动 `npm install`
+- **真 TUI 交互**：输入 `/` 立即弹出悬浮命令菜单（不回车也显示），按字母实时过滤，↑/↓ 方向键选择，Tab 补全，Enter 执行
+- **底部常驻状态栏**（反色条）：实时显示思考开关 / 模型 / 技能数 / 当前目录
+- 自动安装依赖：缺失 `adm-zip`、`terminal-kit` 等依赖时启动自动 `npm install`
 - `/install` 命令：调用系统包管理器（apt/apk/pkg/brew/winget 等）自动安装程序
 - 认证：`glmcode auth set <API_KEY>`
 
@@ -21,6 +21,7 @@ npm install -g glmcode
 
 ```bash
 glmcode              # 启动对话
+glmcode --selftest   # 一键跨平台自检（虚拟模拟 7 种平台 + 真实平台功能验证）
 glmcode --help       # 帮助
 glmcode auth set sk-xxx   # 设置 API Key
 glmcode shell        # 查看系统信息
@@ -54,3 +55,9 @@ mkdir -p skills/my-skill
 ```
 
 启动后输入 `/技能名` 即可注入技能指令。
+
+## 跨平台兼容性
+
+GLMCode 支持 **Windows / macOS / Linux / Android(Termux) / FreeBSD 等所有可运行 Node.js 18+ 的系统**，所有功能在全部平台上均可用。程序自动适配各平台的 Shell（cmd / PowerShell / bash / zsh / fish 等）、包管理器（winget / brew / apt / dnf / pacman / apk / pkg）、打开浏览器命令与路径分隔符。
+
+详见 [COMPATIBILITY.md](COMPATIBILITY.md)。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "glmcode",
-  "version": "0.1.10",
+  "version": "0.1.12",
   "description": "GLM coding agent CLI with shell tools, skills (SKILL.md/zip auto-extract), streaming chat, slash-command menu and bottom status bar. Auto-installs its dependencies.",
   "type": "module",
   "bin": {
@@ -15,11 +15,13 @@
     "src/",
     "skills/",
     "README.md",
+    "COMPATIBILITY.md",
     "CHANGELOG.md",
     "LICENSE"
   ],
   "dependencies": {
-    "adm-zip": "^0.5.16"
+    "adm-zip": "^0.5.16",
+    "terminal-kit": "^3.1.4"
   },
   "engines": {
     "node": ">=18"

package/src/cli.js

@@ -2,11 +2,12 @@
 import fs from "node:fs";
 import os from "node:os";
 import path from "node:path";
-import readline from "node:readline";
 import {spawnSync, spawn} from "node:child_process";
 import {fileURLToPath} from "node:url";
+import termkit from "terminal-kit";
+const term = termkit.terminal;
 
-const VERSION="0.1.10";
+const VERSION="0.1.12";
 const BASE_URL="https://open.bigmodel.cn/api/paas/v4";
 const API_KEYS_URL="https://open.bigmodel.cn/usercenter/proj-mgmt/apikeys";
 const HOME=os.homedir();
@@ -28,7 +29,6 @@ const DEFAULT_CONFIG={
 
 let config={...DEFAULT_CONFIG};
 let apiKey=null, messages=[], cwd=process.cwd(), thinkingEnabled=false, skills=new Map();
-let stopping=false;
 
 function readJson(file,fallback={}){try{return JSON.parse(fs.readFileSync(file,"utf8"));}catch{return fallback;}}
 function saveJson(file,v){fs.mkdirSync(DATA_DIR,{recursive:true,mode:0o700});fs.writeFileSync(file,JSON.stringify(v,null,2)+"\n",{mode:0o600});try{fs.chmodSync(file,0o600);}catch{}}
@@ -49,12 +49,19 @@ function shellInfo(){
   }
   const exe=process.env.SHELL||"/bin/sh"; return {name:path.basename(exe),exe};
 }
+function buildShellArgs(s,cmd){
+  if(process.platform==="win32")return {file:s.exe,args:s.name==="powershell"?["-NoProfile","-Command",cmd]:["/d","/s","/c",cmd]};
+  const n=s.name.toLowerCase();
+  return {file:s.exe,args:(n==="fish"||n==="csh"||n==="tcsh")?["-c",cmd]:["-lc",cmd]};
+}
 function commandExists(c){try{spawnSync(process.platform==="win32"?"where":"which",[c],{stdio:"ignore"});return true;}catch{return false;}}
+function openUrlCandidates(url){
+  if(process.platform==="win32")return [["cmd",["/c","start","",url]]];
+  if(process.platform==="darwin")return [["open",[url]]];
+  return [["xdg-open",[url]],["termux-open-url",[url]],["gio",["open",url]]];
+}
 function openUrl(url){
-  const c=process.platform==="win32"?[["cmd",["/c","start","",url]]]:
-    process.platform==="darwin"?[["open",[url]]]:
-    [["xdg-open",[url]],["termux-open-url",[url]],["gio",["open",url]]];
-  for(const [cmd,args] of c){if(!commandExists(cmd))continue;try{const p=spawn(cmd,args,{detached:true,stdio:"ignore"});p.unref();return true;}catch{}}
+  for(const [cmd,args] of openUrlCandidates(url)){if(!commandExists(cmd))continue;try{const p=spawn(cmd,args,{detached:true,stdio:"ignore"});p.unref();return true;}catch{}}
   return false;
 }
 
@@ -62,6 +69,7 @@ function openUrl(url){
 async function ensureDeps(){
   const missing=[];
   try{await import("adm-zip");}catch{missing.push("adm-zip");}
+  try{await import("terminal-kit");}catch{missing.push("terminal-kit");}
   if(!missing.length)return true;
   console.log(color(`[glmcode] 缺少依赖: ${missing.join(", ")}，正在自动安装...`,C.yellow));
   let ok=true;
@@ -84,7 +92,6 @@ async function extractZipSkills(){
     if(fs.existsSync(target))continue;
     try{
       new AdmZip(zp).extractAllTo(target,true);
-      // 扁平化：zip 内带同名根目录时（如 my-skill/SKILL.md）解压会出现 target/my-skill/... 嵌套，上移一层
       const sub=fs.readdirSync(target,{withFileTypes:true}).find(d=>d.isDirectory());
       if(sub && !fs.existsSync(path.join(target,"SKILL.md")) && fs.existsSync(path.join(target,sub.name,"SKILL.md"))){
         for(const e of fs.readdirSync(path.join(target,sub.name))){
@@ -136,9 +143,8 @@ const TOOLS=[
 
 function execTool(name,args){
   if(name==="run_shell"){
-    const s=shellInfo(), isWin=process.platform==="win32";
-    const file=s.exe, a=isWin?(s.name==="powershell"?["-NoProfile","-Command",args.command]:["/d","/s","/c",args.command]):["-lc",args.command];
-    try{const r=spawnSync(file,a,{cwd,encoding:"utf8",timeout:60000});return ((r.stdout||"")+(r.stderr?"\n[stderr]\n"+r.stderr:"")).slice(0,8000)||"(无输出)";}
+    const {file,args:shArgs}=buildShellArgs(shellInfo(),args.command);
+    try{const r=spawnSync(file,shArgs,{cwd,encoding:"utf8",timeout:60000});return ((r.stdout||"")+(r.stderr?"\n[stderr]\n"+r.stderr:"")).slice(0,8000)||"(无输出)";}
     catch(e){return `执行失败: ${e.message}`;}
   }
   if(name==="write_file"){try{const p=path.resolve(cwd,args.path);fs.mkdirSync(path.dirname(p),{recursive:true});fs.writeFileSync(p,args.content);return `已写入 ${p}`;}catch(e){return `写入失败: ${e.message}`;}}
@@ -194,7 +200,7 @@ async function chat(text){
     }
   }
 }
-/* ---- 斜杠命令菜单：输入 / 即弹出 ---- */
+/* ---- 斜杠命令处理（/help 文本模式） ---- */
 function showMenu(prefix){
   const p=(prefix||"/").trim();
   const list=Object.entries(commands()).filter(([c])=>c.startsWith(p));
@@ -216,68 +222,232 @@ function handleCommand(line){
   else if(cmd==="/cat"){try{console.log(fs.readFileSync(path.resolve(cwd,arg),"utf8").slice(0,8000));}catch(e){console.log(color(`失败: ${e.message}`,C.red));}}
   else if(cmd==="/run"){if(!arg)console.log("用法: /run <命令>");else console.log(execTool("run_shell",{command:arg}));}
   else if(cmd==="/install"){installProgram(arg)}
-  else if(cmd==="/exit"){console.log(color("再见",C.cyan));process.exit(0);}
+  else if(cmd==="/exit"){term.grabInput(false);term("\n");console.log(color("再见",C.cyan));process.exit(0);}
   else console.log(color(`未知命令: ${cmd}（输入 / 查看全部）`,C.red));
 }
 
 function logo(){
  const rows=[" ██████╗   ██╗       ███╗   ███╗","██╔════╝   ██║       ████╗ ████║","██║  ███╗  ██║       ██╔████╔██║","██║   ██║  ██║       ██║╚██╔╝██║","╚██████╔╝  ███████╗  ██║ ╚═╝ ██║"," ╚═════╝   ╚══════╝  ╚═╝     ╚═╝"];
- const W=44;console.log(color("".padStart(W),C.cyan));console.log(color("✧  GLM  ✧".padStart((W+"✧  GLM  ✧".length)/2),C.cyanB));for(const r of rows)console.log(color(r.padStart((W+r.length)/2),C.cyanB));console.log(color("GLM Code · Coding Agent",C.cyanB));console.log(color(`v${VERSION}`,C.gray));console.log(color("/help 查看命令 · /thinking 思考开关",C.gray));console.log("");
+ const W=44;console.log(color("".padStart(W),C.cyan));console.log(color("✧  GLM  ✧".padStart((W+"✧  GLM  ✧".length)/2),C.cyanB));for(const r of rows)console.log(color(r.padStart((W+r.length)/2),C.cyanB));console.log(color("GLM Code · Coding Agent",C.cyanB));console.log(color(`v${VERSION}`,C.gray));console.log(color("输入 / 弹菜单 · ↑↓ 选择 · 回车执行 · Ctrl+C 退出",C.gray));console.log("");
 }
-/* ---- 底部状态栏 ---- */
-function toolbar(){return `┌ 思考:${thinkingEnabled?"开":"关"}  模型:${config.model}  技能:${skills.size}  目录:${cwd} ┐`;}
-function completer(line){
-  if(!line.startsWith("/"))return [[],[]];
-  const list=Object.entries(commands()).filter(([c])=>c.startsWith(line)).map(([c,d])=>`${c} — ${d}`);
-  return [list.length?list:[line], list.map(v=>v.split(" — ")[0])];
+
+/* =============== 真 TUI：悬浮菜单 + 上下键 + 实时过滤 + 底部状态栏 =============== */
+const PROMPT="┃ 输入( / 菜单 · ↑↓选择 · Enter执行) ┃ ";
+const TUI={input:"",cursor:0,items:[],sel:0,scroll:0,history:[],histIdx:-1};
+function statusText(){return ` 思考:${thinkingEnabled?"开":"关"}   模型:${config.model}   技能:${skills.size}   目录:${cwd}  `;}
+function filterItems(input){
+  const s=(input||"").trim();
+  if(!s.startsWith("/"))return [];
+  const name=s.slice(1).toLowerCase();
+  const list=Object.entries(commands());
+  if(!name)return list.map(([c,d])=>`${c}  ${d}`);
+  return list.filter(([c,d])=>{
+    const n=c.slice(1).toLowerCase();
+    return n.startsWith(name)||n.includes(name)||d.toLowerCase().includes(name);
+  }).map(([c,d])=>`${c}  ${d}`);
 }
-function promptLoop(){
- const rl=readline.createInterface({input:process.stdin,output:process.stdout,completer});
- rl.setPrompt(color("┃ 输入消息( / 弹菜单, Tab 补全) ┃ ",C.cyanB));
- function next(){console.log(color(toolbar(),C.gray));rl.prompt();}
- next();
- rl.on("line",async line=>{
-   const text=line.trim();if(!text){next();return;}
-   if(text.startsWith("/")){
-     const cmds=commands();
-     if(text!=="/"&&cmds[text])handleCommand(text);
-     else showMenu(text==="/"?"/":text);
-   }else{rl.pause();await chat(text);rl.resume();}
-   next();
- });
- rl.on("SIGINT",()=>{if(stopping){rl.close();process.exit(0);}stopping=true;console.log(color("\n[再次 Ctrl+C 退出]",C.yellow));setTimeout(()=>stopping=false,1200);rl.prompt();});
- rl.on("close",()=>process.exit(0));
+function menuMax(){const h=term.height>0?term.height:24;return Math.max(1,Math.min(10,h-3));}
+function keepSelVisible(){
+  const MAX=menuMax();
+  if(TUI.sel<TUI.scroll)TUI.scroll=TUI.sel;
+  else if(TUI.sel>=TUI.scroll+MAX)TUI.scroll=TUI.sel-MAX+1;
+}
+function render(){
+  const h=term.height>0?term.height:24, w=term.width>0?term.width:80;
+  const inputRow=h-1, MAX=menuMax();
+  term.saveCursor();
+  // 底部状态栏（常驻）
+  term.moveTo(1,h);term.eraseLine();
+  const st=statusText().padEnd(Math.max(1,w-1));
+  term.inverse(st.slice(0,w));term.styleReset;
+  // 擦除菜单区
+  for(let j=0;j<MAX;j++){term.moveTo(1,inputRow-1-j);term.eraseLine();}
+  // 悬浮菜单
+  if(TUI.items.length){
+    const count=Math.min(TUI.items.length,MAX);
+    for(let j=0;j<count;j++){
+      const idx=TUI.scroll+j;
+      const row=inputRow-1-j;
+      term.moveTo(1,row);
+      const line=" "+TUI.items[idx]+" ";
+      if(idx===TUI.sel)term.bgBrightBlue.black(line.slice(0,w));
+      else term.gray(line.slice(0,w));
+      term.styleReset;
+    }
+  }
+  // 输入行
+  term.moveTo(1,inputRow);term.eraseLine();
+  term.cyan.bold(PROMPT);
+  const before=TUI.input.slice(0,TUI.cursor), after=TUI.input.slice(TUI.cursor);
+  term(before);term.cyan(after);term.styleReset;
+  // 光标
+  term.restoreCursor();
+  term.moveTo(Math.min(1+PROMPT.length+TUI.cursor,w),inputRow);
+  term.hideCursor(false);
+}
+function refreshFilter(){
+  TUI.items=filterItems(TUI.input);
+  if(TUI.sel>=TUI.items.length)TUI.sel=TUI.items.length?TUI.items.length-1:0;
+  keepSelVisible();
+}
+function tuiInput(){
+  return new Promise(resolve=>{
+    TUI.input="";TUI.cursor=0;TUI.items=[];TUI.sel=0;TUI.scroll=0;TUI.histIdx=-1;
+    term.grabInput(true);
+    render();
+    const onKey=(name,matches,data)=>{
+      if(data&&data.isCharacter&&name.length===1&&name.charCodeAt(0)>=32){
+        TUI.input=TUI.input.slice(0,TUI.cursor)+name+TUI.input.slice(TUI.cursor);
+        TUI.cursor++;refreshFilter();render();
+      }
+      else if(name==="UP"){
+        if(TUI.items.length){TUI.sel=TUI.sel>0?TUI.sel-1:TUI.items.length-1;keepSelVisible();}
+        else if(TUI.histIdx<TUI.history.length-1){TUI.histIdx++;TUI.input=TUI.history[TUI.history.length-1-TUI.histIdx];TUI.cursor=TUI.input.length;refreshFilter();}
+        render();
+      }
+      else if(name==="DOWN"){
+        if(TUI.items.length){TUI.sel=(TUI.sel+1)%TUI.items.length;keepSelVisible();}
+        else if(TUI.histIdx>0){TUI.histIdx--;TUI.input=TUI.history[TUI.history.length-1-TUI.histIdx];TUI.cursor=TUI.input.length;refreshFilter();}
+        else if(TUI.histIdx===0){TUI.histIdx=-1;TUI.input="";TUI.cursor=0;refreshFilter();}
+        render();
+      }
+      else if(name==="TAB"){
+        if(TUI.items.length){const chosen=TUI.items[TUI.sel].split("  ")[0];TUI.input=chosen;TUI.cursor=chosen.length;TUI.items=[];}
+        render();
+      }
+      else if(name==="ENTER"){
+        const v=TUI.input;
+        term.removeListener("key",onKey);
+        term.grabInput(false);
+        term.hideCursor();
+        term("\n");
+        if(v.trim())TUI.history.push(v.trim());
+        resolve(v);
+      }
+      else if(name==="BACKSPACE"){
+        if(TUI.cursor>0){TUI.input=TUI.input.slice(0,TUI.cursor-1)+TUI.input.slice(TUI.cursor);TUI.cursor--;refreshFilter();}
+        render();
+      }
+      else if(name==="DELETE"){
+        if(TUI.cursor<TUI.input.length){TUI.input=TUI.input.slice(0,TUI.cursor)+TUI.input.slice(TUI.cursor+1);refreshFilter();}
+        render();
+      }
+      else if(name==="LEFT"){if(TUI.cursor>0){TUI.cursor--;}render();}
+      else if(name==="RIGHT"){if(TUI.cursor<TUI.input.length){TUI.cursor++;}render();}
+      else if(name==="HOME"){TUI.cursor=0;render();}
+      else if(name==="END"){TUI.cursor=TUI.input.length;render();}
+      else if(name==="CTRL_C"){term.removeListener("key",onKey);term.grabInput(false);term.hideCursor(true);term("\n");resolve(null);}
+      else if(name==="CTRL_L"){term.clear();term.moveTo(1,1);render();}
+    };
+    term.on("key",onKey);
+  });
+}
+async function runTui(){
+  term.hideCursor();
+  while(true){
+    const input=await tuiInput();
+    if(input===null)break;
+    const text=input.trim();
+    if(!text)continue;
+    if(text.startsWith("/"))handleCommand(text);
+    else await chat(text);
+  }
+  term.grabInput(false);
+  term("\n"+color("再见",C.cyan)+"\n");
+  process.exit(0);
 }
-
 
 function detectInstaller(){
-  if(process.platform==="win32")return "winget";
-  if(process.platform==="darwin")return "brew";
-  for(const pm of ["apk","apt-get","apt","dnf","pacman","pkg","termux-pkg"]){
+  if(process.platform==="win32")return commandExists("winget")?"winget":null;
+  if(process.platform==="darwin")return commandExists("brew")?"brew":null;
+  for(const pm of ["apk","apt-get","apt","dnf","pacman","pkg"]){
     if(spawnSync("sh",["-lc",`command -v ${pm}`],{encoding:"utf8"}).status===0)return pm;
   }
   return null;
 }
+function installCmd(pm,name){
+  return {apk:`apk add ${name}`,"apt-get":`apt-get install -y ${name}`,apt:`apt install -y ${name}`,dnf:`dnf install -y ${name}`,pacman:`pacman -S --noconfirm ${name}`,pkg:`pkg install -y ${name}`,brew:`brew install ${name}`,winget:`winget install ${name}`}[pm];
+}
 function installProgram(name){
   if(!name){console.log(color("用法: /install <程序>",C.yellow));return;}
   const pm=detectInstaller();
   if(!pm){console.log(color("未检测到可用的软件包管理器",C.red));return;}
-  const q={apk:`apk add ${name}`,"apt-get":`apt-get install -y ${name}`,apt:`apt install -y ${name}`,dnf:`dnf install -y ${name}`,pacman:`pacman -S --noconfirm ${name}`,pkg:`pkg install -y ${name}`,brew:`brew install ${name}`,winget:`winget install ${name}`}[pm];
+  const q=installCmd(pm,name);
   console.log(color(`[安装] ${pm}: ${q}`,C.gray));
   const r=spawnSync(q,{shell:true,stdio:"inherit",cwd:process.cwd()});
   console.log(r.status===0?color("安装完成",C.green):color(`安装失败: ${r.status}`,C.red));
 }
+/* =============== 跨平台自检：glmcode --selftest =============== */
+async function selftest(){
+  const t0=Date.now();let pass=0,fail=0;
+  const realPlat=process.platform;
+  const push=(name,ok,detail)=>{
+    if(ok)pass++;else fail++;
+    console.log(`  ${ok?color("PASS",C.green):color("FAIL",C.red)}  ${name}  ${color(detail||"",C.gray)}`);
+  };
+  const setPlat=p=>Object.defineProperty(process,"platform",{value:p,configurable:true});
+  const platforms=["linux","darwin","win32","freebsd","openbsd","android","sunos"];
+  console.log(color(`\n====== GLMCode 自检 (v${VERSION}) 真实平台=${realPlat} ======`,C.cyanB));
+  for(const p of platforms){
+    console.log(color(`\n[平台模拟] ${p}`,C.cyanB));
+    try{setPlat(p);}catch(e){push(`${p}/设置platform`,false,e.message);continue;}
+    try{const s=shellInfo();push(`${p}/shellInfo`,typeof s.exe==="string"&&s.exe.length>0,`exe=${s.exe} name=${s.name}`);}catch(e){push(`${p}/shellInfo`,false,e.message);}
+    try{
+      const cases=p==="win32"
+        ?[{n:"cmd",want:["/d","/s","/c","echo hi"]},{n:"powershell",want:["-NoProfile","-Command","echo hi"]}]
+        :[{n:"bash",want:["-lc","echo hi"]},{n:"zsh",want:["-lc","echo hi"]},{n:"fish",want:["-c","echo hi"]},{n:"csh",want:["-c","echo hi"]}];
+      let ok=true,det="";
+      for(const c of cases){const r=buildShellArgs({name:c.n,exe:c.n},"echo hi");if(JSON.stringify(r.args)!==JSON.stringify(c.want)){ok=false;det+=`${c.n}->${JSON.stringify(r.args)} `;}}
+      push(`${p}/buildShellArgs`,ok,ok?`${cases.length} 分支正确`:`MISMATCH ${det}`);
+    }catch(e){push(`${p}/buildShellArgs`,false,e.message);}
+    try{const c=openUrlCandidates("https://example.com");push(`${p}/openUrlCandidates`,Array.isArray(c)&&c.length>0,`${c.length} 候选: ${c.map(x=>x[0]).join(" → ")}`);}catch(e){push(`${p}/openUrlCandidates`,false,e.message);}
+    try{const pm=detectInstaller();const q=pm?installCmd(pm,"vim"):null;push(`${p}/installer探测+命令`,true,`pm=${pm||"(无,符合预期)"} cmd=${q||"-"}`);}catch(e){push(`${p}/installer探测+命令`,false,e.message);}
+    try{setPlat(realPlat);}catch{}
+  }
+  console.log(color("\n[真实平台功能]",C.cyanB));
+  try{
+    const {file,args:shA}=buildShellArgs(shellInfo(),"echo glm_selftest_ok");
+    const r=spawnSync(file,shA,{cwd,encoding:"utf8",timeout:60000});
+    const detail=`file=${file} args=${JSON.stringify(shA)} status=${r.status} err=${r.error&&r.error.message} out=${JSON.stringify(String(r.stdout||"")).slice(0,50)}`;
+    push("run_shell 真实执行",String(r.stdout||"").includes("glm_selftest_ok"),detail);
+  }catch(e){push("run_shell 真实执行",false,e.message);}
+  try{const tmp=fs.mkdtempSync(path.join(os.tmpdir(),"glmselftest-"));saveJson(path.join(tmp,"c.json"),{a:1});const v=readJson(path.join(tmp,"c.json"),{});push("配置 save/load",v.a===1,"ok");}catch(e){push("配置 save/load",false,e.message);}
+  try{const r1=execTool("write_file",{path:"_glmselftest.tmp",content:"hello"});const r2=execTool("read_file",{path:"_glmselftest.tmp"});try{fs.unlinkSync(path.join(cwd,"_glmselftest.tmp"));}catch{}push("write_file/read_file",r2==="hello",`read->${JSON.stringify(r2)}`);}catch(e){push("write_file/read_file",false,e.message);}
+  try{
+    const d=path.join(SKILLS_DIR,"demoskill");fs.mkdirSync(d,{recursive:true});
+    fs.writeFileSync(path.join(d,"SKILL.md"),"---\nname: demoskill\ndescription: demo\n---\n# demo\nsay hi\n");
+    await loadSkills();
+    const ok=skills.has("demoskill");
+    try{fs.rmSync(d,{recursive:true,force:true});}catch{}
+    push("SKILL.md 技能加载",ok,`skills=${skills.size}`);
+  }catch(e){push("SKILL.md 技能加载",false,e.message);}
+  try{
+    const AdmZip=(await import("adm-zip")).default;
+    const az=new AdmZip();az.addFile("demo/SKILL.md",Buffer.from("---\nname: demozip\n---\n# z\nhi\n"));const zf=path.join(SKILLS_DIR,"demo.zip");az.writeZip(zf);
+    await extractZipSkills();
+    const ok=fs.existsSync(path.join(SKILLS_DIR,"demo","SKILL.md"));
+    try{fs.rmSync(path.join(SKILLS_DIR,"demo"),{recursive:true,force:true});fs.unlinkSync(zf);}catch{}
+    push("zip 技能自动解压+扁平化",ok,"SKILL.md 已到位");
+  }catch(e){push("zip 技能自动解压+扁平化",false,e.message);}
+  try{const items=filterItems("/mod");const found=items.some(x=>x.startsWith("/model"));push("TUI 命令实时过滤",found,`/mod -> ${items.length} 项`);}catch(e){push("TUI 命令实时过滤",false,e.message);}
+  try{const st=statusText();const mx=menuMax();push("TUI 状态栏/菜单高度",st.includes("思考:")&&mx>=1,`len=${st.length} max=${mx}`);}catch(e){push("TUI 状态栏/菜单高度",false,e.message);}
+  console.log(color(`\n========== 自检完成: PASS ${pass} / FAIL ${fail} (${Date.now()-t0}ms) ==========`,fail>0?C.red:C.green));
+  process.exit(fail>0?1:0);
+}
+
 async function main(){
  loadConfig();const a=loadAuth();if(!a){console.log(color("未检测到 GLM API Key。",C.red));console.log(`API Key 页面: ${API_KEYS_URL}`);console.log("获得 Key 后运行: glmcode auth set <API_KEY>");process.exit(1);}
  apiKey=a.key;await ensureDeps();await loadSkills();logo();console.log(color(`API: ${mask(apiKey)} (${a.source})`,C.green));console.log(color(`模型: ${config.model}   技能: ${skills.size}`,C.gray));console.log("");
- promptLoop();
+ runTui();
 }
 const argv=process.argv.slice(2);
+if(argv[0]==="--selftest"||argv[0]==="selftest"){await selftest();}
 if(argv[0]==="--version"||argv[0]==="-v"){console.log(VERSION);process.exit(0);}
 if(argv[0]==="--help"||argv[0]==="-h"){console.log(`GLMCode ${VERSION}
 启动: glmcode
+TUI: 输入 / 或字母实时弹出悬浮命令菜单，↑↓ 键选择，Tab 补全，Enter 执行
+    底部常驻状态栏：思考开关 / 模型 / 技能数 / 当前目录
 斜杠命令: /help /clear /thinking /model /pwd /cd /ls /cat /run /install /exit
-输入 / 或前缀自动弹出命令菜单，Tab 补全，底部常驻状态栏。
 技能: 将 SKILL.md 目录或 .zip 包放入 skills/ 自动加载。
 认证: glmcode auth set <API_KEY> | auth status | auth logout | auth login
 Shell: glmcode shell | shell list`);process.exit(0);}