前言¶
DeepSeek Harness（DSH）采用「一切皆插件」的架构，开发者可以通过插件扩展模型来源。现有插件大多对接公开 API，需要用户提供 API Key。而商汤「小浣熊」桌面应用自带的模型（如 GLM-5.3、Kimi-K3、DeepSeek-V4.1-Flash 等）目前只能通过桌面端使用，无法直接在 DSH 的对话窗口里调用。
DSH 小浣熊 Connect 插件解决的就是这个问题：它把小浣熊桌面端的模型接入 DSH，在 DSH 的模型选择器里直接选、直接用，不需要填写任何 API Key。
这是什么¶
这是一个为 DeepSeek Harness（DSH）准备的模型推理插件，由开发者 zhlcba 维护。它把商汤小浣熊桌面应用中的模型列表与登录态复用到 DSH 中，让 DSH 的对话窗口能直接使用小浣熊的模型。
插件支持 DSH 0.2.x 内核（实测 0.2.1-rc.2），与上游只支持 0.1.5-rc.1 的版本不同，本 fork 在内核兼容性上做了适配。
安装与启用¶
前置条件：本机已安装并登录商汤小浣熊桌面应用。插件不启动它、也不代替它登录。
安装插件（Desktop profile；Web 端把 desktop 换成 web）：
dsh plugin --profile desktop add dsh-raccoon-connect
# 或直接从 GitHub 安装
dsh plugin --profile desktop add github:zhlcba/dsh-raccoon-connect
安装完成后，完全退出 DSH（含托盘）再重新打开。在模型选择器里找到「商汤小浣熊」分组，即可选择模型开始对话。
核心功能¶
直接复用桌面端登录态¶
插件不要求用户提供任何 API Key，直接复用商汤小浣熊桌面端写入本地 agent 的凭据文件（默认 ~/.box-agent/config/auth.json）。只要桌面端曾经登录过、凭据在有效期内，关闭桌面应用后插件依然可用。只有首次登录、凭据失效或切换账号时才需要打开桌面端。
模型列表与计费信息¶
插件从小浣熊的目录接口获取模型列表，模型名后面会显示上游目录里的计费倍率和促销标签，例如：
GLM-5-3-Flash · x0.10 · 限时折扣SenseNova-6.8-Flash-Lite · x0.00 · 限免一个月
倍率仅用于显示，不影响实际请求；促销标签按时间窗口实时重算，过期后自动回到原价。
图片输入能力¶
插件的图片输入能力按逐个模型的实测结果判定，而不是照抄目录标签。当前按实测声明支持识图的是 SenseNova-6.8-Flash-Lite、Kimi-K3、GLM-5-3-Flash、DeepSeek-V4.1-Flash；GLM-5-3 声明为纯文本，DSH 不会往里塞图片。当目录标签与实测不一致时，可以通过配置项 visionModelIds / textOnlyModelIds 手工纠正。
思考内容透传¶
上游把思考内容放在非标准的 delta.reasoning_content 字段中，插件原样透传，DSH 侧照常显示 reasoning 流。
信息查看与诊断¶
在 DSH 的设置 → 插件 → 「商汤小浣熊」卡片中，可以查看账号、身份（个人/企业）、令牌有效期、剩余积分、当前模型列表来源（实时 / 已保存 / 内置兜底）与最近一次失败原因，也可以手动刷新模型列表。
命令行诊断命令：
dsh plugin --profile web exec dsh-raccoon-connect status # 登录态、令牌有效期、剩余积分
dsh plugin --profile web exec dsh-raccoon-connect doctor # 诊断：路径、心跳、客户端标识、兜底名册
dsh plugin --profile web exec dsh-raccoon-connect logout # 删除插件自留的凭据副本与备份
配置¶
插件卡片没有这些字段的编辑控件，需要修改 profile 的补丁层 ~/.dsh/profiles/web/cordis.patch.yml（Desktop profile 路径类似）。在配置文件中追加一段针对 llm-raccoon 的配置：
- id: llm-raccoon
config:
visionModelIds: [] # 强制按「能识图」提供的模型 id
textOnlyModelIds: [] # 强制按「纯文本」提供的模型 id，优先级高于上一行
visionModelIds / textOnlyModelIds 用于在目录标签标错时兜底：新模型能发图却被标成纯文本，把 id 加进前者即可；反向同理。
依赖与限制¶
- 插件依赖小浣熊客户端的非官方接口，App 升级后可能需要跟着改。凭据文件路径与刷新语义是最可能变的两处。
- 只在 Windows 上真机验证过。macOS/Linux 逻辑相同但未实测；若不匹配，可以用环境变量
RACCOON_AUTH_FILE指向实际文件。 - 目录里的
params.context_window/max_tokens是唯一依据；上游没给的模型按保守值处理，不猜测大窗口。 - 个人版
X-Org-Code目前留空即可；企业版未验证。 - 使用者需遵守商汤小浣熊的服务条款，本插件仅供个人学习和研究使用。
免责声明¶
- 本项目仅供个人学习和研究使用，仅驱动使用者自己的小浣熊账号在本机调用，请勿用于商业用途或超出个人合理使用的场景。
- 使用者需遵守商汤小浣熊的服务条款；因使用本项目产生的任何后果（包括账号被限制、额度被清空、服务中断、登录态被刷新覆盖）由使用者自行承担。
- 本项目作者不对任何因使用或滥用本项目产生的直接或间接损失负责。
总结¶
DSH 小浣熊 Connect 插件解决了 DSH 用户无法直接使用商汤小浣熊桌面端模型的痛点，通过复用桌面端登录态，实现了开箱即用的模型接入体验。它支持 DSH 0.2.x 内核，提供了模型列表、计费信息、图片输入能力等实用功能，适合已经在使用小浣熊桌面端，希望在同一界面下管理所有模型对话的用户。
目录与源码¶
- 技术文档：https://www.skillhub.cn/plugins/zhlcba/dsh-raccoon-connect
- GitHub 仓库：https://github.com/zhlcba/dsh-raccoon-connect
- 国内镜像：https://gitee.com/dhzl/dsh-raccoon-connect
