返回目錄

dsh-overleaf

精選清單收錄維護狀態: 活躍

fly233338/dsh-overleaf

通过 OverleafMCP 连接 Overleaf 论文项目,支持 LaTeX 协作写作

前往 GitHub專案首頁
$ dsh plugin --profile web add dsh-overleaf

14

星數

3

Fork

JavaScript

語言

MIT

授權條款

2026-08-14

建立於

2026-10-21

最近推送

MIT 授權的 DSH 外掛,透過 MCP stdio 暴露 OverleafMCP,讓 DeepSeek Harness 用一個 token 讀取並以 Git 提交修改多個 Overleaf LaTeX 專案。

DSH 整合

原生執行環境

作者聲明

安全稽核

未稽核

最後核實

2026-11-14

授權條款

MIT

01它能幫你完成什麼?

  • 在 DeepSeek Harness 裡看懂整個 LaTeX 專案,而不是貼上零散片段

    模型先用 `mcp__overleaf__list_projects` 列出 Overleaf 專案,再透過 OverleafMCP 的工具讀取檔案、檢文章節與章節內容

    希望 agent 在動手改之前先看到真實專案結構的 LaTeX 作者

  • 修掉 LaTeX 編譯錯誤,並統一全文的術語與符號

    透過 Git 寫回 Overleaf 的檔案或章節,每次寫入都帶明確的 `commitMessage` 並推送一次提交

    希望 agent 直接修補並規範整篇長檔案、而不是手動套用建議補丁的論文作者

  • 在同一個 DSH 工作階段裡處理多個 Overleaf 專案

    一組 MCP 工具涵蓋 `dsh-overleaf.config.json` 裡列出的所有專案 ID

    同時維護多篇 Overleaf 論文或報告的人

02如何將外掛接入 DeepSeek Harness?

先決條件

  • DSH `0.1.0-rc.5` 或 `0.2.x`(在 `0.2.0-rc.2` 上驗證過)
  • Node.js `22.19.0` 或更新版本
  • 一個 Overleaf Git 整合 token

安裝步驟

  1. 01

    如果 DSH CLI 已在 `PATH` 上:執行 `dsh plugin --profile web add dsh-overleaf`,再執行 `dsh web`

    $ dsh plugin --profile web add dsh-overleaf

  2. 02

    從 DSH 原始碼 checkout 安裝:`pnpm install`、`pnpm run build`、`pnpm dsh plugin --profile web add /path/to/dsh-overleaf`、`pnpm dsh web`

  3. 03

    在 `$DSH_HOME/dsh-overleaf/`(沒有 DSH_HOME 時是 `~/.dsh/dsh-overleaf/`)下建立 `dsh-overleaf.config.json`,填入 `gitToken` 與 `projectIds`,然後重新啟動 DSH

驗證整合成功

  • 告訴模型要處理哪個專案,它會先呼叫 `mcp__overleaf__list_projects`,能列出來就表示 OverleafMCP 的工具已經接進 DSH

03DSH 整合程度與能力邊界

DSH 整合原生執行環境

DSH 外掛:把 `@fly233338/overleaf-mcp` 裝成相依套件,以 MCP stdio 啟動,再把它提供的工具交給宿主提供的 DSH MCP Client

  • 跨專案列出與讀取檔案

    `dsh-overleaf.config.json` 裡設定的 Overleaf 專案 ID→來自 `mcp__overleaf__list_projects` 的專案清單、檔案內容,以及章節與章節內容

  • 透過 Overleaf Git 寫回檔案與章節

    檔案或章節的修改,加上明確的 `commitMessage`→推送到 Overleaf 專案的一次 Git 提交

    向 Overleaf 專案推送一次 Git 提交
  • 產生 OverleafMCP 的專案設定

    `dsh-overleaf.config.json` 裡共用的 `gitToken` 與 `projectIds`→同一目錄下由 OverleafMCP 讀取的內部 `.dsh-overleaf.projects.json`

    在使用者設定旁寫入並重新產生 `.dsh-overleaf.projects.json`

04適合誰?何時不該用?

適合

  • 希望 agent 在動手改之前先看到真實專案結構的 LaTeX 作者
  • 希望 agent 直接修補並規範整篇長檔案、而不是手動套用建議補丁的論文作者
  • 同時維護多篇 Overleaf 論文或報告的人

不適合

  • 外掛不編譯檔案、不審閱 PDF、也不自動化瀏覽器,只透過這組 MCP 工具讀寫 Overleaf 專案內容。
  • 需要一個 Overleaf Git 整合 token,README 提醒不要把 token 放進公開原始碼儲存庫或已發佈的套件內容裡。設定只在啟動時讀一次,改完必須重新啟動 DSH。
  • README 寫明 DSH 需要 `0.1.0-rc.5` 或 `0.2.x`(在 `0.2.0-rc.2` 上驗證過),Node.js 需要 `22.19.0` 以上,並說明 npm 安裝命令要等這個套件發佈後才可用。
  • 每次寫入都必須帶明確的 `commitMessage`,並以 Git 提交的形式落到 Overleaf 上,所以改動是真實專案歷史而不是本機草稿。

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

  • 外掛不編譯檔案、不審閱 PDF、也不自動化瀏覽器,只透過這組 MCP 工具讀寫 Overleaf 專案內容。
  • 需要一個 Overleaf Git 整合 token,README 提醒不要把 token 放進公開原始碼儲存庫或已發佈的套件內容裡。設定只在啟動時讀一次,改完必須重新啟動 DSH。
  • README 寫明 DSH 需要 `0.1.0-rc.5` 或 `0.2.x`(在 `0.2.0-rc.2` 上驗證過),Node.js 需要 `22.19.0` 以上,並說明 npm 安裝命令要等這個套件發佈後才可用。
  • 每次寫入都必須帶明確的 `commitMessage`,並以 Git 提交的形式落到 Overleaf 上,所以改動是真實專案歷史而不是本機草稿。
2026-08-142026-10-21作者未說明

MIT · 僅有 README 證據,無帶 tag 的發佈,未做安全稽核

06常見問題

在 DeepSeek Harness 裡怎麼安裝 dsh-overleaf?

DSH CLI 在 `PATH` 上時,執行 `dsh plugin --profile web add dsh-overleaf`,再執行 `dsh web`;從 DSH 原始碼 checkout 安裝則用 `pnpm install`、`pnpm run build`、`pnpm dsh plugin --profile web add /path/to/dsh-overleaf`、`pnpm dsh web`。README 說明直接 npm 安裝的命令要等這個套件發佈後才可用。

外掛從哪裡讀 Overleaf token 與專案 ID?

從 `$DSH_HOME/dsh-overleaf/` 下的 `dsh-overleaf.config.json` 讀;沒有設定 `DSH_HOME` 時用 `~/.dsh/dsh-overleaf/`,目錄與檔案缺少時會在啟動時建立。在 `projectIds` 裡填一個共用的 `gitToken` 和每行一個專案 ID,然後重新啟動 DSH —— 外掛只在啟動時讀一次,並產生 OverleafMCP 使用的內部 `.dsh-overleaf.projects.json`。

模型怎麼知道該處理哪個 Overleaf 專案?

由你告訴它,例如「處理 Overleaf 專案 project-id-a」。模型會先呼叫 `mcp__overleaf__list_projects`,再把選中的 ID 當成 `projectName` 傳給後續的 Overleaf 工具,所以同一組 MCP 工具能服務你設定的所有專案 ID。

它在 DSH 裡做不到什麼?

README 寫得很明確:目前版本不編譯檔案、不審閱 PDF、也不自動化瀏覽器。另外它需要 DSH `0.1.0-rc.5` 或 `0.2.x` 以及 Node.js `22.19.0` 以上,每次寫入都必須帶明確的 `commitMessage` 並推送一次 Git 提交到 Overleaf。

08資料與來源

  • 作者聲明github.com59058647a7d6…

    `dsh-overleaf` installs [@fly233338/overleaf-mcp](https://www.npmjs.com/package/@fly233338/overleaf-mcp) as an npm depen…

  • 作者聲明github.com59058647a7d6…

    Browse and read files from multiple Overleaf projects, inspect document sections and section content, write files or sec…

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

🏆

最佳 DeepSeek Harness 外掛

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

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

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