@lernapps/tooling

中文文档
0.1.1发布于 2026/11/01MITTypeScriptES Module构建来源已验证

lernapps.net应用和站点的共享工具:CLI lernapps,站点操作,更新预设,构建应用的指导;文档在 https://lernapps.net/tooling/

中文使用文档
文档目录6 节
  1. 是给谁的?
  2. 从哪里开始
  3. 里面有什么?
  4. 贡献
  5. 链接
  6. 许可证

工具

开发者和他们的人工智能助手开发学习应用的工具 lernapps.net:一个在浏览器中运行的应用程序,不收集任何内容,可访问,并且是 几分钟内就会在应用概述中列出。开发者在他们自己的地址发布应用,默认是他们自己的地址 GitHub页;一旦列出,lerapps.net就会提供它的一个副本 lernapps.net/apps/start/<id>/.

该工具负责帮助开发者发布他们的应用程序。这个 应用程序概述 解释构建和列表,并提供应用程序本身:目录。

repo还保留了平台的维护功能,创建者不会使用这些功能:检查、发布和预览 lerapps.net自己的网站,以及依赖项的更新策略。

是给谁的?

  • 创作者和他们的助手 开发者不需要开发技能;助理 遵循指导和检查。
  • 平台所有者和审核代理他们会决定一个应用程序是否被列入名单。
  • lernapps仓库的维护者他们改变了规则、检查和指导。

从哪里开始

  • 创造者: lernapps.net/apps/build/ 告诉你的助理该怎么说。
  • 助理: 读 lernapps.net/tooling/llms.txt. 它开始构建 使用计划模板。
  • 这个 技能: 每个阶段一个,按他们持有的东西分组: process/, tooling/, content/, archetypes/。这个 平台的规则 每个应用都保持, 不管它是怎么建造的。
  • 这个 计划模板: 一个应用程序第一个版本的整个工作流程,从第一个 关于清单的问题。它在需要的步骤中命名每个技能。之后的每一次变化都遵循 增加模板它有自己的计划。
  • 这个 体系结构: 每个部分负责什么以及为什么。
  • 这个 规则目录: 每个规则都有id,以及它被告知和检查的位置。

里面有什么?

  • 包 @lernapps/tooling,在 npm (从CI发布,并注明出处) .github/workflows/release.yml):指导、技能、共享预设 并检查每个应用程序和CLI的规则。
  • CLI lernapps: init 在一个空文件夹中启动一个应用程序的计划,并将包的技能同步到代理目录中, skills --archetype 加上选中的原型, create 一旦创作者确认了这个计划,就为原型编写一个新的应用程序, check 在git钩子和CI中以同样的方式检查应用, update 将应用程序移动到最新的运行时和工具版本 工具和替换应用程序的 lernapps-* 使用该工具的技能(以及旧应用程序的单一计划) .vibe/plans/), changes 说明更改会影响什么,以便钩子和CI只运行该更改, screenshots 为构建的解释器或测验的每一页和每一个图形写一个图像,向创造者展示学习者所看到的(npx lernapps screenshots --help)。 npx --yes @lernapps/tooling --help 在应用出现之前, npx lernapps --help 在一个。
  • 中的动作 actions/: 应用程序检查,应用程序发布和应用程序预览的行动,每个应用程序和网站 lerapps.net自己的网站被检查、发布和预览的操作。每个人都说了自己的职责 action.yml. 可重用工作流 changes.yml 为其他工作流提供 更改范围,其注释显示了所需的支票如何永远不会停留在“Pending”状态。
  • 这个 文档网站: 体系结构,规则目录,发布的 模式和 llms.txt.
  • 审查 在 review/:代理在应用程序上市前对其进行审查的程序和规则。
  • 刷新预设 default.json,每个learnapps的仓库都扩展了它。

细节存在于您使用它们的地方:每个命令的帮助,每个操作的描述,错误消息, 以及代码中的注释。

贡献

npm ci,然后 npm run check 运行与CI完全相同。当push不改变代码时,pre-push钩子运行一个快速子集。

许可证

麻省理工学院

版本与发布记录

@lernapps/tooling 共发布 4 个版本,首次发布于 2026/11/01;过去 12 个月发布了 4 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
0.1.1latest2026/11/011 天前
0.1.02026/11/011 天前
0.0.12026/11/012 天前
0.0.0-stage2026/11/012 天前

关于 @lernapps/tooling 的常见问题

@lernapps/tooling 是什么?

lernapps.net应用和站点的共享工具:CLI lernapps,站点操作,更新预设,构建应用的指导;文档在 https://lernapps.net/tooling/

如何安装 @lernapps/tooling?

在项目目录运行 npm install @lernapps/tooling,或使用 pnpm add / yarn add / bun add。它还提供命令行工具 lernapps,可以用 npx lernapps 直接运行。

@lernapps/tooling 支持 TypeScript 吗?

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

@lernapps/tooling 支持 ESM 还是 CommonJS?

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

@lernapps/tooling 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js ^22.18.0 || ^24.11.0 || >=26.0.0。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

@lernapps/tooling 可以商用吗?

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

@lernapps/tooling 还在维护吗?

最新版本 0.1.1 发布于 2026/11/01(1 天前);至今共发布 4 个版本,其中过去 12 个月发布了 4 个;首次发布于 2026/11/01。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。