所有文档
LVX · Office

一个 lvx，跑完你的全部

模型、应用与界面，统一装进 .lvx 容器；跨平台、单文件、本地 AI。

不是套壳，是自己走完每一条指令 · Local AI, one binary.

安装 LVX 看它是怎么跑起来的 逛插件商店

支持 Windows / Linux / Android（x64 · arm64），无需安装运行时环境 —— 当前提供 Linux x86_64 与 Windows x64 1.0.0。

它是什么

把运行时本身做成产品

模型、应用、界面——一种格式，一个程序。
一句话

LVX 是一个把本地 AI 模型、应用和图形界面统一装进单个 .lvx 文件、并只用一个 lvx 程序运行它们的通用运行时。

一段话

LVX（XRuntime）把三件事合成一件——一个自描述的通用容器 .lvx、一个唯一的可执行主程序 lvx、一套从零实现的执行与界面栈。模型、插件、数据集、Flutter 应用都可以是 .lvx；lvx 负责装配、解释、渲染与交互。它不依赖 Dart VM、不套 Chromium、不装 Python——每一行字节都由自己的运行时读进来。

长文

LVX 从一个问题开始：为什么跑一个应用，要拖上几 GB 的运行时、引擎和依赖树？我们的答案是把「运行时」本身做成产品：.lvx 万能容器（自描述文件头、一眼识别、一条命令装配）、lvx 唯一主程序（构建 / 运行 / 推理 / 商店全在同一个二进制里）、自带执行栈（Dart kernel 解释器 + dart:core / dart:ui 契约 + 平台通道 + 资源包）、自带界面栈 LVXUI 2.0（抗锯齿栅格器 + FreeType / HarfBuzz 真字形 + Material 组件）、本地 AI 同进程（GGUF / .lvx 模型 + Vulkan）。结果：真实应用能在 LVX 上直接启动、布局、渲染，包括中文界面与真字形文字。

核心能力

八件事，一个二进制

01

单文件运行时

一个 lvx 完成构建、运行、推理、插件管理；没有「先装环境」这一步。

02

.lvx 万能容器

模型、插件、数据集、应用统一封装，自描述 + 校验，复制即分发。

03

直接执行 Dart / Flutter

解析并执行 Dart kernel（format v130），自实现 dart:core / dart:ui 与平台通道，现有工程不必改业务代码。

04

自研界面引擎 LVXUI 2.0

三层：栅格器 / 真字形排版（含字体回退）/ Material 组件与命中测试，中文混排同一条管线。

05

本地 AI，同进程

GGUF 与 .lvx 模型、量化、Vulkan 计算管线，与界面共用一份内存。

06

插件商店

插件即 .lvx：浏览、下载、安装、卸载、发布都在 lvx 里完成，互不污染。

07

跨平台一致

Windows / Linux / Android × x64 / arm64 共用同一套源码与同一种行为。

08

可解释、可验证

Dart 运行时回归、dart:ui 像素回归、逐帧色彩普查：每个结论都有测量。

工作原理

从源码到一个能点得动的界面

四个动作，全部发生在同一个程序里。

01

打包

lvx build 把 Flutter / C++ 项目编成 .lvx。

02

装配

lvx run 读文件头识别类型，决定用什么方式启动。

03

执行

解释 Dart kernel，运行时直接提供 dart:core / dart:ui / 平台通道 / 资源。

04

呈现

LVXUI 2.0 排版栅格化 + 命中测试，AI 推理与应用共享进程。

插件商店

插件也是 .lvx

商店不是网页，是 lvx 里的一个界面：装、卸、升级都不离开这个程序。

插件即 .lvx
与模型、应用同一种容器格式，带自描述与校验。
浏览 · 下载 · 安装 · 卸载 · 发布
全流程在 lvx 内完成，不需要另装包管理器。
互不污染
插件各自独立，删掉即还原，不影响主程序。
当前状态
内测中：随 LVX 一同推进，公开后在此更新。
路线图

现在到哪一步了

已实现DONE

  • .lvx 容器与主程序
  • LVXUI 2.0 三层引擎
  • GGUF / LVX 模型 + Vulkan
  • 插件商店
  • Dart kernel 执行 —— 真实 Flutter 应用已能启动并渲染中文界面
  • Linux x86_64 1.0.0 发布（lvx / lvx-agent / lvx_lvxc / lvx_dartrun 一体安装）

进行中WIP

  • 执行覆盖度与图像管线收尾（资源图片解码 → 绘制）
  • 桌面窗口与输入边角场景

下一步NEXT

  • .lvx 应用打包一键化
  • LVX 脚本语言（设计原则：比 Python 更简单）
  • 跨平台产物统一签名
安装

安装 LVX 1.0.0

Linux x86_64 与 Windows x64 已发布（Android 构建在推进）。装完就有一个 lvx 程序：构建、运行、推理、插件管理都在里面； 网页商店 /store/ 通过随包安装的 lvx-agent 直接装插件。

单条命令安装

curl -fsSL https://lvx-office.com/install.sh | bash

脚本会自动下载核心包（3.2 MiB）→ 用同目录的 SHA256SUMS 校验 → 装到 ~/.local/lib/lvx + ~/.local/bin（免 sudo）。 ~/.lvx 是数据目录（插件 / 软件源 / 缓存），~/.lvx/bin 记录 lvx-agent 该驱动哪个 CLI。

常用变体（每条都是一行，点「复制」即可）

系统级安装（/usr/local，全机可用） 
curl -fsSL https://lvx-office.com/install.sh | sudo bash -s -- --system
另装 Flutter / Dart 运行时扩展包（约 63 MiB） 
curl -fsSL https://lvx-office.com/install.sh | bash -s -- --flutter-extras
装到自定义前缀 
curl -fsSL https://lvx-office.com/install.sh | bash -s -- --prefix /opt/lvx --bin-dir /opt/lvx/bin
裁剪组件（不装网页商店代理、不装随包插件） 
curl -fsSL https://lvx-office.com/install.sh | bash -s -- --no-agent --no-plugins
卸载 
curl -fsSL https://lvx-office.com/install.sh | bash -s -- --uninstall

安装包

文件大小说明
install.sh 15 KB 安装 / 卸载脚本：可自下载并校验，也支持 --tar 离线安装
lvx-1.0.0-linux-x86_64.tar.gz 3.2 MiB Linux 主程序：lvx / lvx-agent / lvx_lvxc / lvx_dartrun + 官方插件 + 文档
lvx-1.0.0-setup.exe 10.5 MiB Windows 安装程序（Inno Setup 6）：双击装到 %LOCALAPPDATA%\LVX，免管理员；勾选「加入 PATH」后开新终端即可用
lvx-1.0.0-windows-x86_64.zip 17.2 MiB Windows 便携包：解压后直接跑 bin\lvx.exe；install.bat 可复制到 %LOCALAPPDATA%\LVX 并配置 PATH
lvx-1.0.0-linux-x86_64-flutter.tar.gz 62.9 MiB 可选扩展包：Flutter / Dart 运行时资源（kernel/flutter_combined.dill + flutter_assets/）
SHA256SUMS 204 B 上面两个压缩包的校验值（脚本自动使用）
README-安装.md 981 B 随包安装说明

校验：55937f13…3f60c610（Linux CLI）、54264678…b900295f71（Flutter 扩展包）、5c9d2284…e5123e5f1（Windows 安装程序）、2b14a48a…86cd3fedcb（Windows 便携包）—— 完整值见 SHA256SUMS，sha256sum -c SHA256SUMS 可直接校验。

离线 / 手动安装

# 有网机器下载，拷到离线机器
curl -fsSLO https://lvx-office.com/install.sh
curl -fsSLO https://lvx-office.com/lvx/1.0.0/lvx-1.0.0-linux-x86_64.tar.gz
sha256sum -c <(curl -fsSL https://lvx-office.com/lvx/1.0.0/SHA256SUMS | grep -v flutter)
bash install.sh --tar lvx-1.0.0-linux-x86_64.tar.gz

# 或直接解包（包内自带 install.sh）
tar -xzf lvx-1.0.0-linux-x86_64.tar.gz && cd lvx-1.0.0-linux-x86_64 && ./install.sh

Windows 怎么装

# 图形安装（推荐）：双击 lvx-1.0.0-setup.exe → 勾选「加入 PATH」→ 开新终端
lvx help

# 静默安装（可选参数）
lvx-1.0.0-setup.exe /VERYSILENT /SUPPRESSMSGBOXES /NORESTART /DIR=D:\LVX /TASKS=addtopath

# 便携包：解压后直接跑，或执行 install.bat 复制到 %LOCALAPPDATA%\LVX 并配置 PATH
bin\lvx.exe plugins

Windows 包内含 lvx_lvxc.exe、lvx_pack.exe、lvx_flutter_pack.exe 与 21 个插件 DLL。目前是 CLI / 工具链形态：Win32 GDI 窗口与画布可用，UI2 控件引擎（商店界面、图片 syscall）尚未交叉编译进 Windows 构建。

Flutter / Dart 扩展包怎么用

export LVX_ASSETS=$HOME/.local/lib/lvx/flutter-extras/assets
lvx_dartrun $HOME/.local/lib/lvx/flutter-extras/kernel/flutter_combined.dill --ui --hold 20
FAQ

常见问题

是模拟器吗？

不是：自己读 kernel 字节码、自己实现 dart:core / dart:ui、自己排版光栅化——没有 Dart VM、没有 Flutter 引擎、没有浏览器内核。

Flutter 项目要改代码吗？

不需要改业务代码，LVX 面向编译产物，按需实现框架契约。

为什么执着于「一个文件」？

分发、审计、回滚、离线部署的成本几乎全部来自「依赖一棵树」；砍掉这棵树，剩下的才是产品本身。

现在能安装吗？

能。Linux x86_64 一条命令装到 ~/.local：curl -fsSL https://lvx-office.com/install.sh | bash；Windows x64 下载 lvx-1.0.0-setup.exe（10.5 MiB）双击安装。Android 构建在推进中。

本站其它项目

LVX 上的应用

Momotalk-X 官网

基于 Flutter 的蔚蓝档案二创工具：写剧情、扮演老师与学生对话、导出聊天长图。

MomoTalk-AI 官网

Momotalk-X 的 AI 分支：把 AI 会话做进聊天里，多模型供应商、差分情绪标签与工作区。