dsh-plugin-interpreters card
dsh-interpreters
DSH 插件：暴露 run_python 和 run_node 两个模型可调用工具，通过 stdin 执行代码并返回 stdout/stderr/exit code。在设置页「插件配置」分区提供配置卡片，让用户设置 Python 和 Node.js 解释器的可执行文件路径，工具描述中会告知模型解释器位置。
架构
- 工具：
run_python / run_node，通过 spawn(executable, ['-']) 执行代码，代码经 stdin 传入（无命令行长度限制）
- 设置持久化：通过
ctx.settings 命名空间 interpreters 持久化到 $DSH_HOME/settings.yaml
- 动态 description：工具的
description 在注册时根据配置计算，包含解释器路径；设置变更时通过 bridge.onChange() 自动重新注册
- 配置暴露（TypertRemoteService 模式）：DSH 的 settings RPC 域（api-proxy）只向配置客户端提供白名单命名空间（
interpreters 不在其中），所以浏览器通过 host 内置的 typertRemote /api RPC 通道读写 interpreters 命名空间——InterpretersConfigGateway 继承 TypertRemoteService 并用 @Remote('get') / @Remote('set') 标记方法，typertRemote 的 SRC discovery 自动 claim /api/interpreters/get 和 /api/interpreters/set 端点。gateway 在 host 进程内 in-process 调 ctx.settings.update(ns, patch)，绕过 wire-layer allowlist
- 客户端 bundle：配置卡片通过
settings.plugin.item slot 注册（「插件配置」分区），卡片用 connection.rpc.call('/api', 'interpreters/get'|'set', { args: {...} }) 读写，不依赖 settingsScope（因为 interpreters 不在白名单中）；connection/reset 事件触发卡片重载
开发
pnpm install # 安装依赖（link: 指向 ~/.dsh/source/current/）
pnpm run typecheck # tsc --noEmit
pnpm test # vitest run
pnpm run build # tsdown + tsc（生成 lib/index.js, lib/client.js, lib/types/*.d.ts）
目录结构
src/
├── index.ts # Host 入口：name, inject, apply（实例化 bridge + gateway + 工具注册）
├── config.ts # Config schema (schemastery), ResolvedConfig, resolveConfig
├── settings.ts # installInterpretersSettings: 注册 namespace，返回 bridge (source() + onChange())
├── gateway.ts # InterpretersConfigGateway: TypertRemoteService + @Remote('get'|'set')
├── tools.ts # registerTools: 注册 run_python + run_node
├── runner.ts # runCode: spawn + stdin + stdout/stderr 收集
└── client/
├── index.ts # Client 入口：slots.inject('settings.plugin.item') + connection/reset
├── store.ts # 卡片响应式 store（通过 connection.rpc 读写 /api/interpreters/*）
├── InterpretersCard.tsx # 配置卡片组件
└── locales.ts # i18n (zh + en)
运行
本地安装
# 从 npm 安装（推荐）：
dsh plugin --profile web add @huanlin/dsh-plugin-interpreters
# 本地开发（热更新）：
dsh plugin --profile web add "link:D:/Projects/deepseek-harness/dsh-interpreters"
配置
默认配置（cordis.patch.yml）：
pythonPath: 'python' # Python 可执行文件路径
nodePath: 'node' # Node.js 可执行文件路径
timeoutMs: 30000 # 执行超时（毫秒）
运行时通过设置页「插件配置」分区的卡片修改，持久化到 $DSH_HOME/settings.yaml。
检查
pnpm run typecheck && pnpm test && pnpm run build
验证 lib/ 产物：
lib/index.js — host bundle（ESM，external: @deepseek-ai/dsh-typert-protocol, @deepseek-ai/dsh-settings, @deepseek-ai/dsh-tools, schemastery）lib/client.js — client bundle（CJS，window.__ModuleLoader__.load 包裹，external: react）lib/types/ — TypeScript 声明文件cordis.patch.yml — bundle 配置层
