dsh-plugin-scaffold

English | 中文

一个最小、可运行的 DeepSeek Harness（dsh）插件脚手架。它在共享的 ctx.tools 服务上注册一个模型可调用的工具（hello），用最小的代码面完整验证加载链路——插件解析 → Loader 挂载 → 工具注册 → 模型调用。

这是一个外部/社区插件：它不在 deepseek-harness monorepo 内，而是基于已发布的 npm 包（@deepseek-ai/dsh-tools、@deepseek-ai/dsh-llm、@deepseek-ai/cordis）构建。这正是项目鼓励的贡献方式——参见 CONTRIBUTING.md：目前项目不接受外部 PR，但欢迎带有 dsh-plugin 标签的生态插件。

工具做什么

hello 工具接收一个 name，返回结构化 JSON：

{ "greeting": "Hello, World!", "cwd": "/path/to/cwd" }

它的作用是验证链路是否打通，而不是做真实工作。把它当作开发真实能力（文件访问、网页抓取、Shell、定时任务……）的起始模板。

从这里能做什么

这个脚手架只是插件的一种形态——模型可调用的工具。DeepSeek Harness 的设计是一切皆插件，所以同样的加载路径可以解锁很多其他扩展点。挑一个方向，把 hello 工具替换成真实行为即可：

方向	做什么	例子
数据查询工具	模型调用工具，你拉取 API 并返回 JSON	天气、汇率、股票、GitHub
数据库工具	执行校验过的查询	只读 SQL、内部看板
文件/工作区工具	读写、汇总项目文件	定制 grep、批量重命名、代码统计
外部服务桥接	为模型封装 REST/GraphQL/CLI API	翻译、OCR、发邮件、触发 CI
事件监听	观察 agent/*、tools/* 事件并响应	自动会话标题、护栏、用量日志
上下文注入	每次模型请求附带持久上下文	agent.inject() 注入项目/时间/环境信息
模型 provider	在 ctx.llm 注册新适配器	本地 Ollama、OpenAI 兼容接口
人工命令	不经过模型直接执行的 /command	ctx.commands，如 /deploy
后台任务	长任务或定时任务	ctx.jobs、轮询、提醒