# @hy-sde-org/dsh-tool-av 中文文档

规范地址：https://npmcn.com/package/%40hy-sde-org/dsh-tool-av/

版本：0\.2\.1-rc\.5
npm 元数据更新时间：2026-11-01T04:21:18.264Z
中文译文更新时间：2026-11-01T10:00:47.940Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40hy-sde-org/dsh-tool-av
原文对照：https://npmcn.com/package/%40hy-sde-org/dsh-tool-av/?lang=original
项目主页：https://github.com/hy-sde/dsh-av#readme
源码仓库：https://github.com/hy-sde/dsh-av

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

- 包体积（解压后）：57.6 kB，17 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- Node.js 要求：\>=22\.19\.0
- 运行依赖：1 个
- peer 依赖：@hy-sde-org/dsh-av ^0\.2\.1-rc\.5，@deepseek-ai/cordis ~4\.0\.5，@deepseek-ai/dsh-tools ^0\.2\.1-rc\.5，@deepseek-ai/dsh-system-prompt ^0\.2\.1-rc\.5
- 首次发布：2026-09-06T03:18:20.929Z
- 最新版本发布：2026-11-01T04:21:18.085Z
- 已发布版本数：9（近 12 个月 9 个）

## 中文简介

主机ctx上面向模型的自动保险库工具（av\_scan审计，av\_doctor加固检查，av\_catalog, av\_list）。Av服务-只读，从不返回秘密值-加上Av:tools系统提示部分；独立，不需要改变线束。

## 安装

```sh
npm install @hy-sde-org/dsh-tool-av
```

也可以使用：`pnpm add @hy-sde-org/dsh-tool-av`、`yarn add @hy-sde-org/dsh-tool-av`、`bun add @hy-sde-org/dsh-tool-av`

## README

# @hy-sde-org dsh-tool-av

主机上面向模型的自动保管库工具 `ctx.av` 服务，再加上一个 `av:tools` 系统提示符位置部分。表面是故意只读的： 审计Mac的暴露凭据，验证加固，检查 检测器/硬化剂目录，并列出保存的秘密名称- **永远不要释放 秘密值放入模型上下文中**。仅从fork独立移植 `@deepseek-ai/dsh-tool-av` -无需更改上游线束。

## 工具表面

-   `av_scan [severity] [detector] [max_findings]` -全面审计；发现携带 严重性、解释、补救、受影响的文件/行，以及检测器 这就产生了他们。 `severity` 过滤器(`high`/`medium`/`low`)， `detector` 缩小到一个工具(名称从 `av_catalog` 范围=探测器)。
-   `av_doctor [tool]` -硬化验证：每个硬化机的健康/问题 带有修复和存根/目标路径。
-   `av_catalog [scope] [max_entries]` -其中探测器和硬化剂自动 Vault知道（名称+文档链接+加固/适用状态），所以代理 可以针对 `av_scan` 和 `av_doctor` 正确。
-   `av_list` -保存的秘密 **只有名称，没有值**.

当 `av` CLI缺失或损坏，每个工具都降级为结构化的 `{ available: false, reason }` 值，并提供安装提示 （`brew install --cask automic-vault/isotopes/automic-vault`)而不是 投掷。

## 安全规则

1.  任何工具输出都不包含秘密值。 `av_list` 只返回名称； Scan /doctor/catalog返回路径、配置和建议。
2.  加固的报告和建议(`av harden <tool>` 作为终端 命令用户运行)；从不由代理自动批准或执行。
3.  查找结果和目录条目的上限为(`maxFindings` 默认30, `maxCatalogEntries` 默认为60)并汇总。

## 配置

| 配置 | 默认的 | 意义 |
| --- | --- | --- |
| `maxFindings` | `30` | 上限 `av_scan` 显示结果+返回结果 |
| `maxCatalogEntries` | `60` | 每个作用域的目录条目上限 |
| `enabled` | `true` | 集 `false` 要禁用 `av:tools` 提示部分 |

## 安装

agent平面：按预设行挂载，解析主机 `av` 服务 （不需要领域/隔离）。复制现成的预设从 `examples/agent-preset/` 成 `~/.dsh/.agent-presets/<id>/`.

```bash
pnpm --filter @hy-sde-org/dsh-tool-av test    # end-to-end tool tests over a fake av CLI
pnpm --filter @hy-sde-org/dsh-tool-av build   # tsc -> dist
```

## 常见问题

### @hy-sde-org/dsh-tool-av 是什么？

主机ctx上面向模型的自动保险库工具（av\_scan审计，av\_doctor加固检查，av\_catalog, av\_list）。Av服务-只读，从不返回秘密值-加上Av:tools系统提示部分；独立，不需要改变线束。

### 如何安装 @hy-sde-org/dsh-tool-av？

在项目目录运行 npm install @hy-sde-org/dsh-tool-av，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：@hy-sde-org/dsh-av（^0\.2\.1-rc\.5）、@deepseek-ai/cordis（~4\.0\.5）、@deepseek-ai/dsh-tools（^0\.2\.1-rc\.5）、@deepseek-ai/dsh-system-prompt（^0\.2\.1-rc\.5）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @hy-sde-org/dsh-tool-av 支持 TypeScript 吗？

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

### @hy-sde-org/dsh-tool-av 支持 ESM 还是 CommonJS？

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

### @hy-sde-org/dsh-tool-av 需要什么版本的 Node\.js？

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

### @hy-sde-org/dsh-tool-av 可以商用吗？

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

### @hy-sde-org/dsh-tool-av 还在维护吗？

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