DSH Plugins
返回列表
⚙️

dsh-quarto-book

工作流 更新于 2026.10.21

在终端中运行以下命令:

dsh plugin install chengzhao-dev/dsh-quarto-book

将以下提示词粘贴到 DeepSeek Harness 对话框中:

在 DeepSeek Harness 中执行 dsh plugin install chengzhao-dev/dsh-quarto-book,或按设置添加插件并填写源码地址 https://github.com/chengzhao-dev/dsh-quarto-book。

插件介绍

用 Quarto 写书时,章节骨架、中文行文、代码图表和 _quarto.yml 结构往往分散在多次对话里,主题 CSS 与正文又容易互相踩线;渲染前 output-dir 写错还可能覆盖书根。本插件只在仓库 _quarto.yml 为 type: book 且存在章节源文件时生效,不改业务代码,把「写书」和「换肤」拆成两条清晰路径。

writing-quarto 负责新建或修改 content 下的 .qmd、index 与书籍配置:章节结构、行文润色、代码与图表,以及内容与链接检查;它不动 CSS、字体和配色。designing-theme 则专注主题副本里的样式、字体、palette、导航与 Callout,不改正文。收尾可用 quarto_pass_report 把技能、改动文件与检查结论压成固定回执,便于对照「没跑」和「跑了但没改」。

需要确认能否发布时,quarto_render_check 会先判断输出目录是否安全,再按需执行一次 quarto render,并检查 _book 下 HTML 的可发布性(编码、入口、链接形态等);dry_run 可只查配置而不真正渲染。项目若提供 .agents/skills/quarto-book-project/,通用技能会读取其中的章节对照,否则不猜测书名与术语。

适合维护 Quarto Book 的作者、技术写作者和文档团队:在书仓库或书根子目录的会话里使用,想更窄范围可只装进专门写书的 DSH profile。普通应用仓库或非 book 项目不会加载这些技能,避免误触。

使用场景

  • 在 type: book 仓库里新建或改写章节 .qmd 与书籍结构
  • 调整书内 theme 副本的 CSS、字体与配色而不改正文
  • 改完章节或配置后做一次渲染并检查 _book HTML 是否可发布

适合人员

  • 维护 Quarto Book 长文档或教程的作者
  • 负责中文技术书排版与主题一致性的文档编辑
  • 在 DSH 中按书仓库会话写章节、改样式的团队