dsh-research-report 0.4.0 → 0.4.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -1,129 +1,134 @@
1
1
  <div align="center">
2
2
 
3
- # 📑 dsh-research-report
4
- - **1024 store channel**: `npm i -g dsh1024` once, then `dsh1024 plugin --profile web add dsh-research-report` (counts toward the [deepseek1024.com](https://deepseek1024.com) install ranking).
5
- [![Gitee](https://img.shields.io/badge/Gitee-mirror-c71d23?logo=gitee)](https://gitee.com/perrylink/dsh-research-report)
6
- [![dshfind](https://dshfind.com/api/badge/PerryLink/dsh-research-report?metric=downloads)](https://dshfind.com/plugins/PerryLink/dsh-research-report?ref=badge)
7
- [![OpenSSF Scorecard](https://api.securityscorecards.dev/projects/github.com/PerryLink/dsh-research-report/badge)](https://api.securityscorecards.dev/projects/github.com/PerryLink/dsh-research-report)
8
-
9
- **A verifiable research-report engine for DeepSeek Harness.**
10
-
11
- *Every claim is bound to immutable evidence snapshots, verified byte-for-byte, and sealed into a versioned report whose manifest hash anyone can recompute.*
3
+ <picture>
4
+ <source media="(prefers-color-scheme: dark)" srcset="docs/assets/dsh-research-report-hero-zh-dark.webp">
5
+ <img src="docs/assets/dsh-research-report-hero-zh-light.webp" width="100%" alt="dsh-research-report 横幅:封存报告目录的哈希汇封——正文 report.md、账本中的证据哈希、verification.jsonl 与 disconfirmation.jsonl 汇入 manifest.json,封印就是该文件的 SHA-256;下方 dsh-research-verify 可从目录本身重算">
6
+ </picture>
12
7
 
13
- [![License](https://img.shields.io/badge/license-Apache%202.0-blue.svg)](LICENSE)
14
- [![DSH plugin](https://img.shields.io/badge/dsh--plugin-✅-green)](https://github.com/topics/dsh-plugin)
15
- [![dsh-doctor](https://raw.githubusercontent.com/PerryLink/dsh-plugin-doctor/main/badges/PerryLink__dsh-research-report.svg)](https://github.com/PerryLink/dsh-plugin-doctor#verified-徽章)
16
- [![DSH Market](https://raw.githubusercontent.com/2BingLing/dsh-market/master/assets/readme/badge-top-rated.svg)](https://dsh.market/)
17
- [![Node](https://img.shields.io/badge/node-%5E22.19%20%7C%7C%20%3E%3D24-brightgreen.svg)](#)
18
- [![CI](https://img.shields.io/github/actions/workflow/status/PerryLink/dsh-research-report/ci.yml?branch=main&label=CI)](https://github.com/PerryLink/dsh-research-report/actions)
19
- [![Version](https://img.shields.io/github/v/tag/PerryLink/dsh-research-report?label=version)](https://github.com/PerryLink/dsh-research-report/releases)
20
- [![npm version](https://img.shields.io/npm/v/dsh-research-report)](https://www.npmjs.com/package/dsh-research-report)
21
- [![npm downloads](https://img.shields.io/npm/dm/dsh-research-report)](https://www.npmjs.com/package/dsh-research-report)
8
+ # dsh-research-report
22
9
 
23
- [English](README.md) · [简体中文](README-zh.md) · [Español](README-es.md) · [Português](README-pt.md) · [हिन्दी](README-hi.md)
10
+ **交出一份报告,每条结论都能被任何人在自己机器上离线复核——改过任何一个字节,密封哈希就会对不上。**
24
11
 
25
- ```sh
26
- dsh plugin --profile <name> add dsh-research-report
27
- ```
28
-
29
-
30
- </div>
12
+ 面向 DeepSeek Harness 的可核查研究报告引擎:claim 绑定不可变证据快照,数字与引文按字节核对,结果封存为版本化报告目录,封印就是 `manifest.json` 的 SHA-256。
31
13
 
32
- ---
14
+ [安装](#三步上手) · [配置](#配置) · [FAQ](#faq) · [简体中文](README.md) · [English](README.en.md) · [Español](README.es.md) · [Português](README.pt.md) · [हिन्दी](README.hi.md)
33
15
 
34
- **📖 Ecosystem knowledge base** — measured data, not marketing: [plugin development guide · plugin-selection data · maintenance criteria](https://perrylink.github.io/dsh-plugin-guide/).
16
+ [![License](https://img.shields.io/badge/license-Apache--2.0-3366CC?style=flat-square&labelColor=2B3245)](LICENSE)
17
+ [![DSH](https://img.shields.io/badge/DSH-%E2%89%A50.1.6%20%3C0.3.0-4B67B4?style=flat-square&labelColor=2B3245)](#兼容性)
18
+ [![npm](https://img.shields.io/npm/v/dsh-research-report?style=flat-square&labelColor=2B3245&color=CB3837)](https://www.npmjs.com/package/dsh-research-report)
19
+ [![CI](https://img.shields.io/github/actions/workflow/status/PerryLink/dsh-research-report/ci.yml?branch=main&label=CI&style=flat-square&labelColor=2B3245)](https://github.com/PerryLink/dsh-research-report/actions/workflows/ci.yml)
20
+ [![Node](https://img.shields.io/badge/node-%5E22.19%20%7C%7C%20%3E%3D24.9-339933?style=flat-square&labelColor=2B3245)](#兼容性)
35
21
 
36
- <!-- star-cta -->
37
- ## Install & uninstall
22
+ [![Stars](https://img.shields.io/github/stars/PerryLink/dsh-research-report?style=flat-square&labelColor=2B3245)](https://github.com/PerryLink/dsh-research-report/stargazers)
23
+ [![npm downloads](https://img.shields.io/npm/dm/dsh-research-report?style=flat-square&labelColor=2B3245&color=CB3837)](https://www.npmjs.com/package/dsh-research-report)
24
+ [![dshfind](https://dshfind.com/api/badge/PerryLink/dsh-research-report?metric=downloads)](https://dshfind.com/plugins/PerryLink/dsh-research-report?ref=badge)
25
+ [![OpenSSF Scorecard](https://api.securityscorecards.dev/projects/github.com/PerryLink/dsh-research-report/badge)](https://securityscorecards.dev/viewer/?uri=github.com/PerryLink/dsh-research-report)
26
+ [![DSH Market](https://img.shields.io/badge/DSH_Market-listed-4B67B4?style=flat-square&labelColor=2B3245)](https://dsh.market/)
27
+ [![Gitee](https://img.shields.io/badge/Gitee-mirror-C71D23?style=flat-square&labelColor=2B3245&logo=gitee)](https://gitee.com/perrylink/dsh-research-report)
38
28
 
39
29
  ```sh
40
- dsh plugin --profile demo add dsh-research-report # install
41
- dsh plugin --profile demo remove dsh-research-report # uninstall
30
+ dsh plugin --profile <name> add dsh-research-report
42
31
  ```
43
32
 
44
- Verify the row mounts: `dsh --profile demo --dump-config | grep dsh-research-report`.
33
+ </div>
45
34
 
46
- ## ⭐ 如果它帮到了你
35
+ <sub>社区插件,与 DeepSeek 官方无关。唯一仓库:<https://github.com/PerryLink/dsh-research-report>(Gitee 为镜像)。</sub>
47
36
 
48
- 这个插件是 [DSH 插件家族](https://github.com/PerryLink)的一员(95 个,全部 Apache-2.0)。如果你在用,**给个 star** —— 它不会解锁任何功能,但会让下一个人在搜索里更容易找到它。
37
+ ## 它是什么
49
38
 
50
- *English:* part of a 95 plugin family for DeepSeek Harness. If it is useful, **a star helps the next person find it** — nothing is gated behind it.
39
+ 给模型一个主题和一组来源,`dsh-research-report` 把每条结论(claim)绑定到不可变的证据快照、逐字节核对数字与引文,再把结果封存成一份可独立复核的版本化报告。报告目录里有 `report.md`、`manifest.json` 和审计日志;封印哈希就是 `manifest.json` 的 SHA-256,拿到目录的人用 `dsh-research-verify` 就能离线重算,不需要挂载插件。它刻意不做深研循环:检索与抓取走 `ctx.web`,长任务走 `ctx.jobs`,规划与综合留给模型或上游插件。
51
40
 
41
+ <picture>
42
+ <source media="(prefers-color-scheme: dark)" srcset="docs/assets/dsh-research-report-flow-v5-dark.svg">
43
+ <img src="docs/assets/dsh-research-report-flow-v5-light.svg" width="100%" alt="dsh-research-report 结构图:左栏是内容寻址证据账本(抓取 → sha256 → objects 快照 + 四本 JSONL 日志),中栏是逐 claim 判定梳(完整性 → 绑定 → 字面定位,五种结论首中即止并回写账本),右栏是封存报告目录(正文与两本审计日志折进 manifest.json,封印为其 SHA-256);底部是墙外离线复核 dsh-research-verify">
44
+ </picture>
52
45
 
53
- ## What is dsh-research-report?
46
+ ## 三步上手
54
47
 
55
- A verifiable research-report engine for DeepSeek Harness.
48
+ 1. **安装**(三选一):
56
49
 
57
- Every claim is bound to immutable evidence snapshots, verified byte-for-byte, and sealed into a versioned report whose manifest hash anyone can recompute.
50
+ ```sh
51
+ # npm 通道(已发布版本)
52
+ dsh plugin --profile web add dsh-research-report
53
+ # git 通道(最新 main;等价于 git+https://github.com/PerryLink/dsh-research-report.git)
54
+ dsh plugin --profile web add github:PerryLink/dsh-research-report
55
+ # tarball 通道:本仓库 pnpm pack 后
56
+ dsh plugin --profile web add ./dsh-research-report-<version>.tgz
57
+ ```
58
58
 
59
- ![Workflow diagram for dsh-research-report: question → sealed sources → report.](docs/assets/dsh-research-report-flow.svg)
59
+ 两条在线通道都会把 bundle 行(见 [`cordis.patch.yml`](cordis.patch.yml))装入 profile 的 `dsh.profile.bundles` 层栈,**重启生效**。
60
60
 
61
- *Workflow overview: question → sealed sources → report. The examples below use the real command surface.*
61
+ 2. **最小配置**(默认即可用;相对路径相对 harness 工作目录解析):
62
62
 
63
+ ```yaml
64
+ - insert:
65
+ - id: dsh-research-report
66
+ name: dsh-research-report
67
+ config:
68
+ ledgerRoot: .research-ledger
69
+ reportRoot: research-reports
70
+ ```
63
71
 
72
+ 3. **验证已生效**:
64
73
 
65
- ## Compatibility
74
+ ```sh
75
+ dsh --profile web --dump-config | grep dsh-research-report
76
+ ```
66
77
 
67
- - DeepSeek Harness `dsh-v0.2.1-alpha.1` (verified 2026-09-25). npm dev/test line `0.1.7-rc.2`; peers `>=0.1.6-0 <0.2.0 || >=0.1.7-0 <0.2.0`. The compat matrix pins all four declared peer lines. On this line `Session.append`'s third parameter is a `SurfaceIntent` for surface-eligible types only, so `research-report/*` events still do not land in the session log: the ledger journals are the durable source of truth and the audit mirror activates only once a host knows the vocabulary (the regression lock in `test/events-gate.spec.ts` pins that).
68
- 0.1.5-alpha.1 (adapted 2026-09-09): the session envelope keeps its ignorable field for stored-log read compatibility only - Session.append still cannot stamp it, so audit-gate behavior is unchanged. Verified 2026-09-11 against the published 0.1.5-rc.2 types (full local gate chain); the compat workflow pins both declared peer lines.
69
- - Node `^22.19.0 || >=24.0.0`, ESM only (`"type": "module"`).
70
- - Peer dependencies: `@deepseek-ai/cordis ^4.0.2`, `@deepseek-ai/schemastery ^3.18.2`, and `@deepseek-ai/dsh-session`, `@deepseek-ai/dsh-tools`, `@deepseek-ai/dsh-system-prompt`, `@deepseek-ai/dsh-web`, `@deepseek-ai/dsh-jobs` at `>=0.1.6-0 <0.2.0 || >=0.1.7-0 <0.2.0`.
71
- - Optional siblings (never required): `ctx.web` providers for URL capture/gather, `ctx.jobs` for background assembly, `ctx.dataQuality` (dsh-data-quality) for dataset citation cross-checks.
78
+ 然后在会话里跑一遍最小闭环,再用 CLI 复核封印:
72
79
 
73
- ## What you get
80
+ ```text
81
+ evidence_add({ origin: "docs/market.md", title: "市场快照" }) # → ev-1a2b3c4d5e6f
82
+ research_report({ topic: "...", sections: [...], claims: [...], evidenceRefs: ["ev-1a2b…"] })
83
+ ledger_query({ claimId: "c1" }) # 绑定关系 + 核查结论
84
+ ```
74
85
 
75
- - **Evidence ledger** — a content-addressed snapshot store (`<ledgerRoot>/objects/<sha256>` + JSONL journals). The same content is stored exactly once; snapshots are immutable; every read recomputes the hash, so tampering or deletion is detected instead of trusted.
76
- - **Claim ↔ evidence binding** — claims register with the evidence ids they rely on; the ledger keeps the binding and every verification verdict (latest wins).
77
- - **Byte-level verification** — every number and quoted span in a claim must be locatable verbatim in the bound snapshots. No bound evidence, or no checkable literal, marks the claim `unverified`; bound evidence that cannot confirm or deny the claimed literals marks it `insufficient`; a label whose snapshot value differs (the claimed value absent) marks it `disproven`; tampered/missing snapshots mark it `contradicted`. No semantics, no embeddings — auditable byte checks.
78
- - **Optional numeric bridge** — when a claim cites a structured workspace dataset (CSV/JSON) and `dsh-data-quality` is mounted, citations are cross-checked with tolerances through its frozen `verifyCitations` contract; a dataset mismatch disproves the claim.
79
- - **DOI evidence (zero network)** — DOI origins are validated deterministically (`10.xxxx/xxxx` structure, a prefix whitelist, and a DOI character set); invalid DOIs fail loud. Optional journal/year metadata is accepted, and `requireJournalMetadata` gates academic DOI evidence only when enabled.
80
- - **Versioned sealed reports** — `<reportRoot>/<slug(topic)>/<YYYYMMDD-HHmmss>/report.md` + `manifest.json` + `verification.jsonl` + `disconfirmation.jsonl`; the seal hash is the SHA-256 of the manifest, which itself carries the report hash, every evidence hash, and the hash of each audit journal.
81
- - **Pre-delivery re-audit & seal interception** — before sealing, every bound claim is re-verified offline and journaled to `verification.jsonl`; verdict drift, tampered/missing bound evidence, or a journal serialization failure blocks the seal (fail loud, no tunable).
82
- - **Falsification ledger** — every contradicted or disproven claim is recorded in `disconfirmation.jsonl` (claim + evidence references + reason) and listed in the report's `falsification log` appendix.
83
- - **Negative knowledge** — a disproven claim is remembered by its content hash (`disproofs.jsonl`); the same text re-reported against unchanged evidence is forced back to `disproven` and only re-verifies once the evidence changes.
84
- - **Read-only verifier loop** — after sealing, a deterministic `verifySealedReport` fallback (zero network, zero model) recomputes the seal and audit hashes and re-checks every claim, writing the machine check to `verifier-note.md`; when `ctx.jobs` is mounted a read-only verifier job is also spawned (the model review is an enhancement, never a replacement).
85
- - **Standalone verifier CLI** — `dsh-research-verify --report <dir> [--seal <sha256>] [--ledger <dir>] [--format json|sarif]` recomputes the seal hash + per-claim re-checks from the sealed directory alone and prints a JSON envelope or a SARIF 2.1.0 document (see [Verifier CLI](#verifier-cli)).
86
- - **Session-anchored evidence** — `evidence_add` accepts an optional `sessionRef` (`sessionId` + `eventRange`, validated loud); the anchor is stored, rendered in Appendix B, and registered in the manifest and `verification.jsonl`. Session-anchored evidence verifies honestly as `unverified` (`session-anchored evidence requires a manual check against the session log`).
87
- - **Honest gaps** — unverified, insufficient, contradicted, and disproven claims keep a visible `[未核实]` / `[证据不足]` / `[与证据矛盾]` / `[已证伪]` marker in the report body and are listed in Appendix A. Nothing is silently passed.
88
- - **No deep-research loop** — retrieval orchestration is deliberately reused: `ctx.web` for search/fetch, `ctx.jobs` for long runs. Planning and synthesis stay with the model (or an upstream plugin).
86
+ ```sh
87
+ dsh-research-verify --report research-reports/<topic>/<YYYYMMDD-HHmmss>
88
+ ```
89
89
 
90
- ## Quick start
90
+ **卸载**:`dsh plugin --profile web remove dsh-research-report`(或从 profile patch 删掉该行)。
91
91
 
92
- ```sh
93
- dsh plugin --profile web add github:PerryLink/dsh-research-report
94
- ```
92
+ <details>
93
+ <summary>从 DSH Desktop 市场安装</summary>
95
94
 
96
- ### git channel
95
+ 所有 PerryLink 插件均可在 DSH Desktop 内置市场中浏览:**市场 → 来源 → 添加来源 → 粘贴** `https://perrylink-dsh-catalog.perrylink.workers.dev/catalog-source.json` **→ 选中**。安装仍需通过市场的 npm 身份校验与你的确认。
97
96
 
98
- ```sh
99
- # From a scratch profile (pins the commit; runs the self-contained `prepare` build)
100
- dsh plugin --profile demo add "github:YOUR_ORG/dsh-research-report#<sha>"
101
- # The profile's pnpm-workspace.yaml gains an allowBuilds entry for dsh-research-report on first add.
102
- ```
97
+ </details>
103
98
 
104
- ### npm channel
99
+ ## 核心能力
105
100
 
106
- ```sh
107
- dsh plugin --profile demo add dsh-research-report
108
- ```
101
+ `dsh-research-report` 的可信度来自三件事:证据不可变、核查可重算、缺口不隐藏。
109
102
 
110
- Both channels install the bundle row (see `cordis.patch.yml`) into the profile's `dsh.profile.bundles` stack and take effect on restart.
103
+ - **证据账本**——内容寻址快照存储(`<ledgerRoot>/objects/<sha256>` + JSONL 日志)。同一内容只存一份;快照不可变;每次读取都重算哈希——篡改或删除会被发现,而不是被信任。
104
+ - **claim ↔ 证据绑定**——claim 登记时声明其依赖的证据 id;账本保存绑定关系与每一次核查结论(最新为准)。
105
+ - **字节级核查**——claim 文本中的每个数字与引文子串都必须能在其绑定快照中字面定位。无绑定证据或无核查字面量 → `unverified`;证据存在但不足以证实或证伪声称字面量 → `insufficient`;标签在快照中对应不同数值(且声称值不存在)→ `disproven`;快照被篡改/缺失 → `contradicted`。不做语义理解、不做向量相似——只做可审计的字节核对。
106
+ - **可选数字核查桥**——当 claim 引用 workspace 内结构化数据集(CSV/JSON)且 `dsh-data-quality` 已挂载时,经其冻结的 `verifyCitations` 契约做容差核对;数据集不一致即证伪该 claim。
107
+ - **DOI 证据(零网络)**——DOI 源做确定性语法校验(`10.xxxx/xxxx` 结构 + 前缀白名单 + DOI 字符集);非法 DOI 响亮失败。可选期刊/年份元数据被接受;`requireJournalMetadata` 仅在启用时门禁学术 DOI 证据。
108
+ - **版本化封存报告**——`<reportRoot>/<slug(topic)>/<YYYYMMDD-HHmmss>/report.md` + `manifest.json` + `verification.jsonl` + `disconfirmation.jsonl`;封印哈希 = manifest 的 SHA-256,manifest 内含报告哈希、全部证据哈希与各审计日志哈希。
109
+ - **交付前重审计与封存拦截**——封存前对每条绑定证据的 claim 离线重跑一次核查并写入 `verification.jsonl`;verdict drift、绑定证据被篡改/缺失、或审计日志序列化失败都会拦截封存(响亮失败,无 tunable)。
110
+ - **证伪账本**——每条被证伪(disproven)或矛盾(contradicted)的 claim 记录进 `disconfirmation.jsonl`(claim + 证据引用 + 原因),并在报告的「证伪记录」附录列明。
111
+ - **负知识**——被证伪的 claim 按其内容哈希记入 `disproofs.jsonl`;同一文本在证据未变时被复报会被强制置回 `disproven`,证据变化后才允许重新核验。
112
+ - **只读 verifier 回环**——封存后先跑确定性兜底 `verifySealedReport`(零网络零模型):重算封印与审计哈希、逐 claim 复核,把 machine-check 段落写入 `verifier-note.md`;挂载 `ctx.jobs` 时再派生只读 verifier job(模型复核为增强,绝不替代)。
113
+ - **会话锚定证据**——`evidence_add` 支持可选 `sessionRef`(`sessionId` + `eventRange`,格式校验响亮失败);锚点入账并在附录 B、manifest、`verification.jsonl` 登记。会话锚定证据诚实判 `unverified`(`会话锚定证据需人工回查会话日志`)。
114
+ - **诚实缺口**——未核实/证据不足/有矛盾/已证伪的 claim 在正文中保留醒目标记 `[未核实]` / `[证据不足]` / `[与证据矛盾]` / `[已证伪]`,并在附录 A 列明。绝不静默通过。
115
+ - **不做深研循环**——检索编排刻意复用官方底座:搜索/抓取走 `ctx.web`,长任务走 `ctx.jobs`。规划与综合交给模型(或上游插件)。
111
116
 
112
- Then, in a session:
117
+ ### 工具面
113
118
 
114
- ```
115
- evidence_add({ origin: "docs/market.md", title: "Market snapshot" }) # → ev-1a2b3c4d5e6f
116
- research_report({ topic: "示例行业概览", sections: [...], claims: [...], evidenceRefs: ["ev-1a2b…"] })
117
- ledger_query({ claimId: "c1" }) # bindings + verdict
118
- ```
119
+ - **`evidence_add({ origin, content?, title? })`**——登记一条证据。给 `content` 则按原文存储;不给时 URL 源经 `ctx.web` 抓取、workspace 相对路径从磁盘读取(读取绝不逃逸 workspace)。返回证据 id 与 SHA-256 哈希。
120
+ - **`research_report({ topic, title?, sections, claims, evidenceRefs, gather?, depth?, background? })`**——组装并封存报告:校验(claim 引用不全响亮拒绝)→ 逐条核查 → 渲染带醒目标记的 `report.md` → 写 `manifest.json` → 返回封印哈希。`gather: true` 先经 `ctx.web` 做一轮检索,返回已捕获候选证据与显式缺口清单——绝不自动成稿。`background: true` 经 `ctx.jobs` 返回 `{ kind: 'background', jobId }`。
121
+ - **`research_trail({ limit?, format? })`**——只读的 claim → 证据 → 结论轨迹:把已注册 claim 与证据、已存结论拼起来,把没有可解析证据的 claim 标为 **unbound**,列出悬空 evidence id,输出可交给审稿人的 Markdown(以及结构化行)。不新增存储、不改写结论。
122
+ - **`ledger_query({ claimId? | evidenceId? })`**——只读查询绑定关系与核查结论;证据读取时重算哈希,篡改/丢失会显式报告。不带 id 时返回账本摘要。
123
+ - **`ctx.researchReport.assemble(request)`**——面向兄弟插件的冻结服务表面(见 `src/service.ts`;由 [`scripts/verify-frozen-contract.mjs`](scripts/verify-frozen-contract.mjs) 逐字节门禁)。
119
124
 
120
- ### Examples
125
+ ### 示例
121
126
 
122
- These are the plugin's real entry points; install once, then call one.
127
+ 以下为插件真实入口;安装后调用一个即可。
123
128
 
124
- #### Detailed example
129
+ **详细示例**
125
130
 
126
- **Command**
131
+ **命令**
127
132
 
128
133
  ~~~sh
129
134
  research_report({
@@ -134,7 +139,7 @@ research_report({
134
139
  })
135
140
  ~~~
136
141
 
137
- **Output**
142
+ **输出**
138
143
 
139
144
  ~~~text
140
145
  report sealed: /tmp/rr-test-4U2mlF/reports/示例行业概览/20261019-124904
@@ -144,15 +149,15 @@ claims: 1 verified / 0 unverified / 0 contradicted / 0 insufficient / 0 disprove
144
149
 
145
150
  *Observed from `README.md:112-118,150; test/index.spec.ts:166-177; src/tools/research-report.ts:170-175`*
146
151
 
147
- #### Failure branch
152
+ **失败分支**
148
153
 
149
- **Input**
154
+ **输入**
150
155
 
151
156
  ~~~text
152
157
  {"topic":"probe","sections":[{"heading":"Growth","paragraphs":[{"text":"Growth was 42%.","claimIds":["c1"]}]}],"claims":[{"id":"c1","text":"Growth was 42%.","evidenceIds":[]}]}
153
158
  ~~~
154
159
 
155
- **Output**
160
+ **输出**
156
161
 
157
162
  ~~~text
158
163
  edge-case (no throw): isError=false; kind=sealed; verdicts[0]={"claimId":"c1","status":"unverified","note":"claim binds no evidence snapshot"}; counts={"verified":0,"unverified":1,"contradicted":0,"insufficient":0,"disproven":0}; evidenceCount=0; report.md marker=Growth was 42%. [未核实]
@@ -160,70 +165,158 @@ edge-case (no throw): isError=false; kind=sealed; verdicts[0]={"claimId":"c1","s
160
165
 
161
166
  *Observed from `plugins/dsh-research-report/src/verify.ts:173-175 (unverified verdict); plugins/dsh-research-report/src/assemble.ts:209-220 (visible mark); plugins/dsh-research-report/README.md:87 (honest gaps); exercised through plugins/dsh-research-report/test/harness.ts`*
162
167
 
163
- #### Brief examples
168
+ **简短示例**:`research_report` · `ledger_query` · `research_trail`
169
+
170
+ ### dsh-research-verify CLI
171
+
172
+ 独立二进制(打包为 `lib/cli.js`,零 `@deepseek-ai` 导入)无需挂载插件即可审计任意密封报告目录:
173
+
174
+ ```sh
175
+ dsh-research-verify --report <dir> [--seal <sha256>] [--ledger <dir>] [--format json|sarif]
176
+ ```
177
+
178
+ - `--report <dir>`:密封报告目录(`manifest.json` + `report.md` + 审计日志)。
179
+ - `--seal <sha256>`:期望的 seal 哈希,用于与重算的 manifest 哈希比对;缺省则只报告重算值、不比对。
180
+ - `--ledger <dir>`:证据账本根目录(`objects/<sha256>` + `index.jsonl`),用于逐 claim 字节级复检;缺省则如实跳过 claim 复检。
181
+ - `--format`:`json`(默认)或 `sarif`(SARIF 2.1.0)。
182
+
183
+ 它重算 seal 哈希(`manifest.json` 的 SHA-256)、`report.md` 哈希与审计日志哈希,逐 claim 重跑字节级 + 完整性检查,任一已执行检查失败则以非零码退出。`verifySealedReport` / `buildVerificationReport` / `renderSarif` / `renderVerificationJson` 亦从包导出供库调用。
164
184
 
165
- - `research_report`
166
- - `ledger_query`
167
- - `research_trail`
185
+ ## 配置
168
186
 
169
- ## Configuration
187
+ 全部可调项都是 Schemastery `Config` 字段;非法值在加载期响亮失败。相对路径根目录相对 harness 工作目录(workspace)解析。`cordis.patch.yml` 逐键内联注释。
170
188
 
171
- All tunables are Schemastery `Config` fields; invalid values fail the profile load loudly. Relative roots resolve against the harness working directory (the workspace).
189
+ 最常用键:
172
190
 
173
- | Key | Default | Description |
191
+ | 键 | 默认值 | 含义 |
174
192
  | --- | --- | --- |
175
- | `enabled` | `true` | Master switch; `false` mounts nothing. |
176
- | `ledgerRoot` | `.research-ledger` | Evidence-ledger directory (objects + JSONL journals). |
177
- | `reportRoot` | `research-reports` | Sealed-report root (versioned per topic and timestamp). |
178
- | `workspaceRoot` | *(host session working directory)* | Root for workspace-path evidence; defaults to the session working directory, then the harness cwd. |
179
- | `maxEvidenceBytes` | `2097152` | Hard cap on one evidence snapshot's UTF-8 bytes. |
180
- | `maxEvidencePerReport` | `200` | Hard cap on evidence items bound into one report. |
181
- | `fetchTimeoutMs` | `20000` | Deadline (ms) for one `ctx.web` fetch during capture. |
182
- | `requireJournalMetadata` | `false` | When true, DOI-typed evidence must carry a journal name and publication year at registration (fails loud otherwise). |
193
+ | `enabled` | `true` | 总开关;`false` 时什么都不挂载。 |
194
+ | `ledgerRoot` | `.research-ledger` | 证据账本目录(对象 + JSONL 日志)。 |
195
+ | `reportRoot` | `research-reports` | 封存报告根目录(按主题 + 时间戳版本化)。 |
196
+ | `workspaceRoot` | *(宿主会话工作目录)* | 路径证据的工作区根;默认取会话工作目录,其次取 harness cwd。 |
197
+ | `maxEvidenceBytes` | `2097152` | 单条证据快照的 UTF-8 字节硬上限。 |
198
+ | `maxEvidencePerReport` | `200` | 单份报告可绑定证据条数硬上限。 |
183
199
 
184
- ## Tools & surfaces
200
+ <details>
201
+ <summary>完整配置表(8 个键)</summary>
185
202
 
186
- - **`evidence_add({ origin, content?, title? })`** — register one evidence snapshot. With `content` the text is stored verbatim; without it a URL origin is fetched through `ctx.web` and a workspace-relative path is read from disk (reads never escape the workspace). Returns the evidence id and SHA-256 hash.
187
- - **`research_report({ topic, title?, sections, claims, evidenceRefs, gather?, depth?, background? })`** — assemble and seal a report: validate (unregistered claim references are rejected loudly), verify every claim, render `report.md` with visible markers, write `manifest.json`, and return the seal hash. `gather: true` runs ONE search round over `ctx.web` and returns captured candidate evidence plus an explicit gap list — it never auto-assembles. `background: true` returns `{ kind: 'background', jobId }` over `ctx.jobs`.
188
- - **`research_trail({ limit?, format? })`** — read-only claim → evidence → verdict trail: joins registered claims with their evidence and stored verdicts, marks claims with no resolvable evidence as **unbound**, lists dangling evidence ids, and returns Markdown for a reviewer (plus the structured rows). It adds no storage and never changes a verdict.
189
- - **`ledger_query({ claimId? | evidenceId? })`** — read-only binding/verdict queries; evidence is re-hashed on read so a tampered or missing snapshot is reported explicitly. With no id, returns a ledger summary.
190
- - **`ctx.researchReport.assemble(request)`** — the frozen service surface for sibling plugins (see `src/service.ts`; gated byte-for-byte by `scripts/verify-frozen-contract.mjs`).
203
+ | 键 | 默认值 | 含义 |
204
+ | --- | --- | --- |
205
+ | `enabled` | `true` | 总开关;`false` 时什么都不挂载。 |
206
+ | `ledgerRoot` | `.research-ledger` | 证据账本目录(对象 + JSONL 日志)。 |
207
+ | `reportRoot` | `research-reports` | 封存报告根目录(按主题 + 时间戳版本化)。 |
208
+ | `workspaceRoot` | *(宿主会话工作目录)* | 路径证据的工作区根;默认取会话工作目录,其次取 harness cwd。 |
209
+ | `maxEvidenceBytes` | `2097152` | 单条证据快照的 UTF-8 字节硬上限。 |
210
+ | `maxEvidencePerReport` | `200` | 单份报告可绑定证据条数硬上限。 |
211
+ | `fetchTimeoutMs` | `20000` | 抓取时单次 `ctx.web` fetch 的超时(毫秒)。 |
212
+ | `requireJournalMetadata` | `false` | 为 `true` 时,DOI 类证据登记必须带期刊名与出版年份(否则响亮失败)。 |
191
213
 
192
- ## Permissions & data
214
+ </details>
193
215
 
194
- `dsh-research-report` consumes only public seams: `ctx.tools`, `ctx.systemPrompt`, and optionally `ctx.web` / `ctx.jobs` / `ctx.dataQuality` (looked up at call time, never injected). It writes only inside the configured ledger and report roots (both default to workspace-local directories), reads workspace files only inside the workspace, and reaches the network exclusively through the harness web seam — never a direct `fetch`. Evidence snapshots are immutable and content-addressed; claim registrations are immutable; verdicts are append-only.
216
+ profile patch 覆盖示例:
195
217
 
196
- ## Security boundaries
218
+ ```yaml
219
+ - insert:
220
+ - id: dsh-research-report
221
+ name: dsh-research-report
222
+ config:
223
+ reportRoot: research-reports/acme
224
+ maxEvidencePerReport: 100
225
+ requireJournalMetadata: true
226
+ ```
197
227
 
198
- - **Tamper-evidence by construction** — every snapshot read recomputes SHA-256 against the index; a mismatch verifies the bound claims `contradicted` and `ledger_query` reports `integrity: tampered`/`missing`.
199
- - **Workspace confinement** — local evidence reads resolve against the workspace root and refuse escapes (both sides are `path.resolve`d before comparison).
200
- - **Fail-loud configuration** — invalid bounds throw at mount; unregistered claim references, unknown evidence ids, and id/content conflicts throw at assemble.
201
- - **No credential handling, no hidden network** — URL capture rides `ctx.web` (provider selection, error taxonomy, and any SSRF policy stay with the deployment's web providers).
202
- - **Reversible registrations** — every contribution goes through `ctx.effect()` / `register()`, so uninstall and hot reload are clean.
228
+ ## FAQ
203
229
 
204
- ## Known limitations
230
+ <details>
231
+ <summary>账本和报告到底写在哪?删掉会怎样?</summary>
205
232
 
206
- - **Byte-level, not semantic** — the built-in check locates number/quote literals verbatim; paraphrased claims without a checkable literal verify as `unverified`, and a true claim whose number is absent while its label appears with a different value reads `contradicted`. This is a deliberate v1 choice (auditable beats clever).
207
- - **Session events are adaptive** — the plugin declares typed `research-report/evidence`, `research-report/verify`, and `research-report/seal` session events, but the 0.1.5-alpha.1 `Session.append` still exposes no `ignorable` option and no plugin event-registration surface, so appends activate only when the host build knows the types (otherwise the persistence layer would refuse the log on restore). The ledger journals are always the durable source of truth.
208
- - **Default profiles mount no fetch provider** — the shipped `dsh-base` mounts search only, so URL capture fails loud (`WEB_UNAVAILABLE`/`WEB_PROVIDER_UNAVAILABLE`) until a fetch provider is configured; search-based `gather` lists uncaptured sources in the gap list.
209
- - **Single-workspace scope** — ledger and report roots resolve against the harness working directory at mount; multi-workspace deployments should configure absolute roots per profile.
233
+ 两者都在配置的根目录内:`ledgerRoot`(默认 `.research-ledger`)与 `reportRoot`(默认 `research-reports`),相对路径相对 harness 工作目录解析。快照按内容寻址且不可变,同一内容只存一份;删除或改写对象后,下一次读取重算哈希就会失败,绑定它的 claim 判 `contradicted`,`ledger_query` 报告 `integrity: missing`/`tampered`——不会悄悄当没事发生。
210
234
 
211
- ## Verifier CLI
235
+ </details>
212
236
 
213
- The standalone `dsh-research-verify` binary (bundled as `lib/cli.js`, zero `@deepseek-ai` imports) audits any sealed report directory without mounting the plugin:
237
+ <details>
238
+ <summary>没有配置 fetch provider 时会怎样?会静默降级吗?</summary>
214
239
 
215
- ```sh
216
- dsh-research-verify --report <dir> [--seal <sha256>] [--ledger <dir>] [--format json|sarif]
217
- ```
240
+ 不会静默。官方 `dsh-base` 只挂搜索,配置 fetch provider 之前 URL 抓取会响亮失败(`WEB_UNAVAILABLE`/`WEB_PROVIDER_UNAVAILABLE`);基于搜索的 `gather` 会把未捕获的来源列进缺口清单,绝不编造证据、绝不自动成稿。
241
+
242
+ </details>
243
+
244
+ <details>
245
+ <summary>和 dsh-data-quality 会冲突吗?</summary>
246
+
247
+ 不冲突。`ctx.dataQuality` 是可选的,只在调用时经 `ctx.get` 判空使用,从不写入 `inject`;存在时按它冻结的 `verifyCitations` 契约做数据集引文核对,不存在时该分支如实跳过。本插件本身不注册任何 waterfall 监听器。
218
248
 
219
- - `--report <dir>` — the sealed report directory (`manifest.json` + `report.md` + the audit journals).
220
- - `--seal <sha256>` — the expected seal hash to compare the recomputed manifest hash against. Omitted = the recomputed hash is reported without comparison.
221
- - `--ledger <dir>` — the evidence ledger root (`objects/<sha256>` + `index.jsonl`) enabling per-claim byte-level re-checks. Omitted = claim re-checks are skipped honestly.
222
- - `--format` — `json` (default) or `sarif` (SARIF 2.1.0).
249
+ </details>
250
+
251
+ <details>
252
+ <summary>性能开销多大?</summary>
223
253
 
224
- It recomputes the seal hash (SHA-256 of `manifest.json`), the `report.md` hash, and the audit-journal hashes, re-runs the byte-level + integrity check for every claim, and exits non-zero when any performed check fails. The same `verifySealedReport` / `buildVerificationReport` / `renderSarif` / `renderVerificationJson` functions are exported from the package for library use.
254
+ 核查是纯字节操作:零网络、零模型调用,代价随 claim 中的数字/引文字面量与绑定快照大小线性增长。封存前的重审计同样是确定性的重复核对。唯一的外部等待是证据抓取,受 `fetchTimeoutMs`(默认 20000 ms)约束;长报告可走 `background: true` 交给 `ctx.jobs`。
255
+
256
+ </details>
225
257
 
226
- ## Development
258
+ <details>
259
+ <summary>为什么我的转述结论被判 unverified?</summary>
260
+
261
+ 这是字节级设计的必然结果:内置核查只定位数字与引文字面量,不能判断改写前后的语义等价。见「已知限制」第一条——可审计优先于聪明。
262
+
263
+ </details>
264
+
265
+ ## 安全边界
266
+
267
+ - **构造级防篡改**——每次快照读取都对照索引重算 SHA-256;不匹配时绑定 claim 核查为 `contradicted`,`ledger_query` 报告 `integrity: tampered`/`missing`。
268
+ - **workspace 限制**——本地证据读取相对 workspace 根解析并拒绝逃逸(比较前两侧都经 `path.resolve`)。
269
+ - **配置响亮失败**——非法边界在挂载期抛错;claim 引用不全、未知证据 id、id/内容冲突在组装期抛错。
270
+ - **不碰凭据、无隐藏网络**——URL 抓取走 `ctx.web`(provider 选择、错误分类、SSRF 策略都留在部署方的 web provider)。
271
+ - **注册可逆**——所有贡献经 `ctx.effect()` / `register()`,卸载与热重载干净。
272
+
273
+ ## 权限与数据
274
+
275
+ `dsh-research-report` 只消费公开 seam:`ctx.tools`、`ctx.systemPrompt`,以及可选的 `ctx.web` / `ctx.jobs` / `ctx.dataQuality`(调用时经 `ctx.get` 判空使用,绝不写入 inject)。写入只发生在配置的账本与报告根目录内(默认都是 workspace 本地目录);本地文件读取不越出 workspace;网络访问只经 harness web seam——绝不直接 `fetch`。证据快照不可变且内容寻址;claim 登记不可变;核查结论只追加。
276
+
277
+ - **manifest 声明的权限**:`fs:workspace-write`、`network:ctx-web-only`、`session:read`、`session:write`、`native-code:none`(见 `package.json` 的 `dshWorkshop` 段)。
278
+ - **会话事件**:`research-report/evidence`、`research-report/verify`、`research-report/seal` 是自适应镜像;宿主认识该词表时才落盘,否则账本日志单独承担持久真相(见「已知限制」)。
279
+
280
+ ## 已知限制
281
+
282
+ - **字节级而非语义级**——内置核查只做数字/引文字面定位;没有可核查字面量的转述性 claim 判 `unverified`;声称值缺失而标签对应其他数值时判 `contradicted`。这是 v1 的刻意选择(可审计优先于聪明)。
283
+ - **会话事件自适应**——插件声明了类型化的 `research-report/evidence`、`research-report/verify`、`research-report/seal` 会话事件,但 0.1.5-alpha.1 的 `Session.append` 仍不提供 `ignorable` 选项、也没有插件事件注册面,所以只有宿主 build 认识这些类型时才真正落盘(否则持久化层会在恢复时拒绝该日志)。账本日志始终是权威的持久事实源。
284
+ - **默认 profile 不挂载 fetch provider**——官方 `dsh-base` 只挂搜索,所以配置 fetch provider 之前 URL 抓取会响亮失败(`WEB_UNAVAILABLE`/`WEB_PROVIDER_UNAVAILABLE`);基于搜索的 `gather` 会把未捕获的来源列入缺口清单。
285
+ - **单 workspace 作用域**——账本与报告根目录在挂载时相对 harness 工作目录解析;多 workspace 部署应在各 profile 配置绝对路径。
286
+
287
+ ## 与其他 DSH 插件的互操作性
288
+
289
+ 本插件在结构上不争夺其他插件的资源:
290
+
291
+ - **唯一服务键 `ctx.researchReport`**——由 `src/service.ts` 的 Service Definition 提供,不注册第二个服务键。
292
+ - **不注册 waterfall 监听器**——本插件没有 `ctx.on()` 监听器,因而不参与任何顺序敏感事件链;若未来新增,放行分支必须调用 `next()`。
293
+ - **不注册 HTTP 路由与客户端面**——没有 `webServer` 前缀、没有客户端 slot;它是纯 host 插件(仓库无 `client/`)。
294
+ - **patch 层只 insert 自己**——bundle patch 只插入 `dsh-research-report` 一行,不覆写内置行的 `config`。
295
+ - **可选协同按需取用**——`ctx.web` / `ctx.jobs` / `ctx.dataQuality` 都在调用时经 `ctx.get` 判空;未挂载时对应路径响亮失败并说明原因,而不是静默走另一条路。
296
+ - **冻结契约有门禁**——`ctx.researchReport.assemble`(`src/service.ts`)与 `CitationCheck*`(`src/verify.ts`)是兄弟插件共用的逐字节冻结块,`scripts/verify-frozen-contract.mjs` 在 CI 里守住漂移。
297
+
298
+ ## 兼容性
299
+
300
+ | 维度 | 状态 |
301
+ | --- | --- |
302
+ | Harness | DeepSeek Harness `dsh-v0.2.1-alpha.1`(2026-09-25 已核验)。npm dev/test 线 `0.1.7-rc.2`;compat 矩阵同时钉住四条已声明 peer 线。0.1.5-alpha.1(2026-09-09 已适配)的会话信封保留 ignorable 字段但仅用于存量日志读取兼容——`Session.append` 仍无法盖章,门控行为不变。 |
303
+ | Node | `^22.19.0 \|\| >=24.9.0`,仅 ESM(`"type": "module"`) |
304
+ | 平台 | 任何 DSH 可运行处(纯 host;网络只经 `ctx.web`) |
305
+ | 模型 | 文本模型完全支持;核查是字节比对,不需要额外模型能力 |
306
+
307
+ Peer 依赖:`@deepseek-ai/cordis ^4.0.5-alpha.1`、`@deepseek-ai/schemastery ^3.18.5-alpha.1`,以及 `@deepseek-ai/dsh-session`、`@deepseek-ai/dsh-tools`、`@deepseek-ai/dsh-system-prompt`、`@deepseek-ai/dsh-web`、`@deepseek-ai/dsh-jobs`(范围见 `package.json`)。可选兄弟(绝不强制):`ctx.web` 抓取、`ctx.jobs` 后台组装、`ctx.dataQuality` 数据集引文交叉核对。
308
+
309
+ ## 生态与质量
310
+
311
+ - [Gitee 镜像](https://gitee.com/perrylink/dsh-research-report)(同步镜像,以 GitHub 为准)
312
+ - [dshfind 插件页](https://dshfind.com/plugins/PerryLink/dsh-research-report)(安装量与排名)
313
+ - [OpenSSF Scorecard 报告](https://securityscorecards.dev/viewer/?uri=github.com/PerryLink/dsh-research-report)(由 [.github/workflows/scorecard.yml](.github/workflows/scorecard.yml) 驱动)
314
+ - [dsh-plugin-doctor 验证报告](https://github.com/PerryLink/dsh-plugin-doctor#verified-徽章)
315
+ - [DSH Market](https://dsh.market/)(已上架)
316
+ - **1024 商店渠道**:先 `npm i -g dsh1024`,再 `dsh1024 plugin --profile web add dsh-research-report`(计入 [deepseek1024.com](https://deepseek1024.com) 安装排行)
317
+ - [生态实测知识库](https://perrylink.github.io/dsh-plugin-guide/):插件开发指南 · 选型实测数据 · 维护取舍判据
318
+
319
+ ## 开发
227
320
 
228
321
  ```sh
229
322
  pnpm install
@@ -231,39 +324,51 @@ pnpm run typecheck && pnpm run typecheck:ci
231
324
  pnpm test
232
325
  pnpm run build
233
326
  pnpm run verify:self-contained && pnpm run verify:artifacts
327
+ pnpm run verify:frozen-contract
234
328
  node scripts/check-readme-sync.mjs
235
- node scripts/verify-frozen-contract.mjs
329
+ pnpm run check:lockfile
236
330
  pnpm pack
237
331
  ```
238
332
 
239
- - `typecheck` resolves `@deepseek-ai/*` through the installed 0.1.7-rc.2 peers; `typecheck:ci` clears `skipLibCheck` and enables `verbatimModuleSyntax` against the published types. Both must stay green.
240
- - Tests use the real `Context`/`Session`/`ToolRuntime`/`LocalJobRegistry`/`WebRuntime` from the 0.1.7-rc.2 peers; only network backends are scripted providers registered through the real `ctx.web` registries.
241
- - Release: `node scripts/release.mjs <x.y.z>` (bumps, stamps CHANGELOG, re-runs the gate, commits + tags; never pushes).
333
+ - `typecheck` 经已安装的 0.1.7-rc.2 peer 解析 `@deepseek-ai/*`;`typecheck:ci` 关闭 `skipLibCheck` 并开启 `verbatimModuleSyntax` 对照已发布类型。两者都必须保持绿。
334
+ - 测试使用 0.1.7-rc.2 peer 的真实 `Context`/`Session`/`ToolRuntime`/`LocalJobRegistry`/`WebRuntime`;只有网络后端是注册进真实 `ctx.web` 注册表的脚本化 provider。
335
+ - 发布:`node scripts/release.mjs <x.y.z>`(bump、盖 CHANGELOG、重跑门禁、提交 + 打 tag;绝不 push)。
336
+ - 配图由 [`scripts/gen-readme-assets.py`](scripts/gen-readme-assets.py) 程序化生成(Python + Pillow):Pillow 画 `docs/assets/dsh-research-report-hero-{zh,en}-{light,dark}.webp`(1440×576),手写 SVG 画 `docs/assets/dsh-research-report-flow-v5-{light,dark}.svg`(1100×660),可重复执行、深浅两版与五语共用。
242
337
 
243
- ## Topics
338
+ 目录布局:
244
339
 
245
- `dsh`, `dsh-plugin`, `deepseek-harness`, `cordis`, `research`, `evidence-ledger`, `verifiable-report`, `audit`, `citation-verification`
340
+ | 路径 | 内容 |
341
+ | --- | --- |
342
+ | `src/index.ts` | function-plugin 契约(`name`/`inject`/`Config`/`apply`,无 default export) |
343
+ | `src/service.ts` | `ctx.researchReport` Service Definition + 逐字节冻结的 `assemble` 契约块 |
344
+ | `src/ledger.ts` | 内容寻址证据账本(对象 + JSONL 日志、读取重算哈希) |
345
+ | `src/verify.ts` | 字节级核查器 + 冻结的 `CitationCheck*` 桥类型 |
346
+ | `src/assemble.ts` | 纯组装:请求校验、`report.md` 渲染、确定性 `manifest.json`、封印 |
347
+ | `src/gather.ts` | 抓取(`ctx.web` / workspace 文件)与 `gather` 候选轮 |
348
+ | `src/tools/` | 四个消费者:`evidence_add`、`research_report`、`ledger_query`、`research_trail` |
349
+ | `test/` | vitest,使用真实 host 运行时;仅网络后端是脚本化 provider |
350
+ | `fixtures/` | 三条本地文档,覆盖 evidence → seal → tamper → contradicted 全流程 |
246
351
 
247
- ## Contributors
352
+ Topics:`dsh`、`dsh-plugin`、`deepseek-harness`、`cordis`、`research`、`evidence-ledger`、`verifiable-report`、`audit`、`citation-verification`
248
353
 
249
- - [PerryLink](https://github.com/PerryLink) — original author and maintainer: plugin architecture, evidence ledger, byte-level verification, sealed reports, five-language documentation, CI and release automation.
354
+ ## 家族与致谢
250
355
 
251
- ## PerryLink DSH Plugin Family
356
+ 本项目是 [PerryLink](https://github.com/PerryLink) 维护的 DeepSeek Harness 插件家族成员(全部 Apache-2.0)。如果这个插件帮到了你,**给个 star**——它不解锁任何功能,但会让下一个人更容易找到它。
252
357
 
253
- This project is part of the DeepSeek Harness plugin family from [PerryLink](https://github.com/PerryLink). The roster stays collapsed below so every README keeps a short first screen; expand it to see every row and its status.
358
+ - [@PerryLink](https://github.com/PerryLink) —— 原作者与维护者:插件架构、证据账本、字节级核验、密封报告、五语文档、CI 与发布自动化。
254
359
 
255
360
  <details>
256
- <summary>Expand all plugins</summary>
361
+ <summary>展开全部插件</summary>
257
362
 
258
- | Plugin | Status |
363
+ | 插件 | 状态 |
259
364
  |---|---|
260
365
  | **[dsh-aqua-input-check](https://github.com/PerryLink/dsh-aqua-input-check)** | |
261
366
  | **[dsh-archive-check](https://github.com/PerryLink/dsh-archive-check)** | |
262
367
  | **[dsh-auto-review](https://github.com/PerryLink/dsh-auto-review)** | |
263
- | **[dsh-autotier](https://github.com/PerryLink/dsh-autotier)** | 🧊 FROZEN — see the repo README |
368
+ | **[dsh-autotier](https://github.com/PerryLink/dsh-autotier)** | 🧊 已冻结 — 见仓库 README |
264
369
  | **[dsh-bid-ca-precheck](https://github.com/PerryLink/dsh-bid-ca-precheck)** | |
265
370
  | **[dsh-bid-qual-check](https://github.com/PerryLink/dsh-bid-qual-check)** | |
266
- | **[dsh-cert-mcp](https://github.com/PerryLink/dsh-cert-mcp)** | 🧊 FROZEN — see the repo README |
371
+ | **[dsh-cert-mcp](https://github.com/PerryLink/dsh-cert-mcp)** | 🧊 已冻结 — 见仓库 README |
267
372
  | **[dsh-checkpoint-rewind](https://github.com/PerryLink/dsh-checkpoint-rewind)** | |
268
373
  | **[dsh-click](https://github.com/PerryLink/dsh-click)** | |
269
374
  | **[dsh-composer-history](https://github.com/PerryLink/dsh-composer-history)** | |
@@ -314,10 +419,10 @@ This project is part of the DeepSeek Harness plugin family from [PerryLink](http
314
419
  | **[dsh-permit-report-check](https://github.com/PerryLink/dsh-permit-report-check)** | |
315
420
  | **[dsh-pipeline-check](https://github.com/PerryLink/dsh-pipeline-check)** | |
316
421
  | **[dsh-pleading-draft](https://github.com/PerryLink/dsh-pleading-draft)** | |
317
- | **[dsh-plugin-doctor](https://github.com/PerryLink/dsh-plugin-doctor)** | |
422
+ | **[dsh-plugin-doctor](https://github.com/PerryLink/dsh-plugin-doctor)** | 🚫 已退役(仓库已归档) |
318
423
  | **[dsh-plugin-guide](https://github.com/PerryLink/dsh-plugin-guide)** | |
319
- | **[dsh-plugin-kit](https://github.com/PerryLink/dsh-plugin-kit)** | |
320
- | **[dsh-plugin-upgrade](https://github.com/PerryLink/dsh-plugin-upgrade)** | |
424
+ | **[dsh-plugin-kit](https://github.com/PerryLink/dsh-plugin-kit)** | 🚫 已退役(仓库已归档) |
425
+ | **[dsh-plugin-upgrade](https://github.com/PerryLink/dsh-plugin-upgrade)** | 🚫 已退役(仓库已归档) |
321
426
  | **[dsh-policy-brief-draft](https://github.com/PerryLink/dsh-policy-brief-draft)** | |
322
427
  | **[dsh-power-loss-split](https://github.com/PerryLink/dsh-power-loss-split)** | |
323
428
  | **[dsh-power-ticket-check](https://github.com/PerryLink/dsh-power-ticket-check)** | |
@@ -341,20 +446,22 @@ This project is part of the DeepSeek Harness plugin family from [PerryLink](http
341
446
  | **[dsh-tender-extract](https://github.com/PerryLink/dsh-tender-extract)** | |
342
447
  | **[dsh-tender-matrix](https://github.com/PerryLink/dsh-tender-matrix)** | |
343
448
  | **[dsh-test-drive](https://github.com/PerryLink/dsh-test-drive)** | |
344
- | **[dsh-ticktick](https://github.com/PerryLink/dsh-ticktick)** | |
449
+ | **[dsh-ticktick](https://github.com/PerryLink/dsh-ticktick)** | 🚫 已退役(仓库已归档) |
345
450
  | **[dsh-translate](https://github.com/PerryLink/dsh-translate)** | |
346
451
  | **[dsh-warranty-calc](https://github.com/PerryLink/dsh-warranty-calc)** | |
347
- | **[dsh-budget](https://github.com/PerryLink/dsh-budget)** | 🧊 FROZEN — see the repo README |
348
- | **[dsh-claude-move](https://github.com/PerryLink/dsh-claude-move)** | 🧊 FROZEN — see the repo README |
349
- | **[dsh-defend](https://github.com/PerryLink/dsh-defend)** | 🧊 FROZEN — see the repo README |
350
- | **[dsh-draw](https://github.com/PerryLink/dsh-draw)** | 🧊 FROZEN — see the repo README |
351
- | **[dsh-reach](https://github.com/PerryLink/dsh-reach)** | 🧊 FROZEN — see the repo README |
352
- | **[dsh-background-agents](https://github.com/PerryLink/dsh-background-agents)** | 🚫 RETIRED — see the repo README |
353
- | **[dsh-session-pin](https://github.com/PerryLink/dsh-session-pin)** | 🚫 RETIRED — see the repo README |
354
- | **[dsh-team-rooms](https://github.com/PerryLink/dsh-team-rooms)** | 🚫 RETIRED — see the repo README |
452
+ | **[dsh-budget](https://github.com/PerryLink/dsh-budget)** | 🧊 已冻结 — 见仓库 README |
453
+ | **[dsh-claude-move](https://github.com/PerryLink/dsh-claude-move)** | 🧊 已冻结 — 见仓库 README |
454
+ | **[dsh-defend](https://github.com/PerryLink/dsh-defend)** | 🧊 已冻结 — 见仓库 README |
455
+ | **[dsh-draw](https://github.com/PerryLink/dsh-draw)** | 🧊 已冻结 — 见仓库 README |
456
+ | **[dsh-reach](https://github.com/PerryLink/dsh-reach)** | 🧊 已冻结 — 见仓库 README |
457
+ | **[dsh-background-agents](https://github.com/PerryLink/dsh-background-agents)** | 🚫 已退役(仓库已归档) |
458
+ | **[dsh-session-pin](https://github.com/PerryLink/dsh-session-pin)** | 🚫 已退役(仓库已归档) |
459
+ | **[dsh-team-rooms](https://github.com/PerryLink/dsh-team-rooms)** | 🚫 已退役(仓库已归档) |
355
460
 
356
461
  </details>
357
462
 
358
463
  ## License
359
464
 
360
- Apache-2.0 — see [LICENSE](LICENSE).
465
+ [LICENSE](LICENSE)(Apache License 2.0)© 2026 dsh-research-report contributors
466
+
467
+ <p align="center"><sub>Apache-2.0 · 社区插件,与 DeepSeek 无关。</sub></p>