dsh-report-html

1. 安装并启动 DeepSeek Harness：npx @deepseek-ai/dsh web
2. 在终端执行上面的安装命令（CLI 会解析插件并核验来源）
3. 用 dsh plugins list 确认已安装，必要时重启 Harness 生效

插件以当前 dsh 进程的权限运行，安装时可能执行代码。请先通读仓库源码与许可证，确认无破坏性命令与越权访问；本站只做索引，不对第三方插件安全性作担保。

事实信息来自公开插件目录快照（2026-10-01），介绍文案由本站再加工。

以下为插件仓库 README 全文（原始内容，由公开目录抓取整理）。

# dsh-report-html — 把数据变成算得准、交得出手的分析报告

[![npm version](https://img.shields.io/npm/v/dsh-report-html)](https://www.npmjs.com/package/dsh-report-html)
[![GitHub release](https://img.shields.io/github/v/release/hccccc01333/dsh-report-html)](https://github.com/hccccc01333/dsh-report-html/releases)
[![license](https://img.shields.io/github/license/hccccc01333/dsh-report-html)](LICENSE)

**🇨🇳 中文** | [🇬🇧 English](README.en.md)

在 [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) 里，把数据变成
**一份算得准、交得出手的分析报告**：模型负责判断和叙事，插件负责计算和渲染——
统计数字由代码计算（不靠模型脑补），报告是自包含的单文件 HTML，可以转 Word/PPT、
批量打包，还能按 cron 定时生成并推到飞书/钉钉。

## 为什么用 dsh-report-html

- **省的是时间，不是「更好看」**：周报月报、经营分析、A/B 实验这类高频重复劳动，
  配一次报表机器人，到点自动出报告。
- **数字算得准**：均值/中位数、相关性、离群点、Welch t 检验 p 值、达成率、
  环比/同比/月同比/季同比、排名变动，全部由经过单元测试的代码计算。
- **交付物完整**：12 种图表（含中国地图、箱线图、雷达图）、可排序筛选的表格、
  KPI 卡片、下钻明细、主题切换、打印 PDF——单文件离线可开。
- **接入办公链路**：数据来自 CSV / Excel / JSON / PostgreSQL / MySQL / SQLite，
  输出 HTML / Word / PPT / zip 批量包，推送到飞书/钉钉 webhook。
- **中英文双语**：KPI、图表标题、章节、洞察文案随 `language: auto | zh | en` 切换。

## 安装

```sh
dsh plugin --profile web add dsh-report-html   # 从 npm 安装
dsh plugin --profile web add github:hccccc01333/dsh-report-html   # 或从 GitHub
```

## 快速上手

给模型一行话，它就会调用插件：

```text
分析这些数据并写报告到 D:\reports\sales.html：
[{"month": "2026-01", "channel": "Online", "revenue": 120000}, ...]
```

```text
把这几个 CSV 做成批量报告 zip 放到 D:\reports\batch.zip
```

```text
对比 control 和 variant 两组 revenue 的差异是否显著，出 A/B 报告
```

## 工具一览

| 工具 | 做什么 |
| --- | --- |
| `report_html` | 把 Markdown/表格/图表数据渲染成自包含 HTML（或 Word/PPT） |
| `report_analysis` | 自动分析一份数据：指标、图表、洞察、达成率/环比/同比/排名/数据校验 |
| `report_batch_analysis` | 多份数据一次分析，打包成 zip（含索引页） |
| `report_compare` | 两组 A/B 对比：均值差、lift%、Welch t 检验 p 值、类别拆分 |
| `report_sql` | 只读 SQL（PostgreSQL/MySQL/SQLite）→ 完整分析流水线 → 报告 |

通用参数：`template`（analysis/executive/weekly/teaching）、`language`（auto/zh/en）、
`goal`（目标列，算达成率）、`topN`（排名深度）、`source`（数据来源说明）、
`format`（html/docx/pptx）、`webhook`（生成后推送摘要）。服务端数据库密码从
`DSH_DB_PASSWORD` 环境变量读取，不进工具参数。

## 自动报表机器人

包内自带 CLI：一份 JSON 任务文件，把「查数 → 分析 → 出报告 → 推送」串成定时任务。

```json
{
  "jobs": [
    {
      "name": "daily-sales",
      "schedule": "0 9 * * 1-5",
      "output": "D:/reports/daily-sales.html",
      "connection": { "engine": "sqlite", "file": "D:/data/sales.db" },
      "query": "SELECT month, channel, revenue, target FROM sales",
      "template": "weekly",
      "language": "zh",
      "goal": "target",
      "source": "sales.db",
      "webhook": "https://open.feishu.cn/open-apis/bot/v2/hook/your-token"
    }
  ]
}
```

```sh
dsh-report-html run jobs.json           # 常驻调度，到点自动跑
dsh-report-html run jobs.json --once    # 立即全部跑一次（给 CI/外部调度用）
```

完整示例见 [examples/jobs.example.json](examples/jobs.example.json)。

## 报告能力

- **模板**：`analysis`（完整摘要）/ `executive`（摘要 + 建议）/ `weekly`（周报，带周环比）/
  `teaching`（讲解 + 练习）
- **指标**：目标达成率、环比、同比、月同比、季同比、类别排名（含排位变化）、
  数据质量校验（重复行/缺失/高缺失列）、Welch t 检验
- **图表**：bar / line / area / pie / scatter / heatmap / 中国地图 / flow / funnel /
  gauge / box / radar，全部支持下钻与全屏
- **数据入口**：JSON 数组、CSV、Excel (.xlsx)、本地文件、PostgreSQL、MySQL、SQLite
- **交付**：HTML（自包含）、Word、PPT、zip 批量包、飞书/钉钉 webhook 推送

## 与 dsh-report-card 联动

[dsh-report-card](https://github.com/hccccc01333/dsh-report-card) 是宿主端的
`card: 'report'` 渲染协议：构建在该 fork 之上的 DeepSeek Harness 会把插件生成的
报告 HTML 直接内联渲染在对话里（沙箱 iframe），批量 zip 则以多标签卡片展示；
标准宿主自动回退为通用结果卡片。插件只输出协议载荷，不依赖宿主端。

## 示例画廊

真实工具生成的示例报告已提交，可直接打开：

- [showcase-report.html](examples/showcase-report.html) — 全部 12 种图表 + KPI/TOC/公式/下钻
- [analysis-report.html](examples/analysis-report.html) / [executive-report.html](examples/executive-report.html) /
  [weekly-report.html](examples/weekly-report.html) / [teaching-report.html](examples/teaching-report.html) — 四套模板
- [compare-report.html](examples/compare-report.html) — A/B 对比
- [batch.zip](examples/batch.zip) — 批量报告

## 开发

```sh
pnpm install --ignore-workspace
pnpm --ignore-workspace test              # 单元测试
pnpm --ignore-workspace test:coverage     # 覆盖率门槛（90/95/70）
pnpm --ignore-workspace test:snapshot     # 全文档渲染快照
pnpm --ignore-workspace lint / jsdoc / design:lint
pnpm --ignore-workspace examples          # 重新生成示例画廊
```

## 版本

从 1.0.0 起遵循语义化版本：工具名、必填参数、输出字段与文档化 API 是兼容面；
渲染字节不承诺（视觉优化属于 minor）。发布由 git tag 触发 CI 全自动完成。

## License

MIT