软著pdf源码准备

.gitignore

@@ -71,6 +71,9 @@ api/models/whisper/
 # 脚本输出（预览 JSON/Markdown）
 api/scripts/output/
 
+# 软著：源码摘录 PDF（默认生成在仓库根目录）
+/copyright_source_listing.pdf
+
 certs/
 
 # Git worktrees

api/scripts/copyright_source_pdf.py

@@ -0,0 +1,584 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+"""
+软著申报用：源码整理生成 PDF（reportlab）
+
+默认扫描整个 monorepo 根目录（本脚本位于 api/scripts/，向上两级即为仓库根），
+会包含后端 api、Expo 客户端 app-expo、评测 Web app-eval-web 等；也可用 --root 只扫某一子项目。
+
+使用说明（简要）：
+1) 安装依赖：在 api 目录执行 uv sync（本仓库已含 reportlab）
+2) 中文字体：可设置 CJK_MONO_FONT_PATH；默认可用 STSong-Light（Adobe CID）。苹方/冬青等常为 CFF，
+   ReportLab 无法直接嵌入。使用 STSong-Light 时，ASCII（含空格、英文代码）用内置 Courier 分段绘制，
+   中文用 STSong，避免整行用 CID 时拉丁字距错位、挤在一起。
+   需要退回纯 TrueType 单字体（Menlo 等）时用 --no-cid。
+3) 修改下方「配置区」常量：软件全称、版本号、必要时改 SOURCE_ROOT / 输出路径、字体路径、后缀与跳过目录
+4) 运行（全仓默认，仅 .py / .ts(x) / .js(x) / .vue 等源码）：cd api && uv run python scripts/copyright_source_pdf.py
+   仅后端示例：... --root ../api
+
+注意：
+- 空行会从统计与输出中剔除；行首行尾以外的空白（缩进）保留。
+- 总页数按 ceil(非空行总数/50) 估算；>60 页则取前 1500 行 + 后 1500 行，最终 60 页、页码 1–60。
+- 不足 60 页时输出全部非空行；最后一页若不足 50 行，用空行补齐到 50 行。
+"""
+
+from __future__ import annotations
+
+import argparse
+import math
+import os
+import sys
+from dataclasses import dataclass
+from pathlib import Path
+from typing import Iterable
+
+from reportlab.lib.pagesizes import A4
+from reportlab.lib.units import cm
+from reportlab.pdfbase import pdfmetrics
+from reportlab.pdfbase.cidfonts import UnicodeCIDFont
+from reportlab.pdfbase.ttfonts import TTFont
+from reportlab.pdfgen import canvas
+
+# 本文件位于 <repo>/api/scripts/，仓库根为其上两级目录
+REPO_ROOT = Path(__file__).resolve().parents[2]
+
+# =========================
+# 配置区（按项目修改；也可用命令行覆盖部分项）
+# =========================
+SOFTWARE_FULL_NAME = "岁月留书"
+VERSION = "V1.0.0"
+
+# 默认：整仓源码根（api + 各前端/工具子项目）；仅申报名某一模块时可改为子路径或 CLI --root
+SOURCE_ROOT = REPO_ROOT
+OUTPUT_PDF = REPO_ROOT / "copyright_source_listing.pdf"
+
+# PDF 页眉/材料中出现的文件路径：将本机目录前缀替换为申报用虚拟根（如 heguangtongkun/life-echo/...）
+FILE_PATH_ABSOLUTE_PREFIX = Path("/Users/kevin/Codes/hgtk")
+FILE_PATH_DISPLAY_ROOT = "heguangtongkun"
+
+# 设为 None 时自动探测（macOS：Menlo.ttc / Songti.ttc 等）；也可填本机 TTF/OTF 或 TTC 路径
+CJK_MONO_FONT_PATH: Path | None = None
+
+# STSong-Light（CID）与拉丁混排时 ReportLab 常把 ASCII 字距算错；ASCII 段单独用内置 Courier。
+ASCII_LATIN_FONT = "Courier"
+
+
+@dataclass(frozen=True)
+class RenderFonts:
+    """primary：中文等非 ASCII；latin_font 非空时 U+0000–U+007F 用 Courier。"""
+
+    primary: str
+    latin_font: str | None = None
+
+
+def _segment_latin_cjk(line: str) -> list[tuple[str, str]]:
+    if not line:
+        return []
+    out: list[tuple[str, str]] = []
+    buf: list[str] = []
+    is_lat = ord(line[0]) < 128
+    for ch in line:
+        lat = ord(ch) < 128
+        if lat != is_lat:
+            out.append(("lat" if is_lat else "cjk", "".join(buf)))
+            buf = [ch]
+            is_lat = lat
+        else:
+            buf.append(ch)
+    out.append(("lat" if is_lat else "cjk", "".join(buf)))
+    return out
+
+
+def _mixed_line_width(line: str, fonts: RenderFonts, font_size: float) -> float:
+    if fonts.latin_font is None:
+        return pdfmetrics.stringWidth(line, fonts.primary, font_size)
+    w = 0.0
+    for kind, chunk in _segment_latin_cjk(line):
+        fn = fonts.latin_font if kind == "lat" else fonts.primary
+        w += pdfmetrics.stringWidth(chunk, fn, font_size)
+    return w
+
+
+def _draw_line(
+    c: canvas.Canvas,
+    x: float,
+    y: float,
+    line: str,
+    fonts: RenderFonts,
+    font_size: float,
+) -> None:
+    if fonts.latin_font is None:
+        c.setFont(fonts.primary, font_size)
+        c.drawString(x, y, line)
+        return
+    xpos = x
+    for kind, chunk in _segment_latin_cjk(line):
+        if not chunk:
+            continue
+        fn = fonts.latin_font if kind == "lat" else fonts.primary
+        c.setFont(fn, font_size)
+        c.drawString(xpos, y, chunk)
+        xpos += pdfmetrics.stringWidth(chunk, fn, font_size)
+
+
+# 仅收录「可执行/可编译」源码：本仓为 Python + TS/JS 栈；排除 .md、.json、.yaml 等配置与文档。
+# 其它语言可自行向集合内追加后缀。
+INCLUDE_SUFFIXES: set[str] = {
+    ".py",
+    ".pyi",
+    ".ts",
+    ".tsx",
+    ".mts",
+    ".cts",
+    ".js",
+    ".jsx",
+    ".mjs",
+    ".cjs",
+    ".vue",
+}
+
+# 需要跳过的目录名（只比对路径每一段 name）
+SKIP_DIR_NAMES: set[str] = {
+    ".git",
+    ".svn",
+    ".hg",
+    "node_modules",
+    "venv",
+    ".venv",
+    "env",
+    ".env",
+    ".idea",
+    ".vscode",
+    "__pycache__",
+    ".mypy_cache",
+    ".pytest_cache",
+    ".ruff_cache",
+    ".next",
+    ".nuxt",
+    ".output",
+    ".turbo",
+    ".parcel-cache",
+    ".expo",
+    "dist",
+    "build",
+    "target",
+    "out",
+    "coverage",
+    "htmlcov",
+    "storybook-static",
+    "Pods",
+    ".gradle",
+    "DerivedData",
+}
+
+# 是否在文件边界插入标记行
+ADD_FILE_MARKERS = True
+FILE_MARKER_PREFIX = "// ===== "
+
+LINES_PER_PAGE = 50
+MAX_PAGES = 60
+
+# 苹方在多数 macOS 上为 .ttc 内嵌 CFF 轮廓，ReportLab TTFont 无法载入；仍会先尝试以下路径（以防特例）。
+_PINGFANG_CANDIDATES: tuple[Path, ...] = (
+    Path("/System/Library/Fonts/PingFang.ttc"),
+    Path(
+        "/System/Library/Fonts/Hiragino Sans GB.ttc"
+    ),  # 冬青黑体，常与苹方同源 CFF，多半失败
+    Path("/Library/Fonts/PingFang.ttc"),
+)
+
+
+def _try_register_stsong_cid() -> bool:
+    try:
+        pdfmetrics.registerFont(UnicodeCIDFont("STSong-Light"))
+        return True
+    except Exception:
+        return False
+
+
+def _register_stsong_cid_with_notice(*, pingfang_failed: bool) -> str:
+    if not _try_register_stsong_cid():
+        return ""
+    if pingfang_failed:
+        print(
+            "已载入 PDF 简体中文：STSong-Light（Adobe Unicode CID）。"
+            "说明：系统「苹方/冬青」等常为 OpenType-CFF，ReportLab 无法写入该轮廓；"
+            "已改用内置宋体轮廓以保证中文可见（非苹方字形，软著材料通常可接受）。",
+            file=sys.stderr,
+        )
+    else:
+        print(
+            "已载入 PDF 简体中文：STSong-Light（Adobe Unicode CID）。",
+            file=sys.stderr,
+        )
+    return "STSong-Light"
+
+
+# macOS：TrueType 轮廓 .ttc（Menlo、部分宋体/黑体）；苹方多为 CFF，见上方说明。
+_MACOS_TTC_CANDIDATES: tuple[tuple[Path, int], ...] = (
+    (Path("/System/Library/Fonts/Menlo.ttc"), 0),
+    (Path("/System/Library/Fonts/Supplemental/Songti.ttc"), 0),
+    (Path("/System/Library/Fonts/STHeiti Light.ttc"), 0),
+    (Path("/System/Library/Fonts/STHeiti Medium.ttc"), 0),
+)
+
+
+def _try_register_ttf_or_ttc(path: Path, font_name: str = "CodeCJK") -> bool:
+    """将字体注册为 font_name；.ttc 递增 subfontIndex 直至成功或无更多子字体。"""
+    if not path.is_file():
+        return False
+    if path.suffix.lower() == ".ttc":
+        idx = 0
+        while idx < 64:
+            try:
+                pdfmetrics.registerFont(TTFont(font_name, str(path), subfontIndex=idx))
+                return True
+            except Exception as e:
+                msg = str(e).lower()
+                if "bad subfontindex" in msg:
+                    break
+                if "subfontindex" in msg and "not in" in msg:
+                    break
+                idx += 1
+        return False
+    try:
+        pdfmetrics.registerFont(TTFont(font_name, str(path)))
+        return True
+    except Exception:
+        return False
+
+
+def register_font(user_path: Path | None, *, no_cid: bool = False) -> RenderFonts:
+    """选择正文字体；STSong CID 时同时返回 Courier 供拉丁混排。"""
+    font_tt = "CodeCJK"
+    if user_path is not None and user_path.is_file():
+        if _try_register_ttf_or_ttc(user_path, font_tt):
+            print(f"已载入 PDF 字体：{user_path}", file=sys.stderr)
+            return RenderFonts(primary=font_tt)
+
+    pingfang_failed = False
+    if sys.platform == "darwin":
+        for p in _PINGFANG_CANDIDATES:
+            if _try_register_ttf_or_ttc(p, font_tt):
+                print(f"已载入 PDF 字体（苹方/平方相关）：{p}", file=sys.stderr)
+                return RenderFonts(primary=font_tt)
+        pingfang_failed = any(p.is_file() for p in _PINGFANG_CANDIDATES)
+
+    if not no_cid:
+        cid_name = _register_stsong_cid_with_notice(pingfang_failed=pingfang_failed)
+        if cid_name:
+            return RenderFonts(primary=cid_name, latin_font=ASCII_LATIN_FONT)
+
+    if sys.platform == "darwin":
+        for ttc_path, sub in _MACOS_TTC_CANDIDATES:
+            if not ttc_path.is_file():
+                continue
+            try:
+                pdfmetrics.registerFont(
+                    TTFont(font_tt, str(ttc_path), subfontIndex=sub)
+                )
+                label = "系统等宽" if "Menlo" in ttc_path.name else "系统字体"
+                print(
+                    f"已载入 PDF 字体（macOS TrueType）：{ttc_path}（{label}）",
+                    file=sys.stderr,
+                )
+                return RenderFonts(primary=font_tt)
+            except Exception:
+                continue
+
+    for p in (
+        Path("/usr/share/fonts/opentype/noto/NotoSansCJK-Regular.ttc"),
+        Path("/usr/share/fonts/truetype/noto/NotoSansMonoCJK-Regular.ttf"),
+    ):
+        if _try_register_ttf_or_ttc(p, font_tt):
+            print(f"已载入 PDF 字体（Linux 常见路径）：{p}", file=sys.stderr)
+            return RenderFonts(primary=font_tt)
+
+    if no_cid:
+        print(
+            "警告：已指定 --no-cid 且未找到可用 TrueType 轮廓字体，将使用 Courier。",
+            file=sys.stderr,
+        )
+    else:
+        print(
+            "警告：未找到可用的中文矢量字体，将使用 Courier（中文可能无法显示）。",
+            file=sys.stderr,
+        )
+    return RenderFonts(primary="Courier")
+
+
+@dataclass(frozen=True)
+class ExtractResult:
+    lines: list[str]
+    pages: int
+    capped: bool
+    original_non_empty_lines: int
+    original_pages_ceil: int
+
+
+def should_skip_dir(name: str) -> bool:
+    return name in SKIP_DIR_NAMES
+
+
+def iter_source_files(root: Path) -> Iterable[Path]:
+    for dirpath, dirnames, filenames in os.walk(root, followlinks=False):
+        dirnames[:] = [d for d in dirnames if not should_skip_dir(d)]
+        for fn in filenames:
+            p = Path(dirpath) / fn
+            if p.suffix.lower() in INCLUDE_SUFFIXES:
+                yield p
+
+
+def path_for_pdf_listing(fp: Path) -> str:
+    """将绝对路径转为 PDF 展示路径：/Users/.../hgtk/foo -> heguangtongkun/foo。"""
+    try:
+        resolved = fp.resolve()
+        base = FILE_PATH_ABSOLUTE_PREFIX.expanduser().resolve()
+        rel = resolved.relative_to(base)
+        return f"{FILE_PATH_DISPLAY_ROOT}/{rel.as_posix()}"
+    except ValueError:
+        return fp.as_posix()
+
+
+def read_nonempty_lines_from_files(files: list[Path]) -> list[str]:
+    out: list[str] = []
+    for fp in files:
+        if ADD_FILE_MARKERS:
+            out.append(f"{FILE_MARKER_PREFIX}{path_for_pdf_listing(fp)} =====")
+        try:
+            text = fp.read_text(encoding="utf-8", errors="replace")
+        except OSError:
+            text = fp.read_text(encoding="latin-1", errors="replace")
+
+        for raw in text.splitlines():
+            line = raw.rstrip("\n")
+            if line.strip() == "":
+                continue
+            out.append(line)
+    return out
+
+
+def extract_for_pdf(
+    lines: list[str],
+    *,
+    lines_per_page: int = LINES_PER_PAGE,
+    max_pages: int = MAX_PAGES,
+) -> ExtractResult:
+    original_non_empty_lines = len(lines)
+    original_pages_ceil = max(1, math.ceil(original_non_empty_lines / lines_per_page))
+
+    capped = original_pages_ceil > max_pages
+    if capped:
+        first_n = lines_per_page * (max_pages // 2)
+        last_n = lines_per_page * (max_pages // 2)
+        selected = lines[:first_n] + lines[-last_n:]
+    else:
+        selected = list(lines)
+
+    pages = max(1, math.ceil(len(selected) / lines_per_page))
+    return ExtractResult(
+        lines=selected,
+        pages=pages,
+        capped=capped,
+        original_non_empty_lines=original_non_empty_lines,
+        original_pages_ceil=original_pages_ceil,
+    )
+
+
+def pad_to_multiple(lines: list[str], lines_per_page: int) -> list[str]:
+    if not lines:
+        return [""] * lines_per_page
+    remainder = len(lines) % lines_per_page
+    if remainder == 0:
+        return lines
+    return lines + [""] * (lines_per_page - remainder)
+
+
+def fit_line_to_width(
+    line: str, fonts: RenderFonts, font_size: float, max_width: float
+) -> str:
+    if _mixed_line_width(line, fonts, font_size) <= max_width:
+        return line
+    lo, hi = 0, len(line)
+    while lo < hi:
+        mid = (lo + hi + 1) // 2
+        if _mixed_line_width(line[:mid], fonts, font_size) <= max_width:
+            lo = mid
+        else:
+            hi = mid - 1
+    ell = "…"
+    ell_w = _mixed_line_width(ell, fonts, font_size)
+    while lo > 0 and _mixed_line_width(line[:lo], fonts, font_size) + ell_w > max_width:
+        lo -= 1
+    if lo <= 0:
+        return ell
+    return line[:lo] + ell
+
+
+def draw_pdf(
+    out_path: Path,
+    all_lines: list[str],
+    *,
+    fonts: RenderFonts,
+    lines_per_page: int,
+    software_name: str,
+    version: str,
+    font_size: float = 8.5,
+) -> None:
+    page_w, page_h = A4
+    left = 2 * cm
+    right = 2 * cm
+    top = 2 * cm
+    bottom = 2 * cm
+
+    sep_gap = 0.25 * cm
+
+    c = canvas.Canvas(str(out_path), pagesize=A4)
+    c.setTitle(f"{software_name} {version} — 源代码节选")
+    c.setAuthor(software_name)
+
+    header_baseline_y = page_h - top - 0.35 * cm
+    sep_y = header_baseline_y - 0.35 * cm
+
+    content_top = sep_y - sep_gap
+    content_bottom = bottom + 0.5 * cm
+    if lines_per_page <= 1:
+        line_step = max(content_top - content_bottom, 1.0)
+    else:
+        line_step = (content_top - content_bottom) / (lines_per_page - 1)
+
+    max_text_width = page_w - left - right
+    truncated_count = 0
+
+    n = len(all_lines)
+    if n % lines_per_page != 0:
+        raise ValueError("all_lines 长度必须是 lines_per_page 的整数倍（请先 pad）")
+
+    total_pages = n // lines_per_page
+
+    for page_no in range(1, total_pages + 1):
+        left_text = f"{software_name} {version}"
+        _draw_line(c, left, header_baseline_y, left_text, fonts, font_size)
+
+        page_label = str(page_no)
+        page_font = fonts.latin_font or fonts.primary
+        pw = pdfmetrics.stringWidth(page_label, page_font, font_size)
+        c.setFont(page_font, font_size)
+        c.drawString(page_w - right - pw, header_baseline_y, page_label)
+
+        c.setLineWidth(0.3)
+        c.line(left, sep_y, page_w - right, sep_y)
+
+        start = (page_no - 1) * lines_per_page
+        page_slice = all_lines[start : start + lines_per_page]
+
+        for i, raw in enumerate(page_slice):
+            y = content_top - i * line_step
+            fitted = fit_line_to_width(raw, fonts, font_size, max_text_width)
+            if fitted != raw and raw:
+                truncated_count += 1
+            _draw_line(c, left, y, fitted, fonts, font_size)
+
+        c.showPage()
+
+    if truncated_count:
+        print(
+            f"提示：共有 {truncated_count} 行因超宽被截断（可减小字号或换更窄字体）。",
+            file=sys.stderr,
+        )
+
+    c.save()
+
+
+def parse_args() -> argparse.Namespace:
+    p = argparse.ArgumentParser(
+        description="将源码目录整理为软著申报用 PDF（reportlab）",
+    )
+    p.add_argument(
+        "--root",
+        type=Path,
+        default=None,
+        help="源码根目录（默认使用脚本内 SOURCE_ROOT）",
+    )
+    p.add_argument(
+        "--out",
+        type=Path,
+        default=None,
+        help="输出 PDF 路径（默认使用脚本内 OUTPUT_PDF）",
+    )
+    p.add_argument(
+        "--font",
+        type=Path,
+        default=None,
+        help="CJK 等宽字体 TTF/OTF（默认使用脚本内 CJK_MONO_FONT_PATH）",
+    )
+    p.add_argument(
+        "--name",
+        default=None,
+        help="软件全称（默认脚本内 SOFTWARE_FULL_NAME）",
+    )
+    p.add_argument(
+        "--version",
+        dest="version_str",
+        default=None,
+        help="版本号（默认脚本内 VERSION）",
+    )
+    p.add_argument(
+        "--font-size",
+        type=float,
+        default=8.3,
+        help="正文字号（略小可减少超长行截断，默认 8.3）",
+    )
+    p.add_argument(
+        "--no-cid",
+        action="store_true",
+        help="不使用 Adobe STSong-Light（CID），仅尝试 TrueType 轮廓（Menlo 等），中文更易缺失",
+    )
+    return p.parse_args()
+
+
+def main() -> int:
+    args = parse_args()
+    root = args.root or SOURCE_ROOT
+    out_pdf = args.out or OUTPUT_PDF
+    font_path = args.font
+    if font_path is None:
+        font_path = CJK_MONO_FONT_PATH
+    name = args.name or SOFTWARE_FULL_NAME
+    ver = args.version_str or VERSION
+
+    if not root.is_dir():
+        print(f"错误：源码根目录不存在或不是目录：{root}", file=sys.stderr)
+        return 1
+
+    files = sorted(iter_source_files(root), key=lambda p: p.as_posix())
+    lines = read_nonempty_lines_from_files(files)
+    result = extract_for_pdf(lines)
+    padded = pad_to_multiple(result.lines, LINES_PER_PAGE)
+
+    fonts = register_font(font_path, no_cid=args.no_cid)
+
+    out_pdf.parent.mkdir(parents=True, exist_ok=True)
+    draw_pdf(
+        out_pdf,
+        padded,
+        fonts=fonts,
+        lines_per_page=LINES_PER_PAGE,
+        software_name=name,
+        version=ver,
+        font_size=args.font_size,
+    )
+
+    out_pages = len(padded) // LINES_PER_PAGE
+    print(
+        "完成：",
+        f"源非空行 {result.original_non_empty_lines}（按 50 行/页约 {result.original_pages_ceil} 页）",
+        f"节选后 {len(result.lines)} 行",
+        f"输出 {out_pdf} 共 {out_pages} 页",
+        f" capped={result.capped}",
+    )
+    return 0
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())