装好插件之后真正决定它用得顺不顺的往往不是工具怎么调而是配置里几个不起眼的键。dsh-research-report 的 Schemastery Config 一共七个字段五个要填具体值路径、上限、截止时间两个是布尔开关。取值非法时 profile 加载会直接失败。相对根路径一律按 harness 工作目录工作区解析——这是后面很多麻烦的根源。七个键摆成一张表键默认值你要关心什么enabledtrue总开关设成false时什么都不挂载ledgerRoot.research-ledger证据账本目录objects JSONL 日志reportRootresearch-reports封存报告根目录按主题和时间戳分版本maxEvidenceBytes20971522 MiB单份证据快照 UTF-8 字节数的硬上限maxEvidencePerReport200单份报告可绑定证据条目的硬上限fetchTimeoutMs20000单次ctx.web抓取的截止时间毫秒requireJournalMetadatafalse为 true 时DOI 类证据登记必须带期刊名与出版年装之前对照安装形态完整插件清单与汉化避坑指南 能帮你确认 profile 命名与安装命令。五个「填值」的键一、ledgerRoot账本目录别乱放账本是证据快照的家ledgerRoot/objects/sha256存对象旁边是几份 JSONL 日志。默认.research-ledger是隐藏目录不脏工作区却很容易被git clean或一次误删带走。相对路径的实际落点取决于 harness 工作目录换个目录跑就会「找不到账本」多工作区部署应按 profile 配绝对路径。二、reportRoot按主题加时间分版封存产物落在reportRoot/slug(topic)/YYYYMMDD-HHmmss/一个主题一个目录、一次封存一个时间戳子目录。它和ledgerRoot一样按相对路径解析两者命运绑在一起账本在报告才有可复算的底气。指到一个会做备份的盘上比留在工作区省心。三、maxEvidenceBytes2 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。所以篡改或删除不会静默通过而是让绑定主张被判contradictedledger_query报出integrity: tampered或missing结论只追加、不覆盖。想横向对比其它插件的中文资料可再回看 完整插件清单与汉化避坑指南。总结七个键里那五个「填值」的键——两个根目录、两个上限、一个截止时间——基本决定了它在你环境里的行为配之前先想清楚绝对路径与体量想对照同类插件的中文清单与安装形态见 完整插件清单与汉化避坑指南。适合与不适合适合需要长期、可归档把研究结论落盘的人愿意为证据体量做切分取舍的人要在多 profile 间隔离账本目录的人希望接口语义稳定、可被同级插件复用的团队。不适合想一把梭把所有资料丢进去的人——2 MiB 与 200 条是硬上限指望它自动联网把报告写完的人——gather只跑一轮且不自动组装把它当通用知识库或向量检索用的人——没有嵌入、没有语义相似度。标签dsh-research-report、DeepSeek Harness、配置项、进阶用法、证据账本本文由 DeepSeek Harness Hub 自动整理数据来源于插件详情页。