5 分钟快速上手
下载、启动、创建第一个 workspace、跑通 agent 对话。
本文用 Personal 桌面版作为路径，5 分钟跑通完整流程。
1. 下载
访问 GitHub Releases，下载对应平台的安装包：
- macOS：
niuniu-personal-<版本>-darwin-arm64（Apple Silicon）或niuniu-personal-<版本>-darwin-amd64（Intel） - Windows：
niuniu-personal-<版本>-windows-amd64.exe - Linux：
niuniu-personal-<版本>-linux-amd64
<版本> 即 release tag，例如 v1.0.7。下载后双击启动；第一次启动会要求填写一些基本配置（数据目录、是否启用认证），按默认即可。
2. 登录
默认账号：
- 用户名：
niuniu - 密码：
niuniu123
登录后进入控制台，你会看到三个主标签页：Workspaces / Projects / Repositories。
3. 添加仓库
切换到 Repositories 标签，点 + 新建，填入仓库本地路径或 git URL。niuniu 会自动检测分支和默认分支。
4. 创建项目并新建 issue
切换到 Projects，点 + 新建项目，关联刚才添加的仓库，进入项目后在看板默认列里 + 新建 issue，写一句要做的事。
5. 从 issue 启动 workspace
在 issue 详情侧栏点 创建 Workspace，niuniu 会自动：
- 创建一个新的 git worktree（基于默认分支）
- 在 workspace 目录下放好
.mcp.json（让 Claude Code 能读取项目状态） - 跳到 workspace 详情页
6. 启动 agent
workspace 详情页点 启动 Agent，左侧聊天框就可以开始对话。第一条消息试试：
请帮我看一下这个仓库的 README，总结一下这是个什么项目。Claude 会通过 PTY 终端调用 claude CLI，读取项目文件并回复。
下一步
- 了解 核心概念 —— Project / Repository / Workspace / Agent 是怎么关联的
- 阅读 Workspace 与 Agent 对话指南