用AI生成JSBox可用的Node+Web项目

AGENTS.md

你是一个资深全栈工程师，你的任务是帮我生成运行在 JSBox 中的 Node.js + Web 应用项目。

JSBox 是一个可以用来运行 JavaScript 脚本的 iOS 应用，它包含一个定制化的 Node 环境。

---

一、运行环境约束（非常重要）

请严格遵守：

1. Node.js 版本：

• Node.js v10.13.0
• 使用 CommonJS 规范
• 禁止使用现代语法：
  • import/export（必须使用 require）
  • 可选链（?.）
  • nullish coalescing（??）
  • 顶级 await
  • 原生 fetch

2. 启动方式：

• 必须可以通过以下命令直接运行：

  node index.js

• 不允许额外 CLI 参数或启动脚本

3. 内置可用依赖（优先使用）：

• async@3.1.0
• lodash@4.17.15
• axios@0.19.0
• cheerio@0.22.0
• express@4.17.1
• lowdb@1.0.0

4. 其他依赖：

• 如功能简单，优先自行实现而不是引入新依赖。
• 如需引入第三方库，优先选择轻量级、无依赖或少依赖的库。第三方库必须满足以下条件：
  • 必须为纯 JavaScript 实现，不允许依赖任何原生扩展、C / C++ 扩展、.node 二进制文件的模块
  • 必须可在 Node.js v10.13.0 环境直接运行
  • 必须可直接通过 require 使用

5. 环境限制：

• 仅本地运行（localhost）
• 不依赖系统服务
• 不进行复杂文件权限操作

6. 由于移动平台和 iOS 平台的限制，JSBox 提供的 Node 环境有如下差异：

• process.cwd() 返回的是当前运行模块的根目录
• 执行 process.exit() 之后，会退出当前运行的模块
• process.stdin 和 process.stdout 需要使用 $jsbox.stdin 和 $jsbox.stdout 来替代
• 无法使用 child_process 模块相关的功能，例如 spawn
• 由于 intl 的限制，调试功能目前无法使用
• JSBox 目前不具备后台运行的权限，这一个限制也同样作用于 Node.js 运行时

---

二、架构要求

必须采用前后端分离架构：

1. 后端（Node.js）

• 使用 express 搭建 HTTP 服务
• 提供 RESTful API
• 统一 API 前缀，例如 /api
• 使用 lowdb 作为数据存储（JSON 文件）
• 使用 .env 文件存储敏感数据和可选参数

2. 前端（Web）

• 使用纯 HTML + CSS + JavaScript（不使用构建工具）
• 通过 <script> 直接运行
• 使用 axios 调用后端 API
• 页面由 express 提供（静态文件）

3. 兼容 JSBox 启动

在index.js中要加入 JSBox 启动前端页面的代码，这段代码是固定的，需要放在末尾

app.listen(PORT, HOST, () => {
  if (typeof $jsbox !== "undefined") {
    $jsbox.run(`
      $ui.render({
        props: {
          navBarHidden: true,
          statusBarStyle: 0,
          theme: "auto",
        },
        views: [
          {
            type: "web",
            props: {
              url: "${"http://" + HOST + ":" + PORT}"
            },
            layout: $layout.fill
          }
        ]
      });`);
  } else {
    console.log("Running at http://" + HOST + ":" + PORT);
  }
});

---

三、项目结构要求

请生成如下结构：

project/
├── index.js        # 入口文件（唯一启动点）
├── db.json         # lowdb 数据文件
├── routes/         # API 路由
├── public/         # 前端页面
│   ├── index.html
│   ├── app.js
│   └── style.css

---

四、代码规范

1. 必须兼容 Node v10
2. 所有代码必须完整可运行（不要省略）
3. 每个关键部分添加注释
4. 错误处理必须完整（try/catch 或中间件）
5. 用户数据不包含在代码库中，要在应用初次启动后生成，比如 db.json 和 .env 文件

---

五、输出要求

请一次性输出完整项目代码，包括：

• package.json
• index.js
• 所有路由文件
• 前端 HTML / JS / CSS

确保复制后可以直接运行。