前言¶

在 DSH（DeepSeek Harness）里做学术论文相关任务，常见问题是流程散落在对话记忆、外部文档和各自编写的脚本里：门控有没有跑、体裁该走哪条链路、用户模式下能不能改真源文件，往往只能靠口头约定。dsh-paper-studio 把「论文方案」（框架、方法论、工作流）做成可编排、可机检、可在对话里直接用的整包：CLI 编排层加 DSH 插件 V3，判据与模板放在 references/ 真源里，仓库侧只做编排与桥接。

下面按定位、能力、安装与典型用法说明，事实以 GitHub 仓库 README 与 SkillHub 目录页 为准。社区目录为独立站点，与 DeepSeek / 幻方无官方从属关系。

这是什么¶

维护者 liuhaolong16，SkillHub 分类为 工作流。本仓库是一个整包（不是「插件壳 + 外置资产」）：files 已含 bin（CLI）、references（判据资产与期刊体系）、plugin（DSH 插件半体、MCP 服务端）、SKILL.md（技能手册）。

一句话定位：论文方案（编排层）+ DSH 论文插件 V3——真源唯一、双模式（用户模式默认封闭）、五种写作模式（行为差异化）、确定性意图判据，并支持可复跑自检（插件 20 项、audit 出厂审查 6 项、编排层 selftest 53 项）。

它解决什么问题¶

README 归纳了四类诉求，与实现方式对应如下。

1. 不用记流程：在对话里说「启用论文插件」「帮我写论文」时，插件先确认一次，再用可点击选项给出五种模式（每项一行说明），选定后按该模式差异化提问。
2. 不空转：每个动作返回退出码与读数；门是否执行、是否通过有据可查。
3. 不假封闭：用户模式下写入会被拒绝（有夹具证明目标文件未变）；开发者模式需用户原话解锁。
4. 不造第二套说法：--selftest 与 audit 会对文档覆盖、规则表重复、真源单一所有者、门元数据、工具自检、数字漂移等项自动核对。

判据本身（门、体裁、模板、篇幅预算等）不在插件逻辑里硬编码，而在 references/pipeline.json、references/templates.json 等真源文件中；换机器时需按 README 配置本机路径占位符（见后文）。

目录与两端角色¶

bin/                 CLI 编排层（studio.cjs 及各子工具，全部自带 --selftest）
references/          真源：pipeline.json、templates.json 等
plugin/              DSH 插件 V3（dist/plugin.js、skill/SKILL.md、selftest.mjs）
docs/                快速上手
SKILL.md             技能说明（触发语、子命令用法、红线）

编排层入口为 bin/studio.cjs，流水线定义以 references/pipeline.json 为唯一真源。插件目录 plugin/ 为对话驱动、无面板、双模式、五种写作模式。只安装 plugin/ 单目录不支持，且会显形失败（缺资产即退出码 1），不会静默降级。

主仓在 Gitee（Suzumiya-haruhi16/dsh-paper-studio），GitHub 侧 liuhaolong16/dsh-paper-studio 公开可读；README 记录两端由工作流定期从 Gitee 镜像，供无法直连 GitHub git 的环境使用。

核心功能¶

CLI 编排层¶

常用子命令（Windows 示例来自 README，Linux/macOS 将路径分隔符改为 / 即可）：

node bin\studio.cjs route "给这篇稿子做投稿前体检"
node bin\studio.cjs sections --genre research
node bin\studio.cjs audit
node bin\studio.cjs selftest

route 判任务类型、链路与必过门；sections 按体裁输出章节骨架（含篇幅预算与必答问题）；audit 为出厂审查；selftest 为编排层自检（53 项）。

全局安装后可直接使用 paper-studio、paper-studio-mcp（见 package.json 的 bin 字段）。

DSH 插件与工具¶

装进 DSH profile 后，宿主注册两个工具：

插件定位能力树的顺序（README）：DSH_PAPER_STUDIO_ROOT → 包内自带（<pkg>/plugin/dist 往上两级）→ ~/.agents/skills/paper-studio → ~/.dsh/skills/paper-studio → ~/paper-studio → /opt/paper-studio。

环境变量与状态目录¶

• DSH_PAPER_STUDIO_ROOT：指向本仓根；未设时按上表顺序查找。
• DSH_PAPER_HUB：状态目录，默认 ~/.dsh/paper-studio。

本机路径登记（装包后建议完成）¶

references/pipeline.json / references/templates.json 内使用 __LOCAL__/<key> 占位符，真值放在用户主目录（不入 git、不进 npm 包）：

mkdir -p ~/.dsh/paper-studio
cp references/local-paths.example.json ~/.dsh/paper-studio/local-paths.json
# 或：export DSH_PAPER_LOCAL_PATHS=/path/to/your/local-paths.json

需填写的 key 包括：playbook_root、playbook_skill、writer_skill、polish_skill、python_exe、phrase_bank。取不到时不会静默变成空串，运行时会提示未解析的本机路径占位符。

README 另说明：references/pipeline.json 的 assets 段可登记作者本机资产路径，换机器时按布局修改或用环境变量覆盖。

安装与启用¶

README 给出三种等价思路，任选其一即可拿到整包能力。

npm 整包（推荐表述为「装一次拿全部」）：

npm i -g dsh-paper-studio

也可把本仓库作为 bundle 装进 profile。

从 GitHub 加入 DSH profile：

dsh plugin --profile <p> add github:liuhaolong16/dsh-paper-studio

本地路径以 bundle 形式安装（README 示例）：

plugin_manager install_bundle target="link:<本仓路径>/plugin"

运行时要求 Node.js ≥ 20。package.json 当前版本为 3.50.2，许可证 MIT（细则见 LICENSE 与 NOTICE.md 中的三分类口径）。联网与检索由宿主或其它技能提供，本仓不要求任何付费或需登录的 API。

安装前应在当前 DSH 进程权限下审阅源码与许可证；插件以该权限访问本机路径与文件。

典型用法¶

对话侧¶

按 SKILL.md 与 README：用自然语言触发（如「启用论文插件」「帮我写论文」），经一次确认后选择五种写作模式之一，后续提问与动作按模式差异化。需要判断是否该启用插件时，可走 paper_studio 的 action=intent。

命令行侧¶

投稿前体检、按体裁拉章节骨架、改完仓库后自检：

node bin/studio.cjs route "给这篇稿子做投稿前体检"
node bin/studio.cjs sections --genre research
node plugin/selftest.mjs
node bin/studio.cjs audit
node bin/studio.cjs selftest

plugin/selftest.mjs 覆盖注册形态、JSON Schema、真封闭、越界拒收、五模式差异化、意图夹具、端到端 CLI 等 20 项。

适用场景与边界¶

适合谁：需要在 DSH 对话里走论文工作流、又希望门控与体裁链路可机检、可复跑的团队或个人；愿意维护 local-paths.json 与可选的 assets 本机登记。

明确不做（README）：不生成图片（图表仅题注文本、绘图建议或 Mermaid 源码）；不做规避 AI 检测类操作。

相关仓：论文方法本体（11 维判据、机器门、投稿前检查表）在 research-paper-playbook，与本仓编排层配合使用。

结尾¶

dsh-paper-studio 把论文写作方案收成「CLI 真源编排 + 插件对话入口」的整包，用退出码、自检与出厂审查降低空转和规则漂移风险，用户模式下的写入封闭有夹具可证。查阅与安装可从社区目录与 GitHub 入手：

• 目录页：https://www.skillhub.cn/plugins/liuhaolong16/dsh-paper-studio
• 仓库：https://github.com/liuhaolong16/dsh-paper-studio