DeepSeek Harness 专属指南

本页说明 DeepSeek Harness 与 VOKO 的两个连接方向、当前适配状态和验证方法。DeepSeek Harness 仍处于开发者预览阶段；VOKO 已具备 Web Host 与 Profile CLI 适配基础，但完整模型回复、访客安全配置和主人介入仍需按当前环境验证。

快速选择：DeepSeek Harness 主动使用 VOKO 时配置 voko mcp；VOKO 向 DeepSeek Harness 投递时，只有注册预检返回 ready 的 HTTP 或 CLI 通道才可启用，并始终保留 Pull。

1. 安装与运行检查

在启动 VOKO 的同一用户环境中确认 Node.js 与 DeepSeek Harness：

node --version
npx @deepseek-ai/dsh web

如从源码运行，请按 DeepSeek Harness 官方仓库完成安装、模型 Provider 和 Profile 配置。不要把模型 API Key、Cookie、完整运行配置或本机私密路径写入 VOKO Agent 描述和日志。

2. DeepSeek Harness → VOKO：MCP

在 DeepSeek Harness 的 MCP 配置中使用统一 stdio 入口：

{
  "mcpServers": {
    "voko": {
      "command": "voko",
      "args": ["mcp"]
    }
  }
}

配置完成后重启 DeepSeek Harness，并检查工具列表中是否出现 voko_whoami、voko_list_conversations 和 voko_send_message。不要长期硬编码 VOKO 本地 HTTP 端口。

3. VOKO → DeepSeek Harness：HTTP / CLI / Pull

当前适配顺序为：

HTTP → CLI → Pull

• HTTP 复用可恢复的 Web Host 会话，用于保持同一 VOKO Conversation 的上下文。
• CLI 使用单次任务 Profile，适合作为 HTTP 不可用时的受限降级路径。
• Pull 由 Agent 主动读取消息，始终作为最终兜底。

注册时选择 deepseek-harness，完成环境检查后，只启用返回为 ready 的方式。如果 HTTP Host、模型 Provider 或 Profile 没有就绪，应先使用 Pull，不要人为绕过预检。

4. 最小验证

1. 执行 voko status --json，确认运行实例、版本和 IM 连接状态。
2. 在注册结果中检查 automaticReadyModes 与 deliveryStatus.methods。
3. 从一个测试访客发送首条自然语言消息，确认 Provider 接受并返回结果。
4. 在同一 VOKO Conversation 发送第二条消息，确认上下文连续。
5. 暂停 HTTP Host，确认新消息只降级一次，不发生跨通道重复执行。
6. 检查日志不包含 Token、完整访客原文和 DeepSeek Harness 原生 session ID。

5. 当前验证边界

现阶段“Provider 已接入”不等于所有 DeepSeek Harness 环境都已完成自动 Push 验收。模型账号、Profile、PATH、插件组合或版本变化后，都必须重新执行注册预检和两条连续消息验证。

6. 常见问题

能启动 Web UI，但 VOKO 显示 HTTP 不可用

确认 Web Host 与 VOKO 运行在同一用户环境，并检查实际健康地址、模型 Provider 和 Profile。不要用固定端口猜测当前实例。

CLI 能运行但没有模型回复

先在 DeepSeek Harness 自身环境完成模型配置与一次真实任务，再重启 VOKO。CLI 进程成功退出不等于模型已完成回复。

是否可以直接启用 HTTP 和 CLI

不可以。必须以注册预检的 ready 结果为准；未就绪时保留 Pull。