前言¶
在 DeepSeek Harness（DSH）的「一切皆插件」理念下，一个 profile 里可能加载了数十个插件。智能体在开工前很难快速判断：哪些插件已经启用、哪些安装了但未启用、哪些可以从市场索引安装。如果盲目执行任务，可能重复造轮子，也可能错过已有的能力。
dsh-task-plugin-scout 正是为了解决这个「开工前的侦察」问题而设计。它只回答一个问题：动手之前，这个 profile 里已经有哪些插件能让当前任务更省力？
插件定位¶
- 名称：dsh-task-plugin-scout
- 维护者：crane-you
- 分类：工作流
- 包名：dsh-task-plugin-scout
- 类型：Host-only bundle（零依赖、零构建，纯 ESM JavaScript）
核心功能¶
插件由两部分组成：
-
模型工具
plugin_scout
输入任务描述，扫描本机已启用/已安装但未启用、以及已配置的插件市场索引中的插件，按任务匹配度排序，并给出每个候选的下一步操作：启用、安装，或无需操作。 -
系统提示段落
plugin-scout:discovery（order 700）
提醒智能体在非平凡任务开始前先做一次侦察。
插件不自行启用或安装任何东西，所有状态变更仍通过 plugin_manager 工具走用户批准流程。
安装与启用¶
需要在 profile 里已有 plugin-manager（官方 profile 默认带），且 DSH 版本 ≥ 0.2.0（本插件在 0.2.1-rc.2 上开发与测试）。使用 plugin_manager 工具：
// 从 npm 安装（推荐）
{ "action": "install_bundle", "target": "dsh-task-plugin-scout" }
// 从 Git 安装
{ "action": "install_bundle", "target": "git+https://github.com/crane-you/dsh-task-plugin-scout.git" }
// 从本地目录安装（指向包目录的绝对路径）
{ "action": "install_bundle", "target": "D:\\path\\to\\task-plugin-scout" }
安装成功的判据是返回里的 application: applied。确认能力可用，用 cordis_inspect_query 检查 Tool.listTools 是否出现 plugin_scout。
工具参数¶
| 参数 | 类型 | 默认 | 说明 |
|---|---|---|---|
task |
string，必填 | — | 用户要做什么，一到两行。保留用户原话；非中文任务再补一行英文能力关键词，因为插件元数据多为英文。 |
limit |
integer | 5 |
返回候选条数（1–12）。 |
useMarket |
boolean | true |
是否包含已配置的插件市场索引；设为 false 只查本机、不联网。 |
includeActive |
boolean | true |
是否允许列出已启用的插件；设为 false 只看需要动作的候选。 |
排序规则¶
- 能力概念表：约 35 组中英对照概念（语音、翻译、表格、图片、并行、定时、通知等）。任务命中某概念、且候选的名称/标题/描述/关键词也命中同一概念时 +6 分。这是中文任务能找到英文描述插件（反之亦然）的关键。
- 字面重合：任务分词（英文按词、中文按二字组）落在插件名称 +3、标题 +2、描述或关键词 +1。
- 同分按状态：
disabled→available→active，可执行的候选排前面。 - 匹配按词边界：英文概念词必须从词边界开始（如
transcription不会触发script）；中文概念按子串匹配。
配置（可选）¶
插件行的 config（在 profile 的 cordis.patch.yml 里覆盖）：
| 字段 | 默认 | 说明 |
|---|---|---|
promptHint |
true |
是否注册系统提示段落 |
hintText |
内置文案 | 整体替换提示段落正文 |
limit |
5 |
limit 参数的默认值 |
useMarket |
true |
useMarket 参数的默认值 |
本插件未声明 Config schema，配置对象会被原样读取，字段名写错不会被校验。
适用场景与注意¶
适合需要明确插件能力、减少重复工作的 DSH 用户与开发者。插件以当前 DSH 进程权限运行，安装前应检查源码与许可证。
已知边界：
- 行级候选（kind: plugin）描述的是 profile patch 层。Agent 预设可能已自带同一行，此时该能力其实可用；工具会在结果末尾给出提醒。
- 市场结果需要先配置索引；默认不带任何索引源，工具会报告 market: no index configured 并退回纯本地结果。
- 市场文本为第三方内容，索引本身未签名；最终安装什么由安装后的 manifest 决定。
- 隐私：不收集、不上报，任务描述不会外发；唯一可能出网的是插件市场索引文档，task 文本只在本地用于过滤文档。会进入会话记录的是匹配到的插件名称、标题、描述以及本地清单统计数字。
短结尾¶
dsh-task-plugin-scout 在开工前为智能体提供一份「插件能力侦察报告」，让插件从「被动安装」变为「按需启用」。
目录页：https://www.skillhub.cn/plugins/crane-you/dsh-task-plugin-scout
GitHub：https://github.com/crane-you/dsh-task-plugin-scout
