dsh-moark
Verifieddsh-moark · v0.1.0 · MIT · Web UI
MoArk (模力方舟) provider onboarding for DeepSeek Harness
Install
dsh plugin add dsh-moark Confirm the layer applied with dsh --profile default --dump-config — see the install guide.
Source
Tags
Creators
Readme
简体中文 | English
要求
- DeepSeek Harness
0.2.1-rc.2或兼容的0.2.x - MoArk 访问令牌(MoArk 控制台 → 设置 → 访问令牌)
安装
DeepSeek Harness Desktop
打开 设置 → 内置插件,从 npm 安装 dsh-moark。
DeepSeek Harness Web / CLI
dsh plugin --profile web add dsh-moark
安装后重启对应的 DSH profile,或刷新页面。
Desktop 如需使用 CLI,请先完全退出 Desktop:
dsh plugin --profile desktop add dsh-moark
不需要
npm install -g dsh-moark;插件由 DSH profile 管理。
快速开始
- 在模力方舟控制台创建访问令牌。
- 打开
设置 → 模力方舟 · MoArk。 - 选择服务区域:
- 国内:
https://api.moark.com/v1 - 海外:
https://api.moark.ai/v1 - 或自定义 Endpoint
- 国内:
- 填写访问令牌。已保存过令牌时可以留空。
- 点击
获取模型,从 MoArk 拉取当前令牌可用的对话模型。 - 选择要在 DSH 中使用的模型;可在卡片/列表视图间切换。
- 点击
接入 / 更新。插件会写入 provider、等待 DSH 注册,并执行一次流式自测。 - 在模型选择器中选择 MoArk 及对应模型。
如果访问令牌已配置、当前 profile 尚无 providers.moark,打开设置页时会自动用默认模型接入一次。
设置页
| 操作 | 说明 |
|---|---|
| 接入 / 更新 | 写入或更新 MoArk provider;失败自动回滚 |
| 测试连接 | 直接访问 MoArk API,检查 Endpoint 与令牌 |
| 回滚 | 恢复到本次接入前的 llm-pi-ai 配置 |
| 运行自测 | 通过 DSH 的 LLM 服务发起一次真实请求 |
| 获取模型 | 拉取当前令牌可用的对话模型 |
| 添加模型 | 手动填写显示名称与模型 ID |
模型卡片支持:
- 点击整卡切换是否启用;
- 卡片底部
设为默认首选:接入时将该模型设为 DSH 新会话的默认模型; 编辑模型:修改显示名称、上下文窗口、最大输出 token、输入类型(文本/图片);- 复制模型 ID;
- 卡片/列表两种视图。
上下文与最大输出留空时,使用 llm-pi-ai 的默认值(262,144 / 32,768)。
也可以继续使用 DSH 原生的 设置 → 模型 → 模力方舟 编辑器;本插件再次更新时会保留原生编辑器里改过的 provider/model 元数据。
写入内容
| 位置 | 内容 |
|---|---|
| DSH 凭据 | MOARK_API_KEY |
llm-pi-ai |
providers.moark |
| 默认模型(可选) | agentDefaultModel |
插件只合并写入 providers.moark,不会覆盖其他 provider。
安全
- 访问令牌只保存在 DSH 凭据存储中,不写入 provider 配置、日志或页面存储;
- 插件 Host 路由只监听本机回环地址;
- 建议为 DSH 单独创建 MoArk 令牌,便于随时撤销;
- 回滚只会移除 provider,不会自动删除已保存的令牌;如需更换请直接覆盖或在凭据管理中清除。
故障排查
| 现象 | 处理 |
|---|---|
| 401 / 令牌无效 | 在 MoArk 控制台重新生成令牌并填写 |
| 400 资源包或额度错误 | 检查运行包余额、令牌绑定与模型授权 |
| 海外站连接失败 | 确认选择海外区域,使用 https://api.moark.ai/v1 |
| 模型列表为空 | 确认令牌可用、区域正确,然后重新点击 获取模型 |
| 接入后模型选择器没有 MoArk | 运行 运行自测;仍失败时回滚后重新接入 |
| Desktop CLI 安装失败 | 先完全退出 Desktop,再执行 dsh plugin --profile desktop add dsh-moark |
卸载
- 在设置页点击
回滚,移除providers.moark; - 在
设置 → 内置插件中移除插件,或执行:
dsh plugin --profile web remove dsh-moark
- 如需彻底停用,在 MoArk 控制台撤销对应访问令牌。