# 念念客户端

本机 Agent + NAS 控制面 · 记忆在云端 · Chat 走 127.0.0.1

## 下载

按系统选择安装包 · 解压 · 运行包内安装脚本（需 Python 3.10+）。

各平台包已预构建 Console，无需 git、无需 npm。

macOS Linux Windows

owner（pinn） 在 Settings 登录后，将自动启用三云凭证续期并同步到 NAS（SMB）；tenant 无此能力。

### macOS

    unzip niannian-client-mac.zip -d NianNian && cd NianNian
    bash client/mac/install.sh
    # 或双击「安装.command」
    open http://127.0.0.1:18765/niannian/settings

### Windows

    解压 niannian-client-win.zip 到 C:\NianNian
    双击 install.cmd
    # 或：powershell -ExecutionPolicy Bypass -File client\windows\install.ps1

### Linux

    unzip niannian-client-linux.zip -d NianNian && cd NianNian
    bash install.sh

## 首次配置

- Settings · NAS 控制面 URL（HTTPS 域名）
- 登录 · tenant 无密码 · owner（pinn）RSA · 登录后自动云同步到 NAS
- 云同步 · SMB 挂载 persist/config · 极空间手动重启 api/worker
- LLM · 自备 API Key（BYOK）

公网 NAS 仅提供登录 API与本下载页，不提供完整 Console。