# @adelie/requirements-box 中文文档

规范地址：https://npmcn.com/package/%40adelie/requirements-box/

版本：0\.6\.5
npm 元数据更新时间：2026-11-07T02:01:03.460Z
中文译文更新时间：2026-11-06T16:10:25.744Z
软件包许可：Apache-2\.0

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

原始 npm 页面：https://www.npmjs.com/package/%40adelie/requirements-box
原文对照：https://npmcn.com/package/%40adelie/requirements-box/?lang=original
源码仓库：https://github.com/lmliheng/Adelie

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

- 包体积（解压后）：140 kB，12 个文件
- TypeScript 类型：未声明
- 运行依赖：0 个
- 首次发布：2026-10-17T01:12:04.710Z
- 最新版本发布：2026-11-07T02:01:03.267Z
- 近 30 天下载量：2768（2026-10-05 至 2026-11-03，npm 官方下载统计）
- 已发布版本数：19（近 12 个月 19 个）

## 中文简介

一个要求框:一个键入的页面,用户在其中文件他们想要做什么,一个预定的任务,唤醒代理通过它们工作,以及一个每轮的邮件报告——服务是一个单一的无依赖的节点文件,有一个JSON商店和一个键入的AP

## 安装

```sh
npm install @adelie/requirements-box
```

也可以使用：`pnpm add @adelie/requirements-box`、`yarn add @adelie/requirements-box`、`bun add @adelie/requirements-box`

## README

# 请求框

A 类 **需求框**: 用户写下自己想要做的事情的一页, 预定的任务唤醒 代理通过它工作, 和每发邮件报告 - 所以要求的东西 不花费 对话,他们之间不会失去任何东西.

```
user files a request on the page
        │
        ├─ status=new … the page keeps it, the schedule waits
        ▼
every <period> the agent wakes, reads the list, marks each item doing, and works through up to three
        │
        ├─ done      → committed, gated, shipped; item archived, one mail per round
        ├─ blocked   → the question it could not answer, mailed to the user
        └─ rejected  → why not, in the same mail
```

## 里面的东西

| 块 | 这是什么 |
| --- | --- |
| `kit/requirements.mjs` | 整个服务:一个有原子写作的JSON商店,有密钥的API(列表/创建/读取/patch,巡逻cadence,和Do-it-现在的触发器),服务于页面. 只有节点标准库——没有建设阶梯,没有依赖树. |
| `kit/requirements.html` | 页面:存档请求,编辑或取出一个,选择几个并进行批量行动,安排一个项目,暂停巡逻或更改其cadence,查看哪些承诺尚未在直播服务器上发布或未发布,以及一个"现在就行动"按钮. |
| `kit/serve.mjs` | 一个单独为盒子服务的独立的服务器,这样它就可以在自己的端口运行,而无需触及机器上已经存在的任何其它东西. |
| `kit/patrol.md` | 协议 预定的回合如下: 工作,在触摸它之前做标记, 分门别类, 船,邮件, 存档—— 和红线. |
| `kit/install.mjs` | 放下文件, 生成密钥, 写 `box.config.json`,写出时间表,并打印出要运行的两个命令. |

## 为什么它存在

-   **问不是谈话.** 用户的自言自语在页面上;代理在唤醒时读取, 当它恰好在听的时候,不是.
-   **一种形式没有依赖树.** 一个节点文件,一个JSON商店 - 没有安装,没有升级, 整个州是一个你可以读取的文件.
-   **时间表是文件,不是黑匣子.** 圆是一 `.toml` 平台重新读取; cadence、 打开/关闭开关,然后按下“现在就做”按钮,所有文件都写上.
-   **你可以看到什么还没有出来.** 页面带有“承诺同步”卡片:上页之后的承诺 释放标签, 显示当前服务器实际运行的内容( 使用它本身的任务) `/api/version`,不读出磁盘, 是否安装了更新但尚未重新启动,且已发布承诺服务器尚未运行 捡起。 四个都来自 `box.config.json` (单位:千美元)`repoDir` 编号 : `serverUrl` 编号 : `serverTokenFile` 编号 : `installDir`, (中文(简体) ), 安装器为您工作; 任何无法工作的东西都会被报告为“ 不配置 ” 没想到 令牌文件会停留在这个过程中,永远无法到达浏览器.
-   **现在做它只是一击.** 等待下一个勾选是常见的投诉,所以页面可以启动一个 对话框,可以仅为用户选择的项目进行.

## 安装

```bash
node <skill dir>/kit/install.mjs --dir ~/requirements-box --workspace ~/my-project --port 3007 --period 2h
```

开始 `node ~/requirements-box/serve.mjs` 并打开已打印的 URL(按键在 `?key=` 一次和一次 页面记得它。 所有机器特异性的生活 在生成 `box.config.json`; 环境 变量覆盖它.

## 页:1

-   关键是能够使特务发挥作用. 它住在这里 `key.txt` (0600),而且绝不能达到犯罪, 日志或邮件.
-   该页面旨在让一个人可以访问,没有发布:绑定 `127.0.0.1` 除非用户要求 更宽广的听, 永远不暴露它没有钥匙.
-   巡逻协议被刻意地放在一个标记下的文件里,用户可以重写——流量是他们要改变的.

## 常见问题

### @adelie/requirements-box 是什么？

一个要求框:一个键入的页面,用户在其中文件他们想要做什么,一个预定的任务,唤醒代理通过它们工作,以及一个每轮的邮件报告——服务是一个单一的无依赖的节点文件,有一个JSON商店和一个键入的AP

### 如何安装 @adelie/requirements-box？

在项目目录运行 npm install @adelie/requirements-box，或使用 pnpm add / yarn add / bun add。

### @adelie/requirements-box 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/adelie\_\_requirements-box 是否存在。

### @adelie/requirements-box 可以商用吗？

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

### @adelie/requirements-box 的下载量有多少？

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

### @adelie/requirements-box 还在维护吗？

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