企业官网建设流程全解析

装好插件之后，真正决定它用得顺不顺的，往往不是工具怎么调，而是配置里几个不起眼的键。dsh-research-report 的 Schemastery Config 一共七个字段：五个要填具体值（路径、上限、截止时间），两个是布尔开关。取值非法时 profile 加载会直接失败。

相对根路径一律按 harness 工作目录（工作区）解析——这是后面很多麻烦的根源。

七个键摆成一张表

装之前对照安装形态，完整插件清单与汉化避坑指南 能帮你确认 profile 命名与安装命令。

五个「填值」的键

一、ledgerRoot：账本目录别乱放

账本是证据快照的家：<ledgerRoot>/objects/<sha256>存对象，旁边是几份 JSONL 日志。默认.research-ledger是隐藏目录，不脏工作区，却很容易被git clean或一次误删带走。相对路径的实际落点取决于 harness 工作目录，换个目录跑就会「找不到账本」；多工作区部署应按 profile 配绝对路径。

二、reportRoot：按主题加时间分版

封存产物落在<reportRoot>/<slug(topic)>/<YYYYMMDD-HHmmss>/，一个主题一个目录、一次封存一个时间戳子目录。它和ledgerRoot一样按相对路径解析，两者命运绑在一起：账本在，报告才有可复算的底气。指到一个会做备份的盘上，比留在工作区省心。

三、maxEvidenceBytes：2 MiB 硬上限

默认2097152字节，超过就拒。典型翻车是把一整本 PDF 或一整个 CSV 丢进去——正确做法是按章节或按表切分，让每份证据都小到能被逐字核对。

四、maxEvidencePerReport：单份报告 200 条

默认200，超了组装直接失败。它逼你做取舍：一份报告到底需要多少条证据？把无关引用剔掉，报告反而更干净。

五、fetchTimeoutMs：单次抓取 20 秒

默认20000毫秒，是单次ctx.web抓取的截止时间，不是整批预算。抓响应慢的跨地域站点容易整批失败。应对：调大它，或先把内容抓成本地文件、再用content喂给evidence_add。

两个开关

enabled默认true，设成false时什么都不挂载——这是排查「插件到底有没有生效」最快的二分法。requireJournalMetadata默认false；只有打开它，DOI 类证据登记才必须带期刊名与出版年份，否则大声报错；它只约束学术 DOI 证据。

四个工具/服务接口

• evidence_add({ origin, content?, title? })：登记证据快照。带content原样存文本；不带则 URL 走ctx.web、工作区路径从磁盘读（读取永不越出工作区），返回 id 与 SHA-256。

• research_report({ topic, title?, sections, claims, evidenceRefs, gather?, depth?, background? })：校验（未登记的主张引用被大声拒绝）、逐条验证、渲染带标记的report.md、写manifest.json、返回封存哈希。

• ledger_query({ claimId? | evidenceId? })：只读查询，读时重新哈希，篡改或缺失的快照被显式报告；不带 id 返回账本摘要。

• ctx.researchReport.assemble(request)：给同级插件的冻结服务接口，由scripts/verify-frozen-contract.mjs逐字节把关。

gather 只跑一轮，绝不自动组装

research_report({ gather: true })只围绕ctx.web跑一轮搜索，返回抓到的候选证据和一份显式缺口清单，然后停住——它不会替你把候选拼成报告，组装仍是你（或上游插件）的活。把它当成「帮你跑一趟腿」，而不是「帮你把报告写完」。

账本为什么可信

账本内容寻址：相同内容只存一次、快照不可变、每次读取重算 SHA-256。所以篡改或删除不会静默通过，而是让绑定主张被判contradicted，ledger_query报出integrity: tampered或missing；结论只追加、不覆盖。想横向对比其它插件的中文资料，可再回看 完整插件清单与汉化避坑指南。

总结

七个键里那五个「填值」的键——两个根目录、两个上限、一个截止时间——基本决定了它在你环境里的行为，配之前先想清楚绝对路径与体量；想对照同类插件的中文清单与安装形态见 完整插件清单与汉化避坑指南。

适合与不适合

适合：需要长期、可归档把研究结论落盘的人；愿意为证据体量做切分取舍的人；要在多 profile 间隔离账本目录的人；希望接口语义稳定、可被同级插件复用的团队。不适合：想一把梭把所有资料丢进去的人——2 MiB 与 200 条是硬上限；指望它自动联网把报告写完的人——gather只跑一轮且不自动组装；把它当通用知识库或向量检索用的人——没有嵌入、没有语义相似度。

标签：dsh-research-report、DeepSeek Harness、配置项、进阶用法、证据账本

本文由 DeepSeek Harness Hub 自动整理，数据来源于插件详情页。