侧边栏壁纸
博主头像
无涯茶榻

茶烟半榻窗竹雨,一卷残书梦里秋

  • 累计撰写 74 篇文章
  • 累计创建 1 个标签
  • 累计收到 0 条评论

目 录CONTENT

文章目录

DSH 插件与技能有什么不同

同一句需求,交给两个 agent,会以两种方式失败。

一个说:「我没有这个工具。」——它缺的是插件。

另一个工具齐全,却把顺序做反、把参数填错、把该核验的步骤跳过——它缺的是技能。

插件改运行时,技能改上下文。前者给 agent 装手,后者给它装一张流程图。混为一谈,通常会长出两种东西:能跑但没人会用的插件,和写得很全却永远触发不了的技能。

机器人手臂接入新模块
插件:从工具箱里取一个模块,插进运行时的插槽

一、插件:往运行时里装器官

插件是一个 npm 包。DSH 启动时按 profile 里的 dsh.profile.bundles 组装一棵 cordis 加载树,插件就是树上的节点,随运行时一起初始化。

它最核心的动作是注册工具。以本站配图用的 dsh-image-gen 为例,源码里就是一行 ctx.tools.register(defineTool({ name: "generate_image", ... }))。这行执行完,模型面前就多了一个可以调用的函数。同理,dsh-builtin-browser 带来整套 browser_*,billion-context 带来 compress 与 decompress,dsh-univer-office 带来 univer_*。

插件还能挂前端面板、开后台服务、监听事件、加配置项。代价是它每轮都在场:工具的名字、说明、参数 schema 会常驻系统提示,不管这一轮用不用得上。

装一个插件,意味着改依赖、改加载树、重载 profile。它绑定 DSH 的 API 版本,跨不过 engines.dsh 那道门。

二、技能:往上下文里塞说明书

技能只是一个目录,里面一个 SKILL.md。开头是 YAML frontmatter——name 和 description,正文是流程、规范、判据、踩过的坑。

关键在加载方式:系统提示里只放 skill 的目录(名字加一句描述),正文不进来。直到任务命中,模型调用 skill 工具,正文才被读进上下文。这叫渐进披露。

技能不执行任何代码。它教模型用已有的工具——pwsh、浏览器、HTTP 请求、生图——把事情按某个顺序做完。它也不锁平台:同一份 SKILL.md,Claude Code、Codex、Cursor、Copilot 都能读。本机 ~/.agents/skills 下两百多个目录,从文章配图到 Halo 发布,从期权链入库到 C 盘清理,每个都只是一份说明书。

翻开的手册页面化作流程卡片
技能:书里的页面展开成步骤卡片,工具仍然是原来那些工具

三、六个维度看差别

维度插件技能
本质可执行的 npm 包Markdown 指令包
进入哪里运行时,cordis 加载树上下文,目录常驻、正文按需
怎么装dsh plugin add,改 profile bundles,重载把目录拷进技能根,下一轮就出现在目录
上下文成本工具 schema 每轮常驻只有名字和描述,正文用到才读
能力边界抬高上限,能做原本做不到的事不新增能力,只改做法
可移植性绑 DSH 与版本跨 agent 通用
风险任意代码,权限大文本注入,最坏是不听话

四、本文就是一次证据链

这篇文章的配图由 generate_image 生成——那是插件注册的工具;图片上传到 Cloudflare R2 的 wychatop 桶,走的是 Halo 的 r2-wycha 存储策略;文章最后发到本站「技术杂谈」,依据的是 halo-pat-admin 技能里那张端点表和十三条坑。

三个角色分得很清楚:插件提供原子能力(生成一张图),技能提供编排与判据(先查分类 ID、正文必须是 HTML、上传不能手写 Content-Type、发完要用前台状态码自检),模型负责执行。

还有两个容易忽略的事实:管理技能的界面,本身是一个插件;而 dsh-image-gen 包里,又自带了一个 SKILL.md 教人怎么安装它。两层互相嵌套,恰好说明它们不是互斥的两个分类,而是两个正交的层。

一句话:工具由插件给,方法由技能教。插件让 agent 做得到,技能让它做得对。

五、为什么非要分两层

  1. 上下文预算。一百个技能,系统提示里只多一百行描述;一百个工具,会把上下文撑到没法用。常驻的东西必须少而硬,按需的东西才能多而软。
  2. 权限边界。插件是代码,能读文件、发请求、起进程;技能是文本,最坏的结果只是模型不听话。两者风险差一个量级,安装时的审核强度也该差一个量级。
  3. 可移植性。SKILL.md 已经是跨 agent 的事实标准,插件永远绑在某个 runtime 的 API 上。一个团队真正想沉淀的方法论,应该放在可移植的那一层。
  4. 演进速度。技能改一行 Markdown 就生效;插件要发版、过版本门控、重载、回归。越靠近「判断」的东西变化越快,就越该放在轻的那一层。

六、怎么判断该写哪个

四个问题,按顺序问:

  1. 现有工具能不能完成这件事?能,就写技能。
  2. 需要一个新的系统调用、新 API、新界面?才写插件。
  3. 步骤是否稳定、有没有明确判据和已知的坑?有,才值得写成技能。
  4. 要不要在别的 agent 里复用?要,就只能写技能。

两种常见反模式:把一条流程硬塞进插件——过度工程,升级一次就碎;把需要新能力的任务写成技能——模型只能靠猜和演,产出看着像样,实则是幻觉。

正确姿势是组合:插件给窄而稳的原子工具,技能给宽而软的编排与判据。插件越少越好,技能越具体越好。

左侧工具模块与右侧流程手册相连
两层不是二选一:工具在左,方法在右,中间那根线才是完整的 agent

七、尾声

插件决定一个 agent 能做到什么,技能决定它做得像一个生手还是一个熟手。

能力可以买,判断只能攒。分不清这两层的人,往往把时间花在造工具上,而不是把事做完。

0

评论区