# dsh-flomo-report

生成 DeepSeek Harness 会话报告（日报/周报/月报/任意日期区间），并一键同步到 **flomo（浮墨笔记）**。

[English README](./README.md)

## 功能特性

- **会话报告** — 汇总 `~/.dsh/sessions` 中任意日期区间的全部会话（活跃会话、用户/助手消息、工具调用、Token 用量、常用工具、逐会话明细），并调用当前默认模型生成 AI 叙事摘要（今日数据 / 今日主线 / 今日回顾 / 明日建议）。
- **flomo 同步** — 通过 flomo 传入 Webhook 把报告直接写入 flomo，遵守两条已确认的规则：
  - 使用**一个可配置标签**，默认 `#write/dsh`（你已有的标签，插件绝不新建标签）；
  - 发送前**自动去除正文中所有 `#` 号**。
- **Web 可视化面板** — 设置页新增「Flomo Report」面板：日期区间 + 生成/同步、标签、去 # 开关、API URL（留空自动复用 dsh-flomo 插件的 `~/.dsh/dsh-flomo.json`）、生成时自动同步、**报告文件自定义保存目录**（点「选择文件夹」弹出系统目录选择器，或直接手填路径）、每日定时提醒（时刻 + 报告范围），并实时预览将发送到 flomo 的内容。
- **报告文件** — 每次生成的报告都会以 `日报-YYYY-MM-DD.md` 写入配置的目录（默认 `~/.dsh/dsh-flomo-report/reports/`）。
- **每日定时提醒** — 开启后每天到点自动生成上一日（或当日）报告，同步 flomo、保存到 `~/.dsh/dsh-flomo-report/reports/`，并弹出系统通知（macOS 通知中心 / Linux notify-send）。

## 工具

| 工具 | 说明 |
|---|---|
| `flomo_report` | 生成 `[startDate, endDate]`（默认今天）的会话报告，并可选同步 flomo（默认取 syncOnGenerate 配置）。 |
| `flomo_report_config` | 查看/修改同步与定时配置（tag、stripHash、webhookUrl、syncOnGenerate、language、narrate、reminder）。 |
| `flomo_report_test` | 发送一条测试笔记，验证 webhook 连通性与标签配置。 |

## 配置

持久化于 `~/.dsh/dsh-flomo-report.json`（权限 0600）：

```jsonc
{
  "language": "zh",            // zh | en
  "narrate": true,             // AI 叙事摘要
  "tag": "write/dsh",          // flomo 标签，不带 # 前缀
  "stripHash": true,           // 同步时自动去除正文所有 # 号
  "webhookUrl": "",            // flomo API URL；留空复用 dsh-flomo 配置
  "syncOnGenerate": true,      // 生成报告时自动同步
  "reportDir": "",             // 报告文件保存目录；留空用默认 ~/.dsh/dsh-flomo-report/reports
  "reminder": {                // 每日定时提醒
    "enabled": false,
    "hour": 22,
    "minute": 0,
    "range": "previous"        // previous 上一日 | current 当日
  }
}
```

## 安装

```bash
# 本地开发（link）
dsh plugin --profile web add link:/path/to/dsh-flomo-report

# 从 GitHub 安装（仓库需打上 dsh-plugin 话题标签）
dsh plugin --profile web add github:zhengjy01/dsh-flomo-report
```

## 许可证

MIT