工作区聊天机器人CodingYuanLiu/DSH-Chatbot-Plugin

工作区聊天机器人

一个 Cherry Studio 风格的聊天机器人插件，作为 DeepSeek Harness（DSH）动态 Cordis 插件运行：入口在侧边栏底部（设置上方），点开后在右侧主区域打开聊天面板。

功能

- 多助手：每个助手独立配置名称、系统提示词、提供商、模型、思考深度、temperature、maxTokens
- 多对话：每个助手可开多个对话，对话继承助手设置，自动以首条消息命名
- 流式输出：后台生成 + 增量轮询，打字机效果（带闪烁光标）
- 硬盘持久化：助手、对话、历史全部落盘 JSON，进程重启自动恢复
- 清除上下文：两步确认，彻底清空当前对话
- Markdown 渲染：助手消息支持标题、粗体、斜体、行内代码、代码块、列表、引用、链接、表格
- LaTeX 数学：$...$ 与 $$...$$ 以等宽数学块样式显示（见“已知限制”）

运行环境

本插件不是独立应用，依赖 DSH 的以下运行时机制：

- 动态 Cordis 插件：通过 cordis_define 定义、cordis_run 激活（详见下方“快速开始”）
- 运行时服务（Host 半边通过 ctx.get 读取）：
- llm —— 模型流式生成（listProviders / listModels / stream）
- fs —— 状态文件读写
- sandboxPolicy —— 部署工作区根（默认数据目录的候选之一）
- 浏览器端服务（Client 半边）：
- slots —— sidebar.footer.action（入口）与 shell.overlay（面板）
- timer —— 流式轮询间隔
- styles —— 样式注入

快速开始

1. 打开 DSH Web GUI，在会话中调用 cordis_define：
- 新插件：plugin.kind = 'new'，idPrefix 填 chatbot（或你喜欢的 3–6 位小写前缀）
- code.host 填 src/host.js 的整个函数体（从 return { 到结尾的 }）
- code.client 填 src/client.js 的整个函数体
2. 用返回的 pluginId / packageId 调用 cordis_run（首次用 mode: 'run'）。
3. 在 UI 中批准该运行（Client 半边需要授权；勾选双勾可自动放行后续版本）。
4. 刷新页面，点击侧边栏底部（设置图标上方）的 🤖 Chatbot 即可使用。

配置

所有部署相关配置集中在 src/host.js 顶部的 CONFIG 对象：

| 配置项 | 默认值 | 说明 |
| --- | --- | --- |
| dataDir | '' | 状态文件目录（绝对路径）。留空时自动选择：部署工作区根的 .chatbot/，再退回当前目录的 .chatbot/。建议填本机固定数据目录，如 '/home/you/.dsh' |
| fileName | 'chatbot-state.json' | 状态文件名 |
| defaultTemperature | 1 | 新助手默认 temperature（Cherry Studio 风格） |
| defaultMaxTokens | '' | 新助手默认 maxTokens；空字符串 = 不发送该参数（由模型自定） |

数据存储

状态保存在 dataDir/chatbot-state.json（或自动选定的候选路径），格式：

{
"assistants": [
{
"id": "a1",
"name": "默认助手",
"systemPrompt": "你是一个乐于助人的 AI 助手。…",
"provider": "",
"model": "",
"reasoningEffort": "",
"temperature": 1,
"maxTokens": ""
}
],
"conversations": [
{ "id": "c1", "assistantId": "a1", "title": "新对话",
"messages": [ { "role": "user", "text": "你好" } ] }
],
"seqA": 1,
"seqC": 1
}

删除该文件即回到全新状态。

已知限制

- LaTeX 不排版成公式：$...$ / $$...$$ 显示为等宽数学块，而不是 KaTeX 排版效果。动态插件无法引入第三方库（无打包器、无 import），真公式渲染需要产品级支持。
- 流式是轮询近似：Host 与 Client 之间只有单次往返 RPC，因此打字机效果靠 120ms 轮询模拟，而非原生 SSE/WebSocket。
- 侧边栏均分依赖 cordis 插件：入口与 cordis 插件并排各占一半宽度的 CSS 用 :has() 命中 cordis 的 DOM（data-cordis-badge）。如果你的部署没有 cordis 插件，可删除 src/client.js 中该段 CSS，并将 .dsh-cb-layer 的 flex: 1 1 0 改回 flex: none; width: 100%。
- 界面文案为中文：UI 字符串硬编码在 src/client.js 中，如需其他语言请自行替换。

License

MIT