dsh-plugin-daily-report 1.0.1 → 1.0.3

package/README.md

@@ -8,15 +8,19 @@
 - **本地文档**：支持单个文件或目录；目录递归扫描 `.md`、`.markdown`、`.mdx`、`.txt`、`.text`、`.log`、`.docx`、`.html`、`.htm`。自动跳过 `.git`、`node_modules`、`dist`、`build` 等目录。
 - **按天归集**：Git 按提交作者时间归入日期；文档优先取文件名中的日期，其次取文档内 `date:` / `日期:` 字段，最后使用文件修改时间。
 - **时间范围**：默认当月月初到月底，可在页面中改为任意范围（最长 366 天）。
-- **仅统计我的提交（默认开启）**：按每个仓库的 `git config user.email` / `user.name` 过滤，个人日报不会混入同事提交；可随时关闭。
-- **AI 分析（默认启用）**：使用当前默认模型，结合提交说明、代码 diff 片段和文档摘要，按天生成简要总结；结果写入「日报汇总」的 AI 分析列和独立的「AI分析」工作表。可按天编辑、重新分析单日，也可关闭。
+- **仅统计我的提交（默认开启）**：按每个仓库的 `git config user.email` / `user.name` 过滤；可手动填写一个或多个作者邮箱，默认排除 merge commit。
+- **AI 分析（默认启用）**：使用当前默认模型，结合提交说明、代码 diff 片段和文档摘要，按天生成简要总结；支持简洁/详细/管理汇报三种风格，可选择模型。结果写入「日报汇总」的 AI 分析列和独立的「AI分析」工作表。
 - **AI 增量缓存**：按“模型 + 日期 + 提交/diff/文档内容”缓存每日分析结果，只重新分析新增或变化的日期；缓存命中会在进度和结果中显示。缓存文件为 `$DSH_HOME/daily-report/ai-cache.json`。
 - **生成结果预览**：生成后先进入预览页，可编辑总体总结、每日 AI 摘要，添加手动工作项，确认后再导出 XLSX；支持对单日重新调用模型分析。每日条目默认折叠，可单日展开或使用「全部展开/全部收起」。
 - **手动补充工作项**：会议、沟通、线上支持等非代码工作可按天补充，导出时进入「手动补充」列。
-- **从目录批量添加仓库**：在 Git 仓库卡片点击「扫描目录」，选择或输入目录后自动识别最多 6 层内的 Git 仓库，读取当前分支并批量加入；已存在的仓库会自动跳过。
+- **统一数据源配置**：Git 仓库和本地文档归入「数据源配置」卡片，通过「Git 仓库 / 本地文档」页签切换；测试数据源也在这里统一操作。
+- **从目录批量添加仓库**：在 Git 仓库页签点击「扫描目录」，选择或输入目录后自动识别最多 6 层内的 Git 仓库，读取当前分支并批量加入；已存在的仓库会自动跳过。
 - **设置持久化**：Git 仓库、文档、AI 分析、仅统计我的提交和日期范围都会保存到 `settings.json`，下次打开页面保持一致；修改后会自动保存，也可以点击右上角「保存设置」立即保存。
-- **生成进度**：生成任务异步执行，页面实时显示当前阶段、百分比和 AI 已接收字数；AI 分析阶段使用不确定进度条，避免长时间无反馈。
+- **生成进度**：生成任务异步执行，页面实时显示当前阶段、百分比和 AI 已接收字数；支持取消和失败重试。
+- **数据源测试**：一键测试当前 Git/文档源，提前发现路径、分支和权限问题。
+- **自动生成**：可设置每天或每周一固定时间自动生成，结果保存到 `$DSH_HOME/daily-report/history`。自动生成在 DSH 运行期间执行，启动后会补跑当天尚未执行的任务。
 - **XLSX 输出**：工作簿包含【日报汇总】【AI分析】（启用时）【Git明细】【文档明细】【数据源】【说明】工作表，带表头样式、冻结窗格、筛选和列宽。日报汇总冻结日期/星期/日类型三列，Git 明细冻结日期/仓库/分支，左右滚动时保持可见。
+- **多格式导出**：右上角「生成日报」支持下拉选择 XLSX、Markdown、CSV、HTML，默认 XLSX；所选格式会保存到 `settings.json`，预览页的导出按钮会跟随格式变化。
 - **独立页面**：左侧全局菜单新增「日报汇总」入口，点击后在中栏打开独立页面，不依附于任何会话。
 - **两种入口**：左侧「日报汇总」页面；同时注册 `daily_report` Agent 工具，便于在对话中直接生成。
 
@@ -54,10 +58,10 @@ plugin_manager
 1. 点击左侧菜单底部的「日报汇总」图标，在中栏打开独立页面。
 2. 添加 Git 仓库：填写远程地址或本地路径，分支留空时使用默认分支；也可以点击「扫描目录」，指定一个包含多个仓库的目录，批量识别其中的仓库和当前分支。
 3. 添加本地文档：填写文件或目录的绝对路径。
-4. 选择日期范围（默认当月），按需勾选「启用 AI 分析」（默认已勾选），点击页面右上角的「生成 XLSX 日报」。
+4. 选择日期范围（默认当月，也可用「昨天」「本周」等快捷按钮），按需勾选「启用 AI 分析」，在右上角「生成日报」下拉中选择格式；选择格式会立即生成，直接点击主按钮则按当前格式生成。
 5. 生成完成后先在预览区检查：编辑总体/每日 AI 摘要、对某天重新分析、补充手动工作项，确认后点击「导出 XLSX」下载。
 
-Git 仓库、文档、AI 分析开关、作者过滤和日期范围会自动保存在 `$DSH_HOME/daily-report/settings.json`，跨会话与重启有效。
+Git 仓库、文档、AI 分析开关、作者过滤、格式、日期范围和自动生成设置会自动保存在 `$DSH_HOME/daily-report/settings.json`，跨会话与重启有效。自动生成的历史文件保存在 `$DSH_HOME/daily-report/history`。
 
 ## Agent 工具
 
@@ -70,6 +74,7 @@ Git 仓库、文档、AI 分析开关、作者过滤和日期范围会自动保
 | `docs` | 可选，字符串数组；省略时使用已保存配置 |
 | `outputPath` | 可选，输出路径；省略时写入当前会话工作目录 |
 | `ai` | 可选，布尔值；`true` 时调用当前默认模型分析提交 diff 与文档摘要 |
+| `format` | 可选，`xlsx` / `markdown` / `csv` / `html`，默认 `xlsx` |
 | `locale` | `zh` / `en` |
 
 ## 结构
@@ -81,6 +86,7 @@ Git 仓库、文档、AI 分析开关、作者过滤和日期范围会自动保
 | `lib/collect.js` | Git 日志、作者过滤、文档扫描、按天归集、仓库目录扫描 |
 | `lib/ai.js` | AI 提示词、按天分析、增量缓存、单日重新分析 |
 | `lib/report.js` | XLSX 工作表内容与样式 |
+| `lib/formats.js` | Markdown、CSV、HTML 日报渲染 |
 | `lib/xlsx.js` | 无第三方依赖的 XLSX（ZIP + SpreadsheetML）写入器 |
 | `cordis.patch.yml` | 插入 `daily-report` 插件行 |
 | `locale/*.json` | 插件管理器展示文案 |