前言¶
在 DSH 裏用智能體改 LaTeX 論文時，常見做法是本地裝 TeX Live、反覆 xelatex 看日誌，再把報錯貼回對話。環境重、中文字體與編譯器選項也容易和協作平臺不一致。若目標是中國科技雲論文協同編輯服務（latex.cstcloud.cn），更穩妥的路徑是：本地只維護源文件，編譯與 PDF 留在雲端，把結構化診斷交給智能體迭代修改。
下面介紹維護者 KeNan2025 發佈的 DSH 插件 硯臺 · Inkstone（倉庫 KeNan2025/inkstone）。它在 SkillHub 目錄中歸類爲聯網工具。插件把本地 LaTeX 項目打包同步到 CSTCloud Overleaf，在服務器上編譯，並將編譯日誌解析成可讀的錯誤與警告列表；本地不需要安裝任何 TeX 環境。README 還說明：若希望智能體直接讀寫編譯診斷、不需要點按鈕，可另裝 inkstone-skill（skill 形態、零依賴 CLI），兩者可並存並共用同一 Overleaf 賬號。
這是什麼¶
Inkstone 是帶可視化面板的 DSH Web 插件（npm 包名 dsh-inkstone，當前版本 1.0.0，許可證 MIT）。核心價值用 README 裏的一句話概括：本地起筆，雲端成書——同步、編譯、回傳診斷形成閉環，智能體與人在同一套響應上協作修稿。
核心功能¶
官方 README 描述的一條閉環如下：
本地編輯 .tex → 同步並編譯 → 服務器編譯 → 錯誤回傳 → 智能體修改 → 再同步
已覈實的能力包括：
- 同步：將所選項目文件夾打包上傳到指定的 Overleaf 項目；同名項目會被新版本替換，儀表盤上始終只保留一個，不會越積越多。
- 編譯：在 CSTCloud 服務器上編譯，本地無需 TeX；主文件（
main.tex優先）與編譯器（XeLaTeX）由插件自動識別。 - 回傳：編譯日誌被解析爲結構化錯誤（類型、原文、上下文行），面板展示，智能體也可讀取同一條響應。
- 接入方式：通過瀏覽器 Cookie（
overleaf.sid）複用 CSTCloud SSO 登錄態，保存前會真實訪問站點驗證。
插件不內嵌 Overleaf 編輯器（README「實現要點」說明同源反向代理已棄用）；不把 PDF 下載到本地，成功後可從面板「在 Overleaf 打開」。上游僅支持 latex.cstcloud.cn，Host 半固定該地址。
安裝與啓用¶
環境要求（來自 README 與 package.json）：
- DSH
>= 0.2.1-rc.2 - Node
^22.19.0或>= 24.0.0
安裝命令須使用資料原文：
dsh plugin --profile web add github:KeNan2025/inkstone
裝好後刷新 DSH 頁面，左側面板欄會出現石硯圖標，點開即爲工作臺。
DSH 社區插件以當前 DSH 進程權限運行；安裝前建議閱讀倉庫源碼與 MIT 許可證，確認 Cookie 與會話存儲方式符合你的安全預期（README 寫明 Cookie 保存在本機 DSH 進程或 ~/.dsh/overleaf-workbench/session.json，權限 0600，有效期約 5 天）。
典型用法¶
第一次接入雲端¶
latex.cstcloud.cn 使用 CSTCloud 統一身份認證（SSO）。插件複用瀏覽器登錄態，步驟如下：
- 瀏覽器打開 https://latex.cstcloud.cn/project，確認已登錄。
F12→ Application → Cookies →https://latex.cstcloud.cn。- 找到
overleaf.sid，複製其 Value（整行或帶屬性均可）。 - 粘貼進面板，點「保存並驗證」。失效會當場報錯，不會覆蓋仍有效的舊配置。
選材、同步並編譯¶
- 選擇 LaTeX 項目文件夾（「瀏覽…」或從已打開工作區選取）。
- 面板顯示文件數、體積與主文件。
- 點「同步並編譯」，等待約一分鐘（README 稱單次約 30–60 秒，編譯超時上限 5 分鐘）。
看結果並交給智能體¶
成功時顯示編譯成功、用時、遠端項目名，可跳轉 Overleaf。
失敗時按類型列出診斷，例如：
ERROR ! Undefined control sequence.
ctx: l.113 \setCJKmainfont {SimSun}[AutoFakeBold=3,ItalicFont=KaiTi]
WARNING LaTeX Warning: There were undefined references.
將診斷交給 DSH 智能體修改源文件，改完再點「同步並編譯」。
適用場景與注意¶
適合：在 DSH 中寫學位論文、中文 LaTeX 稿件，希望與 CSTCloud Overleaf 對齊編譯環境、又不想在本機維護 TeX 的用戶；需要可視化面板一鍵同步編譯的場景。
務必知曉的限制（README「已知限制」）：
- 同步採用重建而非增量：每次同步生成新項目 id（名稱不變）；若在網頁上手動改過內容，下次同步會被本地覆蓋。
- 產物不落本地，PDF 留在遠端。
- 僅支持 latex.cstcloud.cn，不對用戶開放任意上游代理。
DeepSeek Harness 的理念是「一切皆插件」；SkillHub 等社區目錄爲獨立站點，與 DeepSeek / 幻方無官方從屬關係。本插件在目錄頁爲 KeNan2025/inkstone，源碼與 issue 見 GitHub。
結尾¶
Inkstone 把「本地編輯 → 雲端編譯 → 診斷回傳 → 智能體修稿」收成可重複的操作：無需本地 TeX，編譯器在服務端按 XeLaTeX 配置，錯誤以結構化形式回到 DSH。若你已在 CSTCloud Overleaf 上有項目習慣，可在 DSH 中安裝上述命令對應的插件，用面板完成首次 Cookie 驗證後即可進入同步編譯循環。
