dsh-chatbox-compat

简体中文 · English

给从 Chatbox / Cherry Studio 迁到 DeepSeek Harness 的人，补回三样东西。

Chatbox 用户换到 DSH 之后，最不习惯的通常是这三件事：

1. 记忆看不见、删不掉
2. 不知道自己开了哪些能力
3. 长对话没法带进新对话

这个插件把这三件事按 Chatbox 的交互补回来。

状态：0.1.0 · 优先支持 Windows · 针对 DSH Desktop 0.2.x 编写 用到的是 DSH 的内部插件契约（slot / tool 注册 / 会话日志），不是稳定的公开 API。 rc 版本之间随时可能失效，详见 兼容性。

---

功能

功能	说明
记忆管理页	在输入框上方点「⚙ 工作模式 → 记忆」，能看到全部条目、逐条删除、一键关掉全局注入。AI 也能用 memory_save / memory_delete / memory_search / memory_list 增删查
模式面板	对话模式 / 工作模式切换；Skills 与 MCP 每条独立开关（真实生效，不是摆设）
压缩对话	「打包到新对话」→ 自定义压缩提示词 + 附加要求 → 生成 handoff 摘要，复制后贴到新会话
温度 HUD	Windows 下显示 CPU（ACPI 热区）与 GPU（nvidia-smi）温度，无需管理员、不装第三方工具
本地知识库	SQLite + FTS5，中文按二元组切分。索引目录后模型可用 kb_search 检索

安装

DSH Desktop 没有 dsh plugin add CLI，所以用附带脚本完成同样的动作（建目录联接 + 写 cordis.patch.yml，改前自动备份）：

# 1. 下载并解压到任意目录，例如 D:\tools\dsh-chatbox-compat
cd D:\tools\dsh-chatbox-compat
powershell -ExecutionPolicy Bypass -File .\install.ps1

脚本会：

1. 探测 %APPDATA%\dsh-desktop\harness
2. 把本目录 link 到 profiles\web\node_modules\dsh-chatbox-compat
3. 往 profiles\web\cordis.patch.yml 追加一条 insert 记录（备份到 harness\backups\）
4. 初始化 memory\MEMORY.md 与 chatbox-compat\settings.json

然后完全重启 DSH Desktop。

卸载：

powershell -ExecutionPolicy Bypass -File .\uninstall.ps1

记忆、设置、知识库都会保留。

首次使用

1. 记忆是空的 —— 对 AI 说「记住：…」就会写入，或直接在面板里看。
2. 知识库是空的 —— 面板 → 知识库 → 填一个目录 → 点「索引」。默认根目录是 %USERPROFILE%\kb。
3. 压缩需要 API key —— 从 harness\.credentials.yaml 的 DEEPSEEK_API_KEY 读取（在 DSH 里登录过就会有）。没有 key 时按钮会提示而不是静默失败。

配置

环境变量	默认	说明
DSH_HOME	%APPDATA%\dsh-desktop\harness	Harness 主目录
DSH_COMPAT_PORT	43210	HTTP 端口，被占用时自动 +1（最多试 12 次）
DSH_KB_DIR	%USERPROFILE%\kb	知识库默认根目录
DSH_HANDOFF_MODEL	deepseek-chat	压缩用的模型
DSH_HANDOFF_ENDPOINT	https://api.deepseek.com/chat/completions	压缩用的接口（可指向自建/代理）

兼容性

项	值
实测环境	DSH Desktop 0.2.1-rc.2（Windows 11）
声明范围	>=0.2.0 <0.3.0
未验证	0.1.x、0.3.x、macOS、Linux

为什么这条很重要。 除了 HTTP 接口，这里几乎所有东西都踩在 DSH 的内部实现上：

• UI 槽位 conversation.input.dock —— 改名后按钮会静默消失
• 工具契约 ctx.tools.register（output.schema / output.render）
• 提示注入 ctx.systemPrompt.variable / .section
• 会话日志格式 session.v4.jsonl.zstd（多帧 zstd）

任何一个 rc 都可能改动其中一项。更新 DSH 之后如果面板或按钮不见了，先查这里。

怎么查自己的版本：DSH Desktop → 设置 → 关于；或读 %APPDATA%\dsh-desktop\harness\.desktop-install-state.json 里的 harnessVersion。

提交 issue 前，请附上这两段输出：

Get-Content "$env:APPDATA\dsh-desktop\harness\.desktop-install-state.json"
Get-Content "$env:APPDATA\dsh-desktop\logs\harness.log" -Tail 80

已知限制

• 只测过 DSH Desktop 0.2.1-rc.2。slot 名（conversation.input.dock）和各服务的结构属于内部契约，0.1.x / 0.3.x 可能不兼容。
• 温度只支持 Windows。其他平台会自动隐藏温度那一行。
• 压缩后不会自动新建会话。SDK 里 sessions.create + session.prompt 还没验证稳定，所以现在是「复制 → Ctrl+Alt+N → 粘贴」。
• 知识库是关键词检索，不是向量检索。中文靠二元组，语义相近但用词不同的内容会漏。
• 不是一个进程隔离的插件。它跑在 harness 进程里，崩溃会影响 DSH（已做大量 try/catch，但没有沙箱）。

目录结构

lib/index.js     host：记忆、知识库、温度、压缩、HTTP 与工具注册
lib/client.js    浏览器侧：HUD、模式面板、压缩弹窗
install.ps1      安装（junction + patch）
uninstall.ps1    卸载（保留数据）

License

MIT