# @framers/agentos-ext-code-safety 中文文档

规范地址：https://npmcn.com/package/%40framers/agentos-ext-code-safety/

版本：0\.2\.3
npm 元数据更新时间：2026-10-20T20:54:56.821Z
中文译文更新时间：2026-11-15T12:42:02.285Z
软件包许可：Apache-2\.0

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

原始 npm 页面：https://www.npmjs.com/package/%40framers/agentos-ext-code-safety
原文对照：https://npmcn.com/package/%40framers/agentos-ext-code-safety/?lang=original
项目主页：https://agentos.sh/
源码仓库：https://github.com/manicinc/voice-chat-assistant

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

- 包体积（解压后）：288 kB，38 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：0 个
- peer 依赖：@framers/agentos \>=0\.7\.0
- 首次发布：2026-03-21T23:06:27.131Z
- 最新版本发布：2026-10-20T20:54:56.629Z
- 近 30 天下载量：19863（2026-10-16 至 2026-11-14，npm 官方下载统计）
- 已发布版本数：5（近 12 个月 5 个）

## 中文简介

用于检测AgentOS中危险代码模式的静态分析护栏

## 安装

```sh
npm install @framers/agentos-ext-code-safety
```

也可以使用：`pnpm add @framers/agentos-ext-code-safety`、`yarn add @framers/agentos-ext-code-safety`、`bun add @framers/agentos-ext-code-safety`

## README

# @ framers/ agentos-ex-code- safety (英语)

静态分析护栏 [`@framers/agentos`](https://github.com/framerslab/agentos)在向用户显示或执行任何沙盒中的代码之前,扫描代理机发出的代码(在聊天、伪造工具、生成的文物中).

## 它会做什么

从代理输出中提取代码栅栏,解析它们,并通过可配置的规则集运行每个块. 默认规则覆盖 :

-   文件系统销毁( E)`rm -rf /`,递归删除)
-   过程控制( E)`fork bombs`,无限制 `exec`(中文(简体) )
-   网络过滤到未登录的主机
-   硬码密钥( API 密钥、 令牌、 私人密钥)
-   Eval 风格的动态代码执行
-   OWASP LLM Top 10中已知的不良模式

规则是可插接的;带回自己的,引擎则会将其与默认合并.

## 安装

```bash
npm install @framers/agentos-ext-code-safety
```

同伴依赖 : [`@framers/agentos`](https://github.com/framerslab/agentos)。 。 。 .

## 快速启动

```ts
import { AgentOS } from '@framers/agentos';
import { createCodeSafetyGuardrail } from '@framers/agentos-ext-code-safety';

const agentos = new AgentOS();
await agentos.initialize({
  extensionManifest: {
    packs: [
      {
        factory: () =>
          createCodeSafetyGuardrail({
            languages: ['typescript', 'javascript', 'python', 'shell'],
            extraRules: [],
          }),
        enabled: true,
      },
    ],
  },
});
```

## 公共 API

-   `CodeFenceExtractor` ——从道人身上取出有栅栏的密码块
-   `CodeSafetyScanner` ——通过规则运行围栏内容
-   `CodeSafetyGuardrail` 警卫铁路为AgentOS合同安装扫描仪
-   `DefaultRules` ——内置规则包
-   `createCodeSafetyGuardrail(options?)` 工厂归还 `ExtensionPack`
-   `createExtensionPack(context)` ——AgentOS扩展设备使用的可自动发现工厂自动取出

见 [`src/types.ts`](https://npmcn.com/package/%40framers/agentos-ext-code-safety/src/types.ts) 页:1 `CodeSafetyPackOptions`。 。 。 .

## 实例

-   `test/` ——各受支持语言的固定图案外加规则作者模式

## 懒惰装入和可选安装

此软件包是 `@framers/agentos-extensions-registry`登记册船舶目录元数据; `createCuratedManifest()` 电话 `import.meta.resolve()` 每个条目并默默跳过任何未安装的条目. `npm install @framers/agentos-ext-code-safety` 是大门.

不像其他的护卫包, 代码安全是仅regex。 懒惰无能的模特儿 默认规则设定了正在处理的船舶,并增加了零冷启动成本. 自定义规则在激活时合并通过 `extraRules`。 。 。 .

护栏登记员 `config.evaluateStreamingChunks = true` 并在双相调度器的第二阶段(平行分级器)运行。 危险的栅栏模式(文件系统被破坏、秘密、eval)返回 `BLOCK`; 低等匹配返回 `FLAG`第二阶段最糟糕的行动汇总将作出最严格的决定.

## 工具调用

护栏也设了 `config.evaluateToolCalls`,因此 AgentOS 输出调度器(`@framers/agentos` 0.13.67及后)将每块被守护的溪流取出工具呼叫器. 它扫描它所看工具的代码参数: `command` 联 合 国 `shell_execute` (作为巴什语), `query` 联 合 国 `run_sql` (作为SQL)和 `content` 联 合 国 `write_file`, (中文(简体) ), `create_file` 财务报告和审定财务报表 `edit_file`编辑 `codeExecutingTools` 财务报告和审定财务报表 `codeArgumentMapping` 选项更改该列表。 一个关键的或高的发现阻挡了呼叫:流以护栏的判断来取而代之,因此流从不将呼叫交给主机运行. 调用运行时间会自行运行( A)`executionMode: 'internal'`)不等待输出的护栏,所以一个块会结束溪流而不停止. 更早的AgentOS不读取旗帜并传递工具呼叫未扫描.

关于完整的DI模型 和端到端的走过, 将这个包放在调度器,见 [扩展如何保持可选和懒惰](https://docs.agentos.sh/extensions#how-extensions-stay-optional-and-lazy) 编辑 [自动加载指南](https://docs.agentos.sh/extensions/auto-loading)。 。 。 .

## 许可证

Apache 2. 0 — 见 repo 根 [自由主义](https://npmcn.com/package/LICENSE)。 。 。 .

## 常见问题

### @framers/agentos-ext-code-safety 是什么？

用于检测AgentOS中危险代码模式的静态分析护栏

### 如何安装 @framers/agentos-ext-code-safety？

在项目目录运行 npm install @framers/agentos-ext-code-safety，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：@framers/agentos（\>=0\.7\.0）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @framers/agentos-ext-code-safety 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @framers/agentos-ext-code-safety 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @framers/agentos-ext-code-safety 可以商用吗？

@framers/agentos-ext-code-safety 使用 Apache-2\.0 许可。宽松许可：允许商业使用、修改和再分发，并附带明确的专利授权；分发时需保留许可与 NOTICE 文件，修改过的文件要注明改动。以上为概括，不构成法律意见，请以许可原文为准。

### @framers/agentos-ext-code-safety 的下载量有多少？

根据 npm 官方下载统计，@framers/agentos-ext-code-safety 在 2026/10/16 – 2026/11/14 这 30 天内被下载 19,863 次，日均约 662 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @framers/agentos-ext-code-safety 还在维护吗？

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