chore: standardize project comments in English

scripts/dev.sh

@@ -1,13 +1,13 @@
 #!/usr/bin/env bash
-# 一键启动开发环境：Go 后端（go run -tags dev）+ Vite 前端（热更新），Ctrl+C 同时退出。
+# Start Go (go run -tags dev) and Vite with hot updates; Ctrl+C stops both.
 #
-# 用法：scripts/dev.sh [--host]
-#   --host  前端监听所有网卡，便于手机/平板通过局域网访问
+# Usage: scripts/dev.sh [--host]
+#   --host  Listen on all interfaces for LAN access from phones/tablets.
 #
-# 环境变量：
-#   RAWMARK_DATA  开发数据目录，默认 <仓库>/.dev-data
-#   API_PORT      后端端口，默认 8080（Vite 代理读取同一变量）
-#   WEB_PORT      前端端口，默认 5173
+# Environment variables:
+#   RAWMARK_DATA  Development data directory; defaults to <repository>/.dev-data.
+#   API_PORT      Backend port; defaults to 8080 (also used by the Vite proxy).
+#   WEB_PORT      Frontend port; defaults to 5173.
 set -euo pipefail
 
 ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
@@ -32,7 +32,7 @@ for arg in "$@"; do
   esac
 done
 
-# Go 默认安装位置可能不在非登录 shell 的 PATH 中
+# The default Go installation may be missing from PATH in non-login shells.
 [[ -d /usr/local/go/bin ]] && export PATH="$PATH:/usr/local/go/bin"
 
 fail() {
@@ -54,11 +54,11 @@ port_in_use() {
 port_in_use "$API_PORT" && fail "端口 $API_PORT 已被占用（后端）"
 port_in_use "$WEB_PORT" && fail "端口 $WEB_PORT 已被占用（前端）"
 
-# 由 pnpm 核对锁定依赖；已有依赖时复用本地缓存。
+# Let pnpm verify locked dependencies and reuse cached packages when available.
 echo "==> 核对前端依赖"
 pnpm -C web install --frozen-lockfile
 
-# 退出时结束本脚本启动的所有子进程（包括 go run 编译出的服务进程）
+# On exit, stop every child started here, including the service compiled by go run.
 cleanup() {
   trap - EXIT INT TERM
   echo
@@ -67,13 +67,13 @@ cleanup() {
 }
 trap cleanup EXIT INT TERM
 
-# 给两路日志加前缀，便于区分
+# Prefix both log streams to distinguish them.
 prefix() { sed -u "s/^/[$1] /"; }
 
 echo "==> 启动后端 http://127.0.0.1:$API_PORT（数据目录 $RAWMARK_DATA）"
 RAWMARK_ADDR="127.0.0.1:$API_PORT" go run -tags dev ./cmd/rawmark 2>&1 | prefix server &
 
-# 等后端就绪后再启动前端，避免首次编译期间前端请求失败
+# Wait for the backend before starting Vite to avoid failed requests during initial compilation.
 for _ in $(seq 1 120); do
   curl -fs "http://127.0.0.1:$API_PORT/api/v1/health" >/dev/null 2>&1 && break
   sleep 0.5
@@ -83,5 +83,5 @@ curl -fs "http://127.0.0.1:$API_PORT/api/v1/health" >/dev/null 2>&1 || fail "后
 echo "==> 启动前端 http://localhost:$WEB_PORT"
 (cd web && exec pnpm exec vite "${VITE_ARGS[@]}") 2>&1 | prefix web &
 
-# 任一进程退出（如后端崩溃）即整体停止
+# Stop everything if either process exits, such as after a backend crash.
 wait -n

scripts/prepare-maple-font.py

@@ -1,7 +1,7 @@
 #!/usr/bin/env python3
-"""从指定 v7.9 ZIP 重建本地字体：python3 scripts/prepare-maple-font.py /path/to/MapleMonoNormalNL-NF-CN.zip。
-仅重建字体时需要 fonttools[woff]；应用构建直接使用已入库的 WOFF2。
-来源：https://github.com/subframe7536/maple-font/releases/tag/v7.9
+"""Rebuild local fonts from the specified v7.9 ZIP: python3 scripts/prepare-maple-font.py /path/to/MapleMonoNormalNL-NF-CN.zip.
+Only font regeneration requires fonttools[woff]; application builds use the checked-in WOFF2 files.
+Source: https://github.com/subframe7536/maple-font/releases/tag/v7.9
 """
 import io
 from pathlib import Path
@@ -15,14 +15,14 @@ root = Path(__file__).resolve().parents[1] / 'web/src/common/appearance'
 output = root / 'fonts/maple'
 output.mkdir(exist_ok=True)
 family = 'Maple Mono Normal NL NF CN'
-css = ['/* Maple Mono v7.9；由 scripts/prepare-maple-font.py 生成，授权见 fonts/maple/LICENSE.txt。 */']
+css = ['/* Maple Mono v7.9; generated by scripts/prepare-maple-font.py. See fonts/maple/LICENSE.txt for licensing. */']
 with zipfile.ZipFile(sys.argv[1]) as archive:
     (output / 'LICENSE.txt').write_bytes(archive.read('LICENSE.txt'))
     for variant, weight, style in [('Regular', 400, 'normal'), ('Bold', 700, 'normal'), ('Italic', 400, 'italic'), ('BoldItalic', 700, 'italic')]:
         data = archive.read('MapleMonoNormalNL-NF-CN-' + variant + '.ttf')
         source = TTFont(io.BytesIO(data))
         points = sorted(source.getBestCmap())
-        # 按 Unicode 区间分片，中文和 Nerd Font 不强制随拉丁文字一起下载。
+        # Split by Unicode range so Chinese and Nerd Font glyphs need not download alongside Latin text.
         for block in sorted({cp // 4096 for cp in points}):
             unicodes = [cp for cp in points if cp // 4096 == block]
             font = TTFont(io.BytesIO(data), recalcTimestamp=False)

scripts/remove-sharing.sql

@@ -1,5 +1,5 @@
--- 一次性部署清理：先停止旧服务，并保留数据库与镜像配套的回滚备份。
--- 不由应用启动流程执行；原始笔记和图片不在此脚本的清理范围内。
+-- One-time deployment cleanup: stop the old service and retain matching database/image rollback backups first.
+-- Never run at application startup; original notes and images are outside this script's cleanup scope.
 BEGIN IMMEDIATE;
 DROP TABLE IF EXISTS share_items;
 DROP TABLE IF EXISTS shares;

scripts/reset-shortcuts.sql

@@ -1,4 +1,4 @@
--- 仅在切换到 Typora 默认快捷键的部署中执行一次；保留所有其他设置。
+-- Run once only when migrating to Typora default shortcuts; retain all other settings.
 BEGIN IMMEDIATE;
 UPDATE settings SET value = json_remove(value, '$.shortcuts') WHERE key = 'app.settings';
 COMMIT;