本文由本站基于该插件已收录的字段自动派生（wiki / faq / compatibility_json / readme），非 AI 即时创作。每节末尾标源字段。

快速上手

dsh-plugin-dev-skills / examples/greet-tool

— 源: plugin_wiki.wiki_content

安装与验证

dsh plugin --profile web add github:zimodzh/dsh-plugin-dev-skills#path:examples/greet-tool

复制以上命令在 DSH Web Profile 内运行。安装完成后在「插件列表」启用即可。

— 源: plugins.install

关键要点

• examples/hello-plugin —— 最小插件（bundle 格式）：dsh plugin --profile demo add ./examples/hello-plugin 后 dsh --profile demo 启动，应看到加载日志和每 5 秒一次的心跳，卸载时自动清理。
• examples/greet-tool —— 最小模型工具：安装后对 agent 说 "Use the greet tool to greet Ada."，应收到 "Hello, Ada!"。
• 更新任何 references 前，先核对官方文档对应页面（文档站或源码生成区块），并在 PR 中注明来源。
• 遵守 Agent Skills 约束：name 为 kebab-case 且与目录一致；description ≤ 1024 字符（DSH 目录注入提醒默认 500）；正文渐进式披露。
• 欢迎 PR：修正、更多示例、扩充评测集、其它语言版本。

— 源: plugin_wiki.readme_zh (fallback readme_raw)

常见问题

安装后在终端里能直接调用 greet 命令吗？

不能。greet 不是一个 CLI 子命令，而是一个供模型调用的工具（tool）。你需要在 dsh 对话里让 agent 去调用它，例如说 "Use the greet tool to greet Ada."。

安装这个插件需要额外安装 @deepseek-ai/dsh-tools 吗？

不需要。该包由 dsh 安装目录自带，插件里只需 import 即可使用，无需在 package.json 里声明依赖。

这个示例和 hello-plugin 示例有什么区别？

hello-plugin 是最简生命周期示例，演示插件的启动与自动清理；greet-tool 则是模型可调用的工具示例，演示 defineTool 的 parameters、execute、output 三段式写法。

可以把问候语改成可配置吗？

可以。当前实现把 "Hello, " 前缀写死在 index.js 的 execute 里。你可以修改源码把它抽到 ctx.config，或者参考上游 dsh-plugin-dev 技能的 references/config.md 文档。

插件的 inject: ['tools'] 是什么意思？

它让 Cordis 容器在执行 apply(ctx) 之前先把 tools 服务注册好，避免 ctx.tools 还未就绪时调用 register。

这个插件是 dsh-plugin-dev-skills 仓库的一部分吗？

是的。它是 dsh-plugin-dev-skills 仓库 examples/ 目录下的一个可运行示例，目的是配合 references/tools.md 标准文档演示如何写一个最小模型工具。

— 源: plugin_wiki.faq_json

兼容性

• DSH: 未声明
• Node: 未声明
• Platforms: 跨平台

— 源: plugin_wiki.compatibility_json

踩坑提醒

安装前请审阅上游仓库；本指南基于已收录字段自动派生，可能滞后于最新版本。如发现与官方文档冲突，请以上游为准。

— 来源：通用规则