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/CHANGELOG.md +6 -0
- package/README.en.md +467 -0
- package/README.es.md +466 -0
- package/README.hi.md +466 -0
- package/README.md +269 -162
- package/README.pt.md +466 -0
- package/lib/index.js +18 -0
- package/lib/types/service.d.ts +18 -0
- package/lib/types/service.d.ts.map +1 -1
- package/lib/types/service.js +18 -0
- package/lib/types/service.js.map +1 -1
- package/package.json +45 -20
- package/src/service.ts +18 -0
- package/README-es.md +0 -361
- package/README-hi.md +0 -361
- package/README-pt.md +0 -361
- package/README-zh.md +0 -361
package/README.pt.md
ADDED
|
@@ -0,0 +1,466 @@
|
|
|
1
|
+
<div align="center">
|
|
2
|
+
|
|
3
|
+
<picture>
|
|
4
|
+
<source media="(prefers-color-scheme: dark)" srcset="docs/assets/dsh-research-report-hero-en-dark.webp">
|
|
5
|
+
<img src="docs/assets/dsh-research-report-hero-en-light.webp" width="100%" alt="dsh-research-report: o diretório de relatório selado como entrada de hashes — report.md, os hashes de evidência do livro, verification.jsonl e disconfirmation.jsonl convergem em manifest.json, cujo SHA-256 é o selo; a faixa inferior é o verificador autônomo dsh-research-verify">
|
|
6
|
+
</picture>
|
|
7
|
+
|
|
8
|
+
# dsh-research-report
|
|
9
|
+
|
|
10
|
+
**Entregue um relatório cujas conclusões qualquer pessoa pode reverificar offline na própria máquina: mude um byte e o hash do selo deixa de bater.**
|
|
11
|
+
|
|
12
|
+
Motor de relatórios de pesquisa verificáveis para o DeepSeek Harness: cada claim é vinculado a snapshots de evidência imutáveis, números e citações são conferidos byte a byte, e o resultado é selado num diretório de relatório versionado cujo selo é o SHA-256 do `manifest.json`.
|
|
13
|
+
|
|
14
|
+
[Instalar](#instalação-em-três-passos) · [Configuração](#configuração) · [FAQ](#faq) · [简体中文](README.md) · [English](README.en.md) · [Español](README.es.md) · [Português](README.pt.md) · [हिन्दी](README.hi.md)
|
|
15
|
+
|
|
16
|
+
[](LICENSE)
|
|
17
|
+
[](#compatibilidade)
|
|
18
|
+
[](https://www.npmjs.com/package/dsh-research-report)
|
|
19
|
+
[](https://github.com/PerryLink/dsh-research-report/actions/workflows/ci.yml)
|
|
20
|
+
[](#compatibilidade)
|
|
21
|
+
|
|
22
|
+
[](https://github.com/PerryLink/dsh-research-report/stargazers)
|
|
23
|
+
[](https://www.npmjs.com/package/dsh-research-report)
|
|
24
|
+
[](https://dshfind.com/plugins/PerryLink/dsh-research-report?ref=badge)
|
|
25
|
+
[](https://securityscorecards.dev/viewer/?uri=github.com/PerryLink/dsh-research-report)
|
|
26
|
+
[](https://dsh.market/)
|
|
27
|
+
[](https://gitee.com/perrylink/dsh-research-report)
|
|
28
|
+
|
|
29
|
+
```sh
|
|
30
|
+
dsh plugin --profile <name> add dsh-research-report
|
|
31
|
+
```
|
|
32
|
+
|
|
33
|
+
</div>
|
|
34
|
+
|
|
35
|
+
<sub>Plugin da comunidade, sem afiliação com a DeepSeek. Repositório canônico: <https://github.com/PerryLink/dsh-research-report> (o Gitee é um espelho).</sub>
|
|
36
|
+
|
|
37
|
+
## O que é
|
|
38
|
+
|
|
39
|
+
Dê ao modelo um tema e um conjunto de fontes, e o `dsh-research-report` vincula cada claim a snapshots de evidência imutáveis, confere números e citações byte a byte e sela o resultado num diretório de relatório versionado que qualquer pessoa pode reverificar de forma independente. O diretório contém `report.md`, `manifest.json` e os diários de auditoria; o selo é o SHA-256 do `manifest.json`, e o `dsh-research-verify` o recalcula offline sem montar o plugin. Ele deliberadamente não embute um loop de deep-research: a recuperação roda sobre `ctx.web`, as execuções longas sobre `ctx.jobs`, e o planejamento e a síntese ficam com o modelo ou com um plugin upstream.
|
|
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: painel 1, o livro de evidências endereçado por conteúdo (captura, sha256, snapshot de objetos, quatro diários JSONL); painel 2, o pente de veredictos por claim (integridade, vínculo, localização literal; cinco veredictos, a primeira correspondência vence e é gravada de volta no livro); painel 3, o diretório de relatório selado (report.md e os dois diários de auditoria convergem em manifest.json, cujo SHA-256 é o selo); a faixa inferior é o binário autônomo dsh-research-verify">
|
|
44
|
+
</picture>
|
|
45
|
+
|
|
46
|
+
## Instalação em três passos
|
|
47
|
+
|
|
48
|
+
1. **Instalar** (escolha um canal):
|
|
49
|
+
|
|
50
|
+
```sh
|
|
51
|
+
# canal npm (versões publicadas)
|
|
52
|
+
dsh plugin --profile web add dsh-research-report
|
|
53
|
+
# canal git (main mais recente; equivale a git+https://github.com/PerryLink/dsh-research-report.git)
|
|
54
|
+
dsh plugin --profile web add github:PerryLink/dsh-research-report
|
|
55
|
+
# canal tarball: pnpm pack neste repositório e depois
|
|
56
|
+
dsh plugin --profile web add ./dsh-research-report-<version>.tgz
|
|
57
|
+
```
|
|
58
|
+
|
|
59
|
+
Os dois canais online instalam a linha do bundle (ver [`cordis.patch.yml`](cordis.patch.yml)) na pilha `dsh.profile.bundles` do perfil; **reinicie para entrar em vigor**.
|
|
60
|
+
|
|
61
|
+
2. **Configuração mínima** (os padrões já funcionam; raízes relativas resolvem contra o diretório de trabalho do harness):
|
|
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
|
+
```
|
|
71
|
+
|
|
72
|
+
3. **Verificar se montou**:
|
|
73
|
+
|
|
74
|
+
```sh
|
|
75
|
+
dsh --profile web --dump-config | grep dsh-research-report
|
|
76
|
+
```
|
|
77
|
+
|
|
78
|
+
Depois execute o circuito mínimo numa sessão e confira o selo com a CLI:
|
|
79
|
+
|
|
80
|
+
```text
|
|
81
|
+
evidence_add({ origin: "docs/market.md", title: "Market snapshot" }) # → ev-1a2b3c4d5e6f
|
|
82
|
+
research_report({ topic: "...", sections: [...], claims: [...], evidenceRefs: ["ev-1a2b…"] })
|
|
83
|
+
ledger_query({ claimId: "c1" }) # vínculos + veredicto
|
|
84
|
+
```
|
|
85
|
+
|
|
86
|
+
```sh
|
|
87
|
+
dsh-research-verify --report research-reports/<topic>/<YYYYMMDD-HHmmss>
|
|
88
|
+
```
|
|
89
|
+
|
|
90
|
+
**Desinstalar**: `dsh plugin --profile web remove dsh-research-report` (ou remova a linha do patch do perfil).
|
|
91
|
+
|
|
92
|
+
<details>
|
|
93
|
+
<summary>Instalar a partir do mercado do DSH Desktop</summary>
|
|
94
|
+
|
|
95
|
+
Todos os plugins PerryLink estão no mercado embutido do DSH Desktop: **Mercado → Fontes → Adicionar fonte → colar** `https://perrylink-dsh-catalog.perrylink.workers.dev/catalog-source.json` **→ selecionar**. A instalação continua exigindo a verificação de identidade npm do mercado e a sua confirmação.
|
|
96
|
+
|
|
97
|
+
</details>
|
|
98
|
+
|
|
99
|
+
## Capacidades principais
|
|
100
|
+
|
|
101
|
+
Três coisas sustentam a confiança: a evidência é imutável, as verificações são recalculáveis e as lacunas nunca são escondidas.
|
|
102
|
+
|
|
103
|
+
- **Ledger de evidência** — armazém de snapshots endereçado por conteúdo (`<ledgerRoot>/objects/<sha256>` + diários JSONL). O mesmo conteúdo é guardado uma única vez; os snapshots são imutáveis; toda leitura recalcula o hash, de modo que adulteração ou remoção são detectadas em vez de confiadas.
|
|
104
|
+
- **Vínculo claim ↔ evidência** — os claims são registrados com os ids de evidência dos quais dependem; o ledger guarda o vínculo e cada veredicto de verificação (o mais recente vence).
|
|
105
|
+
- **Verificação em nível de byte** — cada número e trecho entre aspas de um claim precisa ser localizável literalmente nos snapshots vinculados. Sem evidência vinculada, ou sem literal verificável, o claim é marcado `unverified`; evidência vinculada que não confirma nem refuta os literais citados o marca `insufficient`; um rótulo cujo valor difere no snapshot (e o valor citado está ausente) o marca `disproven`; snapshots adulterados ou ausentes o marcam `contradicted`. Sem semântica, sem embeddings: apenas checagens de bytes auditáveis.
|
|
106
|
+
- **Ponte numérica opcional** — quando um claim cita um dataset estruturado do workspace (CSV/JSON) e o `dsh-data-quality` está montado, as citações são conferidas com tolerâncias pelo seu contrato congelado `verifyCitations`; uma divergência do dataset refuta o claim.
|
|
107
|
+
- **Evidência DOI (sem rede)** — origens DOI são validadas deterministicamente (estrutura `10.xxxx/xxxx`, lista de prefixos permitidos e conjunto de caracteres DOI); DOIs inválidos falham ruidosamente. Metadado opcional de revista/ano é aceito, e `requireJournalMetadata` só restringe evidência DOI acadêmica quando habilitado.
|
|
108
|
+
- **Relatórios selados versionados** — `<reportRoot>/<slug(topic)>/<YYYYMMDD-HHmmss>/report.md` + `manifest.json` + `verification.jsonl` + `disconfirmation.jsonl`; o hash do selo é o SHA-256 do manifesto, que por sua vez carrega o hash do relatório, os hashes de toda a evidência e o hash de cada diário de auditoria.
|
|
109
|
+
- **Reauditoria antes da entrega e interceptação do selo** — antes de selar, cada claim vinculado é reverificado offline e registrado em `verification.jsonl`; deriva de veredicto, evidência vinculada adulterada/ausente ou falha de serialização do diário bloqueiam o selo (falha ruidosa, sem tunable).
|
|
110
|
+
- **Ledger de falsificação** — cada claim contradito ou refutado é registrado em `disconfirmation.jsonl` (claim + referências de evidência + motivo) e listado no apêndice de registro de falsificação do relatório.
|
|
111
|
+
- **Conhecimento negativo** — um claim refutado é lembrado pelo hash de conteúdo (`disproofs.jsonl`); o mesmo texto re-reportado contra evidência inalterada é forçado de volta a `disproven` e só é reverificado quando a evidência muda.
|
|
112
|
+
- **Loop de verificação somente leitura** — após selar, o fallback determinístico `verifySealedReport` (sem rede, sem modelo) recalcula o selo e os hashes de auditoria e recheca cada claim, gravando a checagem de máquina em `verifier-note.md`; com `ctx.jobs` montado, um job de verificação somente leitura também é disparado (a revisão do modelo é um acréscimo, nunca um substituto).
|
|
113
|
+
- **Evidência ancorada na sessão** — `evidence_add` aceita um `sessionRef` opcional (`sessionId` + `eventRange`, validado ruidosamente); a âncora é guardada e registrada no Apêndice B, no manifesto e em `verification.jsonl`. Evidência ancorada na sessão verifica honestamente como `unverified` (`evidência ancorada na sessão exige uma checagem manual no log da sessão`).
|
|
114
|
+
- **Lacunas honestas** — claims não verificados, insuficientes, contraditos ou refutados mantêm uma marca visível no corpo do relatório e são listados no Apêndice A. Nada é aprovado em silêncio.
|
|
115
|
+
- **Sem loop de deep-research** — a orquestração de recuperação é deliberadamente reaproveitada: `ctx.web` para busca/coleta, `ctx.jobs` para execuções longas. Planejamento e síntese ficam com o modelo (ou com um plugin upstream).
|
|
116
|
+
|
|
117
|
+
### Superfície de ferramentas
|
|
118
|
+
|
|
119
|
+
- **`evidence_add({ origin, content?, title? })`** — registra um snapshot de evidência. Com `content` o texto é guardado tal e qual; sem ele, uma origem URL é coletada via `ctx.web` e um caminho relativo do workspace é lido do disco (as leituras nunca escapam do workspace). Retorna o id da evidência e o hash SHA-256.
|
|
120
|
+
- **`research_report({ topic, title?, sections, claims, evidenceRefs, gather?, depth?, background? })`** — monta e sela um relatório: valida (referências a claims não registrados são rejeitadas ruidosamente), verifica cada claim, renderiza `report.md` com marcas visíveis, grava `manifest.json` e retorna o hash do selo. `gather: true` roda UMA rodada de busca sobre `ctx.web` e retorna evidência candidata capturada mais uma lista explícita de lacunas; nunca monta automaticamente. `background: true` retorna `{ kind: 'background', jobId }` via `ctx.jobs`.
|
|
121
|
+
- **`ledger_query({ claimId? | evidenceId? })`** — consultas somente leitura de vínculos e veredictos; a evidência é re-hasheada na leitura, então um snapshot adulterado ou ausente é reportado explicitamente. Sem id, retorna um resumo do ledger.
|
|
122
|
+
- **`ctx.researchReport.assemble(request)`** — a superfície de serviço congelada para plugins irmãos (ver `src/service.ts`; protegida byte a byte por [`scripts/verify-frozen-contract.mjs`](scripts/verify-frozen-contract.mjs)).
|
|
123
|
+
|
|
124
|
+
### Exemplos
|
|
125
|
+
|
|
126
|
+
Estes são os pontos de entrada reais do plugin; instale uma vez e chame um.
|
|
127
|
+
|
|
128
|
+
**Exemplo detalhado**
|
|
129
|
+
|
|
130
|
+
**Comando**
|
|
131
|
+
|
|
132
|
+
~~~sh
|
|
133
|
+
research_report({
|
|
134
|
+
topic: "示例行业概览",
|
|
135
|
+
sections: [{ heading: "市场规模", paragraphs: [{ text: "2025 年全球示例行业市场规模为 1,280 亿元。", claimIds: ["c1"] }] }],
|
|
136
|
+
claims: [{ id: "c1", text: "市场规模为 1,280 亿元", evidenceIds: ["ev-5dc0a84d0e48"] }],
|
|
137
|
+
evidenceRefs: ["ev-5dc0a84d0e48", "ev-c6cf024e0916", "ev-61f8f4533cb7"]
|
|
138
|
+
})
|
|
139
|
+
~~~
|
|
140
|
+
|
|
141
|
+
**Saída**
|
|
142
|
+
|
|
143
|
+
~~~text
|
|
144
|
+
report sealed: /tmp/rr-test-4U2mlF/reports/示例行业概览/20261019-124904
|
|
145
|
+
seal (sha256 of manifest.json): 5c85c97597096ced281ca191d7abaaf7434f18b397d35ac81c31aa364a3b12f9
|
|
146
|
+
claims: 1 verified / 0 unverified / 0 contradicted / 0 insufficient / 0 disproven (of 1); evidence bound: 3
|
|
147
|
+
~~~
|
|
148
|
+
|
|
149
|
+
*Observed from `README.md:112-118,150; test/index.spec.ts:166-177; src/tools/research-report.ts:170-175`*
|
|
150
|
+
|
|
151
|
+
**Ramo de falha**
|
|
152
|
+
|
|
153
|
+
**Entrada**
|
|
154
|
+
|
|
155
|
+
~~~text
|
|
156
|
+
{"topic":"probe","sections":[{"heading":"Growth","paragraphs":[{"text":"Growth was 42%.","claimIds":["c1"]}]}],"claims":[{"id":"c1","text":"Growth was 42%.","evidenceIds":[]}]}
|
|
157
|
+
~~~
|
|
158
|
+
|
|
159
|
+
**Saída**
|
|
160
|
+
|
|
161
|
+
~~~text
|
|
162
|
+
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%. [未核实]
|
|
163
|
+
~~~
|
|
164
|
+
|
|
165
|
+
*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`*
|
|
166
|
+
|
|
167
|
+
**Exemplos breves**: `research_report` · `ledger_query`
|
|
168
|
+
|
|
169
|
+
### CLI dsh-research-verify
|
|
170
|
+
|
|
171
|
+
O binário independente (empacotado como `lib/cli.js`, zero importações de `@deepseek-ai`) audita qualquer diretório de relatório selado sem montar o plugin:
|
|
172
|
+
|
|
173
|
+
```sh
|
|
174
|
+
dsh-research-verify --report <dir> [--seal <sha256>] [--ledger <dir>] [--format json|sarif]
|
|
175
|
+
```
|
|
176
|
+
|
|
177
|
+
- `--report <dir>` — o diretório do relatório selado (`manifest.json` + `report.md` + os diários de auditoria).
|
|
178
|
+
- `--seal <sha256>` — o hash de selo esperado para comparar com o hash recalculado do manifesto. Omitido = o hash recalculado é informado sem comparação.
|
|
179
|
+
- `--ledger <dir>` — a raiz do ledger de evidência (`objects/<sha256>` + `index.jsonl`), habilitando as rechecagens byte a byte por claim. Omitido = as rechecagens são honestamente puladas.
|
|
180
|
+
- `--format` — `json` (padrão) ou `sarif` (SARIF 2.1.0).
|
|
181
|
+
|
|
182
|
+
Ele recalcula o hash do selo (SHA-256 do `manifest.json`), o hash do `report.md` e os hashes dos diários de auditoria, reexecuta a checagem byte a byte + de integridade para cada claim, e sai com código não zero quando qualquer checagem executada falha. As mesmas funções `verifySealedReport` / `buildVerificationReport` / `renderSarif` / `renderVerificationJson` são exportadas do pacote para uso como biblioteca.
|
|
183
|
+
|
|
184
|
+
## Configuração
|
|
185
|
+
|
|
186
|
+
Todos os ajustes são campos `Config` do Schemastery; valores inválidos falham ruidosamente no carregamento do perfil. Raízes relativas resolvem contra o diretório de trabalho do harness (o workspace). O `cordis.patch.yml` documenta cada chave inline.
|
|
187
|
+
|
|
188
|
+
Chaves mais usadas:
|
|
189
|
+
|
|
190
|
+
| Chave | Padrão | Significado |
|
|
191
|
+
| --- | --- | --- |
|
|
192
|
+
| `enabled` | `true` | Interruptor mestre; `false` não monta nada. |
|
|
193
|
+
| `ledgerRoot` | `.research-ledger` | Diretório do ledger de evidência (objetos + diários JSONL). |
|
|
194
|
+
| `reportRoot` | `research-reports` | Raiz dos relatórios selados (versionados por tema e timestamp). |
|
|
195
|
+
| `workspaceRoot` | *(diretório de trabalho da sessão do host)* | Raiz para evidência por caminho; padrão é o diretório da sessão, depois o cwd do harness. |
|
|
196
|
+
| `maxEvidenceBytes` | `2097152` | Limite rígido de bytes UTF-8 por snapshot de evidência. |
|
|
197
|
+
| `maxEvidencePerReport` | `200` | Limite rígido de evidências vinculadas a um relatório. |
|
|
198
|
+
|
|
199
|
+
<details>
|
|
200
|
+
<summary>Tabela completa de configuração (8 chaves)</summary>
|
|
201
|
+
|
|
202
|
+
| Chave | Padrão | Significado |
|
|
203
|
+
| --- | --- | --- |
|
|
204
|
+
| `enabled` | `true` | Interruptor mestre; `false` não monta nada. |
|
|
205
|
+
| `ledgerRoot` | `.research-ledger` | Diretório do ledger de evidência (objetos + diários JSONL). |
|
|
206
|
+
| `reportRoot` | `research-reports` | Raiz dos relatórios selados (versionados por tema e timestamp). |
|
|
207
|
+
| `workspaceRoot` | *(diretório de trabalho da sessão do host)* | Raiz para evidência por caminho; padrão é o diretório da sessão, depois o cwd do harness. |
|
|
208
|
+
| `maxEvidenceBytes` | `2097152` | Limite rígido de bytes UTF-8 por snapshot de evidência. |
|
|
209
|
+
| `maxEvidencePerReport` | `200` | Limite rígido de evidências vinculadas a um relatório. |
|
|
210
|
+
| `fetchTimeoutMs` | `20000` | Prazo (ms) de um `ctx.web` fetch durante a captura. |
|
|
211
|
+
| `requireJournalMetadata` | `false` | Quando true, evidência do tipo DOI precisa trazer nome de revista e ano de publicação no registro (caso contrário falha ruidosamente). |
|
|
212
|
+
|
|
213
|
+
</details>
|
|
214
|
+
|
|
215
|
+
Exemplo de override no patch do perfil:
|
|
216
|
+
|
|
217
|
+
```yaml
|
|
218
|
+
- insert:
|
|
219
|
+
- id: dsh-research-report
|
|
220
|
+
name: dsh-research-report
|
|
221
|
+
config:
|
|
222
|
+
reportRoot: research-reports/acme
|
|
223
|
+
maxEvidencePerReport: 100
|
|
224
|
+
requireJournalMetadata: true
|
|
225
|
+
```
|
|
226
|
+
|
|
227
|
+
## FAQ
|
|
228
|
+
|
|
229
|
+
<details>
|
|
230
|
+
<summary>Onde o ledger e os relatórios realmente ficam? O que acontece se eu apagar?</summary>
|
|
231
|
+
|
|
232
|
+
Ambos ficam sob as raízes configuradas: `ledgerRoot` (padrão `.research-ledger`) e `reportRoot` (padrão `research-reports`), resolvidas contra o diretório de trabalho do harness quando relativas. Os snapshots são endereçados por conteúdo e imutáveis, e o mesmo conteúdo é guardado uma única vez; apague ou reescreva um objeto e a checagem de hash da leitura seguinte falha, os claims vinculados verificam como `contradicted` e o `ledger_query` informa `integrity: missing`/`tampered` — nada é tratado como ok em silêncio.
|
|
233
|
+
|
|
234
|
+
</details>
|
|
235
|
+
|
|
236
|
+
<details>
|
|
237
|
+
<summary>O que acontece sem um provedor de fetch? Degrada em silêncio?</summary>
|
|
238
|
+
|
|
239
|
+
Nunca em silêncio. O `dsh-base` distribuído monta apenas busca, então a captura por URL falha ruidosamente (`WEB_UNAVAILABLE`/`WEB_PROVIDER_UNAVAILABLE`) até um provedor de fetch ser configurado; o `gather` baseado em busca lista as fontes não capturadas na lista de lacunas e nunca fabrica evidência nem monta relatório automaticamente.
|
|
240
|
+
|
|
241
|
+
</details>
|
|
242
|
+
|
|
243
|
+
<details>
|
|
244
|
+
<summary>Conflita com o dsh-data-quality?</summary>
|
|
245
|
+
|
|
246
|
+
Não. `ctx.dataQuality` é opcional e é consultado com `ctx.get` em tempo de chamada — nunca injetado. Quando presente, cruza citações de datasets pelo contrato congelado `verifyCitations`; quando ausente, esse caminho é honestamente ignorado. Este plugin não registra nenhum listener waterfall.
|
|
247
|
+
|
|
248
|
+
</details>
|
|
249
|
+
|
|
250
|
+
<details>
|
|
251
|
+
<summary>Qual é o custo de desempenho?</summary>
|
|
252
|
+
|
|
253
|
+
A verificação é puro trabalho de bytes: sem rede, sem chamadas de modelo, linear no número de literais numéricos e entre aspas de um claim e no tamanho dos snapshots vinculados. A reauditoria antes do selo é o mesmo trabalho determinístico repetido. A única espera externa é a captura de evidência, limitada por `fetchTimeoutMs` (20000 ms por padrão); relatórios longos podem rodar com `background: true` sobre `ctx.jobs`.
|
|
254
|
+
|
|
255
|
+
</details>
|
|
256
|
+
|
|
257
|
+
<details>
|
|
258
|
+
<summary>Por que meu claim parafraseado verifica como unverified?</summary>
|
|
259
|
+
|
|
260
|
+
É o desenho em nível de byte: a checagem embutida localiza literais numéricos e entre aspas e não consegue julgar equivalência semântica de uma reescrita. Ver a primeira entrada de Limitações conhecidas: auditável antes de esperto.
|
|
261
|
+
|
|
262
|
+
</details>
|
|
263
|
+
|
|
264
|
+
## Limites de segurança
|
|
265
|
+
|
|
266
|
+
- **Anti-adulteração por construção** — toda leitura de snapshot recalcula o SHA-256 contra o índice; uma divergência faz os claims vinculados verificarem como `contradicted` e o `ledger_query` reporta `integrity: tampered`/`missing`.
|
|
267
|
+
- **Confinamento ao workspace** — leituras locais de evidência resolvem contra a raiz do workspace e recusam escapes (ambos os lados passam por `path.resolve` antes da comparação).
|
|
268
|
+
- **Configuração que falha ruidosamente** — limites inválidos lançam na montagem; referências a claims não registrados, ids de evidência desconhecidos e conflitos de id/conteúdo lançam na montagem do relatório.
|
|
269
|
+
- **Sem manuseio de credenciais, sem rede oculta** — a captura por URL passa por `ctx.web` (seleção de provedor, taxonomia de erros e qualquer política SSRF ficam com os provedores web da implantação).
|
|
270
|
+
- **Registros reversíveis** — cada contribuição passa por `ctx.effect()` / `register()`, então desinstalação e recarga a quente ficam limpas.
|
|
271
|
+
|
|
272
|
+
## Permissões e dados
|
|
273
|
+
|
|
274
|
+
O `dsh-research-report` consome apenas seams públicos: `ctx.tools`, `ctx.systemPrompt` e, opcionalmente, `ctx.web` / `ctx.jobs` / `ctx.dataQuality` (consultados com `ctx.get` em tempo de chamada, nunca injetados). Ele só escreve dentro das raízes configuradas do ledger e dos relatórios (ambas, por padrão, diretórios locais do workspace), lê arquivos do workspace apenas dentro do workspace e alcança a rede exclusivamente pelo seam web do harness — nunca com `fetch` direto. Os snapshots de evidência são imutáveis e endereçados por conteúdo; os registros de claims são imutáveis; os veredictos são apenas anexados.
|
|
275
|
+
|
|
276
|
+
- **Permissões declaradas no manifesto**: `fs:workspace-write`, `network:ctx-web-only`, `session:read`, `session:write`, `native-code:none` (ver o bloco `dshWorkshop` em `package.json`).
|
|
277
|
+
- **Eventos de sessão**: `research-report/evidence`, `research-report/verify` e `research-report/seal` são um espelho adaptativo; só chegam ao log da sessão quando o host conhece o vocabulário, caso contrário os diários do ledger carregam a verdade durável (ver Limitações conhecidas).
|
|
278
|
+
|
|
279
|
+
## Limitações conhecidas
|
|
280
|
+
|
|
281
|
+
- **Em nível de byte, não semântico** — a checagem embutida localiza literais numéricos e entre aspas literalmente; claims parafraseados sem literal verificável verificam como `unverified`, e um claim verdadeiro cujo número está ausente enquanto seu rótulo aparece com outro valor é lido como `contradicted`. É uma escolha deliberada da v1 (auditável antes de esperto).
|
|
282
|
+
- **Os eventos de sessão são adaptativos** — o plugin declara eventos de sessão tipados `research-report/evidence`, `research-report/verify` e `research-report/seal`, mas o `Session.append` de 0.1.5-alpha.1 ainda não expõe a opção `ignorable` nem uma superfície de registro de eventos de plugin, então os appends só ativam quando o build do host conhece os tipos (caso contrário a camada de persistência recusaria o log na restauração). Os diários do ledger são sempre a fonte durável de verdade.
|
|
283
|
+
- **Perfis padrão não montam provedor de fetch** — o `dsh-base` distribuído monta apenas busca, então a captura por URL falha ruidosamente (`WEB_UNAVAILABLE`/`WEB_PROVIDER_UNAVAILABLE`) até configurar um provedor de fetch; o `gather` baseado em busca lista as fontes não capturadas na lista de lacunas.
|
|
284
|
+
- **Escopo de um único workspace** — as raízes do ledger e dos relatórios resolvem contra o diretório de trabalho do harness na montagem; implantações multi-workspace devem configurar raízes absolutas por perfil.
|
|
285
|
+
|
|
286
|
+
## Interoperabilidade com outros plugins DSH
|
|
287
|
+
|
|
288
|
+
Este plugin não disputa estruturalmente recursos de outro plugin:
|
|
289
|
+
|
|
290
|
+
- **Uma única chave de serviço, `ctx.researchReport`** — fornecida pela Service Definition em `src/service.ts`; nenhuma segunda chave de serviço é registrada.
|
|
291
|
+
- **Sem listeners waterfall** — o plugin não registra nenhum listener `ctx.on()`, então não participa de nenhuma cadeia de eventos sensível à ordem; se um for adicionado um dia, o ramo de allow/passthrough DEVE chamar `next()`.
|
|
292
|
+
- **Sem rotas HTTP nem superfície de cliente** — não há prefixo `webServer` nem slot de cliente; é um plugin puramente host (o repositório não tem `client/`).
|
|
293
|
+
- **A camada de patch só insere a própria linha** — o patch do bundle insere `dsh-research-report` e nunca sobrescreve o `config` de uma linha embutida.
|
|
294
|
+
- **Os irmãos opcionais são consultados sob demanda** — `ctx.web` / `ctx.jobs` / `ctx.dataQuality` são resolvidos com `ctx.get` em tempo de chamada; quando faltam, o caminho afetado falha ruidosamente com um motivo explícito em vez de silenciosamente tomar outro caminho.
|
|
295
|
+
- **Contratos congelados têm porta** — `ctx.researchReport.assemble` (`src/service.ts`) e `CitationCheck*` (`src/verify.ts`) são blocos congelados byte a byte compartilhados com plugins irmãos, e `scripts/verify-frozen-contract.mjs` vigia a deriva no CI.
|
|
296
|
+
|
|
297
|
+
## Compatibilidade
|
|
298
|
+
|
|
299
|
+
| Superfície | Estado |
|
|
300
|
+
| --- | --- |
|
|
301
|
+
| Harness | DeepSeek Harness `dsh-v0.2.1-alpha.1` (verificado em 2026-09-25). Linha npm dev/test `0.1.7-rc.2`; a matriz compat fixa as quatro linhas peer declaradas. Na 0.1.5-alpha.1 (adaptado em 2026-09-09) o envelope de sessão mantém o campo ignorable apenas para compatibilidade de leitura de logs armazenados; o `Session.append` ainda não consegue estampá-lo, então o comportamento da porta de auditoria não muda. |
|
|
302
|
+
| Node | `^22.19.0 \|\| >=24.9.0`, somente ESM (`"type": "module"`) |
|
|
303
|
+
| Plataformas | Onde o DSH rodar (host puro; a rede só é alcançada via `ctx.web`) |
|
|
304
|
+
| Modelo | Modelos de texto totalmente suportados; a verificação é comparação de bytes, sem capacidade extra de modelo |
|
|
305
|
+
|
|
306
|
+
Dependências peer: `@deepseek-ai/cordis ^4.0.5-alpha.1`, `@deepseek-ai/schemastery ^3.18.5-alpha.1`, e `@deepseek-ai/dsh-session`, `@deepseek-ai/dsh-tools`, `@deepseek-ai/dsh-system-prompt`, `@deepseek-ai/dsh-web`, `@deepseek-ai/dsh-jobs` (faixas em `package.json`). Irmãos opcionais (nunca obrigatórios): `ctx.web` para captura, `ctx.jobs` para montagem em segundo plano, `ctx.dataQuality` para cruzamento de citações de datasets.
|
|
307
|
+
|
|
308
|
+
## Ecossistema e qualidade
|
|
309
|
+
|
|
310
|
+
- [Espelho no Gitee](https://gitee.com/perrylink/dsh-research-report) (espelho sincronizado; o GitHub é o canônico)
|
|
311
|
+
- [Página do plugin no dshfind](https://dshfind.com/plugins/PerryLink/dsh-research-report) (instalações e ranking)
|
|
312
|
+
- [Relatório OpenSSF Scorecard](https://securityscorecards.dev/viewer/?uri=github.com/PerryLink/dsh-research-report) (movido por [.github/workflows/scorecard.yml](.github/workflows/scorecard.yml))
|
|
313
|
+
- [Relatório de verificação do dsh-plugin-doctor](https://github.com/PerryLink/dsh-plugin-doctor#verified-徽章)
|
|
314
|
+
- [DSH Market](https://dsh.market/) (listado)
|
|
315
|
+
- **Canal da loja 1024**: `npm i -g dsh1024` uma vez e depois `dsh1024 plugin --profile web add dsh-research-report` (conta para o ranking de instalações do [deepseek1024.com](https://deepseek1024.com))
|
|
316
|
+
- [Base de conhecimento do ecossistema](https://perrylink.github.io/dsh-plugin-guide/): dados medidos, não marketing: guia de desenvolvimento de plugins · dados de seleção · critérios de manutenção
|
|
317
|
+
|
|
318
|
+
## Desenvolvimento
|
|
319
|
+
|
|
320
|
+
```sh
|
|
321
|
+
pnpm install
|
|
322
|
+
pnpm run typecheck && pnpm run typecheck:ci
|
|
323
|
+
pnpm test
|
|
324
|
+
pnpm run build
|
|
325
|
+
pnpm run verify:self-contained && pnpm run verify:artifacts
|
|
326
|
+
pnpm run verify:frozen-contract
|
|
327
|
+
node scripts/check-readme-sync.mjs
|
|
328
|
+
pnpm run check:lockfile
|
|
329
|
+
pnpm pack
|
|
330
|
+
```
|
|
331
|
+
|
|
332
|
+
- `typecheck` resolve `@deepseek-ai/*` pelos peers 0.1.7-rc.2 instalados; `typecheck:ci` remove `skipLibCheck` e habilita `verbatimModuleSyntax` contra os tipos publicados. Ambos precisam ficar verdes.
|
|
333
|
+
- Os testes usam os `Context`/`Session`/`ToolRuntime`/`LocalJobRegistry`/`WebRuntime` reais dos peers 0.1.7-rc.2; apenas os backends de rede são provedores scriptados registrados nos registros reais de `ctx.web`.
|
|
334
|
+
- Release: `node scripts/release.mjs <x.y.z>` (bump, carimba CHANGELOG, reexecuta a porta, commit + tag; nunca faz push).
|
|
335
|
+
- As imagens do README são geradas programaticamente por [`scripts/gen-readme-assets.py`](scripts/gen-readme-assets.py) (Python + Pillow): a faixa raster é `docs/assets/dsh-research-report-hero-{zh,en}-{light,dark}.webp` (1440×576) e o diagrama de estrutura SVG escrito à mão é `docs/assets/dsh-research-report-flow-v5-{light,dark}.svg` (1100×660), seguros de reexecutar e compartilhados pelos cinco idiomas.
|
|
336
|
+
|
|
337
|
+
Estrutura de diretórios:
|
|
338
|
+
|
|
339
|
+
| Caminho | Conteúdo |
|
|
340
|
+
| --- | --- |
|
|
341
|
+
| `src/index.ts` | Contrato function-plugin (`name`/`inject`/`Config`/`apply`, sem default export) |
|
|
342
|
+
| `src/service.ts` | Service Definition de `ctx.researchReport` + o bloco de contrato `assemble` congelado byte a byte |
|
|
343
|
+
| `src/ledger.ts` | O ledger de evidência endereçado por conteúdo (objetos + diários JSONL, re-hash na leitura) |
|
|
344
|
+
| `src/verify.ts` | O verificador em nível de byte + os tipos de ponte `CitationCheck*` congelados |
|
|
345
|
+
| `src/assemble.ts` | Montagem pura: validação da requisição, render de `report.md`, `manifest.json` determinístico, selo |
|
|
346
|
+
| `src/gather.ts` | Captura (`ctx.web` / arquivos do workspace) e a rodada de candidatos `gather` |
|
|
347
|
+
| `src/tools/` | Os três consumidores: `evidence_add`, `research_report`, `ledger_query` |
|
|
348
|
+
| `test/` | vitest sobre o runtime real do host; apenas os backends de rede são provedores scriptados |
|
|
349
|
+
| `fixtures/` | Três documentos locais cobrindo o fluxo evidence → seal → tamper → contradicted |
|
|
350
|
+
|
|
351
|
+
Topics: `dsh`, `dsh-plugin`, `deepseek-harness`, `cordis`, `research`, `evidence-ledger`, `verifiable-report`, `audit`, `citation-verification`
|
|
352
|
+
|
|
353
|
+
## Família e agradecimentos
|
|
354
|
+
|
|
355
|
+
Este projeto faz parte da família de plugins DeepSeek Harness da [PerryLink](https://github.com/PerryLink) (todos Apache-2.0). Se ele for útil, **uma estrela ajuda a próxima pessoa a encontrá-lo** — nada é bloqueado por isso.
|
|
356
|
+
|
|
357
|
+
- [@PerryLink](https://github.com/PerryLink) — autor original e mantenedor: arquitetura do plugin, ledger de evidência, verificação em nível de byte, relatórios selados, documentação em cinco idiomas, CI e automação de releases.
|
|
358
|
+
|
|
359
|
+
<details>
|
|
360
|
+
<summary>Expandir todos os plugins</summary>
|
|
361
|
+
|
|
362
|
+
| Plugin | Status |
|
|
363
|
+
|---|---|
|
|
364
|
+
| **[dsh-aqua-input-check](https://github.com/PerryLink/dsh-aqua-input-check)** | |
|
|
365
|
+
| **[dsh-archive-check](https://github.com/PerryLink/dsh-archive-check)** | |
|
|
366
|
+
| **[dsh-auto-review](https://github.com/PerryLink/dsh-auto-review)** | |
|
|
367
|
+
| **[dsh-autotier](https://github.com/PerryLink/dsh-autotier)** | 🧊 CONGELADO — ver o README do repo |
|
|
368
|
+
| **[dsh-bid-ca-precheck](https://github.com/PerryLink/dsh-bid-ca-precheck)** | |
|
|
369
|
+
| **[dsh-bid-qual-check](https://github.com/PerryLink/dsh-bid-qual-check)** | |
|
|
370
|
+
| **[dsh-cert-mcp](https://github.com/PerryLink/dsh-cert-mcp)** | 🧊 CONGELADO — ver o README do repo |
|
|
371
|
+
| **[dsh-checkpoint-rewind](https://github.com/PerryLink/dsh-checkpoint-rewind)** | |
|
|
372
|
+
| **[dsh-click](https://github.com/PerryLink/dsh-click)** | |
|
|
373
|
+
| **[dsh-composer-history](https://github.com/PerryLink/dsh-composer-history)** | |
|
|
374
|
+
| **[dsh-contract-stance](https://github.com/PerryLink/dsh-contract-stance)** | |
|
|
375
|
+
| **[dsh-customs-doc-check](https://github.com/PerryLink/dsh-customs-doc-check)** | |
|
|
376
|
+
| **[dsh-data-quality](https://github.com/PerryLink/dsh-data-quality)** | |
|
|
377
|
+
| **[dsh-demurrage-ledger](https://github.com/PerryLink/dsh-demurrage-ledger)** | |
|
|
378
|
+
| **[dsh-doublecheck](https://github.com/PerryLink/dsh-doublecheck)** | |
|
|
379
|
+
| **[dsh-drill-script-check](https://github.com/PerryLink/dsh-drill-script-check)** | |
|
|
380
|
+
| **[dsh-eia-guide-check](https://github.com/PerryLink/dsh-eia-guide-check)** | |
|
|
381
|
+
| **[dsh-emergency-plan](https://github.com/PerryLink/dsh-emergency-plan)** | |
|
|
382
|
+
| **[dsh-essay-rubric-check](https://github.com/PerryLink/dsh-essay-rubric-check)** | |
|
|
383
|
+
| **[dsh-evidence-check](https://github.com/PerryLink/dsh-evidence-check)** | |
|
|
384
|
+
| **[dsh-export-ctl-check](https://github.com/PerryLink/dsh-export-ctl-check)** | |
|
|
385
|
+
| **[dsh-fast](https://github.com/PerryLink/dsh-fast)** | |
|
|
386
|
+
| **[dsh-fmea-table-check](https://github.com/PerryLink/dsh-fmea-table-check)** | |
|
|
387
|
+
| **[dsh-forecast-penalty](https://github.com/PerryLink/dsh-forecast-penalty)** | |
|
|
388
|
+
| **[dsh-fund-research](https://github.com/PerryLink/dsh-fund-research)** | |
|
|
389
|
+
| **[dsh-github](https://github.com/PerryLink/dsh-github)** | |
|
|
390
|
+
| **[dsh-gongwen-flow-check](https://github.com/PerryLink/dsh-gongwen-flow-check)** | |
|
|
391
|
+
| **[dsh-gongwen-word-check](https://github.com/PerryLink/dsh-gongwen-word-check)** | |
|
|
392
|
+
| **[dsh-guard-plan-qc](https://github.com/PerryLink/dsh-guard-plan-qc)** | |
|
|
393
|
+
| **[dsh-hazchem-check](https://github.com/PerryLink/dsh-hazchem-check)** | |
|
|
394
|
+
| **[dsh-hazplan-check](https://github.com/PerryLink/dsh-hazplan-check)** | |
|
|
395
|
+
| **[dsh-hidden-risk-map](https://github.com/PerryLink/dsh-hidden-risk-map)** | |
|
|
396
|
+
| **[dsh-hs-classify](https://github.com/PerryLink/dsh-hs-classify)** | |
|
|
397
|
+
| **[dsh-icd-rule-check](https://github.com/PerryLink/dsh-icd-rule-check)** | |
|
|
398
|
+
| **[dsh-industry-research](https://github.com/PerryLink/dsh-industry-research)** | |
|
|
399
|
+
| **[dsh-lawcite-adapter](https://github.com/PerryLink/dsh-lawcite-adapter)** | |
|
|
400
|
+
| **[dsh-laya](https://github.com/PerryLink/dsh-laya)** | |
|
|
401
|
+
| **[dsh-lc-doc-check](https://github.com/PerryLink/dsh-lc-doc-check)** | |
|
|
402
|
+
| **[dsh-learning-gap-check](https://github.com/PerryLink/dsh-learning-gap-check)** | |
|
|
403
|
+
| **[dsh-library](https://github.com/PerryLink/dsh-library)** | |
|
|
404
|
+
| **[dsh-local-ai](https://github.com/PerryLink/dsh-local-ai)** | |
|
|
405
|
+
| **[dsh-lsp-actions](https://github.com/PerryLink/dsh-lsp-actions)** | |
|
|
406
|
+
| **[dsh-mask](https://github.com/PerryLink/dsh-mask)** | |
|
|
407
|
+
| **[dsh-mcp-panel](https://github.com/PerryLink/dsh-mcp-panel)** | |
|
|
408
|
+
| **[dsh-medrec-qc](https://github.com/PerryLink/dsh-medrec-qc)** | |
|
|
409
|
+
| **[dsh-memento](https://github.com/PerryLink/dsh-memento)** | |
|
|
410
|
+
| **[dsh-nsfc-form-check](https://github.com/PerryLink/dsh-nsfc-form-check)** | |
|
|
411
|
+
| **[dsh-nurse-record-check](https://github.com/PerryLink/dsh-nurse-record-check)** | |
|
|
412
|
+
| **[dsh-observe](https://github.com/PerryLink/dsh-observe)** | |
|
|
413
|
+
| **[dsh-origin-rvc-check](https://github.com/PerryLink/dsh-origin-rvc-check)** | |
|
|
414
|
+
| **[dsh-ota-review-check](https://github.com/PerryLink/dsh-ota-review-check)** | |
|
|
415
|
+
| **[dsh-output-styles](https://github.com/PerryLink/dsh-output-styles)** | |
|
|
416
|
+
| **[dsh-paper-doc-adapter](https://github.com/PerryLink/dsh-paper-doc-adapter)** | |
|
|
417
|
+
| **[dsh-permission-rules](https://github.com/PerryLink/dsh-permission-rules)** | |
|
|
418
|
+
| **[dsh-permit-report-check](https://github.com/PerryLink/dsh-permit-report-check)** | |
|
|
419
|
+
| **[dsh-pipeline-check](https://github.com/PerryLink/dsh-pipeline-check)** | |
|
|
420
|
+
| **[dsh-pleading-draft](https://github.com/PerryLink/dsh-pleading-draft)** | |
|
|
421
|
+
| **[dsh-plugin-doctor](https://github.com/PerryLink/dsh-plugin-doctor)** | 🚫 APOSENTADO (repo arquivado) |
|
|
422
|
+
| **[dsh-plugin-guide](https://github.com/PerryLink/dsh-plugin-guide)** | |
|
|
423
|
+
| **[dsh-plugin-kit](https://github.com/PerryLink/dsh-plugin-kit)** | 🚫 APOSENTADO (repo arquivado) |
|
|
424
|
+
| **[dsh-plugin-upgrade](https://github.com/PerryLink/dsh-plugin-upgrade)** | 🚫 APOSENTADO (repo arquivado) |
|
|
425
|
+
| **[dsh-policy-brief-draft](https://github.com/PerryLink/dsh-policy-brief-draft)** | |
|
|
426
|
+
| **[dsh-power-loss-split](https://github.com/PerryLink/dsh-power-loss-split)** | |
|
|
427
|
+
| **[dsh-power-ticket-check](https://github.com/PerryLink/dsh-power-ticket-check)** | |
|
|
428
|
+
| **[dsh-ppap-check](https://github.com/PerryLink/dsh-ppap-check)** | |
|
|
429
|
+
| **[dsh-protest-deadline](https://github.com/PerryLink/dsh-protest-deadline)** | |
|
|
430
|
+
| **[dsh-railway-window](https://github.com/PerryLink/dsh-railway-window)** | |
|
|
431
|
+
| **[dsh-repair-order-qc](https://github.com/PerryLink/dsh-repair-order-qc)** | |
|
|
432
|
+
| **[dsh-research-report](https://github.com/PerryLink/dsh-research-report)** | |
|
|
433
|
+
| **[dsh-review-reply-check](https://github.com/PerryLink/dsh-review-reply-check)** | |
|
|
434
|
+
| **[dsh-rulefile-check](https://github.com/PerryLink/dsh-rulefile-check)** | |
|
|
435
|
+
| **[dsh-safety-brief-check](https://github.com/PerryLink/dsh-safety-brief-check)** | |
|
|
436
|
+
| **[dsh-score](https://github.com/PerryLink/dsh-score)** | |
|
|
437
|
+
| **[dsh-session-sync](https://github.com/PerryLink/dsh-session-sync)** | |
|
|
438
|
+
| **[dsh-site-log-check](https://github.com/PerryLink/dsh-site-log-check)** | |
|
|
439
|
+
| **[dsh-skill-pack-security](https://github.com/PerryLink/dsh-skill-pack-security)** | |
|
|
440
|
+
| **[dsh-soe-decision-check](https://github.com/PerryLink/dsh-soe-decision-check)** | |
|
|
441
|
+
| **[dsh-soilwater-check](https://github.com/PerryLink/dsh-soilwater-check)** | |
|
|
442
|
+
| **[dsh-sop-sync-check](https://github.com/PerryLink/dsh-sop-sync-check)** | |
|
|
443
|
+
| **[dsh-spc-gbt-adapter](https://github.com/PerryLink/dsh-spc-gbt-adapter)** | |
|
|
444
|
+
| **[dsh-talk](https://github.com/PerryLink/dsh-talk)** | |
|
|
445
|
+
| **[dsh-tender-extract](https://github.com/PerryLink/dsh-tender-extract)** | |
|
|
446
|
+
| **[dsh-tender-matrix](https://github.com/PerryLink/dsh-tender-matrix)** | |
|
|
447
|
+
| **[dsh-test-drive](https://github.com/PerryLink/dsh-test-drive)** | |
|
|
448
|
+
| **[dsh-ticktick](https://github.com/PerryLink/dsh-ticktick)** | 🚫 APOSENTADO (repo arquivado) |
|
|
449
|
+
| **[dsh-translate](https://github.com/PerryLink/dsh-translate)** | |
|
|
450
|
+
| **[dsh-warranty-calc](https://github.com/PerryLink/dsh-warranty-calc)** | |
|
|
451
|
+
| **[dsh-budget](https://github.com/PerryLink/dsh-budget)** | 🧊 CONGELADO — ver o README do repo |
|
|
452
|
+
| **[dsh-claude-move](https://github.com/PerryLink/dsh-claude-move)** | 🧊 CONGELADO — ver o README do repo |
|
|
453
|
+
| **[dsh-defend](https://github.com/PerryLink/dsh-defend)** | 🧊 CONGELADO — ver o README do repo |
|
|
454
|
+
| **[dsh-draw](https://github.com/PerryLink/dsh-draw)** | 🧊 CONGELADO — ver o README do repo |
|
|
455
|
+
| **[dsh-reach](https://github.com/PerryLink/dsh-reach)** | 🧊 CONGELADO — ver o README do repo |
|
|
456
|
+
| **[dsh-background-agents](https://github.com/PerryLink/dsh-background-agents)** | 🚫 APOSENTADO (repo arquivado) |
|
|
457
|
+
| **[dsh-session-pin](https://github.com/PerryLink/dsh-session-pin)** | 🚫 APOSENTADO (repo arquivado) |
|
|
458
|
+
| **[dsh-team-rooms](https://github.com/PerryLink/dsh-team-rooms)** | 🚫 APOSENTADO (repo arquivado) |
|
|
459
|
+
|
|
460
|
+
</details>
|
|
461
|
+
|
|
462
|
+
## Licença
|
|
463
|
+
|
|
464
|
+
[LICENSE](LICENSE) (Apache License 2.0) © 2026 dsh-research-report contributors
|
|
465
|
+
|
|
466
|
+
<p align="center"><sub>Apache-2.0 · Plugin da comunidade, sem afiliação com a DeepSeek.</sub></p>
|
package/lib/index.js
CHANGED
|
@@ -563,6 +563,24 @@ async function gatherCandidates(deps, topic, depth, signal, register) {
|
|
|
563
563
|
* (dsh-industry-research) consume `ctx.researchReport.assemble` against this
|
|
564
564
|
* exact text. `scripts/verify-frozen-contract.mjs` gates drift.
|
|
565
565
|
*
|
|
566
|
+
* ── Sibling-facing surfaces (both supported) ────────────────────────────────
|
|
567
|
+
* Two seams are contractual for out-of-tree consumers. Pick by integration
|
|
568
|
+
* style, not by convenience:
|
|
569
|
+
*
|
|
570
|
+
* 1. In-process: `ctx.researchReport.assemble()` returns the frozen
|
|
571
|
+
* `AssembleReportResult` above. `reportDir` is the sealed directory;
|
|
572
|
+
* `report.md` and `manifest.json` are its fixed entry files.
|
|
573
|
+
* 2. Event-driven: the `tool/result` event for `name === 'research_report'`
|
|
574
|
+
* carries `meta.reportFile` / `meta.manifestFile` — absolute, resolved paths
|
|
575
|
+
* of those same two artifacts, present only when the result is sealed
|
|
576
|
+
* (`kind === 'sealed'`). The projection is durable and replay-safe; its
|
|
577
|
+
* fields are additive-only and the pair is never renamed, so a consumer that
|
|
578
|
+
* joins `tool/call` to `tool/result` may depend on them.
|
|
579
|
+
*
|
|
580
|
+
* The meta projection exists for consumers that cannot reproduce this plugin's
|
|
581
|
+
* cwd resolution; consumers that call the service directly should use
|
|
582
|
+
* `reportDir`. Both stay stable across minor versions.
|
|
583
|
+
*
|
|
566
584
|
* @module dsh-research-report/service
|
|
567
585
|
*/
|
|
568
586
|
/**
|
package/lib/types/service.d.ts
CHANGED
|
@@ -12,6 +12,24 @@
|
|
|
12
12
|
* (dsh-industry-research) consume `ctx.researchReport.assemble` against this
|
|
13
13
|
* exact text. `scripts/verify-frozen-contract.mjs` gates drift.
|
|
14
14
|
*
|
|
15
|
+
* ── Sibling-facing surfaces (both supported) ────────────────────────────────
|
|
16
|
+
* Two seams are contractual for out-of-tree consumers. Pick by integration
|
|
17
|
+
* style, not by convenience:
|
|
18
|
+
*
|
|
19
|
+
* 1. In-process: `ctx.researchReport.assemble()` returns the frozen
|
|
20
|
+
* `AssembleReportResult` above. `reportDir` is the sealed directory;
|
|
21
|
+
* `report.md` and `manifest.json` are its fixed entry files.
|
|
22
|
+
* 2. Event-driven: the `tool/result` event for `name === 'research_report'`
|
|
23
|
+
* carries `meta.reportFile` / `meta.manifestFile` — absolute, resolved paths
|
|
24
|
+
* of those same two artifacts, present only when the result is sealed
|
|
25
|
+
* (`kind === 'sealed'`). The projection is durable and replay-safe; its
|
|
26
|
+
* fields are additive-only and the pair is never renamed, so a consumer that
|
|
27
|
+
* joins `tool/call` to `tool/result` may depend on them.
|
|
28
|
+
*
|
|
29
|
+
* The meta projection exists for consumers that cannot reproduce this plugin's
|
|
30
|
+
* cwd resolution; consumers that call the service directly should use
|
|
31
|
+
* `reportDir`. Both stay stable across minor versions.
|
|
32
|
+
*
|
|
15
33
|
* @module dsh-research-report/service
|
|
16
34
|
*/
|
|
17
35
|
import { Context, Service } from '@deepseek-ai/cordis';
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../src/service.ts"],"names":[],"mappings":"AAAA
|
|
1
|
+
{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../src/service.ts"],"names":[],"mappings":"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"}
|
package/lib/types/service.js
CHANGED
|
@@ -12,6 +12,24 @@
|
|
|
12
12
|
* (dsh-industry-research) consume `ctx.researchReport.assemble` against this
|
|
13
13
|
* exact text. `scripts/verify-frozen-contract.mjs` gates drift.
|
|
14
14
|
*
|
|
15
|
+
* ── Sibling-facing surfaces (both supported) ────────────────────────────────
|
|
16
|
+
* Two seams are contractual for out-of-tree consumers. Pick by integration
|
|
17
|
+
* style, not by convenience:
|
|
18
|
+
*
|
|
19
|
+
* 1. In-process: `ctx.researchReport.assemble()` returns the frozen
|
|
20
|
+
* `AssembleReportResult` above. `reportDir` is the sealed directory;
|
|
21
|
+
* `report.md` and `manifest.json` are its fixed entry files.
|
|
22
|
+
* 2. Event-driven: the `tool/result` event for `name === 'research_report'`
|
|
23
|
+
* carries `meta.reportFile` / `meta.manifestFile` — absolute, resolved paths
|
|
24
|
+
* of those same two artifacts, present only when the result is sealed
|
|
25
|
+
* (`kind === 'sealed'`). The projection is durable and replay-safe; its
|
|
26
|
+
* fields are additive-only and the pair is never renamed, so a consumer that
|
|
27
|
+
* joins `tool/call` to `tool/result` may depend on them.
|
|
28
|
+
*
|
|
29
|
+
* The meta projection exists for consumers that cannot reproduce this plugin's
|
|
30
|
+
* cwd resolution; consumers that call the service directly should use
|
|
31
|
+
* `reportDir`. Both stay stable across minor versions.
|
|
32
|
+
*
|
|
15
33
|
* @module dsh-research-report/service
|
|
16
34
|
*/
|
|
17
35
|
import { Service } from '@deepseek-ai/cordis';
|
package/lib/types/service.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"service.js","sourceRoot":"","sources":["../../src/service.ts"],"names":[],"mappings":"AAAA
|
|
1
|
+
{"version":3,"file":"service.js","sourceRoot":"","sources":["../../src/service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAEH,OAAO,EAAW,OAAO,EAAE,MAAM,qBAAqB,CAAA;AA0RtD;;;;;;;GAOG;AACH,MAAM,OAAgB,qBAAsB,SAAQ,OAAO;IACzD,YAAY,GAAY;QACtB,KAAK,CAAC,GAAG,EAAE,gBAAgB,CAAC,CAAA;IAC9B,CAAC;CA6DF"}
|