dsh-local-telemetry 0.1.0 → 0.1.1

package/CHANGELOG.md

@@ -2,6 +2,14 @@
 
 本项目遵循 [语义化版本](https://semver.org/lang/zh-CN/) 约定。
 
+## Unreleased
+
+## 0.1.1 - 2026-09-06
+
+- 新增固定 `@deepseek-ai/dsh@0.1.2-rc.1` 的 `npm run test:compat` 门禁及 Windows/Ubuntu Node 22.19 CI，覆盖隔离 profile 的 add、配置 dump 和有限时长启动。
+- 文档明确三层兼容性：JSONL/纯 CLI Node >=18、SQLite Node >=22.5、最新 DSH 宿主验证 Node >=22.19。
+- 修复插件入口遗漏 `skills` 服务注入声明的问题，确保 DSH 启动时实际注册 telemetry runbook，而不是静默降级。
+
 ## 0.1.0 - 2026-09-02
 
 - 首个公开发布版本。
@@ -79,4 +87,3 @@
 - Phase 2 验收：摘要可由原始事件重算。
 
 - Phase 5 验收：JSONL 与 SQLite 对同一事件集产生一致聚合结果。
-

package/DSH-TELEMETRY-/345/274/200/345/217/221/350/256/241/345/210/222.md

@@ -85,7 +85,7 @@
 
 - **宿主 Hook 能力**：DSH Harness 的生命周期 Hook（`request.started` / `model.completed` / …）当前无法确认其真实暴露面。按计划 §2 的降级路径，已实现独立事件记录器与显式适配器接口（`src/adapter.mjs`），只接入已确认存在的生命周期事件。缺失指标返回 `null` / `unavailable`，不伪造。
 
-- **技术栈选择**：零构建 ESM 模块；JSONL 后端零依赖；SQLite 后端使用 Node ≥22.5 内置 `node:sqlite`（零 npm 依赖），Node 18/20 优雅降级为不可用。
+- **技术栈选择**：零构建 ESM 模块；JSONL 和纯 CLI 能力独立支持 Node ≥18；SQLite 后端使用 Node ≥22.5 内置 `node:sqlite`（零 npm 依赖）；作为 DSH 0.1.2-rc.1 宿主统一按 Node ≥22.19 验证。
 
 - **事件契约**：12 种生命周期事件（`request.started` / `model.completed` / `tool.completed` 等）已定义；失败/超时/取消通过 `result.status` 表达，无独立 `tool.failed` 事件名。`src/schema.mjs` 提供校验与序列化，未知指标为 null 不补 0。
 
@@ -123,7 +123,7 @@
 
 ### 0.5 与参考项目对齐
 
-- 与 `dsh-repo-scanner` 对齐：package.json `dsh.bundle.patch` + cordis.patch.yml `- insert:` 格式 + FileSystemSkillProvider 模式 + CI 矩阵（ubuntu/windows × node 18/20/22）。
+- 与 `dsh-repo-scanner` 对齐：package.json `dsh.bundle.patch` + cordis.patch.yml `- insert:` 格式 + FileSystemSkillProvider 模式；Node 18/20/22 仅为独立脚本回归，另有 DSH 0.1.2-rc.1 / Node 22.19 compat 门禁。
 
 - 测试框架：使用 `node:test`；契约测试、隐私测试、性能测试、跨平台测试覆盖。
 
@@ -208,17 +208,17 @@ Make Harness behavior measurable without collecting sensitive conversation conte
 在实现前必须确认 DSH Harness 实际暴露的生命周期接口。目标事件：
 
 ```text
-request.started
-request.context
-model.requested
-model.first_token
-model.completed
-model.failed
-tool.started
- tool.completed
-plugin.started
-plugin.completed
-request.completed
+request.started
+request.context
+model.requested
+model.first_token
+model.completed
+model.failed
+tool.started
+ tool.completed
+plugin.started
+plugin.completed
+request.completed
 request.cancelled
 ```
 
@@ -232,9 +232,9 @@ request.cancelled
 建议适配接口：
 
 ```ts
-interface HarnessTelemetryAdapter {
-  on(event: string, handler: (event: TelemetryEvent) => void): () => void;
-  getCapabilities(): TelemetryCapabilities;
+interface HarnessTelemetryAdapter {
+  on(event: string, handler: (event: TelemetryEvent) => void): () => void;
+  getCapabilities(): TelemetryCapabilities;
 }
 ```
 
@@ -257,49 +257,49 @@ interface HarnessTelemetryAdapter {
 一个请求的结构：
 
 ```text
-request span
-├── plugin span
-├── model attempt span
-│   ├── tool span
-│   └── tool span
+request span
+├── plugin span
+├── model attempt span
+│   ├── tool span
+│   └── tool span
 └── retry model attempt span
 ```
 
 ### 3.2 最小事件结构
 
 ```json
-{
-  "schema_version": "1.0",
-  "event": "model.completed",
-  "event_id": "evt-001",
-  "trace_id": "trace-001",
-  "span_id": "span-003",
-  "parent_id": "span-001",
-  "timestamp": "2026-08-23T12:00:00.000Z",
-  "duration_ms": 8420,
-  "session": {
-    "profile": "web",
-    "environment": "local"
-  },
-  "model": {
-    "provider": "deepseek",
-    "name": "deepseek-chat",
-    "request_type": "chat"
-  },
-  "usage": {
-    "input_tokens": 4200,
-    "output_tokens": 860,
-    "cached_input_tokens": 0,
-    "reasoning_tokens": null
-  },
-  "result": {
-    "status": "success",
-    "finish_reason": "stop"
-  },
-  "privacy": {
-    "content_captured": false,
-    "redactions": 0
-  }
+{
+  "schema_version": "1.0",
+  "event": "model.completed",
+  "event_id": "evt-001",
+  "trace_id": "trace-001",
+  "span_id": "span-003",
+  "parent_id": "span-001",
+  "timestamp": "2026-08-23T12:00:00.000Z",
+  "duration_ms": 8420,
+  "session": {
+    "profile": "web",
+    "environment": "local"
+  },
+  "model": {
+    "provider": "deepseek",
+    "name": "deepseek-chat",
+    "request_type": "chat"
+  },
+  "usage": {
+    "input_tokens": 4200,
+    "output_tokens": 860,
+    "cached_input_tokens": 0,
+    "reasoning_tokens": null
+  },
+  "result": {
+    "status": "success",
+    "finish_reason": "stop"
+  },
+  "privacy": {
+    "content_captured": false,
+    "redactions": 0
+  }
 }
 ```
 
@@ -388,16 +388,16 @@ request span
 价格不能硬编码在业务逻辑中，使用版本化配置：
 
 ```json
-{
-  "currency": "USD",
-  "effective_at": "2026-08-23T00:00:00Z",
-  "models": {
-    "deepseek-chat": {
-      "input_per_million": 0.27,
-      "cached_input_per_million": 0.07,
-      "output_per_million": 1.10
-    }
-  }
+{
+  "currency": "USD",
+  "effective_at": "2026-08-23T00:00:00Z",
+  "models": {
+    "deepseek-chat": {
+      "input_per_million": 0.27,
+      "cached_input_per_million": 0.07,
+      "output_per_million": 1.10
+    }
+  }
 }
 ```
 
@@ -406,8 +406,8 @@ request span
 只有在模型、Token 和价格均可确认时才计算：
 
 ```text
-cost = input_tokens × input_price
-     + cached_input_tokens × cached_input_price
+cost = input_tokens × input_price
+     + cached_input_tokens × cached_input_price
      + output_tokens × output_price
 ```
 
@@ -456,12 +456,12 @@ cost = input_tokens × input_price
 脱敏记录只保留数量和规则名，不保存原文：
 
 ```json
-{
-  "privacy": {
-    "content_captured": false,
-    "redactions": 2,
-    "rules": ["authorization", "api_key"]
-  }
+{
+  "privacy": {
+    "content_captured": false,
+    "redactions": 2,
+    "rules": ["authorization", "api_key"]
+  }
 }
 ```
 
@@ -500,11 +500,11 @@ cost = input_tokens × input_price
 默认配置建议：
 
 ```text
-单事件内存：不超过 64 KB
-内存队列：不超过 1000 条
-批量写入：100 条或 1 秒触发
-单事件处理：不超过 5 ms
-本地日志轮转：100 MB
+单事件内存：不超过 64 KB
+内存队列：不超过 1000 条
+批量写入：100 条或 1 秒触发
+单事件处理：不超过 5 ms
+本地日志轮转：100 MB
 默认保留：7 天
 ```
 
@@ -537,10 +537,10 @@ cost = input_tokens × input_price
 CLI：
 
 ```bash
-node scripts/telemetry.mjs --status
-node scripts/telemetry.mjs --summary --since 1h
-node scripts/telemetry.mjs --trace <trace_id>
-node scripts/telemetry.mjs --export summary.json --since 7d
+node scripts/telemetry.mjs --status
+node scripts/telemetry.mjs --summary --since 1h
+node scripts/telemetry.mjs --trace <trace_id>
+node scripts/telemetry.mjs --export summary.json --since 7d
 node scripts/telemetry.mjs --purge --before 30d
 ```
 
@@ -561,10 +561,10 @@ node scripts/telemetry.mjs --purge --before 30d
 核心接口：
 
 ```ts
-interface TelemetrySink {
-  write(event: TelemetryEvent): Promise<void>;
-  flush(): Promise<void>;
-  close(): Promise<void>;
+interface TelemetrySink {
+  write(event: TelemetryEvent): Promise<void>;
+  flush(): Promise<void>;
+  close(): Promise<void>;
 }
 ```
 
@@ -577,15 +577,15 @@ JSONL 和 SQLite 必须共享同一个事件 schema，不能为不同后端发
 示例：
 
 ```text
-Telemetry summary: last 1h
-Requests        42
-Success         39 (92.9%)
-Errors          3
-P95 latency     12.4s
-Input tokens    182,300
-Output tokens   41,820
-Estimated cost  $0.094
-Tool calls      217
+Telemetry summary: last 1h
+Requests        42
+Success         39 (92.9%)
+Errors          3
+P95 latency     12.4s
+Input tokens    182,300
+Output tokens   41,820
+Estimated cost  $0.094
+Tool calls      217
 Dropped events  0
 ```
 
@@ -596,28 +596,28 @@ Dropped events  0
 可选输出 `TELEMETRY-REPORT.md`：
 
 ```markdown
-# Harness 遥测报告
-
-## 1. 时间范围与数据完整性
-
-## 2. 请求和错误概览
-
-## 3. 延迟分布
-
-## 4. Token 与成本
-
-## 5. 模型比较
-
-## 6. 工具与插件耗时
-
-## 7. 慢请求和失败请求
-
-## 8. 缓存、重试和回退
-
-## 9. 数据隐私与丢弃事件
-
-## 附录
-
+# Harness 遥测报告
+
+## 1. 时间范围与数据完整性
+
+## 2. 请求和错误概览
+
+## 3. 延迟分布
+
+## 4. Token 与成本
+
+## 5. 模型比较
+
+## 6. 工具与插件耗时
+
+## 7. 慢请求和失败请求
+
+## 8. 缓存、重试和回退
+
+## 9. 数据隐私与丢弃事件
+
+## 附录
+
 schema、价格配置、采样配置和生成命令。
 ```
 
@@ -642,31 +642,31 @@ schema、价格配置、采样配置和生成命令。
 CLI：
 
 ```bash
-node scripts/telemetry.mjs --status
-node scripts/telemetry.mjs --summary --since 24h --group-by model
-node scripts/telemetry.mjs --trace <trace_id>
-node scripts/telemetry.mjs --export report.json --since 7d
-node scripts/telemetry.mjs --config telemetry.json
+node scripts/telemetry.mjs --status
+node scripts/telemetry.mjs --summary --since 24h --group-by model
+node scripts/telemetry.mjs --trace <trace_id>
+node scripts/telemetry.mjs --export report.json --since 7d
+node scripts/telemetry.mjs --config telemetry.json
 node scripts/telemetry.mjs --purge --before 30d
 ```
 
 参数：
 
 ```text
---store jsonl|sqlite
---path <path>
---since <duration|timestamp>
---until <duration|timestamp>
---profile <name>
---model <name>
---plugin <name>
---event <name>
---group-by model|plugin|tool|profile|day
---format text|json|markdown
---sample-rate N
---errors-only
---slow-over-ms N
---capture-metadata none|safe
+--store jsonl|sqlite
+--path <path>
+--since <duration|timestamp>
+--until <duration|timestamp>
+--profile <name>
+--model <name>
+--plugin <name>
+--event <name>
+--group-by model|plugin|tool|profile|day
+--format text|json|markdown
+--sample-rate N
+--errors-only
+--slow-over-ms N
+--capture-metadata none|safe
 --purge --before <duration>
 ```
 
@@ -689,19 +689,19 @@ DSH 插件名：`dsh-telemetry`，插件入口只负责：
 建议配置文件：
 
 ```json
-{
-  "enabled": true,
-  "store": "jsonl",
-  "path": "~/.dsh/telemetry",
-  "sample_rate": 1,
-  "errors_always_sample": true,
-  "slow_request_ms": 10000,
-  "capture_metadata": "none",
-  "hash_names": false,
-  "retention_days": 7,
-  "max_file_mb": 100,
-  "flush_interval_ms": 1000,
-  "price_catalog": null
+{
+  "enabled": true,
+  "store": "jsonl",
+  "path": "~/.dsh/telemetry",
+  "sample_rate": 1,
+  "errors_always_sample": true,
+  "slow_request_ms": 10000,
+  "capture_metadata": "none",
+  "hash_names": false,
+  "retention_days": 7,
+  "max_file_mb": 100,
+  "flush_interval_ms": 1000,
+  "price_catalog": null
 }
 ```
 
@@ -859,7 +859,7 @@ DSH 插件名：`dsh-telemetry`，插件入口只负责：
 
 - Windows、Ubuntu。
 
-- Node 18、20、22。
+- Node 18、20、22（独立 JSONL/CLI 回归）；SQLite 最低 Node 22.5；DSH 宿主 compat 固定 Node 22.19。
 
 - CRLF、UTF-8 BOM、中文路径。
 
@@ -910,11 +910,11 @@ DSH 插件名：`dsh-telemetry`，插件入口只负责：
 推荐链路：
 
 ```text
-DSH Harness
-  -> dsh-telemetry：记录调用事实
-  -> dsh-change-impact：分析代码变更影响
-  -> dsh-test-insight：规划测试保护
-  -> dsh-refactor-insight：处理长期结构风险
+DSH Harness
+  -> dsh-telemetry：记录调用事实
+  -> dsh-change-impact：分析代码变更影响
+  -> dsh-test-insight：规划测试保护
+  -> dsh-refactor-insight：处理长期结构风险
   -> dsh-data-insight：分析业务数据
 ```
 
@@ -951,4 +951,3 @@ DSH Harness
 - [ ] DSH 插件安装后不改变请求语义。
 
 - [ ] README、schema、配置样例、CHANGELOG 和发布包一致。
-

package/PUBLISHING.md

@@ -8,7 +8,7 @@
 
 ## 发布前检查清单
 
-1. 运行 `npm test`（127/127 全绿）与 `npm run check`（全模块语法检查），确保全部通过。
+1. 运行 `npm test`（128/128 全绿）与 `npm run check`（全模块语法检查），确保全部通过。
 2. 运行 `npm pack --dry-run`，确认包含 `plugin/index.js`、`cordis.patch.yml`、`skills/`、`src/`、`bin/`、`web/`、`docs/`、`examples/`、`README.md`、`CHANGELOG.md`、`LICENSE`、`PUBLISHING.md`、`DSH-TELEMETRY-开发计划.md`。
 3. 版本一致性：`package.json` version、`bin/telemetry.mjs` USAGE 版本号、`src/aggregate.mjs` `tool.version`、`CHANGELOG.md` 发布段、git tag 五处保持一致（manifest 契约测试覆盖前三处）。
 
@@ -24,8 +24,8 @@
 
 ### GitHub
 
-1. push `main`，确认 GitHub Actions CI 全绿（Node 18/20/22 × Windows/Ubuntu）。
-2. 打 tag `v0.1.0` 并推送。
+1. push `main`，确认独立 JSONL/CLI 回归 CI 全绿（Node 18/20/22 × Windows/Ubuntu），并确认 Node 22.19 的 DSH compat job 通过。
+2. 打 tag `v0.1.1` 并推送。
 3. 给仓库添加 GitHub topic `dsh-plugin`（awesome 收录门槛之一）。
 
 ### npm

package/README.md

@@ -4,7 +4,7 @@
 [![DeepSeek Harness](https://img.shields.io/badge/DeepSeek%20Harness-plugin-4c1d95)](https://github.com/topics/dsh-plugin)
 [![CI](https://github.com/duyanta123/dsh-telemetry/actions/workflows/ci.yml/badge.svg)](https://github.com/duyanta123/dsh-telemetry/actions/workflows/ci.yml)
 [![npm](https://img.shields.io/badge/npm-dsh--local--telemetry-blue)](https://www.npmjs.com/package/dsh-local-telemetry)
-[![version](https://img.shields.io/badge/version-0.1.0-green)](CHANGELOG.md)
+[![version](https://img.shields.io/badge/version-0.1.1-green)](CHANGELOG.md)
 
 本地优先的 Harness 运行遥测插件：记录请求、模型、工具与插件生命周期指标（延迟、Token、成本、错误、缓存），默认不采集内容。
 
@@ -27,6 +27,22 @@ dsh-telemetry 是 Harness 运行可观测性插件，不负责业务分析，不
 
 > Make Harness behavior measurable without collecting sensitive conversation content by default.
 
+## 界面预览
+
+**一屏总览**——请求、P95 延迟、首 Token 延迟、Token/缓存命中、估算成本（配置价格目录后自动计算）与错误分类，全部指标标注样本数，可由原始事件重算：
+
+![仪表盘总览：KPI 卡片、Token 趋势与错误分类](docs/screenshots/dashboard.png)
+
+**工具与插件耗时**——循环调用 ⚠ 提示、需用户确认的调用计数、插件 hook 错误统计；下方请求时间线以状态点区分成功/失败/取消，重试请求带 ↻ 标记：
+
+![工具耗时、循环提示与插件 Hook 统计](docs/screenshots/tools-plugins.png)
+
+**Trace 详情**——点击任意请求展开 span 树与事件时间线；下图展示 deepseek-reasoner 触发 rate_limit 后回退 deepseek-chat 成功的完整链路（每个 attempt 独立计时）：
+
+![Trace 重试回退链详情](docs/screenshots/trace-fallback.png)
+
+> 以上截图为本地只读 Web UI（`--ui`，仅绑定 127.0.0.1），数据为演示数据集；默认配置下不采集 prompt / response / 文件内容 / 密钥。
+
 ## 安装
 
 作为 DSH 插件（推荐）：
@@ -35,6 +51,8 @@ dsh-telemetry 是 Harness 运行可观测性插件，不负责业务分析，不
 dsh plugin --profile web add "github:duyanta123/dsh-telemetry#main"
 ```
 
+兼容性分层：JSONL 和纯 CLI 能力可独立运行在 Node.js >= 18；SQLite 后端要求 Node.js >= 22.5；作为 DSH 0.1.2-rc.1 插件验证统一使用 Node.js >= 22.19。运行 `npm run test:compat` 可执行隔离 profile 的 add、dump-config 和启动 smoke test。
+
 或从 npm 安装（作为库或独立 CLI 使用）：
 
 ```bash

package/bin/telemetry.mjs

@@ -22,7 +22,7 @@ import { loadPriceCatalog } from "../src/cost.mjs";
 import { renderTextSummary, renderMarkdownReport, renderTraceText, renderGroupedText } from "../src/report.mjs";
 import { createTelemetryServer } from "../src/server.mjs";
 
-const USAGE = `dsh-local-telemetry — 本地 Harness 遥测查询 CLI（v0.1.0）
+const USAGE = `dsh-local-telemetry — 本地 Harness 遥测查询 CLI（v0.1.1）
 
 用法：
   node bin/telemetry.mjs --status

package/package.json

@@ -1,7 +1,11 @@
 {
   "name": "dsh-local-telemetry",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "本地优先的 Harness 运行遥测插件：记录请求、模型、工具与插件生命周期指标（延迟、Token、成本、错误、缓存），默认不采集内容。Local-first Harness telemetry plugin for DeepSeek Harness. npm 包 dsh-local-telemetry（dsh-telemetry 名已被第三方占用）。",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/duyanta123/dsh-telemetry.git"
+  },
   "type": "module",
   "main": "./plugin/index.js",
   "exports": {
@@ -30,6 +34,7 @@
   ],
   "scripts": {
     "test": "node --test test/schema.test.mjs test/config.test.mjs test/privacy.test.mjs test/cost.test.mjs test/sink.test.mjs test/recorder.test.mjs test/store.test.mjs test/aggregate.test.mjs test/cli.test.mjs test/server.test.mjs test/manifest.test.mjs",
+    "test:compat": "node test/dsh-compat.test.mjs",
     "prepublishOnly": "npm test",
     "check": "node --check bin/telemetry.mjs && node --check src/index.mjs && node --check src/schema.mjs && node --check src/config.mjs && node --check src/privacy.mjs && node --check src/sampling.mjs && node --check src/cost.mjs && node --check src/sink-jsonl.mjs && node --check src/sink-sqlite.mjs && node --check src/adapter.mjs && node --check src/recorder.mjs && node --check src/store.mjs && node --check src/aggregate.mjs && node --check src/report.mjs && node --check src/server.mjs && node --check plugin/index.js"
   },

package/plugin/index.js

@@ -16,6 +16,7 @@ import { createRequire } from "node:module";
 import { createRecorder } from "../src/recorder.mjs";
 
 export const name = "dsh-local-telemetry";
+export const inject = ["skills"];
 
 const rootDir = join(dirname(fileURLToPath(import.meta.url)), "..");
 const skillsDir = join(rootDir, "skills");

package/src/aggregate.mjs

@@ -453,7 +453,7 @@ export function aggregateEvents(events, { catalog = null, catalogPath = null, ge
   const requestsTotal = requests.length;
   return {
     schema_version: "1.0",
-    tool: { name: "dsh-local-telemetry", version: "0.1.0" },
+    tool: { name: "dsh-local-telemetry", version: "0.1.1" },
     generated_at: generated,
     window,
     data_completeness: {