设置增强套件 kazecreator/dsh-settings-pro

@kazecreator/dsh-settings-pro

English ·

DeepSeek Harness「设置 Pro」插件——一个包、五个功能：IM Bridge、用量、记忆、宠物、视觉。

快速上手

1. 把包安装进 profile：

dsh plugin --profile add @kazecreator/dsh-settings-pro

是 profile 名（Web GUI 对应 web）；该命令会在 profile 目录里转发给 pnpm。

2. 在 cordis.patch.yml 里挂载插件：

- insert:
- id: dsh-settings-pro
name: '@kazecreator/dsh-settings-pro'
config: {}

3. 重启 DSH，让新插件加载。

4. 打开 Web GUI →「设置 Pro」，把想要的功能打开即可——可以全开、开几个、或只开一个。默认全关，开了才运行，而且所有开关都是即时生效（无需重启）。

一段 prompt 完成安装 + 开启功能

这段 prompt 完全替代上面的「快速上手」——不需要先做那几步。DSH 的 agent 有文件读写权限，直接粘贴下面这段 prompt，把 [...] 换成你想要的功能即可，安装和开启它都会帮你做完：

用量和记忆是可选的，默认关闭；不写进 [...] 就不会开启，只开启你点名的功能。

把 @kazecreator/dsh-settings-pro 插件安装进这个 DSH profile，并开启这些功能：[用量, 记忆, 宠物, 视觉, telegram, wechat]。我没列出的功能一律保持关闭。

1. 安装包：在 profile 目录里运行 dsh plugin --profile add @kazecreator/dsh-settings-pro（或 pnpm add @kazecreator/dsh-settings-pro）。
2. 在该 profile 的 cordis.patch.yml 里加一条 insert，插件 id 为 dsh-settings-pro（name 为 @kazecreator/dsh-settings-pro），并在其 config 里只开启我指定的功能：
- 用量 → usageEnabled: true
- 记忆 → memoryEnabled: true
- 宠物 → petsEnabled: true
- 视觉 → visionEnabled: true（还需 visionBaseUrl、visionModel、visionApiKeyEnv——如果我没给，就向我询问）
- telegram → telegramEnabled: true（还需 telegramBotToken、telegramAllowedUserIds——如果我没给，就向我询问）
- wechat → wechatEnabled: true
3. 重启 DSH，让新插件加载。

agent 会安装包、写好 patch、只把你点名的 Enabled 键设为开启，其余全部关闭。重启后功能即生效；之后你仍可随时在「设置 Pro」里实时切换任意开关。

推荐最小配置

不想自己选？直接粘贴这个开箱即用版本——它开启无需额外配置的核心功能（用量、记忆、宠物；三者都可选、默认关闭），并保持 IM（Telegram/微信）与 视觉 关闭（它们需要额外 token/端点，默认 false / 空）：

把 @kazecreator/dsh-settings-pro 插件安装进这个 DSH profile，并按推荐最小配置开启：用量、记忆、宠物；保持 telegram、wechat、视觉关闭。

1. 安装包：在 profile 目录里运行 dsh plugin --profile add @kazecreator/dsh-settings-pro（或 pnpm add @kazecreator/dsh-settings-pro）。
2. 在该 profile 的 cordis.patch.yml 里加一条 insert，插件 id 为 dsh-settings-pro（name 为 @kazecreator/dsh-settings-pro），并在其 config 里设置 usageEnabled: true、memoryEnabled: true、petsEnabled: true。telegramEnabled、wechatEnabled、visionEnabled 保持不写（默认 false，视觉的 visionBaseUrl / visionModel / visionApiKeyEnv 保持空）。
3. 重启 DSH，让新插件加载。

之后你仍可在「设置 Pro」里随时开启 IM 或视觉——在此之前它们保持关闭（false / 空）。用量和记忆同样可选、默认关闭；只要宠物的话，配置里写 petsEnabled: true 即可，其它 Enabled 都不写。

功能一览

| 功能 | 作用 | 开启方式 |
| 用量 | DeepSeek 余额 + 官方计费的每日成本/tokens（峰谷计价） | 设置 Pro → 用量 → 开关 |
| 记忆 | 跨重启记忆 + read_memory / write_memory 工具 | 设置 Pro → 记忆 → 开关 |
| 宠物 | 跟随对话的桌面宠物 | 设置 Pro → 宠物 → 开关 |
| 视觉 | 在纯文本模型看图片前，先用任意 OpenAI 兼容 VLM 描述图片 | 设置 Pro → 视觉 → 启用 + 选模型 |
| IM Bridge | Telegram & 微信桥接（内置） | 设置 Pro → IM Bridge → token / 扫码 |

*Enabled 配置键（usageEnabled、memoryEnabled、petsEnabled、visionEnabled、telegramEnabled、wechatEnabled）也能作为安装时的初始状态，想给某个 profile 预开启某项时用。

桌面宠物 App（可选，Electron）

「网页」打开模式无需安装——直接在浏览器标签页打开 /pet。想要一个真正悬浮在桌面、置顶、可拖拽、点击能回到 DSH 的小窗口宠物，就用「App」模式：打开 设置 Pro → 宠物，在「桌面应用」卡片点 安装，插件会在本地装好 Electron 并启动宠物窗口；安装状态会持久化，关掉设置再进来也能看到「运行中 / 已安装」等状态。

不想用一键安装，也可手动跑源码仓库里的 pet-desktop/：cd pet-desktop && npm install && npm start。

可选环境变量（默认值如下）：

- DSH_PET_URL — 宠物页面地址，默认 http://127.0.0.1:3080/pet
- DSH_URL — 点击宠物时打开的 DSH 地址，默认 http://127.0.0.1:3080
- DSH_OPEN_MODE — 点击宠物打开 DSH 的方式：browser（默认）或 app
- DSH_APP_NAME — macOS 上「App」打开模式所用 Chrome PWA 的应用名，默认 DeepSeek Harness

说明

- 更新：插件每天检查一次 npm registry（启动时与设置页打开时，24 小时内复用缓存）。发现新版本时，「设置 Pro」导航项右侧出现 NEW 徽标；「关于」tab（最后一个 tab）展示插件信息、当前/最新版本、手动「检查更新」，并在 registry 安装且存在新版本时提供「更新并重启」按钮（在 profile 目录执行 pnpm add @kazecreator/dsh-settings-pro@latest 并重启 dsh 进程）。若插件以 file: 链接安装（本地开发目录），更新按钮隐藏，「关于」tab 会显示「安装方式：本地开发（file:）」行。
- 用量「自动同步」读取 Chromium 浏览器会话（macOS / Windows / Linux 上的 Chrome / Edge / Brave / Arc / Opera）来同步官方计费用量；Firefox / Safari 不支持。
- 桌面宠物 App 不随包分发。 默认「网页」打开模式在浏览器标签页打开 /pet，无需额外安装；「App」模式用「设置 Pro → 宠物 → 桌面应用」的一键安装按钮本地安装并启动 Electron 宠物窗口，安装状态持久化。也可手动运行源码仓库里的 pet-desktop/（npm install && npm start）。
- 在线宠物库从 GitHub 拉取——Awesome Codex Pet 社区画廊，作者 @legeling。感谢该项目及每一位宠物作者的开放投稿。本地有缓存，网络失败时回退到缓存/离线提示。