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 传入（无命令行长度限制）
- 设置持久化：配置来自插件 bundle 的
cordis.patch.yml 行配置（行 id dsh-interpreters），运行时改动写入 profile 的 cordis.patch.yml；三个字段都标了 .volatile()，Loader 直接提交新引用值，不重新挂载插件
- 动态 description：工具只注册一次，执行时读取当前 volatile 引用，路径改动对下一次运行立即生效
- 配置暴露：DSH 的 settings RPC 域只向配置客户端提供白名单命名空间，插件因此在 host 上自行注册
/interpreters/api 前缀路由，在进程内调 ctx.settings.update(ns, patch)。ns 必须是该插件在 profile 里的行 id dsh-interpreters（不是包名，也不是短名），否则每次保存都会失败并返回 No configurable plugin entry
- 客户端 bundle：配置卡片注册进插件页的
plugins.row.config 槽（key @huanlin/dsh-plugin-interpreters#dsh-interpreters），用 fetch('/interpreters/api/get'|'set') 读写；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: 声明 auto:false 页面策略，返回 bridge (source())
├── gateway.ts # registerHttpGateway: /interpreters/api 前缀路由（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（fetch /interpreters/api/get|set）
├── 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-interpreters 行的配置卡片修改，持久化到 profile cordis.patch.yml 中该行的 config。
检查
pnpm run typecheck && pnpm test && pnpm run build
验证 lib/ 产物：
lib/index.js — host 入口（ESM，tsc 产物；@deepseek-ai/* 与 @deepseek-ai/schemastery 保持外部引用）lib/client.js — client bundle（CJS，window.__ModuleLoader__.load 包裹，external: react）lib/types/ — TypeScript 声明文件cordis.patch.yml — bundle 配置层
