把中英文二维数学题变成经核验、可交互的 GeoGebra 文件;核验失败不交付。
安装
# GitHub 源码(首次需按提示配置 allowBuilds 构建授权后重试)
dsh plugin --profile web add github:Jack7510/ggb-plugins-dsh
装任何插件都等于在你的机器上跑第三方代码,权限和你本人一样大——能读你的文件、用你的凭据、访问网络,工具审批管不到它。GitHub 来源的插件还会在安装时执行构建脚本——pnpm 默认拦截,所以安装可能停在 ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED 或 ERR_PNPM_IGNORED_BUILDS;dsh 会打印出需要添加的确切键名,把它加进该 profile 的 pnpm-workspace.yaml 的 allowBuilds 下,重跑一次即可装上。放行构建本身就是一次信任判断:请只安装可信来源,并尽量锁定 commit(github:owner/repo#sha)。
README
English | 简体中文
把文字或图片中的二维数学题变成可交互的 GeoGebra 文件。宿主 Agent(Codex、DeepSeek Harness 或 WorkBuddy)理解题意并编写原生 Algebra/CAS 程序;本项目在本地执行、逐条件核验、导出 .ggb、重新加载,并交付文件、核验报告和截图。
支持中文和英文。Agent 根据你的偏好和上下文选择工作语言,保留题目原文,且只分析条件与构图方法,不替你给出题目答案。
演示

拖动 C 时,圆周角保持为圆心角的一半;构造、依赖和核验结果同步更新。
需要什么
| 依赖 | 用途 |
|---|---|
| Codex、DeepSeek Harness(DSH)或 WorkBuddy | 理解题意并编写原生 GeoGebra 程序 |
| Node.js 22+ 与 pnpm 11 | 运行本地 CLI、准备依赖 |
curl 与 unzip |
下载并解压固定版本的 GeoGebra 运行时 |
| Google Chrome 或 Microsoft Edge | 核验时以 headless 方式驱动 applet |
不需要额外模型密钥。安装需要网络;GeoGebra 与浏览器不随包再分发。构建发布包时另外使用 zip、tar 与 npm。
安装
当前版本为 v0.9.0,提供
Codex ZIP 与 DSH npm 包;WorkBuddy ZIP 由同一源码通过 pnpm pack:workbuddy 构建,尚未发布。
DSH 包已在 dsh-plugin.org 收录;
awesome-dsh-plugin 的 5,539 条主索引仍待提交;
版本说明见 0.9.0 发布记录。
- Codex:安装与升级说明。
- DSH:独立 headless profile 安装说明。
- WorkBuddy:插件安装与使用说明。
DSH bundle 已发布到 npm:
profile=desktop # DSH 插件中心或 Web 宿主改为 web
dsh plugin --profile "$profile" add ggb-plugins-dsh@0.9.0
node ~/.dsh/profiles/$profile/node_modules/ggb-plugins-dsh/scripts/setup-plugin.mjs
桌面用户可以把这一句安装指令粘贴到 DSH 对话框,由 DSH 代为安装。
想在 DSH 中浏览并安装,启用 Experimental plugins → Custom plugin markets,然后在 Discover → Add index source 添加:
https://cdn.jsdelivr.net/gh/Jack7510/ggb-plugins@main/docs/market/index.json
三个客户端各自安装,共用同一套执行与核验管线。三份说明都以运行依赖准备(setup-plugin,会报告实际使用的浏览器)和就绪检查(doctor)结束。
第一道题
启用插件后,在新的宿主会话中直接描述题目,图片可以随题附上。
用 GeoGebra 作三角形 ABC,取 AB 的中点 M,连接 CM,把中线标红。拖动 A 验证中点和中线联动,保存文件并打开交互预览。
构造、重载和全部自动核验都以 headless 运行,不打开中间窗口。失败或无法核验的必需条件会阻止交付,而不是被跳过;失败会保留诊断,便于下一轮修正。必要条件缺失或歧义时 Agent 先澄清;未指定坐标时它会说明自行选择的初始构型。Agent 可以自行决定什么、不能决定什么,见 Skill。
你会得到什么
成功运行写出一个交付目录:
| 文件 | 用途 |
|---|---|
<题目>.ggb |
按题目命名的原生文件,可在 GeoGebra 中打开、查看并继续编辑 |
verification.json |
逐条件结果:构造、重载与交互样本 |
preview.png |
交付构型截图 |
request.json、manifest.json |
输入留档与交付清单 |
报告会说明实际执行了哪些检查、有限交互样本覆盖到哪里,不会声称构成一般性证明。需要打印时运行
node scripts/render-report.mjs --delivery <交付目录> --output <文件.html> 生成独立 HTML 报告。
交付目录位于 <outputDir>/<题目>/delivery/;<题目> 同时是 GGB 文件名,同名题目自动追加 -2、-3,不覆盖旧文件。
交互预览
预览加载同一份交付的 GGB,支持适用的点拖动、参数变化与缩放,且不回写交付文件。预览进程在页面加载后自动退出,窗口继续可用;需要重新加载时再执行一次 preview;一次性宿主退出后进程可能被回收。自动复核加 --headless。
直接使用 CLI
宿主会替你调用这个 CLI,其他本地工具也可以直接驱动:
node <installed-plugin>/dist/src/cli.js doctor
node <installed-plugin>/dist/src/cli.js inspect --ggb /absolute/base.ggb
node <installed-plugin>/dist/src/cli.js build --request /absolute/request.json
node <installed-plugin>/dist/src/cli.js preview --delivery /absolute/delivery
已有 GGB 需要改颜色、线型、填充、可见性,或继续构造(增加对象、修改独立数值或坐标)时,在请求中声明 base;inspect 列出对象清单、当前值以及请求必须写入的摘要。删除、重命名和视图修改不支持。请求编写方式见 能力契约。
从源码运行
先满足上表依赖,然后:
pnpm install --frozen-lockfile
pnpm setup:runtime
pnpm build
pnpm demo
pnpm demo 会把内置三角形示例构造到 output/。验证与维护命令、Agent 的工作规则以及发布流程都在 AGENTS.md,这里不重复。
仓库结构
src/:CLI、执行、核验与交付管线。viewer/:承载 GeoGebra applet 的本地页面。skills/:各宿主共用的 Skill。codex/、dsh/、workbuddy/:各宿主的插件资产、安装说明与验收记录。examples/、tests/:可运行输入、10 类题型模板索引与回归用例。scripts/:依赖准备、三种打包、打印报告与覆盖记录工具。docs/:需求与设计、重要修改记录、教师案例库与跨客户端验收记录;历史阶段结果见归档索引。
支持范围与边界
- 支持:二维几何、函数、方程、微积分、列表矩阵与统计,中英文均可。
- 不支持:三维构图、无法声明基线的外部 GGB 续题、一般数学证明。
- 原生命令可以接入,不等于全部命令与重载都已验收;边界见 命令覆盖记录。
- 数值采样与未决 CAS 结果是证据,不是证明。
项目采用 MIT 许可,源码位于 github.com/Jack7510/ggb-plugins。GeoGebra 的独立许可与归属见 第三方说明。
链接
同类插件
Tencent/WeKnora#dsh-weknora★ 37546
把 WeKnora 知识库接入 dsh 的四个只读工具:列出知识库、混合检索原文片段、按顺序还原单篇文档,以及直接取用 WeKnora 自己带引用的 RAG 或 ReAct agent 回答(含可续聊的 session id)。
DayuanJiang/next-ai-draw-io#dsh-plugin★ 36997
dsh 的 draw.io 绘图插件:通过 next-ai-drawio MCP 服务器作图,点回复里的链接在右侧栏打开实时预览,可以手动修改图,AI 的每次修改都是可以恢复的版本。需 Node.js 18+,首次使用由 npx 下载 MCP 服务器。
superdesigndev/treg★ 8164
给 Agent 的工具目录:按「要做的事」检索约 2,600 个外部接口(SEO 与 SERP、外链、社交、人物与公司信息补全、广告库、抓取),查看参数与单次调用价格后直接调用,凭据由服务端注入。附带技能,MCP 行在未设置 TREG_TOKEN 前保持禁用。
T-Auto/dsh-ops★ 5864
为 Windows 的 DSH 提供 bash、PowerShell 7 及 Rust 高性能工具,减少 token 消耗。
sixtysevenlf/dsh-blender-plugin★ 2147
让 DSH agent 通过直连 TCP 通道驱动本地 Blender,提供 15 个工具:视口帧、自定义视角渲染、Python 执行、无头与作业卸载、事务回滚,以及 34 个 family / 228 个 op 的规划层。
helloHub1212/dsh-windows-mcp★ 1456
通过官方 MCP 客户端桥接层把 CursorTouch/Windows-MCP 桌面自动化服务器接入 DSH,把截屏、UI 树快照、鼠标键盘输入、剪贴板、进程与注册表等工具注册成 mcp__windows__* 供模型调用,并附带 windows_mcp_doctor 诊断工具;Computer Use 默认关闭,需在插件面板里打开。
社区评论
评论公开保存在 GitHub Discussions。加载评论会连接 GitHub 和 Giscus;发表内容需要 GitHub 账号。