jean3690/dsh-devtoolbox

DSH 本地工具箱插件：侧边栏独立页面 + /toolbox 命令 + 配置驱动的 agent 确定性工具。 约 35 个纯本地小工具（文本 / 编码 / 数据 / 安全 / 提取 / 转换 / 参考 / 效率）， 参考 devtoolbox.online 设计，数据不出本机。

你能得到什么

界面	能力
侧边栏「工具箱」入口	点击进入中心列全屏工具箱：分类导航 + 搜索 + 工具卡片网格
工具页	动态参数表单 → 本地运行 → 结果（文本 / JSON / 表格），一键复制、下载、保存到项目
/toolbox 命令	/toolbox 列出全部工具；/toolbox run <id> key=value … 直接执行（模型可读、可日志重建）
agent 工具	配置驱动：agentTools 决定哪些 toolbox_* 工具对模型可见（默认一个都不暴露）；userTools 让你用 JS 表达式自定义自己的工具
文件工具	toolbox_file_hash / toolbox_file_encode（GBK⇄UTF-8）——需要时在配置中启用

工具清单（35 个，全部本地运行）

分类	工具 id
文本	text_stats text_remove_blank text_dedup case_change case_convert fullwidth cn_convert regex text_ops
编码	base64 url html_entity unicode_escape radix timestamp
数据	json_format json_csv csv_fix text_diff
安全	md5 sha uuid password random_num
提取	phone email url_extract ip_extract
转换	money color
参考	http_codes ports mime ascii
效率	picker

宿主文件工具：file_hash file_encode（agent 可暴露，见配置）。

快速上手

dsh plugin --profile web add link:/path/to/dsh-devtoolbox

重启 web 面板（bundle 列表在启动时快照），侧边栏出现「工具箱」入口：

/toolbox
/toolbox run md5 text=hello
/toolbox agent

配置（cordis.patch.yml）

- insert:
    - id: dsh-devtoolbox
      name: dsh-devtoolbox
      config:
        # 暴露给模型的内置工具；'*' = 全部，[] = 不暴露（默认）
        agentTools: ['json_format', 'base64', 'md5']
        # 用户自定义工具（JS 表达式；agentTools 含其 name 或 '*' 时注册为 toolbox_<name>）
        # userTools:
        #   - name: shout
        #     description: 把文本转成大写并加感叹号
        #     args:
        #       text: { type: 'string', required: true, description: '输入文本' }
        #     run: !!js |
        #       ((args) => ({ text: String(args.text).toUpperCase() + '!' }))
        # 浏览器「保存到项目」RPC（写入 <profile>/toolbox-saves，可改 saveDir）
        saveEnabled: true
        # saveDir: toolbox-saves

可暴露的内置工具（/toolbox agent 可查看）：text_stats cn_convert case_convert fullwidth base64 url html_entity unicode_escape radix timestamp json_format json_csv csv_fix text_diff md5 sha uuid password random_num phone email url_extract ip_extract money color http_codes ports mime ascii text_ops text_remove_blank text_dedup case_change regex + 宿主文件工具 file_hash file_encode。

架构

src/
├── index.ts            # 宿主插件入口（Cordis function plugin）
├── config.ts           # 配置 schema + 显式 resolve（agentTools / userTools / save）
├── command.ts          # /toolbox 命令（只读：enable/disable 仅给建议，绝不改配置）
├── agentTools.ts       # 配置驱动的 agent 工具注册（默认 0 个）
├── hostTools.ts        # 文件哈希 / 文件编码（宿主专属）
├── service.ts          # toolbox Remote 服务（保存输出到 profile）
├── wire.ts             # Typert wire 协议（toolbox/save，zod 严格编解码）
├── typert.host.ts      # Typert host manifest
├── present.ts          # 结果渲染（无依赖，三端复用）
├── i18n.ts             # zh/en 字典（UI + 命令 + agent 描述共用）
├── tools/              # ★ 35 个纯函数工具（零 DOM/fs/网络，三端复用）
└── client/             # 浏览器半：侧边栏入口 + 中心列视图

核心设计：工具是纯函数，一份代码三处复用——浏览器 UI 直接同步调用（零延迟）、 /toolbox run 输出（模型可读）、agent 工具（模型可调）。浏览器与宿主之间 只有一个 RPC（toolbox/save），其余全部本地计算。

面板互斥：与任务看板 / SSH 面板共用 dsh-panel-activate 事件协议，中心列 同一时刻只有一个面板占用。

样式规范对齐（官方 web-styling.md，deepseek-ai/deepseek-harness）： CSS Modules + 哈希类名（toolbox.module.css，lightningcss 编译，运行时注入 <style data-plugin>，与官方 client 包同机制）；颜色只用 ui-theme 的 --dsw-alias-* 语义 token（无静态色板值、无颜色字面量、无主题选择器）； 字体大小与行高配对；交互控件带 :focus-visible 焦点轮廓。

开发

npm install          # 安装依赖
npm test             # vitest：37 个测试（工具测试含 MD5/SHA 测试向量 + 宿主文件工具/路径消毒）
npm run build        # tsc + tsdown → lib/（node 半 ESM + client 半 ModuleLoader 单文件）
bash scripts/smoke-e2e.mjs.sh   # Playwright 端到端回归（需 GUI 运行中 + playwright-cli）

client bundle 遵循 shell 的 window.__ModuleLoader__.load({ id, factory }) 握手： 平台模块（react 等）external、其余全部内联，因此 /plugins/<id>/client.js 是单文件。

发布

GitHub Actions 已配置（typecheck + test + build）。发布 npm（推荐，安装免构建授权）：

npm publish    # prepublishOnly 自动先跑 build

npm 包名 dsh-toolbox / dsh-tools 已被占用，本项目使用 dsh-devtoolbox。

诚实契约

• 纯本地。工具计算发生在浏览器或宿主进程，无任何数据上传。
• 默认不暴露 agent 工具。模型能调用的 toolbox_* 工具完全由 agentTools 配置决定； 命令的 enable/disable 只打印 patch 建议，绝不写配置。
• 路径安全。保存文件名/子目录经过消毒（防路径穿越），写入目录固定为 saveDir。
• 用户自定义工具自负其责。userTools 是本地 JS 表达式（patch 层本就信任 !!js）。

兼容性

• 运行时：DeepSeek Harness 0.1.0-rc.6（peerDependencies 固定包线）
• 依赖：zod（内联进宿主）、opencc-js（繁简词典，内联进客户端 bundle）

License

Apache-2.0