初始化模板仓库

This commit is contained in:
2026-04-08 13:55:17 +08:00
commit 61a435965f
9 changed files with 1019 additions and 0 deletions

70
scripts/common.py Normal file
View File

@ -0,0 +1,70 @@
"""Common utilities shared between img2typ and solve scripts."""
import logging
import os
from pathlib import Path
from dotenv import load_dotenv
from rich.console import Console
from rich.logging import RichHandler
from rich.theme import Theme
console = Console(
theme=Theme({"info": "cyan", "warning": "yellow", "error": "bold red"})
)
SCRIPT_DIR = Path(__file__).parent
DATA_DIR = SCRIPT_DIR.parent / "data"
ENV_FILE = SCRIPT_DIR / ".env"
def setup_logging(name: str, verbose: bool) -> logging.Logger:
"""Setup logging with rich handler."""
level = logging.DEBUG if verbose else logging.INFO
logging.basicConfig(
level=level,
format="%(message)s",
datefmt="[%X]",
handlers=[RichHandler(console=console, rich_tracebacks=True)],
)
return logging.getLogger(name)
def load_env() -> dict[str, str]:
"""Load environment variables from .env file."""
if ENV_FILE.exists():
load_dotenv(ENV_FILE)
else:
console.print(f"[yellow]Warning: .env file not found at {ENV_FILE}[/yellow]")
api_endpoint = os.environ.get("IMG2TYP_API_ENDPOINT", "")
api_key = os.environ.get("IMG2TYP_API_KEY", "")
api_model = os.environ.get("IMG2TYP_MODEL", "qwen-vl-plus")
if not api_endpoint:
console.print("[yellow]Warning: IMG2TYP_API_ENDPOINT not set[/yellow]")
if not api_key:
console.print("[yellow]Warning: IMG2TYP_API_KEY not set[/yellow]")
return {"endpoint": api_endpoint, "key": api_key, "model": api_model}
def load_prompt(filename: str) -> str:
"""Load a prompt template from file."""
prompt_path = SCRIPT_DIR / filename
if not prompt_path.exists():
console.print(
f"[yellow]Warning: Prompt file not found at {prompt_path}[/yellow]"
)
return ""
return prompt_path.read_text(encoding="utf-8")
def find_attachments(question: str) -> list[str]:
"""Find all attachment files for a given question."""
attachments = []
question_prefix = question + "_"
for file_path in DATA_DIR.iterdir():
if file_path.is_file() and file_path.name.startswith(question_prefix):
attachments.append(file_path.name)
return sorted(attachments)

156
scripts/gen_index.py Normal file
View File

@ -0,0 +1,156 @@
#!/usr/bin/env python3
"""
gen_index.py - Generate index.typ from questions.json.
This script generates an index.typ file that includes all questions
and their answers in the specified format.
"""
import argparse
import sys
from pathlib import Path
from rich.console import Console
from common import DATA_DIR, setup_logging
console = Console()
def load_questions_json() -> list[dict]:
"""Load questions from questions.json."""
questions_path = DATA_DIR / "questions.json"
if not questions_path.exists():
console.print(f"[red]Error: questions.json not found at {questions_path}[/red]")
sys.exit(1)
import json
with open(questions_path, "r", encoding="utf-8") as f:
return json.load(f)
def read_typ_content(target: str) -> str | None:
"""Read typ file content."""
typ_path = DATA_DIR / target
if not typ_path.exists():
console.print(f"[yellow]Warning: {target} not found[/yellow]")
return None
try:
return typ_path.read_text(encoding="utf-8")
except Exception as e:
console.print(f"[yellow]Warning: Failed to read {target}: {e}[/yellow]")
return None
def indent_text(text: str, indent: int = 2) -> str:
"""Indent text by specified spaces."""
lines = text.strip().split("\n")
spaces = " " * indent
return "\n".join(spaces + line if line.strip() else "" for line in lines)
def generate_index(questions: list[dict], dry_run: bool, logger) -> str:
"""Generate index.typ content."""
lines = [
'#import "@local/phomework:0.1.0": homework, question, answer, shadow',
"",
]
enable_shadow = (
"true"
if any(DATA_DIR / f"A_{q['question']}.md" for q in questions)
else "false"
)
lines.append(
f'#homework(title: "计算机网络第三次作业", secret: read(".secret"), enable_shadow: {enable_shadow})['
)
def sort_key(q: dict) -> tuple:
name = q["question"]
prefix = name[0]
try:
num = int(name[1:])
except ValueError:
num = float("inf")
return (0 if prefix == "R" else 1, prefix, num)
sorted_questions = sorted(questions, key=sort_key)
for q in sorted_questions:
question_name = q["question"]
typ_target = q["target"]
lines.append(f' #question(title: "{question_name}")[')
content = read_typ_content(typ_target)
if content:
lines.append(indent_text(content, 4))
else:
lines.append(" [题目内容加载失败]")
lines.append(" ]")
lines.append("")
lines.append(" #answer[")
answer_file = DATA_DIR / f"A_{question_name}.md"
if answer_file.exists():
lines.append(" 请填写答案。")
lines.append("")
lines.append(f' #shadow(read("./data/A_{question_name}.md"))')
else:
lines.append(" [答案文件不存在]")
lines.append(" ]")
lines.append("]")
return "\n".join(lines) + "\n"
def parse_args() -> argparse.Namespace:
"""Parse command line arguments."""
parser = argparse.ArgumentParser(
description="Generate index.typ from questions.json"
)
parser.add_argument("--dry-run", action="store_true", help="Do not write files")
parser.add_argument(
"--force", action="store_true", help="Force overwrite without warning"
)
parser.add_argument("--verbose", action="store_true", help="Enable debug logging")
return parser.parse_args()
def main() -> None:
"""Main entry point."""
args = parse_args()
logger = setup_logging("gen_index", args.verbose)
questions = load_questions_json()
logger.info(f"Loaded {len(questions)} questions")
if not questions:
console.print("[yellow]No questions found in questions.json[/yellow]")
sys.exit(1)
content = generate_index(questions, args.dry_run, logger)
output_path = Path("index.typ")
if output_path.exists() and not args.force and not args.dry_run:
console.print(
f"[yellow]Warning: {output_path} already exists and will be overwritten![/yellow]"
)
response = input("Continue? [y/N]: ")
if response.lower() != "y":
console.print("[yellow]Aborted.[/yellow]")
sys.exit(0)
if args.dry_run:
logger.info(f"[DRY-RUN] Would write {output_path}")
logger.debug(f"Content preview:\n{content[:500]}...")
else:
output_path.write_text(content, encoding="utf-8")
logger.info(f"Wrote {output_path}")
console.print(f"[green]Successfully wrote {output_path}[/green]")
if __name__ == "__main__":
main()

View File

@ -0,0 +1,27 @@
请你将这道题的题目内容提取出来,并转写成 Typst 格式,不包含题号。
题目内容请用代码块包裹起来。如果有多个小问,每个小问之间应该有两个换行符。如果题目有图片,则用 `[图片1]` 的格式表示占位,但不需要描述图片。
你的回答应该形如这样:
```typst
在简化的路径损耗模型下,考虑一对距离为 $r$ 的收发信机,接收端的噪声功率为 $-150"dBm"$,……
考虑如下公式:
$
y <= k x + b
$
……
// snip
[图片1]
1. 请问……
2. 请问……
// snip
```

343
scripts/img2typ.py Normal file
View File

@ -0,0 +1,343 @@
#!/usr/bin/env python3
"""
img2typ.py - Convert image files to typst format using AI API.
This script scans the data directory for image files matching a pattern,
converts them to typst format using an OpenAI-compatible API, and generates
a questions.json manifest.
"""
import argparse
import asyncio
import json
import logging
import re
import sys
from dataclasses import dataclass
from pathlib import Path
import aiohttp
from common import DATA_DIR, console, load_env, load_prompt, setup_logging
IMAGE_PATTERN = re.compile(r"^(\S)\s?([\d.]+)$")
EXCLUDED_PREFIXES = {"", "A", "a"}
IMAGE_EXTENSIONS = {
".png",
".jpg",
".jpeg",
".gif",
".bmp",
".webp",
".PNG",
".JPG",
".JPEG",
".GIF",
".BMP",
".WEBP",
}
@dataclass
class ConversionResult:
"""Result of an image to typst conversion."""
question: str
target: str
skipped: bool
success: bool
error: str | None = None
def find_images() -> list[Path]:
"""Find all image files in data directory matching the pattern."""
images = []
for file_path in DATA_DIR.iterdir():
if file_path.is_file() and file_path.suffix in IMAGE_EXTENSIONS:
stem = file_path.stem
match = IMAGE_PATTERN.match(stem)
if match and match.group(1) not in EXCLUDED_PREFIXES:
images.append(file_path)
return images
def check_typ_exists(image_path: Path) -> bool:
"""Check if corresponding .typ file exists."""
return image_path.with_suffix(".typ").exists()
def parse_markdown_blocks(text: str) -> str:
"""Remove markdown code blocks from text."""
block_pattern = re.compile(r"```(?:typst)?\s*\n?(.*?)\n?```", re.DOTALL)
matches = list(block_pattern.finditer(text))
if matches:
return matches[0].group(1).strip()
return text.strip()
async def call_api(
session: aiohttp.ClientSession,
image_path: Path,
prompt: str,
endpoint: str,
api_key: str,
model: str,
logger: logging.Logger,
) -> str | None:
"""Call the AI API to convert image to typst format."""
import base64
headers = {"Authorization": f"Bearer {api_key}", "Content-Type": "application/json"}
with open(image_path, "rb") as f:
image_data = base64.b64encode(f.read()).decode("utf-8")
payload = {
"model": model,
"messages": [
{
"role": "user",
"content": [
{"type": "text", "text": prompt},
{
"type": "image_url",
"image_url": {
"url": f"data:image/{image_path.suffix[1:]};base64,{image_data}"
},
},
],
}
],
"max_tokens": 4096,
}
logger.info(f"[{image_path.stem}] Converting... (timeout 300s)")
try:
async with session.post(
endpoint,
headers=headers,
json=payload,
timeout=aiohttp.ClientTimeout(total=300),
) as response:
response.raise_for_status()
result = await response.json()
if "choices" not in result or len(result["choices"]) == 0:
logger.error(f"Invalid API response")
return None
content = result["choices"][0]["message"]["content"]
usage = result.get("usage", {})
input_tokens = usage.get("prompt_tokens", 0)
output_tokens = usage.get("completion_tokens", 0)
logger.info(
f"[{image_path.stem}] Done: {input_tokens} in, {output_tokens} out"
)
return content
except asyncio.TimeoutError:
logger.error(f"[{image_path.stem}] Timeout")
return None
except asyncio.CancelledError:
logger.warning(f"[{image_path.stem}] Cancelled")
raise
except Exception as e:
logger.error(f"[{image_path.stem}] Error: {e}")
return None
async def convert_image(
session: aiohttp.ClientSession,
image_path: Path,
prompt: str,
api_config: dict,
logger: logging.Logger,
dry_run: bool,
) -> ConversionResult:
"""Convert a single image to typst format."""
stem = image_path.stem
match = IMAGE_PATTERN.match(stem)
question_name = match.group(1) + match.group(2) if match else stem
typ_path = image_path.with_suffix(".typ")
if typ_path.exists():
logger.info(f"[{question_name}] Skipping: .typ already exists")
return ConversionResult(
question=question_name, target=typ_path.name, skipped=True, success=True
)
if dry_run:
logger.info(f"[{question_name}] Would convert -> {typ_path.name}")
return ConversionResult(
question=question_name, target=typ_path.name, skipped=False, success=True
)
content = await call_api(
session,
image_path,
prompt,
str(api_config["endpoint"]),
api_config["key"],
api_config["model"],
logger,
)
if content is None:
return ConversionResult(
question=question_name,
target=typ_path.name,
skipped=False,
success=False,
error="API call failed",
)
typst_code = parse_markdown_blocks(content)
try:
typ_path.write_text(typst_code, encoding="utf-8")
logger.info(
f"[{question_name}] Wrote {typ_path.name} ({len(typst_code)} bytes)"
)
return ConversionResult(
question=question_name, target=typ_path.name, skipped=False, success=True
)
except IOError as e:
logger.error(f"[{question_name}] Write failed: {e}")
return ConversionResult(
question=question_name,
target=typ_path.name,
skipped=False,
success=False,
error=str(e),
)
def generate_questions_json(
results: list[ConversionResult],
logger: logging.Logger,
dry_run: bool,
) -> None:
"""Generate questions.json from conversion results."""
from common import find_attachments
questions = []
for r in results:
attachments = find_attachments(r.question)
questions.append(
{
"question": r.question,
"format": "typst",
"target": r.target,
"attachments": attachments,
}
)
output_path = DATA_DIR / "questions.json"
if dry_run:
logger.info(
f"[DRY-RUN] Would write questions.json with {len(questions)} entries"
)
logger.debug(f"Content: {json.dumps(questions, indent=4, ensure_ascii=False)}")
else:
output_path.write_text(
json.dumps(questions, indent=4, ensure_ascii=False), encoding="utf-8"
)
logger.info(f"Wrote {output_path.name} ({len(questions)} entries)")
def parse_args() -> argparse.Namespace:
"""Parse command line arguments."""
parser = argparse.ArgumentParser(
description="Convert image files to typst format using AI API"
)
parser.add_argument(
"-f",
"--file",
action="append",
dest="files",
help="Specific image files to process",
)
parser.add_argument(
"--dry-run", action="store_true", help="Do not call AI or write files"
)
parser.add_argument("--verbose", action="store_true", help="Enable debug logging")
parser.add_argument(
"--retry", type=int, default=3, help="Retry attempts (default: 3)"
)
parser.add_argument("-n", type=int, default=3, help="Concurrent limit (default: 3)")
return parser.parse_args()
async def async_main(args: argparse.Namespace, logger: logging.Logger) -> None:
"""Async main entry point."""
if args.files:
image_paths = []
for f in args.files:
p = Path(f)
if not p.is_absolute():
p = DATA_DIR / f
image_paths.append(p)
else:
image_paths = find_images()
logger.info(f"Found {len(image_paths)} images to process")
if not image_paths:
logger.warning("No images found to process")
return
api_config = load_env()
prompt = load_prompt("img2typ.prompt.txt")
semaphore = asyncio.Semaphore(args.n)
async def limited_convert(
session: aiohttp.ClientSession, img_path: Path
) -> ConversionResult:
async with semaphore:
return await convert_image(
session, img_path, prompt, api_config, logger, args.dry_run
)
async with aiohttp.ClientSession() as session:
tasks = [
asyncio.create_task(limited_convert(session, img)) for img in image_paths
]
results = []
try:
for coro in asyncio.as_completed(tasks):
result = await coro
results.append(result)
except asyncio.CancelledError:
logger.warning("Cancelled! Shutting down...")
for task in tasks:
task.cancel()
await asyncio.gather(*tasks, return_exceptions=True)
sys.exit(1)
results.sort(key=lambda r: r.question)
generate_questions_json(results, logger, args.dry_run)
skipped = sum(1 for r in results if r.skipped)
solved = sum(1 for r in results if r.success and not r.skipped)
logger.info(f"Complete: {solved}/{len(results)} converted, {skipped} skipped")
def main() -> None:
"""Main entry point."""
args = parse_args()
logger = setup_logging("img2typ", args.verbose)
logger.info(f"img2typ starting (Dry-run: {args.dry_run}, Workers: {args.n})")
logger.info(f"Data directory: {DATA_DIR}")
try:
asyncio.run(async_main(args, logger))
except KeyboardInterrupt:
logger.warning("Interrupted by user")
sys.exit(1)
if __name__ == "__main__":
main()

20
scripts/solve.prompt.txt Normal file
View File

@ -0,0 +1,20 @@
请根据提供的 typst 内容(包括可能的图片附件),给出一个完整的解答,包括:
1. **解答文本**:问题的直接答案,格式清晰。
2. **答题思路**:逐步解释你如何得出答案,展示你的计算过程和逻辑推理。
3. **相关知识点**:与这道题相关的关键概念、公式或原理。
请使用以下 Markdown 格式输出(不要使用代码块包裹主要内容):
# 解答
[你的直接答案]
# 答题思路
[你的逐步推理过程]
# 相关知识点
[关键概念和公式]
如果题目包含图片附件,请仔细分析后再给出解答。

310
scripts/solve.py Normal file
View File

@ -0,0 +1,310 @@
#!/usr/bin/env python3
"""
solve.py - Solve questions defined in questions.json using AI API.
This script reads questions.json, processes each question with corresponding
typst files and attachments, and generates answer Markdown files.
"""
import argparse
import asyncio
import json
import logging
import sys
from dataclasses import dataclass
from pathlib import Path
import aiohttp
from common import (
DATA_DIR,
console,
find_attachments,
load_env,
load_prompt,
setup_logging,
)
@dataclass
class SolveResult:
"""Result of solving a question."""
question: str
target: str
skipped: bool
success: bool
error: str | None = None
def load_questions_json() -> list[dict]:
"""Load questions from questions.json."""
questions_path = DATA_DIR / "questions.json"
if not questions_path.exists():
console.print(
f"[yellow]Warning: questions.json not found at {questions_path}[/yellow]"
)
return []
with open(questions_path, "r", encoding="utf-8") as f:
return json.load(f)
def build_prompt(question_data: dict, typ_content: str | None) -> str:
"""Build the full prompt including typst content and attachments info."""
base_prompt = load_prompt("solve.prompt.txt")
if not base_prompt:
base_prompt = "请解答这道题。"
parts = [base_prompt, "\n\n"]
if typ_content:
parts.append("## 题目描述 (来自 .typ 文件):\n")
parts.append(typ_content)
parts.append("\n\n")
attachments = question_data.get("attachments", [])
if attachments:
parts.append("## 附件:\n")
for att in attachments:
att_path = DATA_DIR / att
if att_path.exists():
if att.lower().endswith(
(".png", ".jpg", ".jpeg", ".gif", ".bmp", ".webp")
):
parts.append(f"- [图片附件: {att}]\n")
else:
try:
content = att_path.read_text(encoding="utf-8")
parts.append(f"- {att}:\n```\n{content}\n```\n")
except:
parts.append(f"- {att} (二进制文件)\n")
parts.append("\n")
return "".join(parts)
async def call_api_streaming(
session: aiohttp.ClientSession,
question_name: str,
prompt: str,
endpoint: str,
api_key: str,
model: str,
logger: logging.Logger,
) -> str | None:
"""Call the AI API with streaming to solve the question."""
headers = {"Authorization": f"Bearer {api_key}", "Content-Type": "application/json"}
payload = {
"model": model,
"messages": [{"role": "user", "content": [{"type": "text", "text": prompt}]}],
"max_tokens": 4096,
"stream": True,
}
logger.info(f"[{question_name}] Thinking... (timeout 600s)")
try:
async with session.post(
endpoint,
headers=headers,
json=payload,
timeout=aiohttp.ClientTimeout(total=600),
) as response:
response.raise_for_status()
full_content = []
async for line in response.content:
if not line:
continue
line = line.decode("utf-8")
if line.startswith("data: "):
data = line[6:]
if data == "[DONE]":
continue
try:
chunk = json.loads(data)
logger.debug(f"[{question_name}] Chunk: {chunk}")
delta = chunk.get("choices", [{}])[0].get("delta", {})
content = delta.get("content")
if content:
full_content.append(content)
except json.JSONDecodeError:
continue
content = "".join(full_content)
if not content:
logger.warning(f"[{question_name}] Empty response")
return None
logger.info(f"[{question_name}] Done ({len(content)} chars)")
return content
except asyncio.TimeoutError:
logger.error(f"[{question_name}] Timeout")
return None
except asyncio.CancelledError:
logger.warning(f"[{question_name}] Cancelled")
raise
except Exception as e:
logger.error(f"[{question_name}] Error: {e}")
return None
async def solve_question(
session: aiohttp.ClientSession,
question_data: dict,
api_config: dict,
logger: logging.Logger,
dry_run: bool,
) -> SolveResult:
"""Solve a single question and generate answer markdown."""
question_name = question_data["question"]
target_name = f"A_{question_name}.md"
target_path = DATA_DIR / target_name
if target_path.exists():
logger.info(f"[{question_name}] Skipping: answer already exists")
return SolveResult(
question=question_name, target=target_name, skipped=True, success=True
)
typ_path = DATA_DIR / question_data["target"]
typ_content = None
if typ_path.exists():
try:
typ_content = typ_path.read_text(encoding="utf-8")
except:
typ_content = None
if dry_run:
logger.info(f"[{question_name}] Would solve -> {target_name}")
return SolveResult(
question=question_name, target=target_name, skipped=False, success=True
)
prompt = build_prompt(question_data, typ_content)
content = await call_api_streaming(
session,
question_name,
prompt,
str(api_config["endpoint"]),
api_config["key"],
api_config["model"],
logger,
)
if content is None:
return SolveResult(
question=question_name,
target=target_name,
skipped=False,
success=False,
error="API call failed",
)
try:
target_path.write_text(content, encoding="utf-8")
logger.info(f"[{question_name}] Wrote {target_name} ({len(content)} bytes)")
return SolveResult(
question=question_name, target=target_name, skipped=False, success=True
)
except IOError as e:
logger.error(f"[{question_name}] Write failed: {e}")
return SolveResult(
question=question_name,
target=target_name,
skipped=False,
success=False,
error=str(e),
)
def parse_args() -> argparse.Namespace:
"""Parse command line arguments."""
parser = argparse.ArgumentParser(
description="Solve questions from questions.json using AI API"
)
parser.add_argument(
"-q",
"--question",
action="append",
dest="questions",
help="Specific question IDs to solve (e.g., P15)",
)
parser.add_argument(
"--dry-run", action="store_true", help="Do not call AI or write files"
)
parser.add_argument("--verbose", action="store_true", help="Enable debug logging")
parser.add_argument(
"--retry", type=int, default=3, help="Retry attempts (default: 3)"
)
parser.add_argument("-n", type=int, default=3, help="Concurrent limit (default: 3)")
return parser.parse_args()
async def async_main(args: argparse.Namespace, logger: logging.Logger) -> None:
"""Async main entry point."""
questions = load_questions_json()
if not questions:
logger.warning("No questions found in questions.json")
return
if args.questions:
questions = [q for q in questions if q["question"] in args.questions]
logger.info(f"Processing: {[q['question'] for q in questions]}")
else:
logger.info(
f"Found {len(questions)} questions: {[q['question'] for q in questions]}"
)
if not questions:
logger.warning("No matching questions found")
return
api_config = load_env()
semaphore = asyncio.Semaphore(args.n)
async def limited_solve(session: aiohttp.ClientSession, q: dict) -> SolveResult:
async with semaphore:
return await solve_question(session, q, api_config, logger, args.dry_run)
async with aiohttp.ClientSession() as session:
tasks = [asyncio.create_task(limited_solve(session, q)) for q in questions]
results = []
try:
for coro in asyncio.as_completed(tasks):
result = await coro
results.append(result)
except asyncio.CancelledError:
logger.warning("Cancelled! Shutting down...")
for task in tasks:
task.cancel()
await asyncio.gather(*tasks, return_exceptions=True)
sys.exit(1)
results.sort(key=lambda r: r.question)
skipped = sum(1 for r in results if r.skipped)
solved = sum(1 for r in results if r.success and not r.skipped)
logger.info(f"Complete: {solved}/{len(results)} solved, {skipped} skipped")
def main() -> None:
"""Main entry point."""
args = parse_args()
logger = setup_logging("solve", args.verbose)
logger.info(f"solve starting (Dry-run: {args.dry_run}, Workers: {args.n})")
logger.info(f"Data directory: {DATA_DIR}")
try:
asyncio.run(async_main(args, logger))
except KeyboardInterrupt:
logger.warning("Interrupted by user")
sys.exit(1)
if __name__ == "__main__":
main()