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`
Gmail	插件自带（IMAP `imap.gmail.com` / SMTP `smtp.gmail.com`）	`mcp__gmail__`	需要填写地址和应用专用密码；`send_message` 会直接发信
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 密钥
REA 逆向分析	rea-agents（npm `rea-agents@6.4.0`）	`mcp__rea__`	Node.js ^22.19 / ^24.11 / >=26；原生二进制另需 Ghidra/Hopper/IDA
DeepSlate	deepslate-mcp（MIT，启动本机检出目录，不内置）	`mcp__deepslate__`	本机已 clone 并 `npm install && npm run build`；Node.js 20+
Termalin	Termalin MCP（本机 `termalin-mcp` 或托管 HTTP）	`mcp__termalin__`	本机：已安装并运行 Termalin 应用；托管：Pro / 试用的 API 密钥
KiCad	KiCad MCP Pro（社区，`uvx kicad-mcp-pro`，不内置）	`mcp__kicad__`	本机 uv（uvx）；ERC / DRC / 导出需 KiCad（kicad-cli）
Fusion	Autodesk Fusion MCP Server（Fusion 内置，本机 HTTP 27182）	`mcp__fusion__`	Fusion 开着，并在首选项里启用 MCP 服务器
FreeCAD	freecad-mcp（社区，`uvx freecad-mcp`，不内置）	`mcp__freecad__`	本机 uv；FreeCAD 装好 MCP 插件并启动 RPC 服务器（9875）
MATLAB	MATLAB MCP Server（官方 Go 可执行文件，不内置）	`mcp__matlab__`	本机 MATLAB（有效许可）+ 自行下载的服务器 exe
ESP-IDF	ESP-IDF MCP 服务器（`idf.py mcp-server`）	`mcp__espidf__`	ESP-IDF v6.0+（EIM 安装）+ 项目目录
串口	serial-mcp-server（社区，`uvx`，不内置）	`mcp__serial__`	本机 uv；串口设备
Rhino	RhinoAI（官方，默认）或 rhinomcp（社区）	`mcp__rhino__`	Rhino 8 开着并装好对应插件
Altium	eda-agent（社区，不内置）	`mcp__altium__`	Altium Designer 开着 + 自行安装的 eda-agent

组件依赖的运行时（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+）。

DeepSlate（Minecraft 结构渲染）

deepslate-mcp（MIT，© Philogag contributors；渲染引擎 misode/deepslate，MIT，© Misode）把 .nbt / .schem / .litematic 结构文件渲染为 PNG。本组件在「工作组件」分组，默认关闭；只启动您本机已有的 deepslate-mcp（node <目录>/bin/deepslate-mcp.js），不从网络下载，也不把上游源码放进本仓库。工具说明保持上游英文原文。

准备：git clone https://github.com/Philogag/deepslate-mcp，在目录内执行 npm install 与 npm run build（需 Node.js 20+，原生依赖 gl 需能在本机编译或下载预编译包）；在设置中填写「deepslate-mcp 目录」，或点击「安装」把本机已有的检出目录（设置中的目录或主目录 / 桌面 / 文档下的 deepslate-mcp）复制到 tools/deepslate（原目录保留，跳过 .git；目录留空时自动使用该副本），再打开「启用」。
Mojang 资源：材质来自您自己的 Minecraft client.jar（「client.jar 路径」，即 DEEPSLATE_JAR_PATH），或由上游首次运行时从 Mojang 下载并缓存在本机（「材质缓存目录」，即 DEEPSLATE_CACHE_DIR）。本插件从不打包或分发 Mojang 资源，使用须遵守 Minecraft EULA。
聊天室：只读渲染，不控制游戏，对所有成员开放（OPEN_PREFIXES），与 mc_* / mcp__gamebot-* 的场景限制无关；聊天室调用时宽高上限 1600 像素（上游允许 64–4096）。

Termalin（SSH）

Termalin 是 SSH 客户端，自带 MCP 服务器。本组件在「工作组件」分组，默认关闭，不内置、也不自动安装 Termalin。工具说明保持上游英文原文。

本机模式（默认）：运行 Termalin 应用自带的 stdio 服务器 termalin-mcp，所有套餐可用。先安装 Termalin（winget install Termalin.Termalin、Microsoft Store、scoop 或官网安装包），在应用「Settings → Security → Agent Access (MCP)」中允许需要的主机，并把「Connect an assistant」里显示的 termalin-mcp 路径填入设置 termalinCommand（留空时自动探测常见位置和 PATH）。实时终端类工具要求应用保持运行。
托管模式：连接 https://termal.in/api/v1/mcp，请求头为 Authorization: Bearer tk_live_…。API 密钥在 termal.in/account 的「API keys & MCP」中创建，需 Pro 或试用；只能访问已注册 Connector 的服务器，每分钟约 60 次、单次约 90 秒。密钥按其他密钥的方式保存在本机设置中，界面与接口只返回掩码。
不支持 OAuth：https://termal.in/mcp 需要浏览器 OAuth 2.1 授权流程，插件内不支持；填写该地址会被拒绝，请改用 API 密钥端点。
安全：这些工具会在服务器上执行命令和读写文件，一律视为会更改电脑的工具。只有所有者（本机桌面端，或 Telegram 用户 ID 为所有者 ID 的消息）发起的任务可以使用；聊天室中只在所有者触发的回合可用。代码层按 mcp__termalin__ 前缀强制拒绝，即使该工具被误加入开放清单也不会放行。
连接状态和已挂载的工具数量显示在组件详情页的连接行。

KiCad（社区 KiCad MCP Pro）

使用社区服务器 KiCad MCP Pro。本组件在「工作组件」分组，默认关闭，经 stdio 启动用户自己的副本（默认命令 uvx kicad-mcp-pro，首次运行由 uv 从 PyPI 下载到 uv 缓存）。本插件不内置、不打包、不分发其代码。

许可证：以所安装版本附带的许可证为准。2026-10-16 查看上游 main 分支 LICENSE 为 MIT；如所装版本采用 PolyForm Noncommercial，则只能用于非商业用途。
设置：启动命令、项目目录（KICAD_MCP_PROJECT_DIR，留空时可用工具 kicad_set_project 选择）、工具配置（KICAD_MCP_PROFILE：default / pcb_only / build / release / expert / full）、操作模式（KICAD_MCP_OPERATING_MODE：readonly / write / manufacturing，默认 readonly）。
前提：需要本机 uv（含 uvx，例如 winget install astral-sh.uv）。ERC / DRC / 导出依赖 KiCad 自带的 kicad-cli；实时编辑依赖正在运行的 KiCad 及其 IPC 接口。
安全：write 与 manufacturing 模式会修改工程文件或生成生产文件，属于会更改电脑的工具；只读模式下的工具按「MCP 工具仅所有者」的常规规则处理。因此所有 mcp__kicad__ 工具都只有所有者（本机桌面端，或 Telegram 用户 ID 为所有者 ID 的消息）发起的任务可以使用，代码层按前缀强制拒绝。
连接状态、当前配置 / 模式和已挂载的工具数量显示在组件详情页的连接行。

Fusion（Autodesk 官方 MCP 服务器）

使用 Autodesk Fusion 内置的 Fusion MCP Server。本组件在「工作组件」分组，默认关闭，经 Streamable HTTP 连接本机服务器（默认 http://127.0.0.1:27182/mcp，不需要密钥），不启动任何进程。

许可证：服务器随 Autodesk Fusion 提供，按 Autodesk 的使用条款使用；本插件不包含其代码。
启用：在 Fusion 中打开「首选项 › 常规 › API」，勾选「Fusion MCP Server」，点「应用」。端口改过时在设置里填写完整地址。
只读：服务器没有只读模式，dsh-mcp-client 也不能按工具过滤。fusion_mcp_read 只读；fusion_mcp_execute / fusion_mcp_update 会修改设计。需要只读时请在对话中明确要求模型只用 fusion_mcp_read（仅为提示，不是强制）。
安全：本组件的工具会修改设计、文件或设备，属于会更改电脑的工具。所有 mcp__fusion__ 工具都只有所有者（本机桌面端，或 Telegram 用户 ID 为所有者 ID 的消息）发起的任务可以使用，代码层按前缀强制拒绝；聊天室中仅所有者触发的轮次可用。
连接状态、当前配置和已挂载的工具数量显示在组件详情页的连接行。工具说明按上游英文原样传给模型。

FreeCAD（社区 freecad-mcp）

使用社区服务器 freecad-mcp，经 stdio 启动用户自己的副本（默认 uvx freecad-mcp）。本插件不内置、不打包、不分发其代码。

许可证：MIT。
FreeCAD 侧：按上游 README 把 addon/FreeCADMCP 放进 FreeCAD 的 Mod 目录，重启 FreeCAD，切到「MCP Addon」工作台，点「Start RPC Server」（端口 9875）。
设置：启动命令、FreeCAD 主机（远程时传 --host，本机留空）、仅文字反馈（--only-text-feedback，不回传截图）、令牌（FREECAD_MCP_TOKEN，按密钥处理，不显示）。
安全：本组件的工具会修改设计、文件或设备，属于会更改电脑的工具。所有 mcp__freecad__ 工具都只有所有者（本机桌面端，或 Telegram 用户 ID 为所有者 ID 的消息）发起的任务可以使用，代码层按前缀强制拒绝；聊天室中仅所有者触发的轮次可用。
连接状态、当前配置和已挂载的工具数量显示在组件详情页的连接行。工具说明按上游英文原样传给模型。

MATLAB（官方 MATLAB MCP Server）

使用 MathWorks 官方 MATLAB MCP Server（Go 可执行文件），经 stdio 启动用户自己下载的 exe。本插件不内置、不下载该程序。

许可证：只能与 MATLAB 一起使用，并受 MathWorks 软件许可协议约束；不能多人共享同一服务器。
安装：从上游 GitHub Releases 下载 matlab-mcp-server-windows-x64.exe，在设置里填写其路径（或放进 PATH）。
设置：MATLAB 安装目录（--matlab-root）、初始工作文件夹（--initial-working-folder）、显示模式（--matlab-display-mode）、会话模式（--matlab-session-mode：auto / new / existing；existing 时只连接已共享的会话）、遥测（默认关闭，传 --disable-telemetry=true）。
安全：本组件的工具会修改设计、文件或设备，属于会更改电脑的工具。所有 mcp__matlab__ 工具都只有所有者（本机桌面端，或 Telegram 用户 ID 为所有者 ID 的消息）发起的任务可以使用，代码层按前缀强制拒绝；聊天室中仅所有者触发的轮次可用。
连接状态、当前配置和已挂载的工具数量显示在组件详情页的连接行。工具说明按上游英文原样传给模型。

ESP-IDF（Espressif 官方 MCP 服务器）

使用 ESP-IDF 自带的 MCP 服务器，默认命令 eim run "idf.py mcp-server"，经 stdio 启动；项目目录经 IDF_MCP_WORKSPACE_FOLDER 传入。

许可证：ESP-IDF 本身（Apache-2.0），由 Espressif 提供；本插件不包含其代码。
前提：用 EIM v0.8.1+ 安装 ESP-IDF v6.0 或更高版本，并安装 mcp 功能；设置里必须填写一个已存在的项目目录。
说明：工具可编译、烧录、监视设备。串口调试另见「串口」组件。
安全：本组件的工具会修改设计、文件或设备，属于会更改电脑的工具。所有 mcp__espidf__ 工具都只有所有者（本机桌面端，或 Telegram 用户 ID 为所有者 ID 的消息）发起的任务可以使用，代码层按前缀强制拒绝；聊天室中仅所有者触发的轮次可用。
连接状态、当前配置和已挂载的工具数量显示在组件详情页的连接行。工具说明按上游英文原样传给模型。

串口（社区 serial-mcp-server）

独立的「串口」组件（不放在 ESP-IDF 里，任何串口设备都能用），使用社区服务器 serial-mcp-server，默认 uvx --from serial-mcp-server serial_mcp。本插件不内置其代码。

许可证：MIT。
设置：启动命令、插件（SERIAL_MCP_PLUGINS，默认不加载；可填 all 或逗号分隔的名字）。工具名分隔符固定为 _（模型接口不接受带点的工具名），默认关闭追踪。
安全：本组件的工具会修改设计、文件或设备，属于会更改电脑的工具。所有 mcp__serial__ 工具都只有所有者（本机桌面端，或 Telegram 用户 ID 为所有者 ID 的消息）发起的任务可以使用，代码层按前缀强制拒绝；聊天室中仅所有者触发的轮次可用。
连接状态、当前配置和已挂载的工具数量显示在组件详情页的连接行。工具说明按上游英文原样传给模型。

Rhino（官方 RhinoAI，或社区 rhinomcp）

默认使用 McNeel 官方 RhinoAI（rhino-mcp-router --default-version 8，stdio）；也可在设置里改为社区 rhinomcp（uvx rhinomcp，连接 Rhino 内 TCP 端口，默认 1999）。

许可证：两者均为 MIT；本插件不包含其代码。
Rhino 8 兼容性：官方 RhinoAI 支持 Rhino 8（Rhino 9 WIP 也可，设置里选版本）；社区 rhinomcp 面向 Rhino 8。Rhino 7 两者都不支持。
官方：在 Rhino 8 的 PackageManager 安装「Rhino-MCP-Platform」，运行命令 MCPConnect 查看路由程序命令；若不在 PATH，把完整命令填进设置。
社区：在 PackageManager 安装 rhinomcp 插件，在 Rhino 中运行 mcpstart；可在设置中关闭脚本执行（RunCommand / RhinoScript / C#）。
安全：本组件的工具会修改设计、文件或设备，属于会更改电脑的工具。所有 mcp__rhino__ 工具都只有所有者（本机桌面端，或 Telegram 用户 ID 为所有者 ID 的消息）发起的任务可以使用，代码层按前缀强制拒绝；聊天室中仅所有者触发的轮次可用。
连接状态、当前配置和已挂载的工具数量显示在组件详情页的连接行。工具说明按上游英文原样传给模型。

Altium（社区 eda-agent）

使用社区服务器 eda-agent，默认命令 eda-agent（按上游说明自行安装）。本插件不内置其代码。

许可证：Apache-2.0。
工具数量：完整工具集约 450 个，会占用大量上下文。默认使用上游的 EDA_AGENT_TOOLSET=minimal（tool_catalog / tool_invoke 按需调用全部功能），需要时可在设置里改为 full。
设置：启动命令、工具集、仪表盘（默认关闭，EDA_AGENT_DISABLE_DASHBOARD=1）、界面自动化（可关闭）。需要 Altium Designer 正在运行。
安全：本组件的工具会修改设计、文件或设备，属于会更改电脑的工具。所有 mcp__altium__ 工具都只有所有者（本机桌面端，或 Telegram 用户 ID 为所有者 ID 的消息）发起的任务可以使用，代码层按前缀强制拒绝；聊天室中仅所有者触发的轮次可用。
连接状态、当前配置和已挂载的工具数量显示在组件详情页的连接行。工具说明按上游英文原样传给模型。

安装

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

对智能体说：「用 plugin_manager 的 install_bundle 安装 npm 包 dsh-work-components」。
推荐从 npm 安装（发布包已含 lib/ 构建产物）。本包的 prepare 仅在缺少 lib/index.mjs 时才会执行 npm run build（例如从 git 源码安装）；从 npm 安装时通常已有产物并跳过。若 plugin_manager 列出待批准的构建脚本，先确认来源再批准 dsh-work-components 的 prepare（pnpm ≥10 可能还需在 profile 的 pnpm-workspace.yaml 里允许该包）。桌面经纪人 exe 随 npm 包分发；纯 git 安装且本机无 .NET SDK 时，桌面控制需另跑 npm run build:desktop（或改用 npm 包）。
用 list_bundles / list_plugins 确认 dsh-work-components 已启用；结果是 restart-required 时重启 DSH Desktop。替换已装的版本（升级）同样需要重启才会加载新代码。
打开设置页「工作组件」，按需「下载安装」各组件并打开「启用」（新装时全部默认关闭）。

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

要求：DSH Desktop（运行时 Node ^22.19 || >=24，与 package.json 的 engines 一致；会话控制要用 zstd）；Office / Photoshop / Windows / 桌面控制等组件只在 Windows 上可用。桌面控制随插件提供，不需要单独下载或安装 .NET。装好后可用设置页打开「启用」并调用 mm_send_image 等工具做一次冒烟；仓库 CI（.github/workflows/ci.yml）在 PR / push 时跑 check + smoke。

数据目录

插件不往自己的包目录写任何东西（升级时包目录会被整个替换）。可写状态都在 $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`、记忆等；含服务商密钥明文）
`cards/`	牌类规则源（`src/rlcard/`，用户从设置页下载，不随包分发）和按游戏、会话分开的存档（`saves/`）

从旧版本（直接在仓库目录里运行）升级时，首次启动会一次性迁移：仓库根的 .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 发出，不落盘缓存。媒体卡片中的图片可点击放大。

GPT Image 2 生图（「多模态」分组，默认关闭）：在设置页填写 API Key、Base URL（默认 https://api.openai.com/v1）、模型（默认 gpt-image-2）与默认尺寸 / 质量并打开「启用」后，注册 image_generate（POST {base}/images/generations）与 image_edit（POST {base}/images/edits，multipart，1–16 张本地 png/jpg/webp 与可选 PNG 蒙版）。返回的 b64_json 或 url 图片保存到数据目录 images/<YYYY-MM-DD>/（上海时区），经 attachments 以图片块显示，并返回文件路径。「测试连接」只请求 GET {base}/models，不产生出图费用。API Key 为 secret 设置项，设置接口只返回掩码，错误信息中出现的 Key 会被打码。Telegram：两个工具都不在 OPEN_TOOLS 中，只有授权用户（所有者）触发的回合可用——image_generate 消耗付费额度，image_edit 会读取本机任意图片并上传到第三方。

视频理解（「多模态」分组，默认开启）：经 Google Gemini 观看视频。设置项为「启用」「Gemini API 密钥」「模型」（默认 gemini-3.8-flash）「YouTube 链接」「哔哩哔哩链接」与「yt-dlp 路径」；组件卡片中的状态框显示密钥来源与末四位掩码、会话工具是否已挂载、正在使用的 yt-dlp 版本与来源。密钥只用本组件单独配置的 videoGeminiKey（输入框与其他密钥一致：已保存时留空并显示「已配置 ••••xxxx」，输入新值即替换，「清除」删除）（与「余额查询」各服务商密钥相同的做法：设置中按密钥保存、界面只显示掩码；不沿用聊天室转写密钥或成员凭据，也不读取环境变量），未填写时状态为「未配置密钥」；密钥只放在请求头中，不写入日志，也不经设置接口返回。聊天室语音转写与原生 Gemini 成员的「视频输入」仍用各自原来的密钥；访问 Gemini 时沿用聊天室的 Telegram 代理设置。

聊天室：每个视频（本机上传、Telegram 群发送，以及消息中的 YouTube / 哔哩哔哩链接）都会在后台生成带时间戳的中文内容描述，显示在消息的「视频 · 内容描述」卡片中并提供给所有成员；成员可调用 watch_video 就某一时间段提问；原生 Gemini 成员可在成员设置中开启「视频输入」，直接收到最新消息中的视频。
会话工具：describe_video（整体描述）与 watch_video（按问题与时间段观看，相同问题直接返回上次的回答）。参数可为本机视频文件的绝对路径（不超过 200 MB）、YouTube 公开链接（不下载，直接交给 Gemini）或哔哩哔哩链接。不超过 14 MB 的视频内联发送，更大的经 Gemini Files API 上传，48 小时内复用。Telegram：两个工具都不在 OPEN_TOOLS 中，只有授权用户（所有者）触发的回合可用（会把本机文件上传给 Google）。
哔哩哔哩（可选）：需要 yt-dlp（Unlicense，本插件不附带）。查找顺序：「yt-dlp 路径」设置 → PATH → 按需下载的副本。组件卡片的「下载 yt-dlp」（下载后变为「更新 / 重新下载 yt-dlp」）与棋类辅助引擎同一做法：只在设置页（本机，即所有者）点击时，从官方 GitHub 发布页取最新正式版中适合本平台的单文件程序（Windows yt-dlp.exe、macOS yt-dlp_macos、Linux yt-dlp_linux 等），用同一版本的 SHA2-256SUMS 校验 sha256（不符即删除），放到 <数据目录>/bin/，并记录版本；下载过程显示进度，完成后清除检测缓存。没有注册为 AI 工具。版本号先问 GitHub API（带 User-Agent 与 Accept: application/vnd.github+json）；API 失败时（常见：未登录请求每小时 60 次的上限在共用代理出口上用完，返回 403）改读 github.com/yt-dlp/yt-dlp/releases/latest 的跳转目标取版本号，程序与校验文件都从 github.com/…/releases/download/<版本>/ 下载，sha256 校验照样强制。所有请求与其他下载一样走设置「下载代理」（留空时用环境变量 HTTPS_PROXY / HTTP_PROXY），失败时给出中文原因。棋类辅助引擎的下载同样改为走「下载代理」。视频下载到数据目录 videos/<YYYY-MM-DD>/（会话工具）或房间附件目录（聊天室）后按普通视频处理，单个不超过 25 MB。未检测到 yt-dlp 或下载失败时给出原因。
关闭「启用」后，上述功能全部停用：视频不再生成描述（卡片注明「视频理解未启用」），成员没有 watch_video 与视频输入，会话工具卸下；已保存的视频与描述保留。旧版设置键 chatroomVideoEnabled / chatroomVideoModel（原在聊天室「附件与语音」中）仍会读取，并在启动时迁移到本组件。

日历（默认开启）：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 月历（天气用对应表情），模型的文字回复仍走原通道。

牌类（默认关闭）：card_open、card_look、card_play、card_close、card_reset。可打二十一点、勒杜克扑克、限注德州扑克、UNO（2 至 10 人）和斗地主。规则源是 RLCard（MIT，钉死提交），在设置页下载到数据目录，不随本插件分发，也不运行它的对局或智能体。牌桌在对话右侧；发到 Telegram 时每一步用新图片替换上一张。对手的暗牌在公开前不会出现在工具结果或图片里。

模型的图片与视频输入

模型能否收到图片，取决于 DSH 模型配置中声明的输入模态。须在 cordis.patch.yml 的 llm-pi-ai → providers → 对应服务商的 models 中，为该模型声明 input: [text, image]（也可用服务商级的 defaultInput 统一声明）；未声明时按纯文本模型处理，图片改为文字：聊天室由能识图的成员生成图片描述，其他场景由 Vision Router 插件把图片替换为文字说明。修改后需重新加载 DSH。示例：

- id: llm-pi-ai
  name: "@deepseek-ai/dsh-llm-pi-ai"
  config:
    providers:
      gpt:
        apiKeyEnv: GPT_API_KEY
        api: openai-responses
        baseURL: https://api.example.com/v1
        models:
          - id: gpt-6.1-sol
            name: gpt-6.1-sol
            input:
              - text
              - image

视频不受 input 声明影响：DSH 不向模型转发视频，所有视频均经「多模态 › 视频理解」组件（Google Gemini）处理。其他成员看到内容描述并可调用 watch_video；原生 Gemini 成员开启「视频输入」后直接观看。

实装截图

工作组件列表

设置页

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 / Gmail / Cloudflare / Cloudflare Docs / GitHub / ComfyUI / Termalin / KiCad / Fusion / FreeCAD / MATLAB / ESP-IDF / 串口 / Rhino / Altium / FFmpeg / Obsidian / REA 逆向分析（徽标「已验证」）	已连接 / 已启用 / 未启用 / 未安装 / 出错 / 安装中…	运行与连接说明、下载安装 / 卸载、「启用」、组件专属配置
本地兼容	`local-components/<id>/` 下的用户模块（徽标「本地」；可用 env `DSH_WORKBENCH_LOCAL_COMPONENTS_DIR`）	同上	与仓库自带同接口；详情页「启用」；管理页复制 PR 清单 / 打开 Compare（不自动 commit / push / `gh pr create`）
通道	Telegram（徽标「已验证」，默认关闭）	未启动 / 正在连接 / 已连接 / 未连接 / 出错	卡片内完成全部设置：启用、机器人令牌（存宿主凭据）、网络代理、所有者 / 允许的用户 ID、新会话预设、新消息插队；连接行显示实时说明或最近一条错误
游戏	Minecraft / 文明 VI / 视觉（徽标「已验证」与「实验性」，默认关闭）	未启动 / 已启动 / 出错…	共享 GameBot REST + 按游戏 MCP；仓库自带无需下载，首次启用准备 Python 环境
游戏	牌类	未启用 / 已启用	`card_open` 等；右侧牌桌；RLCard 在设置页按需下载，每种牌单独核对规则，不随包分发
通用	桌面控制 / 会话控制 / 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`）
REA 逆向分析	（无常驻 GUI）	MCP 已挂载（静态分析无需外部程序；原生需 Ghidra/Hopper/IDA）
桌面控制	不要求单独的业务进程（本机桌面）	已注册工具 + `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 只回传占位值。卡片下方可以再加机器人（实验性，未验证，不建议使用；功能仍在开发中）：每个机器人单独的令牌、账号标识和预设，各自长轮询。同一个令牌不能给两个机器人或聊天室接收机器人用。
会话按「通道 + 账号 + 聊天」分开。主机器人仍是账号 main，原有私聊和群会话不变。你和另一个机器人的私聊是另一条 DSH 会话，并用那个机器人自己的预设；改预设只影响之后新建的会话，已绑定的要在该会话里 /new。
会话绑定与访问策略沿用 ~/.dsh/dsh-channels（bindings.json、storage/access/policy/v1/telegram/<账号>）。卡片填写了所有者用户 ID 时，启动时按卡片给每个正在连接的机器人写入同一份访问策略：私聊白名单为所有者 + 允许的用户；群聊按「群聊 / 群 ID / 群内需要 @ / 群内发言人」写入（默认关闭）。留空所有者则不改已保存的策略。机器人不能自己进群，须由成员添加；默认隐私模式下 Telegram 只推送 @、回复和命令。
代理：卡片填写的 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。

多 AI 聊天室（实验性）

默认关闭，且不在设置页显示（见更新日志 0.4.0-beta.1 / 0.4.0）。用户的每条新消息开启一个任务：先由主答发言，其余成员依次补充或跳过。

上下文与滚动摘要

成员每次调用看到的提示词顺序为：房间规则 → 一条总摘要（若有）→ 最近可见窗口。默认窗口约 24 条（设置项「上下文窗口（条）」，原「历史条数上限」），不再另设互相打架的历史条数旋钮。

自动压缩：估计上下文（字符数/4）达到「自动压缩阈值」（默认 200000 tokens）时，用独立的摘要小模型把窗口之外的较早消息折进总摘要；被覆盖的消息仍留在 messages.jsonl 与界面中，但对 AI 隐藏（contextHidden / untilSeq）。
手动压缩：房间栏「压缩上下文」。未配置摘要服务商与模型时提示「未配置摘要模型」，自动压缩也会跳过。
/compact 命令：在聊天室输入框或已绑定的 Telegram 群中发送 /compact（群里也可写 /compact@机器人名），效果与「压缩上下文」相同，仅所有者可用。命令不带参数，带参数时只提示「用法：/compact（不带参数）」。命令本身不写入房间记录、不开始 AI 回合；结果（压缩了多少条、未配置摘要模型、压缩进行中、失败）只显示为一行系统提示，AI 看不到（Telegram 发起时同时回到群里）。压缩生成的总摘要照常进入成员的提示词。
摘要模型：设置项「摘要服务商」「摘要模型」（经 DSH 服务商层，密钥由 DSH 保管）。与成员所用模型分开配置。
并发与失败：同一房间同时只跑一次压缩；失败时保留原窗口并硬截断到窗口上限，房间中留一行提示。
本阶段不做：多段摘要、jsonl 抽稀、回合内完整工具结果改写、界面历史分页与上下文压缩联动。

点名主答

用户消息（本机面板或 Telegram 群）中提到某位成员时，该成员成为本任务的主答，优先于「默认主答」；下一条未点名的消息恢复默认主答。可以写 @名字，也可以直接写名字。
可识别的名字：成员名称、成员编号、别名，以及所用 DSH 预设的编号和显示名称；不区分大小写。英文名字前后不能紧挨英文字母或数字（例如 Claudette 不算点名 Claude），紧挨中文、标点或空格均可；网址和邮箱地址中的文字不算点名。
同时提到多位成员时，以在消息中最先出现的为准，与成员列表顺序无关。未启用的成员不参与匹配。
被点名的成员如果因先前回合失败而处于「暂时离开」（期间不安排其发言），点名后立即恢复，之后的任务也照常安排；只恢复被选为主答的那一位。
被点名的主答在本任务中与领队一样可以提前结束本轮（end_round）。只有用户消息会触发点名：成员回复中的名字、Cursor 任务交卷后的唤醒都不会改变主答。

依赖说明

下列包列在 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。

牌类

工具是 card_open、card_look、card_play、card_close、card_reset。card_open 的 game 可以是 blackjack（可省略）、leduc、limit-holdem、uno、doudizhu。规则源不随本仓库或 npm 包分发。设置页下载 RLCard 的钉死提交 d7d0a957baf4cc7225a50522adb0164bf130a9d0（MIT）到 <数据目录>/cards/src/rlcard/。一份检出给全部牌类用。许可证必须是声明的那一种，并且属于 MIT、BSD、ISC 或 Apache-2.0；GPL 等 copyleft、多份许可证混在一起、或正文对不上，都会拒绝装载。每种牌再核对自己的规则片段，缺哪一种就只拒绝那一种：

game	牌	核对
`blackjack`	二十一点	`rlcard/games/blackjack/`：A 计 11、十与花牌计 10、爆牌时把 A 减 10、庄家不足 17 点必须要牌、终局前藏起一张庄家牌、动作只有 hit 和 stand
`leduc`	勒杜克扑克	`rlcard/games/leducholdem/`：黑桃/红桃的 J、Q、K，小盲 1，每轮最多加注 2 次，对子看手牌与公共牌点数
`limit-holdem`	限注德州扑克	`rlcard/games/limitholdem/`：小盲 1，每轮最多加注 4 次，四条街，`compare_hands`
`uno`	UNO	`rlcard/games/uno/`：两人、每人 7 张、含 +4
`doudizhu`	斗地主	`rlcard/games/doudizhu/`：0 号是地主、可出牌生成器、牌序含 A、2、B、R

本插件的适配器自己发牌、判合法动作、走对手，不调用 RLCard 的对局或智能体。无限注德州（半池、一池、全下和边池）没有做，设置页也没有这一行。

和钉死版本不完全相同、需要单独记住的地方：

二十一点：玩家爆牌后庄家不再补牌；起手两张 21 是天成，天成高于后来凑成的 21，双方天成算和局。RLCard 把所有相同点数都当成平局，并且玩家爆牌后仍给庄家补牌。其余一致：一副牌，每手重新洗牌；不设分牌、加倍或保险；庄家软 17 也停牌。玩家凑满 21 且多于两张时不会自动停牌。
勒杜克：6 张牌、两人、两轮限注。小盲先行动，公开牌后加注额从 2 变成 4。这副牌每种点数只有两张，双方同时对上公共牌发不出来；若局面真的如此，平分底池。RLCard 会把底池判给先扫到的那一家。
限注德州：两人、52 张牌、四条街。翻牌前和小盲后的翻牌圈加注额是 2，转牌和河牌是 4。翻牌前小盲先行动，之后从上一轮收口处继续，不改成赌场常见的大盲先动。摊牌取七张里最好的五张。弃牌方的底牌保持隐藏；双方都没弃牌才摊开。奇数筹码的余数给 0 号座位。
UNO：2 至 10 人，默认 4 人，由设置项「UNO 人数」决定，座位 0 为玩家，其余座位由插件内置的对手补齐。新开的牌局按官方规则：发牌位为最后一个座位，座位 0 先出；起手翻到 +4 会塞回去重洗；起手的跳过令座位 1 先出，起手的反转改为逆时针并由发牌位先出，起手的 +2 由座位 0 摸两张并停一轮。跳过令下家停一轮；反转改变方向，两人局中等同跳过；+2 与 +4 令下家摸牌并停一轮。牌堆用尽时，将弃牌堆除顶牌以外的牌洗回。只有没有别的牌可出时才能出 +4。摸到同色数字、同色功能牌或万能牌会立刻打出，摸到异色才留在手里。先出完手牌者胜，其余每人记 -1。对手手牌只公开张数。旧版两人存档（存档中没有 options）仍按原先跟随 RLCard 两人局的走法重放：起手的 +2 补给发牌位且仍由发牌位出牌，反转轮到另一人。
斗地主：叫分在钉死版本里被注释掉了，所以玩家固定当地主并先出牌，另外两家是农民。三张底牌公开。牌型按该版本的可出集合比较，不读取它的 27472 条动作表。炸弹大于普通牌，火箭最大。更长的顺子不会压过更短的顺子。

同一时间右侧只有一张牌桌。二十一点的存档文件名仍是会话身份的摘要，和原来一样；其它牌类把游戏名一并算进文件名。正文只记种子和已经发生的动作（含对手走出的动作），不写每张牌，因此暗牌不会出现在存档文本里。桌面用当前会话 id；Telegram 用聊天 id 加话题 id。未完成的同一种牌在同一身份里 card_open 会续上。card_reset 只清这个身份的指定游戏；没写游戏时清当前牌桌的那一种。lastResult 只来自这一种牌、这一个身份的上一手。换一种牌、换一个会话，都看不到那一手，也看不到它的结果。

发到 Telegram 时，每一步先发新的牌桌图片，再删掉上一张。图片标题只用点阵里有的字母（LED、HOLD、N1、DD）。群里只有发起这手的人可以直接行动。card_look 和 card_play 对非授权用户开放；card_open、card_close、card_reset 会下载或写存档，仍受授权用户闸门限制。

棋类辅助引擎（按需下载，独立进程）

下列引擎不随本仓库或 npm 包分发，也不与本插件链接。只有在设置页「棋类」里某一棋种的棋盘（本体）下载完成后，点该棋种的「下载辅助引擎」，才会从各项目的官方 GitHub 发布页下载钉死版本（src/boards/assist/specs.mjs 记有地址与 sha256，校验不符即放弃），解压到 <数据目录>/boards/assist/<引擎>/。运行时作为独立子进程，只经 stdin/stdout 文本协议通信（UCI、piskvork / Gomocup、KataGo analysis JSON）；每局一个长驻进程，board_close、关闭棋类、移除引擎或 DSH 退出时结束。引擎缺失或出错时只是不给提示，不影响棋局。下载棋盘本体不会下载辅助引擎。

棋种	引擎	许可证	版本 / 资产	本插件中的用途
中国象棋	Pikafish	GPL-3.0（NNUE 权重见包内 NNUE-License.md）	`Pikafish-2026-09-06`，`Pikafish.2026-09-06.7z`（universal 构建，含 `pikafish.nnue`）	UCI，`MultiPV 3` + `UCI_ShowWDL`；着法转成与 `notation.mjs` 一致的中文记谱（如炮二平五）
国际象棋	Stockfish	GPL-3.0	`sf_19`，`stockfish-{windows,linux}-x86-64-universal`（运行时自选 AVX2 等指令集）	UCI，`MultiPV 3` + `UCI_ShowWDL`；UCI 着法（e2e4）
五子棋	Rapfi	GPL-3.0	`250615`，`Rapfi-engine.7z`（官方包内含 rapfi-networks 的 mix9svq 权重与 config.toml）；先试 AVX2 版，起不来改用 SSE 版	piskvork / Gomocup 协议，`YXBOARD` + `YXNBEST 3` 取前三，规则为无禁手（freestyle，与棋盘项目一致）；坐标如 H8
围棋	KataGo	代码 MIT；网络权重为 KataGo 网络许可证	`v1.18.1`（最近一个带 CPU / Eigen 构建的版本），`eigenavx2` 版起不来时改用 `eigen` 版；网络 `kata1-b15c192-s1672170752-d466197061`（katagotraining.org）	analysis 引擎 JSON，`reportAnalysisWinratesAs = SIDETOMOVE`；坐标如 D4

解压 7z：Windows 用系统自带的 tar.exe（bsdtar / libarchive）；其他平台需要 PATH 上有 bsdtar 或 7-Zip（7zz / 7z）。分析时长由设置项 boardsHintMs（默认 1000 毫秒，100–10000）决定。

游戏 · 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 桌面大脑同时驱动同一游戏（双脑）。

更新日志

按版本从新到旧整理，依据 git 标签、提交记录与 GitHub Releases。

0.4.3（2026-10-16）

修复：Gmail 组件移除旧版邮件中转模式（地址和密码留空时沿用本机已保存的邮箱）；现在必须在设置中填写 Gmail 地址和应用专用密码。之前靠留空沿用的用户，组件会提示「请填写 Gmail 地址和应用专用密码」。
说明：0.4.2 已打 git 标签但从未发布到 npm，其改动并入本版本；请直接升级到 0.4.3。

0.4.2（未发布，2026-10-16）

仅有 git 标签，未发布到 npm；改动见 0.4.3。

0.4.1（2026-10-16）

修复：聊天室「所有者 Telegram 用户 ID」不再有内置默认值；留空时，Telegram 上的所有者操作（「批准 +N」「执行」、/bind、/unbind）一律拒绝，本机桌面端仍视为所有者。
修复：「cursor-agent 路径」不再有内置默认值；留空时自动在 PATH 和常见安装位置查找，找不到时提示「未找到 cursor-agent」。
修改：设置页示例改为通用占位（如「例：123456789」「例：D:\projects\my-app」）；聊天室中您的名字留空时显示为「用户」。
修改：package.json 的简介改为英文；README 中的 Node 版本要求与 engines 一致（^22.19 || >=24）。

0.4.0（2026-10-14）

新增：正式版，包含 0.4.0-beta.1 与 0.4.0-beta.2 的全部功能：「游戏」分组的牌类（5 种牌类游戏）与棋类（4 种棋）组件，「多模态」分组的「GPT Image 2 生图」，「通用」分组的「网关核验」。
修改：「通道 › Telegram」同时接入多个机器人仍为实验性，未验证，不建议使用；多 AI 聊天室仍为实验性，默认关闭且不在设置页显示。
修改：需要 Node.js ^22.19 || >=24。

0.4.0-beta.2（预览版，2026-10-14）

新增：在「游戏」分组中新增牌类组件，在设置页下载 RLCard 后可玩 5 种牌类游戏（二十一点、勒杜克扑克、限注德州扑克、UNO、斗地主）。启用后可在聊天中让 AI 开局并对打，进度自动存档，Telegram 中以图片显示牌桌。
新增：在本机设置环境变量 DSH_WORK_SHOW_EXPERIMENTAL=1，或在插件数据目录放一个 show-experimental 文件，设置页会显示实验性的「聊天室」；默认仍隐藏、关闭。
修改（实验性，未验证，不建议使用）：「通道 › Telegram」初步支持同时接入多个机器人，功能仍在开发中。
修复：设置页打开时偶发「无法连接插件宿主接口」的问题。

0.4.0-beta.1（预览版，2026-10-14）

新增：在「游戏」分组中新增棋类组件，支持中国象棋、国际象棋、五子棋、围棋 4 种棋。启用后可在聊天中与 AI 对弈；可另行下载辅助引擎（Pikafish、Stockfish、Rapfi、KataGo），AI 走棋前会参考候选着法与胜率。
新增：在「多模态」分组中新增「GPT Image 2 生图」，填入 API Key 后可在对话中让 AI 文生图或编辑图片，图片保存在插件数据目录。
新增：在「通用」分组中新增「网关核验」，在聊天输入栏打开「核验」后，逐轮检查中转网关的回包模型、流式、Token 计数、中文完整性与缓存，结果显示在回复下方。
新增：多 AI 聊天室（实验性），默认关闭且暂不在设置页显示。
修改：需要 Node.js ^22.19 || >=24；预览版在 npm 上以 beta 标签发布，不影响正式版。
修复：地图、桌面控制停靠窗口恢复与通知重复显示等问题。

0.3.4（2026-10-12）

修改：「笔记」列表的标签改为两行显示，更易阅读。
修复：天气不可用时，日历卡片不再显示空的天气信息。

0.3.3（2026-10-12）

新增：在「通用」分组中新增「笔记」，启用后 AI 可把任务中总结的要点按「类型 › 类别 › 笔记」保存，之后检索复用，也可在设置页查看和编辑。
新增：在「工作组件」分组中新增 Gmail 组件。
新增：「通道 › Telegram」支持群聊，并只允许所有者使用会改动电脑的工具。
修改：桌面控制窗口支持停靠；通知可右键关闭；检查更新更可靠。

0.3.2（2026-10-10）

新增：日历显示天气图标与更长的预报，发到 Telegram 时另附一条月历；桌面控制点击、滚动时显示光标与按键动画。
修改：「游戏」分组（Minecraft / 文明 VI / 视觉）标为实验性。

0.3.1（2026-10-10）

新增：在「多模态」分组中新增「地图」（高德地点检索、路线规划、天气与静态地图，路线可发到手机）和「日历」（农历、节气、法定节假日、日程与天气）。
修改：启动时即显示连接与更新检查的进度提示；每次启动都会检查更新。

0.3.0（2026-10-10）

新增：在「通用」分组中新增「桌面控制」，AI 可按控件操作本机窗口，进行输入、点击、滚动和截图。
新增：「通道 › Telegram」并入工作组件，可在设置页直接配置。
新增：「游戏」分组内置 GameBot（Minecraft、文明 VI、视觉）。
新增：组件安装可取消，并显示实时进度；设置页支持通知堆叠与自动检查更新。
修改：设置页文字与安装日志跟随浅色 / 深色主题。
修复：安装本地组件时偶发失败的问题。

0.2.2（2026-10-05）

修复：部分环境下启动崩溃；收起右侧栏时样式异常。

0.2.1（2026-10-03）

新增：首个公开版本。设置页「工作组件」分组可一键安装并启用 Office、Blender、Unity、Figma、Photoshop、Chrome、Godot、Windows、Notion、Cloudflare、GitHub、ComfyUI、FFmpeg、Obsidian 等组件，供 AI 在会话中调用。
新增：「会话控制」（实验性，默认关闭）；支持添加本地组件。
修复：设置页空白。

dsh-work-components（工作组件）

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

组件	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`
Gmail	插件自带（IMAP `imap.gmail.com` / SMTP `smtp.gmail.com`）	`mcp__gmail__`	需要填写地址和应用专用密码；`send_message` 会直接发信
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 密钥
REA 逆向分析	rea-agents（npm `rea-agents@6.4.0`）	`mcp__rea__`	Node.js ^22.19 / ^24.11 / >=26；原生二进制另需 Ghidra/Hopper/IDA
DeepSlate	deepslate-mcp（MIT，启动本机检出目录，不内置）	`mcp__deepslate__`	本机已 clone 并 `npm install && npm run build`；Node.js 20+
Termalin	Termalin MCP（本机 `termalin-mcp` 或托管 HTTP）	`mcp__termalin__`	本机：已安装并运行 Termalin 应用；托管：Pro / 试用的 API 密钥
KiCad	KiCad MCP Pro（社区，`uvx kicad-mcp-pro`，不内置）	`mcp__kicad__`	本机 uv（uvx）；ERC / DRC / 导出需 KiCad（kicad-cli）
Fusion	Autodesk Fusion MCP Server（Fusion 内置，本机 HTTP 27182）	`mcp__fusion__`	Fusion 开着，并在首选项里启用 MCP 服务器
FreeCAD	freecad-mcp（社区，`uvx freecad-mcp`，不内置）	`mcp__freecad__`	本机 uv；FreeCAD 装好 MCP 插件并启动 RPC 服务器（9875）
MATLAB	MATLAB MCP Server（官方 Go 可执行文件，不内置）	`mcp__matlab__`	本机 MATLAB（有效许可）+ 自行下载的服务器 exe
ESP-IDF	ESP-IDF MCP 服务器（`idf.py mcp-server`）	`mcp__espidf__`	ESP-IDF v6.0+（EIM 安装）+ 项目目录
串口	serial-mcp-server（社区，`uvx`，不内置）	`mcp__serial__`	本机 uv；串口设备
Rhino	RhinoAI（官方，默认）或 rhinomcp（社区）	`mcp__rhino__`	Rhino 8 开着并装好对应插件
Altium	eda-agent（社区，不内置）	`mcp__altium__`	Altium Designer 开着 + 自行安装的 eda-agent

DeepSlate（Minecraft 结构渲染）

准备：git clone https://github.com/Philogag/deepslate-mcp，在目录内执行 npm install 与 npm run build（需 Node.js 20+，原生依赖 gl 需能在本机编译或下载预编译包）；在设置中填写「deepslate-mcp 目录」，或点击「安装」把本机已有的检出目录（设置中的目录或主目录 / 桌面 / 文档下的 deepslate-mcp）复制到 tools/deepslate（原目录保留，跳过 .git；目录留空时自动使用该副本），再打开「启用」。
Mojang 资源：材质来自您自己的 Minecraft client.jar（「client.jar 路径」，即 DEEPSLATE_JAR_PATH），或由上游首次运行时从 Mojang 下载并缓存在本机（「材质缓存目录」，即 DEEPSLATE_CACHE_DIR）。本插件从不打包或分发 Mojang 资源，使用须遵守 Minecraft EULA。
聊天室：只读渲染，不控制游戏，对所有成员开放（OPEN_PREFIXES），与 mc_* / mcp__gamebot-* 的场景限制无关；聊天室调用时宽高上限 1600 像素（上游允许 64–4096）。

Termalin（SSH）

Termalin 是 SSH 客户端，自带 MCP 服务器。本组件在「工作组件」分组，默认关闭，不内置、也不自动安装 Termalin。工具说明保持上游英文原文。

本机模式（默认）：运行 Termalin 应用自带的 stdio 服务器 termalin-mcp，所有套餐可用。先安装 Termalin（winget install Termalin.Termalin、Microsoft Store、scoop 或官网安装包），在应用「Settings → Security → Agent Access (MCP)」中允许需要的主机，并把「Connect an assistant」里显示的 termalin-mcp 路径填入设置 termalinCommand（留空时自动探测常见位置和 PATH）。实时终端类工具要求应用保持运行。
托管模式：连接 https://termal.in/api/v1/mcp，请求头为 Authorization: Bearer tk_live_…。API 密钥在 termal.in/account 的「API keys & MCP」中创建，需 Pro 或试用；只能访问已注册 Connector 的服务器，每分钟约 60 次、单次约 90 秒。密钥按其他密钥的方式保存在本机设置中，界面与接口只返回掩码。
不支持 OAuth：https://termal.in/mcp 需要浏览器 OAuth 2.1 授权流程，插件内不支持；填写该地址会被拒绝，请改用 API 密钥端点。
安全：这些工具会在服务器上执行命令和读写文件，一律视为会更改电脑的工具。只有所有者（本机桌面端，或 Telegram 用户 ID 为所有者 ID 的消息）发起的任务可以使用；聊天室中只在所有者触发的回合可用。代码层按 mcp__termalin__ 前缀强制拒绝，即使该工具被误加入开放清单也不会放行。
连接状态和已挂载的工具数量显示在组件详情页的连接行。

KiCad（社区 KiCad MCP Pro）

许可证：以所安装版本附带的许可证为准。2026-10-16 查看上游 main 分支 LICENSE 为 MIT；如所装版本采用 PolyForm Noncommercial，则只能用于非商业用途。
设置：启动命令、项目目录（KICAD_MCP_PROJECT_DIR，留空时可用工具 kicad_set_project 选择）、工具配置（KICAD_MCP_PROFILE：default / pcb_only / build / release / expert / full）、操作模式（KICAD_MCP_OPERATING_MODE：readonly / write / manufacturing，默认 readonly）。
前提：需要本机 uv（含 uvx，例如 winget install astral-sh.uv）。ERC / DRC / 导出依赖 KiCad 自带的 kicad-cli；实时编辑依赖正在运行的 KiCad 及其 IPC 接口。
安全：write 与 manufacturing 模式会修改工程文件或生成生产文件，属于会更改电脑的工具；只读模式下的工具按「MCP 工具仅所有者」的常规规则处理。因此所有 mcp__kicad__ 工具都只有所有者（本机桌面端，或 Telegram 用户 ID 为所有者 ID 的消息）发起的任务可以使用，代码层按前缀强制拒绝。
连接状态、当前配置 / 模式和已挂载的工具数量显示在组件详情页的连接行。

Fusion（Autodesk 官方 MCP 服务器）

许可证：服务器随 Autodesk Fusion 提供，按 Autodesk 的使用条款使用；本插件不包含其代码。
启用：在 Fusion 中打开「首选项 › 常规 › API」，勾选「Fusion MCP Server」，点「应用」。端口改过时在设置里填写完整地址。
只读：服务器没有只读模式，dsh-mcp-client 也不能按工具过滤。fusion_mcp_read 只读；fusion_mcp_execute / fusion_mcp_update 会修改设计。需要只读时请在对话中明确要求模型只用 fusion_mcp_read（仅为提示，不是强制）。
安全：本组件的工具会修改设计、文件或设备，属于会更改电脑的工具。所有 mcp__fusion__ 工具都只有所有者（本机桌面端，或 Telegram 用户 ID 为所有者 ID 的消息）发起的任务可以使用，代码层按前缀强制拒绝；聊天室中仅所有者触发的轮次可用。
连接状态、当前配置和已挂载的工具数量显示在组件详情页的连接行。工具说明按上游英文原样传给模型。

FreeCAD（社区 freecad-mcp）

使用社区服务器 freecad-mcp，经 stdio 启动用户自己的副本（默认 uvx freecad-mcp）。本插件不内置、不打包、不分发其代码。

许可证：MIT。
FreeCAD 侧：按上游 README 把 addon/FreeCADMCP 放进 FreeCAD 的 Mod 目录，重启 FreeCAD，切到「MCP Addon」工作台，点「Start RPC Server」（端口 9875）。
设置：启动命令、FreeCAD 主机（远程时传 --host，本机留空）、仅文字反馈（--only-text-feedback，不回传截图）、令牌（FREECAD_MCP_TOKEN，按密钥处理，不显示）。
安全：本组件的工具会修改设计、文件或设备，属于会更改电脑的工具。所有 mcp__freecad__ 工具都只有所有者（本机桌面端，或 Telegram 用户 ID 为所有者 ID 的消息）发起的任务可以使用，代码层按前缀强制拒绝；聊天室中仅所有者触发的轮次可用。
连接状态、当前配置和已挂载的工具数量显示在组件详情页的连接行。工具说明按上游英文原样传给模型。

MATLAB（官方 MATLAB MCP Server）

使用 MathWorks 官方 MATLAB MCP Server（Go 可执行文件），经 stdio 启动用户自己下载的 exe。本插件不内置、不下载该程序。

许可证：只能与 MATLAB 一起使用，并受 MathWorks 软件许可协议约束；不能多人共享同一服务器。
安装：从上游 GitHub Releases 下载 matlab-mcp-server-windows-x64.exe，在设置里填写其路径（或放进 PATH）。
设置：MATLAB 安装目录（--matlab-root）、初始工作文件夹（--initial-working-folder）、显示模式（--matlab-display-mode）、会话模式（--matlab-session-mode：auto / new / existing；existing 时只连接已共享的会话）、遥测（默认关闭，传 --disable-telemetry=true）。
安全：本组件的工具会修改设计、文件或设备，属于会更改电脑的工具。所有 mcp__matlab__ 工具都只有所有者（本机桌面端，或 Telegram 用户 ID 为所有者 ID 的消息）发起的任务可以使用，代码层按前缀强制拒绝；聊天室中仅所有者触发的轮次可用。
连接状态、当前配置和已挂载的工具数量显示在组件详情页的连接行。工具说明按上游英文原样传给模型。

ESP-IDF（Espressif 官方 MCP 服务器）

使用 ESP-IDF 自带的 MCP 服务器，默认命令 eim run "idf.py mcp-server"，经 stdio 启动；项目目录经 IDF_MCP_WORKSPACE_FOLDER 传入。

许可证：ESP-IDF 本身（Apache-2.0），由 Espressif 提供；本插件不包含其代码。
前提：用 EIM v0.8.1+ 安装 ESP-IDF v6.0 或更高版本，并安装 mcp 功能；设置里必须填写一个已存在的项目目录。
说明：工具可编译、烧录、监视设备。串口调试另见「串口」组件。
安全：本组件的工具会修改设计、文件或设备，属于会更改电脑的工具。所有 mcp__espidf__ 工具都只有所有者（本机桌面端，或 Telegram 用户 ID 为所有者 ID 的消息）发起的任务可以使用，代码层按前缀强制拒绝；聊天室中仅所有者触发的轮次可用。
连接状态、当前配置和已挂载的工具数量显示在组件详情页的连接行。工具说明按上游英文原样传给模型。

串口（社区 serial-mcp-server）

许可证：MIT。
设置：启动命令、插件（SERIAL_MCP_PLUGINS，默认不加载；可填 all 或逗号分隔的名字）。工具名分隔符固定为 _（模型接口不接受带点的工具名），默认关闭追踪。
安全：本组件的工具会修改设计、文件或设备，属于会更改电脑的工具。所有 mcp__serial__ 工具都只有所有者（本机桌面端，或 Telegram 用户 ID 为所有者 ID 的消息）发起的任务可以使用，代码层按前缀强制拒绝；聊天室中仅所有者触发的轮次可用。
连接状态、当前配置和已挂载的工具数量显示在组件详情页的连接行。工具说明按上游英文原样传给模型。

Rhino（官方 RhinoAI，或社区 rhinomcp）

默认使用 McNeel 官方 RhinoAI（rhino-mcp-router --default-version 8，stdio）；也可在设置里改为社区 rhinomcp（uvx rhinomcp，连接 Rhino 内 TCP 端口，默认 1999）。

许可证：两者均为 MIT；本插件不包含其代码。
Rhino 8 兼容性：官方 RhinoAI 支持 Rhino 8（Rhino 9 WIP 也可，设置里选版本）；社区 rhinomcp 面向 Rhino 8。Rhino 7 两者都不支持。
官方：在 Rhino 8 的 PackageManager 安装「Rhino-MCP-Platform」，运行命令 MCPConnect 查看路由程序命令；若不在 PATH，把完整命令填进设置。
社区：在 PackageManager 安装 rhinomcp 插件，在 Rhino 中运行 mcpstart；可在设置中关闭脚本执行（RunCommand / RhinoScript / C#）。
安全：本组件的工具会修改设计、文件或设备，属于会更改电脑的工具。所有 mcp__rhino__ 工具都只有所有者（本机桌面端，或 Telegram 用户 ID 为所有者 ID 的消息）发起的任务可以使用，代码层按前缀强制拒绝；聊天室中仅所有者触发的轮次可用。
连接状态、当前配置和已挂载的工具数量显示在组件详情页的连接行。工具说明按上游英文原样传给模型。

Altium（社区 eda-agent）

使用社区服务器 eda-agent，默认命令 eda-agent（按上游说明自行安装）。本插件不内置其代码。

许可证：Apache-2.0。
工具数量：完整工具集约 450 个，会占用大量上下文。默认使用上游的 EDA_AGENT_TOOLSET=minimal（tool_catalog / tool_invoke 按需调用全部功能），需要时可在设置里改为 full。
设置：启动命令、工具集、仪表盘（默认关闭，EDA_AGENT_DISABLE_DASHBOARD=1）、界面自动化（可关闭）。需要 Altium Designer 正在运行。
安全：本组件的工具会修改设计、文件或设备，属于会更改电脑的工具。所有 mcp__altium__ 工具都只有所有者（本机桌面端，或 Telegram 用户 ID 为所有者 ID 的消息）发起的任务可以使用，代码层按前缀强制拒绝；聊天室中仅所有者触发的轮次可用。
连接状态、当前配置和已挂载的工具数量显示在组件详情页的连接行。工具说明按上游英文原样传给模型。

安装

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

对智能体说：「用 plugin_manager 的 install_bundle 安装 npm 包 dsh-work-components」。
推荐从 npm 安装（发布包已含 lib/ 构建产物）。本包的 prepare 仅在缺少 lib/index.mjs 时才会执行 npm run build（例如从 git 源码安装）；从 npm 安装时通常已有产物并跳过。若 plugin_manager 列出待批准的构建脚本，先确认来源再批准 dsh-work-components 的 prepare（pnpm ≥10 可能还需在 profile 的 pnpm-workspace.yaml 里允许该包）。桌面经纪人 exe 随 npm 包分发；纯 git 安装且本机无 .NET SDK 时，桌面控制需另跑 npm run build:desktop（或改用 npm 包）。
用 list_bundles / list_plugins 确认 dsh-work-components 已启用；结果是 restart-required 时重启 DSH Desktop。替换已装的版本（升级）同样需要重启才会加载新代码。
打开设置页「工作组件」，按需「下载安装」各组件并打开「启用」（新装时全部默认关闭）。

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

数据目录

路径	内容
`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`、记忆等；含服务商密钥明文）
`cards/`	牌类规则源（`src/rlcard/`，用户从设置页下载，不随包分发）和按游戏、会话分开的存档（`saves/`）

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

聊天室：每个视频（本机上传、Telegram 群发送，以及消息中的 YouTube / 哔哩哔哩链接）都会在后台生成带时间戳的中文内容描述，显示在消息的「视频 · 内容描述」卡片中并提供给所有成员；成员可调用 watch_video 就某一时间段提问；原生 Gemini 成员可在成员设置中开启「视频输入」，直接收到最新消息中的视频。
会话工具：describe_video（整体描述）与 watch_video（按问题与时间段观看，相同问题直接返回上次的回答）。参数可为本机视频文件的绝对路径（不超过 200 MB）、YouTube 公开链接（不下载，直接交给 Gemini）或哔哩哔哩链接。不超过 14 MB 的视频内联发送，更大的经 Gemini Files API 上传，48 小时内复用。Telegram：两个工具都不在 OPEN_TOOLS 中，只有授权用户（所有者）触发的回合可用（会把本机文件上传给 Google）。
哔哩哔哩（可选）：需要 yt-dlp（Unlicense，本插件不附带）。查找顺序：「yt-dlp 路径」设置 → PATH → 按需下载的副本。组件卡片的「下载 yt-dlp」（下载后变为「更新 / 重新下载 yt-dlp」）与棋类辅助引擎同一做法：只在设置页（本机，即所有者）点击时，从官方 GitHub 发布页取最新正式版中适合本平台的单文件程序（Windows yt-dlp.exe、macOS yt-dlp_macos、Linux yt-dlp_linux 等），用同一版本的 SHA2-256SUMS 校验 sha256（不符即删除），放到 <数据目录>/bin/，并记录版本；下载过程显示进度，完成后清除检测缓存。没有注册为 AI 工具。版本号先问 GitHub API（带 User-Agent 与 Accept: application/vnd.github+json）；API 失败时（常见：未登录请求每小时 60 次的上限在共用代理出口上用完，返回 403）改读 github.com/yt-dlp/yt-dlp/releases/latest 的跳转目标取版本号，程序与校验文件都从 github.com/…/releases/download/<版本>/ 下载，sha256 校验照样强制。所有请求与其他下载一样走设置「下载代理」（留空时用环境变量 HTTPS_PROXY / HTTP_PROXY），失败时给出中文原因。棋类辅助引擎的下载同样改为走「下载代理」。视频下载到数据目录 videos/<YYYY-MM-DD>/（会话工具）或房间附件目录（聊天室）后按普通视频处理，单个不超过 25 MB。未检测到 yt-dlp 或下载失败时给出原因。
关闭「启用」后，上述功能全部停用：视频不再生成描述（卡片注明「视频理解未启用」），成员没有 watch_video 与视频输入，会话工具卸下；已保存的视频与描述保留。旧版设置键 chatroomVideoEnabled / chatroomVideoModel（原在聊天室「附件与语音」中）仍会读取，并在启动时迁移到本组件。

模型的图片与视频输入

- id: llm-pi-ai
  name: "@deepseek-ai/dsh-llm-pi-ai"
  config:
    providers:
      gpt:
        apiKeyEnv: GPT_API_KEY
        api: openai-responses
        baseURL: https://api.example.com/v1
        models:
          - id: gpt-6.1-sol
            name: gpt-6.1-sol
            input:
              - text
              - image

实装截图

工作组件列表

设置页

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 / Gmail / Cloudflare / Cloudflare Docs / GitHub / ComfyUI / Termalin / KiCad / Fusion / FreeCAD / MATLAB / ESP-IDF / 串口 / Rhino / Altium / FFmpeg / Obsidian / REA 逆向分析（徽标「已验证」）	已连接 / 已启用 / 未启用 / 未安装 / 出错 / 安装中…	运行与连接说明、下载安装 / 卸载、「启用」、组件专属配置
本地兼容	`local-components/<id>/` 下的用户模块（徽标「本地」；可用 env `DSH_WORKBENCH_LOCAL_COMPONENTS_DIR`）	同上	与仓库自带同接口；详情页「启用」；管理页复制 PR 清单 / 打开 Compare（不自动 commit / push / `gh pr create`）
通道	Telegram（徽标「已验证」，默认关闭）	未启动 / 正在连接 / 已连接 / 未连接 / 出错	卡片内完成全部设置：启用、机器人令牌（存宿主凭据）、网络代理、所有者 / 允许的用户 ID、新会话预设、新消息插队；连接行显示实时说明或最近一条错误
游戏	Minecraft / 文明 VI / 视觉（徽标「已验证」与「实验性」，默认关闭）	未启动 / 已启动 / 出错…	共享 GameBot REST + 按游戏 MCP；仓库自带无需下载，首次启用准备 Python 环境
游戏	牌类	未启用 / 已启用	`card_open` 等；右侧牌桌；RLCard 在设置页按需下载，每种牌单独核对规则，不随包分发
通用	桌面控制 / 会话控制 / uv / Node.js / 下载代理	已连接 / 可用 / 未安装 / 已设置…	桌面控制随插件提供，打开「启用」即可；其余为会话能力、运行时与代理
基础工具	添加工作组件	提示词工具	Token 声明 + 可复制 AI 提示词：写成本地模块（不装进 `tools/`）。选型功能最全优先；应补可配置/必填参数（中文 label）；本地阶段 `keys` + `launch`/`spec` 硬编码默认，拟议 schema 写注释；自定义键未进 schema 前不持久化。模块就位后重启 DSH，再在设置页下载安装。

「已连接」

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

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

组件	(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`）
REA 逆向分析	（无常驻 GUI）	MCP 已挂载（静态分析无需外部程序；原生需 Ghidra/Hopper/IDA）
桌面控制	不要求单独的业务进程（本机桌面）	已注册工具 + `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       插件管理器里的标题 / 简介 / 图标

同源 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）迁入

构建与测试

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。

会话控制（通用）

内置于本插件，不单独装包。面向官方 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

默认关闭；关闭时不加载任何通道代码。打开「启用」后才动态加载 lib/channel-telegram.mjs，在本插件 ctx 下挂一个 fork（channel-core → channel-harness → Telegram 适配器）；关闭开关或插件卸载时随 fork 一起清理（ctx.effect）。不直接写会话日志：入站经宿主 agents 服务进入会话。
令牌写进宿主凭据（主机器人默认引用名 TELEGRAM_BOT_TOKEN，与 dsh-telegram-temp 共用，切换时无需重新填写），不写入本插件设置；GET /settings 只回传占位值。卡片下方可以再加机器人（实验性，未验证，不建议使用；功能仍在开发中）：每个机器人单独的令牌、账号标识和预设，各自长轮询。同一个令牌不能给两个机器人或聊天室接收机器人用。
会话按「通道 + 账号 + 聊天」分开。主机器人仍是账号 main，原有私聊和群会话不变。你和另一个机器人的私聊是另一条 DSH 会话，并用那个机器人自己的预设；改预设只影响之后新建的会话，已绑定的要在该会话里 /new。
会话绑定与访问策略沿用 ~/.dsh/dsh-channels（bindings.json、storage/access/policy/v1/telegram/<账号>）。卡片填写了所有者用户 ID 时，启动时按卡片给每个正在连接的机器人写入同一份访问策略：私聊白名单为所有者 + 允许的用户；群聊按「群聊 / 群 ID / 群内需要 @ / 群内发言人」写入（默认关闭）。留空所有者则不改已保存的策略。机器人不能自己进群，须由成员添加；默认隐私模式下 Telegram 只推送 @、回复和命令。
代理：卡片填写的 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 声明互相冲突）。

多 AI 聊天室（实验性）

默认关闭，且不在设置页显示（见更新日志 0.4.0-beta.1 / 0.4.0）。用户的每条新消息开启一个任务：先由主答发言，其余成员依次补充或跳过。

上下文与滚动摘要

自动压缩：估计上下文（字符数/4）达到「自动压缩阈值」（默认 200000 tokens）时，用独立的摘要小模型把窗口之外的较早消息折进总摘要；被覆盖的消息仍留在 messages.jsonl 与界面中，但对 AI 隐藏（contextHidden / untilSeq）。
手动压缩：房间栏「压缩上下文」。未配置摘要服务商与模型时提示「未配置摘要模型」，自动压缩也会跳过。
/compact 命令：在聊天室输入框或已绑定的 Telegram 群中发送 /compact（群里也可写 /compact@机器人名），效果与「压缩上下文」相同，仅所有者可用。命令不带参数，带参数时只提示「用法：/compact（不带参数）」。命令本身不写入房间记录、不开始 AI 回合；结果（压缩了多少条、未配置摘要模型、压缩进行中、失败）只显示为一行系统提示，AI 看不到（Telegram 发起时同时回到群里）。压缩生成的总摘要照常进入成员的提示词。
摘要模型：设置项「摘要服务商」「摘要模型」（经 DSH 服务商层，密钥由 DSH 保管）。与成员所用模型分开配置。
并发与失败：同一房间同时只跑一次压缩；失败时保留原窗口并硬截断到窗口上限，房间中留一行提示。
本阶段不做：多段摘要、jsonl 抽稀、回合内完整工具结果改写、界面历史分页与上下文压缩联动。

点名主答

用户消息（本机面板或 Telegram 群）中提到某位成员时，该成员成为本任务的主答，优先于「默认主答」；下一条未点名的消息恢复默认主答。可以写 @名字，也可以直接写名字。
可识别的名字：成员名称、成员编号、别名，以及所用 DSH 预设的编号和显示名称；不区分大小写。英文名字前后不能紧挨英文字母或数字（例如 Claudette 不算点名 Claude），紧挨中文、标点或空格均可；网址和邮箱地址中的文字不算点名。
同时提到多位成员时，以在消息中最先出现的为准，与成员列表顺序无关。未启用的成员不参与匹配。
被点名的成员如果因先前回合失败而处于「暂时离开」（期间不安排其发言），点名后立即恢复，之后的任务也照常安排；只恢复被选为主答的那一位。
被点名的主答在本任务中与领队一样可以提前结束本轮（end_round）。只有用户消息会触发点名：成员回复中的名字、Cursor 任务交卷后的唤醒都不会改变主答。

依赖说明

构建与校验

包	本插件中的用途	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（插件运行时）

包	本插件中的用途	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）

包	本插件中的用途	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

包	本插件中的用途	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

牌类

game	牌	核对
`blackjack`	二十一点	`rlcard/games/blackjack/`：A 计 11、十与花牌计 10、爆牌时把 A 减 10、庄家不足 17 点必须要牌、终局前藏起一张庄家牌、动作只有 hit 和 stand
`leduc`	勒杜克扑克	`rlcard/games/leducholdem/`：黑桃/红桃的 J、Q、K，小盲 1，每轮最多加注 2 次，对子看手牌与公共牌点数
`limit-holdem`	限注德州扑克	`rlcard/games/limitholdem/`：小盲 1，每轮最多加注 4 次，四条街，`compare_hands`
`uno`	UNO	`rlcard/games/uno/`：两人、每人 7 张、含 +4
`doudizhu`	斗地主	`rlcard/games/doudizhu/`：0 号是地主、可出牌生成器、牌序含 A、2、B、R

和钉死版本不完全相同、需要单独记住的地方：

二十一点：玩家爆牌后庄家不再补牌；起手两张 21 是天成，天成高于后来凑成的 21，双方天成算和局。RLCard 把所有相同点数都当成平局，并且玩家爆牌后仍给庄家补牌。其余一致：一副牌，每手重新洗牌；不设分牌、加倍或保险；庄家软 17 也停牌。玩家凑满 21 且多于两张时不会自动停牌。
勒杜克：6 张牌、两人、两轮限注。小盲先行动，公开牌后加注额从 2 变成 4。这副牌每种点数只有两张，双方同时对上公共牌发不出来；若局面真的如此，平分底池。RLCard 会把底池判给先扫到的那一家。
限注德州：两人、52 张牌、四条街。翻牌前和小盲后的翻牌圈加注额是 2，转牌和河牌是 4。翻牌前小盲先行动，之后从上一轮收口处继续，不改成赌场常见的大盲先动。摊牌取七张里最好的五张。弃牌方的底牌保持隐藏；双方都没弃牌才摊开。奇数筹码的余数给 0 号座位。
UNO：2 至 10 人，默认 4 人，由设置项「UNO 人数」决定，座位 0 为玩家，其余座位由插件内置的对手补齐。新开的牌局按官方规则：发牌位为最后一个座位，座位 0 先出；起手翻到 +4 会塞回去重洗；起手的跳过令座位 1 先出，起手的反转改为逆时针并由发牌位先出，起手的 +2 由座位 0 摸两张并停一轮。跳过令下家停一轮；反转改变方向，两人局中等同跳过；+2 与 +4 令下家摸牌并停一轮。牌堆用尽时，将弃牌堆除顶牌以外的牌洗回。只有没有别的牌可出时才能出 +4。摸到同色数字、同色功能牌或万能牌会立刻打出，摸到异色才留在手里。先出完手牌者胜，其余每人记 -1。对手手牌只公开张数。旧版两人存档（存档中没有 options）仍按原先跟随 RLCard 两人局的走法重放：起手的 +2 补给发牌位且仍由发牌位出牌，反转轮到另一人。
斗地主：叫分在钉死版本里被注释掉了，所以玩家固定当地主并先出牌，另外两家是农民。三张底牌公开。牌型按该版本的可出集合比较，不读取它的 27472 条动作表。炸弹大于普通牌，火箭最大。更长的顺子不会压过更短的顺子。

棋类辅助引擎（按需下载，独立进程）

棋种	引擎	许可证	版本 / 资产	本插件中的用途
中国象棋	Pikafish	GPL-3.0（NNUE 权重见包内 NNUE-License.md）	`Pikafish-2026-09-06`，`Pikafish.2026-09-06.7z`（universal 构建，含 `pikafish.nnue`）	UCI，`MultiPV 3` + `UCI_ShowWDL`；着法转成与 `notation.mjs` 一致的中文记谱（如炮二平五）
国际象棋	Stockfish	GPL-3.0	`sf_19`，`stockfish-{windows,linux}-x86-64-universal`（运行时自选 AVX2 等指令集）	UCI，`MultiPV 3` + `UCI_ShowWDL`；UCI 着法（e2e4）
五子棋	Rapfi	GPL-3.0	`250615`，`Rapfi-engine.7z`（官方包内含 rapfi-networks 的 mix9svq 权重与 config.toml）；先试 AVX2 版，起不来改用 SSE 版	piskvork / Gomocup 协议，`YXBOARD` + `YXNBEST 3` 取前三，规则为无禁手（freestyle，与棋盘项目一致）；坐标如 H8
围棋	KataGo	代码 MIT；网络权重为 KataGo 网络许可证	`v1.18.1`（最近一个带 CPU / Eigen 构建的版本），`eigenavx2` 版起不来时改用 `eigen` 版；网络 `kata1-b15c192-s1672170752-d466197061`（katagotraining.org）	analysis 引擎 JSON，`reportAnalysisWinratesAs = SIDETOMOVE`；坐标如 D4

游戏 · 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 桌面大脑同时驱动同一游戏（双脑）。

更新日志

按版本从新到旧整理，依据 git 标签、提交记录与 GitHub Releases。

0.4.3（2026-10-16）

修复：Gmail 组件移除旧版邮件中转模式（地址和密码留空时沿用本机已保存的邮箱）；现在必须在设置中填写 Gmail 地址和应用专用密码。之前靠留空沿用的用户，组件会提示「请填写 Gmail 地址和应用专用密码」。
说明：0.4.2 已打 git 标签但从未发布到 npm，其改动并入本版本；请直接升级到 0.4.3。

0.4.2（未发布，2026-10-16）

仅有 git 标签，未发布到 npm；改动见 0.4.3。

0.4.1（2026-10-16）

修复：聊天室「所有者 Telegram 用户 ID」不再有内置默认值；留空时，Telegram 上的所有者操作（「批准 +N」「执行」、/bind、/unbind）一律拒绝，本机桌面端仍视为所有者。
修复：「cursor-agent 路径」不再有内置默认值；留空时自动在 PATH 和常见安装位置查找，找不到时提示「未找到 cursor-agent」。
修改：设置页示例改为通用占位（如「例：123456789」「例：D:\projects\my-app」）；聊天室中您的名字留空时显示为「用户」。
修改：package.json 的简介改为英文；README 中的 Node 版本要求与 engines 一致（^22.19 || >=24）。

0.4.0（2026-10-14）

新增：正式版，包含 0.4.0-beta.1 与 0.4.0-beta.2 的全部功能：「游戏」分组的牌类（5 种牌类游戏）与棋类（4 种棋）组件，「多模态」分组的「GPT Image 2 生图」，「通用」分组的「网关核验」。
修改：「通道 › Telegram」同时接入多个机器人仍为实验性，未验证，不建议使用；多 AI 聊天室仍为实验性，默认关闭且不在设置页显示。
修改：需要 Node.js ^22.19 || >=24。

0.4.0-beta.2（预览版，2026-10-14）

新增：在「游戏」分组中新增牌类组件，在设置页下载 RLCard 后可玩 5 种牌类游戏（二十一点、勒杜克扑克、限注德州扑克、UNO、斗地主）。启用后可在聊天中让 AI 开局并对打，进度自动存档，Telegram 中以图片显示牌桌。
新增：在本机设置环境变量 DSH_WORK_SHOW_EXPERIMENTAL=1，或在插件数据目录放一个 show-experimental 文件，设置页会显示实验性的「聊天室」；默认仍隐藏、关闭。
修改（实验性，未验证，不建议使用）：「通道 › Telegram」初步支持同时接入多个机器人，功能仍在开发中。
修复：设置页打开时偶发「无法连接插件宿主接口」的问题。

0.4.0-beta.1（预览版，2026-10-14）

新增：在「游戏」分组中新增棋类组件，支持中国象棋、国际象棋、五子棋、围棋 4 种棋。启用后可在聊天中与 AI 对弈；可另行下载辅助引擎（Pikafish、Stockfish、Rapfi、KataGo），AI 走棋前会参考候选着法与胜率。
新增：在「多模态」分组中新增「GPT Image 2 生图」，填入 API Key 后可在对话中让 AI 文生图或编辑图片，图片保存在插件数据目录。
新增：在「通用」分组中新增「网关核验」，在聊天输入栏打开「核验」后，逐轮检查中转网关的回包模型、流式、Token 计数、中文完整性与缓存，结果显示在回复下方。
新增：多 AI 聊天室（实验性），默认关闭且暂不在设置页显示。
修改：需要 Node.js ^22.19 || >=24；预览版在 npm 上以 beta 标签发布，不影响正式版。
修复：地图、桌面控制停靠窗口恢复与通知重复显示等问题。

0.3.4（2026-10-12）

修改：「笔记」列表的标签改为两行显示，更易阅读。
修复：天气不可用时，日历卡片不再显示空的天气信息。

0.3.3（2026-10-12）

新增：在「通用」分组中新增「笔记」，启用后 AI 可把任务中总结的要点按「类型 › 类别 › 笔记」保存，之后检索复用，也可在设置页查看和编辑。
新增：在「工作组件」分组中新增 Gmail 组件。
新增：「通道 › Telegram」支持群聊，并只允许所有者使用会改动电脑的工具。
修改：桌面控制窗口支持停靠；通知可右键关闭；检查更新更可靠。

0.3.2（2026-10-10）

新增：日历显示天气图标与更长的预报，发到 Telegram 时另附一条月历；桌面控制点击、滚动时显示光标与按键动画。
修改：「游戏」分组（Minecraft / 文明 VI / 视觉）标为实验性。

0.3.1（2026-10-10）

新增：在「多模态」分组中新增「地图」（高德地点检索、路线规划、天气与静态地图，路线可发到手机）和「日历」（农历、节气、法定节假日、日程与天气）。
修改：启动时即显示连接与更新检查的进度提示；每次启动都会检查更新。

0.3.0（2026-10-10）

新增：在「通用」分组中新增「桌面控制」，AI 可按控件操作本机窗口，进行输入、点击、滚动和截图。
新增：「通道 › Telegram」并入工作组件，可在设置页直接配置。
新增：「游戏」分组内置 GameBot（Minecraft、文明 VI、视觉）。
新增：组件安装可取消，并显示实时进度；设置页支持通知堆叠与自动检查更新。
修改：设置页文字与安装日志跟随浅色 / 深色主题。
修复：安装本地组件时偶发失败的问题。

0.2.2（2026-10-05）

修复：部分环境下启动崩溃；收起右侧栏时样式异常。

0.2.1（2026-10-03）

新增：首个公开版本。设置页「工作组件」分组可一键安装并启用 Office、Blender、Unity、Figma、Photoshop、Chrome、Godot、Windows、Notion、Cloudflare、GitHub、ComfyUI、FFmpeg、Obsidian 等组件，供 AI 在会话中调用。
新增：「会话控制」（实验性，默认关闭）；支持添加本地组件。
修复：设置页空白。

meya-ashuripehya/dsh-work-components

dsh-work-components（工作组件）

DeepSlate（Minecraft 结构渲染）

Termalin（SSH）

KiCad（社区 KiCad MCP Pro）

Fusion（Autodesk 官方 MCP 服务器）

FreeCAD（社区 freecad-mcp）

MATLAB（官方 MATLAB MCP Server）

ESP-IDF（Espressif 官方 MCP 服务器）

串口（社区 serial-mcp-server）

Rhino（官方 RhinoAI，或社区 rhinomcp）

Altium（社区 eda-agent）

安装

数据目录

模型的图片与视频输入

实装截图

设置页

「已连接」

架构（给开发者）

从纯 MCP（cordis.patch）迁入

构建与测试

会话控制（通用）

功能

使用注意

API（宿主）

通道 · Telegram

多 AI 聊天室（实验性）

上下文与滚动摘要

点名主答

依赖说明

构建与校验

设置 Schema

Cordis（插件运行时）

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

通道栈（@wsz987）与 HTTP

牌类

棋类辅助引擎（按需下载，独立进程）

游戏 · GameBot

更新日志

0.4.3（2026-10-16）

0.4.2（未发布，2026-10-16）

0.4.1（2026-10-16）

0.4.0（2026-10-14）

0.4.0-beta.2（预览版，2026-10-14）

0.4.0-beta.1（预览版，2026-10-14）

0.3.4（2026-10-12）

0.3.3（2026-10-12）

0.3.2（2026-10-10）

0.3.1（2026-10-10）

0.3.0（2026-10-10）

0.2.2（2026-10-05）

0.2.1（2026-10-03）

Community comments

meya-ashuripehya/dsh-work-components

dsh-work-components（工作组件）

DeepSlate（Minecraft 结构渲染）

Termalin（SSH）

KiCad（社区 KiCad MCP Pro）

Fusion（Autodesk 官方 MCP 服务器）

FreeCAD（社区 freecad-mcp）

MATLAB（官方 MATLAB MCP Server）

ESP-IDF（Espressif 官方 MCP 服务器）

串口（社区 serial-mcp-server）

Rhino（官方 RhinoAI，或社区 rhinomcp）

Altium（社区 eda-agent）

安装

数据目录

模型的图片与视频输入

实装截图

设置页

「已连接」

架构（给开发者）

从纯 MCP（cordis.patch）迁入

构建与测试

会话控制（通用）

功能

使用注意

API（宿主）

通道 · Telegram

多 AI 聊天室（实验性）