feat: Add new files for i18n, libs, and project structure

2026-08-14 03:18:04 +00:00 · 2025-12-18 13:33:30 +08:00
parent 516ac26f93
commit bfa0694868
750 changed files with 112255 additions and 0 deletions
@@ -0,0 +1,118 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+"""
+docs_to_excel.py
+
+Documents → Excel converter: rebuild a workbook from prompts folders.
+
+Rules (per STRUCTURE_AND_CONVERSION_SPEC.md):
+- Each folder under prompt-library/prompts that matches "(N)_<name>" or any folder is a sheet
+- For each file matching "(r,c)_*.md", write its full text to Excel cell (r,c), 1-based
+- Title part in filename is ignored for cell value
+- Non-matching files are ignored
+- Optionally clears existing workbook or merges (default: overwrite generate new)
+
+Usage:
+  python prompt-library/scripts/docs_to_excel.py --out "rebuilt.xlsx"
+  # optional: --prompts-dir prompt-library/prompts --clear
+"""
+from __future__ import annotations
+
+import argparse
+import re
+from pathlib import Path
+from typing import Dict, Tuple
+
+import pandas as pd
+from openpyxl import Workbook
+
+FOLDER_PREFIX_RE = re.compile(r"^\((\d+)\)_")
+FILE_NAME_RE = re.compile(r"^\((\d+),(\d+)\)_.*\.md$")
+
+
+def parse_args() -> argparse.Namespace:
+    p = argparse.ArgumentParser(description="Rebuild Excel workbook from prompt folders")
+    p.add_argument("--prompts-dir", type=str, default="prompt-library/prompts", help="Prompts root directory")
+    p.add_argument("--out", type=str, required=True, help="Output Excel file path")
+    return p.parse_args()
+
+
+def list_sheet_folders(prompts_root: Path) -> Dict[str, Path]:
+    sheets: Dict[str, Path] = {}
+    for child in sorted(prompts_root.iterdir()):
+        if not child.is_dir():
+            continue
+        if child.name == "prompt-category":
+            # legacy; skip auto-generated category
+            continue
+        sheets[child.name] = child
+    return sheets
+
+
+def extract_rc(name: str) -> Tuple[int, int] | None:
+    m = FILE_NAME_RE.match(name)
+    if not m:
+        return None
+    r = int(m.group(1))
+    c = int(m.group(2))
+    return r, c
+
+
+def main() -> None:
+    args = parse_args()
+    prompts_root = Path(args.prompts_dir).resolve()
+    out_path = Path(args.out).resolve()
+
+    if not prompts_root.exists():
+        raise FileNotFoundError(f"Prompts directory not found: {prompts_root}")
+
+    sheet_folders = list_sheet_folders(prompts_root)
+    if not sheet_folders:
+        raise RuntimeError("No sheet folders found under prompts root")
+
+    wb = Workbook()
+    # remove default sheet
+    default = wb.active
+    wb.remove(default)
+
+    for folder_name, folder_path in sheet_folders.items():
+        # Recover original sheet name (try to drop ordering prefix "(N)_")
+        m = FOLDER_PREFIX_RE.match(folder_name)
+        sheet_name = folder_name[m.end():] if m else folder_name
+        if not sheet_name:
+            sheet_name = folder_name
+        ws = wb.create_sheet(title=sheet_name)
+
+        # Aggregate cells
+        max_row = 0
+        max_col = 0
+        cells: Dict[Tuple[int, int], str] = {}
+        for file in folder_path.iterdir():
+            if not file.is_file() or not file.name.endswith('.md'):
+                continue
+            rc = extract_rc(file.name)
+            if not rc:
+                continue
+            r, c = rc
+            text = file.read_text(encoding='utf-8')
+            # Trim a single trailing newline for cell value aesthetics
+            if text.endswith("\n"):
+                text = text[:-1]
+            cells[(r, c)] = text
+            if r > max_row:
+                max_row = r
+            if c > max_col:
+                max_col = c
+
+        # Write into sheet
+        for (r, c), val in cells.items():
+            ws.cell(row=r, column=c, value=val)
+
+    # Save workbook
+    out_path.parent.mkdir(parents=True, exist_ok=True)
+    wb.save(str(out_path))
+    print(f"✅ Rebuilt Excel saved to: {out_path}")
+
+
+if __name__ == "__main__":
+    main()