DeepSeek Harness 创造模式完整教程:5 步创建插件、验证生效与保存专属模式
发布日期:2026-11-03
DeepSeek Harness 创造模式(Creator Mode)是 DeepSeek 官方提供的插件与 Agent 预设开发模式。截至 2026 年 11 月,官方帮助说明它具备标准任务工具,并增加运行时检查、Cordis 插件和预设开发指引。使用时,新建任务并选择创造模式,描述要增加的能力、使用入口和验收方式,再让 Agent 完成安装与实际验证。下面从启动 Web 端开始,用“项目笔记”插件串起操作流程,最后创建可复用的代码审查模式,并说明插件保存、即时加载和重启生效的区别。

第 1 步:启动 Harness,准备独立工作区
创造模式运行在 Harness 内,无需单独安装一个“Creator”程序。首次尝试可以准备一个示例目录,避免混入现有项目文件。
安装 Node.js 后,在终端执行官方 README 提供的启动命令:
mkdir -p harness-creator-demo
cd harness-creator-demo
npx @deepseek-ai/dsh web截至 2026 年 11 月 3 日,README 标注 Web UI 默认地址为 http://127.0.0.1:3080,本地启动会打开浏览器;实际地址以终端输出为准。保持该终端进程运行,在示例目录中放入几份 Markdown 笔记供后续验收。
第 2 步:配置模型,选中项目目录
先让普通对话和工作区可用,再进入插件开发。官方 Web UI 指南说明:全新界面不会自动选中工作区,选中前会话输入框不可用。
以七牛云接口为例,按当前 Harness 模型指南打开“设置 → 模型 → 添加模型提供商”,切到“自定义模型 API”,填写:
Provider ID:自定义小写标识,例如
qiniu。基础 URL:
https://api.qnaigc.com/v1。API 协议:
OpenAI Chat Completions。API 密钥与模型 ID:从七牛控制台获取,复制模型广场提供的模型 ID,避免误填展示名称。
七牛开发者中心的 Harness 接入文档确认了上述 API 地址、密钥和模型 ID 获取位置;当前界面路径以 Harness 官方模型指南为准。
保存后在模型选择器中选中模型,再点击“选择工作区”,添加并选中刚才的示例目录。先发送一句“列出当前工作区中的 Markdown 文件”,检查模型和文件读取是否正常。
第 3 步:新建创造模式任务,描述第一个插件
新建任务时选择“创造模式”,把“做什么、入口在哪、如何验收”一起交代。官方帮助提供了侧栏项目笔记示例,下面在其基础上补充文件范围和验收要求:
帮我写一个 DeepSeek Harness 插件,在侧栏增加“项目笔记”入口。
列出当前工作区的 Markdown 文件,点击后预览内容。
先检查当前运行时与已有插件,说明实施方案。
插件运行时只读取笔记,不修改笔记文件,不扫描工作区外目录。
允许在示例工作区创建插件源码和必要配置。
完成插件安装,并验证入口能打开、文件列表正确、预览内容一致。
最后报告生成的文件、组合包名称、安装状态,以及是否需要重启。这是一份可复制的任务模板,实际生成结果需要在你的环境中验证。第一次先完成文件列表和预览,等基础功能通过,再增加搜索、标签等需求。

第 4 步:检查安装状态,验证插件真正可用
插件生成源码后,还需要安装、激活和功能验收。官方帮助明确要求安装并验证实际效果;插件可能即时加载,也可能需要重启。
根据 2026 年 11 月核验的 Dynamic Cordis 教程,使用 Plugin Manager 安装时应区分以下结果:
在“项目笔记”示例中,依次检查侧栏入口、文件列表和预览内容。再正常重启同一 profile,确认功能仍可使用。profile 是运行配置,插件改动会影响使用它的其他会话。需要审批的操作按当前权限策略处理;侧栏“插件”页用于管理插件组合包。
如果入口没有出现,让 Agent 检查安装结果、运行时状态和错误日志。官方 Plugin Manager 文档说明,部分启用失败会保留依赖及选择状态,必要时停用或卸载对应组合包,再修复重试。
第 5 步:创建专属模式,在新任务中复用
插件用来增加工具、服务连接或界面;模式是一份 Agent 预设,用来组合工具与工作规则。官方帮助给出的另一项 Creator 用法,就是基于标准模式创建代码审查预设。
可以继续发送:
基于标准模式创建“代码审查”模式。
优先检查潜在错误和测试缺口,指出文件路径与行号。
先输出问题与依据,修改文件前先询问我。
保存成可在新任务中选择的 Agent 预设,并说明保存位置。完成后创建一个新任务,选择“代码审查”模式,用一份示例代码检查其输出是否符合要求。新预设在新建任务时选择,已有任务不会因此自动切换。提示词规定工作方式,实际可执行操作仍由权限设置决定。
掌握这条流程后,再尝试连接外部服务。官方 Dynamic Cordis 教程提供了配置 MCP 的进阶案例,前提是已有可访问、提供 ping 工具的 Streamable HTTP MCP 服务器。

验收要同时看到 application: applied 和成功的 mcp__demo__ping 调用。
本文依据 DeepSeek Harness 官方帮助、Web UI 指南与 Dynamic Cordis 教程整理,资料截至 2026 年 11 月 3 日。文中提示词为操作模板,具体结果需在本地环境中验收。
参考资料
DeepSeek Harness 官方 README:https://github.com/deepseek-ai/deepseek-harness
DeepSeek Harness 官方 Web UI 指南:https://github.com/deepseek-ai/deepseek-harness/blob/master/docs/user/guide/index.zh.md
DeepSeek Harness 官方模型配置指南:https://github.com/deepseek-ai/deepseek-harness/blob/master/docs/user/guide/providers.zh.md
Dynamic Cordis 官方教程:https://deepseek-harness.github.io/deepseek-harness/develop/practice/dynamic-cordis
Plugin Manager 官方说明:https://github.com/deepseek-ai/deepseek-harness/blob/master/packages/boot/plugin-manager/README.zh.md
七牛云实时推理请求 API 接入说明:https://developer.qiniu.com/aitokenapi/13379/real-time-ai-interface-api
七牛开发者中心 Harness 接入文档:https://developer.qiniu.com/aitokenapi/13550/deepseek-harness-configuration-access-ai
相关文章
七牛云产品
七牛云 AI 大模型广场:https://www.qiniu.com/ai/models