返回目錄

dsh-openmaic

編輯精選維護狀態: 活躍

thu-maic/dsh-openmaic

OpenMAIC 的 DSH 整合:課堂、幻燈片、互動元件與蘇格拉底式教學。

前往 GitHub
$ dsh plugin --profile web add git+https://github.com/THU-MAIC/dsh-openmaic.git

83

星數

14

Fork

JavaScript

語言

MIT

授權條款

2026-08-13

建立於

2026-08-13

最近推送

一個原生 DeepSeek Harness 插件,把你的智能體變成 OpenMAIC 老師:透過四個工具加一個蘇格拉底式技能,生成課堂、投影片、互動式元件與沙箱教學卡片。

DSH 整合

原生執行環境

作者聲明

安全稽核

未稽核

最後核實

2026-09-03

授權條款

MIT

01它能幫你完成什麼?

  • 在 DeepSeek Harness 中生成 AI 課堂與蘇格拉底式課程

    open.maic.chat 上可播放的課堂連結,以及在對話中渲染的投影片、互動式元件與行內教學卡片

    使用 DeepSeek Harness 的教育者、教師與智能體,想要互動、蘇格拉底式的教學素材

  • 行內渲染智能體編寫的投影片、元件與 HTML 教學片段

    沙箱卡片與官方渲染器投影片,涵蓋文字、形狀、圖片、表格、圖表、公式、程式碼、模擬與遊戲

    希望在 DeepSeek Harness 內直接生成視覺化、互動課程內容的開發者與教學智能體

02如何將外掛接入 DeepSeek Harness?

安裝步驟

  1. 01

    執行 `dsh plugin --profile web add git+https://github.com/THU-MAIC/dsh-openmaic.git`,把插件安裝到 `web` 設定檔。

    $ dsh plugin --profile web add git+https://github.com/THU-MAIC/dsh-openmaic.git

  2. 02

    重新啟動 `dsh web` 並重新整理頁面——存放庫已自帶編譯好的 `lib/`,因此無須建置步驟。

    $ dsh web

驗證整合成功

作者未說明

03DSH 整合程度與能力邊界

DSH 整合原生執行環境

原生 DeepSeek Harness 執行期插件:透過官方 `dsh plugin --profile web add` 指令安裝,在執行期內註冊四個工具與蘇格拉底式教學技能。

  • openmaic_generate — 課堂生成

    一條課程需求(例如「幫我做一節 X 課」),以及選用的 `language` 等參數→open.maic.chat 上可播放的課堂連結,由非同步生成任務回傳

  • openmaic_slide — 投影片渲染

    一份以 PPTist 風格 Slide JSON 編寫的 OpenMAIC 投影片→經 OpenMAIC 官方渲染器渲染的投影片(文字、形狀、圖片、表格、圖表、公式、程式碼)

  • openmaic_widget — 互動式元件

    一份依內建契約編寫的 OpenMAIC 風格互動式元件(模擬、遊戲或程式碼)→以行內沙箱卡片形式渲染的完整 HTML 文件;程式碼在智能體編寫時串流式輸出

  • openmaic_render — 行內 HTML 教學卡片

    一段行內 HTML 教學片段(概念卡、測驗、逐步解說)→在對話中就地渲染的沙箱卡片

  • openmaic-teach — 蘇格拉底式教學技能

    一次 DeepSeek Harness 會話→以引導式提問教學的蘇格拉底式 OpenMAIC 課程,並呼叫投影片、元件與卡片作為輔助

04適合誰?何時不該用?

適合

  • 使用 DeepSeek Harness 的教育者、教師與智能體,想要互動、蘇格拉底式的教學素材
  • 希望在 DeepSeek Harness 內直接生成視覺化、互動課程內容的開發者與教學智能體

不適合

  • slide/widget/render 工具不進行服務端生成;它們渲染智能體依據 OpenMAIC SDK 契約(`@openmaic/dsl`、`@openmaic/generation`、`@openmaic/renderer`)編寫的內容,並以沙箱卡片形式行內展示。

05相容性、維護與安全提醒

  • 生成類工具會把需求提交到 open.maic.chat 並遠端輪詢;課堂生成為非同步過程,依賴外部 OpenMAIC 服務可連網存取。
  • slide/widget/render 工具不進行服務端生成;它們渲染智能體依據 OpenMAIC SDK 契約(`@openmaic/dsl`、`@openmaic/generation`、`@openmaic/renderer`)編寫的內容,並以沙箱卡片形式行內展示。
  • 課堂生成較慢;預設 `pollIntervalMs` 為 5000,但 60000 更友善,單一任務上限 `maxWaitMs` = 600000(10 分鐘)。
2026-08-132026-08-13作者未說明

MIT · maintained (latest release not published; tracked from default-branch commit)

06常見問題

如何在 DeepSeek Harness 中安裝 dsh-openmaic?

執行 `dsh plugin --profile web add git+https://github.com/THU-MAIC/dsh-openmaic.git`,然後重新啟動 `dsh web` 並重新整理。插件自帶編譯好的 `lib/`,因此 git 安裝無須建置。

這個插件註冊了哪些工具?

它註冊了四個工具——`openmaic_generate`、`openmaic_slide`、`openmaic_widget`、`openmaic_render`——以及一個 `openmaic-teach` 技能,該技能以蘇格拉底式教學會話執行,並以上述工具作為輔助。

課堂在哪裡生成?需要帳號嗎?

`openmaic_generate` 把需求提交到 open.maic.chat 並輪詢非同步任務,回傳可播放的課堂連結。設定項 `accessCode`(邀請碼)目前線上尚未強制驗證,可暫時留空。

slide/widget/render 工具需要服務端生成嗎?

不需要。這些工具不進行服務端生成;它們渲染智能體依據 OpenMAIC SDK 契約(`@openmaic/dsl`、`@openmaic/generation`、`@openmaic/renderer`)編寫的內容,並以沙箱卡片形式行內展示。

如何把插件指向本地的 OpenMAIC 實例?

在插件設定(`dsh-openmaic.baseUrl`)中將 `baseUrl` 設為 `http://localhost:3000`。其它可調項包含 `pollIntervalMs` 與 `maxWaitMs`(單一生成任務的 10 分鐘上限)。

08資料與來源

  • 作者聲明github.com09c1693cfe83…

    `dsh-openmaic` is a DeepSeek Harness plugin that registers four tools

  • 作者聲明github.com09c1693cfe83…

    dsh plugin --profile web add git+https://github.com/THU-MAIC/dsh-openmaic.git

此頁面根據專案公開文件、儲存庫中繼資料與 DSH Plugins 的結構化解析所產生;最後核實於 2026-09-03。發現錯誤?提交更正。

🏆

最佳 DeepSeek Harness 外掛

從全目錄挑出的 12 個值得優先安裝的外掛,涵蓋各個分類。

DSH Plugins 是獨立的 DeepSeek Harness 外掛市集,與 DeepSeek 官方無關,也不代表官方背書。第三方外掛未經安全稽核,安裝前請審查原始碼。

每週取得最新的 DeepSeek Harness 外掛,絕不濫發。