快速开始
桌面端：从安装到问出第一个问题
普通用户推荐直接用桌面端：安装包内嵌完整后端，双击即用，不需要任何命令行。
1. 下载安装
到官网 grzhishiku.com 下载 Windows 安装包或便携版：
- 安装版：双击安装，支持自动更新；
- 便携版：解压即用，数据放在程序同级目录，适合放 U 盘（不支持自动更新，需手动下载新版）。
安装后启动，程序会常驻系统托盘；内嵌后端首次启动约需一分钟健康检查，请稍候。
2. 注册账号
首次打开按引导本地注册账号——永久免费，数据只存在你本机。之后如需云端备份、充值按量余额，再绑定云端账号即可。
3. 选模型
打开「设置 → AI 设置」，按预算三选一（界面上有「免费 / BYOK 自付 / 按次价」标签，不会选错）：
- 本地模型（免费）：自装 Ollama 后
ollama pull qwen2.5:0.5b即可；Pro 会员可直接用模型管家一键装好，全程不碰命令行； - 免费池（免费）：☁️ 标签为「免费」的模型，每日 10 次对话，开箱即用；
- 云端按量 / BYOK：充余额用平台模型（不需会员），或开 Pro 自填 8 家厂商 API Key。
4. 导入第一批内容
从「采集」入口任选其一，先喂点东西进去：
- 批量导入：一次导入多条笔记、剪藏和链接；
- 浏览器书签：导入浏览器导出的书签 HTML；
- 浏览器剪藏：装扩展后一键保存网页；
- 笔记管理 / 便签墙：直接手写。
入库后会自动打标签、自动向量化，无需手动整理。
5. 问第一个问题
打开「AI 问答」（或右下角对话栏），问一个与你刚导入内容相关的问题，按 Enter 发送。回答会基于你的知识库检索，并给出可点回原文的引用来源。
桌面端还可以用全局热键：Ctrl+Shift+N 快记、Ctrl+Shift+J 唤起对话，完整列表见快捷键大全。
环境要求（自托管 / 开发）
- Docker + Docker Compose（推荐）
- 或 Node.js 20+ + Python 3.11+
Docker 一键启动
bash
git clone https://github.com/motuo520/grzhishiku.git
cd grzhishiku
cp backend/.env.example .env
# 编辑 .env：至少设置 SECRET_KEY、ADMIN_SECRET_KEY、DATABASE_ENCRYPT_KEY
docker compose up -d访问：
- 前端：
http://localhost:3000 - API：
http://localhost:8000 - API 文档：
http://localhost:8000/docs
创建管理员
注册一个普通账号后，将其提升为管理员：
bash
cd backend
./.venv/bin/python -m scripts.create_admin user@example.comWindows：
bash
.venv\Scripts\python.exe -m scripts.create_admin user@example.com本地开发
后端
bash
cd backend
python -m venv .venv
source .venv/bin/activate # Windows: .venv\Scripts\activate
pip install -r requirements.txt
cp .env.example .env
uvicorn app.main:app --reload --port 8000前端
bash
cd frontend
npm install
npm run dev浏览器打开 http://localhost:3000。
桌面端
bash
cd desktop
npm install
npm run dev:embedded打包：
bash
npm run dist输出在 desktop/release/。
浏览器扩展
bash
cd browser-extension
npm install
npm run build在 Chrome 扩展管理页加载 dist/ 目录。