Harness 知识库插件

连接和使用 Dataki 知识库, 在问答中 复用知识、 主动保存, 并将每日对话新知识沉淀入库。

核心原则 正式知识存 Dataki;每日自动提取知识先存 Harness,经本人确认后写入 Dataki。
🔍 会话检索
多选库 · 思考收拢引用
💬 主动记忆
自然语言触发 · 直存免审
✍️ 手动维护
三字段 · 免审直存
📄 文件导入
解析预览 · 确认写入
🕒 每日 03:00 学习
提取用户原话 · 待确认
Harness 绑定与权限网关 按 用户 + 项目 隔离
知识库连接
≤10个/项目 · Key复用
绑定与共享
≤50个 · 个人/只读/可编辑
个人偏好独立
默认保存库(≤1) · 检索开关
Harness 待学习暂存与核对 仅本人可见

暂存每日提取建议(未确认不参与检索)→ 选目标库比对(≤40篇遍历 / >40篇检索候选)→ 本人确认且获 Dataki 回执后转正式知识。

🗄️
Dataki 远端正式知识库
统一保存正式知识;解除 Harness 绑定不删除 Dataki 文档;文件文档正文只读。
业务术语 业务规则 指标口径

【全景流程图】端到端业务流转与存储边界

01
绑定与共享
连接≤10 · 绑定≤50
① 选择连接或输新 Key
拉取目录阶段不保存 Key;同 Key 自动复用连接
➔
② 确认绑定 & 行内切范围
默认: 仅个人 共享·只读 共享·可编辑
➔
③ Harness 存绑定与偏好
按用户+项目隔离;解绑仅删绑定,保留 Dataki 文档
02
维护与导入
手动 · 文件 · 复制
A. 手动维护:填标题+分类+内容
B. 文件导入:MD/TXT/PDF/DOCX ≤5M
➔
解析预览 & 权限校验
• 手动新增无草稿/免审核;停用后不参与检索
• 文件解析期间锁重选,预览确认前不写 Dataki
➔
🗄️ 直写 Dataki 正式库
多条逐条保存,部分失败保留已完成防重;支持跨可写库独立复制
03
会话检索与记忆
问答复用 · 主动保存
提问检索:读取当前会话所选库
主动记忆:“记住这条口径规则”
➔
• 检索:步骤与引用收进思考过程(失败明确报错)
• 记忆路由: ①指定库➔ ②默认库➔ ③无默认则追问
➔
🗄️ 直写 Dataki & 正常回复
不弹二次审核卡片;若尚在索引则提示“已保存,处理中”
04
每日学习核对
03:00 定时 · 仅本人
① 提取用户原话新事实
排除 AI 回答/引用;先存 Harness 待学习(未确认不参与检索)
➔
② 选“学习到”目标库并比对 (≤40遍历 / >40检索)
新知识
确认/改
更新已有
看Diff
已收录
仅忽略
有冲突
人工判
失败
可重试
➔
③ 本人确认 ➔ 写 Dataki
取得 Dataki 保存成功回执后,才标记该待学习建议为“已处理”

【对象与权限】核心对象、隔离规则与权限矩阵

对象与隔离

六大对象定义与隔离规则

  • 个人绑定按“用户+项目”隔离。
  • 项目共享需绑定人显式开启。
  • 两人分别绑定同一 Dataki 库时:远端内容相同,绑定设置与个人偏好独立。
1. 知识库连接
通过 API Key 建立,1个连接可访问多个库
2. 知识库绑定
绑定到当前用户 + 当前 CubeData 项目
3. 项目共享
开放给当前项目成员(只读 / 可编辑)
4. 会话知识库
当前会话允许 AI 检索和读取的库集合
5. 默认保存库
当前项目保存会话知识的默认库(≤1个)
6. 待学习知识
对话自动提取、尚未由本人确认的建议
👤 用户 A:仅个人 · 默认保存 ✓ · 检索开
🗄️ 同一 Dataki 库 (内容相同)
👤 用户 B:共享只读 · 无默认保存 · 检索关
权限矩阵

围绕“绑定人”和“共享成员”划分

不依赖 CubeData 项目管理员角色。
注¹:仅适用于可写文档库并受 Dataki 授权约束;文件文档正文不支持在 Harness 直接编辑。

操作 绑定人 共享只读成员 共享可编辑成员
查看、检索知识 支持 支持 支持
新增、导入、编辑、启停知识 支持¹ 不支持 支持¹
设为自己的默认保存库 支持¹ 不支持 支持¹
调整自己的对话检索开关 支持 支持 支持
修改共享范围、解除原绑定 支持 不支持 不支持
查看、处理他人的待学习知识 不支持 不支持 不支持

【八大功能需求】核心规则与流程示意

需求 01

1. 知识库绑定与管理

  • 入口与列表:侧栏“知识库 → 管理绑定”,支持搜索与分页;绑定人优先显示真实用户名(否则显示 ID)。
  • 新增双路径:① 从已有连接选未绑定库;② 输新 Key 拉目录(拉目录不存 Key,确认绑定才存;同 Key 复用连接)。
  • 范围与解绑:默认“仅个人”,行内下拉立即切换(失败恢复原值);解绑仅删 Harness 绑定,不删 Dataki 文档。
  • 配额限制:每用户每项目最多 10 个连接、50 个自有绑定。
管理绑定(连接 ≤10 · 绑定 ≤50)
知识库名称 使用范围 绑定人 对话检索 默认保存 操作
商业化指标口径库 项目共享·可编辑 ▾ 张安东 开启 解除绑定
买量归因规则库 仅个人 ▾ u_902814 开启 解除绑定
公共术语库 (他人共享只读) 项目共享·只读 李明 开启 禁用(无写权限) 不可解绑
需求 02

2. 知识浏览与维护

  • 左导航 + 右工作区:依次进入列表 → 详情 → 编辑,返回列表保留页码与搜索条件。
  • 三字段表单:仅填标题、分类、内容(标题与分类同行且标题更宽,正文独立;无需填别名/场景)。
  • 直存与启停:直接保存无草稿审核;停用后不参与检索;无写权限隐藏写入口。
  • 文件阅读:文件文档直接在当前工作区阅读,不弹二层弹窗。
右侧工作区
标题(更宽): A项目有效首充定义
分类: 指标口径 ▾
内容(独立展示): 统计角色首次实付 > 0 订单(排除 0 元礼包与测试服 9999)。
需求 03

3. 文件导入

  • 整合在“新增知识”内(无顶层导入按钮),支持 MD / TXT / PDF / DOCX(≤5 MiB,无 OCR)。
  • 解析中显示动画并禁用保存/重选;确认前不写 Dataki。
  • 多条逐条保存,部分失败保留已完成状态防重;超长、空知识或损坏等分别明确提示。
1. 选文件
≤5MiB
2. 解析提取
锁定重选/保存
3. 展示预览
未写Dataki
4. 确认保存
逐条防重
条目 1:ARPU 计算口径✓ 已保存 (保留状态)
条目 2:跨服活跃度口径⚠️ 失败 · 仅重试本条
需求 04

4. 会话知识检索

  • 三态显示:全部知识库 / N个知识库 / 未启用知识库(菜单仅含全选与库选项)。
  • 按用户、项目、会话保存状态;取消全选停止后续检索并保留已有聊天。
  • 检索步骤与引用统一收进思考过程;检索失败明确报错,不显示“没有相关知识”。
输入框检索状态切换
▾ 思考过程(已收拢检索步骤与 2 篇引用资料,不堆叠对话卡片)
📚 全部知识库 ▾ 菜单仅保留:[✓ 全选] + 知识库列表
需求 05

5. 会话主动记忆

  • 用户表达“记住这个口径”,AI 整理事实并按三级规则路由保存目标。
  • 保存后正常回复,不弹二次审核卡片;索引中说明“已保存,处理中”。
  • 默认保存库采用互斥勾选框(≤1个,无写权限时禁用)。
1. 明确指定库
➔ 存入该指定可写库
2. 未指定但有默认
➔ 存入个人默认保存库
3. 未指定且无默认
➔ 询问用户,绝不猜测
🤖 AI 回复:“已保存,处理中”(Dataki 索引中) 免二次审核卡片
需求 06

6. 每日学习与知识核对

  • 每日 03:00 提取:仅提取用户原话新事实/补充/更正(排除 AI 回答、工具结果与引用知识)。
  • 仅本人可见:未确认不参与检索;获 Dataki 保存回执后才标记已处理;切库重新核对。
  • 核对范围:≤40 篇遍历全文;>40 篇检索最多 40 篇候选(未读完提示“部分内容未核对”)。
5 种核对结果与操作:
目标库:商业化指标口径库 ▾ 核对结果:新知识
展示待保存正文;相关资料按需展开
用户原话:“S9998 也是压测服,统计流水时一并剔除。”
收到 Dataki 回执后标记已处理
需求 07

7. 跨知识库复制

  • 支持单条/批量将手动知识复制到可写库(副本独立维护,部分失败不回滚)。
  • 不支持整库复制;文件文档及 >16,000 字手动文档在 Dataki 处理。
  • 只读库手动知识可从详情页复制,列表不显示批量选择。
需求 08

8. 空状态与通用交互

  • 首次无库且无待学习:居中展示“绑定知识库”主按钮,隐藏空导航与搜索栏。
  • 无待学习记录时不显示分类占位;空可写库有新增引导,空只读库无新增。
  • 反馈统一用全局 Toast;编辑/导入/绑定离开页面有未保存保护。

【异常与验收】异常规则、12项验收与待评估清单

数据与异常规则(6 项)

1. 撤回共享或降为只读
立即按新权限执行,清除受影响成员默认保存目标。
2. Key 失效或无权限
明确提示授权问题,不切换到他人凭证继续访问。
3. 保存期间文档已变化
提示刷新并重新编辑,避免基于旧内容覆盖提交。
4. 写入超时/断线结果未知
标记“写入待核实”,避免自动重复创建。
5. 解除绑定
保留 Dataki 文档;删最后一个绑定时清理连接凭证。
6. 用户或项目切换
绑定、偏好、待学习数据保持隔离(显式共享除外)。

产品验收清单(12 项)

后续待评估(非本期范围)
1. 知识列表整库搜索
2. 扫描件 PDF OCR
3. Dataki 原生细粒度权限展示
4. 多人同时编辑原子冲突保护
5. 多 Host 部署支持
6. 完整运营埋点和效果统计