# @bas\.io/guard 中文文档

规范地址：https://npmcn.com/package/%40bas.io/guard/

版本：0\.33\.1
npm 元数据更新时间：2026-10-27T10:51:35.293Z
中文译文更新时间：2026-11-07T20:01:30.967Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40bas.io/guard
原文对照：https://npmcn.com/package/%40bas.io/guard/?lang=original
项目主页：https://github.com/basdotio/bas-guard#readme
源码仓库：https://github.com/basdotio/bas-guard

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：9.3 kB，3 个文件
- TypeScript 类型：未声明
- Node.js 要求：\>=18
- 运行依赖：0 个
- 首次发布：2026-09-09T15:54:11.262Z
- 最新版本发布：2026-10-27T10:51:34.385Z
- 近 30 天下载量：2817（2026-10-08 至 2026-11-06，npm 官方下载统计）
- 已发布版本数：31（近 12 个月 31 个）

## 中文简介

本地,离线安全扫描的AI代理设置:审计技能,MCP服务器,钩子和权限授予代理自动装入,在安装前先审查一个.

## 安装

```sh
npm install @bas.io/guard
```

也可以使用：`pnpm add @bas.io/guard`、`yarn add @bas.io/guard`、`bun add @bas.io/guard`

## README

# 护卫

本地,离线安全扫描 AI 代理设置——"反病毒为你的克洛德代码 配置". 它把一切做为代理人 **自动装入** (技能,MCP服务器,钩子, 授权授权、子代理、斜线命令、指令文件)和报告带来风险的内容.

它从不执行它扫描的东西,也不进行自己的网络通话. 扫描只读; 写作的指令`clean`只有永远 _移动_ 东西在你的配置根.

## 用这个

不需要安装——包内有二进制船,所以没有安装脚本和 安装时不下载任何信息 :

```bash
# vet one skill, plugin or zip BEFORE it reaches a directory an agent loads from
npx --yes @bas.io/guard@latest check ./some-skill

# audit everything the agent on this machine auto-loads
npx --yes @bas.io/guard@latest scan --report
```

`check` 答案关于你指向它的东西, 所以它意味着相同的 你运行它的地方. `scan` 回答关于 **它运行的机器** 在你自己的电脑上,这是你真正的 `~/.claude`,这是重点;在主办会议或CI容器中,它描述 而不是让一个几乎是空的 框中的分数接近100个无标记.

留作再用,并作加载时门:

```bash
npm i -g @bas.io/guard

bas-guard check ./some-skill     # vet one skill/plugin/zip before installing it
bas-guard scan --report          # audit this machine's ~/.claude + write an HTML report
bas-guard clean                  # list duplicate, bloated and stale skills (report-only)
bas-guard version
```

退出代码 : `0` 低于阈值.. `1` (a) 调查结果在或以上 `--fail-on` • 妇女 `2` 运行时间出错 (扫描没有发生——从未读过) `2` \* 作为通行证) `3` `clean` 部分行为 `4` 门 无法评估( 使用 `--fail-on`,根没有检查 或项目 `.claude` 这个 未读 `--fail-on-llm`法官不能为一切负责 跑道切开 以信号结尾以 `128 + signal`,如同任何Unix程序: `130` 为Ctrl-C, `141` 何时 输出管被关闭(`bas-guard scan | head`) (中文(简体) ). 非一或三等号的非零表示 你没有得到一个判决.

## 负载时门需要一个稳定的路径

`bas-guard hook install` 记录它从二进制运行的绝对路径, 所以 Claude Code 在每个技能负载之前都可以叫它. **不从一个 `npx` 援引**该 路径生活在 npm 的临时缓存中,并被垃圾收集,然后钩点在 文件已不复存在 – 每一种技能在设置仍然外观时加载未审计 保护(扫描报告为 `GATE-001`) (中文(简体) ). 在全球安装,或使用释放二进制,当 你想要的大门.

## 它是什么, 和不是的

A 类 **静态** 扫描仪:相对风险信号,不是安全证书. 它不能证明意图, 观察程序在运行时会做什么,通过加密的有效载荷读取,或者告诉你是什么 远程 MCP 端点实际上是。 "没有发现"意味着没有发现 从静态规则 值得读的正是这一点.

## 再来

完整的文档,规则参考文献(每个找到可以打印的ID),克洛德代码插件, 和带有校验和的平台二进制 : [https://github.com/basdotio/bas-guard. 互联网档案馆的存檔,存档日期2011-12-21](https://github.com/basdotio/bas-guard)

麻省理工学院.

## 常见问题

### @bas\.io/guard 是什么？

本地,离线安全扫描的AI代理设置:审计技能,MCP服务器,钩子和权限授予代理自动装入,在安装前先审查一个\.

### 如何安装 @bas\.io/guard？

在项目目录运行 npm install @bas\.io/guard，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 aguard、bas-guard，可以用 npx aguard 直接运行。

### @bas\.io/guard 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/bas\.io\_\_guard 是否存在。

### @bas\.io/guard 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=18。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @bas\.io/guard 可以商用吗？

@bas\.io/guard 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @bas\.io/guard 的下载量有多少？

根据 npm 官方下载统计，@bas\.io/guard 在 2026/10/08 – 2026/11/06 这 30 天内被下载 2,817 次，日均约 94 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @bas\.io/guard 还在维护吗？

最新版本 0\.33\.1 发布于 2026/10/27（11 天前）；至今共发布 31 个版本，其中过去 12 个月发布了 31 个；首次发布于 2026/09/09。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。