跳到正文
Lumo
从这里开始约 1 分钟

开始使用

安装两个产品、在本地运行本站，并知道哪些命令真正重要。

更新于 2025年11月1日约 1 分钟编辑此页
本页目录

Lumo 有三种运行方式：Chrome 应用商店、GitHub Actions 产物，或本地构建。用户脚本管理器通过 GitHub Releases 分发。本站是一个标准的 Vite 项目。

安装 Lumo#

  1. 1

    Chrome 应用商店

    稳定渠道。会自动更新，但每个版本都要等 Google 审核，因此可能落后于 main。

  2. 2

    GitHub Actions 产物

    下载最新的 lumo-chrome-mv3 产物，解压，打开 chrome://extensions，开启开发者模式，选择“加载已解压的扩展程序”。

  3. 3

    从源码构建

    克隆仓库、安装依赖、构建，然后加载 .output/chrome-mv3。

从源码构建 Lumobash
git clone https://github.com/mscststs/lumo.gitcd lumonpm installnpm run build# chrome://extensions → 加载已解压的扩展程序 → .output/chrome-mv3

安装 Lumo Userscripts#

用户脚本需要 Chrome 138 或更新版本，以及原生 chrome.userScripts API。Chrome 会要求你为该扩展允许一次用户脚本。

  1. 从 GitHub Releases 下载最新压缩包，或从源码构建。
  2. 打开 chrome://extensions，开启开发者模式，加载已解压的目录。
  3. 在扩展卡片上开启 允许用户脚本。

这个开关是必须的

没有“允许用户脚本”，管理器仍然可以安装和编辑脚本，但 Chrome 不会执行它们。

在本地运行本站#

网站bash
npm installnpm run dev       # http://localhost:5173npm run typechecknpm run testnpm run build     # 预渲染所有路由到 build/client
命令作用
npm run dev带 HMR 的 React Router 开发服务器。
npm run build预渲染所有路由并写出静态 HTML。
npm run preview通过 Wrangler 预览 build/client。
npm run typecheck生成路由类型，再运行 tsc --noEmit。
npm run testVitest：i18n 对齐、文档完整性、主题对比度。
npm run deploy把 build/client 作为 Worker 静态资产部署。