前言¶

DeepSeek Harness（dsh）通過插件把能力註冊進模型的工具列表。古文字方向已有 guwenzi-tools tools --server 這類機器可讀接口，但若只在終端裏手工跑 CLI，模型通常拿不到「何時用、輸入什麼、返回什麼、下一步做什麼」的結構化說明，字形結果也往往是路徑或文字描述，而不是可直接覈對的圖像塊。

Open-Glyph 維護的 OpenGlyph-DeepSeek-Harness（npm 包名 @openglyph/dsh-openglyph，當前 v0.2.2）把 OpenGlyph 文檔處理、字形檢索、部件組合與可排印字體相關能力，註冊爲 DSH 原生工具，統一技能入口爲 /openglyph。下面介紹定位、能力邊界、安裝與典型用法；事實以 GitHub 倉庫 README 爲準。

這是什麼¶

一句話：把古文字工具鏈註冊進 DeepSeek Harness，讓模型按工具契約調用遠端與本地能力，並把候選字形、原頁等以 Harness 附件形式呈現，而不是再塞一份「請自行運行 CLI」的籠統提示。

• 維護者：Open-Glyph（倉庫作者 Zejia FAN）
• 分類：客戶端（DSH 插件）
• 適用材料：古籍、甲骨、金文、簡帛等字形證據採集，以及生僻隸定字的字體與 LaTeX 排印
• 重要邊界（README 明確說明）：字形檢索不等於釋讀；生成字體不等於字形已經覈定；DINO 相似候選不能代替原圖與人工覈定

核心功能¶

v0.2.2 註冊 33 個原生工具：20 個遠端原子工具、7 個輔助工具、6 個本地 LaTeX 工具。插件不替換 DeepSeek 模型本身，也不改 Harness 賬號預算；雲端識別/檢索複用本機 guwenzi-tools 登錄態，無需把網站密碼或 API Key 交給模型。

與常見誤解對應的說明（來自 README）：

除字體包交付外，插件還支持準備論文級 LaTeX 項目、使用隨包 22,583 字字庫、離線編譯 JSON 新字、編譯 PDF 並檢查缺字與字體嵌入；部件預覽使用 WASM，README 稱不要求爲 macOS 桌面版改代碼簽名安全設置。工具參數與返回見倉庫 docs/TOOLS.md。

識別並排印類任務，模型常按需選用如下鏈路（非每步強制）：

本地文件 → gwz_open → 指定頁原圖 → gwz_glyph_detect
         → gwz_glyph_template_search → gwz_glyph_template_inspect
         → gwz_glyph_compose → gwz_glyph_verify → gwz_deliver

LaTeX 排印鏈路：

gwz_latex_setup → gwz_latex_prepare → 編輯 main.tex → gwz_latex_compile → PDF
                    ↑ gwz_latex_lookup 查已有編號
                    ↑ gwz_latex_inspect → JSON → gwz_latex_build 生成新字庫
                    ↑ 也可導入遠端造字交付的 LaTeX 字體 ZIP

候選圖、原頁、部件圖等會寫入 Harness 持久附件服務，作爲真實圖像內容塊送給支持圖像輸入的模型；若宿主拒絕圖像，插件保留 image_failures 與完整記錄，不會聲稱「已經看過」。中間證據在 work/openglyph/，遠端字體交付整理到 outputs/古文字排印/<名稱>/（OTF/TTF、映射 JSON、LaTeX ZIP 等，均爲可排印候選稿，ready 僅表示字體生成成功）。

安裝與啓用¶

README 寫明實際測試的 Harness SDK 爲 0.2.1-rc.5，Node.js 要求 24.9+，含同版本桌面應用；未聲稱兼容未測試的 alpha。桌面版可在應用插件管理中安裝/更新本倉庫並啓用，更新後確認插件版本 0.2.2，重新加載插件或空閒時重啓後再開新會話。

命令行版 DSH 按 DeepSeek 官方說明 安裝；以下爲 README 給出的可選路徑。

1、雲端識別/檢索：CLI 與賬號¶

純本地已有字排印不需要雲賬號。需要遠端識別/檢索時：

python3 -m pip install -U 'guwenzi-tools>=0.6.0'
guwenzi-tools login
guwenzi-tools doctor --quick

按瀏覽器完成授權後回到終端；插件複用該連接。本地生成論文 PDF 需要 Tectonic 或 XeLaTeX；gwz_latex_setup 會逐項檢查，缺編譯器需先安裝或配置路徑。

2、將插件安裝進 profile¶

例如網頁版 web profile：

dsh plugin --profile web add github:Open-Glyph/OpenGlyph-DeepSeek-Harness#v0.2.2
dsh web

其他 profile 替換爲實際名稱（桌面版通常爲 desktop，不是 web）。Git 安裝直接使用倉庫內 ESM，無需構建腳本。更嚴格的固定方式是把標籤換成審查過的 commit SHA。

安裝前後不會自動修改網站、PAI 配置或原有三個通用 skills；可與通用 skills 共存。舊技能名 /openglyph-paleography 仍兼容。

3、工作文件夾¶

在 Harness 中選擇專門的本地工作文件夾，將待處理 PDF 或圖片複製進去。默認只允許上傳該目錄內文件。PDF 頁碼指物理頁碼，不是書中印刷頁碼。

典型用法¶

以下文字發到 DeepSeek 對話框，不是終端。

首次建議自檢：

/openglyph 先自檢，告訴我哪些能力可用、缺什麼。

滿足先決條件後，選 /openglyph 再用自然語言描述任務即可；不必手工輸入各工具命令。

識別並排印一頁（README 示例）：

/openglyph 請處理工作文件夾中 清華簡.pdf 的物理第32頁，用專用工具查形、造字，最後用我們的LaTeX包排成論文PDF，並給源碼項目。不要用相近常用字替換，保留原圖證據和待人工覈定意見，不處理其他頁。

單字造字並排印：

/openglyph 請把 待造字.png 做成可排印候選字，再與普通漢字混排成PDF。請給字體、映射、源碼和比較意見，不要只貼圖片。

已有字 LaTeX 示例（編號須來自實際查詢/編譯，不可猜測 Unicode）：

\documentclass[UTF8,fontset=fandol]{ctexart}
\usepackage{openglyph}
\OpenGlyphLoad{ebag}
\begin{document}
這個現成字直接排進正文：\ebag{s030-067}。
\end{document}

中斷的遠端任務可用 gwz_resume 恢復，避免重複上傳；插件不新增頁數、字數、上傳體積或服務端配額類限制（仍以各自賬號與宿主配置爲準）。

適用場景與注意¶

適合：需要在 DSH 會話裏完成「取頁圖 → 檢字/模板 → 造字 → 交付字體或 LaTeX 項目 → 可選 PDF 編譯」的一體化協作；希望模型看到字形圖像證據而非僅 JSON 路徑。

使用前請知悉：

1. 插件以當前 dsh 進程權限在宿主 shell 中執行本地構字/編譯，繼承文件沙箱；安裝前應閱讀倉庫源碼與 MIT 插件許可，以及 THIRD-PARTY-NOTICES.md 中的 GlyphWiki、KAGE 等第三方許可。
2. 模型路線須支持圖像輸入，Harness 須啓用附件服務。
3. PUA 碼位僅屬於隨附字體，須保留字體與映射，不能當作正式 Unicode 身份；人工未確認時插件不會僞造確認記錄。
4. DeepSeek Harness 社區插件目錄（如 SkillHub 目錄頁）爲獨立生態站點，與 DeepSeek / 幻方無官方從屬關係；本文不將其描述爲官方應用商店。

可選高級配置在 profile 的 cordis.patch.yml 中覆蓋 openglyph 插件行（cli、evidenceDirectory、latexEngine、tectonic 等），詳見 README；正常情況下無需配置。不要把密鑰寫入插件 YAML。

結尾¶

OpenGlyph-DeepSeek-Harness 把古文字 CLI 與 LaTeX 排印能力收斂爲 DSH 原生工具與 /openglyph 技能，在保留學術邊界說明的前提下，支持從文獻頁到可排印候選稿的可復現工作流。

• 目錄頁：https://www.skillhub.cn/plugins/Open-Glyph/OpenGlyph-DeepSeek-Harness
• GitHub：https://github.com/Open-Glyph/OpenGlyph-DeepSeek-Harness
• 網站：https://openglyph.cn；排印庫：https://github.com/Open-Glyph/OpenGlyph-LaTeX