focus-guard

v3.0.7
junxin · 更新于 2026-10-18 · MIT

FocusGuard 聚焦护栏核心包:给 AI 编码智能体(ZCode / DSH 双端原生硬拦截)装上的履职纪律与监察系统。日常零打扰、只查行为;六条钩子覆盖会话启动到收尾全程,含三预算池、L1-L6 梯度处罚、高危命令审批单、KPI 兑现、因果链留痕与积木图书馆。零依赖(Node.js ≥18),是所有人下载的范本包——外接集成见 focus-guard-extended。

开发与运行时dshzcodeagent-hooksfocus依赖 1 项
认证等级
L3
4 / 4 层有结论
健康分 · S
100
0 条扣分
周下载
670
截至 11-13
依赖漏洞
0
无公告
能力扫描
9 项
2 高关注 · 4 需留意
上线 27 天下载趋势
按天
累计下载1.6k
近 7 天670
单日峰值444
近 7 天环比↑292%
015030045060010/1810/2210/2610/3011/311/711/1310/18 · 44410/19 · 010/20 · 010/21 · 5210/22 · 4310/23 · 3110/24 · 2110/25 · 2710/26 · 4910/27 · 3010/28 · 2710/29 · 2110/30 · 2010/31 · 2711/1 · 2411/2 · 2611/3 · 2811/4 · 2011/5 · 2411/6 · 2211/7 · 15111/8 · 4511/9 · 2911/10 · 4111/11 · 33511/12 · 6911/13 · 0

这个包发布于 2026-10-18,上线还不满四周,按周折桶只剩几个点, 所以先按天画。纵轴同样从 0 起;npm 的日下载量滞后 1~2 天结算,最后一天可能偏低。

报告更新于 2026-11-06
四层检测
检测 L3完整口径

四层逐级把关:包结构是否完整、能否与其他插件组合、隔离环境能否装上并启动、抽样运行时是否异常。任一层未通过,不计入等级。

  1. L0
    静态结构与契约

    sha512-So+wmhfRU+h3WBcR… 与本地 tarball 复算一致,补丁与入口齐备

    通过
  2. L1
    配置组合与依赖图

    插入模块可解析,目录内 peer 满足,跨包无 entry id 冲突

    通过
  3. L2
    隔离沙箱冒烟

    隔离 profile 安装成功,层已挂载;宿主带它启动(booted)(产自 dsh 0.2.0-rc.2,当前基线 0.2.2-rc.1)

    通过
  4. L3
    运行时健康监控

    抽样会话内未观测到外部进程 / 越界写 / 外连(1293 个事件)(日志里没有它的名字)(产自 dsh 0.2.0-rc.2,当前基线 0.2.2-rc.1;工装已变更(verify_install.py、verify_browser.py、verify_runtime.py),结论按当时条件读)

    通过

检测等级只回答四件事:包本身结构是否完整可解析(结构完整)、能不能与别的插件组合(可组合)、隔离环境里装不装得上并起得来(可安装)、会话观测里有没有出现意外动作(已观测)。依赖漏洞、仓库存活、下载量都不参与评级,只作为独立信号标注。可信 ≠ 无漏洞,上架 ≠ 推荐。

能力扫描
9 项能力 · 219 处命中

命中次数只说明源码里出现过这类调用,不说明行为好坏。逐条看下面的清单。

可执行外部程序
spawns-processes · 11 处
高关注
以 shell 执行命令
shell-exec · 10 处
高关注
写入文件
writes-files · 47 处
需留意
读取文件
reads-files · 83 处
一般
读取环境变量
reads-env · 43 处
一般
动态加载模块
dynamic-import · 15 处
一般
启动伪终端
spawns-pty · 7 处
需留意
调用 Windows 上没有的命令
windows-command · 1 处
需留意
删除操作未校验路径
destructive-delete · 2 处
需留意
兼容性
可与其它插件组合

安装前需确认四项:依赖哪些包、需要何种运行时、自带多少第三方依赖、是否改动宿主本身。

peer 依赖
1个
全部来自 @deepseek-ai/
运行时要求
>=18.17
声明在 engines.node
第三方依赖
0个
未引入第三方依赖
bundle patch
1个
./src/dsh/cordis.patch.yml
依赖安全公告
无已知公告

按声明范围的下界查 OSV.dev,没有命中已知漏洞。这不等于依赖绝对安全,只说明公开数据库里没有记录。