开发者平台

KOOK & DeepSeek Harness 插件使用说明

「咕噜咕噜~人家是迷路到KOOK海域的鲸鱼娘啦!你愿意点一下『领养』,把我这只圆滚滚的小鲸鱼捞回家吗?我会每天吐泡泡给你看,还会用尾巴拍水花哄你开心哦

1. 先准备好

你需要:

  • 一台正在运行 DSH 的电脑,并且能在 DSH 里正常和模型聊天。
  • 一个 KOOK 机器人,以及它的 Bot Token。
  • 你自己的 KOOK 用户 ID。
  • 插件安装包。

如下流程为对KOOK不熟悉的同学的教程,如果熟悉,请忽略并跳过。

  1. 打开 KOOK 开发者平台,创建应用和机器人,连接方式选择 WebSocket,取得 Bot Token。

机器人基本设置

  1. 打开 "机器人" -> "邀请链接", 生成邀请链接。copy这个邀请链接。

邀请链接

  1. 打开KOOK,注册登录。"右下角头像" -> "个人设置" -> "高级设置" -> "开发者模式", 将开发者模式打开。

开发者模式

  1. 点击 + 创建服务器。然后在浏览器中, 把上面的邀请链接打开,把机器人邀请进你创建的服务器。
  2. 在服务器中,右键自己头像, copy用户ID

Token 相当于机器人的密码,不要发给别人。用户 ID 是一串数字,不是昵称,也不是 Token。

2. 安装插件

  1. 打开你平时使用的 DSH 页面。
  2. 进入 插件 → 安装,输入 dsh-kook@0.3.4 安装dsh-kook插件

安装dsh-kook

  1. 启用 dsh-kook。
  2. 刷新 DSH 页面。
  3. 打开 插件 → 已安装 → dsh-kook,找到 KOOK 机器人设置页。

已经安装的用户:更新到 0.3.2 或更新版本,再刷新页面。不要重复安装多个使用相同 Token 的机器人实例。

3. 第一次只配这些

建议先让机器人在私聊里正常回复,再开其他功能。

页面上的项目 第一次怎么设置
Bot Token 粘贴 KOOK 开发者平台里的机器人 Token
工作目录 点击“选择目录”,选一个已经存在、准备用来工作的文件夹
允许的用户 ID 填你自己的 KOOK 用户 ID;多个用户每行填一个,你可以先把上面你copy的自己的id填上
允许的频道 ID 先留空
允许私聊 打开
自动转发频道消息 先关闭
模型供应商、模型、Agent 预设 先保留“跟随 DSH 默认”
陌生人配对审批 先关闭
其他项目 保持默认即可

配置好后,点击 保存设置。

工作目录选的是运行 DSH 的电脑上的目录。如果你用另一台设备打开 DSH 页面,它不一定是当前设备的文件夹。

保存后 Token 输入框不显示原来的内容,这是正常的。以后改其他配置时,不用重新填 Token。不要点击“清除 Token 并停用连接”,除非你想关闭机器人连接。

4. 发第一条消息

在 KOOK 中找到机器人,私聊发送:

你好,请用一句话介绍自己。

收到回答,就说明基本配置成功了。

机器人依赖 DSH 运行。使用期间,要让运行 DSH 的电脑保持开机、联网,DSH 也要保持运行。

想在 DSH 里看这段对话:打开左侧工作区,找到刚才选择的工作目录对应的工作区。也可以在 KOOK 私聊发送 /status,取得会话 ID 后核对。

5. 日常最常用的几个命令

在机器人私聊里直接发送:

想做什么 发送什么
正常聊天 直接发送文字
停止当前任务 /stop
重新开一段对话 /new
查看当前会话 ID /status
查看自己的长期记忆 /memory
查看帮助 /help

/new 后,再发一条普通消息,就会创建新会话。旧聊天记录不会因此删除,长期记忆也不会因此清空。

如果机器人提示“等待本地确认”,打开 DSH 对应会话,在那里完成审批或回答问题。

6. 想在频道里使用

  1. 把机器人加入目标服务器,确认它有查看频道和发送消息的权限。
  2. 在插件设置里,把目标频道 ID 填入 允许的频道 ID。
  3. 把需要使用机器人的人的 ID 填入 允许的用户 ID。
  4. 点击 保存设置。

默认在频道里这样说话:

/dsh 帮我解释一下这个问题。

频道里用命令也要带前缀,例如:

/dsh /status
/dsh /new

如果不想每次输入 /dsh,打开 自动转发频道消息,再保存。开启后,允许用户在允许频道中的普通文字也会提交给 DSH。

频道回复对频道成员可见。私聊里的内容和个人信息,建议继续在私聊里讨论。 配对批准目前用于私聊;需要频道使用权限,仍请添加允许的用户 ID。

7. 想让机器人有自己的性格

在 机器人性格设定 中填入你希望它如何说话。例如直接复制:

你是一位耐心、友好的中文助手。
先给结论,再做简短解释。
尽量使用简单的语言,不要堆砌术语。
不知道的事情明确说不知道,不要编造。

点击 保存设置,之后提交的新消息会带上这份设定。你也可以在网上找到一些人设设置进去(比如鲸鱼娘等).

8. 想让陌生人先经过你同意

  1. 确认 允许私聊 已打开。
  2. 打开 陌生人配对审批。
  3. 在 主人 KOOK 用户 ID 中填写你自己的用户 ID。
  4. 保留你自己在 允许的用户 ID 中,点击 保存设置。

之后,未获授权的人私聊机器人时,会先收到六位配对码,你也会收到通知。

愿意让对方使用,就在你与机器人的私聊里发送:

/approve 123456

把示例数字换成通知里的真实配对码。批准后,让对方再发一条消息即可。

暂时不想批准,就不执行批准命令;对方不会因此获得使用权限。已在“允许的用户 ID”列表中的人无需配对。

9. 长期记忆怎么设置

不确定怎么填,就保持默认:

项目 建议值 意思
每次使用的记忆条数 8 每次回答最多参考多少条记忆
记忆半衰期(月) 6 大约每过 6 个月,旧记忆的权重减半

记忆按 KOOK 用户分别保存。衰退不是“到了 6 个月自动删除”,而是旧记忆被参考的机会逐渐降低;也不保证每句话都能永远记住。

发送 /memory 可以查看当前仍能检索到的记忆。只想重新开始聊天时用 /new,但它不会清空长期记忆。

10. 想给机器人一份资料

使用 知识库文件:

  1. 准备一份 TXT 或 Markdown 文件,使用 UTF-8 编码,大小不超过 1 MiB(约 1 MB)。

  2. 不同主题之间空一行,例如:

    营业时间:周一到周五,上午九点到下午六点。
    
    售后规则:收到商品后七天内,可联系工作人员咨询退换。
  3. 在插件设置中点击知识库文件选择控件,选中这份文件。

  4. 确认页面显示已导入的文件名,点击 保存设置。

  5. 向机器人问一个与资料有关的问题。

每次使用的知识条数先保持 5 即可。插件按关键词寻找相关段落,并不保证每次都能匹配到全部资料。

导入保存的是当时的内容。原文件改了,要重新选择文件并保存,机器人才能读到新版内容。 当前不直接导入 PDF、Word 或图片,请先整理成文本。

11. 出问题时,按这个顺序检查

机器人完全不回复

  1. 先在 DSH 中发一句话,确认 DSH 自己能正常回答。
  2. 确认插件已启用,DSH 正在运行且电脑联网。
  3. 确认填的是 Bot Token,并且已经保存设置。
  4. 私聊时,检查“允许私聊”和你的用户 ID。
  5. 频道里,检查频道 ID、用户 ID、机器人频道权限;默认要加 /dsh。

提示“处理失败”

先确认使用的是 0.3.2 或更新版本。新版会显示具体错误码和编号。

提示里出现 先怎么处理
MODEL_UNAVAILABLE 先确认 DSH 能聊天,再在插件里刷新并重选模型
PRESET_UNAVAILABLE 重新选择可用的 Agent 预设,或跟随默认
WORKSPACE_CHANGED、PRESET_CHANGED 设置与旧会话不同,发送 /new 后再发消息
SESSION_RESUME 旧会话恢复失败;不需要继续旧对话时,可 /new
SESSION_OWNED 旧会话由 DSH 其他组件持有;可 /new 建立独立会话
ROUTE_SAVE、MEMORY_SAVE 检查磁盘空间和保存目录是否允许写入
WORKSPACE_ATTACH 检查工作目录是否还存在,并查看 DSH 的存储状态
其他错误,或处理后仍失败 保留完整错误码和编号,用于进一步排查

寻求帮助时,说明“私聊还是频道”“发了什么操作”“出现什么错误码”,不要发送 Token。

DSH 里看不到 KOOK 对话

  • 更新到 0.3.2 或更新版本,并刷新 DSH 页面。
  • 查看插件配置目录对应的工作区,而不是只看当前打开的对话。
  • 在 KOOK 发送 /status 核对会话 ID。
  • 如果消息当时没有成功提交给 DSH,就不会有相应聊天记录。

改配置后任务停了

这是当前版本的行为:保存设置会重新应用连接,并停止插件当前持有的任务。尽量等一轮回答完成后再改配置。 改了工作目录或 Agent 预设后,发送 /new 再开始聊天。

12. 哪些设置先不要动

高级存储与兼容设置保持默认即可,不需要手动改会话文件、记忆文件或环境变量。

第一次使用,只要完成这几个动作就够了:安装插件 → 填 Token → 选择工作目录 → 填自己的用户 ID → 打开私聊 → 保存 → 给机器人发“你好”。