LRAppSoft 安卓端文档同步工具

将 懒人精灵 官方文档「快速开始 → 安卓端」下的 API 文档抓取并转换为本地 Markdown 文件的工作流。

官方文档站基于 VitePress 构建，本工具抓取每个页面预渲染后的 .html（含完整正文），再将其转换为标准 Markdown，避免 SPA 页面仅含占位符的问题。

目录结构

\lrappdocs\
├── README.md            # 本说明文件
├── download.ps1         # 仅下载原始 HTML 到 raw/ 的旧脚本（保留备用）
├── convert.ps1          # 将 raw/ 下的 HTML 转换为 md/ 下的 Markdown
├── sync.ps1             # 工作流主脚本：下载 + 转换（+ 可选 git 提交）
├── raw\                 # 原始下载的 HTML 文件（每页一个 <slug>.html）
│   ├── math.html
│   ├── cipher.html
│   ├── ...（共 25 个页面）
│   └── custom.html
└── md\                  # 转换后的 Markdown 文档（与 raw/ 一一对应）
    ├── math.md
    ├── cipher.md
    ├── ...（共 25 个页面）
    └── custom.md

文件说明

当前文档页面（25 个）

math · cipher · lfs · luasocket · luaopenov · io · time · array · ffi · string · device · color · network · touch · ui · extension · accessibility · node · dynamicui · json · console · virtualscreen · imgui · gobridge · custom

使用工作流脚本

前置要求

• Windows + PowerShell（Core 或 Windows PowerShell 均可）
• 联网可访问 http://www.lrappsoft.com
• （可选）本地已 git init，用于自动提交变更

一键同步（推荐）

在 PowerShell 中执行：

powershell -ExecutionPolicy Bypass -File D:\xfx\lrappdocs\sync.ps1

脚本会自动完成：下载最新 HTML → 转换为 Markdown → （若检测到 git 仓库）提交变更。

常用参数

仅重新转换（已下载过 raw/）

如果只想调整转换格式、不重新联网下载，直接运行：

powershell -ExecutionPolicy Bypass -File D:\xfx\lrappdocs\convert.ps1

官方文档更新后如何使用

1. 运行一键同步脚本 sync.ps1，即可拉取最新内容并覆盖更新 md/。
2. 若官网新增了文档页面，编辑 sync.ps1 顶部的 $Pages 数组，把新页面的 slug（即 /lrword/api/android/<slug>.html 中的文件名）追加进去，再运行脚本即可。