← 返回列表
⚠ 装前注意
把 OpenMAIC 带进 DeepSeek Harness。Bring OpenMAIC into DeepSeek…
基本兼容但装前注意：未发布到 npm registry，仅可从源码安装 · 最近上游提交 2026/8/13 · 已提供中文文档
OpenMAIC for DeepSeek Harness：课堂、幻灯片、交互式组件与苏格拉底式教学
综合分
53.1
GitHub 分
53.1
用户评分
—
★ Stars
75
周下载量
—
安装插件（需先安装 dsh CLI 引擎：npm install -g @deepseek-ai/dsh）
dsh plugin --profile web add THU-MAIC/dsh-openmaic未发布到 npm registry，仅可从源码安装，改用 GitHub 源安装
🟢实装验证通过· 2026/9/19
由 dsh-plugin-verify（GitHub Actions）在真实 dsh 环境安装成功，非静态推断。
数据截至 2026/9/17（元数据每日更新 · 实装验证按队列轮转，单条结论的验证时间见上方）
安装兼容性检查⚠ 装前注意
以下结论由程序自动检查 npm 包、engines 声明与入口文件得出，未做人工实机验证——能装不等于用着没问题。
✗npm 包@openmaic/dsh-openmaic（未发布到 npm，仅可源码安装）
✓Node 引擎未声明 engines.node
✓dsh CLI 依赖未声明 dsh 版本约束
✓入口文件main/exports/bin 已声明
未发布到 npm registry，仅可从源码安装
验证方式：npm registry 存在性 + package.json 静态校验 · 最后验证 2026/9/17 11:37:53
依赖的 DSH / Cordis 模块
@deepseek-ai/cordis@deepseek-ai/dsh-llm@deepseek-ai/dsh-session@deepseek-ai/dsh-skill@deepseek-ai/dsh-system-prompt@deepseek-ai/dsh-tools@deepseek-ai/schemastery用户评分
还没有人投票，来当第一个
订阅周报，不错过优质插件更新
每周一封 · 高评分插件 + 新用户活动
README
dsh-openmaic
把 OpenMAIC 带进 DeepSeek Harness。Bring OpenMAIC into DeepSeek Harness。
dsh-openmaic 是一个 DeepSeek Harness 插件，它注册了四个工具和一个
苏格拉底式教学技能：
- openmaic_generate：告诉你的 agent“给我做一节关于 X 的课”，插件会把需求提交到 open.maic.chat，等待异步生成任务完成，并返回一个可播放的课堂链接。
- openmaic_slide：agent 编写一张 OpenMAIC 幻灯片（PPTist 风格的 Slide JSON），插件用 OpenMAIC 的官方渲染器渲染它（文本、形状、图片、表格、图表、公式、代码）。
- openmaic_widget：agent 按照内置契约编写一个 OpenMAIC 风格的交互式组件（模拟、游戏或代码）；代码在编写时流式输出，然后以内联沙盒卡片的形式渲染。
- openmaic_render：agent 编写一段内联 HTML 教学片段（概念卡片、测验、演练），插件将其作为沙盒卡片直接渲染在对话中。
- openmaic-teach 技能：把一次会话变成一堂苏格拉底式的 OpenMAIC 课程，通过引导式提问进行教学，并引入幻灯片、组件和卡片作为辅助。
它长什么样
用户: 帮我做一节量子物理入门课
模型 → openmaic_generate(requirement="量子物理入门课", language="zh-CN")
← "Classroom ID: class-abc123
Classroom URL:
https://open.maic.chat/classroom/class-abc123"
模型: 课堂已经生成好了，点开就能上课：
https://open.maic.chat/classroom/class-abc123
交互式组件：
用户: 做一个抛体运动模拟器
模型 → 按 openmaic-widget 模板写完整 HTML（流式输出）
→ openmaic_widget(html="…", widgetType="simulation", title="抛体运动")
← "Rendered the simulation widget …"
对话里就地出现一个可交互的 OpenMAIC 模拟器
安装
dsh plugin --profile web add git+https://github.com/THU-MAIC/dsh-openmaic.git
然后重启 dsh web 并刷新。该插件自带编译好的 lib/，因此通过
git 安装无需构建步骤。
配置
dsh-openmaic:
baseUrl: https://open.maic.chat
accessCode: "" # invite code; not enforced online yet, leave empty
pollIntervalMs: 5000
maxWaitMs: 600000
| 键 | 默认值 | 说明 |
| --- | --- | --- |
| baseUrl | https://open.maic.chat | API 基础地址。指向 http://localhost:3000 即可针对本地 OpenMAIC 进行开发。 |
| accessCode | "" | open.maic.chat 的邀请码。线上尚未强制启用，留空即可；启用后填入。 |
| pollIntervalMs | 5000 | 轮询间隔，单位毫秒。生成较慢，因此 60000 比默认值更友好。 |
| maxWaitMs | 600000 | 单个任务的上限，10 分钟。 |
API 流程
1. 如果设置了 accessCode，则调用 POST /api/access-code/verify，并在后续请求中回放 openmaic_access cookie。
2. 用需求调用 POST /api/generate-classroom，只附带你传入的可选标志。返回 jobId 和 pollUrl。
3. 轮询 GET {pollUrl}，直到任务变为 succeeded 或 failed，或者 maxWaitMs 耗尽。
4. 成功后，返回 {baseUrl}/classroom/{classroomId}（或服务器提供的 result.url）。
范围
- openmaic_generate：生成一个课堂并返回可播放的链接。
- openmaic_slide：使用官方渲染器渲染一张 OpenMAIC 幻灯片。
- openmaic_widget：渲染智能体编写的模拟 / 游戏 / 代码小部件（一个完整的 HTML 文档）。它会在智能体编写代码时流式传输代码，并在完成后进行渲染。
- openmaic_render：将内联 HTML 教学片段渲染为沙盒卡片。
- openmaic-teach：苏格拉底式教学会话，使用上述工具作为辅助。
slide/widget/render 工具不进行服务器端生成；它们根据 OpenMAIC SDK 契约（@openmaic/dsl、@openmaic/generation、@openmaic/renderer）渲染智能体编写的内容。
路线图
- 接入其余小部件类型（diagram、visualization3d、procedural-skill）。
- 动作循环返回模型（教学智能体交互：高亮/标注/显示小部件元素）。
开发
./scripts/build.sh # links host deps, bundles src/ to lib/ with tsdown
./scripts/test.sh # links host deps, runs the vitest suite
这些脚本通过 PATH 上的 dsh 定位 harness 检出目录；设置 DSH_CHECKOUT 以针对特定检出目录进行构建。
许可证
MIT扫码进群