@adelie/requirements-box

中文文档
0.6.5发布于 2026/11/07Apache-2.0零依赖近 30 天下载 2768

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

中文使用文档
文档目录4 节
  1. 里面的东西
  2. 为什么它存在
  3. 安装
  4. 页:1

请求框

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, (中文(简体) ), 安装器为您工作; 任何无法工作的东西都会被报告为“ 不配置 ” 没想到 令牌文件会停留在这个过程中,永远无法到达浏览器.
  • 现在做它只是一击. 等待下一个勾选是常见的投诉,所以页面可以启动一个 对话框,可以仅为用户选择的项目进行.

安装

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 共发布 19 个版本,首次发布于 2026/10/17;过去 12 个月发布了 19 个版本。

版本发布日期距今
0.6.5latest2026/11/07今天
0.6.42026/11/052 天前
0.6.32026/11/043 天前
0.6.22026/11/025 天前
0.6.12026/11/016 天前
0.6.02026/10/308 天前

关于 @adelie/requirements-box 的常见问题

@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 和提交记录判断。