Personal 桌面版安装

Personal 是 niuniu 的单机本地版本：所有数据存在你电脑的 SQLite 文件里，不需要服务器、不需要 PostgreSQL，启动就能用。

系统要求

• macOS 11+（Apple Silicon 或 Intel）—— 系统自带 WKWebView，无额外依赖
• Windows 10+ x64 —— 需要 Microsoft Edge WebView2 Runtime
  • 普通 Win10 / Win11 家庭版 / 专业版自带该组件
  • LTSC、企业精简版、Windows Server、IoT 等版本默认不预装，需要手动下载 “Evergreen Standalone Installer”（x64）安装
  • 如果缺失，niuniu-personal 启动时会弹出原生提示框引导你打开下载页 —— 安装后重新启动即可
• Linux glibc 2.31+ x64 —— 需要系统 WebKitGTK 库（缺失时进程会因为动态链接器失败而无法启动）
  • Debian / Ubuntu：sudo apt install libwebkit2gtk-4.1-0
  • Fedora / RHEL：sudo dnf install webkit2gtk4.1
  • Arch / Manjaro：sudo pacman -S webkit2gtk
  • 服务器精简版 / 最小化镜像通常缺这个包
• 已安装 Claude CLI
• 已安装 git ≥ 2.30

下载

访问 GitHub Releases，找到最新版本，下载：

平台	文件名
macOS Apple Silicon	niuniu-personal-<版本>-darwin-arm64
macOS Intel	niuniu-personal-<版本>-darwin-amd64
Windows	niuniu-personal-<版本>-windows-amd64.exe
Linux	niuniu-personal-<版本>-linux-amd64

<版本> 即 release tag，例如 v1.0.7。

首次启动

macOS / Linux：下载后给文件加可执行权限（chmod +x niuniu-personal-*）再双击启动。macOS 首次运行可能需要在 系统设置 → 隐私与安全性 里允许”开发者未签名”。 Windows：双击 .exe，可能需要批准 SmartScreen 提示。

启动后浏览器会自动打开 http://localhost:3000。

默认账号

• 用户名：niuniu
• 密码：niuniu123

登录后建议立即去 设置 → 用户 修改密码。

数据目录

所有数据保存在 ~/.niuniu/：

~/.niuniu/
├── config.yaml          # 配置
├── niuniu.db            # SQLite 数据库
├── personal.boot.lock   # 单实例锁
└── users/<id>/          # 你的 workspace、repository 目录

迁移到新机器只需要复制整个 ~/.niuniu/ 目录。

升级

下载新版本，覆盖旧二进制。数据库会自动迁移，无需手动操作。强烈建议升级前备份 ~/.niuniu/。

下一步

• 5 分钟快速上手 跑通第一个 workspace
• 团队协作请看 Team 团队版安装