选课与培养方案终端 · Class Choice Terminal
面向计算机类新生的选课与培养方案问答终端，交付形态是 DeepSeek Harness（DSH）插件套件：一套明日方舟风格的 Web 界面与开场动画，加一套课程 / 教师 / 培养方案 / 学分 / 规则查询工具。
界面不是另起一套前端，而是通过 DSH 的 webserver/index-inject 注入行实现，因此保留 DSH 的会话、工具调用、Skill 与权限体系，插件随装随用。
界面预览
开场动画（启动时约 2.6 秒，可点击任意处跳过）：
进入工作区后的主界面：
组成
| 目录 | 作用 |
|---|---|
plugins/dsh-arknights-theme/ |
明日方舟风格皮肤 + 开场动画 + HUD 边角框，纯注入式，无客户端 bundle |
plugins/dsh-class-choice/ |
5 个选课域工具（课程 / 培养方案 / 学分核算 / 教师 / 规则条款）与示例数据 |
profile/ |
本地 Web profile 的 overlay 示例（--patch 用） |
scripts/ |
从源码构建 DSH 并启动带插件的 Web UI |
.dsh/skills/ |
可选的项目级 Skill：选课顾问的问答流程 |
docs/ |
前期需求与方案文档（.docx） |
快速开始
前置：Node.js ≥ 24.9、pnpm、git，以及一个可写的 DSH 配置目录（默认 ~/.dsh）。
# 1. 构建 Harness 源码（只在专用的构建目录里进行）
pwsh ./scripts/setup-dev.ps1
# 2. 启动带插件的 Web UI
pwsh ./scripts/dev-web.ps1 -Port 3080
setup-dev.ps1 会：克隆 deepseek-harness 到同级目录 ../class_choice_system_contribute/deepseek-harness（已存在则复用）→ 执行 pnpm install → 执行 pnpm run build:artifacts → 生成本机可用的 profile/class-choice.overlay.yml（绝对路径）→ 打印启动命令。
首次启动后终端会打印形如 dsh web: http://127.0.0.1:3080/?token=... 的地址，用浏览器打开即可。带 token 的链接用于建立本地信任，换端口或重启后以新打印的地址为准。
如果已经有一份构建好的 DSH，只想装插件：
# 在 deepseek-harness 目录中
pnpm dsh --profile web --patch <本仓库>/profile/class-choice.overlay.yml --no-open --port 3080
> overlay 中的插件路径必须是绝对路径，这是 DSH loader 的约定。
插件一：明日方舟风格界面（dsh-arknights-theme）
- 调色板：暖石墨底 + 琥珀金强调色，覆盖 DSH 的
--dsw-alias-*语义 token；表面半透明，让几何背景透出层次。 - 几何背景：纯 CSS / 内联 SVG 画出的技术图面——被遮罩的 88px 网格、右上斜切排线、左下网点、一条贯穿的斜向金线、右上六边形与缓慢自转的菱形、左下三角标尺；外加径向暗角压住四周。不请求任何图片资源，任意视口自适应。
- 开场动画：六边形徽标描边 → 标题遮罩展开 → 终端自检日志与进度条 → 上收式揭幕。点击 / 按键可跳过；
prefers-reduced-motion下自动退化为静默淡出；4.6 秒故障保护，即使脚本报错也不会锁死界面。 - 常驻 HUD：四角细金边、左下角
CLASS CHOICE TERMINAL // 选课与培养方案状态条、极轻扫描线。 - 无构建产物：插件在
apply()时读取本地theme.css/splash.css/splash.html/splash.js，通过webserver/index-inject推送style/html/script行，因此不需要打包客户端 bundle，也不依赖 React。
如果 profile 里装过立绘类背景插件，本皮肤会隐藏它的图片图层（[data-dab-wp*] 与 body 上的图片背景），只保留自己的几何图面；需要恢复立绘时删掉 theme.css 里对应的三行抑制规则即可。
实现约束（改样式前请先读）：
- 注入文本里不能出现 `` 就会让插入点落到注释里，整页解析错位。插件加载时会自检并给出明确报错。
- 覆写 token 使用
html:root body ... !important。运行时主题表在插件之后注入，社区背景插件也会用!important覆写同一批变量，只有更高的选择器权重才能稳定生效。 - 开场动画的样式必须放在独立的
style行里，不能内嵌在注入的 HTML 片段中——解析器会重定位片段内的 ``，把覆盖层拆散。
插件二：选课域工具（dsh-class-choice）
| 工具 | 用途 |
|---|---|
cc_course_lookup |
按课程名 / 代码 / 简称查学分、学时、性质、建议学期、模块、先修课 |
cc_plan_overview |
培养方案总学分与模块最低学分结构 |
cc_credit_audit |
按已修课程代码逐模块核算已修 / 要求 / 差额 |
cc_teacher_lookup |
教师公开档案、授课记录、考核方式；显式拒绝主观评价 |
cc_policy_search |
选课与学籍管理规定条款检索，带条款编号与出处 |
设计取舍与前期方案一致：事实来自数据，模型只负责组织语言；查不到时工具返回明确的“未找到”话术，而不是让模型推测。
工具以普通 ToolDefinition 字面量注册（未引入 defineTool 依赖），因此整个插件零运行时依赖，按路径即可加载。
数据
plugins/dsh-class-choice/data/*.json 是演示数据（12 门课程、8 位教师、7 个模块、6 条规则），用于联调与演示。正式部署时替换为教务处的培养方案与课程库，保持字段不变即可；所有工具输出都会带上数据版本号。
Skill（可选）
.dsh/skills/class-choice-advisor/SKILL.md 描述了“先查事实 → 再解释规则 → 必须带来源 → 查不到转人工”的问答流程。
- 项目级生效：在本仓库（含
.git的目录）中启动会话即可被发现。 - 全局生效：把该目录复制到
~/.dsh/skills/。
目录结构
class_choice_system/
├── README.md
├── plugins/
│ ├── dsh-arknights-theme/
│ │ ├── package.json
│ │ └── src/{index.ts,theme.css,splash.css,splash.html,splash.js}
│ └── dsh-class-choice/
│ ├── package.json
│ ├── src/index.ts
│ └── data/{courses,teachers,plan,policies}.json
├── profile/
│ └── class-choice.overlay.yml # setup-dev.ps1 生成，含本机绝对路径
├── scripts/{setup-dev.ps1,dev-web.ps1}
├── .dsh/skills/class-choice-advisor/SKILL.md
├── docs/ # 前期需求与方案文档
└── screenshots/
开发与验证
- 构建产物与
node_modules全部位于../class_choice_system_contribute/deepseek-harness，本仓库只保存可上传的源码、文档与截图。 - 主题插件的资源在
apply()时读取一次；改完 CSS/HTML/JS 后重启dev-web.ps1即可看到效果。 - 工具逻辑可脱离模型单测：
node --import tsx .scratch/plugin-smoke.mjs（脚本示例见下），或直接在会话里让模型调用工具。
import { apply } from './plugins/dsh-class-choice/src/index.ts'
const registered = []
apply({ tools: { register: (definition) => registered.push(definition) } })
const result = await registered[0].execute({ query: '程设' }, {})
已知限制与下一步
- 演示数据只覆盖一个专业、一个年级；多专业 / 多版本需要按“专业 + 年级 + 生效学年”三元组扩展数据层（方案文档 4.5 节）。
- 课程卡片、来源卡片、学分进度视图目前以 Markdown 表格呈现；要做到真正的结构化卡片，需要新增带
dsh.client的客户端插件，而不是继续用注入行。 - 时间冲突判断、课表比对尚未实现（缺少开课记录与课表数据）。
- 尚未接入真实教务系统与身份授权，学分核算以手工输入为准。
许可
MIT。界面与动画为原创实现，仅借鉴明日方舟的视觉语言（深色工业感、琥珀金强调、切角与细描边），不包含其素材或商标。
