开始之前
- 需要一台运行 macOS、Windows 或 Linux 的电脑。
- 需要 Shisa AI 账户。你可以在设置过程中创建或连接账户。
- 请先使用可以安全试验的文件夹。重要工作应保留备份或使用 Git。
1. 什么是终端？
终端是一种用文字向电脑发出指令的应用。输入命令后按 Enter。Jouzu 在终端中运行。你不需要背命令，本指南会提供准确的输入内容。
如何打开
macOS
- 1.按 Command + Space。
- 2.输入“终端”或 Terminal。
- 3.按 Enter。
Windows
- 1.打开开始菜单。
- 2.输入 Windows Terminal。
- 3.选择 Windows Terminal 或 PowerShell。
Linux
- 1.打开应用菜单并搜索 Terminal。
- 2.许多桌面也可用 Ctrl + Alt + T 打开。
2. 安装 Jouzu
选择你的电脑
先安装 Node.js 22.19 或更高版本、Git 和 Bash，然后在终端运行： 下载 Node.js
npm install -g jouzu安装完成后，确认 Jouzu 可用：
jz --version看到 Jouzu 和 Pi 版本信息即表示成功。
3. 打开项目文件夹
Jouzu 可以读取和修改启动位置文件夹中的文件。cd 命令用于进入文件夹。请将示例路径替换为你自己的路径。
cd ~/Documents/my-project然后启动 Jouzu：
jzProject trust
4. 连接 Shisa AI 账户
在 Jouzu 中输入下面的命令并按 Enter。浏览器会打开；登录并批准连接，然后返回终端。
/login shisa浏览器显示连接成功后，Jouzu 会刷新 Shisa 模型目录。
5. 选择模型
打开模型选择器，选择一个 Shisa 模型并按 Enter。如果不确定，请选择 Jouzu 显示的默认模型。
/model/status随时可用 /status 查看当前模型和文件夹。
6. 完成首次任务
先从容易检查的小任务开始。说明你的目标、相关文件或区域，以及怎样判断任务完成。
首次提示示例
请阅读这个项目，但不要修改文件。说明它的用途、列出主要文件夹，并告诉我如何运行现有测试。后续提示示例
现在请把你找到的测试命令写入 README。编辑前先向我展示修改计划。接受前先检查
7. 常用命令
/status | 显示当前文件夹、模型和上下文用量。 |
|---|---|
/model | 选择模型。 |
/settings | 更改语言、账户、目录等设置。 |
/hotkeys | 列出当前终端中有效的快捷键。 |
/voice | 开始或停止语音输入。 |
/scrollback | 将对话导出到终端回滚区以便搜索。 |
/bug | 生成可检查后提交的公开 Issue 草稿。 |
/quit | 退出 Jouzu。 |
8. 故障排除
jz: command not found
安装后关闭并重新打开终端，然后运行 jz --version。仍失败时，请重新安装或检查 npm 全局 bin 文件夹是否在 PATH 中。
浏览器登录后没有返回 Jouzu
批准连接后返回终端。如果已超时，请再次运行 /login shisa。在远程机器上，使用终端显示的手动 URL 或代码。
没有显示 Shisa 模型
运行 /catalogs 并刷新 Shisa 目录。也可以先运行 /logout shisa，再运行 /login shisa。
Jouzu 正在等待或自动工作停止
运行 /flow。它会说明被保留的请求、等待和暂停的工作，并显示解除所需的准确操作。
语音输入不可用
语音需要具备实时语音权限的 Shisa 账户。运行 /login shisa，然后用 /voice devices 检查麦克风。
Windows 安装程序被阻止
确认 Windows 显示的发布者为 Shisa Inc.，并与公开的 SHA-256 校验和比对。如果发布者不匹配，不要绕过警告。
在 Jouzu 外运行下面的命令，可生成只读诊断报告：
jz doctor