前言¶

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