从 RBAC 到 CLI/API/MCP 收官之作
WeKnora 详解系列 · 第 04 篇(收官)
各位数码圈的老铁们,我是叨叨数码。
不知不觉,这个 WeKnora 系列已经写到第 4 篇了——前 3 篇咱们聊了"怎么跑起来"、"怎么接数据"、"怎么调检索和模型",按数码圈的话讲,硬件、软件、生态都拆完一遍了。
那这第 4 篇收官之作,咱聊点啥?
聊"怎么用得稳 + 怎么用得深"——对应两块硬核内容:
- 🏢 企业治理:权限、加密、审计、合规——让 IT 部门能拍板"上线"
- 🛠️ 开发者工具:CLI、API、MCP Server、扩展、小程序——让程序员能玩出花
这一篇是整个系列里"最硬"的一篇,但也是最能体现 WeKnora "企业级" 三字含金量的一篇。
按数码圈"测完硬件要拆机看做工"的惯例——今天咱们把 WeKnora 的"做工"拆给你看。
一、权限:4 级 RBAC,把"谁能干啥"写在规矩里
在企业里推一个 AI 系统,IT 部门第一个问题永远是:"权限怎么配?"
这个好理解——总不能让实习生也能删掉公司所有产品文档吧。
WeKnora 给了一套4 级 RBAC 权限模型,从大到小:
| 角色 | 权限范围 | 数码类比 |
|---|---|---|
| Owner(所有者) | 租户最高权限:管理成员、配置平台、管理所有知识库 | 手机厂商 CEO |
| Admin(管理员) | 管理知识库、配置系统、管理租户内用户 | 产品线经理 |
| Contributor(贡献者) | 上传/编辑/删除知识库内容、发起对话 | 内容运营 |
| Viewer(查看者) | 仅可查看知识库内容、发起对话 | 普通用户 |
资源隔离也做得够细:每个知识库都有独立的所属权配置,不同租户的资源完全隔离,跨租户访问?门儿都没有。
叨叨的实操建议:
- 🔹 老板/部门负责人:Owner 角色(数量控制在 1-2 个)
- 🔹 IT 管理员 / 业务方对接人:Admin 角色
- 🔹 内容运营 / 文档维护:Contributor 角色
- 🔹 普通员工 / 客服:Viewer 角色
权限分配要遵守"最小权限原则"——能 Viewer 就不给 Contributor,能 Contributor 就不给 Admin。这跟手机 App 申请权限一个道理。
如果你想细究每个角色的具体权限矩阵,可以去翻 docs/RBAC说明.md,里面写得明明白白。
二、安全:加密 / 沙箱 / 防护,3 层铠甲
如果说 RBAC 是"门禁系统",那安全体系就是"铠甲 + 盾牌 + 武器"。
WeKnora 在 v0.6.0 之后把安全层做了个大满贯升级,覆盖 4 个核心维度:
第一层:数据加密(AES-256-GCM)
所有 API 密钥、MCP 服务凭证、数据源凭证,全部静态加密存。
什么叫"静态加密"?就是数据写进数据库的那一刻就是密文,就算有人把整个数据库 dump 走,看到的也是一串乱码。
而且支持"平滑密钥轮换"——这个太关键了。传统做法是:换密钥必须停机,否则新老密钥不一致会出问题。WeKnora 不用,轮换过程业务不中断,对生产环境友好度拉满。
数码类比:像 iPhone 的"高级数据保护"——数据上锁、钥匙定期换、换钥匙过程你完全无感。
第二层:传输安全(gRPC TLS + Token)
应用服务和 docreader 之间的 gRPC 通信默认开启 TLS 加密,同时支持 Token 鉴权。
这意味着什么?就算内网被监听,抓包也只能看到加密数据流,看不到具体内容。
数码类比:像 Wi-Fi 6E 的 WPA3 加密——协议级安全,不是应用层糊一层。
第三层:SSRF 防护
这是企业最容易被忽视、但后果最严重的攻击点——SSRF(服务端请求伪造)。
通俗讲:黑客诱导你的服务器去访问内网敏感地址(比如 127.0.0.1、192.168.0.1),把内部数据偷出来。
WeKnora 内置了SSRF 安全 HTTP 客户端,所有外部 HTTP 请求都过一遍白名单校验,默认禁止访问内网地址。
这一条,对所有要上生产的项目都是必选项。少了它,分分钟被安全团队打回来。
第四层:Agent 沙箱执行
ReAct Agent 调外部工具时,默认在沙箱里跑。
就算有恶意代码想"越狱",也跑不出沙箱的边界。
数码类比:像 iOS 系统的"App 沙盒"——App 之间互相隔离,恶意 App 也影响不到系统。
三、审计:每一步都留痕,合规党狂喜
企业上线任何一个系统,合规部门都要问:"出了问题能不能追溯?"
WeKnora 给的回答是:"能,每一步都留痕。"
每个租户都有独立的审计日志,记录:
- 📝 用户管理操作(新增/删除/权限变更)
- 📝 知识库变更(创建/删除/文档上传)
- 📝 配置修改(LLM 切换、模型参数调整)
- 📝 对话调用(谁问了什么、AI 回了什么)
- 📝 权限变更(谁被提权/降权了)
支持按操作类型、时间、操作人三个维度筛选查询,金融、政务、医疗这种重合规行业直接用。
数码类比:像行车记录仪 + 飞机黑匣子——平时没用,出事就是唯一证据。
四、可观测:Langfuse 全链路追踪 + E2E 评估
这一节是程序员和运维的福音。
WeKnora v0.6.1 之后移除了 Jaeger,全栈只留一个追踪后端——Langfuse。这个决定很果断,但选得很对——工具太多反而没人用。
Langfuse 追踪能看到啥?
- 🧠 ReAct 循环全流程:每一步推理、每次工具调用都看得…