前言¶
在 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 验证后即可进入同步编译循环。
