DeepSeek Harness

DeepSeek Harness（简称 DSH）是 DeepSeek 官方推出的智能 Agent 编程环境。

模力方舟官方插件

模力方舟官方提供了专属接入插件 dsh-moark，提供对 DeepSeek Harness 的原生兼容支持。

全面支持流式输出（Streaming）、工具调用（Tool Calling）与思维链推理内容展示（Reasoning Content / Thinking）。

开源仓库：gitee.com/moark/dsh-moark / github.com/oschina/dsh-moark

前置准备

1. 确认 Harness 版本：DeepSeek Harness 0.2.1-rc.2 或兼容的 0.2.x。
2. 准备运行环境：确保已安装 DeepSeek Harness Desktop，或可以运行 DSH Web / CLI。
3. 获取访问令牌：前往 工作台 -> 设置 -> 访问令牌 创建或复制访问令牌。建议为插件创建专属令牌。
4. 确认资源包额度：确认账号拥有足够的运行资源包余额，或访问令牌已绑定相应资源权限。

安装插件

Desktop 和 Web 的 profile 相互独立，需要分别安装。

Desktop 客户端安装（推荐）

1. 打开 DeepSeek Harness 客户端。
2. 点击左侧导航栏的 插件 菜单。
3. 点击 「+ 添加插件」，输入 npm 包名 dsh-moark，确认安装。

CLI 命令行安装

安装提示

运行 DeepSeek Harness Desktop 时，优先在客户端内通过「插件管理」安装；若通过 CLI 操作，请务必先退出 DeepSeek Harness Desktop。

如果习惯使用终端管理插件，请在完全退出桌面端进程后，执行以下命令：

dsh plugin --profile desktop add dsh-moark

DSH Web / npx

DSH Web 使用独立的 web profile，需要和 Desktop 分别安装插件。

安装插件：

dsh plugin --profile web add dsh-moark

如果本机没有全局 dsh 命令，可以通过 npx 执行：

npx @deepseek-ai/dsh plugin --profile web add dsh-moark

如果 Web 已经启动，也可以直接在左侧 Plugins 中搜索安装；安装后重启一次 Web 进程。

启动 Web：

dsh web

或者：

npx @deepseek-ai/dsh web

打开终端输出的 Web 地址后，进入 Settings → 模力方舟 · MoArk。如果安装前 Web 已经在运行，安装插件后重启一次 Web 进程。

安装完成后，在 DeepSeek Harness 设置左侧列表中将出现 模力方舟 · MoArk 设置入口。

接入配置

插件接入（推荐）

配置服务区域与访问令牌

在 DeepSeek Harness 左侧导航点击 设置 → 模力方舟 · MoArk，点击顶部的 「接入 / 更新」 打开连接设置弹窗，设置 接入点 与 访问令牌。

模力方舟国内和海外站各自独立部署，属于两套系统，访问令牌不互通

• 插件当前支持如下区域接入
  • 国内站：https://api.moark.com/v1（默认）
  • 海外站：https://api.moark.ai/v1
  • 自定义地址；支持兼容 OpenAI API 并支持 /chat/completions 与 /models 的接入地址
• 访问令牌：粘贴从模力方舟控制台获取的访问令牌（Access Token）。

获取与选择模型

1. 插件默认预选了常用高性能编码模型（如 qwen3.8-flash、deepseek-v4.1-flash 等）。
2. 点击工具栏中的 「获取模型」 按钮，插件将拉取当前令牌可用的全部文本对话模型。
3. 点击模型卡片即可切换启用或关闭状态；在目标卡片底部选中 「设为默认首选」，新会话将默认以此模型作为主力模型。

验证与保存

1. 点击 「测试连接」，验证网络连通性与令牌有效性；
2. 点击 「接入 / 更新」 保存，插件会自动存储凭据、安全合并路由并执行端到端流式自测。

手动配置（不安装插件）

如果不使用插件，也可以直接在 Harness 原生设置中配置：

1. 在 DeepSeek Harness 左侧导航点击 「设置」 → 模型。
2. 添加自定义 Provider 并配置以下字段：

配置项	填写说明
提供商名称	MoArk 或 模力方舟 (MoArk)
API 协议	openai-completions
Base URL（国内）	https://api.moark.com/v1
Base URL（海外）	https://api.moark.ai/v1
API Key / 环境变量	在 Harness 凭据中设置 MOARK_API_KEY（或直接填入访问令牌）
模型列表	手动添加所需模型 ID（如 qwen3.8-flash、deepseek-v4.1-flash 等）

保存后回到会话，在模型选择器中切换至 MoArk 及其模型，即可开始智能编码对话与工程协助。

---

常见问题与排查

1. 提示 401 / 令牌无效

• 请前往 工作台 -> 设置 -> 访问令牌 检查令牌是否有效。
• 确认复制时未夹带前后空格或隐藏字符。

2. 提示 400 资源包或额度错误

• 确认账户内已购买对应资源包，且未过期或耗尽。
• 若使用了权限受限的访问令牌，请确认已为该令牌分配了对应模型的访问权限。

3. 模型列表为空

• 确认当前访问令牌已授权至少一个文本对话模型；
• 点击页面上的 「获取模型」 重新拉取；
• 检查网络是否可正常连接所选服务区域的 Base URL。

4. 如何撤销接入并回滚？

• 插件在写入前会自动保存快照。在 Settings → 模力方舟 · MoArk 页面点击工具栏的 「回滚」，即可将提供商配置还原为接入前的快照。

---

卸载与停用

1. 回滚路由：在卸载插件前，建议先进入插件设置页点击 「回滚」，清理写入的模型路由。
2. 卸载插件：
   • Desktop 界面：进入左侧 Plugins，找到 dsh-moark 点击卸载；
   • Desktop CLI：退出客户端后执行 dsh plugin --profile desktop remove dsh-moark；
   • Web / npx：停止 Web 进程后执行 dsh plugin --profile web remove dsh-moark，没有全局 dsh 时使用 npx @deepseek-ai/dsh plugin --profile web remove dsh-moark。
3. 清理令牌：回滚不会删除已保存的访问令牌；如需彻底停用，请在 MoArk 控制台撤销对应令牌，并在 Harness 凭据管理中清除 MOARK_API_KEY。