Plugin directory / Developer / dsh-openmaic
dsh-openmaic
Verified · install-tested on dsh THU-MAIC
What it does
OpenMAIC for DeepSeek Harness: classrooms, slides, interactive widgets, and Socratic teaching.
Works — verified, growing community
OpenMAIC for DeepSeek Harness: classrooms, slides, interactive widgets, and Socratic teaching. It installs cleanly and boots without issues in our testing. It has a growing community — a solid choice.
“Verified” means our automated CI actually ran dsh plugin add in a clean profile and it booted — nothing more. Feature descriptions and version compatibility are the author’s claims. This is not a security audit and not an endorsement of third-party code.
README
dsh-openmaic
把 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, 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-teachskill: 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(requirement="量子物理入门课", language="zh-CN")
← "Classroom ID: class-abc123
Classroom URL:
https://open.maic.chat/classroom/class-abc123"
模型: 课堂已经生成好了，点开就能上课：
https://open.maic.chat/classroom/class-abc123
Interactive widget:
用户: 做一个抛体运动模拟器
模型 → 按 openmaic-widget 模板写完整 HTML（流式输出）
→ openmaic_widget(html="<!doctype html>…", widgetType="simulation", title="抛体运动")
← "Rendered the simulation widget …"
对话里就地出现一个可交互的 OpenMAIC 模拟器
Install
dsh plugin --profile web add git+https://github.com/THU-MAIC/dsh-openmaic.git
Then restart dsh web and refresh. The plugin ships its compiled lib/, so a
git install needs no build step.
Config
dsh-openmaic:
baseUrl: https://open.maic.chat
accessCode: "" # invite code; not enforced online yet, leave empty
pollIntervalMs: 5000
maxWaitMs: 600000
| Key | Default | Notes |
|---|---|---|
baseUrl |
https://open.maic.chat |
API base. Point at http://localhost:3000 to develop against a local OpenMAIC. |
accessCode |
"" |
Invite code for open.maic.chat. Not enforced online yet, leave empty; fill it in once enabled. |
pollIntervalMs |
5000 |
Poll interval in ms. Generation is slow, so 60000 is friendlier than the default. |
maxWaitMs |
600000 |
Cap for one job, 10 minutes. |
API flow
- If
accessCodeis set,POST /api/access-code/verifyand replay theopenmaic_accesscookie on later requests. POST /api/generate-classroomwith the requirement, plus only the optional flags you passed. Returns ajobIdandpollUrl.- Poll
GET {pollUrl}until the job issucceededorfailed, ormaxWaitMsruns out. - On success, return
{baseUrl}/classroom/{classroomId}(or the server-providedresult.url).
Scope
openmaic_generate: generate a classroom and return a playable link.openmaic_slide: render one OpenMAIC slide with the official renderer.openmaic_widget: render a simulation / game / code widget the agent writes (a full HTML document). It streams the code while the agent writes it and renders on completion.openmaic_render: render an inline HTML teaching fragment as a sandboxed card.openmaic-teach: Socratic teaching session that uses the tools above as aids.
The slide/widget/render tools do no server-side generation; they render content
the agent authors against the OpenMAIC SDK contracts (@openmaic/dsl,@openmaic/generation, @openmaic/renderer).
Roadmap
- Wire the remaining widget types (diagram, visualization3d, procedural-skill).
- Action loop back to the model (teaching-agent interactions: highlight/annotate/reveal widget elements).
Development
./scripts/build.sh # links host deps, bundles src/ to lib/ with tsdown
./scripts/test.sh # links host deps, runs the vitest suite
The scripts locate the harness checkout from dsh on PATH; set DSH_CHECKOUT to build against a specific checkout.
License
MIT
Install
Install the catalog once, then DeepSeek Harness can find and install any plugin from this site automatically:
dsh plugin add dshbase-catalogThen say "install dsh-openmaic for me" — your agent finds it in the directory and installs it. Docs: dshbase-catalog · verified packs.
This plugin is GitHub source (not published to npm) — install it straight from the repo:
Web profile:
dsh plugin --profile web add github:THU-MAIC/dsh-openmaicHeadless (CLI) profile:
dsh plugin --profile headless add github:THU-MAIC/dsh-openmaicdsh plugin --profile web add https://dshbase.com/builds/openmaic-dsh-openmaic-0.4.0.tgzTest report
Verified: L1 install + L2 load + L3 runtime from GitHub source on dsh 0.1.0-rc.6.
When to use it
Extend the agent's coding surface — give it a new tool, workflow, or integration so it handles a dev task it couldn't before.
Who it's for
Developers who want dsh to behave like a teammate on real codebases — editing, running, and verifying changes rather than just answering.
For developers — extending it
The tool/command surface is the seam: expose more of the SDK, add smarter context wiring, or tighten the loop between code changes and verification.
Share this badge
Drop this badge into your README — it links back here and updates automatically when our test status changes:
[](https://dshbase.com/plugins/dsh-openmaic/)<a href="https://dshbase.com/plugins/dsh-openmaic/"><img src="https://dshbase.com/badges/dsh-openmaic.svg" alt="dshbase install-tested"></a>