前言¶
DeepSeek Harness (DSH) 采用插件化架构，允许通过扩展功能来适配不同的模型或工具。在使用本地工具链（如 Cursor CLI）时，一种常见需求是将 Web UI 中的对话请求直接路由到本地已登录的 CLI，而不是通过 DSH 的 API 网关转发。dsh-cursor-passthrough 插件正是为此设计，它通过在模型选择器中增加一个专用分组，实现这一路由逻辑。
插件定位¶
这是一个社区维护的插件，由用户 mingzhong15 开发。它的核心功能是在 DSH 的聊天模型选择器中添加一个名为 Cursor 直通 的分组。当用户选择该分组时，Web UI 会拦截对话轮次，并在本地直接运行 agent acp，从而利用本地已登录的 Cursor CLI 处理请求。
与 dsh-cursor-acp 的区别¶
该插件与 dsh-cursor-acp 不同：
* dsh-cursor-acp：在父聊天使用 DSH 模型时，注册一个 cursor_agent 工具。
* dsh-cursor-passthrough：修改模型选择器的路由，让整轮对话直接走 Cursor CLI。
安装前准备¶
在安装本插件前，请确保环境满足以下条件：
- 已安装 DeepSeek Harness 和 Cursor CLI，并运行过
agent login登录。 - 在同一 Profile 下安装了
dsh-cursor-acp。本插件复用了该插件的 CLI 发现辅助工具，但不会重复注册工具。
安装步骤¶
根据你的运行环境，选择对应的安装命令。
Web Profile:
dsh plugin --profile web add github:mingzhong15/dsh-cursor-passthrough
Desktop:
dsh plugin --profile desktop add github:mingzhong15/dsh-cursor-passthrough
本地检出 (Local Checkout):
dsh plugin --profile web add link:/path/to/dsh-cursor-passthrough
安装完成后，需要重启 DeepSeek Harness。如果是远程浏览器，建议硬刷新（Ctrl+Shift+R）。
启用与使用¶
- 安装完成后，进入 Settings（设置） -> Cursor 直通。
- 使用右侧的开关控制该分组在模型选择器中的可见性。
- 在聊天界面，从模型选择器中选择 Cursor 直通 分组。
- 选择具体的 Cursor 模型（如 Paratera、DeepSeek 等），对话将直接通过本地 CLI 处理。
此时，Composer 区域会显示一个绿色徽章，表明当前会话处于 Cursor 直通模式。
工作原理¶
当选中的 Provider 为 cursor 时，DSH 会拦截 llm/stream 请求，并在本地执行 agent acp。对于 Cursor 会话，会话标题和压缩逻辑也会使用本地占位符，从而跳过 DSH 的 API 适配层。
注意事项¶
- 本插件不是官方 Cursor 产品。
- 需要确保本地环境已正确登录 Cursor CLI。
- 需要配合
dsh-cursor-acp使用以获取 CLI 发现辅助功能。 - 代码基于 MIT 协议开源。
结语¶
dsh-cursor-passthrough 提供了一种在 DSH 中直接调用本地 Cursor 能力的标准化路由方式。如果你需要在 Web 界面中无缝切换使用本地 CLI 而不改变 DSH 的模型选择逻辑，这是一个实用的工具。
