前言¶
在 DeepSeek Harness（DSH）裏做智能體或工具鏈開發時，主界面通常是對話與插件槽位；若你要寫論文、報告或技術文檔，往往還要另開編輯器、本地 TeX 發行版和 PDF 閱讀器，改稿與問模型之間還要來回複製路徑和編譯日誌。Folio 是社區維護的 DSH 客戶端插件：在 Harness 側欄增加 Folio 寫作 頁面，把 LaTeX 源碼、PDF 預覽和 Harness 原生對話放在同一工作區，TeX 在本機編譯，助手只能提出修改建議，由你在差異視圖裏應用或捨棄。
這是什麼¶
Folio（npm 包名 dsh-folio，當前版本 0.2.0，MIT 許可證）由 Meinianda-L 維護，是面向 DeepSeek Harness 的 LaTeX 寫作工作區插件。一句話定位：在 Harness 裏寫 LaTeX、編譯成 PDF，並通過你已配置好的模型在原生 Harness 對話裏協作；文稿是磁盤上的普通文件夾，不需要爲 Folio 單獨註冊賬號或 API Key。
社區目錄頁：skillhub.cn/plugins/Meinianda-L/folio（獨立站點，與 DeepSeek / 幻方無官方從屬關係）。源碼與說明：github.com/Meinianda-L/folio（GitHub 上約 2 stars）。
核心功能¶
下面按 README 已說明的能力歸納；未在資料中出現的不展開。
編輯器與項目¶
- CodeMirror 6 LaTeX 高亮；約 150 個常用命令與 30+ 環境的
\補全，Tab 跳轉佔位符。 - 項目級補全：
\ref{/\cref{對全項目\label；\cite{對.bib；\input{、\includegraphics{、\usepackage{、\documentclass{對文件與宏包。 - 停止輸入約 1 秒後自動保存，並用哈希避免覆蓋磁盤上的外部改動；搜索替換、括號匹配、CJK -aware 字數統計。
- 格式工具欄與右鍵菜單：常見 LaTeX 結構、在 PDF 中定位（SyncTeX 反向）、編輯器設置（字號、字體、七套配色等）。
PDF 預覽與 SyncTeX¶
- PDF.js 連續頁預覽，文字可選中複製； pinch 或 ⌘/Ctrl + 滾輪以指針爲中心縮放，重建後保持頁碼與位置。
- 雙擊 PDF 跳到對應源碼行（含
\input引入的文件）；工具欄或右鍵 Show in PDF / 在 PDF 中定位 從源碼跳到 PDF。
編譯與 TeX 環境¶
- 引擎：pdfLaTeX、XeLaTeX、LuaLaTeX、Tectonic；支持 BibTeX/Biber 與必要時的重編譯。
- ⌘/Ctrl + S 保存並編譯，⌘/Ctrl + Enter 僅編譯；可開啓保存時自動編譯。問題列表可點擊跳到文件與行；上一次成功的 PDF 會保留在磁盤上。
- TeX 環境 對話框：列出檢測到的工具、版本與路徑；在指定目錄、Harness
PATH及常見安裝位置中查找 MacTeX / TeX Live / TinyTeX / MiKTeX；Test rendering / 測試渲染 對各引擎與中文（ctex）做小樣編譯。
導入與文稿庫¶
- 導入
.zip（如 Overleaf 導出）或文件夾，可拖拽；跳過隱藏項、.git、__MACOSX與常見編譯產物；自動識別主文件（優先main.tex）與引擎（% !TEX program =或按 fontspec/ctex 等推斷）。
助手與審閱¶
- 每份文稿對應 Harness Workspace，對話爲其中的 Session，側欄可見；切換、新建、歸檔對話，可一鍵歸檔空對話。
- 助手在工具層僅可使用
folio_project：列/讀文件、編譯、讀上次構建結果、propose_patch（精確 find/replace 或整文件）。修改以 diff 呈現，應用前你可審閱；寫作會話被限制爲上述工具，不能借 shell 等繞過審閱。 - 每輪對話會附帶當前文稿、文件、光標、選區與最近編譯錯誤等上下文，無需手動粘貼。
界面與集成¶
- 視覺與明暗主題跟隨 Harness 設計令牌；面板可開關、縮放；助手可拖出浮窗或停靠左/右/底。
環境要求¶
資料中寫明的依賴如下：
- DeepSeek Harness：
0.2.1-rc.2系列（web profile）；package.json中dsh引擎範圍爲>=0.2.1-rc.2 <0.3.0。 - Node.js 24+。
- 本機 TeX 發行版（啓動 Harness 時
PATH中最好已有；若無，Folio 仍常能自動發現，或在 TeX 環境 中指定 bin 目錄）。Linux 示例包：texlive-latex-base texlive-latex-recommended texlive-latex-extra texlive-xetex；中文另需texlive-lang-chinese及字體。Tectonic 爲可選引擎。
安裝與啓用¶
官方 README（含 README.zh-CN.md）給出的安裝步驟如下。倉庫已附帶構建好的 client.js，按文檔說明可直接使用，無需自行 npm run build。
git clone https://github.com/Meinianda-L/folio.git
cd folio
npm install --omit=dev
dsh plugin --profile web add "$(pwd)"
完成後重啓 dsh web，在 Harness 側欄打開 Folio 寫作。
更新插件時，在倉庫目錄執行 git pull 與 npm install --omit=dev，再重啓 Harness；若僅瀏覽器端 client.js 變更，刷新頁面即可。
安全說明：插件以當前 DSH 進程權限運行，可讀寫其配置的文稿目錄並調用本機 TeX。安裝前請自行閱讀源碼與 MIT 許可證，確認可信後再加入 profile。
典型用法¶
README 中的可復現流程可概括爲：
- 在文稿庫新建文稿（英文論文、中文 ctexart 或空白模板），或導入已有 zip/文件夾。
- 寫作：文件樹、源碼與 PDF 並排；★ 標記主文件；圖片或
.bib可拖到文件樹上傳。 - 編譯：工具欄，或 ⌘/Ctrl + S / ⌘/Ctrl + Enter；點編譯狀態查看問題列表。
- 問助手：在嵌入的對話裏選模型，例如精簡摘要或修復編譯錯誤；先選中文本可限定範圍。
- 審閱：出現修改建議時打開 diff，應用或捨棄（僅當文件自建議生成後未被改動時應用纔會成功）。
常用快捷鍵（與 README 一致）：
| 快捷鍵 | 作用 |
|---|---|
| ⌘/Ctrl + S | 保存並編譯 |
| ⌘/Ctrl + Enter | 編譯 |
\ |
命令補全 |
| 雙擊 PDF | 跳到對應源碼行 |
配置與數據位置¶
- 默認文稿根目錄：
~/Documents/DSH-Folio。若要更換，在 profile 的cordis.patch.yml（例如~/.dsh/profiles/web/cordis.patch.yml）中增加：
- id: folio
config:
projectRoot: /Users/you/Papers
- 環境變量
DSH_FOLIO_TEX_CACHE：Tectonic 預熱緩存所在的 XDG 緩存根（默認XDG_CACHE_HOME或~/.cache）。
每份文稿在 projectRoot 下以 ID 建目錄，含 project.json、源文件與 .folio/（如 output.pdf、build.json、proposals.json）。刪除文稿會移入 .trash/，而非立即抹掉。
適用場景與注意¶
適合：已在用 DSH web profile、希望在本機寫 LaTeX、看 PDF、並用同一套 Harness 模型做潤色或修編譯錯誤，且希望 AI 不能直接改文件的單用戶場景。
不適合（README「不包含」）：多人協作、分享鏈接、公網隧道、獨立賬號體系或 Folio 自帶的 API Key 存儲。
限制（資料原文）：編譯全局串行、項目內文件與大小上限、原生 TeX 並非 OS 級沙箱——Folio 面向你信任的本機項目。編譯在臨時快照中進行，有超時與 openin_any 等約束；請勿把不可信來源的 TeX 項目直接交給本機引擎。
結尾¶
Folio 把 LaTeX 編輯、真實 TeX 構建、PDF 預覽與 Harness 原生對話收進一個插件頁，並用 propose_patch + diff 審閱把「AI 改稿」約束在可接受的流程裏。若你在 DSH 生態裏找客戶端側的論文寫作工具，可從社區目錄與 GitHub 閱讀完整說明後再安裝：
- 目錄頁：https://www.skillhub.cn/plugins/Meinianda-L/folio
- 倉庫：https://github.com/Meinianda-L/folio
