{"slug": "integrate-the-deepseek-harness-into-paseo-guide", "title": "Integrate the DeepSeek Harness into Paseo Guide", "summary": "A developer documented integrating DeepSeek Harness (DSH) into Paseo by registering the agent's ACP stdio profile as a generic provider, allowing remote clients to drive a locally running DSH instance. The writeup details editing Paseo's config.json, pre-installing the ACP profile to avoid a 20-second probe timeout, and verifying the setup with provider diagnostics and a smoke test. The integration passed checks for model selection, reasoning effort, session persistence, permissions, and MCP, though DSH lacks modes support.", "body_md": "2026-09-10 实操记录并逐项验证。环境：macOS（mac-studio.local）、Paseo 0.8.0、DSH `@deepseek-ai/dsh` 0.1.5-rc.1。\n\nDeepSeek Harness（DSH）不是只有浏览器 Web 端口。`dsh web` 只是 `--profile web` 的别名，DSH 的官方入口模式里本来就有一个标准 ACP server：\n\n```\ndsh --profile acp     # ACP over stdio，直到客户端断开\n```\n\nPaseo 支持「把任意讲 ACP 的 agent 注册成 provider」，所以接入方式就是把 DSH 当通用 ACP provider 加进 Paseo。\n\n数据流：\n\n```\nPaseo 客户端（手机 / 桌面 / 浏览器）\n        │  relay / 局域网 / Tailscale\n        ▼\nPaseo daemon\n        │  按 command 自己 spawn\n        ▼\ndsh --profile acp（子进程，每个 agent 一个）\n        ▼\nDeepSeek API\n```\n\n这个结构带来一个额外好处：执行在本机，控制面可以远程。DSH 本身默认只监听 `127.0.0.1:3080`，接进 Paseo 之后，你在外面用手机就能驱动本机的 DSH。\n\n```\nnpm i -g @deepseek-ai/dsh\ndsh --version\n```\n\n- npm 上的 `@deepseek-ai/dsh` 本体很小（约 48KB），它是个 launcher；真正的运行时依赖在首次启动某个 profile 时才装进`$DSH_HOME/profiles/` 。\n\n```\ndsh web               # 默认 http://127.0.0.1:3080\n```\n\n浏览器里进 Settings → Models，填入 DeepSeek API key 并保存。\n\n```\ndsh --profile acp --help\n```\n\n首次执行会初始化 `~/.dsh/profiles/acp` 并把依赖装好；`--help` 只打印帮助后退出，不会占用 stdin/stdout。\n\n为什么必须先手动跑一次：Paseo 的 ACP 探针有约 20 秒超时，如果让 Paseo 触发首次安装，provider 会以\"不可用\"告终。\n\n编辑 `~/.paseo/config.json`，在 `agents.providers` 下加一段（改前先备份）：\n\n```\n\"dsh\": {\n  \"extends\": \"acp\",\n  \"label\": \"DeepSeek Harness\",\n  \"description\": \"DeepSeek Harness (dsh) coding agent over ACP stdio.\",\n  \"command\": [\"dsh\", \"--profile\", \"acp\"],\n  \"env\": {},\n  \"enabled\": true\n}\n```\n\n如果 dsh 不在 daemon 的 PATH 里，`command` 换成绝对路径，例如：\n\n```\n\"command\": [\"/Users/<你>/.local/share/fnm/node-versions/<ver>/installation/bin/dsh\", \"--profile\", \"acp\"]\npaseo reload           # provider 改动不需要重启 daemon，不会打断正在跑的 agent\npaseo provider ls\npaseo provider diagnostic dsh\npaseo provider models dsh\n```\n\n本次实测输出：\n\n```\nDeepSeek Harness (ACP)\n  Launcher binary: dsh\n  Resolved path:   ~/.local/share/fnm/.../bin/dsh\n  Version:         0.1.5-rc.1\n  ACP spawn:       ok (0ms)\n  ACP initialize:  ok (363ms)\n  ACP session/new: ok (45ms; models=4; modes=0)\n  ACP cleanup:     ok (29ms)\n  Status:          Ready\n```\n\n**再做一次真实冒烟：**\n\n```\npaseo run --provider dsh --title \"冒烟测试\" \\\n  \"只回复两个字：ok。不要调用任何工具，不要修改任何文件。\"\n```\n\n| 能力 | DSH acp profile | Paseo 通用 ACP adapter | 结果 | \n|---|---|---|---|\n| 协议 | ACP v1 over stdio | `extends: \"acp\"` | ✅ | \n| `authenticate` | 立即成功、不需要认证 | Paseo 根本不调用它 | ✅ | \n| 模型选择 | config option id `model` ，category`model` | 读 `model` 类 config option | ✅ 能切模型 | \n| 推理档位 | config option `reasoning_effort` ，category**`thought_level`** | 映射为 thinking 档位 | ✅ 能选档位 | \n| 会话持久化 | `session/list` /`resume` /`close` | 原生支持 | ✅ | \n| 权限 | `session/request_permission` ，只有`allow_once` /`reject_once` | Auto Accept 找 allow 选项 | ✅ | \n| MCP | 支持 stdio / HTTP 声明 | 默认注入自身 MCP | ✅ 实测通过 | \n| 模式（modes） | **没有** | 无 modes 时跳过 `setMode` | ⚠️ 别配 `modeId` | \n| 客户端 fs / 终端 | 不使用，靠自己的工具 | 默认 fs=false | ✅ 互不干扰 |", "url": "https://wpnews.pro/news/integrate-the-deepseek-harness-into-paseo-guide", "canonical_source": "https://gist.github.com/robbin/b0b3cc024d88235b1ebeecce5499b5e8", "published_at": "2026-09-11 06:03:22+00:00", "updated_at": "2026-09-11 06:55:48.056116+00:00", "lang": "en", "topics": ["ai-agents", "ai-tools", "developer-tools", "ai-products"], "entities": ["DeepSeek", "DeepSeek Harness", "Paseo", "DeepSeek API", "ACP", "MCP"], "alternates": {"html": "https://wpnews.pro/news/integrate-the-deepseek-harness-into-paseo-guide", "markdown": "https://wpnews.pro/news/integrate-the-deepseek-harness-into-paseo-guide.md", "text": "https://wpnews.pro/news/integrate-the-deepseek-harness-into-paseo-guide.txt", "jsonld": "https://wpnews.pro/news/integrate-the-deepseek-harness-into-paseo-guide.jsonld"}}