前言¶
DeepSeek Harness（DSH）遵循“一切皆插件”的设计理念，其 CLI 工具通常与特定的运行时环境或协议集成。当你需要将 DSH 的推理能力直接暴露给 Multica 时，需要一个符合特定 JSONL 过程协议的桥接层。dsh-profile-multica 作为一个安装式社区包，实现了这一点，它将官方 DSH CLI 转换为 Multica 可识别的 JSONL 流。
核心功能¶
该插件通过一个专用的 multica profile 向 DSH 添加了以下能力：
- 添加命令：新增三个命令行选项：
--probe、--list-models和--stdio。 - 模型发现：
--list-models命令会投影当前已安装的 DSH 提供商、模型和推理级别。 - 事件流：
--stdio模式接受执行请求，并将 Agent 和 Session 事件以 JSONL 格式流式传输。 - 请求取消：支持对正在进行的请求进行取消操作。
安装与启用¶
在安装前，请确保环境满足以下要求：
- Node.js 版本为
^22.19.0或>=24.0.0 @deepseek-ai/dsh版本为0.1.0-rc.7或兼容的后续预发布版本- PATH 中包含 pnpm 以便调用
dsh plugin
安装插件需要使用官方 CLI 命令：
dsh plugin --profile multica add dsh-profile-multica
安装完成后，可以执行以下命令验证插件是否生效：
dsh --profile multica --probe
典型用法¶
1. 探测与模型列表¶
--probe 命令用于打印 Multica 使用的发现帧。--list-models 则用于查看当前配置的可用模型列表：
dsh --profile multica --probe
dsh --profile multica --list-models
2. 执行请求与事件流¶
--stdio 命令是核心执行入口。它接受一个版本 1 的执行请求，通过 stdout 流式输出事件，并通过 stderr 输出诊断信息。
在使用前，需要配置环境变量：
MULTICA_DSH_SESSION_ROOT：选择 JSONL 持久化目录。DSH_PERMISSION_MODE：设置权限模式。选项包括read-only（只读）、workspace-write（工作区写，默认）或danger-full-access（完全访问）。
由于协议没有交互式批准回合，因此必须在执行前选择符合当前环境策略的权限模式。
适用场景与注意¶
- 单进程单请求：协议限制一个进程只能接受一个执行请求。Multica 在处理任务时，需要为每个任务启动一个全新的进程。
- 无交互批准：该协议没有批准响应机制。如果操作超出了所选的策略范围，操作会直接失败，而不会等待人工批准。
- 模型发现容错：在模型发现过程中，如果某个提供商失败，插件会将其错误信息打印到 stderr，然后继续处理剩余的提供商，不会中断整个流程。
- API 版本跟踪：该包跟踪预发布 DSH API。如果 DSH 发布了新的预发布版本，可能需要等待插件发布相应的匹配版本。
总结¶
如果你需要在 Multica 中直接利用 DeepSeek Harness 的能力，dsh-profile-multica 提供了一个基于 JSONL 协议的轻量级桥接方案。它通过标准的命令行接口和流式事件传输，实现了 DSH 与 Multica 的集成。
