前言¶

在 DeepSeek Harness（DSH）里让智能体操作 Word、Blender、GitHub 或本机 Chrome，常见做法是为每个上游 MCP 单独写进 profile、自己管进程与升级。组件一多，启用顺序、依赖运行时（uv、Node）和 OAuth 令牌路径就容易散在多处。dsh-work-components 把「控制其他工作软件」的 MCP 服务器收进一个客户端插件：用设置页下载、启用和重挂，并以 @deepseek-ai/dsh-mcp-client 子插件挂载，不写进 profile，卸载插件时一并卸掉；设置改动后只重挂受影响的组件。

这是什么¶

dsh-work-components（npm 包名同名）由维护者 meya-ashuripehya 发布，归类为 DSH 客户端插件。一句话定位：带设置页的 DSH 插件，用于统一下载、启用并挂载面向 Office、创作工具、Windows 桌面、Notion、Cloudflare、GitHub、ComfyUI 等的工作组件 MCP，并附带多模态发图、地图与网页卡片、日历、牌类、GameBot、Telegram 通道等能力。目录页：https://www.skillhub.cn/plugins/meya-ashuripehya/dsh-work-components；源码：https://github.com/meya-ashuripehya/dsh-work-components。

自有代码采用 MIT 许可证；vendor/dsh-tools/ 为 DeepSeek 代码副本，许可与保留义务见仓库 NOTICE。插件与 DeepSeek 及各第三方产品无隶属或授权关系，文中产品名仅说明兼容对象。

工作组件 MCP 一览¶

每个工作组件对应一套 MCP 服务器与固定工具名前缀。新鲜安装时所有工作组件 MCP 与会话控制均默认关闭（*Enabled: false），需在设置页「工作组件」里逐个打开「启用」才会挂载。

各组件依赖的 uv、Python 或 Node 运行时，可在设置页「下载安装」到插件数据目录的 tools/。具体桥接、端口与项目侧配置在设置 UI 完成，README 不逐步重复。

另已内嵌 GameBot（src/components/gamebot/）与 桌面控制（DSHDesktopBroker.exe，通用分组里启用；npm 包已含 exe，git 检出需 npm run build:desktop，要求 .NET SDK 8+）。

设置页与多模态¶

DSH 设置中的「工作组件」页按分组列出功能：行首图标、行尾实时状态，点进管理页可下载安装、配置、「启用」。

多模态

• 媒体卡片：mm_send_image 将本地图片转为 Host attachmentId，在 turnTail 以 MmCard 展示。
• 日历（默认开启）：calendar_show、calendar_event_save、calendar_event_delete；公历、农历、节气与中国法定节假日离线计算（Asia/Shanghai）；日程存于数据目录 calendar/events.json；天气走 Open-Meteo，可填「天气城市」。
• 地图（默认关闭）：启用并保存高德 Web 服务 Key 后，提供地理编码、检索、路线、天气预报、地图标点与可点击路线图（GCJ-02）；Key 仅保存在设置页。
• GPT Image 2 生图（默认关闭）：配置 API Key、Base URL（默认 https://api.openai.com/v1）、模型（默认 gpt-image-2）后注册 image_generate 与 image_edit；出图保存到数据目录 images/<YYYY-MM-DD>/。

牌类（默认关闭）：card_open、card_look、card_play 等；支持二十一点、勒杜克扑克、限注德州、UNO、斗地主；规则源 RLCard 需在设置页下载到数据目录，不随包分发。

还支持 本地兼容 目录 local-components/<id>/ 下的用户模块，以及 Telegram 通道、会话控制（需 zstd）等，详见仓库 README 与设置页分组。

数据目录¶

插件不向包目录写入状态（升级会替换整个包目录）。可写数据位于 $DSH_HOME/data/dsh-work-components/（DSH_HOME 缺省 ~/.dsh；可用 DSH_WORKBENCH_DATA_DIR 改根路径）：

GET /dsh-workbench/api/settings 对密钥字段返回占位 __dsh_secret_saved__；POST 带回占位表示不变，空字符串表示清除。

安装与启用¶

在 DSH Desktop 中通过内置 plugin_manager 安装 bundle，不要在 profile 目录自行跑 npm / pnpm。

对智能体说明安装意图，例如：

用 plugin_manager 的 install_bundle 安装 npm 包 dsh-work-components

建议步骤：

1. 优先从 npm 安装（发布包已含 lib/ 构建产物）。若 plugin_manager 列出待批准的构建脚本，确认来源后再批准 dsh-work-components 的 prepare（pnpm ≥10 可能需在 profile 的 pnpm-workspace.yaml 中允许该包）。
2. 用 list_bundles / list_plugins 确认 dsh-work-components 已启用；结果为 restart-required 时重启 DSH Desktop。升级替换版本后同样需要重启。
3. 打开设置页「工作组件」，按需「下载安装」各组件并打开「启用」。

卸载使用 plugin_manager 的 remove_bundle；数据目录不随包删除，需时手动清理。

环境要求（来自 README）：DSH Desktop；Node ^22.19 || >=24（与 package.json 的 engines 一致）；会话控制需 zstd。Office、Photoshop、Windows、桌面控制等组件仅 Windows 可用。桌面控制随 npm 包分发 exe，一般无需单独安装 .NET。

典型用法¶

装好后可在设置页打开「启用」，并调用多模态工具做冒烟，例如让智能体使用 mm_send_image 发送一张本地图片，确认 MmCard 与 toolview 表现符合预期。

需要操作本机软件时，先在对应组件管理页完成「下载安装」与连接说明中的前提（如 Blender 插件、Obsidian Local REST API），再启用组件；智能体侧可见的工具名均带表中前缀，例如 GitHub 相关为 mcp__github__。

日历类可直接调用 calendar_show 查看月历与日程；地图、生图、牌类等功能需先在设置页打开对应分组并保存配置（如高德 Key、OpenAI API Key）。

适用场景与注意¶

适合谁：已在用 DSH Desktop、希望在一个插件里集中管理多类「工作软件 MCP」的开发者或高级用户；需要对话内发图、日历卡片、可选地图与生图、牌桌或 GameBot 等扩展能力时也可一并启用。

权限与安全：插件以当前 DSH 进程权限运行。Gmail 的 send_message、生图工具上传本机图片到第三方、Telegram 对部分工具的授权限制等，安装前应阅读源码与 MIT 许可证，并理解 OAuth、PAT、应用专用密码的存放位置（如 %USERPROFILE%\.mcp-auth、设置 API 掩码行为）。image_generate / image_edit 在 Telegram 侧仅对所有者触发的回合开放。

平台：多类组件依赖 Windows 或特定桌面软件常驻；非 Windows 用户仍可选用 Chrome、Notion、GitHub、Cloudflare Docs、ComfyUI 等与本机环境匹配的子集。

社区目录 SkillHub 与 DeepSeek / 幻方无官方从属关系，插件为社区维护作品。

结尾¶

dsh-work-components 把分散的工作类 MCP 收成可管理的客户端插件：设置页负责下载、启用与重挂，数据与工具落在独立数据目录，并叠加多模态与日历等对话能力。进一步了解分组与截图见仓库 README「设置页」与「实装截图」。

• 目录页：https://www.skillhub.cn/plugins/meya-ashuripehya/dsh-work-components
• GitHub：https://github.com/meya-ashuripehya/dsh-work-components