0lidaxiang/dsh-plugin-greet
51最近提交 2026年8月16日
dsh-plugin-greet DSH 插件
该插件注册了一个 `greet` 工具，模型可调用它生成个性化问候。它展示了插件配置、参数验证、结构化输出和文本渲染器。专为希望学习编写插件的新手作者设计。
如何安装 dsh-plugin-greet DSH 插件
dsh plugin --profile web add dsh-plugin-greet@0.2.0复制不会执行命令。安装 dsh-plugin-greet DSH 插件前请核对仓库和版本。
dsh-plugin-greet DSH 插件数据来源
dsh-plugin-greet DSH 插件快照日期：2026年8月16日
discovered
dsh-plugin-greet DSH 插件能做什么
- 注册一个模型可调用的 `greet` 工具，支持必选和可选参数。
- 支持英文和中文问候，以及友好和正式两种风格。
- 验证输入参数（名称长度、支持的语言和风格），并返回清晰的错误信息。
- 生成结构化规范输出，并附带文本渲染器（`output.render`）。
- 可通过插件配置自定义问候语、标点、默认语言和默认风格。
dsh-plugin-greet DSH 插件适合哪些场景
- 从头学习如何构建 DSH 插件，包括配置、工具注册和测试。
- 在开发复杂插件前，在最小环境中测试工具模式和验证逻辑。
- 演示结构化输出分离，用于多插件工作流或策略集成。
- 在 DeepSeek Harness 中实验插件配置和配置文件组合。
dsh-plugin-greet DSH 插件适合谁
- 刚接触 DeepSeek Harness 的插件开发者，需要完整的最小示例。
- 希望了解 DSH 中工具注册、参数模式和结构化输出的开发者。
dsh-plugin-greet DSH 插件的限制
- 该插件没有网络、文件系统、shell 或凭据访问权限，仅依赖官方 `@deepseek-ai/schemastery` 包。
- 中文和正式用语使用内置示例，只有友好英文问候和标点可通过插件配置自定义。
- 必须明确指示模型使用 `greet` 工具，它不会对如 'Hello' 等关键词自动触发。
- DeepSeek Harness 目前处于开发者预览版，未来版本可能需要兼容性更新。
dsh-plugin-greet DSH 插件的仓库 README 摘录
以下文字摘自 dsh-plugin-greet DSH 插件的上游仓库 0lidaxiang/dsh-plugin-greet 的 README，版权归原作者，仅作引用。
English | [简体中文](docs/README.zh-CN.md) A beginner-friendly, installable DeepSeek Harness plugin that demonstrates bundle distribution, profile composition, plugin configuration, tool schemas, structured output, validation, testing, and a real model-driven tool call. > This is a community example, not an official DeepSeek AI plugin. DeepSeek Harness is currently in Developer Preview, so future releases may require compatibility updates.  ## What you will learn This repository keeps the implementation in one small entry file so that a new plugin author can follow the complete path: ```text User prompt → model chooses the greet tool → argument schema checks the shape → execute validates and normalizes values → the tool returns structured data → output.render creates model-facing text → the model writes its final response ``` The example covers: - exporting a validated plugin `Config` - injecting and using the Harness `tools` service - required and optional tool arguments - English and Chinese greetings - friendly and formal styles - structured canonical output with a text renderer - actionable validation errors -
阅读完整 README仓库许可: MIT
dsh-plugin-greet DSH 插件常见问题
如何将 dsh-plugin-greet 安装到 DeepSeek Harness 中？
先停止正在运行的 DeepSeek Harness 实例，然后运行 `npx @deepseek-ai/dsh plugin --profile web add dsh-plugin-greet@0.2.0`。该命令会将包安装到 'web' 配置文件并添加其声明的 bundle。安装后，用 `npx @deepseek-ai/dsh --profile web --dump-config` 验证，然后通过 `npx @deepseek-ai/dsh web` 启动 Web UI。
为什么我说 '你好' 时模型没有调用 greet 工具？
该插件不会监听 '你好' 等关键词，它只是将 `greet` 工具提供给模型。你必须明确指示模型使用该工具，例如：'你必须使用 greet 工具用友好的中文风格问候小明。' 否则模型可能直接回复而不调用工具。
如何更改默认的问候语或标点符号？
在后续的补丁层（如配置文件的 `cordis.patch.yml`）中覆盖插件配置。用相同的 `id`（`greet-tool`）、包名 `name` 以及完整的 `config` 对象重新声明该插件行。例如，设置 `greeting: Hi` 和 `punctuation: "!"` 可更改友好的英文输出。注意中文和正式用语是内置的，不可自定义。
我通过 'npm install dsh-plugin-greet' 安装了插件，但工具不见了，哪里出错了？
普通的 `npm install` 仅将依赖添加到当前 Node.js 项目。你必须使用 `dsh plugin --profile <name> add ...` 命令将插件安装并组合到 Harness 配置文件中。请按照 README 中的官方安装说明操作。
dsh-plugin-greet 在生产环境中使用安全吗？
该插件没有网络、文件系统、shell 或凭据访问权限。它运行在宿主进程中，因此安装前应审查其源代码。README 建议优先使用固定的发布标签或提交 SHA 以确保稳定性。此外，DeepSeek Harness 处于开发者预览版，未来版本可能需要兼容性更新。