# @corva/fe-ai-tools 中文文档
规范地址：https://npmcn.com/package/%40corva/fe-ai-tools/
版本：1\.9\.0
npm 元数据更新时间：2026-08-31T14:55:53.831Z
中文译文更新时间：2026-11-10T20:06:25.427Z
软件包许可：UNLICENSED
本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。
原始 npm 页面：https://www.npmjs.com/package/%40corva/fe-ai-tools
原文对照：https://npmcn.com/package/%40corva/fe-ai-tools/?lang=original
项目主页：https://github.com/corva-ai/corva-fe-ai-tools#readme
源码仓库：https://github.com/corva-ai/corva-fe-ai-tools
## 关键信息（来自 npm 元数据）
- 包体积（解压后）：649 kB，32 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- Node.js 要求：\>=20
- 运行依赖：0 个
- peer 依赖：react \>=16\.8
- 首次发布：2026-06-22T16:54:44.929Z
- 最新版本发布：2026-08-31T14:55:53.630Z
- 近 30 天下载量：7584（2026-10-11 至 2026-11-09，npm 官方下载统计）
- 已发布版本数：13（近 12 个月 13 个）
## 中文简介
询问 Corva app-tools 工具包:结果构建器,创建Toolset,注册/eval hooks,并为 Corva 平台和 Dev Center FE apps 键入可显示 AI 工具的参数阅读器.
## 安装
```sh
npm install @corva/fe-ai-tools
```
也可以使用：`pnpm add @corva/fe-ai-tools`、`yarn add @corva/fe-ai-tools`、`bun add @corva/fe-ai-tools`
## README
# 科瓦-费-艾-工具
一回中两事:
1. **`@corva/fe-ai-tools`** ——独立版"问柯娃" **应用程序工具包** (结果) 建造者、指挥/管理/预算原始人、, `createToolset`,登记/检索 由DC 和 fE应用平台. 来源于 [`src/`](https://npmcn.com/package/%40corva/fe-ai-tools/src/)· ; `yarn build` (tsup) (英语) `yarn test` (视频) / `yarn lint`。反应是一种对等依赖.
2. **报道剧本** 用于使用 Ask Corva 覆盖 Corva FE 应用程序的教学库 AI 工具、 eval 套件、 对话情景、 脚本和覆盖跟踪( 每件事 页:1.
使用此重播作为工作游戏本. 链接到 `corva-web-frontend` 新鲜度 仅引用——代理从这里开始,选择正确的工作流程并执行 而不首先读另一个repo.
## 从这里开始——你需要做什么?
| 我必须要.. | 转到 |
| --- | --- |
| **上载的应用程序** 添加 Corva 工具并覆盖 | [工作流程/README.md](https://npmcn.com/package/%40corva/fe-ai-tools/workflows/README.md) |
| **维护已覆盖的DC或内置平台应用** | [工作流程/README.md](https://npmcn.com/package/%40corva/fe-ai-tools/workflows/README.md) 与 `maintain --range ...` |
| **对当前工具包合同的现有应用程序重新进行资格审查** | [工作流程/现有申请升级/即期](https://npmcn.com/package/%40corva/fe-ai-tools/workflows/existing-app-upgrade-prompt.md) |
| **检查或在整个储存库推出工具包** | [文献/参考资料/传单管理](https://npmcn.com/package/%40corva/fe-ai-tools/docs/reference/fleet-management.md)· ; [演变和未来的自动化](https://npmcn.com/package/%40corva/fe-ai-tools/docs/reference/fleet-evolution.md) |
| **关闭 app PR 并同步覆盖/ Jira** | [文件/参考资料/交付-同步md](https://npmcn.com/package/%40corva/fe-ai-tools/docs/reference/delivery-sync.md) |
| **测试一个应用/ 看代理如何使用其工具** | [工作流程/测试/](https://npmcn.com/package/%40corva/fe-ai-tools/workflows/testing/) ——接受食谱E;勘探/调试食谱A |
| **理解如何问克瓦** (概念第一) | **新问克瓦?** ↓(下节) |
| 有关工作 **平台核心工具/多应用程序路由** | [工作流程/平台/平台](https://npmcn.com/package/%40corva/fe-ai-tools/workflows/platform/) - 核心合同、主机确认、整合证明 |
| 见 **已经覆盖的东西** / 积压 | [文档/覆盖/](https://npmcn.com/package/%40corva/fe-ai-tools/docs/coverage/) |
| **计划或轨道** 多波工作(等级、状态、波) | [计划/计划](https://npmcn.com/package/%40corva/fe-ai-tools/plans/README.md) |
每个登入的应用程序都有一个 Ask Corva 工具表面、对话框情景和一个直播 录取证. **仅列出已锁定的应用程序** 内 [文件/覆盖/覆盖政策](https://npmcn.com/package/%40corva/fe-ai-tools/docs/coverage/coverage-policy.md) 额外获取 一个完全等级的Eval套房。 登入会读取此策略; 它不选择或计分 锚自出.
## 新问克瓦? 先看这个
如果你从来没有见过Corva, 花5分钟 在精神模型之前 触摸一个工作流程。 工作流程研究假设你知道 这两件事 拥有 _进程_而不是概念.
1. [文献/参考资料/建筑](https://npmcn.com/package/%40corva/fe-ai-tools/docs/reference/architecture.md) ——如何是用户 即时成为UI的更改,“延迟工具”是什么,工具是如何到达的 代理人(`prompt → agent → app-call-tool → your handler → state`) (中文(简体) ). 这个 _为什么_ 包括代理人名册+词汇表.
2. [文献/参考资料/工具编写](https://npmcn.com/package/%40corva/fe-ai-tools/docs/reference/tool-authoring.md) - 痷琌 工具是,两种类型,以及一种的外观(文件夹形状、信封和 )),分类特定描述标准.
3. [文件/参考资料/应用工具结构.md](https://npmcn.com/package/%40corva/fe-ai-tools/docs/reference/app-tool-structure.md) —— 说 犬科分层 `src/ai-tools` 模块,导入边框,确定 门,独立结构的判决.
4. [参考文献/参考文献/杂志](https://npmcn.com/package/%40corva/fe-ai-tools/docs/reference/eval-harness.md) - 怎么样 lander驱动真实的UI和分数状态(当您到达测试/evals时读取).
5. [文件/参考资料/平台-表面.md](https://npmcn.com/package/%40corva/fe-ai-tools/docs/reference/platform-surfaces.md) - 那个 cWF的前端工具(全球核心、平台表面、DC app)的三级工具 一级能力属于一种能力,属于表面登记合同。 读取 [文档/覆盖/cwf-工具](https://npmcn.com/package/%40corva/fe-ai-tools/docs/coverage/cwf-tools.md)清单中 工具 CNF 船舶和代理人能够看见的条件.
6. [文件/参考资料/日历修订](https://npmcn.com/package/%40corva/fe-ai-tools/docs/reference/canon-revisions.md) - 那个 编号的行码变化。 每个被封面的应用程序都印有它发去的修订版 在下面,所以以后打开的回波可以仅仅应用三角洲而不是再读.
## 应用覆盖流量
[`workflows/README.md`](https://npmcn.com/package/%40corva/fe-ai-tools/workflows/README.md) 初始覆盖的唯一所有者 后期维修:舞台订单、独立审查、修理、证据新鲜度, 吉特快递 交接 具体的引用贯穿于最后的测试,承诺, push, profile PR, required PR checks, 以及精确的远程PR头验证,不包含 中间 Git 授权暂停 。 从一个绝对的应用路径和一个 明确模式 :
```md
@workflows/README.md /absolute/path/to/app onboard
@workflows/README.md /absolute/path/to/app maintain --range ...
```
阶段指南 `workflows//README.md` 包含执行细节 发现 工具 情景 锚地测试 现场测试 平台核心和 多应用程序集成的路由 [工作流程/平台/平台](https://npmcn.com/package/%40corva/fe-ai-tools/workflows/platform/)。 。 。 .
## App发射器(机上/试验)
两个发射器将几个答案变成一个好的开始:它们找到应用程序的回波 (将它与 `--clone` (如果缺席) `.env`,写 机器可读JSON结果,并打印在哪里开始+操作 得到了chas,然后指回到这个README的导航。 把他们从 repo 根(或通过绝对路径——它们解决自己的位置):
```bash
# Cover an app (add AI tools) — the slug is all it needs (interactive prompt):
scripts/launch/onboard.sh
# …or headless (how the agent runs it, after taking the repo from you):
scripts/launch/onboard.sh --repo directional-surveys-and-projections [--clone] [--dry-run]
# Test an app (drive the agent live) — repo + recipe:
scripts/launch/test-app.sh --repo directional-surveys-and-projections --recipe E [--clone]
# Print the questions a script asks (the agent reads this to know what to ask you):
scripts/launch/onboard.sh --print-questions
```
应用程序名称取自于 sattle; 登入如下 [峡谷流出](https://npmcn.com/package/%40corva/fe-ai-tools/workflows/README.md) 以顺序. 锁定成员从 `docs/coverage/coverage-policy.md`,未由 发射装置或上船时的推断.
`--repo` 取一发子弹( r)`corva-dc-fe-` 为DC应用程序推断, `owner/name`, (中文(简体) ), a GitHub URL,或本地路径. `--dry-run` 预览克隆/`.env` 没有动作 执行它们; 现有 `.env` 永远不会被覆盖.
## 图书馆地图
一切处所(上行是道 _顺序_这是 _指数_) (中文(简体) ).
| 路径 | 目的 |
| --- | --- |
| [工作流程/README.md](https://npmcn.com/package/%40corva/fe-ai-tools/workflows/README.md) | 单笔申请登机、维修、独立审查、修理和交接. |
| [工作流程/应用程序覆盖-即期](https://npmcn.com/package/%40corva/fe-ai-tools/workflows/app-coverage-prompt.md) | 可填充的一app管弦乐即时上机或维护. |
| [工作流程/现有申请升级/即期](https://npmcn.com/package/%40corva/fe-ai-tools/workflows/existing-app-upgrade-prompt.md) | 准备运行 重新获得资格 并迁移一个已经覆盖的应用程序. |
| [工作流程/发现库/](https://npmcn.com/package/%40corva/fe-ai-tools/workflows/discover-queries/) | 发现真正的用户查询 `{app}/ai-tests/queries.json`。 。 。 . |
| [工作流程/工具/软件](https://npmcn.com/package/%40corva/fe-ai-tools/workflows/tools/) | 向 Dev Center app repo 添加 Ask Corva 工具和持久的 repo 本地维护指令 . |
| [工作流程/工具/核对清单.md](https://npmcn.com/package/%40corva/fe-ai-tools/workflows/tools/checklist.md) | 关于来源真相、模块所有权、证据和候选人结构证明的单一独立最后清单. |
| [工作流程/场景/](https://npmcn.com/package/%40corva/fe-ai-tools/workflows/scenarios/) | 作者每个应用程序对话方案 `queries.json` 每个应用程序. |
| [工作流程/评估/](https://npmcn.com/package/%40corva/fe-ai-tools/workflows/evals/) | 作者 : `queries.json`并把它开到绿色. |
| [工作流程/测试/](https://npmcn.com/package/%40corva/fe-ai-tools/workflows/testing/) | 任何应用程序或多应用程序仪表板(接收A-E + eval套件)的活式和交互式代理测试. |
| [工作流程/平台/平台](https://npmcn.com/package/%40corva/fe-ai-tools/workflows/platform/) | 路由内置平台应用并维持平台-核心/多应用行为. |
| [文件/参考资料/](https://npmcn.com/package/%40corva/fe-ai-tools/docs/reference/architecture.md) | 真实源概念docs:架构,工具作者,eval habel,eval架构. |
| [文件/参考资料/交付-同步md](https://npmcn.com/package/%40corva/fe-ai-tools/docs/reference/delivery-sync.md) | 强制性目标应用PR-即时Jira-覆盖-艺术同步合同. |
| [文档/覆盖/cwf-工具](https://npmcn.com/package/%40corva/fe-ai-tools/docs/coverage/cwf-tools.md) | 每艘前端工具corva-web-前端舰只,生效后,重放/确认政策,以及决定代理人能选取的可用条件. |
| [车队/](https://npmcn.com/package/%40corva/fe-ai-tools/fleet/registry.json) | 登记、表v2现状、互动观察、生成健康报告和移徙计划. |
| [参考文献/参考文献/档案-演变](https://npmcn.com/package/%40corva/fe-ai-tools/docs/reference/fleet-evolution.md) | 从只读清单到牵引请求自动化和任选代理辅助审查的必然演变. |
| [文档/覆盖/](https://npmcn.com/package/%40corva/fe-ai-tools/docs/coverage/) | 工具覆盖清单 + DC- app 积压 归本Repo所有. |
| [计划/](https://npmcn.com/package/%40corva/fe-ai-tools/plans/README.md) | 规划+执行框架(任务分级,波浪,变化日志),用于特性和bug. |
| [计划/说明/运行方案](https://npmcn.com/package/%40corva/fe-ai-tools/plans/scripts/run-program.sh) + 键 `yarn pb:auto:dc` | 飞行中程序记录的自动划向-loop驱动程序(一个) `claude -p` 每个时代;需要明确的程序记录和干净的工作树)。 由人类引出,在运行时具有自主性;坐标通过 `pb-deliver-dc-corva`未为 `/pb-feature` 或者说 `/pb-bugfix` 探员. |
| [计划/说明/表-方案.sh](https://npmcn.com/package/%40corva/fe-ai-tools/plans/scripts/watch-program.sh) + 键 `yarn pb:watch` | 仅在运行驱动器上读取的仪表板:锁主,时代计数,当前记录散列,每个分支CI. 安全离开开放. |
| [脚本/](https://npmcn.com/package/%40corva/fe-ai-tools/scripts/) | 确定性验证+飞行前护栏,外加 `launch/` 文件夹( e)`onboard.sh` 编号 : `test-app.sh` + 共享 `lib/common.sh`定位/复制一个应用程序的回波,种子它的 `.env`,并进入工作流程. |
有两个由设计而来的变化日志——将它们分开:
- **`CHANGELOG.md`** (释放-提供)由 `release-please` 从 常规承诺; 它跟踪 `@corva/fe-ai-tools` 舰船版本,是 源消费者针对.
- **`plans/changelog.md`** (游戏本- facing) 仅是附件,名称 触摸 每个承诺的计划/方案区域,以及 `scripts/verify.sh` 执行通过 `plans/scripts/check-playbook.sh`。 。 。 .
编辑一个不能代替另一个.
工作流程文件夹使用短而重复的文件名 : `README.md` (进入点+) 执行合同, `checklist.md` (最后质量门,其中分开), `schema.json` 编号 : `example.json` (机器可读合同+实例), `examples/` (仅该工作流程的工作实例文件).
## 合同和所有权
这回波是 **真相来源** 并拥有:工作流程播放本;脚本和 验证闸;覆盖清单+DC-app积压;概念参考 内 [文件/参考资料/](https://npmcn.com/package/%40corva/fe-ai-tools/docs/reference/architecture.md) —— 说 [架构.md](https://npmcn.com/package/%40corva/fe-ai-tools/docs/reference/architecture.md) (数据流动、代理名册、词汇表), [工具写入.md](https://npmcn.com/package/%40corva/fe-ai-tools/docs/reference/tool-authoring.md), (中文(简体) ), [eval-harness.md (英语)](https://npmcn.com/package/%40corva/fe-ai-tools/docs/reference/eval-harness.md),以及 [eval-architecture.md (英语)](https://npmcn.com/package/%40corva/fe-ai-tools/docs/reference/eval-architecture.md) (主播/集中模式).
妇联(`corva-web-frontend/docs/ai-agent/`)只保留编码编码文件 必须在与来源相同的会话中更新: `code-map.md` (文件地图), `ownership.md` (决定日志), `capabilities.md` (与平台 eval 相绑) 身份证 当FE变换时,将参考文献重新同步到这里.
实时测试产生日期不符的报告 **正在测试代码** ——平台 届会 `corva-web-frontend/ai-tests/runs/`,每个应用程序的会话 `{app}/ai-tests/runs/` 证据记录,不是参考文件,也不是本游戏本.
## 验证
在考虑修改之前, 请运行闸门( 非零出站为硬站 ):
```bash
yarn verify # package + playbook + review-gate + diff gates
```
单个命令仍记录在 [脚本/README.md](https://npmcn.com/package/%40corva/fe-ai-tools/scripts/README.md)。 。 。 . 为核实特定的承诺范围,运行 `CHECK_RANGE=base...head yarn verify`。 。 。 .
变动 `plans/features|bugs|testing/` 也需要同一场会 [计划/更改日志.md](https://npmcn.com/package/%40corva/fe-ai-tools/plans/changelog.md) 条目命名每个被触碰的区域—— 游戏本门执行它.
## 常见问题
### @corva/fe-ai-tools 是什么？
询问 Corva app-tools 工具包:结果构建器,创建Toolset,注册/eval hooks,并为 Corva 平台和 Dev Center FE apps 键入可显示 AI 工具的参数阅读器\.
### 如何安装 @corva/fe-ai-tools？
在项目目录运行 npm install @corva/fe-ai-tools，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：react（\>=16\.8）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。它还提供命令行工具 fe-ai-tools，可以用 npx fe-ai-tools 直接运行。
### @corva/fe-ai-tools 支持 TypeScript 吗？
支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。
### @corva/fe-ai-tools 支持 ESM 还是 CommonJS？
同时提供 ES Module 与 CommonJS 入口，import 和 require\(\) 都可以使用，打包工具会自动选择合适的版本。
### @corva/fe-ai-tools 需要什么版本的 Node\.js？
package\.json 的 engines 字段要求 Node\.js \>=20。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。
### @corva/fe-ai-tools 可以商用吗？
@corva/fe-ai-tools 使用 UNLICENSED 许可。作者声明为 UNLICENSED，即不授予公开使用许可（与公共领域的 Unlicense 不同）。使用前需获得作者授权。以上为概括，不构成法律意见，请以许可原文为准。
### @corva/fe-ai-tools 的下载量有多少？
根据 npm 官方下载统计，@corva/fe-ai-tools 在 2026/10/11 – 2026/11/09 这 30 天内被下载 7,584 次，日均约 253 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。
### @corva/fe-ai-tools 还在维护吗？
最新版本 1\.9\.0 发布于 2026/08/31（2 个月前）；至今共发布 13 个版本，其中过去 12 个月发布了 13 个；首次发布于 2026/06/23。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。