# 念念 · 客户端安装包（v0.13）

Mac / Windows / Linux 本机 Agent + Console（`client` profile）。

## 架构

```text
本机 Agent  127.0.0.1:18765  ← Chat / MCP / VP / memory / vault / wiki
NAS 控制面  https://<nas>/    ← login / push / pending-fetches
```

安装包 **不** 内置 tenant_init · **不** 改 Docker 镜像。

## 快速开始（Mac · Gate-1）

```bash
# 开发：从仓库根目录
bash client/mac/install.sh

# 公网用户：下载对应平台 zip 解压后
#   macOS:   bash client/mac/install.sh
#   Linux:   bash install.sh
#   Windows: install.cmd
bash client/scripts/health-check.sh
open http://127.0.0.1:18765/niannian/settings
```

**Pages 发布包：** `bash client/scripts/build-pages-release.sh` → 上传 `client/download/` 到 Cloudflare Pages（见 [download/releases/README.md](download/releases/README.md)）。

## 目录

| 路径 | 说明 |
|------|------|
| `scripts/build-console-client.sh` | 构建 client profile Console |
| `scripts/start-local-agent.sh` | 前台启动本机 Agent |
| `scripts/health-check.sh` | 探活 `/health` |
| `mac/install.sh` | macOS 安装 + launchd |
| `linux/install.sh` | Linux systemd 用户服务 |
| `windows/install.ps1` | Windows 计划任务 + 启动脚本 |
| `config/client-agent.env.example` | 环境变量模板 |

## 数据目录

| 平台 | `NIANNIAN_HOME` 默认 |
|------|------------------------|
| macOS | `~/Library/Application Support/NianNian` |
| Linux | `~/.local/share/niannian` |
| Windows | `%LOCALAPPDATA%\NianNian` |

## 首次向导（Settings 页）

1. **NAS 控制面 URL** — `control_plane`
2. **本机 Agent** — 默认 `http://127.0.0.1:18765`
3. **登录** — tenant 无密码 · owner 弹窗 RSA
4. **LLM BYOK** — 在 LLM 页配置

## 相关

- [v0.13 qa-checklist](../docs/superpowers/specs/2026-07-01-v0.13-client-split-qa-checklist.md)
- [deploy/desktop/README.md](../deploy/desktop/README.md)
