dsh-literature-agents:文史与古典文献研究工具包

前言

在 DeepSeek Harness(DSH)里做文史、古典文献或数字人文相关对话时,常见问题是:模型会泛泛而谈,却缺少可核验的论文与古籍来源,也难以按校勘、训诂、翻译等分工组织回答。通用智能体插件多面向计算机或通用任务,对 Crossref、中文维基文库、Wikidata 等链路也没有现成封装。

dsh-literature-agents(维护者 yujh129)是 DSH 社区插件目录中的工作流类条目,面向 DSH 0.2.1-rc.2 及以上(见包内 dsh.engines 声明)。它提供一个 Host bundle 与一个 Web 客户端模块:9 个文献工具、11 位文史专家子代理、3 个评审团,以及输入区的「古籍」开关,用于按对话启停整套能力。运行方式参考 @michengai/dsh-agency-agents:通过 cordis.patch.yml 注入、注册模型侧工具与系统提示,专家子代理经 ctx.subagents.startActivation() 激活。

这是什么

插件全名 dsh-literature-agents,当前发布版本为 1.0.0,MIT 许可。一句话定位:在 DSH 会话中接入可溯源的文献检索、古籍阅读与翻译、引用核验,并可召唤领域专家子代理与并行评审团。

检索类工具在输出中会附带一行「数据源:… ✓/✗(原因)」;上游失败时降级并说明原因,不补造结果。

九个文献工具

能力 工具名 主要数据源
论文检索 search_scholar_papers Crossref、OpenAlex,网页搜索兜底
学人生平 get_scholar_biography Wikidata(属性级溯源)+ OpenAlex 著作
古籍检索 search_classic_texts 中文维基文库全文检索
古籍阅读 get_classic_text 中文维基文库页面正文
古籍翻译 translate_classic 平行文本/旧注检索后,由翻译专家今译或英译
引用核验 verify_citation Crossref DOI、题名相似度
专家召唤 summon_literature_expert 11 位文史专家子代理
评审团 run_literature_panel 3 个并行评审团
专家名册 list_literature_experts 列出专家、领域与评审团

专家子代理与评审团

11 位专家(5 个领域)

  • 史学与人物:史学史专家 historiographer、学人行实考据专家 biographer
  • 文献考据:校勘学家 textual-critic、目录版本学家 bibliographer、训诂学家 philologist
  • 古籍翻译:古籍翻译家 classics-translator、注疏专家 scholia-expert
  • 文学研究:文学批评家 literary-critic、比较文学学者 comparatist
  • 数字人文与核验:数字人文研究者 digital-humanist、学术核验员 citation-auditor

3 个评审团

  • 古籍考据评审团 classics-research-panel:目录、校勘、训诂、注疏
  • 文学研究评审团 literature-review-panel:史学史、文学批评、比较文学、引用核验
  • 古籍翻译审校团 translation-review-panel:译文、旧注、训诂、引用

评审团只返回各成员独立意见;主会话负责核验证据、去重,并按严重级别汇总后交付。

技能与研究协议

skills/literature-research/SKILL.md 由 patch 中第二条 Host 行(@deepseek-ai/dsh-skill-filesystem)挂载,内容涵盖分层检索、事实纪律、生平考据、古籍阅读、翻译规范与引用核验清单。@deepseek-ai/dsh-skill-filesystem 由宿主 @deepseek-ai/dsh-base 提供;插件仅在 patch 里按模块名挂载,不在 peerDependencies 中重复声明,以免 profile 内出现第二份旧版本遮蔽宿主自带模块。

安装与启用

插件以当前 DSH 进程权限运行,安装前建议阅读仓库源码与 MIT 许可证。社区目录页:https://www.skillhub.cn/plugins/yujh129/dsh-literature-agents。

从插件市场(dsh-market)

在 dsh-market 中搜索 Literature & Classics Agents 安装,目标即本仓库:

dsh plugin add github:yujh129/dsh-literature-agents

Windows 桌面版若提示无法识别 dsh,可使用安装目录下 resources\runtime\cli\bin\dsh.cmd 的完整路径,或将该 bin 加入 PATH。

也可在当前会话让 agent 调用:

plugin_manager install_bundle target="github:yujh129/dsh-literature-agents"

安装会写入 profile 的 dsh.profile.bundles 并热装载。若曾被停用,可再启用:

plugin_manager set_bundle target="dsh-literature-agents" enabled=true

生效后,新会话或下一模型步即可看到 9 个工具、技能与输入区「古籍」开关。

本地开发与卸载

从源码目录安装(将路径换成本机绝对路径):

plugin_manager install_bundle target="<本仓库的绝对路径>"

卸载:

plugin_manager remove_bundle target="dsh-literature-agents"

输入区「古籍」开关

输入框左侧工具行有「古籍」开关(conversation.input.left,id literature-toggle):

  1. 开(品牌色圆点):本对话可调用全部 9 个文献工具,系统提示含专家引导。
  2. 关(灰色圆点):在该会话 Agent 上下文中通过 tools.restrict({deny}) 隐藏 9 个工具,并移除专家引导段;其他对话不受影响。技能仍在目录中,但无工具可调用。

状态按 SessionId 保存在 ~/.dsh/dsh-literature-agents/toggles.json(DSH_HOME 优先),重启后保留;新对话默认开启。切换立即作用于该会话;若某轮正在生成,从下一模型步生效。此为用户专属操作,模型无法自行开关。

配置项

在 profile 的 bundle 配置中可设置:

- id: literature-agents
  name: dsh-literature-agents
  config:
    provider: spawn   # 子代理 provider;默认 spawn,缺失时回退到任一非 fork provider
    maxDepth: 1       # 召唤出的专家最多再委派一层;provider 不支持时自动省略

典型用法(对话侧)

README 未给出固定对话脚本,可按工具职责在开启「古籍」开关后自然提问,例如:

  1. 用 search_scholar_papers 查某主题论文,再对关键条目用 verify_citation 核验 DOI 或题名。
  2. 用 search_classic_texts / get_classic_text 定位并阅读原文,需要今译或英译时调用 translate_classic。
  3. 需要多角度意见时,用 list_literature_experts 查看名册,再 summon_literature_expert 或 run_literature_panel 并行征求评审团意见。

主会话应结合工具返回的数据源行与证据自行汇总,勿把评审团输出当作已去重的终稿。

网络依赖与注意

  • 必需:Crossref、OpenAlex、Wikidata、中文维基文库。
  • 可选:宿主网页搜索(如 dsh-free-search 等),仅作兜底与线索。
  • README 注明本机实测不可达且不参与主链路的源包括 zh.wikipedia.org、ctext.org、Semantic Scholar、Gutendex 等;Wikidata 在共享 IP 上可能出现 403 Too Many Reqs,插件对 403/429 做三次退避重试,仍失败时如实降级并给出网页线索。

插件分类为工作流;GitHub 仓库当前星标为 1。DSH 社区插件目录(如 skillhub.cn)为独立收录站点,与 DeepSeek / 幻方无官方从属关系。

链接

羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

Xiaoye