dsh-oi-workbench

August 20, 2026 · View on GitHub

OI 出题工作台 —— DeepSeek Harness 的 skill-first 插件：核心是 oi-workbench 技能，另附 Python 外部管理 UI、HOJ/Hydro 桥接脚本与系统斜杠命令自动注册。

安装后，在任意会话中可用 oi-workbench 技能：按内部整理的知识点速查锁定知识点，设计测试点表格与特殊性质，针对性构造数据，制作大样例附件，本地评测，打包 Hydro / HOJ 原生题目包，并把题目/比赛/团队发布到 Hydro 或 HOJ；还提供 Python 外部管理 UI 和 /hoj、/oiwb、/oj 系统斜杠命令。用户还可自行添加自己的知识库速查卡与原创参考题 （见「用户自定义知识库 / 参考题」一节）。

安装

dsh plugin --profile web add dsh-oi-workbench
# 或 GitHub 仓库方式：
# dsh plugin --profile web add github:your-name/dsh-oi-workbench

安装后重启 DeepSeek Harness 生效。

安装时会自动：

安装 @etby-studio/dsh-commands 命令发现插件；
在 profile 层插入 dsh-commands，并让其直接扫描插件内的 commands/register/；
因此 /hoj、/oiwb、/oj 系统斜杠命令随插件安装自动注册，无需手动复制。

使用

在会话中直接描述需求即可，例如：

使用 oi-workbench 技能，帮我出两道入门组题：一道贪心+堆，一道简单 DP。每道 25 个测试点、2 个特殊性质档、附带大样例 zip，最后打成 Hydro 包，再导到 HOJ。

技能会按 skills/oi-workbench/SKILL.md 工作流执行：知识点锁定 → 测试点表格设计 → 题面（零做法提示）→ 代码矩阵 → 数据构造与击杀矩阵验证 → 本地评测 → Hydro/HOJ 打包 → 发布。

内容

skills/oi-workbench/
├── SKILL.md               # 出题工作流（技能入口，含评测约定）
├── knowledge-base/        # 内部整理的知识点速查：入门级/提高级/专家级
├── specs/                 # 规范：测试点表格、数据构造、题面风格、变式、用户自定义内容
├── templates/             # 模板：题面、分数表、题目包、知识库卡片
├── generator/             # Hydro/HOJ 打包器 + 校验器 + 本地评测器（Python 标准库）
├── hydro-bridge/          # Hydro OJ 对接（登录/题目/比赛/团队）
├── hoj-bridge/            # HOJ 完整管理对接（题目/比赛/训练/用户/团队/公告/标签/评测）
├── ui/                    # Python 外部管理 UI（hoj_ui.py + hoj-admin.html + user_content.py）
├── commands/              # 斜杠指令文档 + 自动注册命令文件（register/）
├── reference/             # 原创参考题（入门级 4 题 + 提高级 4 题）
└── examples/              # 示例题（果园分装，含完整验证记录）

用户自定义知识库 / 参考题（批次 1）

用户可自行增删改查 reference / knowledge-base，数据存于 ~/.dsh-oi-workbench/ （kb/ 与 reference/），不侵入插件安装目录；技能「锁定知识点」时并入使用，同名 topic 以用户卡为准，level 允许自定义新增。规范见 skills/oi-workbench/specs/user-content.md，命令见 skills/oi-workbench/commands/kb.md。

# 知识库卡片：新增 / 检索 / 校验
python skills/oi-workbench/ui/user_content.py kb add --topic 并查集 --level 提高级 --summary "..."
python skills/oi-workbench/ui/user_content.py kb search 并查集
python skills/oi-workbench/ui/user_content.py kb validate

# 参考题：校验后加入用户层 / 列出
python skills/oi-workbench/ui/user_content.py ref add my-problem --level 提高级 --id my-p1
python skills/oi-workbench/ui/user_content.py ref list

路线图 / TODO（未完成功能）

以下能力已规划未完成，将按 version-records/ROADMAP.md 分批填充（不含版本号承诺）：

故事题面 + 故事设计能力：原创故事构造复杂剧情、知识点融入题面；story-card 故事设计能力。
一次性出一场比赛：一段描述 → 多题 + 故事主线 + 数据 + 打包 + 一键建赛。
连续剧情 / 连载：同场共享主线 + 跨场次连载；story.yaml 剧本仓库 + 连续性检查。
支持 spj 和交互题（完整评测）：当前已提供基础本地 spj（checker 按 exit 0=AC）与包级 judge.spj / checker / interactor 字段；待补 testlib 标准 checker、交互题 interactor 的真机评测与配套样例验证。
支持 testlib.h：spj / 交互题 checker / interactor 统一改用 Codeforces 标准 testlib.h（自动链接内置 testlib.h，本地评测与远程 OJ 行为一致）。

常用命令

# 打包/校验 Hydro
python generator\build_package.py examples\demo --out P01.zip
python generator\verify_package.py P01.zip

# 打包/校验 HOJ
python generator\build_hoj_package.py examples\demo --out P01-hoj.zip
python generator\verify_hoj_package.py P01-hoj.zip

# 本地评测
python generator\local_judge.py examples\demo --source std\std.cpp

# 一键校验全部自出参考题
python generator\build_all_reference.py

# 发布到 HOJ
python hoj-bridge\publish_problem.py --base https://hoj.example.com --user root --problem-dir examples\demo

# HOJ 管理
python hoj-bridge\manage_hoj.py --help

斜杠命令

插件安装后自动注册以下系统命令（通过 @etby-studio/dsh-commands 扫描 commands/register/）：

命令	作用
`/hoj`	启动 HOJ 外部管理 UI
`/oiwb`	OI Workbench 通用入口
`/oj`	`/oiwb` 的别名
`/hoj problems`	HOJ 题目列表
`/hoj contests`	HOJ 比赛列表
`/hoj publish <目录>`	发布题目到 HOJ
`/hoj rejudge <submitId>`	重判提交
`/oiwb kb list\|show\|search\|add\|edit\|rm\|validate`	用户自定义知识库（见 commands/kb.md）
`/oiwb ref list\|show\|add\|rm\|validate`	用户自定义参考题（见 commands/kb.md）

UI 管理

UI 使用 Python 外部管理 UI（不依赖 DSH 内部 render_ui）：

python skills/oi-workbench/ui/hoj_ui.py --host 0.0.0.0 --port 6163 --base https://hoj.example.com

浏览器访问：http://localhost:6163/
手机/局域网访问：http://<本机IP>:6163/
服务端代理 HOJ API，保存 Cookie，避免 file:// 和 CORS 问题
通用指令根为 /oiwb（别名 /oj），HOJ 子命令见 skills/oi-workbench/commands/hoj.md

依赖

npm：@etby-studio/dsh-commands（MIT），用于系统斜杠命令注册；其传递依赖为 MIT / ISC / BSD 类宽松协议；
Python：出题/打包/对接/UI 脚本均使用 Python 3 标准库，无第三方 Python 包；
本地编译验证需要 g++（C++14，建议按 -O2 -std=c++14 -static）；
发布到 Hydro/HOJ 需要你自己的实例与账号。

参考

Hydro 题目包格式：https://docs.hydro.ac/zh/docs/Hydro/user/problem-format
HOJ 导入格式：https://github.com/HimitZH/HOJ/blob/master/docs/docs/use/import-problem.md
自出参考题：reference/entry/、reference/intermediate/

License

项目采用 Apache License 2.0，覆盖本仓库原创代码、脚本、配置、模板、文档与参考题。详见 LICENSE 与 NOTICE.md。

npm 依赖：仅 @etby-studio/dsh-commands（MIT，用于系统斜杠命令注册）；
Python 依赖：仅标准库。