HuanLinOTO/dsh-plugin-interpreters

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)