Files
xiaoyin-markdown/tools/screenshots/README.md
T
Jidekin 0e09d307e3 feat(site): 官网换成真实界面截图(4 张)+ 截图生成工具
老板要求:用真实的软件界面图,不要 CSS 画的效果图。

做法:把仓库里**真实的渲染层**跑起来截 —— src/renderer 下的
index.html / style.css / app.js / markdown.js 一字未改,只用
tools/screenshots/mock-api.js 把 Windows 侧的文件、剪贴板、对话框接口换成假数据,
再用无头 Chrome + CDP 在 1440x900@2x 下渲染。

产出 4 张(压到 1600 宽 JPEG q88,共 508KB):
  site/img/app-light.jpg  浅色分栏:文件树 + 源码 + 实时预览 + 章节大纲 + 状态栏
  site/img/app-dark.jpg   深色主题
  site/img/app-find.jpg   查找「安装包」:正文全标黄、当前标橙、计数 2/4
  site/img/app-read.jpg   阅读模式

页面改动:
  · HERO 的假窗口 → 真实截图(保留窗口标题栏样式)
  · 深色区块的假代码窗 → 真实深色截图
  · 新增「这些都是真实界面」区块,放查找/阅读两张 + 说明
  · 清掉改版后失效的假窗口 CSS(-1213 字节)

tools/screenshots/ 里留了完整流程(含「等 2.8 秒让 toast 消失」这个坑),
以后界面改了可以直接重出图。
2026-11-19 21:56:45 +08:00

1.8 KiB
Raw Blame History

官网截图生成

官网 site/index.html 里那几张「真实界面」图是这么来的:

用仓库里真实的渲染层(src/renderer/{index.html,style.css,app.js,markdown.js})跑起来截图, 只把 Windows 侧的文件/剪贴板接口换成 mock-api.js 里的假数据 —— 界面、排版、渲染引擎全是线上那份代码,不是画的效果图。

步骤

# 1. 复制渲染层 + 挂上 mock
rm -rf /tmp/shots/app && mkdir -p /tmp/shots/app
cp src/renderer/* /tmp/shots/app/
# 在 index.html 里把 <script src="mock-api.js"> 插到 app.js 之前
cp tools/screenshots/mock-api.js /tmp/shots/app/

# 2. 起静态服务
cd /tmp/shots/app && python3 -m http.server 8901 &

# 3. 起无头 Chrome(开 CDP)
CH=$(ls ~/.cache/ms-playwright/chromium-*/chrome-linux64/chrome | head -1)
$CH --headless=new --no-sandbox --hide-scrollbars --disable-gpu \
    --force-device-scale-factor=2 --remote-debugging-port=9222 \
    --window-size=1440,900 about:blank &

# 4. 截 4 张(浅色分栏 / 深色 / 查找高亮 / 阅读模式)
node tools/screenshots/take.mjs

# 5. 压成网页尺寸(1600 宽,JPEG q88)
python3 - <<'PY'
from PIL import Image; import os
for s, d in {'shot-split':'app-light','shot-dark':'app-dark',
             'shot-find':'app-find','shot-read':'app-read'}.items():
    im = Image.open(f'/tmp/shots/out/{s}.png').convert('RGB')
    w, h = im.size; tw = 1600
    im.resize((tw, round(h*tw/w)), Image.LANCZOS).save(
        f'site/img/{d}.jpg', 'JPEG', quality=88, optimize=True, progressive=True)
PY

截图里打开的是一篇样例「周报」文档,内容在 mock-api.js 的 DOC 常量里,改文案就改那里。 注意 take.mjs 里打开文件后要等 ~2.8 秒再截 —— 否则底部的「已打开」toast 会留在图上。