dsh-work-components（工作组件）

兼容 DeepSeek Harness（DSH）的插件，用来统一挂载和管理「控制其他工作软件」的 MCP 服务器（Office / 创作工具 / Windows 桌面 / Notion / Cloudflare / GitHub / ComfyUI 等）。每个工作组件以 @deepseek-ai/dsh-mcp-client 子插件的形式挂载：不写进 profile，随本插件卸载，设置改动后只重挂受影响的组件。

自有代码采用 MIT 许可证。vendor/dsh-tools/ 是 DeepSeek 的代码副本，版权归 DeepSeek，许可同样是 MIT，全文和保留义务见 NOTICE 与 vendor/dsh-tools/LICENSE。

文中的产品名称只用来说明兼容对象，是各自权利人的商标。本项目与 DeepSeek、微软、Blender Foundation、Unity Technologies、Figma、Adobe、Google、Godot Foundation、Notion、Cloudflare、GitHub、Comfy、FFmpeg、Obsidian 等没有隶属、赞助或授权关系。设置页图标是通用线条；仓库不收录第三方产品标志。插件自身设置页的实装截图见下文「实装截图」。

组件	MCP 服务器	工具名前缀	前提（简述）
Office	OfficeMCP（COM）	`mcp__officemcp__`	Windows + Office（Word / Excel / PowerPoint 等）
Blender	mcp-for-blender（PyPI）	`mcp__blender__`	Blender 开着并启用对应插件
Unity	mcp-for-unity / mcpforunityserver（Coplay）	`mcp__unity__`	Unity 编辑器装了 MCP for Unity 包并开着工程
Figma	figma-console-mcp（npm；也可改连官方桌面版 MCP）	`mcp__figma__`	Figma 桌面版 + Desktop Bridge（console）或 Dev Mode 官方 MCP
Photoshop	@alisaitteke/photoshop-mcp（npm，COM / ExtendScript）	`mcp__photoshop__`	Windows（或 macOS）装有 Photoshop 并开着
Chrome	chrome-devtools-mcp（npm）	`mcp__chrome__`	本机 Google Chrome；可独立启动或连已有实例
Windows	Windows-MCP（PyPI）	`mcp__windows__`	Windows；stdio 由插件拉起，或连已有 HTTP 服务
桌面控制	插件自带经纪人（UI Automation）	`mcp__desktop__`	Windows；随插件提供，打开「启用」即可，无需下载
Notion	Notion MCP（经 mcp-remote OAuth 桥）	`mcp__notion__`	首次 OAuth；token 在 `%USERPROFILE%\.mcp-auth`
Cloudflare	Cloudflare API MCP（经 mcp-remote）	`mcp__cloudflare__`	首次 OAuth（scope=offline_access）
Cloudflare Docs	Cloudflare Docs MCP（公开 HTTP）	`mcp__cloudflare-docs__`	无需登录
GitHub	GitHub MCP（托管 HTTP）	`mcp__github__`	PAT：设置 `githubToken` 或环境变量 `GITHUB_MCP_PAT`
ComfyUI	comfy-mcp（PyPI）	`mcp__comfyui__`	本机 ComfyUI / comfy-cli
Godot	godot-ai（PyPI，`godot-ai attach`）	`mcp__godot__`	Godot 4.7+ 编辑器开着项目，且项目启用了同版本 Godot AI 插件
FFmpeg	Kinocut（PyPI `kinocut`，原 mcp-video）	`mcp__ffmpeg__`	本机已安装 ffmpeg/ffprobe（PATH 或设置路径）
Obsidian	obsidian-mcp-server（npm）	`mcp__obsidian__`	Obsidian 开着 + 社区插件 Local REST API + API 密钥

组件依赖的运行时（uv + Python，或 Node.js）与各上游 MCP 包，都可以在设置页「下载安装」到插件数据目录的 tools/（见下文「数据目录」）。新鲜安装时所有工作组件 MCP 与会话控制均默认关闭（*Enabled: false），装好后在管理页逐个打开「启用」才会挂载对应 MCP。具体安装、桥接、端口与项目侧配置都在设置 UI 里完成，本 README 不重复操作步骤。

已内嵌：GameBot（src/components/gamebot/）、桌面控制（src/components/desktop/broker/dist/DSHDesktopBroker.exe，设置页「通用」分组，打开「启用」即可；npm 包内已含，git 检出需 npm run build:desktop 构建，要求 .NET SDK 8+）。

安装

在 DSH Desktop 里让智能体用内置的 plugin_manager 安装 bundle（不要自己在 profile 目录里跑 npm / pnpm，install_bundle 会完成包安装和 bundle 选择）：

对智能体说：「用 plugin_manager 的 install_bundle 安装 npm 包 dsh-work-components」。
本包没有 install / postinstall 构建脚本；如果结果里列出待批准的构建脚本，不要批准，先确认来源。
用 list_bundles / list_plugins 确认 dsh-work-components 已启用；结果是 restart-required 时重启 DSH Desktop。替换已装的版本（升级）同样需要重启才会加载新代码。
打开设置页「工作组件」，按需「下载安装」各组件并打开「启用」（新装时全部默认关闭）。

卸载：plugin_manager 的 remove_bundle。数据目录（设置、已下载的工具、GameBot 数据）不随包删除，需要时手动删掉。

要求：DSH Desktop（Node ≥ 22.15 运行时，会话控制要用 zstd）；Office / Photoshop / Windows / 桌面控制等组件只在 Windows 上可用。桌面控制随插件提供，不需要单独下载或安装 .NET。

数据目录

插件不往自己的包目录写任何东西（升级时包目录会被整个替换）。可写状态都在 $DSH_HOME/data/dsh-work-components/（DSH_HOME 缺省 ~/.dsh；可用 DSH_WORKBENCH_DATA_DIR 整体改位置）：

路径	内容
`settings.json`	没有 DSH 设置服务时的设置持久化（可用 `DSH_WORKBENCH_SETTINGS_FILE` 改）
`tools/`	「下载安装」落地的 uv / Python / Node.js / 各组件（可用 `DSH_WORKBENCH_TOOLS_DIR` 改）
`local-components/`	本地兼容组件源码（可用 `DSH_WORKBENCH_LOCAL_COMPONENTS_DIR` 改）
`gamebot/`	GameBot 的 Python 环境（`.venv`）与数据（`data/game-configs.json`、记忆等；含服务商密钥明文）

从旧版本（直接在仓库目录里运行）升级时，首次启动会一次性迁移：仓库根的 .dsh-workbench-settings.json 移到 settings.json，src/components/gamebot/data/ 移到 gamebot/data/；已有的 tools/、local-components/ 里有绝对路径（venv），所以原地沿用并记录在 legacy-locations.json。迁移记录在 migration.json，不会重复执行。

GET /dsh-workbench/api/settings 返回的密钥字段（令牌、API key、密码）一律是占位值 __dsh_secret_saved__；POST 原样带回占位值 = 保持不变，传空字符串 = 清除。

多模态：mm_send_image（本地图片 → Host attachmentId；render=text+image；UI：presentationMeta.mm → turnTail MmCard，toolview 仅 pending/compact）。

地图（默认关闭）：在设置页启用并保存高德 Web 服务 Key 后，提供地理编码、地点检索、路线规划、天气预报、地图标点卡片与可点击的路线图。标点卡片在页面上可打开高德地图；发到 Telegram 时改为原生命置，不再发送静态地图图片。路线图点开后进入高德导航页，并附带可在手机打开的网页分享链接与导航深链，坐标为 GCJ-02。可将分享链接通过 Telegram 发送，或复制到系统浏览器打开；该链接适用于 iOS 与 Android。导航深链（amapuri）供 Android 与 HarmonyOS 直接打开。上述方式不写入高德账号收藏夹。Key 只保存在设置页，不读取环境变量。设置项「绕过代理」默认开启，高德请求不使用系统或环境变量中的 HTTP 代理。静态地图预览经 attachments.saveImage 发出，不落盘缓存。媒体卡片中的图片可点击放大。

日历（默认开启）：calendar_show、calendar_event_save、calendar_event_delete。公历、农历、节气和中国法定节假日（含调休）由 lunar-javascript 离线计算，「今天」按 Asia/Shanghai。日程写在数据目录 calendar/events.json，不放进设置。天气预报来自 Open-Meteo（CC BY 4.0），填写设置项「天气城市」后按接口能提供的最长天数查询，不使用高德 Key，请求沿用当前进程的代理。未填城市时历法与日程仍然可用。聊天卡片和设置页「日历」共用同一块月历，每种天气有一枚动态小图标。发到 Telegram 时，calendar_show 的卡片另成一条 HTML 月历（天气用对应表情），模型的文字回复仍走原通道。

实装截图

工作组件列表

设置页

DSH 设置里的「工作组件」页：首页是功能列表（按分组），行首应用图标、行尾实时状态，点进该项的管理页。

分组	功能	列表状态（示意）	管理页要点
多模态	媒体卡片	mm_send_image · 可用	`mm_send_image` 发图（API text+image；settled MmCard 在 turnTail，toolview 折叠后仍可见）
多模态	日历	已启用	月历、农历、节假日、日程；天气城市走 Open-Meteo
工作组件	Office / Blender / Unity / Figma / Photoshop / Chrome / Godot / Windows / Notion / Cloudflare / Cloudflare Docs / GitHub / ComfyUI / FFmpeg / Obsidian（徽标「已验证」）	已连接 / 已启用 / 未启用 / 未安装 / 出错 / 安装中…	运行与连接说明、下载安装 / 卸载、「启用」、组件专属配置
本地兼容	`local-components/<id>/` 下的用户模块（徽标「本地」；可用 env `DSH_WORKBENCH_LOCAL_COMPONENTS_DIR`）	同上	与仓库自带同接口；详情页「启用」；管理页复制 PR 清单 / 打开 Compare（不自动 commit / push / `gh pr create`）
通道	Telegram（徽标「已验证」，默认关闭）	未启动 / 正在连接 / 已连接 / 未连接 / 出错	卡片内完成全部设置：启用、机器人令牌（存宿主凭据）、网络代理、所有者 / 允许的用户 ID、新会话预设、新消息插队；连接行显示实时说明或最近一条错误
游戏	Minecraft / 文明 VI / 视觉（徽标「已验证」与「实验性」，默认关闭）	未启动 / 已启动 / 出错…	共享 GameBot REST + 按游戏 MCP；仓库自带无需下载，首次启用准备 Python 环境
通用	桌面控制 / 会话控制 / uv / Node.js / 下载代理	已连接 / 可用 / 未安装 / 已设置…	桌面控制随插件提供，打开「启用」即可；其余为会话能力、运行时与代理
基础工具	添加工作组件	提示词工具	Token 声明 + 可复制 AI 提示词：写成本地模块（不装进 `tools/`）。选型功能最全优先；应补可配置/必填参数（中文 label）；本地阶段 `keys` + `launch`/`spec` 硬编码默认，拟议 schema 写注释；自定义键未进 schema 前不持久化。模块就位后重启 DSH，再在设置页下载安装。

有上游仓库的功能在标题旁显示蓝色网址文字（新标签打开）。管理页「‹ 返回」或 Esc 回列表；每页各自「保存」；「启用」拨动后立即单独保存（本地组件同样有启用开关，键 <id>Enabled，缺省关）。安装进行中列表与管理页约每 1.5 秒刷新；有组件已启动时约每 5 秒刷新以跟上「已连接」。设置命名空间：dsh-workbench。

「已连接」

优先级：安装中 / 排队中 → 出错 → 已连接 → 已启动 → 未启动 / 未安装。

已启动（status: on）：MCP 服务器已挂载，尚未确认够得着目标程序。
已连接（status: connected）：已启动，且 (a) 对应程序在运行，(b) MCP 层可达。

探测在 GET /components 时按需进行（src/connect.mjs）：只读、不拉起程序；结果缓存 PROBE_TTL_MS（6s），同一组件不并发，一轮共用一次进程列表；单次探测限时 PROBE_TIMEOUT_MS（15s）、工具调用默认限时 4s；请求最多等 1.5s，未完成的下次再带。工具经 ctx.tools 里 dsh-mcp-client 已有连接直接执行。上次已连接而本次工具超时则暂保持已连接并注明。组件重挂后旧结果作废。

组件	(a) 程序在运行	(b) MCP 够得着
Office	进程 WINWORD / EXCEL / POWERPNT 等（含 Visio、Outlook、WPS 等）	`RunningApps`（COM，只读）非空
Blender	进程 blender	已注册工具 + TCP 连插件端口（`BLENDER_HOST:BLENDER_PORT`，默认 `localhost:9876`）
Unity	进程 Unity	已注册工具 + 按 `~/.unity-mcp`（或 `UNITY_MCP_STATUS_DIR`）端口文件与默认 6400 做桥接 ping
Figma（console）	进程 Figma（不含 figma_agent）	`figma_get_status` 中 `transport.websocket.available`
Figma（官方）	进程 Figma	TCP 连官方 MCP 地址（默认 `127.0.0.1:3845`）
Photoshop	进程 Photoshop	`photoshop_ping` 成功（`PSMCP_FEEDBACK=0`、`ANALYTICS_DISABLED=1`）
Chrome（launch）	chrome-devtools-mcp 专用配置目录被 Chrome 占用	`list_pages` 成功（未占用时不调，避免拉起 Chrome）
Chrome（autoConnect）	chrome + 渠道默认配置目录有 `DevToolsActivePort` 且端口开	`list_pages` 成功
Chrome（browserUrl）	`GET <调试地址>/json/version` 成功	`list_pages` 成功
Godot	进程名以 Godot 开头（不含 venv 里的 `godot-ai`）	已注册工具 + `session_manage(op=list)` 有会话 + `editor_state` 成功
FFmpeg	本机能解析到 ffmpeg（PATH 或 `ffmpegPath`）	MCP 已就绪（Kinocut 不依赖常驻 GUI）
Obsidian	进程 Obsidian	已注册工具 + TCP 连 Local REST API（`obsidianBaseUrl`，默认 `127.0.0.1:27123`）
桌面控制	不要求单独的业务进程（本机桌面）	已注册工具 + `status` 成功

架构（给开发者）

组件文件夹约定见 docs/component-module.md（布局、稳定导出、共享层、新增检查清单）。

src/
  index.mjs            宿主入口：SettingsSchema、API、mm_send_image
  components.mjs       兼容再导出 → ./components/
  components/          仓库自带组件 + shared / registry / manager
  connect-lib.mjs      「已连接」共享原语（进程 / TCP / MCP 调用）
  connect.mjs          汇总各组件 app/probe，提供 probeComponent
  tools.mjs            数据目录 / 迁移、tools/ 布局、下载、uv / Node / npm / venv 安装
  component-sdk.mjs    本地组件 SDK（shared + tools + connect-lib；构建成 lib/component-sdk.mjs）
lib/
  index.mjs            构建产物（宿主）
  local-loader-worker.mjs  构建产物（本地组件加载子进程）
  component-sdk.mjs    构建产物（本地组件 SDK，`dsh-work-components/sdk`）
  client.js            前端设置页、mm_send_image toolview（pending）与 turnTail MmCard（ModuleLoader）
office/launch.py       OfficeMCP 启动包装（stdio 友好）
cordis.patch.yml       bundle 层，插入宿主插件行
docs/component-module.md  组件模块约定（含 bundled vs local）
scripts/               build、vendor:sync、各类 smoke
locale/ icon.svg       插件管理器里的标题 / 简介 / 图标

托管安装：设置页可把 uv、Node.js 与各组件装进数据目录的 tools/（.dsh-install.json 记版本）。启动查找顺序一般为：托管 tools/ → 设置路径 → 系统 / 旁路回退（如 uvx、npx、旁边的 ../officemcp）。Figma「官方桌面版 MCP」模式走 streamable-http，不需本地包。测试可用环境变量 DSH_WORKBENCH_TOOLS_DIR 改落地目录。

同源 API（前缀 /dsh-workbench/api）：

方法	路径	说明
GET/POST	`/settings`	读写 `dsh-workbench` 设置（密钥打码，见「数据目录」）
GET	`/components`	`{ ok, dataDir, toolsDir, localComponentsDir, contributeCompareUrl, components }`；组件含 `moduleSource`（`bundled`/`local`）、`status`、`connection`、`install`、`source`（启动来源）等
GET	`/components/<id>/contribute`	仅 local：PR 清单、文件列表、compare URL、命令模板
POST	`/components/<id>/install`	开始（重新）安装，202；冲突 409。`id`：`uv` / `node` / `office` / … / `godot` / `ffmpeg` / `obsidian`
POST	`/components/<id>/uninstall`	删除 `tools/` 中该安装
POST	`/components/godot/addon`	body `{ project }`：把同版本插件装进 Godot 项目

另有 /dsh-workbench/assets/* 提供插件 assets/ 静态资源。

从纯 MCP（cordis.patch）迁入

本机原先在 ~/.dsh/profiles/desktop/cordis.patch.yml 里用 @deepseek-ai/dsh-mcp-client 直接挂的 Windows / Notion / Cloudflare / Cloudflare Docs / GitHub / ComfyUI，已收进本插件的「工作组件」。迁完后请去掉 profile 里对应的 mcp-* 插入项，避免工具双重注册；备份目录示例：~/.dsh/profiles/desktop/.backup-before-mcp-to-workbench-*。

新增组件：先写本地组件目录下的 <id>/index.mjs（设置页「添加工作组件」提示词；宿主原语从 dsh-work-components/sdk 导入），再按 docs/component-module.md 合入 src/components/ 并开 PR。本地模块由 registry 自动发现（fork 子进程加载，坏模块的 process.exit / 挂起不会拖垮宿主；仍勿运行不信任代码），与 bundled 同 id 时 bundled 优先。宿主用 RuntimeSettingsSchema 合并本地 *Enabled（见 src/index.mjs）。运行时下载仍只落在 tools/，仓库与 npm 包都不附带已下载的 MCP 树。测试可用 DSH_WORKBENCH_LOCAL_COMPONENTS_DIR 指向桩目录。

构建与测试

npm install
npm run build          # 不依赖已安装的 DSH；defineTool 在 vendor/dsh-tools（升级后可 npm run vendor:sync）
npm run smoke          # 假 ctx，mm_send_image → lib/smoke.png
npm run smoke:tools    # 走同一套安装代码装组件，再 MCP initialize / tools/list（可指定组件、--proxy、--skip-install、--uninstall）
npm run smoke:office   # 按插件启动方案拉起 OfficeMCP（可用 --expect-managed）
npm run smoke:connect  # 「已连接」实机冒烟（Windows）：node scripts/connect-smoke.mjs chrome …
npm run smoke:local    # 本地兼容发现 / moduleSource / contribute 清单
npm run smoke:gamebot  # GameBot 设置下发冒烟（SMOKE_GAMEBOT_URL，默认 http://127.0.0.1:8767；临时配置 / 记忆目录）
npm run check          # 语法检查 + GameBot 字段与 lib/client.js 一致性 + vendor/wsz987 与补丁一致（prepublishOnly 会先 build 再跑它）
npm run vendor:channels  # 由 npm 上的 @wsz987/channel-* 0.5.1 + vendor/wsz987/patches 重新生成 vendor/wsz987（加 -- --check 只校验）
npm run build:desktop  # dotnet publish 桌面控制经纪人到 src/components/desktop/broker/dist（不进 git；npm run build 会在需要时自动调用）

发布走 GitHub Actions（.github/workflows/publish.yml，npm trusted publishing / OIDC，自动带 provenance）：推送 v* 标签触发；本地不要 npm publish。

从源码挂进 DSH Desktop：在 ~/.dsh/profiles/desktop 用 pnpm add link:<插件目录>，并在 dsh.profile.bundles 加入 "dsh-work-components"（若 profile 里曾直接挂同名 mcp-client，先去掉以免重复）。改 bundle 后需重启 Desktop。

会话控制（通用）

内置于本插件，不单独装包。面向官方 Harness 0.2.0-rc.2 会话日志。

功能

功能	入口	行为
撤回	用户消息下方操作行的「撤回」（设置 → 工作组件 → 通用 → 会话控制可关）	先把当前页正在看的会话恢复到内存，再追加一条 `surfaceOp: replace`，当前页收起该回合及之后的内容。恢复失败时才备份并物理截断磁盘日志，并由页面重新同步。
重试	助手操作行的「重试」（复制与分支之间）	先恢复会话，再保留这条用户消息，用 `surfaceOp: replace` 收起它后面的回复，然后 `followup` 同一条内容。新回复直接流在原问题下面。恢复失败时不改磁盘日志。
熔断	输入框「暂停」按钮（随时可用，含思考中）；或自动阈值	暂停只调用 `agent.cancel({ kind: 'user' }, { keepInbox: true })`。自动熔断在同一取消之后，等回合停写，再按撤回把失败尾轮从磁盘截掉。

使用注意

只打开着、还没在内存里的会话，会先按官方 sessionController 恢复，再在当前页收起内容。撤回收起该回合及之后的全部对话；重试留下原问题，收起原回复并立刻重新生成。页面不用退出再进。恢复失败时，撤回仍截断磁盘并由当前页重新同步；重试不先删日志。
备份目录：~/.dsh/repair-backups/workbench-session-controls-<时间戳>/。
聊天内自动使用当前会话 sessionId，无需粘贴；设置页仍可调自动熔断阈值。
自动熔断阈值在设置页「会话控制」中调整。
主开关 sessionControlsEnabled 经 /settings 保存。有 DSH 设置服务时写入该服务；Desktop 无设置服务时写入数据目录的 settings.json（可用 DSH_WORKBENCH_SETTINGS_FILE 覆盖路径）。启用后聊天内撤回/重试/暂停会立即出现，无需重启。

API（宿主）

GET /dsh-workbench/api/session/turns?sessionId=
POST /dsh-workbench/api/session/retract { sessionId, userMessageSeq? , messageId? }
POST /dsh-workbench/api/session/regenerate { sessionId, userMessageSeq?, messageId? }
POST /dsh-workbench/api/session/cancel { sessionId, reason? }
GET /dsh-workbench/api/session/notices

通道 · Telegram

「通道」分组的 Telegram 卡片把机器人私聊接到 DSH 会话，功能与独立插件 dsh-telegram-temp 相同（文字、图片、流式回复，以及多模态工具结果图片转发）。地图标点卡片改为 Telegram 原生命置（sendVenue，坐标由 GCJ-02 转为 WGS-84），不发送静态地图图片。

默认关闭；关闭时不加载任何通道代码。打开「启用」后才动态加载 lib/channel-telegram.mjs，在本插件 ctx 下挂一个 fork（channel-core → channel-harness → Telegram 适配器）；关闭开关或插件卸载时随 fork 一起清理（ctx.effect）。不直接写会话日志：入站经宿主 agents 服务进入会话。
令牌写进宿主凭据（默认引用名 TELEGRAM_BOT_TOKEN，与 dsh-telegram-temp 共用，切换时无需重新填写），不写入本插件设置；GET /settings 只回传占位值。
会话绑定与访问策略沿用 ~/.dsh/dsh-channels（bindings.json、storage/access/policy/v1/telegram/main）。卡片填写了所有者用户 ID 时，启动时按卡片写入访问策略（所有者 + 允许的用户，私聊白名单，群组规则保持原样）；留空则沿用已保存的策略。
代理：卡片填写的 HTTP 代理只用于访问 api.telegram.org；留空沿用宿主与环境变量。
路由与格式（迁移自 profile cordis.patch.yml 的 channels-harness / channels-telegram）：默认智能体预设、通道级 / 会话级预设覆盖、路由模式、入站元数据前缀、出站格式（默认 HTML）。
冲突保护：profile 的 bundles 里仍有 dsh-telegram-temp（或 @wsz987/dsh-channels）、或宿主里已有其他插件提供的 channels / channelControl 服务时不启动，卡片显示「已由独立插件 dsh-telegram-temp 接管，请先移除该插件」等说明；运行中出现 Telegram 409（同一机器人被别处轮询）时立即停止轮询。
参考源码：通道实现参考 wsz987/dsh-channels（npm：@wsz987/channel-core / channel-harness / channel-telegram / channel-control，聚合包 @wsz987/dsh-channels）；行为对齐独立插件名 dsh-telegram-temp（无单独公开仓库）。完整依赖表见下文「依赖说明」。
补丁随仓库走：vendor/wsz987/<包> 是 npm 0.5.1 打上 vendor/wsz987/patches/*.patch 之后的副本，构建时把 @wsz987/channel-{core,harness,telegram} 解析到这里并打包进 lib/channel-telegram.mjs，不依赖 postinstall，npm install 不会冲掉补丁。依赖版本在 devDependencies 里精确锁定（.npmrc 设 legacy-peer-deps=true，因为 DSH 各包 rc.2 / rc.3 的 peer 声明互相冲突）。

从 dsh-telegram-temp 切换：在卡片填好设置并打开「启用」（此时显示接管说明，不会轮询）→ 退出 DSH Desktop → "%LOCALAPPDATA%\Programs\DeepSeek Harness\resources\runtime\cli\bin\dsh.cmd" plugin --profile desktop remove dsh-telegram-temp → 重新打开 DSH。

依赖说明

下列包列在 devDependencies（另有 schemastery 与若干运行时依赖），供本机构建、类型解析，以及把「通道 › Telegram」打成自包含的 lib/channel-telegram.mjs。正式发布的 npm 包一般不要求用户再装这些 Harness / 通道包；宿主 DSH 仍通过 Cordis inject（如 tools、agents、sessions、credentials、attachments）提供同名服务。版权与保留义务见 NOTICE。

构建与校验

包	本插件中的用途	npm	源码
esbuild	`npm run build`：打包 `lib/index.mjs`、`lib/local-loader-worker.mjs`、`lib/component-sdk.mjs`，以及 Telegram 运行时 `lib/channel-telegram.mjs`；`vendor:channels` 等脚本也会用到	esbuild	evanw/esbuild

设置 Schema

包	本插件中的用途	npm	源码
schemastery	`src/index.mjs` 的 `SettingsSchema` / `RuntimeSettingsSchema`（设置注册与 API 校验）	schemastery	shigma/schemastery
@deepseek-ai/schemastery	与通道栈（`@wsz987/channel-*`）声明的 Schema 实现对齐并锁定版本；构建 Telegram 运行时时随通道依赖解析	@deepseek-ai/schemastery	deepseek-ai/deepseek-harness

Cordis（插件运行时）

通道启用后会在本插件 ctx 下再挂一层 fork（ctx.plugin），因此构建 Telegram 包时需解析 DeepSeek 发行的 Cordis 及相关加载器，版本与宿主侧声明对齐（见 .npmrc 的 legacy-peer-deps）。

包	本插件中的用途	npm	源码
@deepseek-ai/cordis	通道 fork 的 Cordis 运行时；`@wsz987/channel-*` 的 peer / 依赖	@deepseek-ai/cordis	deepseek-ai/deepseek-harness
@deepseek-ai/cordis-plugin-loader	Cordis 插件加载器；由 `cordis` / 通道依赖树引入，devDependencies 精确锁定以免打包漂移	@deepseek-ai/cordis-plugin-loader	同上
@deepseek-ai/cordis-plugin-include	Cordis 插件 include；同上，并被 `dsh-agent-presets` 等依赖	@deepseek-ai/cordis-plugin-include	同上

DeepSeek Harness 包（锁定进 Telegram 产物 / vendor）

下列 @deepseek-ai/dsh-* 多数不由本仓库源码直接 import，而是 @wsz987/channel-harness / channel-telegram / channel-core 的依赖；scripts/build.mjs 打 lib/channel-telegram.mjs 时从 node_modules 打入（版本在 devDependencies 精确锁定）。宿主侧同名能力则通过服务注入使用（例如 credentials、attachments、agents、sessions）。

包	本插件中的用途	npm	源码
@deepseek-ai/dsh-tools	① `vendor/dsh-tools/` 副本供 `defineTool`（`npm run vendor:sync` 自本机 DSH Desktop 同步）；② 通道 harness 依赖树中的工具类型	@deepseek-ai/dsh-tools	deepseek-ai/deepseek-harness；vendor 说明见 NOTICE
@deepseek-ai/dsh-llm	vendor 中仅保留 `HarnessError`（自该包抽取）；通道 harness 依赖中亦有 LLM 相关模块	@deepseek-ai/dsh-llm	同上
@deepseek-ai/dsh-agent	通道 harness：入站消息经宿主 `agents` 进会话；打包时解析该包	@deepseek-ai/dsh-agent	同上
@deepseek-ai/dsh-agent-presets	通道路由 / 预设（默认智能体、通道级与会话级覆盖）	@deepseek-ai/dsh-agent-presets	同上
@deepseek-ai/dsh-session	通道与会话绑定、会话生命周期（与 inject `sessions` 对应）	@deepseek-ai/dsh-session	同上
@deepseek-ai/dsh-scope	通道 harness 作用域 / 绑定上下文	@deepseek-ai/dsh-scope	同上
@deepseek-ai/dsh-attachment	通道侧附件与多模态出站；宿主 `attachments`（如 `mm_send_image`）为同名服务	@deepseek-ai/dsh-attachment	同上
@deepseek-ai/dsh-commands	通道 harness 命令面	@deepseek-ai/dsh-commands	同上
@deepseek-ai/dsh-user-questions	通道 / harness 用户提问交互	@deepseek-ai/dsh-user-questions	同上
@deepseek-ai/dsh-invariants	harness 不变量校验（通道依赖树）	@deepseek-ai/dsh-invariants	同上
@deepseek-ai/dsh-home-paths	`$DSH_HOME` 等路径约定；`channel-core` / harness 依赖	@deepseek-ai/dsh-home-paths	同上
@deepseek-ai/dsh-credentials	Telegram 机器人令牌等凭据；`channel-telegram` 依赖，宿主经 `ctx.inject(['credentials'])` 读取	@deepseek-ai/dsh-credentials	同上
@deepseek-ai/dsh-atomic-write	原子写盘；由 `dsh-agent-presets` 等引入，devDependencies 锁定以免通道产物版本漂移	@deepseek-ai/dsh-atomic-write	同上

通道栈（@wsz987）与 HTTP

参考实现与独立插件名 dsh-telegram-temp 行为对齐（令牌、会话绑定目录、cordis.patch 挂载顺序等）；公开源码仓库为 wsz987/dsh-channels（npm 聚合包 @wsz987/dsh-channels）。dsh-telegram-temp 本身无独立公开 Git 仓库，仅作本机 / profile 侧临时插件名出现在冲突检测与迁移说明中。

包	本插件中的用途	npm	源码
@wsz987/channel-core	通道契约与 `ctx.channels`；运行时 `apply` 自 vendor 打补丁副本（非直接 npm 原版）	@wsz987/channel-core	wsz987/dsh-channels（`packages/channel-core`）
@wsz987/channel-harness	渠道 ↔ Harness 桥（会话绑定、回复管线等）；同样解析自 vendor 补丁副本	@wsz987/channel-harness	同上（`packages/channel-harness`）
@wsz987/channel-telegram	Telegram Bot 适配器（长轮询、出站等）；vendor 补丁副本	@wsz987/channel-telegram	同上（`packages/channel-telegram`）
@wsz987/channel-control	通道控制面（配置 / 凭据 / 生命周期）；未打补丁，构建时从 `node_modules` 解析（见 `scripts/build.mjs`）	@wsz987/channel-control	同上（`packages/channel-control`）
undici	Telegram 运行时可选 HTTP 代理：`ProxyAgent` + `fetch` 访问 `api.telegram.org`；打入 `lib/channel-telegram.mjs`	undici	nodejs/undici

Vendor 与补丁（Telegram）： vendor/wsz987/<包> 由 npm 上的 @wsz987/channel-{core,harness,telegram}@0.5.1 加上 vendor/wsz987/patches/*.patch 生成（npm run vendor:channels；npm run check 校验）。补丁涵盖长轮询停滞守护、流式正文去重、入站插队、工具结果图片转发等。发布包不携带 vendor/wsz987/，只携带已打好补丁的 lib/channel-telegram.mjs。细节见上文「通道 · Telegram」与 NOTICE。

游戏 · GameBot

「游戏」分组（Minecraft / 文明 VI / 视觉）标为实验性（与会话控制相同的「实验性」徽标样式）。GameBot（REST body + MCP 桥）内嵌在 src/components/gamebot/（共享层，不单独出卡片），设置页「游戏」分组按游戏分卡：

卡片	组件 id / MCP serverName	启用键
Minecraft	`gamebot-minecraft`	`gamebot-minecraftEnabled`
文明 VI	`gamebot-civilization`	`gamebot-civilizationEnabled`
视觉	`gamebot-vision`	`gamebot-visionEnabled`

每次应用/会话启动全部默认关闭，需重新启用；共享的 gamebotUrl / gamebotRoot 会记住。
共享 body：任一游戏启用 → 自动启动一个 REST body（默认 http://127.0.0.1:8766）；全部关闭 → 停止（只停本插件拉起的进程）。
按游戏的 MCP：每张卡一个 MCP 服务器（工具前缀 mcp__gamebot-<game>__），桥带 GAMEBOT_GAME=<game>：游戏参数固定、只列该游戏会话、拒绝其他游戏的 session、去掉 list_games、get_game 结果里的密钥打码。
仓库自带、实验性：游戏卡没有「下载安装」。设置页标题旁有徽标「已验证」（随仓分发）与「实验性」（尚未完全验证）。首次启用任一游戏时自动准备共享 Python 环境 <数据目录>/gamebot/.venv：用插件托管的 uv（没有就先装进 tools/uv）建 Python 3.12 venv，再从 PyPI 下载安装 pyproject.toml 里的依赖（fastapi、uvicorn、httpx、websockets、pydantic、mss、Pillow、numpy 等，约半分钟到几分钟，走设置里的下载代理）；GameBot 代码本身随包提供，不再安装。装好后写 .dsh-gamebot-ready.json 标记；装到一半失败下次会重建。uv 不可用时退回本机 Python 3.10–3.12 + pip。
设置页是唯一来源：每张卡包含该游戏在 GameBot 里的全部配置（驱动、地址、端口、目录、决策 / 聊天模型、服务商、密钥、人设、记忆…，键名 gb_<game>_<配置键>）。启用或保存时通过 PATCH /v1/games/<game> 下发到 body。密钥字段留空 = 保持 GameBot 已存的该服务商密钥；人设留空 = GameBot 默认。填写了 gamebotRoot（外部 GameBot 目录）时，首次加载会从它的 data/game-configs.json 一次性导入。
GameBot 自带的网页设置前端（/ui）已移除，body 只提供 REST。
Minecraft 只提供 minaret（NeoForge 模组 WebSocket）驱动。Mineflayer 驱动需要的 Node 桥（minecraft-bridge，依赖 mineflayer）不随包发布，所以设置页不显示；要用的话自备桥目录（server.js + npm install），设置环境变量 GAMEBOT_MINECRAFT_BRIDGE_DIR 指向它。
文明 VI 陪玩评论只经 DSH 宿主内的桥写入会话，GameBot 不直接写会话文件。
改了 src/components/gamebot/fields.mjs 后运行 node scripts/gen-gamebot-fields.mjs 再 npm run build。冒烟：npm run smoke:gamebot。

勿与 DSH 桌面大脑同时驱动同一游戏（双脑）。

dsh-work-components

安装

源码

标签

作者

说明文档