统一编辑器运行时creativedswork/dsh-uni-editor

DSH Uni Editor

CI
npm
GitHub release
license

所有 Editor，一个 DSH Editor。

DSH Uni Editor 将现有 Editor 接入 DeepSeek Harness Agent Chat。Editor 保留自己的 UI、数据模型和领域工具；DSH 统一入口、当前 Session 上下文，以及人工编辑与 Agent 之间可验证的交接。

它是一个基于稳定版 MCP Apps 的 Cordis 插件包。一个 npm 包同时提供 Host 插件、Browser bundle，以及用于启用两者的 dsh.bundle patch。

Host 管理 MCP 连接，通过 Harness 注册模型可见工具，不把 app-only 工具暴露给模型，并通过不同源的 Sandbox Proxy 运行不受信任的 View。整个方案不需要修改 Agent Loop，也不需要外部 MCP 代理。

观看视频演示，了解 threejs-editor-mcp 如何直接运行在 DSH Chat UI 中。Editor 始终可以从 Session Header 返回；inline 与 fullscreen 切换不会重建 iframe，并可通过 Locate in Chat 返回产生该 App 的工具消息。

安装

将 npm 包安装到 Web profile：

dsh plugin --profile web add @creative-dswork/dsh-uni-editor

安装后 bundle 会自动启用。在 $DSH_HOME/profiles/web/cordis.patch.yml 中配置 mcp-apps：

- id: mcp-apps
config:
servers:
- serverName: counter
transport: stdio
command: node
args: [/absolute/path/to/server.js]
cwd: /absolute/path/to/server
forwardWorkspace: true
prompts:
autoInject:
- serverName: counter
name: test-review-loop
arguments:
threshold: '85'

forwardWorkspace 默认关闭，只应对需要当前 DSH Workspace 的可信本地 stdio
Server 启用。transport: streamable-http 不会收到 Workspace metadata；此时改为
提供 url 和可选的 headers，不再填写 command、args、cwd 和 env。
serverName 必须匹配 [A-Za-z0-9_-]{1,32}，它会成为公开工具名的一部分。

prompts.autoInject 是显式信任白名单。Host 会对每个配置项调用 MCP
prompts/list 和 prompts/get，再将返回的指导内容加入 Harness system
prompt。这样 Agent 可以在普通 Turn 中主动采用 MCP 提供的工作流，不需要
Slash Command。当前只接受 user-role 文本和内嵌文本资源；Server 断开时会
移除对应 Prompt，收到 notifications/prompts/list_changed 后会重新加载。
不要将不可信 Server 的 Prompt 加入白名单，因为这些内容会获得 system
prompt 权限。

启动 Harness：

dsh web

Web profile 必须绑定到 127.0.0.1。当前 Sandbox Proxy 只支持 loopback 浏览器，因此插件会拒绝范围更大的监听地址。

独立 Counter Demo

仓库内置了一个本地 stdio MCP Server：

- show_counter：模型可见工具，关联 ui://counter/app；
- increment_counter：只有该 View 可以调用的 app-only 工具；
- 一个使用 MCP Apps 官方 App 的内置 View。

下面的命令使用已发布的 Harness CLI，不依赖相邻的 deepseek-harness 源码目录：

pnpm install
pnpm run build
export DSH_HOME="$PWD/.tmp/demo-home"
pnpm dlx @deepseek-ai/dsh@0.1.0-rc.6 plugin --profile web add "$PWD"
pnpm dlx @deepseek-ai/dsh@0.1.0-rc.6 web --patch "$PWD/demo/cordis.patch.yml"

打开命令输出的 URL，将当前目录连接为 workspace，然后让已配置的模型显示 counter。工具调用完成后，工具卡片会渲染数值 0；点击 + 时，View 会通过 Host 调用 app-only 的 increment_counter，并把数值更新为 1。

完整编辑器示例请参阅 threejs-editor-mcp。

行为

- 目标规范为 MCP Apps 2026-01-26，View MIME 类型为 text/html;profile=mcp-app。
- 支持 stdio 和 Streamable HTTP 两种 MCP transport。
- 只将明确加入白名单的 MCP Prompt 注入 Harness system prompt，并标注来源。
- 识别 _meta.ui.visibility；省略该字段时，工具同时对模型和 App 可见。
- 对设置 forwardWorkspace: true 的可信本地 stdio Server，将调用 Agent
不可变的 Workspace cwd 写入模型发起的 tools/call request metadata
ai.deepseek.dsh/workspace。远程 HTTP、App 发起的调用以及模型可见的 tool
参数和结果都不包含该值。
- 将可读文本交给模型，同时把 structuredContent 和结果 _meta 保存在受大小限制、仅 UI 可见的 presentation metadata 中。
- 使用官方 AppBridge 和 PostMessageTransport 处理 View 生命周期，以及 App 发起的工具和资源调用。
- 在 Session Header 中提供持续可见的 Active App 入口，并支持多个 MCP App Instance。
- 打开 fullscreen 时不重建 iframe 或 AppBridge，保留 View 中尚未保存的状态。
- 通过 Locate in Chat 返回产生该 App 的原始工具消息。
- 代理 ui/download-file，允许下载一个最大 4 MiB 的内嵌 JSON 资源，因为 Sandbox View 无法直接下载文件。
- 在独立 loopback origin 上通过 HTTP header 强制执行 CSP，并校验 postMessage 的 source 和 origin。
- View 加载失败时回退到普通文本工具结果。

工具列表变化会自动同步；transport 自动重连尚未实现。Browser 每五秒刷新一次 catalog。

安全架构

flowchart LR
Agent["Harness Agent"] -->|"模型可见工具"| Host["MCP Apps Host127.0.0.1"]
Host -->|"stdio 或 Streamable HTTP"| Server["MCP Server"]

subgraph Browser["浏览器"]
UI["Harness UIHost origin"]
Proxy["Sandbox Proxy独立 loopback origin"]
View["MCP App View双层 iframe Sandbox"]
UI -->|"经过校验的 postMessage"| Proxy
Proxy -->|"CSP + sandbox 属性"| View
end

Host -->|"受大小限制的 View 和资源 API"| UI
View -->|"app-only 工具和 ui/message"| UI
UI -->|"经过授权的 bridge 调用"| Host

- Host 和 Sandbox Proxy 使用不同的 loopback origin。
- View 运行在双层 iframe 中，由 HTTP CSP 和明确的 sandbox 属性共同约束。
- bridge 接受消息前会校验 postMessage 的 source 和 origin。
- 工具可见性将模型可见工具与 app-only 工具分开。
- Host API 拒绝跨源写入，并限制请求体和 metadata 的大小。

开发

pnpm install
pnpm run check
pnpm run pack:dry-run

将本地 checkout 安装到 profile：

dsh plugin --profile web add .
dsh --profile web --dump-config

发布

prepack 会执行类型检查、生产构建和包测试。npm tarball 包含 Host 入口、Browser bundle、类型声明、bundle patch、许可证和中英文 README，不包含开发 Demo 文件。

发布通过 Publish workflow 手动触发。npm environment 必须提供有权发布 @creative-dswork scope 的 NPM_TOKEN。workflow 会携带 provenance 发布 npm 包；npm 发布成功后，再创建对应版本的 tag 和 GitHub Release。

0.2.0 及更早版本以 @creative-dswork/dsh-mcp-apps 发布。当前版本请安装 @creative-dswork/dsh-uni-editor。