dshbase
EN

插件目录 / Developer / dsh-openmaic

dsh-openmaic

已验证 · 实测可装 THU-MAIC

✓ 持续维护 基于 7 个官方 DSH 包

查看 GitHub ↗ ← 返回插件目录

22Stars
4Forks
1未关闭 issue
JavaScript语言
2026-08-13最近推送
跨平台平台

功能简介

DeepSeek Harness 的 OpenMAIC 插件：教室、幻灯片、交互式组件与苏格拉底式教学。

✅
我们的评价
可用 — 实测通过，社区增长中

DeepSeek Harness 的 OpenMAIC 插件：教室、幻灯片、交互式组件与苏格拉底式教学。 实测能干净安装、正常启动。社区在增长，是个稳妥选择。

「已验证」表示我们的自动化 CI 在干净 profile 里实际执行了 dsh plugin add 并启动成功——仅此而已。功能描述与版本兼容性均为作者声明。这不是安全审计，也不代表对第三方代码的背书。

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-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(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

  1. If accessCode is set, POST /api/access-code/verify and replay the openmaic_access cookie on later requests.
  2. POST /api/generate-classroom with the requirement, plus only the optional flags you passed. Returns a jobId and pollUrl.
  3. Poll GET {pollUrl} until the job is succeeded or failed, or maxWaitMs runs out.
  4. On success, return {baseUrl}/classroom/{classroomId} (or the server-provided result.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

安装

🧩 让 Agent 自动装（推荐）

装一次目录插件，之后本站所有插件都能让 DeepSeek Harness 自动找、自动装：

dsh plugin add dshbase-catalog

然后对 agent 说「帮我装 dsh-openmaic」，它会在目录里找到并自动安装。文档：dshbase-catalog · 已验证场景包。

该插件是 GitHub 源码（未发 npm）——直接从仓库装：

Web profile：

dsh plugin --profile web add github:THU-MAIC/dsh-openmaic

Headless（CLI）profile：

dsh plugin --profile headless add github:THU-MAIC/dsh-openmaic
⚡ 有预构建版 — 跳过构建步骤，直接装编译好的版本： 
dsh plugin --profile web add https://dshbase.com/builds/openmaic-dsh-openmaic-0.4.0.tgz

实测报告

验证通过：从 GitHub 源码完成 L1 安装 + L2 加载 + L3 运行（dsh 0.1.0-rc.6）。

使用场景

扩展 agent 的编码能力面——给它一个新工具、工作流或集成，让它接手以前做不了的开发任务。

适合谁

想让 dsh 在真实代码库上像队友一样干活的开发者——能改、能跑、能验证，而不只是回答问题。

二次开发建议

工具/命令面就是缝：暴露更多 SDK 能力、加更聪明的上下文接线，或收紧改代码与验证之间的循环。

安全：尚未扫描——我们的每日静态扫描将很快覆盖它。

分享徽章

Developer 里更多

petdex

✅ 已验证 · ★3975

dsh-anchored-standard

✅ 已验证 · ★3757

modlens

✅ 已验证 · ★3669

EchoBird

✅ 已验证 · ★3126

brooks-lint

✅ 已验证 · ★1418

awesome-dsh-plugins

✅ 已验证 · ★1391

浏览全部 7795 个插件 →