paseo-dsh-direct

English | 中文

paseo-dsh-direct 通过 Direct Provider，把本机的 DeepSeek Harness（dsh）接入 Paseo。

安装

需要 Paseo 0.11 及以上，并在运行 Paseo daemon 的机器上装好 dsh，它的 major.minor 要和你装的插件线一致。Paseo 0.8 至 0.10 请安装 npm:[email protected]。

在 Paseo 里打开 Settings → Plugins → Install Plugin，npm 和 Git 两种来源任填一个：

| 你的 dsh | npm | Git | |---|---|---| | 0.2.x | npm:paseo-dsh-direct | https://github.com/Jecvay/paseo-dsh-direct | | 0.1.x | npm:[email protected] | 只能用命令行：paseo plugin install https://github.com/Jecvay/paseo-dsh-direct --ref rel/0.1 |

更新插件在 daemon 所在机器上运行（App 的插件菜单里没有更新入口）：

paseo plugin update paseo-dsh-direct --check   # 看有没有新版本
paseo plugin update paseo-dsh-direct --yes     # 更新到最新

更多：兼容性说明 · 命令行安装、本地目录安装、环境变量

为什么叫 Direct

其他 dsh 接入大多走 ACP，那是一套所有 agent 都能用的通用协议。本插件不走 ACP，直接原生对接 dsh，dsh 的各种行为都能按 Paseo 自己的方式呈现：

• 回复和思考过程流畅地流式输出，不会被切成一段一段。
• 工具审批和 dsh 向你提的问题，显示成 Paseo 自带的审批卡片和问答卡片。
• 已有的 dsh 会话可以导入 Paseo 接着用。
• dsh 的斜杠命令（/compact、/plan 等）出现在 Paseo 的 / 菜单里。
• Paseo 的用量表显示 dsh 的 token 用量和上下文占用。
• 目标变化（dsh 自己在 /goal 命令输出里已报告的除外）、计划模式切换和权限预设变化会在对话里显示为小的时间线卡片。

版本号

插件版本号的 major.minor 跟随它支持的 dsh 线；最后一位是插件自己的发布计数，不跟 dsh 走。按本机的 dsh 版本选装对应线——见上表，完整规则和已实测的 dsh 版本见兼容性说明。

使用

新建对话时选择 DeepSeek Harness。模型和 preset 来自已配置的 DSH profile。已有原生 DSH 会话可通过 Paseo 的 Import session 导入，并保留原生会话标识。

Provider 支持连续正文和思考输出、工具执行与审批、用户问答、模型和 preset 配置、中断及会话恢复。它用插件专用的 paseo profile 启动 DSH，不修改 Paseo 或 DSH 核心。

插件使用名为 paseo 的 DSH profile。首次启动时，插件用 DSH 官方的 web 模板自动创建它（位置是 ~/.dsh/profiles/paseo；设置了 $DSH_HOME 时在其下）。模型路由、默认模型和权限预设写在 ~/.dsh/profiles/paseo/cordis.patch.yml。可在 Paseo 设置里的 DeepSeek Harness 页通过 Executable、Profile 指定可执行文件和 profile。可执行文件的选择顺序：PASEO_DSH_EXECUTABLE、设置页、Paseo 配置的 agents.providers.dsh-pi.command、PATH 里的 dsh。profile 的选择顺序：PASEO_DSH_PROFILE、设置页、默认的 paseo；显式指定的 profile 不会被自动创建。

在同一设置页的 Startup timeout 中填写桥接就绪等待时间，接受 1–600 整数秒，留空仍用默认 15 秒。它只控制启动桥接进程到收到就绪信号（bridge.ready）的等待，没有环境变量覆盖。设置对所有新启动的桥接生效，包括会话创建/恢复、模型目录/历史会话查询和子代理设置读写；已运行的桥接不受影响。

创建默认 profile（60 秒）、检查启动配置（20 秒）和后续初始化请求（bridge.initialize，30 秒）各有独立时限。等待加长也可能延长连接关闭等待。

Paseo 0.11、0.14 和 0.15.3 对建立 Provider 连接和普通插件请求（RPC）设有 30 秒外层时限。因此，设置更长的桥接等待不保证模型目录查询或子代理设置操作能等那么久。请求超时后底层任务仍可能继续，设置保存也可能稍后完成；重试前先核对当前状态。这些版本中，建立连接后打开会话的事件路径（session.open）没有同类外层计时器。600 秒是允许填写的上限，不代表整个操作可等待 600 秒。详见等待范围与源码依据。

如果 Paseo Daemon 默认关闭插件加载，请先在配置中启用 pluginsEnabled。

同一设置页的 Subagent models 区域可以按名称或提供方搜索模型、逐项勾选、全选、清空或关闭选模。首次初始化会选中当前可用的全部模型并保存到 DSH profile；已有选择（包括显式关闭）会保留，后续新增模型需要手动勾选。改动对支持选模的 preset 的新会话生效，详见设置页说明。

如果原生会话仍被另一个 DSH 客户端（如终端界面）占用，请先在那里释放，再从 Paseo 导入或恢复。

从源码安装

用于本地开发，或不走 Settings 界面直接安装：

git clone https://github.com/Jecvay/paseo-dsh-direct.git
cd paseo-dsh-direct
npm ci
npm run build
paseo plugin install "$PWD"
paseo plugin ls
paseo provider models dsh-pi

构建后也可以直接安装本地源码：paseo plugin install /absolute/path/to/paseo-dsh-direct。命令行还能指定 Settings 界面给不了的 Git ref：

paseo plugin install github:Jecvay/paseo-dsh-direct --ref <tag-or-commit>

开发

npm ci
npm run build
npm run typecheck
npm test
npm run verify:notes
npm run verify:docs

参阅文档索引、兼容性说明、插件开发与验证和 Alpha 验收规范。

许可

MIT