@lininn/zz

AI 编码助手 CLI —— zz 命令。

安装

npm install -g @lininn/zz

要求 Node.js >= 24。

使用

终端 TUI 模式

zz

启动交互式终端 UI，与 AI 对话编码。

单次提问

zz -p "用 Python 写一个快速排序"

Web 聊天页面

zz --web

启动本地 Web 服务器（默认端口 3030）并自动打开浏览器，在浏览器里与 AI 聊天。

端口被占用时自动切换到下一个可用端口。也可手动指定：

zz --web --web-port 8080

模型配置页

zz --web-config

打开浏览器配置自定义模型 Provider（Claude / OpenAI 兼容接口），配置写入 ~/.zcode/ 。

其他常用命令

zz --version          # 查看版本
zz --help             # 查看帮助
zz doctor             # 诊断环境信息
zz login              # 登录
zz plugin             # 插件管理
zz skills             # 技能管理

远程控制（手机操控 PC）

1. PC 上启动 zz --web（或 TUI 模式）
2. PC 上运行 connector（zcode-relay 的 connector），绑定账号
3. 手机浏览器访问中转地址，登录后即可远程操控 PC 上的 ZCode

中转服务器支持多版本共存：手机端看到的页面版本与 PC 端运行的 ZCode 版本自动匹配。

配置

• 配置目录：~/.zcode/
• Provider 配置：~/.zcode/v2/personal-provider-config.json（通过 zz --web-config 编辑）
• 环境变量：
  • ZCODE_WEB_STATIC_ROOT — 指定 web 静态文件目录（zz --web 托管）
  • PORT — server 端口（默认 3030）

许可证

详见项目 LICENSE 文件。