MarchLiu/dsh-cf-sas

Project Overview项目介绍

dsh-security-audit (repository dsh-cf-sas) is a security-audit plugin built natively for DeepSeek Harness. It reworks Cloudflare's security-audit-skill from a prompt-only skill plus manual sandbox usage into an autonomous orchestration engine whose top-level UX promise is "one prompt to start, a panel to watch progress, a report when finished." The repository ships package.json with a dsh.bundle declaration and a cordis.patch.yml service-injection layer; the compiled lib/ entry point is loaded by DSH as a plugin rather than being a stand-alone CLI, desktop client, or generic MCP server, and the upstream skill is vendored read-only under vendor/skills/security-audit/.

A typical run begins when the DSH agent receives one user prompt; the engine then auto-selects an execution location (local Docker on macOS or Windows, gVisor or runc on Linux, and from v1.5 onward a user-supplied remote SSH host transported by git bundle) and walks the probe → authorize → remediate pipeline. A three-view panel exposes live progress while the v1 hybrid scheduler (planned v2) promises unit-level capability matching and parallel remote container pools, and the tool is aimed at advanced DSH operators who want production-environment compliance scanning driven by their agent.

Runtime dependencies are listed implicitly in assets/sandbox/ (Hypatia run-1 verified strict images), assets/install-scripts/ (declarative probe installers that remain auditable), and the bundled vendor directory; budget is modeled as a hard gate whose violation is treated as an engine bug. The 10-step race-safe promotion from the original SKILL.md is encoded entirely in code, raw copies are forbidden, and a missing sandbox is a normal branch that downgrades affected checks to needs_validation rather than aborting. The project publishes to npm as dsh-security-audit; the license field in the repository is not declared, so users must verify licensing and external-image compliance before first run.

dsh-security-audit(仓库 dsh-cf-sas)是为 DeepSeek Harness(DSH)原生构建的安全审计插件,将 Cloudflare 的 security-audit-skill 从"提示词技能 + 手工沙箱"改造为自治编排器。package.json 中通过 dsh.bundle 声明插件边界,cordis.patch.yml 负责把引擎、面板渲染、工具等 Service 注入 DSH 运行时,因此安装即作为 DSH 插件加载,而非独立客户端或通用 MCP 服务,UX 目标是"一句话发起 → 面板看进度 → 结束收报告"。

典型工作流是用户对 DSH agent 给出一次指令,引擎自动判定本地 Docker(mac/win)或 Linux gVisor/runc 执行位置,完成 probe→授权→修复流程,期间通过三视图面板展示进度,并以报告三形态交付产物,v1.5 起还支持远程 SSH 执行位置与全局出域开关。它面向把生产环境合规扫描交给 agent 自治的中高级 DSH 用户,依赖上游 skill 原样 vendored、assets/sandbox/ 中已用 Hypatia run-1 验证的严格镜像配置以及 declarative probe 安装脚本,预算被建模为硬闸门,任何超出预算的动作都会失败。

插件通过 npm 发布为 dsh-security-audit,并将上游 SKILL.md 的 10 步 race-safe 晋升 100% 代码化,禁止裸拷贝,所有产物通过白名单晋升。沙箱缺席是设计的正常路径而非错误路径:控制不齐时相关检查会降级为 needs_validation,再交由 ledger/validator 二次确认,许可证信息仓库未标注,使用前需自评授权与依赖镜像合规。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 2 warnings2 项注意
  • No license declared - all rights reserved by default; ask the author before commercial use or redistribution未声明开源许可证 —— 默认「保留所有权利」,商用或再分发前先问作者
  • Only 4 stars - very few users, little community feedback星标只有 4,几乎没人在用,遇到问题缺少社区反馈
DSH walks through these 9 checksDSH 会逐条核对这 9 项

Compatibility兼容性

  • DSH, Node, OS and profile requirementsDSH 版本 / Node 版本 / 操作系统 / profile 是否满足要求
  • External dependencies and runtimes (Electron / Python / Docker, ...)外部依赖与运行时(Electron / Python / Docker 等)是否齐备
  • Conflicts with installed plugins: command names, skill / tool names, ports, duplicate MCP registration与已装插件是否冲突:命令名、skill / tool 重名、端口占用、重复 MCP 注册

Security安全性

  • Repo matches the facts registered here; archived or abandoned?仓库是否与页面登记一致,是否归档或长期停更
  • Safety of preinstall / install / postinstall and install.sh / setup.ps1preinstall / install / postinstall 与 install.sh、setup.ps1 是否安全
  • curl|bash, download-then-execute, obfuscation, unrelated domains → stop immediatelycurl|bash、下载即执行、混淆代码、无关域名 → 立刻停止
  • Typosquatting or unmaintained packages among the new dependencies新增依赖里有没有 typosquatting 或无人维护的包
  • Requested permissions vs. what the feature actually needs申请了哪些权限、是否超出功能所需(filesystem / network / shell / clipboard)
  • Any sudo / admin requirement, plus uninstall and rollback是否要求 sudo / 管理员权限,以及卸载与回滚方式

Anything uncertain must be marked unknown with a note on how to confirm it. This site's signal screen is a static snapshot, not a security audit.拿不准的必须标「未知」并说明要我怎么确认。本站的信号筛查是静态快照,不能替代安全审计。

Or use CLI install (for developers)或使用命令行安装(适合开发者)

CLI Install命令行安装

dsh plugin --profile web add github:MarchLiu/dsh-cf-sas

把 MarchLiu/dsh-cf-sas 加入你的 DSH 配置(web profile)即可启用。

READMEREADME

dsh-security-audit

Publish to npm npm version

将 cloudflare/security-audit-skill 从 "prompt 技能 + 手工沙箱"升级为自治编排的 DSH plugin。

UX 目标:一句话发起 → 面板看进度 → 结束收报告。

设计文档见 docs/dsh-plugin-design.md(已对齐的全部决策记录), DSH 插件 API 调研笔记见 docs/dsh-plugin-api-notes.md。

目录

dsh-cf-sas/
├── package.json            # dsh.bundle 声明
├── cordis.patch.yml        # 插件服务插入层
├── src/                    # 引擎、SandboxDriver、tools、面板渲染(源码)
├── lib/                    # 编译产物(插件实际加载的入口)
├── vendor/skills/security-audit/   # 上游 skill 原样 vendored(只读规程源 + validator)
├── assets/sandbox/         # 沙箱镜像与执行脚本(hypatia run-1 已验证的严格配置)
├── assets/install-scripts/ # probe 缺口的声明式安装脚本(可审计)
└── docs/

版本切分

版本 范围
v1 本地 Docker (mac/win) + Linux gVisor/runc 自动选择;单执行位置;probe→授权→修复;ledger/validator/晋升全代码化;面板三视图 + 报告三形态;subagent 编排引擎
v1.5 远程 SSH 执行位置(用户自备主机);git bundle 传输;全局出域开关生效
v2 混合调度(unit 级能力匹配派发);远端容器池并行;增量审计向导

原则

  • 上游 skill 原样 vendored、只读引用;产物契约与上游完全兼容。
  • 沙箱缺席是正常路径不是错误路径:控制不齐 → 相关检查降级 needs_validation。
  • 白名单产物晋升,永不裸拷贝(SKILL.md 的 10 步 race-safe 晋升 100% 代码化)。
  • 预算是硬闸门;SKILL.md 纪律翻译为引擎不变量,违反即 bug。
← 上一个 Prev dsh-minecraft-dev 下一个 Next dsh-omni-bridge →