# @flood-md/agent 中文文档

规范地址：https://npmcn.com/package/%40flood-md/agent/

版本：0\.2\.14
npm 元数据更新时间：2026-11-15T12:29:59.881Z
中文译文更新时间：2026-11-15T13:56:57.034Z
软件包许可：MIT

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

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

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

- 包体积（解压后）：1.6 MB，540 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：0 个
- 首次发布：2026-10-22T11:16:31.991Z
- 最新版本发布：2026-11-15T12:29:59.541Z
- 近 30 天下载量：3203（2026-10-15 至 2026-11-13，npm 官方下载统计）
- 已发布版本数：17（近 12 个月 17 个）

## 中文简介

用于编码剂的版本洪水设计指令.

## 安装

```sh
npm install @flood-md/agent
```

也可以使用：`pnpm add @flood-md/agent`、`yarn add @flood-md/agent`、`bun add @flood-md/agent`

## README

# @ flood-md/ 代理服务器

洪灾反应/Next.js项目的版本相匹配的指南。 读取已安装 在编译屏幕之前签订合同。 0.2.11 参考包包括间隔 指导、路线和可观察的规则。 这些文件授权 无权修改外部服务.

可选 `@flood-md/agent/inspect` 出口用品检查 本地验证工具中的浏览器评价 。 它读取了电流 DOM 不突变/网络访问和返回有界限的观测、复制和 字段几何学。 见 [已进行审查](https://npmcn.com/package/%40flood-md/agent/references/rendered-review.md) 用于执行, 隐私、限制和背景审查。 知识阅读器的主要条目仍然存在 唯节. 空的观察列表不能验证接口的质量. 相同的可选条目导出检查SourceUI 以查看有限制的文本观察 联合来文X/CSS。 它建议对本地对话框/控制进行所有者审查 不读取文件或执行源的自定义布局。 文本匹配可以是 假阳性或错失间接代码;请参见已提供的审查参考. 对于全窗Appshell路线, `assertWorkspaceScroll` 失败浏览器测试 当文档滚动或工作空间失去其“洪水”滚动视图时. 见 [Playwright 示例](https://npmcn.com/package/%40flood-md/agent/references/rendered-review.md#require-workspace-scroll-in-browser-tests)。 。 。 .

该软件包还用 TypeScript 显示一个只读的节点知识 API 声明。 不需要模型提供者,网络服务或MCP运行时间.

```ts
import {createKnowledgeReader} from '@flood-md/agent';
const reader = createKnowledgeReader();
const context = await reader.info();
const page = await reader.list({kind: 'component', search: 'table'});
const material = await reader.read('component:data-table');
```

在当前时跟随下一条 Cursor/ nextOffset 。 元数据与 ; 对照匹配的软件包目录检查选定的机构. CLI增加了主机版检查并保存了项目拥有的指南副本. snowledge.json包含语义注释;构建生成 dist/catalog.json 说明书、指南和食谱 网站。 不手工编辑生成散列或重复组件合同. 见 [代理知识](https://npmcn.com/package/docs/agent-knowledge.md) 为团体、能力、, 先决条件、阅读预算、兼容性和定制行为.

源包包括现有暗基的路由工作流程,包括 应用程序结构,屏幕组成,布局组成,组件组成,分级, 印刷、决策设计、间隔、运动、, 基础、可访问性、表单、叠加、导航、数据显示、记录、, 反馈、界面内容、视觉审查和核实。 轻而易举 洪井条目选择相关技能; 嵌入的文件夹不意味着独立 自动发现. 工作流程. json描述适用性. 规则.json描述可观察到的检查; 没有完成的组件审计报告或可执行的执行引擎.

| 来源 | 作用 |
| --- | --- |
| 设计 | 共享版UI/组件合同 |
| SKILLL.MD (英语) | 短条目和任务路由器 |
| 参考文献/路由 | 适用性、受众、先决条件和管理来源 |
| 参考文献/汇编 | 屏幕/格式组成工作流程 |
| 参考文献/浮标组合/SKILL.md | 完全原始的第一成分 技巧从洪水取道 |
| 参考文献/间隔 | 所测量的相距、密度、筑巢几何和受撞击地区 |
| 参考文献/可获取性.md | 互动和认知检查 |
| 参考文献/定制 | 范围化语义定制 |
| 参考文献/核查 | 报告完成前的证据 |
| 规则.json | 具备条件、来源和可观察检查的稳定规则身份证 |
| 显示. json | 来源 − CLI 使用的已安装路径绘图 |
| 工作流程.json | 构成部分-家庭适用性和经路由的全技能来源 |

CLI输入复制了所有未使用的路径的每个显示条目。 医生检查 需要没有链接的正则文件 。 既不重写工具主机 指示或证明代理人遵守。 该网站为下列来源提供服务: /代理/在建设之后。 只读相关引用; 已安装声明 管理可用的API。 见 [人类指南](https://npmcn.com/package/docs/agents.md)。 。 。 .

DESIGN.md包括具体构成规则:内在动作宽度, 反应性形式父母、接近指标/标签对、选择间隔、, 和键盘/内在形式要求。 总是检查申报 在使用后期版本引入的API之前安装了软件包. 参见用户界面 [版式指南](https://npmcn.com/package/docs/layout.md) 用于完整的例子.

明确的条目/规则指南路径识别包源; 显示. 文件地图 他们的目标。 直接到工程的 Entry 点数 技术。 与软件包和DESIGN标题保持一致.

## 常见问题

### @flood-md/agent 是什么？

用于编码剂的版本洪水设计指令\.

### 如何安装 @flood-md/agent？

在项目目录运行 npm install @flood-md/agent，或使用 pnpm add / yarn add / bun add。

### @flood-md/agent 支持 TypeScript 吗？

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

### @flood-md/agent 支持 ESM 还是 CommonJS？

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

### @flood-md/agent 可以商用吗？

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

### @flood-md/agent 的下载量有多少？

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

### @flood-md/agent 还在维护吗？

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