- Home
- Plugins
- Dev & Plugin Tools
- dsh-task-readiness
dsh-task-readiness
kelvin0304ykx-coder/dsh-task-readiness
Checks whether the current session can actually run a task before starting it: tool admission for the current step, model route, workspace write boundary, document engine and MCP visibility, reported per capability with evidence, plus an opt-in minimal probe and a recheck after an approved fix.
Install
dsh plugin --profile web add github:kelvin0304ykx-coder/dsh-task-readinessREADME
DSH 功能体检助手
开工前先确认“这个会话现在到底能不能做这件事”。面向普通用户,不替代宿主权限,也不把诊断通过当成任务质量或安全保证。
当前版本:0.1.1,兼容 DSH >=0.2.2-rc.2 <0.3.0(实测 rc.2 与 rc.3)。许可证 MIT。仓库:https://github.com/kelvin0304ykx-coder/dsh-task-readiness。已完成独立 profile 的安装、启动加载与卸载验证,并从公开 Release 匿名安装成功。
它做什么
- 把一句任务描述或内置模板变成结构化的能力要求(联网搜索、网页抓取、读写文件、读图、Office 生成/预览/转换/重算、浏览器读取、MCP)。
- 只读采集本轮证据:工具准入、捕获的模型路由、工作目录、沙箱写入边界、审批策略、文档引擎服务、MCP 可见性、显式输入文件。
- 给出逐项状态:具备条件但未测试、指定测试通过、已知阻塞、待确认、证据过期;未知不会被写成通过。
- 可选最小探测:文件读取、文件写入(创建并删除唯一合成文件)、固定示例页抓取、一次有上限的检索、合成文档的转换/渲染/工作簿重算。
- 受控处理:本插件自有任务选项的输出目录、替代路线与恢复;执行前必须由宿主审批返回 allowed-once。
- 复检:任何动作之后重新采集证据并生成新报告,旧报告保留为历史。
三个工具
| 工具 | 作用 | 边界 |
|---|---|---|
readiness_check | 校验任务意图并生成报告 | 只读,不联网测试、不执行任务、不改配置 |
readiness_probe | 生成或执行最小探测 | 只接受内置探测;执行需要宿主审批;超时或取消保留未知 |
readiness_remedy | 生成或执行受控处理 | 只改本插件自有选项;不改宿主模型、权限或其它插件配置 |
命令:/readiness、/readiness-list、/readiness-refresh。命令入口没有本轮工具准入与审批,因此只读,不发起探测。
探测支持矩阵
| 能力 | 自动探测 | 说明 |
|---|---|---|
| 读取文件 | 是 | 对显式声明输入读取受限字节窗口 |
| 写入目标目录 | 是 | 在所选目录创建并立即删除唯一合成文件,经过宿主权限边界 |
| 网页抓取 | 是 | 固定示例页,校验状态码与正文标记,验证码页判为失败 |
| 联网搜索 | 是 | 一次有上限、非敏感的查询,费用未知时显示费用未知 |
| 文档转换 / 页面渲染 / 表格重算 | 是 | 使用随包合成文档经宿主文档引擎执行 |
| 文档生成 | 否 | 需要宿主 shell 与技能,本插件不代跑脚本 |
| 图片理解 | 否 | 需要新一轮模型请求与附件,本插件不代发模型请求 |
| 浏览器读取 | 否 | 需要调用当前会话的浏览器工具,本插件不直接执行工具 |
| MCP 连接 | 否 | 探测会连接并可能启动进程,本插件不代发 |
没有自动探测的能力会显示“未知”与人工验证办法,不会伪装成不支持或已通过。
安装
从 npm(推荐,输入包名即可):
dsh plugin --profile <你的 profile> add dsh-task-readiness
dsh --profile <你的 profile> --dump-config # 应出现 id: task-readiness
dsh --profile <你的 profile> # 启动后插件页显示“1 运行中”
dsh plugin --profile <你的 profile> remove dsh-task-readiness
或直接装 GitHub Release 包(无需 npm 账号):
dsh plugin --profile <你的 profile> add https://github.com/kelvin0304ykx-coder/dsh-task-readiness/releases/download/v0.1.0/dsh-task-readiness-0.1.0.tgz
dsh --profile <你的 profile> --dump-config # 应出现 id: task-readiness
dsh --profile <你的 profile> # 启动后插件页显示“1 运行中”
dsh plugin --profile <你的 profile> remove dsh-task-readiness
Release 资产见 v0.1.0。
本包是一个 Cordis bundle:package.json 的 dsh.bundle.patch 指向 cordis.patch.yml,补丁插入一个名为 dsh-task-readiness 的插件条目。```sh
发布后(或本地 tarball)
dsh plugin --profile <你的 profile> add dsh-task-readiness # 或 add ./dsh-task-readiness-0.1.0.tgz dsh --profile <你的 profile> --dump-config # 应出现 id: task-readiness dsh --profile <你的 profile> # 启动后插件页显示“1 运行中” dsh plugin --profile <你的 profile> remove dsh-task-readiness # 卸载
已在独立 `DSH_HOME` 上用同一组命令实测:安装后自动加入 profile 的 bundle 列表;`--dump-config` 出现插入条目;启动后插件页显示 `dsh-task-readiness 0.1.0`、开关已启用、包含的组件“共 1 个 · 1 运行中”;`remove` 后条目消失。运行时不 import 任何宿主包,也不额外安装依赖。
## 验证状态
| 层 | 状态 |
|---|---|
| 规则与状态机单元测试 | 通过(153 项) |
| 探测执行器与宿主适配的合成测试 | 通过 |
| 插件入口的 Host 形状测试(工具注册、审批、命令、事件) | 通过 |
| 打包内容检查 | 通过 |
| 打包产物在隔离目录中的导入与运行 | 通过 |
| npm 发布(0.1.1,staged 审核后自动上线) | 通过 |
| 从 npm 按包名安装 → 加载冒烟 | 通过 |
| 隔离 profile 安装、按包名加载、宿主组合校验、卸载 | 通过 |
| 真实宿主加载(独立 DSH_HOME,插件页显示“1 运行中”) | 通过 |
| 公开 Release 匿名安装(无 GitHub 登录) | 通过 |
| 真实宿主中的模型回合与工具调用 | 未验证(隔离宿主无模型凭据) |
| 真实 Cordis 上下文挂载 / 卸载 | 通过 |
| 宿主 SDK 层探针(注册表 + JSON Schema 校验器) | 通过(9 项) |
| 会话内报告卡片(宿主呈现层) | 已实现,未经 GUI 实测 |
| 自定义客户端面板 | 未实现 |
| Windows / Linux | 未验证 |
| 真实文档引擎(LibreOffice)探测 | 通过:转换、渲染、重算均实测 |
| 其他真实后端探测(搜索、抓取、MCP、浏览器) | 未执行 |
## 隐私与数据
- 诊断缓存只在内存中保留本会话的最小证据;不写整份环境变量、配置或会话内容。
- 动作日志只记录计划 id、会话 id、动作种类、绑定指纹、时间与结果,用于幂等与中断恢复,不记录任务正文、密钥或文件内容。
- 共享导出走白名单投影:不含会话 id、绝对路径、原始任务文本与错误正文。
- 探测使用随包合成材料,不发送用户文档。
## 许可与发布
未发布。许可证与发布账号在发布前单独确定;在此之前请把本包视为本地预览件。
Related plugins
deepseek-harness
deepseek-ai/deepseek-harness
dsh-market
dsh-market/dsh-market
dsh-web (dsh-plugin-manager)
zhu1090093659/dsh-web
dsh-web
zhu1090093659/dsh-web