# @alisio/plugin-evalua 中文文档

规范地址：https://npmcn.com/package/%40alisio/plugin-evalua/

版本：0\.10\.0
npm 元数据更新时间：2026-10-15T01:57:10.246Z
中文译文更新时间：2026-11-06T12:18:51.262Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40alisio/plugin-evalua
原文对照：https://npmcn.com/package/%40alisio/plugin-evalua/?lang=original
项目主页：https://github.com/GustavoGutierrez/alisio-plugins/tree/main/packages/plugin-evalua#readme
源码仓库：https://github.com/GustavoGutierrez/alisio-plugins

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

- 包体积（解压后）：2.4 MB，404 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- Node.js 要求：\>=22\.16
- 运行依赖：1 个
- peer 依赖：@alisio/sdk ^0\.8\.0
- 首次发布：2026-10-07T02:57:44.289Z
- 最新版本发布：2026-10-15T01:57:09.984Z
- 近 30 天下载量：3225（2026-10-06 至 2026-11-04，npm 官方下载统计）
- 已发布版本数：20（近 12 个月 20 个）

## 中文简介

指导教师进行短期面试,并保留教师简介、工作空间和考试编号,以便进行可打印的学校数学考试.

## 安装

```sh
npm install @alisio/plugin-evalua
```

也可以使用：`pnpm add @alisio/plugin-evalua`、`yarn add @alisio/plugin-evalua`、`bun add @alisio/plugin-evalua`

## README

![Evalúa](https://npmcn.com/package/%40alisio/plugin-evalua/cover.webp)

# @alisio/plugin-evala (英语)

> 读这个 [西班牙语](https://npmcn.com/package/%40alisio/plugin-evalua/README.es.md)。两个读取母系统保持同步,必须一起更新.

Evalúa通过一次简短、有指导的面试,帮助教师准备可打印的学校数学考试 解答和分心器通过代码和网页预算来计算,从不猜测.

> 状态: v1 特性完成 。 简介、工作空间和访谈、准确的数学核心、 可扩展的知识库、项目生成和核查以及端到端流动(Gate A-) 以 HTML 和 PDF 键写这四份文件 测试.

## 快速路径

坚持通过Alisio安装:

```bash
alisio install npm:@alisio/plugin-evalua
```

安装特定版本,或将已安装的插件更新到特定版本 :

```bash
alisio install npm:@alisio/plugin-evalua@0.2.1
alisio install npm:@alisio/plugin-evalua@0.2.1 --update
```

`alisio install --update` (没有规格)刷新每个已安装的插件 .

项目-地方发展:

```bash
npm install --save-dev @alisio/plugin-evalua
alisio --plugin @alisio/plugin-evalua
```

需要22.16个节点或更新 `@alisio/sdk` `>=0.3.0 <0.7.0`。 。 。 .

## 怎样用

与协调员交谈;从语言开始,然后是机构、教师和 可选标识,并创建苍蝇上的工作空间。 然后,它要求考试 三短 轮回 A出道前,没有东西被写入磁盘,老师同意.

![Usage flow: from /evalua:new through the three interview rounds and Gate A to the generated items and the PDFs](https://npmcn.com/package/%40alisio/plugin-evalua/assets/usage-flow.svg)

专访只问其不知道的:

| 回合 | 问 题 |
| --- | --- |
| 简介(一次) | 语言、机构、教师姓名、可选标志 |
| 1 - 何为 | 专题(对知识库的建议)、级别、级别(básico/intermedio/avanzado/genio)、知识库 |
| 2\. 形状 | 项类型(多选择),题数,相同的考试或银行,列 |
| 2b——仅存银行 | 银行规模,变体数量 |
| 3 — 平面和语气 | 页数限制( 西侧可读, 1, 2 或您输入的号码), 时间和仪器, 关闭文本 |

您也可以运行它无头: 未决回合存储在工作空间状态中, 您继续 与 `/evalua:new id=value ...` (免费文本输入) `<id>:text=...`) (中文(简体) ).

### 如何产生和审查考试

蓝图为专题×认知需求×项目类型表. 候选人来自该项目 首先,然后从静态的银行物品, 每一个候选人通过代码验证 之前它是 被冻结; 失败的候选人会被重新绘制( 范围) , 无法填入的空档被报告 .

![Generation and review pipeline](https://npmcn.com/package/%40alisio/plugin-evalua/assets/review-pipeline.svg)

## 探员

`evl-coordinator` 主持采访和门 以平庸的口语, 并调用工具。 从来没有 作者一个数学答案: 家庭,解析者和目录是真理的来源. 授权项目由 `evl-math-reviewer` (只读)和 `evl-language-reviewer` (只读;审查者从未看到作者的推理.

![Agent flow](https://npmcn.com/package/%40alisio/plugin-evalua/assets/agent-flow.svg)

## 命令和工具

| 命令 | 它会做什么 |
| --- | --- |
| `/evalua:init [dir] [--edit]` | 创建工作空间( 默认文件夹) `evalua/`)并问师生简介一回. |
| `/evalua:new [topic]` | 主持考试面试,并保留草稿至A口. |
| `/evalua:status` | 显示配置文件、任何待定回合、草稿和考试文件夹. |
| `/evalua:approve a|b` | A门分配考试文件夹并冻结 `exam.yaml`; B口批准最终包. |
| `/evalua:generate` | 绘制蓝图、生成和核实物品并冻结 `items.json`。 。 。 . |
| `/evalua:build` | 读取批准的文件夹,符合页面预算,并写出考试,答题表,解析书和标注为HTML和PDF. |
| `/evalua:kb` | 列出知识库:包,题和层次. |
| `/evalua:doctor` | 报告知识库的健康和可用的打印浏览器. |

代理工具 : `evalua_profile`, (中文(简体) ), `evalua_answer`, (中文(简体) ), `evalua_status`, (中文(简体) ), `evalua_kb`, (中文(简体) ), `evalua_check`, (中文(简体) ), `evalua_exam`, (中文(简体) ), `evalua_generate` 财务报告和审定财务报表 `evalua_build`。 。 。 .

独立的 CLI :

```sh
alisio-evalua check    # the EVL-KB-* report
alisio-evalua kb       # packs, topics and levels as JSON
alisio-evalua doctor   # knowledge health and the print browser
```

## 如何运作

-   **准确的数学.** 答案和分心器来自精确合理的算术(BigInt分数)和 微小多变量理性多名类型;随机是被种子的xoshiro128\*\*,所以同一考试 总是以相同的顺序重建同样的问题.
-   **广泛的知识基础.** 版本的 YAML 包声明主题、 级别校正和来源 (项目家庭或固定银行项目)。 一个工作空间包 `<root>/knowledge-packs/` 扩展或 覆盖一个未更改代码的已发送的 。 装载器执行 `EVL-KB-001..007`。 。 。 .
-   **项目生成和核查.** 一个决定性的蓝图驱动来自家庭的候选人 然后是银行,有一条有界限的重划回路、去重复和稳定的参考; `EVL-ITM-*` 财务报告和审定财务报表 `EVL-EXM-*` 检查检查结果.
-   **发相并相.** 键入的文档模型输入自定义的 HTML 发送器( 服务器侧) KaTeX 内含,无网络)和克罗梅-家庭 `printToPDF`; 密度梯度测量真实页面 计算和选择符合预算的最清晰的预设,但显然失败 `EVL-LAY-001` 当它不能。 一页内审计检查 横向溢出,相重叠的框, 下层文字,公式合适并回答空格(`EVL-LAY-002`, (中文(简体) ), `EVL-LAY-004`) (中文(简体) ).
-   **数字.** 决定性, 灰度的 SVG 数字由代码生成并嵌入到项目中 通过a `figure` 块: Venn/ sets 图表、笛卡尔平面、三角形、正方形、矩形、, 常规多边形、圆形、椭圆形、棱柱形、圆柱形、圆锥形、数字行、分数条、条 图表和角度。 一个问题可以显示一个没有外部资产和网络的图.
-   **主题.** 3个由数据驱动的主题船(B`classic`, (中文(简体) ), `blue`, (中文(简体) ), `dark`,由 `exam.yaml.template` 并可从 `templates/themes/<id>/`。 。 。 .
-   **闭幕词.** 来源目录(出名的引文和公有领域Reina-Valera 1909节) 外加一个工作空间为老师提供的文本引用层;没有从内存中写入任何内容.

## 打印浏览器

PDFs需要Chromium相容的浏览器;没有被下载. 检测接受Google Chrome, Chromium, Brave, Microsoft Edge, Vivaldi and Opera on Linux, macOS and Windows, 荣誉 `ALISIO_EVALUA_CHROME`, (中文(简体) ), `PUPPETEER_EXECUTABLE_PATH` 财务报告和审定财务报表 `CHROME_PATH`。没有浏览器,构建 仍然写自成一体的 KaTeX 类型集 HTML 文件, 并报告页数限制不是 经核实.

## 工作空间布局

```
<workspace>/
  .alisio/evalua/state.json     machine-owned state (atomic writes)
  evalua/
    teacher.yaml                teacher profile, safe to edit by hand
    assets/logo.png             optional logo (PNG, JPEG or WebP, up to 2 MB; SVG is rejected)
    knowledge-packs/            optional workspace packs (extend or override the shipped ones)
    quotes/                     optional teacher closing texts
    exams/NN-slug/              created only after the teacher approves the exam spec
```

考试数字是连续的,永远不会被再使用,即使一个文件夹被手工删除.

## 配置字段

`teacherName`, (中文(简体) ), `institution` (打印大写),可选 `logo`, (中文(简体) ), `subject` (默认) 马特马蒂卡斯, `language` (默认) `es`和 `paper` (单位:千美元)`letter` 或者说 `a4`默认值 `letter`) (中文(简体) ).

## 许可证

麻省理工学院. 销售商KaTeX是麻省理工学院;见 `THIRD_PARTY_NOTICES.md`。 。 。 .

## 常见问题

### @alisio/plugin-evalua 是什么？

指导教师进行短期面试,并保留教师简介、工作空间和考试编号,以便进行可打印的学校数学考试\.

### 如何安装 @alisio/plugin-evalua？

在项目目录运行 npm install @alisio/plugin-evalua，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：@alisio/sdk（^0\.8\.0）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。它还提供命令行工具 alisio-evalua，可以用 npx alisio-evalua 直接运行。

### @alisio/plugin-evalua 支持 TypeScript 吗？

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

### @alisio/plugin-evalua 支持 ESM 还是 CommonJS？

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

### @alisio/plugin-evalua 需要什么版本的 Node\.js？

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

### @alisio/plugin-evalua 可以商用吗？

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

### @alisio/plugin-evalua 的下载量有多少？

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

### @alisio/plugin-evalua 还在维护吗？

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