快速开始
这一页带你走完一遍：装好 KnowWork，接上模型，建一个知识库，然后在对话里问出第一个带出处的回答。整个过程大约 30 分钟，大部分时间在拉镜像。
准备
| 项目 | 要求 |
|---|---|
| 服务器 | 一台 Linux 服务器，x86_64，4 核 8 GB 起步；装好 Docker 24+ 与 Docker Compose v2.24+ |
| 交付物 | 授权文件（*.license）、镜像仓库只读账号、交付包 know_work_<版本>_<日期>.tar.gz |
| 模型服务 | OpenAI 兼容接口：至少一个对话模型；用知识库还要一个向量模型；重排序模型可选 |
| 文档解析 | 一个 MinerU 服务，用来解析 PDF、Word、PPT |
模型和 MinerU 都由你们自己提供，KnowWork 不内置。模型可以是 DeepSeek、通义千问等云服务，也可以是自建的 vLLM、SGLang。
一、安装
# 1. 解压交付包，进入目录（之后的命令都在这个目录里执行）
tar -xzf know_work_v0.0.3_20261028.tar.gz && cd know_work_v0.0.3_20261028
# 2. 放授权（目录里只放一份）
cp /path/to/xxx.license license/
# 3. 登录镜像仓库（账号密码是交付给你的只读账号）
docker login crpi-6q638zy09wmnj70w.cn-hangzhou.personal.cr.aliyuncs.com
# 4. 启动：拉镜像、起服务，等到打印「KnowWork 已就绪」和访问地址
./install-pro.sh
浏览器打开打印出来的地址（默认 http://<服务器 IP>:8080）。云服务器要用公网地址访问时，见安装部署。
二、创建管理员
第一次打开会进入初始化向导，填邮箱、姓名和密码，创建第一个账号。
这个账号是唯一的系统管理员
初始化建的第一个账号就是系统管理员：只有它能配模型、文档解析、新建空间和看系统设置，而且目前不能新增或转交。建议用 IT 部门的公共邮箱（例如 it-admin@你的公司域名）建，账号交给 IT 负责人保管，不要用某位员工的个人账号。详见角色与管理员。
三、接入模型
用系统管理员登录，点左下角的账号菜单 →「管理后台」→「模型」。
- 在「厂商」页添加模型服务：填名称、API 地址（OpenAI 兼容的
.../v1）和 API Key。 - 在「模型」页点「添加模型」，选刚才的厂商：
- 对话模型：能力勾「对话」，别名填
default。智能助手默认用的就是叫default的模型； - 向量模型：能力勾「向量」，知识库靠它做语义检索；
- 重排序模型（可选）：能力勾「重排序」，让检索排序更准。
- 对话模型：能力勾「对话」，别名填
- 每个模型点一下「测试」，确认调得通。
详细说明见模型与文档解析。
四、接入文档解析
还是在「模型」里，切到「文档解析」页：打开「启用文档解析」，填 MinerU 地址，保存后立即生效，不用重启。
不配文档解析时，PDF、Word、PPT 解析不了；Excel、CSV、纯文本照常能用。
五、建知识库并上传文档
- 回到工作台，点左侧「知识库」→「新建知识库」，填名称和描述，嵌入模型选第三步加的向量模型。
- 打开知识库，在「文档」页上传文件。列表里能看到每份文档的解析状态，变成「就绪」就能用了。
- 切到「检索测试」，问一句文档里有的内容，看能不能命中。
六、第一次提问
回到「新对话」，在输入框里输入 @，选刚建的知识库，然后提问。回答里的编号点开就是原文，能直接核对。
七、让同事用起来
- 邀请同事：「管理后台」→「成员」→「邀请新用户」，把生成的链接发给对方；
- 建组织：「部门与用户组」里照公司架构建部门，把人放进去；
- 授权：「资源授权」里把知识库目录授权给部门，部门里的人就能查。
推荐的初始设置顺序见资源授权。