开工前检查当前会话能否真正执行一项任务:本轮工具准入、模型路由、工作区写入边界、文档引擎与 MCP 可见性,逐项给出状态与依据;可选最小探测,并在经批准的处理后复检。
安装
# npm 包(预构建)
dsh plugin --profile web add dsh-task-readiness
# Release 预构建包
dsh plugin --profile web add "https://github.com/kelvin0304ykx-coder/dsh-task-readiness/releases/download/v0.1.1/dsh-task-readiness-0.1.1.tgz"
# GitHub 源码(首次需按提示配置 allowBuilds 构建授权后重试)
dsh plugin --profile web add github:kelvin0304ykx-coder/dsh-task-readiness
装任何插件都等于在你的机器上跑第三方代码,权限和你本人一样大——能读你的文件、用你的凭据、访问网络,工具审批管不到它。GitHub 来源的插件还会在安装时执行构建脚本——pnpm 默认拦截,所以安装可能停在 ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED 或 ERR_PNPM_IGNORED_BUILDS;dsh 会打印出需要添加的确切键名,把它加进该 profile 的 pnpm-workspace.yaml 的 allowBuilds 下,重跑一次即可装上。放行构建本身就是一次信任判断:请只安装可信来源,并尽量锁定 commit(github:owner/repo#sha)。
README
开工前先确认“这个会话现在到底能不能做这件事”。面向普通用户,不替代宿主权限,也不把诊断通过当成任务质量或安全保证。
当前版本: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、绝对路径、原始任务文本与错误正文。
- 探测使用随包合成材料,不发送用户文档。
## 许可与发布
未发布。许可证与发布账号在发布前单独确定;在此之前请把本包视为本地预览件。
链接
同类插件
yjh051108/dsh-routing-suite★ 7029
一个仓库三件套:DSH 插件包的运行时注入器(注入、热重载、卸载、开发侧挂区一键转正、路由自愈,外带设置页插件管理:列出、卸载、拖入文件夹内化)、任务感知的思维模式路由 agent 预设(router-standard / router-spec / router-react)、以及分级两级任务协议(commit_star / lock_stage / revise_do / edit_plan / mark_task / redteam_verdict 六个工具,任务状态落盘)。注入器实现直接在库内,安装的是它自己的行为而不是一份依赖清单。
strukto-ai/mirage#dsh★ 3788
把文件系统与 bash 提供者换成 mirage 虚拟工作区:文件工具与 shell 命令作用于挂载的资源(RAM、S3、Redis、Slack、Gmail、Notion、Postgres)而非宿主磁盘,支持按挂载点设置读/写/执行模式、按命令选择沙箱(进程内 monty、pyodide、quickjs;远程 docker、e2b、daytona),并可在虚拟终端中安装 CLI(git、gh、slack、linear、ntn、gws,或自行注册的程序树)作为命令头词。
first-fluke/oh-my-agent#dsh★ 1467
在工具执行前后以及尝试结束当前轮次时运行项目 OMA 检查。随插件安装 OMA CLI 依赖,并在首次使用时初始化未配置的项目。需要 Node.js 22+;首次初始化需要网络连接和项目目录写入权限。
MichengAI/dsh-skills-manager★ 577
在设置里管理本地 DSH 技能,并只读查看公共 Agent 技能。
hust-open-atom-club/oh-dsh★ 324
社区发行版:TUI、桌面端与 Web UI 统一体验,分层安装、一步到位。
Fishquito7/dsh-skill-mcp-panel★ 278
在 DSH Web 设置中管理技能与 MCP 服务器:技能卡片热启停、工作区作用域、分组、批量迁移与拖拽导入,以及 stdio/HTTP MCP 增删改查、连接测试、密钥脱敏,并附带统一 dsh-panel 命令行。
社区评论
评论公开保存在 GitHub Discussions。加载评论会连接 GitHub 和 Giscus;发表内容需要 GitHub 账号。