omdsh-dev/dsh-custom-tool 预览 preview

omdsh-dev/dsh-custom-tool

Plugin插件 Native原生 ⭐ 23 MIT Approval & Security审批与安全

为DeepSeek Harness创建并管理沙盒化的JavaScript工具,配备Monaco编辑器及以模型驱动的工具生命周期管理。

Project Overview项目介绍

This is a native plugin built exclusively for DeepSeek Harness (DSH) that enables both users and the DSH agent to author, manage, and register custom JavaScript tools directly within DSH's settings interface. It ships with an embedded Monaco editor (the same editor that powers VS Code) that provides full TypeScript intellisense for tool code, so users get live completions and error diagnostics as they write. The plugin exposes three core functions to the DSH agent: create a new custom tool, remove an existing one, and list all currently registered custom tools.

All custom tool code runs in a restricted, fresh worker thread inside a sandboxed Node VM realm, with an explicit allowlist for allowed capabilities and hard resource budgets for time, memory, and output size. Tools cannot access inherited environment variables, spawn child processes, or access the filesystem outside their configured permission boundaries. This intentional design prevents unauthorized access to system resources and keeps DSH secure even when running user or model-authored custom code.

You can install the plugin directly from the GitHub release tarball using the DSH CLI plugin command, and no build step is required because all bundled assets are committed to the repository. After installation, you just need to restart the DSH web server to load the plugin properly. All configurable settings like timeout, memory limit, maximum number of stored tools, and network access allowance can be adjusted via the cordis.yml config file.

这是一个专为DeepSeek Harness(DSH)开发的原生插件,支持用户和DSH模型直接通过插件内置的设置界面创建、编辑和管理自定义JavaScript工具。插件自带基于Monaco(VS Code引擎)的编辑器,提供TypeScript智能提示,支持工具热注册,创建的工具可以跨会话持久保存。插件还向模型开放了三个核心能力:创建工具、删除工具和列出已有的自定义工具。

它解决了原本DSH无法灵活扩展能力的问题,现在用户不需要重新打包安装DSH就能随时添加自定义能力,模型也可以在会话中途自行创建持久化工具。所有自定义工具代码都在受限的独立Worker线程中执行,拥有明确的权限边界和资源预算,避免了未授权访问和资源滥用问题。

工具支持全局和工作区两种执行范围,以及全局存储和工作区存储两种位置,可灵活满足不同场景需求。安装可通过DSH的插件命令直接从GitHub包安装,不需要额外编译步骤。所有配置项都可以在cordis.yml中调整,包括超时时间、内存限制、最大工具数量等。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 1 note1 项提示
  • 23 stars - an early-stage project星标 23,属于早期项目
DSH walks through these 9 checksDSH 会逐条核对这 9 项

Compatibility兼容性

  • DSH, Node, OS and profile requirementsDSH 版本 / Node 版本 / 操作系统 / profile 是否满足要求
  • External dependencies and runtimes (Electron / Python / Docker, ...)外部依赖与运行时(Electron / Python / Docker 等)是否齐备
  • Conflicts with installed plugins: command names, skill / tool names, ports, duplicate MCP registration与已装插件是否冲突:命令名、skill / tool 重名、端口占用、重复 MCP 注册

Security安全性

  • Repo matches the facts registered here; archived or abandoned?仓库是否与页面登记一致,是否归档或长期停更
  • Safety of preinstall / install / postinstall and install.sh / setup.ps1preinstall / install / postinstall 与 install.sh、setup.ps1 是否安全
  • curl|bash, download-then-execute, obfuscation, unrelated domains → stop immediatelycurl|bash、下载即执行、混淆代码、无关域名 → 立刻停止
  • Typosquatting or unmaintained packages among the new dependencies新增依赖里有没有 typosquatting 或无人维护的包
  • Requested permissions vs. what the feature actually needs申请了哪些权限、是否超出功能所需(filesystem / network / shell / clipboard)
  • Any sudo / admin requirement, plus uninstall and rollback是否要求 sudo / 管理员权限,以及卸载与回滚方式

Anything uncertain must be marked unknown with a note on how to confirm it. This site's signal screen is a static snapshot, not a security audit.拿不准的必须标「未知」并说明要我怎么确认。本站的信号筛查是静态快照,不能替代安全审计。

Or use CLI install (for developers)或使用命令行安装(适合开发者)

CLI Install命令行安装

dsh plugin --profile web add https://github.com/omdsh-dev/dsh-custom-tool/archive/refs/tags/v0.1.2.tar.gz

把 omdsh-dev/dsh-custom-tool 加入你的 DSH 配置(web profile)即可启用。

READMEREADME

dsh-custom-tool

Custom tools for the DeepSeek Harness: users author their own JavaScript tools in the settings UI with a Monaco (VS Code) editor and TypeScript intellisense, and the model grows and prunes the same toolset itself through custom_tool_create / custom_tool_remove / custom_tools_list. Every tool is durable, hot-registered, and written into the model prompt on the next step.

The Custom Tool settings page

The tool editor

Problems it solves

  • Users cannot extend their agent: before this plugin, adding a capability meant shipping a harness package. Now a tool is a form in the settings UI — name, description, parameters, code — saved live and callable by the model immediately.
  • The model cannot grow itself: custom_tool_create lets the model persist tools mid-session (hot-registered, visible on its next step), with the same validation gate the UI uses — the model cannot persist anything the settings UI would refuse.
  • User-authored code runs in a restricted worker: every call executes in a fresh worker thread inside a node:vm realm with an explicit allowlist, Node Permission Model, and hard budgets. The worker receives no inherited environment variables, filesystem access outside its configured scope, or child-process capability.

Features

  • Settings UI (Custom Tool section, own nav glyph): list, create, edit, enable/disable, delete. Model-created and workspace-scoped tools are badged. Every string follows the harness locale (Chinese / English) and switches with the language preference.
  • Monaco editor: VS Code engine + TypeScript language service; args typed from the parameter schema, env/sandbox globals declared, completions and diagnostics live. Editor and TS workers are bundled inline — the client bundle is a single file.
  • Durable store: tools live in the custom-tools settings namespace (schema defaults, composition base, user document — the ordinary settings layering). Edits apply live; restart restores them.
  • Live registration: enabled tools register into ctx.tools the moment the settings write commits; disabled/removed tools unregister immediately. The harness assembles tool schemas into the system prompt automatically.
  • Model self-service: custom_tool_create (upsert by name), custom_tools_list, and custom_tool_remove share the UI's validation gate and the ownership rules below.

Showing the opening section of the README — the full document lives in the repository以上为 README 开头摘要,完整文档在仓库内 · View the full README on GitHub →在 GitHub 查看完整 README →

← 上一个 Prev oh-my-knowledge 下一个 Next dsh-whale-girl-live2d →