陕师大校园考古实地打卡
Overview
把陕西师范大学（长安校区 + 雁塔校区）当作一座「露天考古博物馆」，引导学生、游客或新生在真实坐标上完成考古 / 文物 / 碑刻 / 历史地标打卡，并用脚本记录进度、生成专属「考古护照」。
本技能提供：19 个真实打卡点的权威数据（references/checkin-points.md + assets/data.js）、一个开箱即用的 Web 应用（assets/index.html，支持点位详情与藏品图标、答题积分、腾讯地图导航、图文打卡与二创上传、分享海报、积分徽章墙）、一个可选的命令行脚本（scripts/checkin.py），以及一张可打印的 HTML 护照模板（assets/certificate_template.html）。
When to Use
- 用户要在陕师大校园内组织 / 参与考古、研学、寻古、新生教育类打卡活动。
- 用户询问「陕师大有哪些值得打卡的文物 / 古迹 / 书画 / 古籍」「校园里哪里能考古」「给我规划一条校园打卡路线」。
- 用户需要记录打卡进度、统计完成情况、一键生成分校区路线图、或导出一张纪念证书。
- 用户要做答题积分 / 集徽章（每点答题 +10 分，50/60/70/90/100 分解锁 5 级陕师大校徽）、接入腾讯地图导航前往打卡点、拍照写字打卡并上传二创作品、或生成分享海报发朋友圈 / 发给朋友。
- 涉及的具体真实点位（共 16 个，详见
references/checkin-points.md）包括：教育博物馆四馆（历史文化馆·战国秦封宗邑瓦书、书画艺术馆·唐寅郑板桥拓片、妇女文化馆·她的故事/女书嫁衣、中国教育馆）、红烛校史馆、启功题校名石、银杏大道、长安校区图书馆（古籍/拓片）、岩矿数字博物馆、气象园、畅志园碑林、启夏苑（唐启夏门故址）、雁塔校区图书馆、隋唐天坛圜丘、曲江流饮·吴家坟。
Workflow
1. 介绍活动 & 列点
向用户说明玩法：校园即露天考古博物馆，走到打卡点 → 完成任务 → 记录 → 集证。
读取 references/checkin-points.md 获取全部打卡点的地点、考古看点、打卡任务、难度，按需复述给用户（不要一次倾倒全部，可按校区或兴趣筛选）。
2. 初始化记录
在用户的工作目录运行（脚本仅用标准库，无需联网）：
python <skill>/scripts/checkin.py init
python <skill>/scripts/checkin.py setname "<用户的昵称>"
之后用 checkin.py list 展示全部点位与状态，checkin.py status 查看进度。
3. 打卡
用户到达某点并完成打卡任务后，记录：
python <skill>/scripts/checkin.py checkin YT-04 --note "四层坛体，天子祭天礼制建筑" --photo yt04.jpg
# 无法实地前往时可用云打卡模式：
python <skill>/scripts/checkin.py checkin CJ-01 --mode cloud --note "瓦书封地：酆邱"
--note记录任务答案 / 观察；--photo留实地照片路径；--mode field|cloud区分实地与云打卡。- 重复打卡同一 ID 会覆盖更新该点记录。
4. 进度与成就
python <skill>/scripts/checkin.py status
成就阈值：初出茅庐(≥1) / 长安探秘(集齐长安校区 11 点) / 雁塔寻古(集齐雁塔校区 5 点) / 满贯(集齐全部 16 点)。
5. 一键生成打卡路线图
python <skill>/scripts/checkin.py route --out 我的路线.html
# 仅某校区：python <skill>/scripts/checkin.py route --campus 长安校区
脚本按校区输出一张「行程单」HTML：顶部为打卡顺序示意图（节点连线 diagram，非地理地图），下方为有序清单，标注每段步行提示（博物馆内约 2–3 分钟 / 校园内约 5–10 分钟）与每点已打卡(✅)/未打卡(⬜)状态。实际导航请用地图 App。可用 present_files 预览。
6. 生成考古护照
python <skill>/scripts/checkin.py cert --out 我的考古护照.html
脚本用 assets/certificate_template.html 渲染，填入昵称、日期、进度条与已打卡清单，输出可浏览器打开 / 打印的 HTML。可用 present_files 直接预览。
7. Web 应用（推荐交互版）
直接用浏览器打开 <skill>/assets/index.html（双击或 present_files 预览），这是一个纯前端、零依赖、本地保存的校园考古 App：
- 点位列表 / 详情：按校区切换，点进去看藏品图标 + 考古介绍，点击藏品看详情。
- 答题积分：每点一题，答对 +10 分；累计 50 / 60 / 70 / 90 / 100 分解锁 5 级校徽（青铜·雁塔大门 → 白银·长安大门 → 黄金·长安图书馆 → 王者·雁塔图书馆 → 彩虹·校训「报道不曲，拥书自华」）。
- 腾讯地图导航：详情页「去这里」调用腾讯地图 URI 唤起步行导航（免 key），直达该点真实坐标。
- 图文打卡 + 二创上传：拍照 / 选图 + 文字，本地保存（localStorage）；二创作品单独归类到相册。
- 分享：单点「分享这个点位」复制文案，或生成分享海报（canvas 绘图，含昵称 / 积分 / 徽章 / 校训），调起系统分享发朋友圈 / 好友。
- 徽章墙 / 相册：集中展示已解锁徽章与所有打卡、二创图片。
数据来自 assets/data.js（19 个真实点：复用小程序「小师师校园考古探险」的天坛 / 博物馆 / 图书馆 / 汉墓高保真数据 + 书画艺术馆 / 妇女文化馆 / 校史馆等补充点，坐标取自陕师大两校区及天坛实测值）。
Resources
assets/index.html
纯前端 Web 应用（单文件 + data.js），浏览器直接打开即用，进度存 localStorage。是答题积分 / 徽章 / 地图导航 / 上传二创 / 分享海报的主交互入口。
assets/data.js
Web 应用的机器可读数据源：19 个打卡点（id / 名称 / 校区 / 坐标 / 图标 / 介绍 / 藏品 / 题库）与 5 级徽章定义。增删点位只需改这里。
references/checkin-points.md
16 个打卡点的完整人类可读数据：地点、类别、考古看点、打卡任务、难度。脚本中的 ID（CJ-01…CJ-11、YT-01…YT-05）与此文件严格对应，修改任一处须同步另一处。
scripts/checkin.py
纯标准库 CLI，管理 snnu_checkin_log.json（初始化 / 设名 / 打卡 / 列表 / 进度 / 出证）。打卡点常量 POINTS 为机器可读的权威来源。
assets/certificate_template.html
护照证书模板，含 {{NAME}} {{DATE}} {{COUNT}} {{TOTAL}} {{PERCENT}} {{POINTS_TABLE}} 占位符，由 cert 命令渲染。
Notes
- 坐标与看点来自陕师大官网、校史馆简介及公开报道，部分高保真数据（天坛 / 博物馆 / 图书馆 / 汉墓）复用自小程序「小师师校园考古探险」；实际开放情况以校内现场为准，打卡点为活动设计，非官方研学路线。
- Web 应用（
assets/data.js）为 19 点最新完整版；命令行版scripts/checkin.py为 16 点旧版。增删打卡点：Web 改assets/data.js，CLI 改scripts/checkin.py与references/checkin-points.md，保持 ID 一致。
