技能介绍

解决题库 Markdown 同步的格式与数据一致性问题

在维护 GESP 和 CSP 等计算机等级考试题库时，经常面临 Markdown 稿件格式混乱、两站（tk 题库与 OJ 判题机）数据同步不一致的难题。裸写的代码符号如 C++、a^b 或 int *p 会被 Markdown 解析器误伤，导致公式错乱；同时，客观题与编程题的入库逻辑完全不同，混用会导致数据覆盖或丢失。本技能旨在通过一套严格的校验与同步规则，确保权威源稿件能准确、安全地落入现网数据库。

核心能力与双线处理流程

本技能将同步工作严格拆分为两条互不干涉的线：

客观题同步线：稿件存放在 10_卷子/ 目录。导入 tk 管理端时，通过 POST /api/import/questions 按 标题 进行 upsert 以保留原 ID。题型严格限制为单选、多选、判断、填空（实操题在 tk 端解析为填空）。导入后，通过 tk 的 "同步题库站" 功能将题目 poke 到 OJ 客观题表。
GESP 编程题写库线：稿件存放在 编程题/ 目录。以官方 PDF 为终审标准，结合洛谷题页 DOM 进行交叉核对。核对无误后，使用 apply_gesp_statements.py 脚本，仅执行 UPDATE 操作，且严格限制题号为 GE* 及同题副本 G*，绝不触碰 CD* 或 WL* 等非权威题库。

适用边界与安全注意点

在使用本技能时，必须遵守以下工程红线：

真值来源唯一性：官方 PDF 是最终事实来源，拿不准必须记入 40_修复台账/，严禁凭空捏造。洛谷仅作为交叉核对旁证，严禁使用洛谷 dump 作为正文源或使用其 CDN 图片。
格式防御：所有 C++ 关键字、运算符（如 ++i、==）必须包裹在行内代码或 $...$ 中，防止被 markdown-it 插件吞掉或转换。
安全与备份：凭证、cookie 和数据库同步密钥绝不写入技能文件或仓库。在执行任何写库操作前，必须备份 problem 题面（如 problem_stmt_bak_gesp_*）。
目录隔离：权威仓仅限 ~/Documents/reputable-sources/，切勿写回已删除的 Desktop 目录，也不要将编程题误导入客观题库。