Paseo 智能体接入 yannassoumou/dsh-paseo

面向 Paseo 的 DeepSeek Harness 服务商插件

把 DeepSeek Harness 注册为 Paseo 的编程智能体：借助 Paseo 的 runAcpProvider() 适配层，包装 DSH 内置的 ACP 服务器配置档（dsh --profile acp）。会话生命周期、时间线、权限、模型和模式都由 Paseo 映射，无需改动 DSH 代码。

安装

前提：守护进程所在机器的 PATH 中有 dsh 命令行（也可以按服务商覆盖命令，见下文），并且至少配置了一个配置档；守护进程已启用插件（Settings → Plugins → Enable plugins）。

paseo plugin add git:yannassoumou/dsh-paseo

也可以从本地检出安装：

paseo plugin install /absolute/path/to/dsh-paseo

然后在 Paseo 中创建智能体，选择 DeepSeek Harness 服务商。

启动指定的 DSH 二进制或配置档

插件默认启动 dsh --profile acp。Paseo 允许在守护进程的 ~/.paseo/config.json 中，通过 agents.providers 替换任意服务商命令（改完后执行 paseo reload --json 生效）。如果想运行本地检出，而不是 PATH 中的 dsh：

{
"agents": {
"providers": {
"dsh": {
"command": ["/Users/you/dsh/apps/cli/lib/bin.js", "--profile", "acp"]
}
}
}
}

绝对路径会直接执行（不需要通过 PATH 查找），文件必须设置可执行位。如果还没有 acp 配置档，可以用 --from-default-profile acp 把随包附带的 acp 配置档复制一份到 $DSH_HOME/profiles。

选择 ACP 会话启动时使用的模型

Paseo 打开的每个会话，初始服务商和模型都由 ACP 应用自己的配置决定。在 $DSH_HOME/profiles/acp/cordis.patch.yml 中指向一个已配置的路由（把 yas 和模型 id 换成你自己配置的路由）：

- id: acp
name: "@deepseek-ai/dsh-acp"
config:
provider: yas
model: qwen3.8-flash-next-iq3_s-dual-262k

API 密钥来自 DSH 自己的凭据存储（$DSH_HOME/.credentials.yaml）或启动环境，Paseo 不需要传递。

Paseo 编排工具

Paseo 会向智能体会话注入 MCP 工具，让智能体能启动其他智能体。部分本地模型后端会拒绝这些工具的模式定义（例如 vLLM 要求 additionalProperties 必须是布尔值）；如果对话因 400 负载错误失败，可以按服务商在 ~/.paseo/config.json 中禁用：

{ "agents": { "providers": { "dsh": { "paseoTools": { "enabled": false } } } } }

说明

桥接层做了什么

DSH 的 ACP 服务器（dsh --profile acp）会持久化会话，并支持 session/resume；但 Paseo 用 ACP 的 session/load 重新打开服务商会话，这个变体还会重放对话记录。DSH 没有实现该变体，插件负责补齐：

- 持久化：桥接层声明 agentCapabilities.loadSession，并把 Paseo 的把 session/load 改成 session/resume，会话就能在守护进程重启、空闲超时和 paseo agent reload 之后继续存活；
- 历史回放：Paseo 重新打开时会清空自己的时间线，并期望服务商回放历史，因此桥接层把每个会话的对话记录存到 ~/.local/state/dsh-paseo/transcripts/ 下，等会话重新打开时再作为时间线条目注入回去；
- 流式正确性：DSH 给同一条消息的推理块和文本块打上相同的 messageId；桥接层把它们拆开，让推理和回答分别渲染成独立条目。

- ACP 会话持久化：Paseo 重新打开 DSH 会话时，DSH 会话会原生恢复，包括 DSH 侧的智能体上下文（已验证：reload 或杀掉 ACP 进程之前记住的词，之后仍能回忆起来）。
- 插件没有客户端代码；Paseo 标准的 ACP 时间线渲染器覆盖了全部需求。

配套插件：在 DSH 工作区浏览器里显示 Paseo 会话

Paseo 智能体拥有持久的 DSH 会话，但没有任何东西为它们的 cwd 创建 DSH 工作区，所以它们都待在 Ungrouped 分组里。companion/paseo-session-workspaces.ts 是一个 DSH 插件（不属于 Paseo 插件），它监视 Paseo 守护进程的智能体记录，把每个 Paseo 会话挂到其 cwd 对应的 DSH 工作区上，标题取自 Paseo 项目（worktree 用 project · branch）。这样每个会话都会出现在 DSH 浏览器里对应的工作区下，带完整轨迹、搜索和历史。

把它装进 DSH 的 web 配置档（配置档内的插件文件，无需构建步骤）：

mkdir -p ~/.dsh/profiles/web/plugins
cp companion/paseo-session-workspaces.ts ~/.dsh/profiles/web/plugins/

然后追加到 ~/.dsh/profiles/web/cordis.patch.yml：

- insert:
- id: paseo-session-workspaces
name: ./plugins/paseo-session-workspaces.ts

相对插件名按配置档目录解析。HMR 会在补丁编辑后重载配置档；如果运行中的宿主日志出现 HMR is disposed，重启 DSH web 宿主。选项：在该条目的 config: 块下配置 paseoHome（默认 ~/.paseo）、enabledProviders（默认 ["dsh"]）、scanIntervalMs（默认 5000）。