DSH Plugins Marketplace

DSH Plugins

Plugins

/

dsh-helloworld

d

dsh-helloworld

Manifest valid
hasBundlePatch

dsh-helloworld

项目结构

.
├── src/index.ts        # Host 插件源码(name + Config + apply + hello / approval_hello 工具)
├── lib/                # tsc 构建产物,随仓库提交
├── cordis.patch.yml    # bundle 层:插入 preset 和插件行
├── tsconfig.json       # TypeScript 构建配置
└── skills/roll-dice/   # 示例 skill

开发

npm install
npm run build      # src/index.ts -> lib/
npm run typecheck

package.json 的 main/types 分别指向 lib/index.js 与 lib/index.d.ts。lib/ 是生成产物,但 git/Gitee 安装不会执行构建脚本,因此修改 src/ 后必须重新构建并提交 lib/。@deepseek-ai/cordis 仅用于类型导入,声明为 peer/dev 依赖;@deepseek-ai/schemastery 用于声明插件配置 schema,声明为运行时依赖。

配置

hello-plugin 支持一个字符串配置项,插件加载(apply 执行)时打印:

字段类型必填说明
messagestring是插件加载时打印的字符串;同时作为两个工具省略 name 时的问候语

在 cordis.patch.yml 的插件行中通过 config 设置:

- insert:
    - id: hello
      name: '@potterhe/dsh-helloworld'
      config:
        message: Hello, world!

loader 的覆盖语义是整体替换 config,因此在 profile 的 cordis.patch.yml 中覆盖 hello 行时也必须提供 message。修改 bundle 内的值后需要重装并重启,覆盖 profile 配置则由 loader 重新加载。

工具(Tool)

插件加载时向模型注册两个行为相同、审批策略不同的工具:

工具参数行为人工确认
helloname(string,可选)返回 Hello, <name>!;省略或为空白时返回配置的 message否
approval_hello同上与 hello 完全相同是:每次调用先弹审批,允许后才执行

两个工具都返回一个字符串,并以文本块呈现给模型;name 为问候对象,省略或为空白时返回配置的 message(默认 Hello, world!)。注册发生在 apply 执行时;由于 hello 行挂在 profile 根组合(见下方 bundle 说明),这些工具是全局注册,profile 下所有 preset 的模型都能看到并调用。

在会话中可直接要求模型调用,例如:

用 hello 工具跟 Ada 打个招呼
用 approval_hello 工具跟 Ada 打个招呼

第一条直接得到 Hello, Ada!;第二条会先出现审批卡片,点击允许后才得到 Hello, Ada!。

approval_hello 的访问控制由 tools/pre-execute 返回 ask 实现:DSH 通过审批通道(Web 的审批卡片)询问一次,只有 allowed-once 才执行。拒绝时工具结果为 the user rejected tool "approval_hello"(APPROVAL_REJECTED);取消为 APPROVAL_CANCELLED;没有可用审批通道或审批策略为 never(如 danger-full-access 权限模式)时失败关闭(APPROVAL_UNAVAILABLE)。PTC 调用(tools.approval_hello(...))与子代理内的调用同样经过这套审批,每次调用独立确认。

工具定义只依赖 @deepseek-ai/dsh-tools 的 defineTool、ctx.tools.register 与 tools/pre-execute。@deepseek-ai/dsh-tools 由运行中的 dsh 安装提供,仓库内只把它声明为 peer/dev 依赖,用于类型检查与构建。修改 src/index.ts 后必须重新 npm run build,并重装 bundle、重启 dsh 才会生效(git/Gitee 安装不执行构建脚本)。

Preset

会话级组合能力

组合包(bundle)

Agent Note: profile 插件组合包取代固定的表层 overlay

生效配置的完整叠加顺序是:

  1. Profile 的 dsh.profile.bundles 列表所列各 bundle 的 patch(按顺序)
  2. Profile 自己的 cordis.patch.yml
  3. home 级的 $DSH_HOME/cordis.patch.yml
  4. 每个 --patch overlay(按命令行参数顺序)

Skills

- id: tool-skill
  name: '@deepseek-ai/dsh-tool-skill'

Comments

Loading…