回答附出处，点编号可看原文片段
Ingest
上传入库
上传后自动处理，通常几十秒内可检索。
1选择可写库
2上传文件
3等待向量化
Projects
项目库
一项目一库，code 即 collection_code，成员之外不可见。
创建项目
创建者自动成为负责人
添加成员
仅项目负责人或系统管理员可添加。先搜姓名 → 点选下拉 → 再点添加。
- 搜不到人：退出后重新「飞书登录」再试（需通讯录搜索权限）
- 提示「仅负责人可操作」：在下方成员列表把你自己设为负责人，或找管理员
我的项目
当前账号参与的项目库
加载中…
Libraries
我的知识库
点进某个库可查看文档、打开原文；有写权限时可删除或去入库。
加载中…
库文档
选择上方某个库查看文档列表
加载中…
Guide
新手指南
按步骤操作。不懂系统的人从这里跟做。
下面带「去…」的按钮可直接跳到对应功能，方便业务跟做。
先懂三个词
库
文档盒子。问答要选搜哪个库（如 fangxun）项目
一项目=一库，code 相同（项目 fangxun → 库 fangxun）入库
上传后要切块向量化；状态「已入库」才能搜到这不是网盘：传「结论/文档」，不要整仓源码。
流程 ① 第一次用（只查知识）
- 打开本站 → 飞书登录
- 左侧点 问答 → 顶部选「范围」
- 输入具体问题 → 发送
- 看答案下方 出处，点编号核对原文
流程 ② 新项目（例：fangxun）
本地文件再复杂也按这个顺序 · 点按钮即可跳转
-
项目 → 创建：code 填
fangxun，填名称 → 创建项目 - 同一页 添加成员（只读 / 可读写）；对方最好先登录过
- 决定传什么：docs / 方案 / 结论 md；不传整仓代码、node_modules、密钥
-
入库 → 目标库选
fangxun→ 选文件上传 - 我的库 → 点开 fangxun → 等状态变「已入库」
-
问答 → 范围选
fangxun→ 用文中词验证
- 文件很多：只盯文档目录自动同步（开发者拿 PAT + 本机 kb-watch），别监视整个源码树
- Git 管代码；知识库管「后人能问清的结论」
流程 ③ 接 Cursor（可选）
- 左侧 开发者 → 先选项目 → 创建 PAT → 复制 MCP JSON
- JSON 里会有
KB_COLLECTION=项目code；改本机 command/cwd 路径 - 粘贴到 Cursor → Settings → MCP；再去入库选同一项目
左侧菜单 · 一键跳转
底层（知道即可）
人 → kb.liaojietech.com
→ 登录/权限/上传编排
├─ 七牛存原文件
├─ 数据库记权限与状态
└─ 处理机：切块 · 向量 · 带出处回答
- 搜不到：多半还没入库、范围选错、或没有读权限
- 完整文档：仓库
docs/17-新手指南-怎么用与底层架构.md
Developer
开发者
签发 Cursor / MCP / 脚本用的个人访问令牌。
Cursor MCP · 项目令牌
流程：先建项目并加人 → 选项目创建 PAT → 把 JSON 存到该业务仓库的 .cursor/mcp.json（一项目一文件，分类上传）
- 人跟着项目：先在「项目」创建并加人，再来这里签发
- 创建时必须选择项目；一张 PAT 只绑定一个项目库
- API Base：
https://kb.liaojietech.com/api/kb - 复制 JSON → 放到业务项目
.cursor/mcp.json；用 Cursor 打开该文件夹即可（command/cwd 已指向本机知识库运行时） - 含 PAT 的文件勿提交 Git；其它电脑请改路径
原文