dsh-observe 0.2.27 → 0.2.29

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,116 +1,206 @@
1
1
  <div align="center">
2
2
 
3
- # 📊 dsh-observe
4
- - **1024 store channel**: `npm i -g dsh1024` once, then `dsh1024 plugin --profile web add dsh-observe` (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-observe)
6
- [![dshfind](https://dshfind.com/api/badge/PerryLink/dsh-observe?metric=downloads)](https://dshfind.com/plugins/PerryLink/dsh-observe?ref=badge)
7
- [![OpenSSF Scorecard](https://api.securityscorecards.dev/projects/github.com/PerryLink/dsh-observe/badge)](https://api.securityscorecards.dev/projects/github.com/PerryLink/dsh-observe)
3
+ <picture>
4
+ <source media="(prefers-color-scheme: dark)" srcset="docs/assets/dsh-observe-hero-zh-dark.webp">
5
+ <img src="docs/assets/dsh-observe-hero-zh-light.webp" width="100%" alt="dsh-observe 配图:左列是插件名、价值句与安装命令;右侧是一条 turn 的 trace 瀑布——turn、step、工具调用与 LLM span 按时间轴排布,LLM 条上标着 token 数,下方是 spans、tokens、USD 成本与上下文压力指标,卡片底部注明脱敏先于入队、去向是 OTLP 与 Langfuse">
6
+ </picture>
7
+
8
+ # dsh-observe
8
9
 
9
- **OpenTelemetry and Langfuse observability exporter for DeepSeek Harness.**
10
+ **把每次会话变成标准 OTLP trace 与 Langfuse 观测——发出去之前先脱敏,默认什么都不发。**
10
11
 
11
- *Turn session events into OTLP traces and Langfuse observations — sanitized, buffered, off by default.*
12
+ 面向 DeepSeek Harness 的可观测性导出器:turn/step/工具调用/LLM 生成 span,token 与 USD 成本指标,异步批量、有界离线缓冲、指数退避重试;OTLP 与 Langfuse 接其一或两个都接。
12
13
 
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-observe.svg)](https://github.com/PerryLink/dsh-plugin-doctor#verified-徽章)
16
- [![DSH Market](https://raw.githubusercontent.com/2BingLing/dsh-market/master/assets/readme/badge-listed-en.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-observe/ci.yml?branch=main&label=CI)](https://github.com/PerryLink/dsh-observe/actions)
19
- [![Version](https://img.shields.io/github/v/tag/PerryLink/dsh-observe?label=version)](https://github.com/PerryLink/dsh-observe/releases)
20
- [![npm version](https://img.shields.io/npm/v/dsh-observe)](https://www.npmjs.com/package/dsh-observe)
21
- [![npm downloads](https://img.shields.io/npm/dm/dsh-observe)](https://www.npmjs.com/package/dsh-observe)
14
+ [安装](#三步上手) · [配置](#配置) · [FAQ](#faq) · [简体中文](README.md) · [English](README.en.md) · [Español](README.es.md) · [Português](README.pt.md) · [हिन्दी](README.hi.md)
22
15
 
23
- [English](README.md) · [简体中文](README-zh.md) · [Español](README-es.md) · [Português](README-pt.md) · [हिन्दी](README-hi.md)
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.2.1%20%3C0.3.0-4B67B4?style=flat-square&labelColor=2B3245)](#兼容性)
18
+ [![npm](https://img.shields.io/npm/v/dsh-observe?style=flat-square&labelColor=2B3245&color=CB3837)](https://www.npmjs.com/package/dsh-observe)
19
+ [![CI](https://img.shields.io/github/actions/workflow/status/PerryLink/dsh-observe/ci.yml?branch=main&label=CI&style=flat-square&labelColor=2B3245)](https://github.com/PerryLink/dsh-observe/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)](#兼容性)
21
+
22
+ [![Stars](https://img.shields.io/github/stars/PerryLink/dsh-observe?style=flat-square&labelColor=2B3245)](https://github.com/PerryLink/dsh-observe/stargazers)
23
+ [![npm downloads](https://img.shields.io/npm/dm/dsh-observe?style=flat-square&labelColor=2B3245&color=CB3837)](https://www.npmjs.com/package/dsh-observe)
24
+ [![dshfind](https://dshfind.com/api/badge/PerryLink/dsh-observe?metric=downloads)](https://dshfind.com/plugins/PerryLink/dsh-observe?ref=badge)
25
+ [![OpenSSF Scorecard](https://api.securityscorecards.dev/projects/github.com/PerryLink/dsh-observe/badge)](https://securityscorecards.dev/viewer/?uri=github.com/PerryLink/dsh-observe)
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-observe)
24
28
 
25
29
  ```sh
26
30
  dsh plugin --profile <name> add dsh-observe
27
31
  ```
28
32
 
29
-
30
33
  </div>
31
34
 
32
- ---
35
+ <sub>社区插件,与 DeepSeek 官方无关。唯一仓库:<https://github.com/PerryLink/dsh-observe>(Gitee 为镜像)。</sub>
33
36
 
34
- **📖 Ecosystem knowledge base** — measured data, not marketing: [plugin development guide · plugin-selection data · maintenance criteria](https://perrylink.github.io/dsh-plugin-guide/).
37
+ ## 它是什么
35
38
 
36
- <!-- star-cta -->
37
- ## Install & uninstall
39
+ `dsh-observe` 把 harness 的 `session/event` 流翻译成标准可观测协议:一个 turn 一条 trace,step、工具调用与 LLM 生成各是一个 span,token 与成本是累计指标,prompt/completion 正文先脱敏截断再入队。它只做导出——不注册任何模型工具、不注册用户可见命令,全部行为由配置决定;配置了 OTLP 或 Langfuse 之后重启,数据自己流走,没配置就什么都不采集。
38
40
 
39
- - **git channel** (latest `main`): `dsh plugin --profile web add github:PerryLink/dsh-observe` — the `prepare` script builds with production dependencies only.
40
- - **npm channel** (published releases): `dsh plugin --profile web add dsh-observe`.
41
- - **tarball channel**: `pnpm pack` in this repo, then `dsh plugin --profile web add ./dsh-observe-<version>.tgz`.
42
- - **uninstall**: `dsh plugin --profile web remove dsh-observe` (or remove the row from the profile patch).
41
+ <picture>
42
+ <source media="(prefers-color-scheme: dark)" srcset="docs/assets/dsh-observe-flow-v5-dark.svg">
43
+ <img src="docs/assets/dsh-observe-flow-v5-light.svg" width="100%" alt="dsh-observe 结构图(双通道分叉 + 有界回环):session/event 经 collector(turn/step/tool/llm span 与 observe.tokens、observe.cost、observe.context_tokens 指标,确定性 sha256 id)到 sanitize(键名脱敏、内置密钥模式、prompt/completion 4000 与 tool 2000/2000 字符预算),在入队之前完成脱敏;随后分叉成 otlp 与 langfuse 两条独立管线,每条是队列(256 条或 5000ms,maxQueueRecords 2000)→ flush/retry(5 次、1000ms×2 退避、上限 60000ms)→ 各自端点;重试耗尽与队列溢出落入两轨之间有界的 storage-domain spool(10000 条、最旧优先淘汰、读回 zod 复校验、重启仍在),每 30000ms 沿右侧虚线回环排空回两个端点;左下是可选 remote 面 observe/status 与 observe/setEnabled,底部注明默认关闭与三个监听事件">
44
+ </picture>
43
45
 
44
- > If pnpm reports `ERR_PNPM_IGNORED_BUILDS` for this package (esbuild's harmless platform-binary validation), add `allowBuilds: { esbuild: true }` to your `pnpm-workspace.yaml` — the `dsh` CLI prints the exact snippet.
46
+ ## 三步上手
45
47
 
46
- ## ⭐ 如果它帮到了你
48
+ 1. **安装**(三选一):
47
49
 
48
- 这个插件是 [DSH 插件家族](https://github.com/PerryLink)的一员(95 个,全部 Apache-2.0)。如果你在用,**给个 star** —— 它不会解锁任何功能,但会让下一个人在搜索里更容易找到它。
50
+ ```sh
51
+ # git 通道(最新 main;prepare 脚本只用生产依赖构建)
52
+ dsh plugin --profile web add github:PerryLink/dsh-observe
53
+ # npm 通道(已发布版本)
54
+ dsh plugin --profile web add dsh-observe
55
+ # tarball 通道:本仓库 pnpm pack 后
56
+ dsh plugin --profile web add ./dsh-observe-<version>.tgz
57
+ ```
49
58
 
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.
59
+ > 如果 pnpm 对本包报 `ERR_PNPM_IGNORED_BUILDS`(esbuild 的平台二进制无害校验),在你的 `pnpm-workspace.yaml` 中加入 `allowBuilds: { esbuild: true }` —— `dsh` CLI 会打印确切片段。
51
60
 
61
+ 2. **最小配置**(在 profile patch 里打开 `enabled` 并至少配一个后端;`cordis.patch.yml` 里该行默认关闭):
52
62
 
53
- ## What is dsh-observe?
63
+ ```yaml
64
+ - insert:
65
+ - id: dsh-observe
66
+ name: dsh-observe
67
+ config:
68
+ enabled: true
69
+ otlp:
70
+ endpoint: http://localhost:4318
71
+ ```
54
72
 
55
- OpenTelemetry and Langfuse observability exporter for DeepSeek Harness.
73
+ Langfuse 侧同理:`langfuse.baseUrl` + `langfuse.publicKey` + `langfuse.secretKey`,两者可以同时开。
56
74
 
57
- Turn session events into OTLP traces and Langfuse observations — sanitized, buffered, off by default.
75
+ 3. **验证已生效**:
58
76
 
59
- ![Workflow diagram for dsh-observe: install → open panel → act.](docs/assets/dsh-observe-flow.svg)
77
+ ```sh
78
+ dsh --profile web --dump-config | grep -A2 'id: dsh-observe'
79
+ ```
60
80
 
61
- *Workflow overview: install → open panel → act. The examples below use the real command surface.*
81
+ 本插件不注册用户可见命令,所以没有 `/observe` 之类的手动触发面;把 `remote.enabled` 设为 `true` 后,设置页可经 `observe/status` 读到已配置后端、队列深度与离线缓冲占用。
62
82
 
83
+ **卸载**:`dsh plugin --profile web remove dsh-observe`(或从 profile patch 删掉该行)。
63
84
 
85
+ <details>
86
+ <summary>从 DSH Desktop 市场安装</summary>
64
87
 
65
- ## Compatibility
88
+ 所有 PerryLink 插件均可在 DSH Desktop 内置市场中浏览:**市场 → 来源 → 添加来源 → 粘贴** `https://perrylink-dsh-catalog.perrylink.workers.dev/catalog-source.json` **→ 选中**。安装仍需通过市场的 npm 身份校验与你的确认。
66
89
 
67
- | Surface | Status |
68
- |---|---|
69
- | Harness | DeepSeek Harness `dsh-v0.2.1-alpha.1` (adapted 2026-10-04): session format V4 represents a tool result as a first-class `role: 'tool'` message carrying top-level `toolCallId` + `content` + optional `isError` — the V3 `tool-result` content block is gone from the host's `ContentBlockMap`, and this plugin reads only the V4 shape (a pre-upgrade V3 log still projects through a read-only compatibility path). Session format V3's other traits carry over: the assistant stream is embedded in `assistant/message` / `assistant/attempt`, and the system prompt is surface node 0 (`system/message`); the plugin consumes only the live event stream and never reads session log files. The peer range `>=0.1.2-rc.1 <0.2.0 \|\| >=0.1.5-alpha.1 <0.2.0 \|\| >=0.1.6-0 <0.2.0 \|\| >=0.1.7-0 <0.2.0` keeps every published line installable (full local gate chain; the compat workflow covers the profile install smoke). |
70
- | Node | `^22.19.0 \|\| >=24.0.0` |
71
- | Backends | OpenTelemetry OTLP/HTTP (traces + metrics, JSON encoding) and Langfuse (LLM observability) — either or both |
72
- | Model | Model-agnostic: it exports the session/event stream; no model calls are made |
90
+ </details>
73
91
 
74
- ## What you get
92
+ ## 核心能力
75
93
 
76
- `dsh-observe` turns the harness's `session/event` stream into standard observability protocols:
94
+ `dsh-observe` 把会话事件流变成标准可观测协议:
77
95
 
78
- - **Spans** — turn, step, tool-call (duration, status, retry derivation), and LLM generation spans, linked into per-turn traces with deterministic ids.
79
- - **Metrics** — per-provider/model token counters, USD cost counters (configurable pricing table), and the optional context-pressure gauge from `ctx.tokenMeter`.
80
- - **Sanitized capture** — prompt and completion bodies are redacted (structural key names + built-in secret patterns + your patterns) and truncated before anything is queued or sent.
81
- - **Reliability** — async batching (size- and timer-triggered), a bounded durable offline buffer (storage-domain) with oldest-first eviction, and deterministic exponential-backoff retries; undeliverable batches survive restarts.
82
- - **Runtime kill switch** — the optional Typert remote (`observe/status`, `observe/setEnabled`) lets a settings page stop and resume exporting without unmounting.
83
- - **Off by default** — `enabled: true` plus at least one backend is an explicit opt-in; nothing is captured or exported otherwise.
96
+ - **Spans** —— turn、step、工具调用(耗时、状态、重试推导)与 LLM 生成 span,按 turn 连成 trace,id 确定性可复现。
97
+ - **Metrics** —— 按 provider/model 的 token 计数、USD 成本计数(可配价格表)、以及可选的 `ctx.tokenMeter` 上下文压力 gauge。
98
+ - **脱敏采集** —— prompt 与 completion 正文先经结构性键名脱敏 + 内置密钥模式 + 自定义模式 + 字符预算截断,之后才进入队列或发送。
99
+ - **可靠性** —— 异步批量(数量与定时双触发)、有界持久离线缓冲(storage-domain,最旧优先淘汰)、确定性指数退避重试;未送达批次重启后仍在。
100
+ - **运行时总开关** —— 可选 Typert remote(`observe/status`、`observe/setEnabled`)让设置页在不卸载的情况下停止/恢复导出。
101
+ - **默认关闭** —— `enabled: true` 且至少配置一个后端才是显式开启;否则不采集、不导出。
84
102
 
85
103
  ```text
86
- session/event stream
87
- │ collector (turn/step/tool/llm spans, metrics)
88
- │ sanitize (keys, secrets, budgets)
89
- ├──▶ pipeline "otlp" ── queue ── flush ──▶ OTLP /v1/traces + /v1/metrics
90
- │ └─ retry/backoff ─┐
91
- ├──▶ pipeline "langfuse" ── queue ── flush ──▶ Langfuse ingestion
92
- │ └─ retry/backoff ─┤
93
- └────────── durable spool (offline buffer, bounded) ◀┘
104
+ session/event 流
105
+ │ collector(turn/step/tool/llm span、metrics)
106
+ │ sanitize(键名、密钥、预算)
107
+ ├──▶ pipeline "otlp" ── 队列 ── flush ──▶ OTLP /v1/traces + /v1/metrics
108
+ │ └─ 重试/退避 ──┐
109
+ ├──▶ pipeline "langfuse" ── 队列 ── flush ──▶ Langfuse ingestion
110
+ │ └─ 重试/退避 ──┤
111
+ └────────── 持久 spool(离线缓冲,有界)◀┘
94
112
  ```
95
113
 
96
- ## Quick start
114
+ ### 表面
97
115
 
98
- ```sh
99
- dsh plugin --profile web add github:PerryLink/dsh-observe
100
- ```
116
+ 本插件**不注册任何模型工具**,也不注册用户可见命令——它是后台导出器。它只有三类表面:
101
117
 
102
- ```sh
103
- # 1. install the bundle into your profile
104
- dsh plugin --profile web add github:PerryLink/dsh-observe
118
+ - **消费** `session/event`(span/metric 采集)、`session/flush`(尽力导出 kick —— 持久化检查点绝不等待远端后端)、`session/disposed`。
119
+ - **可选 remote 服务** `observe`(`remote.enabled`,默认关闭)—— `observe/status` 返回总开关状态、已配置后端、队列深度与缓冲占用;`observe/setEnabled` 在运行时停止/恢复导出。
120
+ - **唯一注入的服务键** `storageDomain`,用于离线缓冲的持久表。
105
121
 
106
- # or from npm (published releases)
107
- dsh plugin --profile web add dsh-observe
122
+ ### 示例
108
123
 
109
- # 2. configure a backend in your profile patch (cordis.yml) and restart
110
- dsh --profile web
111
- ```
124
+ 没有手动触发面:安装后按上面的最小配置打开 `enabled`,重启后即可在 OTLP 后端看到 trace 与指标、在 Langfuse 看到 observations。要确认「确实在采集」,看后端收到的第一条 trace 即可;要确认「确实在发」,看 `observe/status` 的队列深度是否随会话推进而回落。
125
+
126
+ ## 配置
112
127
 
113
- Minimal OTLP configuration (the row ships commented out in `cordis.patch.yml`):
128
+ 所有可调项都是 Schemastery `Config` 字段(可在 cordis.yml / profile patch 中修改)。按 id 定向覆盖会替换整行 —— 需要重新声明每个键。[`cordis.patch.yml`](cordis.patch.yml) 逐键内联注释。
129
+
130
+ 最常用键:
131
+
132
+ | 键 | 默认值 | 含义 |
133
+ |---|---|---|
134
+ | `enabled` | `false` | 总开关;`true` 且至少一个后端才是显式开启 |
135
+ | `otlp.endpoint` | *(必填)* | OTLP 基础 URL;`/v1/traces` 与 `/v1/metrics` 由插件追加 |
136
+ | `otlp.serviceName` | `deepseek-harness` | `service.name` 资源属性 |
137
+ | `langfuse.baseUrl` | `https://cloud.langfuse.com` | Langfuse 基础 URL |
138
+ | `langfuse.traceName` | `session {session} turn {turn}` | trace 名称模板;`{session}`/`{turn}` 按 trace 插值 |
139
+ | `capture.llm` | `true` | LLM 生成 span 开关 |
140
+ | `llm.prompt` | `true` | 采集脱敏后的请求 prompt(`false` 只记大小) |
141
+ | `llm.reasoning` | `true` | 单独采集 reasoning(思维链)到 `gen_ai.completion.reasoning`(`false` = 只发正文) |
142
+ | `batch.maxBufferRecords` | `10000` | 持久离线缓冲上限;最旧记录先丢 |
143
+ | `remote.enabled` | `false` | 挂载 `observe` Typert remote(运行时总开关) |
144
+
145
+ <details>
146
+ <summary>完整配置表(48 个键)</summary>
147
+
148
+ | 键 | 默认值 | 含义 |
149
+ |---|---|---|
150
+ | `enabled` | `false` | 总开关;`true` 且至少一个后端才是显式开启 |
151
+ | `otlp` | `null` | OTLP 后端配置,`null` 表示禁用 |
152
+ | `otlp.endpoint` | *(必填)* | OTLP 基础 URL;`/v1/traces` 与 `/v1/metrics` 由插件追加 |
153
+ | `otlp.serviceName` | `deepseek-harness` | `service.name` 资源属性 |
154
+ | `otlp.serviceVersion` | *(无)* | `service.version` 资源属性 |
155
+ | `otlp.headers` | `{}` | 合并进每个导出请求的额外请求头 |
156
+ | `otlp.timeoutMs` | `10000` | 单请求超时 |
157
+ | `langfuse` | `null` | Langfuse 后端配置,`null` 表示禁用 |
158
+ | `langfuse.baseUrl` | `https://cloud.langfuse.com` | Langfuse 基础 URL |
159
+ | `langfuse.publicKey` | *(必填)* | 项目公钥 |
160
+ | `langfuse.secretKey` | *(必填)* | 项目密钥 |
161
+ | `langfuse.release` | *(无)* | 打在各 trace 上的 release 标签 |
162
+ | `langfuse.traceName` | `session {session} turn {turn}` | trace 名称模板;`{session}`/`{turn}` 按 trace 插值 |
163
+ | `langfuse.tags` | `[]` | 打在每个 trace 上的静态标签 |
164
+ | `langfuse.timeoutMs` | `10000` | 单请求超时 |
165
+ | `capture.turns` | `true` | turn 生命周期 span |
166
+ | `capture.steps` | `true` | step 生命周期 span |
167
+ | `capture.tools` | `true` | 工具调用 span(参数/结果脱敏) |
168
+ | `capture.llm` | `true` | LLM 生成 span |
169
+ | `llm.prompt` | `true` | 采集脱敏后的请求 prompt(`false` 只记大小) |
170
+ | `llm.completion` | `true` | 采集脱敏后的 completion(`false` 只记大小) |
171
+ | `llm.reasoning` | `true` | 单独采集 reasoning(思维链)到 `gen_ai.completion.reasoning`(`false` = 只发正文) |
172
+ | `metadata.sessionId` | `true` | 会话 id 属性 |
173
+ | `metadata.cwd` | `false` | 会话工作目录(本地路径——默认关闭) |
174
+ | `metadata.agentPreset` | `true` | agent preset id 属性 |
175
+ | `metadata.model` | `true` | provider/model 属性 |
176
+ | `metrics.tokens` | `true` | 按 provider/model 的 token 计数 |
177
+ | `metrics.cost` | `true` | USD 成本计数(需 `pricing` 规则匹配) |
178
+ | `metrics.contextTokens` | `true` | 上下文压力 gauge(需 `ctx.tokenMeter`) |
179
+ | `pricing` | `[]` | 价格表,首个匹配生效:`{ provider?, model, inputPerToken, outputPerToken, cacheReadPerToken?, cacheWritePerToken? }` |
180
+ | `sanitize.enabled` | `true` | 脱敏总开关(`false` 只关脱敏,不关截断) |
181
+ | `sanitize.redactKeys` | `[]` | 额外键名子串(key/token/secret/password/authorization/credential/apiKey 恒生效) |
182
+ | `sanitize.redactPatterns` | `[]` | 额外密钥正则 |
183
+ | `sanitize.truncatePromptChars` | `4000` | prompt 字符预算 |
184
+ | `sanitize.truncateCompletionChars` | `4000` | completion 字符预算 |
185
+ | `sanitize.truncateToolInputChars` | `2000` | 工具参数字符预算 |
186
+ | `sanitize.truncateToolOutputChars` | `2000` | 工具结果字符预算 |
187
+ | `sanitize.truncateAttributeChars` | `512` | span 属性字符串预算 |
188
+ | `batch.maxRecords` | `256` | 队列达到该数量即 flush |
189
+ | `batch.flushIntervalMs` | `5000` | 定时 flush 间隔 |
190
+ | `batch.maxQueueRecords` | `2000` | 内存队列上限;超出溢入缓冲 |
191
+ | `batch.maxBufferRecords` | `10000` | 持久离线缓冲上限;最旧记录先丢 |
192
+ | `batch.bufferRetryIntervalMs` | `30000` | 离线缓冲重试间隔 |
193
+ | `retry.maxAttempts` | `5` | 每批尝试次数(含首次) |
194
+ | `retry.baseDelayMs` | `1000` | 首次退避延迟 |
195
+ | `retry.factor` | `2` | 每连续失败一次的退避倍数 |
196
+ | `retry.maxDelayMs` | `60000` | 退避上限 |
197
+ | `remote.enabled` | `false` | 挂载 `observe` Typert remote(运行时总开关) |
198
+
199
+ </details>
200
+
201
+ > ⚠️ **reasoning 合规提示**:`llm.reasoning` 默认开启,reasoning 会作为 `gen_ai.completion.reasoning` 单独外发(绝不混入 `gen_ai.completion`;在 Langfuse 中放在 generation 的 metadata 里)。思维链可能包含用户原文,或模型逐字复述的上下文,**外发前请评估合规要求**;不需要时设 `llm.reasoning: false`。`llm.completion: false` 会同时关掉正文与 reasoning。
202
+
203
+ 按 id 覆盖的示例(会替换整行,所以重述需要的键):
114
204
 
115
205
  ```yaml
116
206
  - insert:
@@ -120,146 +210,150 @@ Minimal OTLP configuration (the row ships commented out in `cordis.patch.yml`):
120
210
  enabled: true
121
211
  otlp:
122
212
  endpoint: http://localhost:4318
213
+ capture:
214
+ tools: false
215
+ sanitize:
216
+ truncatePromptChars: 2000
217
+ batch:
218
+ maxBufferRecords: 20000
123
219
  ```
124
220
 
125
- Then verify the row mounts:
221
+ ## FAQ
126
222
 
127
- ```sh
128
- dsh --profile web --dump-config | grep -A2 'id: dsh-observe'
129
- ```
223
+ <details>
224
+ <summary>会不会把 prompt、工具参数原文发到后端?</summary>
130
225
 
131
- ### Examples
226
+ 不会按原文发出。每条记录在入队之前就完成三层脱敏:结构性键名(key/token/secret/password/authorization/credential/apiKey 恒在名单内,可用 `sanitize.redactKeys` 追加子串)、内置密钥模式(API key、GitHub token、AWS key、bearer 凭据、私钥)加 `sanitize.redactPatterns` 自定义正则、以及字符预算截断(prompt/completion 各 4000、工具参数与结果各 2000、span 属性 512)。只想要体积不想要正文时,把 `llm.prompt` 与 `llm.completion` 设为 `false`,记录里只剩大小与计数。
227
+
228
+ </details>
132
229
 
133
- No user-facing command is registered; this plugin runs as a background exporter, configured through its settings.
230
+ <details>
231
+ <summary>后端挂了、网络断了会丢数据吗?</summary>
134
232
 
135
- ## Configuration
233
+ 普通 span 与指标走「重试 → 溢出到离线缓冲」这条链:批次失败按 `retry.maxAttempts`(默认 5 次)与 `retry.baseDelayMs × retry.factor` 的确定性指数退避重试,重试耗尽或内存队列超过 `batch.maxQueueRecords` 时溢出到有界持久 spool(`batch.maxBufferRecords` 默认 10000,最旧优先淘汰),并有 `batch.bufferRetryIntervalMs` 的周期性回灌,重启后未送达批次仍在。OTLP metrics 是例外:它按累计聚合,丢一次 flush 会在下一次自愈。
136
234
 
137
- All tunables are Schemastery `Config` fields (changeable from cordis.yml). An id-targeted override replaces the whole row — restate every key you need. `cordis.patch.yml` documents each key inline.
235
+ </details>
138
236
 
139
- | Key | Default | Meaning |
140
- |---|---|---|
141
- | `enabled` | `false` | Master switch; `true` plus at least one backend is the explicit opt-in |
142
- | `otlp` | `null` | OTLP backend config, or `null` to disable it |
143
- | `otlp.endpoint` | *(required)* | OTLP base URL; `/v1/traces` and `/v1/metrics` are appended |
144
- | `otlp.serviceName` | `deepseek-harness` | `service.name` resource attribute |
145
- | `otlp.serviceVersion` | *(none)* | `service.version` resource attribute |
146
- | `otlp.headers` | `{}` | Extra headers merged into every export request |
147
- | `otlp.timeoutMs` | `10000` | Per-request timeout |
148
- | `langfuse` | `null` | Langfuse backend config, or `null` to disable it |
149
- | `langfuse.baseUrl` | `https://cloud.langfuse.com` | Langfuse base URL |
150
- | `langfuse.publicKey` | *(required)* | Project public key |
151
- | `langfuse.secretKey` | *(required)* | Project secret key |
152
- | `langfuse.release` | *(none)* | Release tag stamped onto traces |
153
- | `langfuse.traceName` | `session {session} turn {turn}` | Trace-name template; `{session}`/`{turn}` interpolate per trace |
154
- | `langfuse.tags` | `[]` | Static tags stamped onto every trace |
155
- | `langfuse.timeoutMs` | `10000` | Per-request timeout |
156
- | `capture.turns` | `true` | Turn lifecycle spans |
157
- | `capture.steps` | `true` | Step lifecycle spans |
158
- | `capture.tools` | `true` | Tool-call spans with sanitized arguments/results |
159
- | `capture.llm` | `true` | LLM generation spans |
160
- | `llm.prompt` | `true` | Capture the sanitized request prompt (`false` = sizes only) |
161
- | `llm.completion` | `true` | Capture the sanitized completion (`false` = sizes only) |
162
- | `metadata.sessionId` | `true` | Session id attribute |
163
- | `metadata.cwd` | `false` | Session working directory (a local path — off by default) |
164
- | `metadata.agentPreset` | `true` | Agent preset id attribute |
165
- | `metadata.model` | `true` | Provider/model attributes |
166
- | `metrics.tokens` | `true` | Per-provider/model token counters |
167
- | `metrics.cost` | `true` | USD cost counters (need `pricing` rules to match) |
168
- | `metrics.contextTokens` | `true` | Context-pressure gauge (needs `ctx.tokenMeter`) |
169
- | `pricing` | `[]` | Pricing table, first match wins: `{ provider?, model, inputPerToken, outputPerToken, cacheReadPerToken?, cacheWritePerToken? }` |
170
- | `sanitize.enabled` | `true` | Redaction master switch (`false` disables redaction, never truncation) |
171
- | `sanitize.redactKeys` | `[]` | Extra key-name substrings (key/token/secret/password/authorization/credential/apiKey are always included) |
172
- | `sanitize.redactPatterns` | `[]` | Extra secret regular expressions |
173
- | `sanitize.truncatePromptChars` | `4000` | Prompt character budget |
174
- | `sanitize.truncateCompletionChars` | `4000` | Completion character budget |
175
- | `sanitize.truncateToolInputChars` | `2000` | Tool argument character budget |
176
- | `sanitize.truncateToolOutputChars` | `2000` | Tool result character budget |
177
- | `sanitize.truncateAttributeChars` | `512` | Span attribute string budget |
178
- | `batch.maxRecords` | `256` | Flush once the queue holds this many records |
179
- | `batch.flushIntervalMs` | `5000` | Timer flush interval |
180
- | `batch.maxQueueRecords` | `2000` | In-memory queue bound; excess spills to the buffer |
181
- | `batch.maxBufferRecords` | `10000` | Durable offline buffer bound; oldest records drop first |
182
- | `batch.bufferRetryIntervalMs` | `30000` | Offline buffer retry interval |
183
- | `retry.maxAttempts` | `5` | Attempts per batch, including the first try |
184
- | `retry.baseDelayMs` | `1000` | First backoff delay |
185
- | `retry.factor` | `2` | Backoff multiplier per consecutive failure |
186
- | `retry.maxDelayMs` | `60000` | Backoff ceiling |
187
- | `remote.enabled` | `false` | Mount the `observe` Typert remote (kill switch) |
188
-
189
- ## Tools & surfaces
190
-
191
- This plugin registers **no model tools** — it is a background exporter. Its surfaces:
192
-
193
- - **Consumes** `session/event` (span/metric collection), `session/flush` (best-effort export kick — the durability checkpoint never waits on a remote backend), and `session/disposed`.
194
- - **Optional remote service** `observe` — `observe/status` returns the kill-switch state, configured backends, queue depths, and buffer occupancy; `observe/setEnabled` stops and resumes exporting at runtime.
195
-
196
- ## Permissions & data
197
-
198
- - **Permissions**: `network:outbound` to the endpoints you configure, `session:read` for the event stream, `storage:write` for the offline buffer; no native code, no filesystem access.
199
- - **Data**: everything sent is derived from the session log and sanitized (redaction + truncation) before it is queued, buffered, or transmitted. The offline buffer stores only sanitized records, re-validated when read back.
200
- - **Credentials**: Langfuse public/secret keys travel only to the configured Langfuse endpoint; OTLP headers only to the configured OTLP endpoint. The plugin stores no credentials itself — keep them in credential references or environment-injected values.
201
-
202
- ## Security boundaries
203
-
204
- - **Off by default** — nothing is captured or exported unless you opt in explicitly.
205
- - **Sanitize before send** — structural key redaction, built-in secret patterns (API keys, GitHub tokens, AWS keys, bearer credentials, private keys), your patterns, and character budgets all apply before any record leaves memory.
206
- - **Durable boundary re-validation** — records read back from storage are checked again before a sink can see them.
207
- - **Failure loud, failure contained** — export failures warn, count, retry, and finally spool; a failing session handler is caught and logged so observability can never break the harness hot path.
208
- - **Model-visible ⟺ logged** — prompt/completion exports project only the session surface (whose node 0 is the system prompt) and the logged header (call config and tools); the exporter invents no content.
209
-
210
- ## Known limitations
211
-
212
- - **npm 0.1.7-rc.2** — the plugin is developed and tested against `@deepseek-ai/dsh@0.1.7-rc.2` (devDeps and CI's primary ruler); the peer range `>=0.1.2-rc.1 <0.2.0 || >=0.1.5-alpha.1 <0.2.0 || >=0.1.6-0 <0.2.0 || >=0.1.7-0 <0.2.0` keeps every published line installable, and the second ruler (`typecheck:ci`) plus the compat workflow cover the older baselines.
213
- - **Audit events are not persisted** — the exporter's own `observe/*` records are audit-only: on the current host line the session append gate admits surface events, so no `observe/*` event is written to the session log, and the plugin does not fake one with an unmarked append (that would make sessions unreadable). Treat `/observe` status output and the OTLP/Langfuse backends as the audit surface.
214
- - **Metrics bypass the retry/spool path** — OTLP metrics are aggregated cumulatively, so a lost flush self-heals on the next one (by design, not a bug).
215
- - **No sampling** — every enabled span family is exported; set `capture.*` switches and `batch.maxBufferRecords` for high-volume sessions.
216
-
217
- ## Development
237
+ <details>
238
+ <summary>插件自己存了什么?凭据放在哪?</summary>
239
+
240
+ 离线缓冲里只有已脱敏的记录,且从存储读回时会再校验一次才交给 sink。插件本身不存任何凭据:Langfuse 公钥/密钥只出现在发往你配置的 Langfuse 端点的请求里,OTLP 请求头同理只发往你配置的 OTLP 端点——请用凭据引用或环境注入,不要写进 profile patch 提交。它只读会话事件流,从不读取或改写会话日志文件。
241
+
242
+ </details>
243
+
244
+ <details>
245
+ <summary>会不会拖慢会话?</summary>
246
+
247
+ 采集与脱敏都在事件处理里同步完成,但发送全部是异步的:队列按数量或定时 flush,`session/flush` 只是一次尽力而为的 kick——持久化检查点绝不等待远端后端。导出失败会告警、计数(`observe.export_failures`)、重试,最后进缓冲;会话事件处理器本身抛错会被捕获并记录,可观测性不会拖垮 harness 热路径。
248
+
249
+ </details>
250
+
251
+ <details>
252
+ <summary>会和别的插件抢服务、事件或 slot 吗?</summary>
253
+
254
+ 只注入一个服务键 `storageDomain`,只监听三个 `session/*` 事件,不注册模型工具、不注册命令、不注册 client slot、不监听任何 waterfall,也不改全局对象。唯一需要留意的命名面是可选 remote 服务 `observe`(`remote.enabled` 默认关闭)——同一 profile 里若已有别的插件占用同名服务,只开其中一个。
255
+
256
+ </details>
257
+
258
+ ## 安全边界
259
+
260
+ - **默认关闭** —— 不显式开启(`enabled: true` 且至少一个后端)则不采集、不导出。
261
+ - **发送前脱敏** —— 结构性键名脱敏、内置密钥模式(API key、GitHub token、AWS key、bearer 凭据、私钥)、自定义模式与字符预算,全部在任何记录离开内存前生效。
262
+ - **持久边界再校验** —— 从存储读回的记录在到达 sink 前再次检查。
263
+ - **失败大声、失败隔离** —— 导出失败会告警、计数、重试并最终入缓冲;会话事件处理失败被捕获并记录,可观测性永远不会拖垮 harness 热路径。
264
+ - **模型可见 ⟺ 已记录** —— prompt/completion 导出只投影会话 surface(其节点 0 即系统提示词)与已记录的 header(调用配置与工具);导出器不发明任何内容。
265
+
266
+ ## 权限与数据
267
+
268
+ - **权限**:对你配置的端点出网(`network:outbound`)、读取事件流(`session:read`)、写离线缓冲(`storage:write`);无原生代码、无文件系统访问。
269
+ - **数据**:所有外发内容都来自会话日志,并在入队、缓冲、发送前完成脱敏(脱敏 + 截断)。离线缓冲只存脱敏记录,读回时再次校验。
270
+ - **凭据**:Langfuse 公钥/密钥只发往你配置的 Langfuse 端点;OTLP 请求头只发往你配置的 OTLP 端点。插件自身不存任何凭据 —— 请使用凭据引用或环境注入。
271
+
272
+ ## 已知限制
273
+
274
+ - **基线 `0.2.2-rc.1`** —— 插件针对 `@deepseek-ai/dsh@0.2.2-rc.1` 开发与测试(devDependencies 与 CI 的主尺子);`engines.dsh` 的 `>=0.2.1-0 <0.3.0 || >=0.2.2-0 <0.3.0` 与 peer 复合范围让每条已发布线都可安装,更旧的基线由第二把尺子(`typecheck:ci`)与 compat 工作流覆盖。
275
+ - **审计事件不落盘** —— 本插件自身的 `observe/*` 记录仅作审计:当前宿主线的会话 append 闸门只接纳 surface 事件,因此不会有 `observe/*` 事件写入会话日志;插件也不会用未标记 append 伪造一条(那会让会话不可读)。审计面请以 `observe/status` 输出(需 `remote.enabled: true`)与 OTLP/Langfuse 后端为准。
276
+ - **Metrics 不走重试/缓冲路径** —— OTLP metrics 按累计聚合,丢失一次 flush 会在下一次自愈(设计如此,非缺陷)。
277
+ - **无采样** —— 每个启用的 span 族都会导出;大流量会话请调整 `capture.*` 开关与 `batch.maxBufferRecords`。
278
+
279
+ ## 与其他 DSH 插件的互操作性
280
+
281
+ 本插件的注册面很窄,因此天然不易与别的插件冲突:
282
+
283
+ - **无工具名冲突** —— 不注册任何模型工具(README 与 `src/index.ts` 均无工具注册)。
284
+ - **无命令名冲突** —— 不注册用户可见命令,斜杠命令命名空间完全不碰。
285
+ - **无 client slot 冲突** —— 本包不含浏览器半(无 `client/` 目录),不注册任何 client slot。
286
+ - **无 waterfall 短路** —— 只读监听 `session/event`、`session/flush`、`session/disposed`,不监听任何 allow/passthrough 型 waterfall,因此不存在压住别人决策的问题。
287
+ - **唯一的服务键** —— `storageDomain`(注入,不提供);另有一个**可选**的 remote 服务 `observe`,仅在 `remote.enabled: true` 时注册。
288
+ - **出网只去你配置的端点** —— OTLP 与 Langfuse 各自独立,关掉一个不影响另一个。
289
+
290
+ 如果你在同一个 profile 里同时装了别的可观测性插件,注意两点:两者都会消费 `session/event`(Cordis 的广播语义,互相不会饿死),但会产生两份 trace;以及不要同时注册 `observe` 这个 remote 服务名。
291
+
292
+ ## 兼容性
293
+
294
+ | 维度 | 状态 |
295
+ |---|---|
296
+ | Harness | DeepSeek Harness `dsh-v0.2.2-rc.4`(2026-11-18 已适配):会话格式 V4 把工具结果改为 `role: 'tool'` 的一等消息,顶层携带 `toolCallId` + `content` + 可选 `isError` —— V3 的 `tool-result` 内容块已从宿主 `ContentBlockMap` 移除,本插件只读 V4 形状(升级前的 V3 日志仍可经只读兼容路径投影)。会话格式 V3 的其余特征沿用:助手流内嵌到 `assistant/message` / `assistant/attempt`,系统提示词为 surface 节点 0(`system/message`);本插件只消费实时事件流,从不读取会话日志文件。`engines.dsh` 为 `>=0.2.1-0 <0.3.0 \|\| >=0.2.2-0 <0.3.0`,profile 安装冒烟由 compat 工作流覆盖。 |
297
+ | Node | `^22.19.0 \|\| >=24.9.0`,纯 ESM(`"type": "module"`) |
298
+ | 后端 | OpenTelemetry OTLP/HTTP(traces + metrics,JSON 编码)与 Langfuse(LLM 可观测)——二选一或同时 |
299
+ | 模型 | 与模型无关:它导出 session/event 流,自身不调用任何模型 |
300
+
301
+ peer 依赖:`@deepseek-ai/cordis ^4.0.5-alpha.1`、`@deepseek-ai/schemastery ^3.18.5`,以及 `@deepseek-ai/dsh-llm`、`@deepseek-ai/dsh-session`、`@deepseek-ai/dsh-storage`、`@deepseek-ai/dsh-storage-domain`、`@deepseek-ai/dsh-storage-json`、`@deepseek-ai/dsh-typert-protocol`(`>=0.1.2-rc.1 <0.2.0 || >=0.1.5-alpha.1 <0.2.0 || >=0.1.6-0 <0.2.0 || >=0.1.7-0 <0.2.0 || >=0.2.0-0 <0.3.0 || >=0.2.1-0 <0.3.0 || >=0.2.2-0 <0.3.0`;devDependencies 钉 `0.2.2-rc.1`)。`zod` 是唯一的运行时依赖,用于离线缓冲的持久边界校验。
302
+
303
+ ## 生态与质量
304
+
305
+ - [Gitee 镜像](https://gitee.com/perrylink/dsh-observe)(同步镜像,以 GitHub 为准)
306
+ - [dshfind 插件页](https://dshfind.com/plugins/PerryLink/dsh-observe)(安装量与排名)
307
+ - [OpenSSF Scorecard 报告](https://securityscorecards.dev/viewer/?uri=github.com/PerryLink/dsh-observe)(由 [.github/workflows/scorecard.yml](.github/workflows/scorecard.yml) 驱动)
308
+ - [dsh-plugin-doctor 验证报告](https://github.com/PerryLink/dsh-plugin-doctor#verified-徽章)
309
+ - [DSH Market](https://dsh.market/)(已上架)
310
+ - **1024 商店渠道**:先 `npm i -g dsh1024`,再 `dsh1024 plugin --profile web add dsh-observe`(计入 [deepseek1024.com](https://deepseek1024.com) 安装排行)
311
+ - [生态实测知识库](https://perrylink.github.io/dsh-plugin-guide/):插件开发指南 · 选型实测数据 · 维护取舍判据
312
+
313
+ ## 开发
218
314
 
219
315
  ```sh
220
- pnpm install # node ^22.19 || >=24
221
- pnpm run typecheck # tsc: src + tests against the 0.1.7-rc.2 devDeps (no tsconfig paths)
222
- pnpm run typecheck:ci # tsc against the published line (no paths)
223
- pnpm run check:ruler-live # canary: must fail to compile, proving the ruler is live
224
- pnpm test # vitest: 126 tests, 18 suites (real Context/Session/storage seam)
225
- pnpm run test:coverage # coverage gate (90/80/90/90)
226
- pnpm run build # tsdown bundle + tsc declarations (lib/)
227
- pnpm run verify:self-contained # dependency specs resolve from the registry
228
- pnpm run verify:artifacts # built ESM face + bundle patch present
229
- node scripts/check-readme-sync.mjs # five-language README sync gate
230
- pnpm pack # the published tarball
316
+ pnpm install # node ^22.19 || >=24.9
317
+ pnpm run typecheck # tsc:src + tests,对照 0.2.2-rc.1 devDeps(无 tsconfig paths)
318
+ pnpm run typecheck:ci # tsc:对照已发布线(无 paths)
319
+ pnpm run check:ruler-live # canary:必须编译失败,以证明尺子仍是活的(需 checkout 面)
320
+ pnpm test # vitest:126 个测试、18 个套件(真实 Context/Session/storage 接缝)
321
+ pnpm run test:coverage # 覆盖率门禁(90/80/90/90)
322
+ pnpm run build # tsdown bundle + tsc 声明(lib/)
323
+ pnpm run verify:self-contained # 依赖声明全部来自 registry
324
+ pnpm run verify:artifacts # 构建产物 ESM 面 + bundle patch 齐全
325
+ node scripts/check-readme-sync.mjs # 五语 README 同步门
326
+ pnpm pack # 发布用 tarball
231
327
  ```
232
328
 
233
- ## Topics
329
+ 配图由 [`scripts/gen-readme-assets.py`](scripts/gen-readme-assets.py) 程序化生成(Pillow 绘制 1440×576 hero,结构图为手写 1100×660 SVG),输出 `docs/assets/dsh-observe-hero-{zh,en}-{light,dark}.webp` 四张与 `docs/assets/dsh-observe-flow-v5-{light,dark}.svg` 一对,可重复执行。旧的 `docs/assets/dsh-observe-flow-{light,dark}.svg`、`dsh-observe-flow.svg`、`dsh-observe-hero.png` 与 `dsh-observe-demo.{png,gif}` 保留在原处以防外链失效,README 不再引用。
234
330
 
235
- `dsh`, `dsh-plugin`, `deepseek-harness`, `deepseek`, `cordis`, `observability`, `opentelemetry`, `otlp`, `langfuse`, `tracing`
331
+ Topics:`dsh`, `dsh-plugin`, `deepseek-harness`, `deepseek`, `cordis`, `observability`, `opentelemetry`, `otlp`, `langfuse`, `tracing`
236
332
 
237
- ## Contributors
333
+ ## 家族与致谢
238
334
 
239
- - [@PerryLink](https://github.com/PerryLink) — creator and maintainer: collector, pipelines, spool, OTLP/Langfuse sinks, sanitization, and the five-language docs.
335
+ 本项目是 [PerryLink](https://github.com/PerryLink) 维护的 DeepSeek Harness 插件家族成员(全部 Apache-2.0)。如果这个插件帮到了你,**给个 star**——它不解锁任何功能,但会让下一个人更容易找到它。
240
336
 
241
- ## PerryLink DSH Plugin Family
242
-
243
- 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.
337
+ - [@PerryLink](https://github.com/PerryLink) —— 创建者与维护者:collector、pipeline、spool、OTLP/Langfuse sink、脱敏层与五语文档。
244
338
 
245
339
  <details>
246
- <summary>Expand all plugins</summary>
340
+ <summary>展开全部插件</summary>
247
341
 
248
- | Plugin | Status |
342
+ | 插件 | 状态 |
249
343
  |---|---|
250
344
  | **[dsh-aqua-input-check](https://github.com/PerryLink/dsh-aqua-input-check)** | |
251
345
  | **[dsh-archive-check](https://github.com/PerryLink/dsh-archive-check)** | |
252
346
  | **[dsh-auto-review](https://github.com/PerryLink/dsh-auto-review)** | |
253
- | **[dsh-autotier](https://github.com/PerryLink/dsh-autotier)** | 🧊 FROZEN — see the repo README |
347
+ | **[dsh-autotier](https://github.com/PerryLink/dsh-autotier)** | 🧊 已冻结 — 见仓库 README |
254
348
  | **[dsh-bid-ca-precheck](https://github.com/PerryLink/dsh-bid-ca-precheck)** | |
255
349
  | **[dsh-bid-qual-check](https://github.com/PerryLink/dsh-bid-qual-check)** | |
256
- | **[dsh-cert-mcp](https://github.com/PerryLink/dsh-cert-mcp)** | 🧊 FROZEN — see the repo README |
350
+ | **[dsh-cert-mcp](https://github.com/PerryLink/dsh-cert-mcp)** | 🧊 已冻结 — 见仓库 README |
257
351
  | **[dsh-checkpoint-rewind](https://github.com/PerryLink/dsh-checkpoint-rewind)** | |
258
352
  | **[dsh-click](https://github.com/PerryLink/dsh-click)** | |
259
353
  | **[dsh-composer-history](https://github.com/PerryLink/dsh-composer-history)** | |
260
354
  | **[dsh-contract-stance](https://github.com/PerryLink/dsh-contract-stance)** | |
261
355
  | **[dsh-customs-doc-check](https://github.com/PerryLink/dsh-customs-doc-check)** | |
262
- | **[dsh-data-quality](https://github.com/PerryLink/dsh-data-quality)** | |
356
+ | **[dsh-data-quality](https://github.com/PerryLink/dsh-data-quality)** | 🧊 已冻结 — 见仓库 README |
263
357
  | **[dsh-demurrage-ledger](https://github.com/PerryLink/dsh-demurrage-ledger)** | |
264
358
  | **[dsh-doublecheck](https://github.com/PerryLink/dsh-doublecheck)** | |
265
359
  | **[dsh-drill-script-check](https://github.com/PerryLink/dsh-drill-script-check)** | |
@@ -292,7 +386,7 @@ This project is part of the DeepSeek Harness plugin family from [PerryLink](http
292
386
  | **[dsh-mask](https://github.com/PerryLink/dsh-mask)** | |
293
387
  | **[dsh-mcp-panel](https://github.com/PerryLink/dsh-mcp-panel)** | |
294
388
  | **[dsh-medrec-qc](https://github.com/PerryLink/dsh-medrec-qc)** | |
295
- | **[dsh-memento](https://github.com/PerryLink/dsh-memento)** | |
389
+ | **[dsh-memento](https://github.com/PerryLink/dsh-memento)** | 🧊 已冻结 — 见仓库 README |
296
390
  | **[dsh-nsfc-form-check](https://github.com/PerryLink/dsh-nsfc-form-check)** | |
297
391
  | **[dsh-nurse-record-check](https://github.com/PerryLink/dsh-nurse-record-check)** | |
298
392
  | **[dsh-observe](https://github.com/PerryLink/dsh-observe)** | |
@@ -304,10 +398,10 @@ This project is part of the DeepSeek Harness plugin family from [PerryLink](http
304
398
  | **[dsh-permit-report-check](https://github.com/PerryLink/dsh-permit-report-check)** | |
305
399
  | **[dsh-pipeline-check](https://github.com/PerryLink/dsh-pipeline-check)** | |
306
400
  | **[dsh-pleading-draft](https://github.com/PerryLink/dsh-pleading-draft)** | |
307
- | **[dsh-plugin-doctor](https://github.com/PerryLink/dsh-plugin-doctor)** | |
401
+ | **[dsh-plugin-doctor](https://github.com/PerryLink/dsh-plugin-doctor)** | 🚫 已退役(仓库已归档) |
308
402
  | **[dsh-plugin-guide](https://github.com/PerryLink/dsh-plugin-guide)** | |
309
- | **[dsh-plugin-kit](https://github.com/PerryLink/dsh-plugin-kit)** | |
310
- | **[dsh-plugin-upgrade](https://github.com/PerryLink/dsh-plugin-upgrade)** | |
403
+ | **[dsh-plugin-kit](https://github.com/PerryLink/dsh-plugin-kit)** | 🚫 已退役(仓库已归档) |
404
+ | **[dsh-plugin-upgrade](https://github.com/PerryLink/dsh-plugin-upgrade)** | 🚫 已退役(仓库已归档) |
311
405
  | **[dsh-policy-brief-draft](https://github.com/PerryLink/dsh-policy-brief-draft)** | |
312
406
  | **[dsh-power-loss-split](https://github.com/PerryLink/dsh-power-loss-split)** | |
313
407
  | **[dsh-power-ticket-check](https://github.com/PerryLink/dsh-power-ticket-check)** | |
@@ -319,7 +413,7 @@ This project is part of the DeepSeek Harness plugin family from [PerryLink](http
319
413
  | **[dsh-review-reply-check](https://github.com/PerryLink/dsh-review-reply-check)** | |
320
414
  | **[dsh-rulefile-check](https://github.com/PerryLink/dsh-rulefile-check)** | |
321
415
  | **[dsh-safety-brief-check](https://github.com/PerryLink/dsh-safety-brief-check)** | |
322
- | **[dsh-score](https://github.com/PerryLink/dsh-score)** | |
416
+ | **[dsh-score](https://github.com/PerryLink/dsh-score)** | 🧊 已冻结 — 见仓库 README |
323
417
  | **[dsh-session-sync](https://github.com/PerryLink/dsh-session-sync)** | |
324
418
  | **[dsh-site-log-check](https://github.com/PerryLink/dsh-site-log-check)** | |
325
419
  | **[dsh-skill-pack-security](https://github.com/PerryLink/dsh-skill-pack-security)** | |
@@ -331,20 +425,22 @@ This project is part of the DeepSeek Harness plugin family from [PerryLink](http
331
425
  | **[dsh-tender-extract](https://github.com/PerryLink/dsh-tender-extract)** | |
332
426
  | **[dsh-tender-matrix](https://github.com/PerryLink/dsh-tender-matrix)** | |
333
427
  | **[dsh-test-drive](https://github.com/PerryLink/dsh-test-drive)** | |
334
- | **[dsh-ticktick](https://github.com/PerryLink/dsh-ticktick)** | |
428
+ | **[dsh-ticktick](https://github.com/PerryLink/dsh-ticktick)** | 🚫 已退役(仓库已归档) |
335
429
  | **[dsh-translate](https://github.com/PerryLink/dsh-translate)** | |
336
430
  | **[dsh-warranty-calc](https://github.com/PerryLink/dsh-warranty-calc)** | |
337
- | **[dsh-budget](https://github.com/PerryLink/dsh-budget)** | 🧊 FROZEN — see the repo README |
338
- | **[dsh-claude-move](https://github.com/PerryLink/dsh-claude-move)** | 🧊 FROZEN — see the repo README |
339
- | **[dsh-defend](https://github.com/PerryLink/dsh-defend)** | 🧊 FROZEN — see the repo README |
340
- | **[dsh-draw](https://github.com/PerryLink/dsh-draw)** | 🧊 FROZEN — see the repo README |
341
- | **[dsh-reach](https://github.com/PerryLink/dsh-reach)** | 🧊 FROZEN — see the repo README |
342
- | **[dsh-background-agents](https://github.com/PerryLink/dsh-background-agents)** | 🚫 RETIRED — see the repo README |
343
- | **[dsh-session-pin](https://github.com/PerryLink/dsh-session-pin)** | 🚫 RETIRED — see the repo README |
344
- | **[dsh-team-rooms](https://github.com/PerryLink/dsh-team-rooms)** | 🚫 RETIRED — see the repo README |
431
+ | **[dsh-budget](https://github.com/PerryLink/dsh-budget)** | 🧊 已冻结 — 见仓库 README |
432
+ | **[dsh-claude-move](https://github.com/PerryLink/dsh-claude-move)** | 🧊 已冻结 — 见仓库 README |
433
+ | **[dsh-defend](https://github.com/PerryLink/dsh-defend)** | 🧊 已冻结 — 见仓库 README |
434
+ | **[dsh-draw](https://github.com/PerryLink/dsh-draw)** | 🧊 已冻结 — 见仓库 README |
435
+ | **[dsh-reach](https://github.com/PerryLink/dsh-reach)** | 🧊 已冻结 — 见仓库 README |
436
+ | **[dsh-background-agents](https://github.com/PerryLink/dsh-background-agents)** | 🚫 已退役(仓库已归档) |
437
+ | **[dsh-session-pin](https://github.com/PerryLink/dsh-session-pin)** | 🚫 已退役(仓库已归档) |
438
+ | **[dsh-team-rooms](https://github.com/PerryLink/dsh-team-rooms)** | 🚫 已退役(仓库已归档) |
345
439
 
346
440
  </details>
347
441
 
348
442
  ## License
349
443
 
350
- [Apache License 2.0](LICENSE) © 2026 dsh-observe contributors
444
+ [LICENSE](LICENSE)(Apache License 2.0)© 2026 dsh-observe contributors
445
+
446
+ <p align="center"><sub>Apache-2.0 · 社区插件,与 DeepSeek 无关。</sub></p>