dsh.so
中文
English中文
@lhhzmz229/dsh-api-runner avatar

@lhhzmz229/dsh-api-runner

DSH 插件：按 YAML 配置调用后端接口、启停/接管本地 Java 服务、按字节偏移增量读日志并等待日志特征，让模型改完代码自己验证

Plugin开发网络终端 / Shell文件
验证
L5 · 运行已测
通过
风险
低风险
健康
活跃
信任
金

安装验证：运行验证通过 (L5) · 验证于 dsh 0.2.1-rc.2 · 验证日期 安装验证详情 →

安装验证徽章 dsh 0.2.1-rc.2

功能介绍AI

让模型按 YAML 配置调用后端接口、启停本地 Java 服务、按字节偏移增量读日志并等待日志特征，实现改完代码自己验证。

  • 按 YAML 配置调用接口，支持登录保存 token 与一键试调
  • 启停并接管本机运行中的 Java / Spring Boot 服务
  • 按字节偏移增量读日志，支持等待日志特征出现
developerAIterminalAIfileAI

能力标签为 AI 推断或 README 规则抽取（见角标），词表受限、未经安装验证；AI = 推断，README = 原文关键词。

安装

dsh plugin --profile web add dsh-api-runner
已验证 0.2.0

安装方式: npm · 运行验证通过 (L5)

验证与兼容性

按插件版本分组：每张卡是该插件版本实测过的 dsh 版本与安装兼容结论（L5 优先）。只列真测过的组合——未列出 = 未实测，不推定兼容。L1–L3 为插件级静态档（与 dsh 版本无关，各 dsh 行同值）：在行内「验证等级」格里与 L4/L5 并列显示、标注「静态」，证据体为插件级单份、随行内「查看检查项与证据」出现，不在各版本重复存储。

External credentials（插件级）：未检测到

原插件兼容声明来自 package.json · peerDependencies
未采集到插件清单

未采集到插件清单 —— 无法得知作者声明的版本范围。

安装兼容矩阵（速览 · 行 = 插件版本〔最近 5〕，列 = dsh 版本〔最近 5〕）
结论一览 → 证据在下方分版本卡片
插件版本 ＼ dshdsh 0.2.1-rc.2
当前
0.2.0✓
安装兼容实测（按插件版本，组内按 dsh 版本）
图例：✓ L5 运行验证通过○ 生态插件◼ 生态应用✗ 失败
0.2.0npm✓ 运行验证通过 12026-10-22

dsh-api-runner

✓dsh 0.2.1-rc.2当前2026-10-22L5 · 运行验证通过
实测环境与工件
  • • Node.js: v24.14.0
  • • DSH: 0.2.1-rc.2
  • • 被测插件工件: npm · dsh-api-runner@0.2.0
验证等级（L1–L3 为插件级静态档 · L4/L5 为该组合最新真测）
L1 静态
通过
L2 静态
通过
L3 静态
通过
L4 沙盒
通过
L5 运行
通过
在 dsh 沙盒中完成安装与运行冒烟——装得上、跑得起来
L5 · 运行验证通过 · dsh 0.2.1-rc.2 有效

ID: dsh-api-runner@0.2.0@dsh0.2.1-rc.2 · 档位: l4-sandbox

签发：2026-10-22 · 有效至：2026-10-29

查看检查项与证据
L1 · 已找到✓ 通过

↳ 沿用自更早记录 dsh-api-runner@cbef50@dsh0.2.1-rc.2（l3-fullscan）

由 L3 推定✓ 通过
默认通过——L3 安装规范已通过（全库 L3 扫描策略）
L2 · 结构化✓ 通过

↳ 沿用自更早记录 dsh-api-runner@cbef50@dsh0.2.1-rc.2（l3-fullscan）

由 L3 推定✓ 通过
默认通过——L3 安装规范已通过（全库 L3 扫描策略）
L3 · 安装规范✓ 通过

↳ 沿用自更早记录 dsh-api-runner@cbef50@dsh0.2.1-rc.2（l3-fullscan）

安装命令已解析✓ 通过
来源：插件市场校验 · 方式：安装规范解析 · 采集于 2026-10-22
DSH 版本已声明✓ 通过
来源：插件市场校验 · 方式：DSH 版本声明 · 采集于 2026-10-22
L4 · 安装已测✓ 通过
受限沙盒内执行安装✓ 通过
来源：Windows ACL 沙盒 · 方式：沙盒安装执行 · 采集于 2026-10-22
安装源 dsh-api-runner · 通道 npm 包 · 结果 ran · 退出码 0
检查耗时：6.0s
沙盒安装成功✓ 通过
来源：Windows ACL 沙盒 · 方式：沙盒安装执行 · 采集于 2026-10-22
安装源 dsh-api-runner · 通道 npm 包 · 结果 ran · 退出码 0
检查耗时：6.0s
安装产物已确认✓ 通过
来源：Windows ACL 沙盒 · 方式：沙盒安装执行 · 采集于 2026-10-22
安装源 dsh-api-runner · 通道 npm 包 · 结果 ran · 退出码 0
检查耗时：6.0s
安装版本已解析✓ 通过
来源：Windows ACL 沙盒 · 方式：沙盒安装执行 · 采集于 2026-10-22
安装源 dsh-api-runner · 通道 npm 包 · 结果 ran · 退出码 0
检查耗时：6.0s
L5 · 运行已测✓ 通过

已在加载器目录树中激活（150 个条目）

沙盒安装通过✓ 通过
来源：Windows ACL 沙盒 · 方式：沙盒安装执行 · 采集于 2026-10-22
安装源 dsh-api-runner · 安装方式 复用 L4 沙盒
检查耗时：399ms
Web 启动就绪✓ 通过
来源：DSH 运行时 · 方式：Web 启动 · 采集于 2026-10-22
就绪行 dsh web: http://127.0.0.1:49873/?token=…
HTTP 服务响应✓ 通过
来源：DSH 运行时 · 方式：HTTP 请求 · 采集于 2026-10-22
探测路径 / · HTTP 200 · 耗时 399ms
插件清单中已激活✓ 通过
来源：DSH 运行时 · 方式：插件清单查询 · 采集于 2026-10-22
清单判定 active · 清单条目 150
命中：include:api-runner · dsh-api-runner · 相位 active
相位计数：active 122 · null 28

L1–L3 为插件级静态结论（基础门槛，全 dsh 版本相同）：证据为插件级单份，不在各版本重复存储。

仅展示最近 3 个已发布版本；源码快照（commit hash）组、未标注工件组与更早版本不展示——全量档案保留在数据层（插件无任何已发布版本时，快照/未标注组才照常展示）。

作者徽章

将官方徽章嵌入你的 README，展示插件的安全与安装检测状态：

dsh.so risk
`[![dsh.so risk](https://www.dsh.so/badge/dsh-api-runner.svg)](https://www.dsh.so/artifact/dsh-api-runner/)`
dsh 0.2.1-rc.2 安装验证已通过
`[![dsh.so install · dsh 0.2.1-rc.2](https://www.dsh.so/badge/install/dsh-api-runner@0.2.1-rc.2.svg)](https://www.dsh.so/artifact/dsh-api-runner/)`

安全报告

两层自动化检查，都不是人工审核：静态扫描（逐插件规则判定）与模型驱动的动态安全审计（只覆盖静态判定 warn 及以上的插件子集，不执行插件代码）。

dsh-api-runner自动审查 · 每日更新

静态扫描 低，动态审计最高 中，按「取更严者」→ 总评级 中。

静态 低→动态 中→总评级 中
0 严重·0 高
中总评级 · 中
1静态扫描 · vet 主判vet AST 静态分析（npm 发布物或 git 源码）
版本绑定
插件版本v0.2.0dsh 清单
扫描版本0.2.0npm2026-10-22
当前版本0.2.0版本一致
vet 判定clean · npm

vet 为 AST 静态扫描（npm 发布物或 git 源码）。

静态发现（12 条）
  • 警告fsWrite · filessrc/java-runner.js:123

    fs.writeFileSync(tmp, JSON.stringify(doc, null, 2), 'utf8');

  • 警告fsWrite · filessrc/java-runner.js:317

    fs.appendFileSync(logPath, `\n==== ${new Date().toISOString()} ${reason} ====\n`, 'utf8');

  • 警告shellExec · shellsrc/java.js:21

    execFile(file, args, { timeout: timeoutMs, windowsHide: true, maxBuffer: 8 * 1024 * 1024 }, (error, stdout) => {

  • 警告shellExec · shellsrc/java.js:527

    execFile(file, args, { timeout: timeoutMs, windowsHide: true, maxBuffer: 8 * 1024 * 1024 }, (error, stdout, stderr) => {

  • 警告netIp · networksrc/main.js:430

    const url = new URL(req.url || '/', 'http://127.0.0.1');

  • 警告netIp · networksrc/ops.js:574

    baseUrl: item.httpPort ? `http://127.0.0.1:${item.httpPort}` : '',

  • 警告netIp · networksrc/ops.js:966

    baseUrl: httpPort ? `http://127.0.0.1:${httpPort}` : '',

  • 警告fsWrite · filessrc/project-store.js:73

    fs.writeFileSync(tmp, JSON.stringify(doc, null, 2), 'utf8');

  • 警告childProcess · code-execsrc/restart.js:462

    child = spawn(exe, argv, {

  • 警告shellExec · shellsrc/restart.js:117

    execFile(cmd, args, { timeout: 6000, windowsHide: true }, (error, stdout) => resolve(error ? '' : String(stdout || '')));

  • 警告shellExec · shellsrc/restart.js:159

    execFile(isWindows ? 'where' : 'which', ['mvn'], { timeout: 5000, windowsHide: true }, (error, stdout) => {

  • 警告shellExec · shellsrc/restart.js:342

    const child = execFile(

2动态审计模型读脱敏源码上下文 · 不执行插件代码
最高等级中
并入后总评级 中
审计时间2026-10-22
发现计数0 严重·0 高另有 2 条中 / 2 条低未展开
展开 4 条审计发现
  • medium/dsh-api-runner/api 的鉴权栅栏是条件式的，缺失时会放行src/main.js:265

    注释已说明宿主鉴权不覆盖插件前缀路由，因此这个可选调用就是唯一闸门。若部署的宿主没有 requestRejection，rejection 为 undefined，所有路由都在无鉴权下执行：java/start|stop|restart（杀进程/拉进程）、settings POST（任意 dataDir/mavenHome）、读项目配置与发起外部接口调用。任何本机进程，或通过 DNS rebinding 访问本机 Web 服务的网页，都能借此操控进程。

  • mediumjava start 对任意 pid 直接杀进程树，无项目或归属校验src/java-runner.js:259

    唯一前置条件只是 jcmd 快照成功（本机任意 JVM 均可）。调用方有设计上不经宿主鉴权的 HTTP 路由 `java/start`（body.pid）和 ApiRunner 工具（模型传 pid）。随后插件会杀掉该 JVM 的整个进程树并按快照重新拉起。模型路径可被间接利用：日志文件与接口响应体会原样进入模型上下文，植入文本即可诱导它杀掉无关服务。

  • low接受客户端提供的绝对路径作为项目键，可跨项目读/写配置src/main.js

    pickCwd/pickProject 允许来自请求体或查询串的绝对路径，能访问该路由的调用方（或绕过栅栏者）可让插件解析任意目录下的 `<dir>/.dsh/api-runner.yml` 并返回其中的接口 id/URL、服务命令、日志路径，同时把项目数据写进该键。

  • low日志 id 清洗保留点号，id 为 ".." 时会写出 java-logs 目录src/java-runner.js:172

    `[^\w.-]` 允许 '.'，因此 id 为 '..'（可由 java_action=start 的 id 或 HTTP body.id 影响，最终传入 logPathOf 与 _ensureLogHeader）会解析成 <dataDir>/<时间戳>.log，在预期的服务目录上一层创建/追加文件。文件名是固定时间戳，影响仅限在托管目录之外产生游离文件。

未发现严重问题，但插件 HTTP 前缀路由的鉴权栅栏是条件式的（可能失效），且 java start 可凭任意 pid 杀掉本机 JVM，无归属校验。

口径：动态审计只会把风险往严重里判，不会把风险降下来（只升不降，不构成豁免）；模型判错时由人工复核撤回，撤回后回到静态判定。合并判定 = 两层中更严的那一个。

免责声明：静态扫描与动态安全审计都是自动化分析，不构成安全保证。安装前请自行审查。

活跃度

最近提交 2026-10-22 · 活跃度：活跃

• 仓库创建: 2026-10-21

• 星标: ★ 1 · 复刻: 0

• 健康度: 活跃 — 近 30 天有提交

来源

GitHub: github.com/lhhzmz229/dsh-api-runner

这页有帮助吗？