try-works/dsh-cloudflare

dsh-cloudflare

DeepSeek Harness (DSH) 插件，提供与 Codex Cloudflare 插件 1:1 对等的功能，发布形式见
openai/plugins plugins/cloudflare。

它打包了 Codex 插件的完整技能面及其两个斜杠命令，
新增了两个额外的 Cloudflare 技能（think 和 flue），并附带了一份
可直接应用的 cordis.yml，用于其单个 MCP 服务器。

它提供什么

技能

十一个 Cloudflare 技能包，以 cloudflare provider 的形式被发现。前九个
逐字取自 Codex 插件；think 和 flue
是自行编写的补充，覆盖 Codex 插件尚未提供的 Cloudflare 技术（见 PROVENANCE.md）。

| 技能 | 用途 |
| --- | --- |
| agents-sdk | 使用 Agents SDK 在 Cloudflare Workers 上构建 AI 智能体 |
| building-ai-agent-on-cloudflare | 端到端智能体构建工作流 |
| building-mcp-server-on-cloudflare | 在 Workers 上构建远程 MCP 服务器 |
| cloudflare | 全面的 Cloudflare 平台技能 |
| durable-objects | 使用 Durable Objects 进行有状态协调 |
| flue | 在 Cloudflare 上构建/部署 Flue 智能体（Flue Durable Objects、Workers AI） |
| sandbox-sdk | 安全的沙箱化代码执行 |
| think | 使用 @cloudflare/think 的持久化聊天智能体 |
| web-perf | 通过 Chrome DevTools MCP 进行 Web 性能审计 |
| workers-best-practices | Workers 生产环境最佳实践审查 |
| wrangler | Wrangler CLI 用法与配置 |

该目录由 scripts/gen-manifest.mjs 从内置的 SKILL.md frontmatter 生成，
因此 DSH 目录对每个技能目录都保持单一事实来源
（见 PROVENANCE.md）。

斜杠命令

Codex 命令 /cloudflare:build-agent 和 /cloudflare:build-mcp
映射到 DSH 的命令名语法（该语法禁止 :），映射如下：

- /cloudflare-build-agent
- /cloudflare-build-mcp

每个处理程序会展开逐字取自 Codex 的命令简述（替换
$ARGUMENTS），并将其作为后续回合排队到接收智能体上，然后
进行确认——保留 Codex 的“调用→由模型完成工作”的行为。

MCP 服务器

Codex 插件声明了一个 MCP 服务器。DSH 为每个
@deepseek-ai/dsh-mcp-client 实例建模一个 MCP 服务器，因此随附的补丁层会在插件行旁边插入
一行 cloudflare-api mcp-client。cloudflare-api 服务器镜像 .mcp.json
（https://mcp.cloudflare.com/mcp）——即 Cloudflare Code Mode 服务器，
覆盖完整的 Cloudflare API（约 1,000 个 token 中涵盖 2,500+ 个端点）。

智能体默认使用此服务器进行实时 Cloudflare 工作。 cloudflare 和 wrangler 技能指示模型在检查或操作
账户时，优先使用 Code Mode 的
搜索 → 执行流程，而非 wrangler/curl/SDK。Code Mode 暴露三个工具，DSH 将其命名为：

| Cloudflare 工具 | DSH 工具 | 用途 |
| --- | --- | --- |
| search | mcp__cloudflare-api__search | 通过针对 OpenAPI 规范运行 JS 来查找端点 |
| execute | mcp__cloudflare-api__execute | 通过 cloudflare.request() 调用 API |
| docs | mcp__cloudflare-api__docs | 搜索实时 Cloudflare 文档 |

完整指南和代码模式：packages/dsh-cloudflare/skills/cloudflare/references/api/codemode-mcp.md。

Cloudflare 还在
cloudflare/mcp-server-cloudflare
中发布了一组专注的、特定领域的 MCP 服务器。
为了实现与 Codex 的 1:1 对等，此插件仅附带 Code Mode；请通过下方的
--patch 覆盖层按配置文件添加其余部分（每个都是一行
@deepseek-ai/dsh-mcp-client）。

Cloudflare MCP 服务器目录

| 服务器 | 用途 | URL |
| --- | --- | --- |
| Code mode | 通过代码执行访问完整的 Cloudflare API（极低的 token 开销） | https://mcp.cloudflare.com/mcp |
| AI Gateway | 搜索日志；提示/响应详情 | https://ai-gateway.mcp.cloudflare.com/mcp |
| Audit Logs | 查询审计日志，生成审查报告 | https://auditlogs.mcp.cloudflare.com/mcp |
| AutoRAG | 搜索和查询账户 AutoRAG 实例 | https://autorag.mcp.cloudflare.com/mcp |
| Browser Run | 抓取页面、转换为 markdown、截图 | https://browser.mcp.cloudflare.com/mcp |
| Cloudflare Blog | 搜索和阅读 Cloudflare 博客文章 | https://blog.mcp.cloudflare.com/mcp |
| Cloudflare One CASB | SaaS 安全配置错误检查 | https://casb.mcp.cloudflare.com/mcp |
| Container | 启动沙盒开发环境 | https://containers.mcp.cloudflare.com/mcp |
| Demo Day | 最小示例 Cloudflare MCP 服务器 | https://demo-day.mcp.cloudflare.com/mcp |
| Digital Experience Monitoring | 关键应用健康洞察 | https://dex.mcp.cloudflare.com/mcp |
| DNS Analytics | DNS 性能和问题调试 | https://dns-analytics.mcp.cloudflare.com/mcp |
| Documentation | 最新的 Cloudflare 参考信息 | https://docs.mcp.cloudflare.com/mcp |
| Logpush | Logpush 作业健康状况的快速摘要 | https://logs.mcp.cloudflare.com/mcp |
| Observability | 应用日志和分析调试 | https://observability.mcp.cloudflare.com/mcp |
| Radar | Cloudflare Radar 互联网洞察 | https://radar.mcp.cloudflare.com/mcp |
| Workers Bindings | Workers 存储/AI/计算原语 | https://bindings.mcp.cloudflare.com/mcp |
| Workers Builds | 管理 Cloudflare Workers Builds | https://builds.mcp.cloudflare.com/mcp |

参考资料：
Code Mode MCP 博客文章，
github.com/cloudflare/mcp-server-cloudflare，
Cloudflare MCP 服务器文档。

按配置文件添加更多 MCP 服务器（可选）

该包在
packages/dsh-cloudflare/mcp/ 下为每个可选服务器附带了一个可直接应用的覆盖层
（外加 all.yml，可一次性选择启用所有特定领域的服务器）。附带的 cordis.patch.yml 有意
在一个服务器上保持与 Codex 对等——这些叠加层是可选启用的：

一个服务器
dsh --profile  --patch packages/dsh-cloudflare/mcp/docs.yml

多个服务器（--patch 可重复）
dsh --profile  \
--patch packages/dsh-cloudflare/mcp/docs.yml \
--patch packages/dsh-cloudflare/mcp/observability.yml

所有特定于域的服务器
dsh --profile  --patch packages/dsh-cloudflare/mcp/all.yml

| 叠加文件 | 服务器 |
| --- | --- |
| mcp/ai-gateway.yml | AI Gateway |
| mcp/audit-logs.yml | Audit Logs |
| mcp/autorag.yml | AutoRAG |
| mcp/browser.yml | Browser Run |
| mcp/blog.yml | Cloudflare Blog |
| mcp/casb.yml | Cloudflare One CASB |
| mcp/containers.yml | Container |
| mcp/demo-day.yml | Demo Day |
| mcp/dex.yml | Digital Experience Monitoring |
| mcp/dns-analytics.yml | DNS Analytics |
| mcp/docs.yml | Documentation |
| mcp/logpush.yml | Logpush |
| mcp/observability.yml | Observability |
| mcp/radar.yml | Radar |
| mcp/bindings.yml | Workers Bindings |
| mcp/builds.yml | Workers Builds |
| mcp/all.yml | 以上全部 |

每个叠加层都是一个普通的 cordis.patch.yml 格式列表，包含单个
@deepseek-ai/dsh-mcp-client 行（id/name 为 cloudflare-）。它们
在 profile 层之后干净地组合，并且不会改变始终启用的
cloudflare-api 行。

安装

已发布到 npm，名称为 @try-works/dsh-cloudflare。

@try-works/dsh-cloudflare 既是一个 DSH bundle，也是一个插件：它的
package.json 声明了 dsh.bundle.patch，指向随附的
cordis.patch.yml，该文件会插入插件行以及 MCP 客户端行。
因此，将其作为插件安装会自动挂载整个层：

dsh plugin --profile  add @try-works/dsh-cloudflare

dsh plugin 会转发到 profile 目录中的 pnpm，然后将该
包协调到 dsh.profile.bundles 中，因为它声明了 dsh.bundle；在
下一次启动时，profile 会将随附的 cordis.patch.yml 组合到其
各层之上。（将其作为普通依赖安装——例如 pnpm add
@try-works/dsh-cloudflare——仍然可行，但只会发出警告，并且不会挂载
该层；在这种情况下，请应用仓库根目录的 cordis.yml 叠加层。）

对于手动 --patch 安装，仓库根目录的 cordis.yml 包含相同的
两行：

dsh --profile  --patch ./cordis.yml

无论哪种方式，都要求 profile 已经提供 ctx.skills、
ctx.commands 和 ctx.tools（随附的 @deepseek-ai/dsh-base
bundle 会提供），这样 skills、斜杠命令和 MCP 工具才能干净地挂载。

DSH 如何感知插件

DSH 没有插件自动发现机制：当加载器条目行命名了某个插件时，即当它的 name 出现在组合后的
条目树中时，该插件才会被运行时知晓。bundle 的 dsh.plugin add 路径和 --patch 叠加层
都只是添加该行的方式；一旦该行被组合，插件的
apply 会注册其技能（ctx.skills）和命令（ctx.commands），这正是使它们对模型可用的原因——技能目录（@deepseek-ai/dsh-tool-skill）和命令注册表会将已注册的技能和命令呈现给 agent。

AGENTS.md 不是插件注册机制，也不需要为了插件正常工作而编辑它。DSH 的 @deepseek-ai/dsh-agent-instructions 仅从项目树和 $DSH_HOME 加载 AGENTS.md/CLAUDE.md；它没有插件清单输入。向 AGENTS.md 添加注释是可选的按工作区约定，而不是此插件要求或执行的操作。

开发

node scripts/gen-manifest.mjs   # regenerate src/manifest.ts from vendored SKILL.md
node scripts/typecheck.mjs      # tsc -b packages/dsh-cloudflare (builds lib/)
node scripts/parity-check.mjs   # assert 11 skills / 2 commands / 1 MCP server

该包可独立构建：在 packages/dsh-cloudflare 内运行 npm install（devDependencies 包含 typescript 和 @types/node，peer 依赖从 npm 解析），然后 npm run build / npm run prepack 会生成 lib/。scripts/typecheck.mjs 首先查找包本地的 typescript，否则回退到位于 DSH_HARNESS（默认 D:/deepseek-harness）的 DeepSeek Harness 检出。

来源与许可证

内置的技能/命令源自 openai/plugins，提交为 11c74d6ba24d3a6d48f54a194cd00ef3beea18f9（插件版本 0.1.2）。完整记录见 PROVENANCE.md。该包和插件代码采用 Apache-2.0 许可（见仓库根目录的 LICENSE）；内置技能内容带有各自的许可证，Cloudflare 和 Flue 捆绑包采用 Apache-2.0（见 packages/dsh-cloudflare/skills/*/LICENSE.txt）。