前言¶
在 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):
- 开(品牌色圆点):本对话可调用全部 9 个文献工具,系统提示含专家引导。
- 关(灰色圆点):在该会话 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 未给出固定对话脚本,可按工具职责在开启「古籍」开关后自然提问,例如:
- 用
search_scholar_papers查某主题论文,再对关键条目用verify_citation核验 DOI 或题名。 - 用
search_classic_texts/get_classic_text定位并阅读原文,需要今译或英译时调用translate_classic。 - 需要多角度意见时,用
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 / 幻方无官方从属关系。