THU-MAIC/dsh-openmaic
82最近提交 2026年8月13日
dsh-openmaic DSH 插件
dsh-openmaic 注册了四个工具和一个苏格拉底式教学技能。它使智能体能够利用 OpenMAIC 服务生成课程、渲染幻灯片、交互式小部件和内联 HTML 片段。插件会异步轮询生成任务，并返回可播放的链接或沙盒卡片。
如何安装 dsh-openmaic DSH 插件
dsh plugin --profile web add git+https://github.com/THU-MAIC/dsh-openmaic.git复制不会执行命令。安装 dsh-openmaic DSH 插件前请核对仓库和版本。
dsh-openmaic DSH 插件数据来源
dsh-openmaic DSH 插件快照日期：2026年8月16日
discovered
dsh-openmaic DSH 插件能做什么
- openmaic_generate：向 OpenMAIC 提交课程需求，异步轮询任务完成，返回可播放的课堂链接。
- openmaic_slide：使用官方渲染器渲染 OpenMAIC 幻灯片（PPTist 风格的 Slide JSON），支持文本、形状、图片、表格、图表、公式和代码。
- openmaic_widget：渲染智能体编写为完整 HTML 文档的交互式小部件（模拟、游戏或代码），在编写时流式输出代码，完成后内联渲染。
- openmaic_render：将内联 HTML 教学片段（概念卡片、测验、渐进式讲解）渲染为对话中的沙盒卡片。
- openmaic-teach 技能：将会话转变为苏格拉底式 OpenMAIC 课程，通过引导式提问并借助幻灯片、小部件和卡片进行教学。
dsh-openmaic DSH 插件适合哪些场景
- 教师要求智能体创建一节量子物理入门课程，插件生成课堂链接。
- 学生请求制作抛体运动模拟器，智能体编写小部件代码并交互式渲染。
- 教育者在聊天中嵌入内联 HTML 概念卡片测验，用于快速评估。
- 开发者使用苏格拉底式技能逐步引导学习者通过一个主题。
dsh-openmaic DSH 插件适合谁
- 创建交互式 AI 驱动课程的教育工作者。
- 希望将 OpenMAIC 教学工具集成到 DeepSeek Harness 中的 AI 智能体开发者。
- 受益于对话式、苏格拉底式教学会话的学习者。
dsh-openmaic DSH 插件的限制
- 生成任务是异步的，插件会轮询直到完成，默认最大等待时间为 10 分钟（600000 ms）。
- 幻灯片、小部件和渲染工具仅渲染智能体编写的内容，不进行任何服务器端生成。
- accessCode 配置项目前在线未强制使用，但未来可能变为必需。
dsh-openmaic DSH 插件的仓库 README 摘录
以下文字摘自 dsh-openmaic DSH 插件的上游仓库 THU-MAIC/dsh-openmaic 的 README，版权归原作者，仅作引用。
把 OpenMAIC 带进 DeepSeek Harness。Bring OpenMAIC into DeepSeek Harness. `dsh-openmaic` is a DeepSeek Harness plugin that registers four tools and a Socratic teaching skill: - `openmaic_generate`: tell your agent "make me a lesson about X", and the plugin submits the requirement to [open.maic.chat](https://open.maic.chat/), waits for the async generation job, and returns a playable classroom link. - `openmaic_slide`: the agent writes one OpenMAIC slide (PPTist-style Slide JSON) and the plugin renders it with OpenMAIC's official renderer (text, shapes, images, tables, charts, formulas, code). - `openmaic_widget`: the agent writes an OpenMAIC-style interactive widget (simulation, game, or code) per the bundled contract; the code streams as it writes, then renders inline as a sandboxed card. - `openmaic_render`: the agent writes an inline HTML teaching fragment (concept card, quiz, walkthrough) and the plugin renders it as a sandboxed card right in the conversation. - `openmaic-teach` skill: turns a session into a Socratic OpenMAIC lesson, teaching by guided questioning and pulling in slides, widgets, and cards as aids. ## What it looks like ``` 用户: 帮我做一节量子物理入门课 模型 → openmaic_generate
阅读完整 README仓库许可: MIT
dsh-openmaic DSH 插件常见问题
如何安装 dsh-openmaic？
在终端中运行 `dsh plugin --profile web add git+https://github.com/THU-MAIC/dsh-openmaic.git`。然后重启 `dsh web` 服务并刷新浏览器。插件附带了编译好的文件，无需额外构建步骤。
dsh-openmaic 提供了哪些工具？
它提供了四个工具：`openmaic_generate`（生成课程课堂）、`openmaic_slide`（渲染 OpenMAIC 幻灯片）、`openmaic_widget`（渲染交互式小部件）和 `openmaic_render`（渲染内联 HTML 教学片段）。还包含一个苏格拉底式教学技能 `openmaic-teach`。
我能将 dsh-openmaic 用于本地 OpenMAIC 实例吗？
可以。将配置中的 `baseUrl` 设置为 `http://localhost:3000`（或您的本地服务器地址），即可针对本地 OpenMAIC 实例进行开发。默认值为 `https://open.maic.chat`。
openmaic_generate 是如何工作的？
智能体调用 `openmaic_generate` 并传入课程需求。插件向 OpenMAIC 的 `/api/generate-classroom` 端点发送 POST 请求，获取任务 ID，然后轮询服务器直到任务成功或失败（最多等待 `maxWaitMs` 配置的时间）。成功后返回可播放的课堂链接。
dsh-openmaic 是否支持幻灯片和小部件的服务器端生成？
不支持。`openmaic_slide`、`openmaic_widget` 和 `openmaic_render` 工具仅渲染智能体编写的内容，不会进行任何服务器端生成。它们依赖 OpenMAIC SDK 契约（`@openmaic/dsl`、`@openmaic/generation`、`@openmaic/renderer`）来内联渲染内容。