# @christianirack/brainllm 中文文档

规范地址：https://npmcn.com/package/%40christianirack/brainllm/

版本：0\.10\.6
npm 元数据更新时间：2026-11-09T16:53:32.234Z
中文译文更新时间：2026-11-09T16:55:07.678Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40christianirack/brainllm
原文对照：https://npmcn.com/package/%40christianirack/brainllm/?lang=original
项目主页：https://chrisifm.github.io/BRAINLLM/
源码仓库：https://github.com/chrisifm/BRAINLLM

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

- 包体积（解压后）：80.6 kB，6 个文件
- TypeScript 类型：未声明
- Node.js 要求：\>=22
- 运行依赖：0 个
- 首次发布：2026-10-28T22:55:28.873Z
- 最新版本发布：2026-11-09T16:53:31.913Z
- 近 30 天下载量：5175（2026-10-10 至 2026-11-08，npm 官方下载统计）
- 已发布版本数：26（近 12 个月 26 个）

## 中文简介

BRAINLLM:一款由 Rust 驱动的前端和全高架网络编译器. 优化了JavaScript,SSR,SEO准备的静态站点,一个PostgreSQL后端和用于LLM和AI代理的MCP工具.

## 安装

```sh
npm install @christianirack/brainllm
```

也可以使用：`pnpm add @christianirack/brainllm`、`yarn add @christianirack/brainllm`、`bun add @christianirack/brainllm`

## README

![BRAINLLM brain mark](https://raw.githubusercontent.com/chrisifm/BRAINLLM/v0.10.6/docs/site/assets/logo.png)

# 蓝宝石

### LLMs的网络编译器,由Rust所建. 烧快.

**你的LLM拥有前端。 给它一种为工作而建的语言.**

> **以 Rust 写成, 从 parser 到 marifier .** 一个本地二进制, 没有工具链可以安装 。 温暖生产建筑 内 **~34 ms( 宽度)**关于 **4.5× 速度快于反应 + Vite** 打开 [我们的开放式基准](https://npmcn.com/package/%40christianirack/brainllm/#readme-show-me-the-numbers)。 。 。 .

![Built with Rust](https://img.shields.io/badge/built%20with-Rust-dea584?logo=rust&logoColor=white) [![Website](https://img.shields.io/badge/website-chrisifm.github.io%2FBRAINLLM-0071e3)](https://chrisifm.github.io/BRAINLLM/) [![npm version](https://img.shields.io/npm/v/@christianirack/brainllm?color=cb3837)](https://www.npmjs.com/package/@christianirack/brainllm) [![License](https://img.shields.io/github/license/chrisifm/BRAINLLM)](https://github.com/chrisifm/BRAINLLM/blob/v0.10.6/LICENSE)

[![BRAINLLM — The web compiler for LLMs. Open the website: chrisifm.github.io/BRAINLLM](https://raw.githubusercontent.com/chrisifm/BRAINLLM/v0.10.6/docs/site/assets/cover.png)](https://chrisifm.github.io/BRAINLLM/)

**🌐 [(原始内容存档于2013-10-12). chrisifm.github.io/BRAINLLM](https://chrisifm.github.io/BRAINLLM/)**

BRAINLLM 给编码代理一个紧凑的语言,一个单一的规格和一个用 Rust 写的本地编译器 告诉他们如何纠正错误。 模型构建了前端. 你确定方向,检查结果,然后决定 什么飞船.

`.brain` 组件编译为直接-DOM JavaScript和范围化的 CSS. Rust工具链 处理解析,检查, 代码生成、捆绑和分解。 该代理可以通过CLI或MCP操作.

**以所积相. 让你的LLM更好.** 每次运行都是发现编译器错误的机会,一个昂贵的步骤或 一个混乱的诊断。 代理商可以把发现变成一个经过测试的建议,在配置时,按下它 自动到审查处。 维护者决定合并什么.

## 用于安全修改代码的代理

BRAINLLM不是另一个反应,下一个或节点,它不会试图替换它们. 它的目的是成为第一个 自改进 LLMS 的编译器 : 当代理器击中编译器缺口时, `scripts/evolve.mjs` 把它变成一个孤立的, 被测试的建议书,由一个人决定是否上船. 无变化会自行合并 。 下面的每个要求都是可以命令的 运行; 数字在 [基准](https://npmcn.com/package/%40christianirack/brainllm/#readme-show-me-the-numbers)其他堆栈作为高级分析出售的工具是: 这里的基线 :

-   **定位不读.** `brain map`, (中文(简体) ), `brain card`, (中文(简体) ), `brain graph`, (中文(简体) ), `brain context` 符号搜索给出 代理合同 以及它必须接触的确切位置 永远不要2000行文件.
-   **每次编辑前都测出风险.** `brain risk <target>` 返回决定性的分数,其背后的因素 (附属单位、路线、公共合同、后端计划、覆盖测试、SEO/i18n/a11y、预算室) 检查可以证明编辑安全 .
-   **原子变化.** 租借、修改、检查的更改ets 在私人快照上验证整个应用程序 写作和干净地恢复; 拒绝 steal review,而不是翻写另一个代理的作品.
-   **开发时实时证据.** 汇编反馈,每个保存(诊断和每个视图的字节), 运行时间错误映射到 `.brain` 线条 内存和漏出检查 超过CLI和MCP.

**[访问现场](https://chrisifm.github.io/BRAINLLM/)** • 妇女 **[构建您的第一个应用程序](https://npmcn.com/package/%40christianirack/brainllm/#readme-give-your-agent-its-first-task)** • 妇女 **[读取光谱](https://github.com/chrisifm/BRAINLLM/blob/v0.10.6/SPEC.md)** • 妇女 **[见基准](https://npmcn.com/package/%40christianirack/brainllm/#readme-show-me-the-numbers)** • 妇女 **[贡献](https://npmcn.com/package/%40christianirack/brainllm/#readme-build-the-tool-your-agent-needs)**

## 带有模型的前端语言

一个写你的应用软件的代理人需要一份合同,它可以遵循,反馈也可以采取行动. BRAINLLM 使循环 清晰:读取 spec,生成一个组件,检查,应用固定,测试结果.

![An agent reads the BRAINLLM contract, writes a component and uses compiler feedback to validate the app](https://github.com/chrisifm/BRAINLLM/raw/v0.10.6/docs/site/assets/agent-loop.png)

-   **少来猜想.** `brain spec` 定义支持的语言。 一个组成部分格式,一个规定的项目 结构和发电机使模型在已知的合同内运作.
-   **反馈可以使用.** 诊断包括文件、地点、规则和拟议修正。 机械修理 精确替换编辑; `brain fix` 应用它们。 代理人仍然可以看到需要判断的决定.
-   **整个循环的工具.** `brain map --json`, (中文(简体) ), `brain check --json`, (中文(简体) ), `brain doctor` 财务报告和审定财务报表 `brain build` 让 代理人检查、验证和汇编其工作. `brain mcp` 暴露工具超过stdio.
-   **为浏览器输出 .** 信号更新受影响的 DOM 节点. 工具链包括自己的编译器, 捆绑和变压器,没有维特,网络包装, 建造或 Babel 在建设管道.

BrainScript基于HTML,CSS和JavaScript的受限子集. 它旨在减少选择 代理在保存开发者可以读取和审查的代码的同时,必须重建.

## 你的经纪人有什么工作

| 能力 | 它对应用建设循环的作用 |
| --- | --- |
| 服务语文合同 | `brain spec` 向模型提供已执行的语法和公约 |
| 任务播放本 | `brain guide <topic>` (亦为MCP) `brain_guide`:步骤,检查,常见错误和每个任务的一个实例(视图,数据,表格,服务器,SIO,可访问性,WebMCP,测试,i18n,性能) |
| 构成部分和反应状态 | `.brain` 文件结合了标记、大脑脚本和范围化样式; `sig`, (中文(简体) ), `drv` 财务报告和审定财务报表 `fx` 快速更新 |
| 表格和数据 | 格式验证、 HTTP 资源和服务器合同给常见的应用行为一个有文件记录的路径 |
| 路线和布局 | 视图、布局、装载器和警卫将导航和出入检查放入项目结构 |
| 诊断和维修 | JSON 诊断可以识别失败; 支持的机械编辑可以用 `brain fix` |
| A. 背景和自动化 | 项目地图、重点读取、CLI和MCP工具允许代理检查和操作应用程序 |
| 核查和交付 | 测试, `brain doctor` 和生产建设使验证成为工作流程的一部分 |
| 经测试的编译器改进 | 孤立的建议、验证闸门和可选审查处的推让代理人提供补救 |

使用 [SPEC.md 高频](https://github.com/chrisifm/BRAINLLM/blob/v0.10.6/SPEC.md),服务 `brain spec` 财务报告和审定财务报表 [变相.md](https://github.com/chrisifm/BRAINLLM/blob/v0.10.6/docs/EVOLUTION.md) 确切的合同和限制.

## 在前端堆栈中适合的地方

这些工具占据了不同的地层. 这是对它们角色的比较,而不是通用速度排名. 链接 项目文档描述了每个工具;BRAINLLM一栏解释了该项目做出的选择.

| 项目 | 主要作用 | BRAINLLM如何接近这部分工作 |
| --- | --- | --: |
| [反应](https://react.dev/) | 基于组件的用户界面库 | 专用组件语言、编译器和代理工作流程 |
| [角质](https://angular.dev/overview) | 具有综合工具的网络应用框架 | 围绕LLM 作者制构建的受限语言和规范规格 |
| [阴道](https://vuejs.org/guide/introduction.html) | 声明式、反应式接口的渐进框架 | 限定组件语法和结构,并配有编译器-制导修复 |
| [天体](https://docs.astro.build/en/concepts/why-astro/) | 网站框架侧重于内容驱动的网站和岛屿 | 代理代理前端的语言和工具链,有自己的渲染合同 |
| [维特](https://vite.dev/guide/) | 开发服务器和生产制造工具 | 综合管线 `.brain` 应用程序 |
| [网络软件包](https://webpack.js.org/concepts/) | 装有加载器和插件的模块捆绑器 | 作为编译器管道的一部分,它自己的捆绑和修饰器 |
| **蓝宝石** | **前端语言、编译器、运行时间和代理合同** | **模型在一个记录的工作流程内写、检查和改进** |

其他项目也提供大赦国际的指导和工具。 BRAINLLM的强调是写作合同本身. 没错 不运行已有的React, Angular 或 Vue 组件不变, 仅替换一个构建工具不是迁移 . 下文的数字比较仅涵盖测量的React/Vite和Svelte/Vite固定建筑.

## 形式不需要生态系统.

你的经纪人来按键了 你的堆交了个委员会.

如果设置决定耗用会话时间,则给模型一个有明确合同的工具链.

BRAINLLM将组件语法,状态,形式,路由和编译器反馈带入一个被记录的工作流程. 内容 Rust工具链拥有构建管道,浏览器运行时间没有第三方依赖性. 开始于 您需要的网络行为; 给代理商一套较小的常规来学习和检查 .

**少取工具来. 更多网络.**

## 给我看数字

**别相信头条 运行基准.**

如果你更喜欢阅读原始的时机 而不是发布帖子, 这部分是给你的。 检查固定,复制 运行和保持结果 即使它不同意我们的.

**七叠相. 同样的仪表盘工作流程。 140个测量建筑.**

| 温暖生产建筑 | 中线,20跑 | 标准偏差 |
| --- | --- | --: |
| 蓝宝石 | 34.32分钟 | 13.23分钟 |
| 反应 + Vite | 155.49分钟 | 16.71 毫秒 |
| Vue + 维特 | 211.76分钟 | 53.56 毫秒(每秒) |
| 斯维尔特+维特 | 243.53 ms (英语) | 56.14毫秒 |
| 天体+ 反应岛 | 504.78 ms (单位:千米) | 77.45 分钟 |
| 角 CLI 函数 | 1,262.50毫秒(分钟) | 69.03毫秒 |
| 反应+网络包装 | 1 334.54 分钟 | 560.99分钟 |

所有7个执行都通过了相同的9个Chrome交互检查,包括创建,搜索,编辑和删除. 这些测量使用被冻结的 BRAINLLM 源 `7889787`,苹果M5,装有24个GiB RAM,节点26.12.0和每台2个取暖器 堆栈。 Builds在共享机器上连续运行. 差异事项:检查原始样品,特别是网页包装. 产出战略不同(包括安全部门改革、客户渲染和Astro React岛);这一比较措施 生产时间是固定的,而不是通用的应用性能或特性等同.

读取 [扩大的方法、版本、有效载荷和结果](https://github.com/chrisifm/BRAINLLM/blob/v0.10.6/bench/build/expanded.md)原三层 [历史成果](https://github.com/chrisifm/BRAINLLM/blob/v0.10.6/bench/build/results/summary.md) 保持不变。 使用 `bench/build/expanded.mjs` 与记录的被冻结的二进制和抓取指令设置 复制这七层跑道.

**请您的代理对结果提出质疑 :**

```text
Reproduce BRAINLLM's build benchmark and tell me what the evidence supports.
First inspect bench/build/README.md, bench/build/run.sh, the frozen fixture,
the React/Svelte reference implementations and their pinned dependencies.
Explain the output differences and required tools before running anything.

Run bench/build/run.sh in an isolated workspace using its documented settings.
Keep the compared fixture implementations unchanged. Record the compiler hash,
tool versions, hardware, machine load, warmups and sample count. Preserve the
raw timings and report cold and warm medians in ms, plus the measured HTML,
CSS and JavaScript payload in KiB gzip with every excluded asset identified.

Compare the local results with the checked-in results. Report failures,
limitations and regressions as observed. Do not claim a win unless the actual
numbers support it. Do not upload results or publish anything automatically.
Clean up only the temporary resources this run created.
```

一个单独的 [缓存键微基准](https://github.com/chrisifm/BRAINLLM/blob/v0.10.6/bench/build/results/compiler-cache-lookup.json) 测量 **43.3×快键 查询** 删除一个不必要的解析后: 1万个1 050字节输入的查看。 这个数字测量 只有内部操作。 这不是一个全面建设的速度或一个网络包的比较.

这个 [基准报告](https://github.com/chrisifm/BRAINLLM/blob/v0.10.6/bench/REPORT.md) 还跟踪代理生成的应用程序、浏览器行为、有效载荷大小和 失败恢复。 历史LLM结果描述其被冻结的模型/谱/编译器运行;它们不保证 表示新的即时或编译器修订将会通过。 这个项目向希望 调查语言设计和编译器反馈如何影响代理行为. 带个假说和复制人来.

编译器管道用Rust来写. 浏览器自动化通过 CDP 驱动真正的 Chrome 用于交互和 回归检查。 这些检查可以确定它们所操作的流程;它们并不意味着通用浏览器或应用程序 兼容性。 存储器记录的LLM评价确定了模型,任务和被冻结的修订,以便您检查 每一个结果都证明了什么.

## 任务完成的代理工具

| 探员需要.. | 编译器提供.. |
| --- | --- |
| 以一致文件开始 | 用于查看、组件、频道、服务、输入的API、计划、路由守卫和服务器模块的生成器 |
| 不猜测进口的重构 | 检查过 AST 编辑道具、组件文件重命名、移动和提取 |
| 检查它建造的东西 | Chrome 截图、无障碍框架和清晰的视觉基线比较 |
| 保持小路线 | 已执行 `viewKB` jS + CSS + HTML 的预算 |
| 推迟可选 UI | 可见、闲置或键盘可访问的交互加载; 同步图像解码 |
| 修复和核实 | `brain doctor --fix` 在全部质量检查前应用机械编辑 |
| 让您尝试生产输出 | 当地临时人员 `brain preview` 有自有进程清理的服务器 |

浏览器工具和预览主管目前需要macOS或Linux. 屏幕截图基线需要稳定的浏览器, 字体和应用程序数据输入。 运行时间挂载/堆积预算仍计划;编译器拒绝这些设置 而不是假装测量它们。 见 [已执行合同](https://github.com/chrisifm/BRAINLLM/blob/v0.10.6/SPEC.md) 财务报告和审定财务报表 [工具内部](https://github.com/chrisifm/BRAINLLM/blob/v0.10.6/docs/INTERNALS.md)。 。 。 .

## 让你的经纪人完成第一个任务

**连接您的编码代理 。 告诉它该建什么 试试应用.**

打开一个可访问您的工程文件和终端的编码代理 。 给它下面的提示和你的产品 简言之。 它可以安装编译器,阅读语言合同,并通过检查工作. 一旦应用程序运行, 尝试实际工作流程,并告诉代理应该改变什么。 你负责产品和什么船.

BRAINLLM的CLI是起点; `brain mcp` 也通过支持MCP的客户端通过stdio连接. 您的代理需要Node 22+和Chrome来进行基于浏览器的macOS或Linux检查. 基特和拉斯特需要稳定 仅在从源代码或贡献创建编译器时。 它应该诚实地报告缺少的先决条件.

**粘贴到您的编码代理 :**

```text
Build a small task app with BRAINLLM: add, complete and delete tasks,
and save them locally. Follow https://github.com/chrisifm/BRAINLLM
for setup. Run the checks and open the app for me.
```

自定义工程扩展代理工作流程

```text
Build my frontend with BRAINLLM.

Product brief: [describe the app, its users and the first useful workflow].

1. Inspect the workspace and available tools. Preserve existing files and secrets.
   Verify Node 22+ and Chrome for browser checks. Create a separate app with
   npm create @christianirack/brainll@latest my-app. If npm is unavailable,
   follow the source-install instructions in the README. Report missing prerequisites.
2. Enter the generated app. Read its AGENTS.md and run npx brain spec.
   Only use implemented features in the served spec; do not invent APIs.
3. Read npx brain map --json. Generate the needed views and components with brain add.
   Implement the first complete user workflow, including loading, empty, error
   and success states. Add meaningful behavior tests.
4. Run npx brain fix, then npx brain check --json. Resolve remaining diagnostics.
   Run npx brain doctor and npx brain build. Exercise the workflow in the browser.
5. Report actual test results, remaining gaps and how to run the app. Stop
   temporary processes and close only browser resources you created.
   Do not publish or deploy without my instruction.

At each completed workflow, look for a concrete compiler defect or measurable
improvement. Read docs/EVOLUTION.md and docs/AGENT-IDEAS.md in the framework repo.
Reproduce it, add a regression test and propose the smallest compatible fix.
Only use automatic contribution when I have explicitly configured it for an
owned fork or authorized review branch. Never weaken checks or merge automatically.
```
最好自己装? 这是命令.

使用公共初始化器( 不需要 npm 账户) :

```sh
npm create @christianirack/brainll@latest my-app
cd my-app
npm run dev
```

`npm create @christianirack/brainllm@latest my-app` 是具有相同行为的语法拼写. 在生成的应用程序内, 使用 `npx brain` 用于 CLI 命令和 `npm run build` 用于生产. 编译器是预建的; Rust 只需要用于下面的源安装.

```sh
git clone https://github.com/chrisifm/BRAINLLM.git
cd BRAINLLM
cargo install --locked --path crates/brain-cli
brain new my-app
cd my-app
brain run
```

对于仅需要普通文件托管的网站:

```sh
brain new my-site --static
cd my-site
brain build --static --site https://example.com
```

将示例源替换为自己的。 上传内容 `dist/`: 预先交付的 HTML, 精密资产和 SEO文件,带有可选的gzip/Brotli副本. 主机上不需要BRAINLLM/Node/Rust服务器. 静态模式拒绝 请求时间服务器特性。 读取 `brain guide static` 用于路径、构建时间数据和托管配置. GitHub 页面, 设置 `staticOutput.host` 改为 `github-pages` 读取 `brain guide github-pages`。编译器属性默认存在;只有明确的用户请求允许顶级 `compilerBranding:false` 删除生成的可见/隐藏签名和编译器链接. 使用 npm- 安装的编译器 `npx brain` 这些命令.

使用已安装的源设备 `brain` 直接命令。 该工作流程不需要 `npm install` 在生成的应用程序中.

货物安装 `brain` 输入其 bin 目录; 确保目录位于您 `PATH`。用 Ctrl+C (英语). 从应用程序目录中运行 `brain doctor` 来验证它 `brain build` 以创建生产产出. 对于 npm 创建的应用程序中的 MCP 客户端, 请使用命令 `npx` 有参数 `["brain", "mcp"]` 及其应用 工作目录。 新应用程序包括 `.mcp.json` 克劳德代码和 `.cursor/mcp.json` 用于光标,加 `CLAUDE.md` 导入 `AGENTS.md`。安装被绑定的依赖,重新启动客户端并验证 `brain_spec` 出现. 客户端信任/核准设置仍然适用;仅配置并不能证明存在连接.

对于已有的应用程序, 请运行 `brain agent setup` 合并本地注册,或 `claude mcp add --scope project brain -- npx --no-install brain mcp` 单独为克洛德代号. `brain agent setup --hooks` 并安装可选 Claude 代码编辑时检查反馈,保留已存在的钩. 钩子检查应用程序之后 `.brain`, (中文(简体) ), `.jsbrain` 财务报告和审定财务报表 `.cssbrain` 编辑;它不运行测试或下载软件包. 使用 `brain mcp --profile minimal` 用于6个核心工具,或 `--profile backend` 资源/工作合同和发电机. 使用源安装, 将注册更改为命令 `brain` 和论点 `["mcp"]`。 。 。 . 其他客户端使用自己的MCP设置. 见 [后端/代理合同](https://github.com/chrisifm/BRAINLLM/blob/v0.10.6/docs/BACKEND.md)。 。 。 .

对于现有的前端,请从 [迁移工作流程](https://github.com/chrisifm/BRAINLLM/blob/v0.10.6/docs/MIGRATION.md)。其只读规划器识别 React, Angular, Vue, Svelte, Next 和 Nuxt 项目. 一次端口一个测试过的路径或组件,保留其 行为和保持回滚路径。 它是一个递增的工作流程,而不是自动转接器.

## 你的经纪人处理的密码

```html
<meta props="start:num=0 label:str='Clicks'">

<script>
  let n = sig(start)
  let dbl = drv(() => n * 2)
</script>

<button on:click={n++}>{label}: {n} × 2 = {dbl}</button>
```

编译器处理信号读写. 当输入值发生变化时, 衍生值更新 。 样式可以生活在 相同的文件,并被扩展到组件。 这个 [服务光谱](https://github.com/chrisifm/BRAINLLM/blob/v0.10.6/SPEC.md) 定义支持的语法.

## 可读之意. 精益浏览器输出.

一个内部函数命名 `back_to_home` 可以在生产中成为简短的标识符。 确切的字母取决于 和模块中的其他名称。 当代理商对代码提出理由时保留有意义的名称; 让 编译器在浏览器接收的内容中缩短符合条件的绑定.

这个例子来自 [修饰器范围回归测试](https://github.com/chrisifm/BRAINLLM/blob/v0.10.6/crates/brain-min/src/mangle.rs)数字 :

```js
// Before
function outer(longName, other) {
  const total = longName + other.value;
  return total + window.x;
}

// After
function a(a,b){const c=a+b.value;return c+window.x}
```

地产名称和外出参考保留其意义. 导出绑定物和其他被保护名称如下 修饰者的保存规则。 来源仍可读取;出产文物获得较小的标识. 这样可以保存输出字节,而不是自动保存 LLM 读取源所用的符号. 降低代理商环境成本 是由语言合同、重点读取和项目地图服务的一个单独的设计目标 测量代理工作流程,然后要求保存符号 .

## 出错应当给代理机下一个动作.

BRAINLLM包括应用循环的几个阶段的保护:

-   **船前:** 编译器检查覆盖了支持的语言规则,可访问性和服务器/客户端边界. 私人环境值属于服务器;客户端访问仅限于 `PUBLIC_` 数值.
-   **在表格中:** schemas定义需要的字段和所支持的类型;服务器字段错误返回到窗体. 该应用程序仍然拥有其业务规则,授权和服务器侧验证.
-   **组件失败时 :** 运行时边界捕获渲染和反应错误,报告并替换 带有倒数的受影响组件。 故障事件处理器在保存组件时报告错误 . 重试被限定:十秒内三次失败去掉重试按钮.
-   **当工作失控时:** 运行时间预算阻止受影响部分超过监测限额。 生产 还用模拟定时器来构建探测器,用于无限制的生长. `brain doctor` 运行项目检查, 试验和诊断; 失败的阶段仍然可见于制剂.

这些机制已经落实,而不是承诺抓住每一个错误或修复每一个失败。 经纪人还需要 测试用户的工作流程。 见 [光谱中的运行时行为](https://github.com/chrisifm/BRAINLLM/blob/v0.10.6/SPEC.md#errors-at-runtime), (中文(简体) ), [组件边界](https://github.com/chrisifm/BRAINLLM/blob/v0.10.6/runtime/brain-guard.js) 财务报告和审定财务报表 [编译器诊断](https://github.com/chrisifm/BRAINLLM/blob/v0.10.6/crates/brain-check/)。 。 。 .

## 构建您的代理工具

**以所积相. 让你的LLM更好.**

![An LLM turns an observed problem into an isolated fix, runs validation and submits a contribution for human review](https://github.com/chrisifm/BRAINLLM/raw/v0.10.6/docs/site/assets/improvement-loop.png)

一个失败的编译可以成为回归测试. 一再缓慢的步骤可以成为基准。 修理的时候 构建您的应用程序可以成为帮助下一个开发商及其代理商的贡献.

在建立应用程序时找到编译器缺口吗 ? 将最小的可复制病例变成回归测试和 捐款。 BRAINLLM 包括一个 [演化工作流程](https://github.com/chrisifm/BRAINLLM/blob/v0.10.6/docs/EVOLUTION.md) 已验证的编译器 二进制和可逆活化. 配置自动推入审查分支; 合并需要 主要作者的审查。 这是一个明确的开发工作流程,而不是一个默默地改写自己的编译器 在每一个建筑。 读取 [代理改进游戏本](https://github.com/chrisifm/BRAINLLM/blob/v0.10.6/docs/AGENT-IDEAS.md) 迅速提出具体意见 调查.

欢迎人类开发者和LLM贡献者. 有用的第一贡献包括可复制的编译器错误, 保留行为移取实例,更清晰的诊断以及用数据前后的性能改进.

1.  读取 [捐款额](https://github.com/chrisifm/BRAINLLM/blob/v0.10.6/CONTRIBUTING.md) 相关 [内部](https://github.com/chrisifm/BRAINLLM/blob/v0.10.6/docs/INTERNALS.md)。 。 。 .
2.  用回归测试和合成样本数据进行有重点的改变.
3.  运行 `bash scripts/verify.sh`它建立CLI并检查Rust、运行时间、工具、诊断装置、隐私 和寄存语言。 核查还需要Ripgrep.
4.  与问题一起打开拉出请求,产生的行为和实际验证证据.

应用程序作者所写的修改也需要Conference所描述的被冻结的LLM基准工作流程. 不得在捐款中包括应用秘密、私人来源或客户数据.

## 知道你收养什么

BRAINLLM 是,这是 **0.10.6 联合国** (见 [变动情况](https://github.com/chrisifm/BRAINLLM/blob/v0.10.6/CHANGELOG.md)) (中文(简体) ). 从一个小的应用程序或一个孤立的路径开始,测试你需要的行为. 标记特征 (一) 来源说明中规划的不是支持的承诺; `brain spec` 服务于已执行的合同. 第三方反应,Angular和Vue组件不会自动成为BRAINLLM组件. 基准获胜 建设时间并不意味着每个运行时间的工作量都更快.

## 继续建设

| 你想说.. | 从这里开始 |
| --- | --- |
| 向代理商提供项目上下文 | [页:1](https://github.com/chrisifm/BRAINLLM/blob/v0.10.6/llms.txt) |
| 写入应用程序 | [SPEC.md 高频](https://github.com/chrisifm/BRAINLLM/blob/v0.10.6/SPEC.md) 财务报告和审定财务报表 `brain spec` |
| 移动已存在的前端 | [移徙指南](https://github.com/chrisifm/BRAINLLM/blob/v0.10.6/docs/MIGRATION.md) |
| 使用时改进编译器 | [演化工作流程](https://github.com/chrisifm/BRAINLLM/blob/v0.10.6/docs/EVOLUTION.md) 财务报告和审定财务报表 [代理构想](https://github.com/chrisifm/BRAINLLM/blob/v0.10.6/docs/AGENT-IDEAS.md) |
| 了解执行情况 | [内部](https://github.com/chrisifm/BRAINLLM/blob/v0.10.6/docs/INTERNALS.md) 财务报告和审定财务报表 [货箱](https://github.com/chrisifm/BRAINLLM/blob/v0.10.6/crates/) |
| 检查实例和复制测量数据 | [实例](https://github.com/chrisifm/BRAINLLM/blob/v0.10.6/examples/) 财务报告和审定财务报表 [基准](https://github.com/chrisifm/BRAINLLM/blob/v0.10.6/bench/) |
| 促成变化 | [贡献者指南](https://github.com/chrisifm/BRAINLLM/blob/v0.10.6/CONTRIBUTING.md) |

释放 [麻省理工学院许可证](https://github.com/chrisifm/BRAINLLM/blob/v0.10.6/LICENSE)。 。 。 .

创建和维护者 **克里斯蒂安·伊拉克·弗洛雷斯·马尔多纳多**,主要作者. [(原始内容存档于2018-03-26). ingenieria.dev](https://ingenieria.dev/) • 妇女 [irack.mx (英语)](https://irack.mx/) • 妇女 [克里斯蒂安语@irack.mx](mailto:christian@irack.mx)

## 由捐助者建造

每一份合并的贡献都会帮助下一个开发者及其代理商. 感谢公众的GitHub账户.

[![chrisifm](https://avatars.githubusercontent.com/u/1562002?v=4)](https://github.com/chrisifm) [颜色](https://github.com/chrisifm)

通过审查的牵引请求来刷新归属. [如何运作](https://github.com/chrisifm/BRAINLLM/blob/v0.10.6/docs/CONTRIBUTORS.md)。 。 。 .

## 常见问题

### @christianirack/brainllm 是什么？

BRAINLLM:一款由 Rust 驱动的前端和全高架网络编译器\. 优化了JavaScript,SSR,SEO准备的静态站点,一个PostgreSQL后端和用于LLM和AI代理的MCP工具\.

### 如何安装 @christianirack/brainllm？

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

### @christianirack/brainllm 支持 TypeScript 吗？

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

### @christianirack/brainllm 需要什么版本的 Node\.js？

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

### @christianirack/brainllm 可以商用吗？

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

### @christianirack/brainllm 的下载量有多少？

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

### @christianirack/brainllm 还在维护吗？

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