Mempemp/DSH-runner-rlm-tools-bsl

dsh-rlm-tools-bsl

rlm-tools-bsl 的生命周期与 DeepSeek Harness 的运行时间完全一致。

DSH 的插件运行器：在 DSH 启动时拉起 MCP 服务器 rlm-tools-bsl（用于对 1С 代码库进行令牌高效分析），随 DSH 一起关闭，并在设置选项卡中显示服务器状态以及 MCP 配置参数。该服务器不会注册为 Windows 服务：它由 DSH 进程启动，并随其一起终止。

功能

🔁 服务器随 DSH 一起启动和关闭
DSH 启动时，插件会在本地端口（默认 9330）上运行 rlm-tools-bsl --transport streamable-http，并通过 MCP 握手等待其就绪。DSH 停止时，进程会连同整个进程树一起被终止（uv 跳板 → python → uvicorn），因此端口会被释放。

⚙️ 设置中的「rlm-tools-bsl」选项卡
状态（插件进程运行中 / 已接管外部进程 / 已停止 / 端口被占用 / 错误）、版本和 pid、「重启」按钮、端口字段以及供 MCP 管理器使用的现成 JSON（带「复制」按钮）。出错时会立即显示错误文本和日志的最后几行。服务器本身的配置仍保留在其自己的配置文件中。

📦 自动安装服务器
如果系统中没有 rlm-tools-bsl，插件会自行安装它——如果连 uv 也没有，则一并安装。可通过 autoInstall: false 键禁用。

🔎 接管已运行的服务器与 takeover
如果端口上已有服务器在响应（上次会话遗留的），插件不会启动第二个，而是接管现有的——并且在 DSH 退出时仍会将其关闭（位于我们端口上的服务器被视为自己的；可通过插件行中的 takeover: false 键禁用）。它通过 MCP 握手区分「自己的」服务器和别人的：/health 返回通用的 {"status":"ok"}，而只有 initialize 才知道名称和版本。

🔗 自动注册到 MCP 管理器
插件会自行在已安装的 MCP 管理器的存储中维护 rlm 记录，并在端口变更时更新它；不会触碰其他记录。可通过 mcpAutoRegister: false 键禁用。

🚧 端口被占用
如果端口被其他应用程序占用，选项卡会显示具体是谁（进程名和 pid），并附上日志链接以查看其他启动错误。

🔌 供其他插件和代理使用的 /rlm/ 路由
GET /rlm/state — 状态和参数，GET /rlm/log?tail=N — 日志尾部，POST /rlm/start|stop|restart，POST /rlm/save — 端口。

如何将服务器连接到 DSH（MCP）

插件会自行在已安装的 MCP 管理器的存储中维护服务器记录——无需手动执行「Add」步骤：

| 管理器 | 存储 | 名称字段 |
|---|---|---|
| dsh-mcp-manager | $DSH_HOME/mcp-servers.json | serverName |
| @wingsky-1/dsh-mcp-manager | $DSH_HOME/dsh-mcp.json | name |

记录会在服务器首次成功启动时创建，在端口变更时更新，文件中的其他记录会保留；两个管理器都会在运行时重新读取各自的文件，无需重启 DSH。结果可在选项卡的「连接到 DSH」区块中看到。删除插件后，记录仍会保留在文件中——请在管理器中将其删除。
对于插件不认识的服务器管理器，需手动添加服务器：

方式 1 — 通过 UI（推荐）。 Settings → MCP Server Manager → Add → 传输方式 streamable-http，名称 rlm，URL：

http://127.0.0.1:9330/mcp

方式 2 — 以字符串形式写入文件 ~/.dsh/mcp-servers.json（文件会被热重载，无需重启）。将对象添加到 servers 数组中：

{
"serverName": "rlm",
"transport": "streamable-http",
"url": "http://127.0.0.1:9330/mcp",
"enabled": true
}

空文件的完整内容：

{
"version": 1,
"servers": [
{
"serverName": "rlm",
"transport": "streamable-http",
"url": "http://127.0.0.1:9330/mcp",
"enabled": true
}
]
}

名称 rlm 会提供工具 mcp__rlm__rlm_start、mcp__rlm__rlm_execute、mcp__rlm__rlm_help、mcp__rlm__rlm_projects、mcp__rlm__rlm_index、mcp__rlm__rlm_end。

URL 中的端口必须与选项卡中的端口一致（默认为 9330）。文件格式和字段名称由管理器本身定义——如有疑问，请通过其 UI 添加服务器。

方式 3 — 静态配置文件行（如果不使用 MCP 管理器）——写入 ~/.dsh/profiles/web/cordis.patch.yml：

- insert:
- id: mcp-rlm
name: '@deepseek-ai/dsh-mcp-client'
config:
serverName: rlm
transport: streamable-http
url: http://127.0.0.1:9330/mcp

方式 3 不依赖 MCP 管理器——这是通过 DSH 自身手段进行的连接。不要将方式 1 和方式 3 组合使用：两个具有相同 serverName 的 MCP 服务器会冲突。

安装

需要 dsh ≥ 0.1.2-rc.1 以及已安装的 rlm-tools-bsl（见下文）。有三种安装方式——结果相同。

从 release 安装（无需下载任何内容）：

dsh plugin --profile web add https://github.com/Mempemp/DSH-runner-rlm-tools-bsl/releases/download/v0.1.3/dsh-rlm-tools-bsl-0.1.3.tgz

本地归档 dsh-rlm-tools-bsl-0.1.3.tgz（从 release 页面下载或自行构建：cd dsh-rlm-tools-bsl && npm pack）：

dsh plugin --profile web add dsh-rlm-tools-bsl-0.1.0.tgz

插件文件夹（开发模式，对 lib/.js 的修改无需重新安装即可生效）：

dsh plugin --profile web add /dsh-rlm-tools-bsl

安装后请重启 DSH（插件组合在启动时读取）并刷新浏览器页面。

安装 rlm-tools-bsl 本身

如果系统中没有该服务器，插件会在首次启动时自行安装（参见“自动安装”）。当版本和位置由您选择时，才需要手动安装：

需要 uv —— 如果系统中没有 Python 3.10+，uv 会自行下载：

uv，如果还没有（无需管理员权限）
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

uv tool install rlm-tools-bsl     # 安装
uv tool upgrade rlm-tools-bsl     # 更新已安装的版本
rlm-tools-bsl --version           # 需要版本 ≥ 1.35
重复执行 uv tool install 不会更新已安装的包（rlm-tools-bsl is already installed）——更新需要使用 uv tool upgrade。

uv 的隔离环境：可执行文件为 %USERPROFILE%\.local\bin\rlm-tools-bsl.exe，服务不会注册。插件会自行查找文件：PATH → %USERPROFILE%\.local\bin → 自己的 bin 文件夹（参见「自动安装」）。其他路径通过插件行中的 command 键指定（参见「高级参数」）。更新包之后——在选项卡中「重新启动」。

不需要 Windows 服务（simple-install-from-pip.ps1）。如果它已安装：rlm-tools-bsl service status——状态，rlm-tools-bsl service stop——停止，rlm-tools-bsl service uninstall——卸载。仅停止是不够的：启动类型为「自动」的服务会在下次 Windows 启动时自动拉起。

数据和文件沙箱

rlm-tools-bsl 会写入工作文件夹之外：service.json 和 projects.json——写入 %USERPROFILE%\.config\rlm-tools-bsl，日志——写入 %USERPROFILE%\.config\rlm-tools-bsl\logs\server.log，缓存——写入 %USERPROFILE%\.cache\rlm-tools-bsl。日志目录必须可写：如果禁止写入（DSH 文件沙箱），服务器会以代码 1 退出，并在日志末尾出现 PermissionError。

重定向——通过插件行中的环境变量：RLM_CONFIG_FILE 将配置、日志和缓存一并迁移到其旁边，RLM_INDEX_DIR——SQLite 索引目录。

- id: rlm-tools-bsl
name: 'dsh-rlm-tools-bsl'
config:
env:
RLM_CONFIG_FILE: D:\rlm-data\service.json   # 日志：D:\rlm-data\logs，缓存：D:\rlm-data\cache
RLM_INDEX_DIR: D:\rlm-data\index

自动安装

如果启动时找不到命令，插件会自行将 rlm-tools-bsl 安装到 $DSH_HOME/rlm-tools-bsl：

- bin——可执行文件：rlm-tools-bsl.exe、rlm-bsl-index.exe，当系统中没有 uv 时——还有 uv.exe（通过官方脚本安装，PATH 不变）；
- tool——工具环境；python——Python，如果没有找到合适的系统 Python。

安装会在后台进行：选项卡显示状态「正在安装 rlm-tools-bsl…」，输出和错误——在日志末尾。插件行中的 autoInstall: false 键会关闭自动安装——那么当服务器缺失时，选项卡会显示错误以及用于手动安装的命令。

如果 dsh 不在 PATH 中

本地安装和 DSH Desktop 不会将 dsh 添加到 PATH——请通过 node 调用入口点。bin.js 的路径：

| DSH 的安装方式 | bin.js 的路径 |
|---|---|
| 本地（npm install @deepseek-ai/dsh） | \node_modules\@deepseek-ai\dsh\lib\bin.js |
| DSH Desktop | %LOCALAPPDATA%\Programs\DSH Desktop\resources\app\node_modules\@deepseek-ai\dsh\lib\bin.js |

node "C:\путь\к\dsh\lib\bin.js" plugin --profile web add "C:\путь\к\dsh-rlm-tools-bsl-0.1.0.tgz"

可能的困难

| 症状 | 该怎么办 |
|---|---|
| ERR_PNPM_UNEXPECTED_STORE | 在安装命令中添加 --store-dir=""（路径在错误文本本身中给出） |
| 写入 …\profiles\web 时出现 EPERM | 没有配置文件文件夹的权限（沙箱、杀毒软件）：关闭 DSH，允许写入，重试 |
| 关于 peer 依赖的警告（cordis、react、react-dom） | 忽略：插件没有外部依赖，react 来自 DSH 运行时 |
| 归档路径包含空格 | 在 pnpm 的 .cmd shim 上会出错——将归档放在无空格的路径中，或以文件夹方式安装 |
| 安装后 dsh.profile.bundles 中出现了多余的包 | dsh plugin add 会重写层列表：dshmarket 保持为“热”的插件（.dsh-market\hot-.yml）会获得永久激活。不需要的行可以从配置文件的 package.json 中删除，这不影响插件的工作 |
| 安装后没有选项卡 | DSH 未重启，或者页面未强制刷新（Ctrl+Shift+R） |
| 状态“端口被占用” | 端口被另一个进程占用（例如 rlm-tools-bsl 服务或其他应用）——选项卡中可以看到名称和 pid；停止它或更换端口 |
| 服务器以代码 1 崩溃，日志中有 PermissionError 指向 …\.config\rlm-tools-bsl\logs | 目录不可写（DSH 文件沙箱）：允许该路径，或在插件的环境变量中设置 RLM_CONFIG_FILE 和 RLM_INDEX_DIR——参见“数据与文件沙箱” |
| 重启后 rlm-tools-bsl 服务自行启动 | 服务安装时启动类型为“自动”：rlm-tools-bsl service uninstall，参见“安装 rlm-tools-bsl 本身” |

检查主机部分是否已启动：curl -s http://127.0.0.1:/rlm/state —— 应返回带有服务器状态的 JSON。 —— DSH Web UI 的端口（默认 3080，DSH Desktop 可能不同——可在浏览器地址栏中看到），而不是 MCP 服务器的端口。

参数

选项卡中配置一个字段——端口（port），它也会进入 MCP 的 URL。值按机器存储：$DSH_HOME/rlm-tools-bsl/settings.json（$DSH_HOME —— 环境变量，否则为 ~/.dsh）。

默认端口为 9330；rlm-tools-bsl 本身为 9000。端口在选项卡中设置，并进入 MCP 的 URL。

高级参数——插件行

键只能在配置文件的 cordis.patch.yml 中的插件行里设置（没有对应的 UI）：

- id: rlm-tools-bsl
name: 'dsh-rlm-tools-bsl'
config:
command: D:\tools\rlm\rlm-tools-bsl.exe      # 自定义可执行文件路径
port: 9330
env:                                          # 服务器环境变量，参见“数据与文件沙箱”
RLM_LLM_MODEL: deepseek-chat                # 示例：服务器本身的任意 RLM_ 键
takeover: true                                # 随 DSH 一起关闭，即使是接管的进程
autoInstall: true                             # 如果 rlm-tools-bsl 不存在，则自动安装
mcpAutoRegister: true                         # 将 rlm 记录写入 MCP 管理器存储

冲突时的优先级：settings.json 中的值（来自选项卡的端口）→ 插件行中的值 → 内置值。

使用

1. 安装插件并添加 MCP 服务器（参见「如何将服务器连接到 DSH」）。rlm-tools-bsl 在缺失时会自动安装。
2. 重启 DSH —— 在 Settings 中会出现 「rlm-tools-bsl」 选项卡，服务器会自动启动。
3. 检查状态：首次启动可能会经过「正在安装 rlm-tools-bsl…」，之后是「运行中（pid …，v1.35.1）」。出错时会显示错误文本和日志尾部，位于同一选项卡。
4. 关闭 DSH —— 服务器停止，端口释放。MCP 管理器会在下次启动时自动重新连接。

要求

- DeepSeek Harness（dsh web 或 DSH Desktop）≥ 0.1.2-rc.1 —— 该选项卡使用 settings.section 插槽
- Node.js ≥ 20
- rlm-tools-bsl ≥ 1.35 —— 缺失时插件会自动安装（参见「自动安装」）；手动安装需要 uv

HTTP 路由

| 方法和路径 | 用途 |
|---|---|
| GET /rlm/state | 服务器状态、当前参数、路径、日志尾部 |
| GET /rlm/log?tail=N | 进程日志尾部（默认 200 行，最多 500 行） |
| POST /rlm/start | 启动服务器（或接管已启动的服务器） |
| POST /rlm/stop | 停止服务器（如果启用了 takeover，也包括接管的服务器） |
| POST /rlm/restart | 重启 |
| POST /rlm/save | {settings:{port}} —— 保存端口 |

仓库结构

- dsh-rlm-tools-bsl/lib/index.js —— host 部分（ESM）：进程生命周期、就绪探测、/rlm/ 路由。
- dsh-rlm-tools-bsl/lib/client.js —— 客户端部分：settings.section 区段（「rlm-tools-bsl」），包含状态、重启、端口和 MCP 代码片段。
- dsh-rlm-tools-bsl/cordis.patch.yml —— 将插件挂载到配置文件组合中的行。
- dsh-rlm-tools-bsl/tests/_http.mjs —— 不依赖 DSH 的 host 部分 E2E：模拟 ctx.webServer + 真实的 rlm-tools-bsl 服务器（node tests/_http.mjs）。
- dsh-rlm-tools-bsl/README.md —— 包说明（与发布归档中的相同）。

没有外部依赖：仅使用 node: 和 DSH 运行时中的 React。

安全

- rlm-tools-bsl 服务器监听 127.0.0.1 —— 不对外暴露。
- Host 路由可在本地无会话令牌访问（与其他插件通过 ctx.webServer.register 的路由一样）—— 不要在无令牌的情况下将 DSH 暴露到网络。
- 插件不会终止他人的进程：端口被占用时仅进行诊断。