dsh-plugin-daily-report 1.0.1 → 1.0.2

package/README.md

@@ -17,6 +17,7 @@
 - **设置持久化**：Git 仓库、文档、AI 分析、仅统计我的提交和日期范围都会保存到 `settings.json`，下次打开页面保持一致；修改后会自动保存，也可以点击右上角「保存设置」立即保存。
 - **生成进度**：生成任务异步执行，页面实时显示当前阶段、百分比和 AI 已接收字数；AI 分析阶段使用不确定进度条，避免长时间无反馈。
 - **XLSX 输出**：工作簿包含【日报汇总】【AI分析】（启用时）【Git明细】【文档明细】【数据源】【说明】工作表，带表头样式、冻结窗格、筛选和列宽。日报汇总冻结日期/星期/日类型三列，Git 明细冻结日期/仓库/分支，左右滚动时保持可见。
+- **多格式导出**：右上角「生成日报」支持下拉选择 XLSX、Markdown、CSV、HTML，默认 XLSX；所选格式会保存到 `settings.json`，预览页的导出按钮会跟随格式变化。
 - **独立页面**：左侧全局菜单新增「日报汇总」入口，点击后在中栏打开独立页面，不依附于任何会话。
 - **两种入口**：左侧「日报汇总」页面；同时注册 `daily_report` Agent 工具，便于在对话中直接生成。
 
@@ -54,7 +55,7 @@ plugin_manager
 1. 点击左侧菜单底部的「日报汇总」图标，在中栏打开独立页面。
 2. 添加 Git 仓库：填写远程地址或本地路径，分支留空时使用默认分支；也可以点击「扫描目录」，指定一个包含多个仓库的目录，批量识别其中的仓库和当前分支。
 3. 添加本地文档：填写文件或目录的绝对路径。
-4. 选择日期范围（默认当月），按需勾选「启用 AI 分析」（默认已勾选），点击页面右上角的「生成 XLSX 日报」。
+4. 选择日期范围（默认当月），按需勾选「启用 AI 分析」（默认已勾选），在右上角「生成日报」下拉中选择格式；选择格式会立即生成，直接点击主按钮则按当前格式生成。
 5. 生成完成后先在预览区检查：编辑总体/每日 AI 摘要、对某天重新分析、补充手动工作项，确认后点击「导出 XLSX」下载。
 
 Git 仓库、文档、AI 分析开关、作者过滤和日期范围会自动保存在 `$DSH_HOME/daily-report/settings.json`，跨会话与重启有效。
@@ -70,6 +71,7 @@ Git 仓库、文档、AI 分析开关、作者过滤和日期范围会自动保
 | `docs` | 可选，字符串数组；省略时使用已保存配置 |
 | `outputPath` | 可选，输出路径；省略时写入当前会话工作目录 |
 | `ai` | 可选，布尔值；`true` 时调用当前默认模型分析提交 diff 与文档摘要 |
+| `format` | 可选，`xlsx` / `markdown` / `csv` / `html`，默认 `xlsx` |
 | `locale` | `zh` / `en` |
 
 ## 结构
@@ -81,6 +83,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` | 插件管理器展示文案 |

package/client.js

@@ -63,7 +63,12 @@ window.__ModuleLoader__.load({
       "progress.hint": "AI 分析需要调用模型，耗时通常比普通汇总更长；请保持页面打开。",
       optional: "可选",
       remove: "移除",
-      generate: "生成 XLSX 日报",
+      generate: "生成日报",
+      "format.label": "格式",
+      "format.xlsx": "XLSX 工作簿",
+      "format.markdown": "Markdown 文档",
+      "format.csv": "CSV 表格",
+      "format.html": "HTML 网页",
       generating: "正在收集并生成…",
       "save.saving": "正在保存设置…",
       "save.savingShort": "正在保存…",
@@ -85,7 +90,7 @@ window.__ModuleLoader__.load({
       "result.ai.failed": "AI 分析未完成",
       "preview.title": "生成结果预览",
       "preview.desc": "先检查并编辑每日 AI 摘要、补充非代码工作，再导出 XLSX。",
-      "preview.export": "导出 XLSX",
+      "preview.export": "导出",
       "preview.expandAll": "全部展开",
       "preview.collapseAll": "全部收起",
       "preview.exporting": "正在导出…",
@@ -171,7 +176,12 @@ window.__ModuleLoader__.load({
       "progress.hint": "AI analysis calls a model, so it usually takes longer than a plain digest. Keep this page open.",
       optional: "optional",
       remove: "Remove",
-      generate: "Generate XLSX report",
+      generate: "Generate report",
+      "format.label": "Format",
+      "format.xlsx": "XLSX workbook",
+      "format.markdown": "Markdown document",
+      "format.csv": "CSV table",
+      "format.html": "HTML page",
       generating: "Collecting and generating…",
       "save.saving": "Saving settings…",
       "save.savingShort": "Saving…",
@@ -193,7 +203,7 @@ window.__ModuleLoader__.load({
       "result.ai.failed": "AI analysis did not complete",
       "preview.title": "Review before export",
       "preview.desc": "Check and edit each day's AI summary, add non-code work, then export the XLSX.",
-      "preview.export": "Export XLSX",
+      "preview.export": "Export",
       "preview.expandAll": "Expand all",
       "preview.collapseAll": "Collapse all",
       "preview.exporting": "Exporting…",
@@ -289,7 +299,7 @@ window.__ModuleLoader__.load({
       return { git, docs, mineOnly: source.mineOnly !== false };
     }
 
-    function cleanSettings(settings, aiEnabled, range) {
+    function cleanSettings(settings, aiEnabled, range, format) {
       return {
         git: settings.git
           .map((item) => ({
@@ -306,6 +316,7 @@ window.__ModuleLoader__.load({
           .filter((item) => item.location.length > 0),
         aiEnabled: aiEnabled !== false,
         mineOnly: settings.mineOnly !== false,
+        format: FORMAT_OPTIONS.includes(format) ? format : "xlsx",
         range:
           range && typeof range.start === "string" && typeof range.end === "string"
             ? { start: range.start, end: range.end }
@@ -339,6 +350,23 @@ window.__ModuleLoader__.load({
       }
     }
 
+    const FORMAT_OPTIONS = ["xlsx", "markdown", "csv", "html"];
+
+    function formatLabel(format, t) {
+      if (format === "markdown") return t("format.markdown", "Markdown");
+      if (format === "csv") return t("format.csv", "CSV");
+      if (format === "html") return t("format.html", "HTML");
+      return t("format.xlsx", "XLSX");
+    }
+
+    function formatExtension(format) {
+      return format === "markdown" ? "md" : format;
+    }
+
+    function formatShortLabel(format) {
+      return format === "markdown" ? "Markdown" : format.toUpperCase();
+    }
+
     function useTranslate(ctx) {
       const [, force] = React.useState(0);
       React.useEffect(() => {
@@ -359,8 +387,20 @@ window.__ModuleLoader__.load({
       ".dsdr-hero-copy { flex: 1; min-width: 0; }",
       ".dsdr-hero-action { display: flex; flex: none; flex-direction: column; align-items: flex-end; gap: 5px; margin-left: auto; }",
       ".dsdr-hero-buttons { display: flex; align-items: center; justify-content: flex-end; flex-wrap: wrap; gap: 8px; }",
-      ".dsdr-save-btn { min-height: 38px; }",
-      ".dsdr-generate { min-height: 38px; padding: 9px 18px; font-size: 13px; white-space: nowrap; }",
+      ".dsdr-save-btn { min-height: 38px; background: #3b4046; border-color: #3b4046; color: #ffffff; font-weight: 600; }",
+      ".dsdr-save-btn:hover { background: #292d31; border-color: #292d31; }",
+      ".dsdr-save-btn:disabled { background: #666b70; border-color: #666b70; color: #ffffff; opacity: .8; }",
+      ".dsdr-generate { min-height: 38px; padding: 9px 16px; font-size: 13px; white-space: nowrap; }",
+      ".dsdr-btn-with-icon { display: inline-flex; align-items: center; justify-content: center; gap: 6px; }",
+      ".dsdr-split { position: relative; display: inline-flex; align-items: stretch; }",
+      ".dsdr-split .dsdr-generate { border-radius: 8px 0 0 8px; }",
+      ".dsdr-split-toggle { min-height: 38px; padding: 0 9px; border-radius: 0 8px 8px 0; border-left: 1px solid rgba(255, 255, 255, .32); }",
+      ".dsdr-menu { position: absolute; top: calc(100% + 6px); right: 0; z-index: 30; min-width: 190px; padding: 5px; border: 1px solid var(--dsw-alias-border-l2); border-radius: 10px; background: var(--dsw-alias-bg-overlay); box-shadow: 0 10px 28px rgba(0, 0, 0, .2); }",
+      ".dsdr-menu-title { padding: 5px 8px 4px; color: var(--dsw-alias-label-secondary); font-size: 11px; line-height: 16px; }",
+      ".dsdr-menu-item { display: flex; align-items: center; justify-content: space-between; gap: 8px; width: 100%; padding: 7px 8px; border: 0; border-radius: 7px; background: transparent; color: var(--dsw-alias-label-primary); font: inherit; font-size: 12px; line-height: 18px; text-align: left; cursor: pointer; }",
+      ".dsdr-menu-item:hover { background: var(--dsw-alias-bg-layer-2); }",
+      ".dsdr-menu-item.is-active { background: var(--dsw-alias-bg-layer-2); font-weight: 600; }",
+      ".dsdr-menu-check { width: 14px; color: #146b5a; text-align: center; }",
       ".dsdr-save { color: var(--dsw-alias-label-secondary); font-size: 11px; line-height: 16px; }",
       ".dsdr-mark { flex: none; width: 42px; height: 42px; border-radius: 11px; display: grid; place-items: center; background: var(--dsw-alias-bg-layer-2); border: 1px solid var(--dsw-alias-border-l1); }",
       ".dsdr-title { margin: 0; font-size: 22px; line-height: 30px; font-weight: 600; }",
@@ -380,9 +420,9 @@ window.__ModuleLoader__.load({
       ".dsdr-btn:hover { background: var(--dsw-alias-bg-layer-1); border-color: var(--dsw-alias-brand-primary); }",
       ".dsdr-btn:focus-visible { outline: 2px solid var(--dsw-alias-brand-primary); outline-offset: 1px; }",
       ".dsdr-btn:disabled { opacity: .7; cursor: not-allowed; }",
-      ".dsdr-btn-primary { background: #15557f; border-color: #15557f; color: #ffffff; font-weight: 600; box-shadow: 0 2px 6px rgba(0, 0, 0, .18); }",
-      ".dsdr-btn-primary:hover { background: #103f5f; border-color: #103f5f; opacity: 1; }",
-      ".dsdr-btn-primary:disabled { background: #5e7c8f; border-color: #5e7c8f; color: #ffffff; opacity: .8; }",
+      ".dsdr-btn-primary { background: #146b5a; border-color: #146b5a; color: #ffffff; font-weight: 600; box-shadow: 0 2px 6px rgba(0, 0, 0, .18); }",
+      ".dsdr-btn-primary:hover { background: #0f5547; border-color: #0f5547; opacity: 1; }",
+      ".dsdr-btn-primary:disabled { background: #6b8a82; border-color: #6b8a82; color: #ffffff; opacity: .8; }",
       ".dsdr-btn-danger { border-color: transparent; background: transparent; color: var(--dsw-alias-state-error-primary); font-weight: 600; }",
       ".dsdr-btn-danger:hover { background: var(--dsw-alias-bg-layer-2); border-color: transparent; }",
       ".dsdr-check { display: inline-flex; align-items: center; gap: 7px; color: var(--dsw-alias-label-primary); font-size: 12px; line-height: 20px; cursor: pointer; white-space: nowrap; }",
@@ -443,7 +483,7 @@ window.__ModuleLoader__.load({
       ".dsdr-code { font-family: ui-monospace, SFMono-Regular, Consolas, monospace; font-size: 11px; }",
       ".dsdr-footer { color: var(--dsw-alias-label-secondary); font-size: 11px; line-height: 17px; }",
       ".dsdr-spacer { flex: 1; }",
-      "@media (max-width: 780px) { .dsdr-page { padding: 20px 16px 40px; } .dsdr-hero-action { flex: 1 0 100%; width: 100%; align-items: stretch; margin-left: 0; } .dsdr-hero-buttons { width: 100%; } .dsdr-hero-buttons .dsdr-btn { flex: 1; } .dsdr-generate { width: 100%; } .dsdr-range { grid-template-columns: 1fr 1fr; } .dsdr-range .dsdr-actions { grid-column: 1 / -1; } .dsdr-stats { grid-template-columns: 1fr 1fr; } .dsdr-scan-row { grid-template-columns: 1fr; } .dsdr-manual-add { grid-template-columns: 1fr; } .dsdr-source, .dsdr-source-docs { grid-template-columns: 1fr; } .dsdr-source .dsdr-icon-btn { justify-self: end; } }",
+      "@media (max-width: 780px) { .dsdr-page { padding: 20px 16px 40px; } .dsdr-hero-action { flex: 1 0 100%; width: 100%; align-items: stretch; margin-left: 0; } .dsdr-hero-buttons { width: 100%; } .dsdr-hero-buttons .dsdr-btn { flex: 1; } .dsdr-split { flex: 1; } .dsdr-split .dsdr-generate { flex: 1; } .dsdr-generate { width: 100%; } .dsdr-range { grid-template-columns: 1fr 1fr; } .dsdr-range .dsdr-actions { grid-column: 1 / -1; } .dsdr-stats { grid-template-columns: 1fr 1fr; } .dsdr-scan-row { grid-template-columns: 1fr; } .dsdr-manual-add { grid-template-columns: 1fr; } .dsdr-source, .dsdr-source-docs { grid-template-columns: 1fr; } .dsdr-source .dsdr-icon-btn { justify-self: end; } }",
     ].join(NL);
 
     function installStyles(ctx) {
@@ -488,11 +528,73 @@ window.__ModuleLoader__.load({
       );
     }
 
+    function SaveIcon(props) {
+      const size = Number(props && props.size) > 0 ? Number(props.size) : 15;
+      return h(
+        "svg",
+        {
+          viewBox: "0 0 24 24",
+          width: size,
+          height: size,
+          fill: "none",
+          stroke: "currentColor",
+          strokeWidth: 1.8,
+          strokeLinecap: "round",
+          strokeLinejoin: "round",
+          "aria-hidden": true,
+        },
+        h("path", { d: "M5 3.5h11l3.5 3.5v13.5H5z" }),
+        h("path", { d: "M8 3.5v5h7v-5M8 20.5v-6h8v6" }),
+      );
+    }
+
+    function GenerateIcon(props) {
+      const size = Number(props && props.size) > 0 ? Number(props.size) : 15;
+      return h(
+        "svg",
+        {
+          viewBox: "0 0 24 24",
+          width: size,
+          height: size,
+          fill: "none",
+          stroke: "currentColor",
+          strokeWidth: 1.8,
+          strokeLinecap: "round",
+          strokeLinejoin: "round",
+          "aria-hidden": true,
+        },
+        h("path", { d: "M6 3.5h8l4 4v13H6z" }),
+        h("path", { d: "M14 3.5v4h4M9 12h6M9 15.5h4" }),
+        h("path", { d: "M18.5 16.5v4M16.5 18.5h4" }),
+      );
+    }
+
+    function ChevronIcon(props) {
+      const size = Number(props && props.size) > 0 ? Number(props.size) : 12;
+      return h(
+        "svg",
+        {
+          viewBox: "0 0 24 24",
+          width: size,
+          height: size,
+          fill: "none",
+          stroke: "currentColor",
+          strokeWidth: 2,
+          strokeLinecap: "round",
+          strokeLinejoin: "round",
+          "aria-hidden": true,
+        },
+        h("path", { d: "M6 9l6 6 6-6" }),
+      );
+    }
+
     function DailyReportView(props) {
       const ctx = props.ctx;
       const t = useTranslate(ctx);
       const [settings, setSettings] = React.useState({ git: [], docs: [] });
       const [range, setRange] = React.useState(currentMonthRange);
+      const [exportFormat, setExportFormat] = React.useState("xlsx");
+      const [formatMenuOpen, setFormatMenuOpen] = React.useState(false);
       const [aiInfo, setAiInfo] = React.useState({ available: false, provider: "", model: "" });
       const [useAi, setUseAi] = React.useState(true);
       const [loading, setLoading] = React.useState(true);
@@ -519,6 +621,7 @@ window.__ModuleLoader__.load({
       const pollAbortRef = React.useRef(null);
       const saveAbortRef = React.useRef(null);
       const saveTimerRef = React.useRef(null);
+      const formatMenuRef = React.useRef(null);
       const sessionId = typeof props.sessionId === "string" ? props.sessionId : "";
       const localeIsEnglish = currentLocaleId(ctx).toLowerCase().startsWith("en");
 
@@ -535,6 +638,17 @@ window.__ModuleLoader__.load({
         };
       }, []);
 
+      React.useEffect(() => {
+        if (!formatMenuOpen) return;
+        const close = (event) => {
+          if (formatMenuRef.current && !formatMenuRef.current.contains(event.target)) {
+            setFormatMenuOpen(false);
+          }
+        };
+        document.addEventListener("mousedown", close);
+        return () => document.removeEventListener("mousedown", close);
+      }, [formatMenuOpen]);
+
       React.useEffect(() => {
         let alive = true;
         const query = sessionId.length > 0 ? "?sessionId=" + encodeURIComponent(sessionId) : "";
@@ -547,6 +661,10 @@ window.__ModuleLoader__.load({
             if (!alive) return;
             setSettings(normalizeClientSettings(payload && payload.settings));
             setUseAi(!(payload && payload.settings && payload.settings.aiEnabled === false));
+            const savedFormat = payload && payload.settings && payload.settings.format;
+            if (typeof savedFormat === "string" && FORMAT_OPTIONS.includes(savedFormat)) {
+              setExportFormat(savedFormat);
+            }
             const nextAi = payload && payload.ai ? payload.ai : { available: false, provider: "", model: "" };
             setAiInfo({
               available: nextAi.available === true,
@@ -590,7 +708,7 @@ window.__ModuleLoader__.load({
             saveTimerRef.current = null;
           }
         };
-      }, [settings, useAi, range, loading]);
+      }, [settings, useAi, range, exportFormat, loading]);
 
       function updateGit(index, patch) {
         setSettings((previous) => ({
@@ -637,7 +755,7 @@ window.__ModuleLoader__.load({
           const response = await fetch(API + "/state", {
             method: "PUT",
             headers: { "content-type": "application/json" },
-            body: JSON.stringify({ settings: cleanSettings(settings, useAi, range) }),
+            body: JSON.stringify({ settings: cleanSettings(settings, useAi, range, exportFormat) }),
             signal: controller.signal,
           });
           if (!response.ok) throw new Error("save-failed");
@@ -821,7 +939,7 @@ window.__ModuleLoader__.load({
           const response = await fetch(API + "/job/export", {
             method: "POST",
             headers: { "content-type": "application/json", accept: "application/octet-stream" },
-            body: JSON.stringify({ jobId: previewJobId, edits: previewEdits() }),
+            body: JSON.stringify({ jobId: previewJobId, edits: previewEdits(), format: exportFormat }),
           });
           if (!response.ok) {
             let payload = null;
@@ -837,7 +955,7 @@ window.__ModuleLoader__.load({
           const filenameHeader = response.headers.get("x-report-filename");
           const filename = filenameHeader
             ? decodeURIComponent(filenameHeader)
-            : "日报汇总_" + preview.range.start + "_" + preview.range.end + ".xlsx";
+            : "日报汇总_" + preview.range.start + "_" + preview.range.end + "." + formatExtension(exportFormat);
           const blob = await response.blob();
           const url = window.URL.createObjectURL(blob);
           const next = Object.assign({}, summary, { filename, url, size: blob.size });
@@ -919,9 +1037,12 @@ window.__ModuleLoader__.load({
         });
       }
 
-      async function generate() {
+      async function generate(formatOverride) {
         if (generating) return;
-        const cleaned = cleanSettings(settings, useAi, range);
+        const format = FORMAT_OPTIONS.includes(formatOverride) ? formatOverride : exportFormat;
+        setExportFormat(format);
+        setFormatMenuOpen(false);
+        const cleaned = cleanSettings(settings, useAi, range, format);
         if (cleaned.git.length === 0 && cleaned.docs.length === 0) {
           setError(t("error.noSources", "请至少添加一个 Git 仓库或本地文档。"));
           return;
@@ -1080,16 +1201,66 @@ window.__ModuleLoader__.load({
                   "button",
                   {
                     type: "button",
-                    className: "dsdr-btn dsdr-save-btn",
+                    className: "dsdr-btn dsdr-save-btn dsdr-btn-with-icon",
                     onClick: saveSettingsNow,
                     disabled: saveState === "saving",
                   },
-                  saveState === "saving" ? t("save.savingShort", "正在保存…") : t("save.button", "保存设置"),
+                  h(SaveIcon, { size: 15 }),
+                  h("span", null, saveState === "saving" ? t("save.savingShort", "正在保存…") : t("save.button", "保存设置")),
                 ),
                 h(
-                  "button",
-                  { type: "button", className: "dsdr-btn dsdr-btn-primary dsdr-generate", onClick: generate, disabled: generating },
-                  generating ? t("generating", "正在收集并生成…") : t("generate", "生成 XLSX 日报"),
+                  "div",
+                  { className: "dsdr-split", ref: formatMenuRef },
+                  h(
+                    "button",
+                    {
+                      type: "button",
+                      className: "dsdr-btn dsdr-btn-primary dsdr-generate dsdr-btn-with-icon",
+                      onClick: () => generate(),
+                      disabled: generating,
+                    },
+                    h(GenerateIcon, { size: 15 }),
+                    h("span", null, generating ? t("generating", "正在收集并生成…") : t("generate", "生成日报")),
+                  ),
+                  h(
+                    "button",
+                    {
+                      type: "button",
+                      className: "dsdr-btn dsdr-btn-primary dsdr-split-toggle",
+                      onClick: () => setFormatMenuOpen((open) => !open),
+                      disabled: generating,
+                      "aria-haspopup": "menu",
+                      "aria-expanded": formatMenuOpen,
+                      "aria-label": t("format.label", "格式"),
+                    },
+                    h(ChevronIcon, { size: 12 }),
+                  ),
+                  formatMenuOpen
+                    ? h(
+                        "div",
+                        { className: "dsdr-menu", role: "menu" },
+                        h("div", { className: "dsdr-menu-title" }, t("format.label", "格式")),
+                        FORMAT_OPTIONS.map((format) =>
+                          h(
+                            "button",
+                            {
+                              type: "button",
+                              role: "menuitemradio",
+                              "aria-checked": exportFormat === format,
+                              className: "dsdr-menu-item" + (exportFormat === format ? " is-active" : ""),
+                              key: format,
+                              onClick: () => {
+                                setExportFormat(format);
+                                setFormatMenuOpen(false);
+                                generate(format);
+                              },
+                            },
+                            h("span", null, formatLabel(format, t)),
+                            h("span", { className: "dsdr-menu-check" }, exportFormat === format ? "✓" : ""),
+                          ),
+                        ),
+                      )
+                    : null,
                 ),
               ),
               saveText ? h("div", { className: "dsdr-save" }, saveText) : null,
@@ -1150,7 +1321,7 @@ window.__ModuleLoader__.load({
                     h(
                       "button",
                       { type: "button", className: "dsdr-btn dsdr-btn-primary", onClick: exportPreview, disabled: exporting || regenerating.length > 0 },
-                      exporting ? t("preview.exporting", "正在导出…") : t("preview.export", "导出 XLSX"),
+                      exporting ? t("preview.exporting", "正在导出…") : t("preview.export", "导出") + " " + formatShortLabel(exportFormat),
                     ),
                   ),
                 ),

package/index.js

@@ -18,6 +18,7 @@ import {
   sanitizeSettings,
 } from "./lib/collect.js";
 import { aiInfo, analyzeReport, regenerateDay } from "./lib/ai.js";
+import { buildCsvReport, buildHtmlReport, buildMarkdownReport } from "./lib/formats.js";
 import { buildReportWorkbook, reportFileName, summarizeReport, buildReportPreview, applyReportEdits } from "./lib/report.js";
 
 export const inject = ["webServer"];
@@ -36,12 +37,32 @@ const MAX_RANGE_DAYS = 366;
 const JOB_TTL = 60 * 60 * 1000;
 const MAX_JOBS = 20;
 const jobs = new Map();
+const REPORT_FORMATS = new Set(["xlsx", "markdown", "csv", "html"]);
+
+function normalizeFormat(value) {
+  return typeof value === "string" && REPORT_FORMATS.has(value) ? value : "xlsx";
+}
+
+function formatContentType(format) {
+  if (format === "markdown") return "text/markdown; charset=utf-8";
+  if (format === "csv") return "text/csv; charset=utf-8";
+  if (format === "html") return "text/html; charset=utf-8";
+  return "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet";
+}
+
+function buildReportBuffer(result, format) {
+  if (format === "markdown") return Buffer.from(buildMarkdownReport(result), "utf8");
+  if (format === "csv") return Buffer.from(buildCsvReport(result), "utf8");
+  if (format === "html") return Buffer.from(buildHtmlReport(result), "utf8");
+  return buildReportWorkbook(result);
+}
 
 const DEFAULT_SETTINGS = {
   git: [],
   docs: [],
   aiEnabled: true,
   mineOnly: true,
+  format: "xlsx",
   range: null,
 };
 
@@ -80,12 +101,13 @@ function sendError(res, status, code, message, details) {
   sendJson(res, status, body);
 }
 
-function sendReportFile(res, buffer, filename, summary) {
+function sendReportFile(res, buffer, filename, summary, contentType) {
   const summaryHeader = Buffer.from(JSON.stringify(summary), "utf8").toString("base64");
   const encodedName = encodeURIComponent(filename);
+  const extension = filename.includes(".") ? filename.slice(filename.lastIndexOf(".") + 1) : "xlsx";
   res.statusCode = 200;
-  res.setHeader("content-type", "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet");
-  res.setHeader("content-disposition", 'attachment; filename="daily-report.xlsx"; filename*=UTF-8\'\'' + encodedName);
+  res.setHeader("content-type", contentType || "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet");
+  res.setHeader("content-disposition", 'attachment; filename="daily-report.' + extension + '"; filename*=UTF-8\'\'' + encodedName);
   res.setHeader("content-length", String(buffer.length));
   res.setHeader("cache-control", "no-store");
   res.setHeader("x-report-filename", encodedName);
@@ -320,10 +342,6 @@ function registerRoute(ctx, path, handler, label) {
   ctx.effect(() => dispose, label);
 }
 
-function outputPathFor(cwd, start, end) {
-  return join(cwd, reportFileName(start, end));
-}
-
 function ensureAbsolute(cwd, value) {
   if (typeof value !== "string" || value.trim().length === 0) return "";
   return isAbsolute(value) ? resolve(value) : resolve(cwd, value);
@@ -380,8 +398,9 @@ function registerTool(ctx) {
           description: "Local document files or directories. When omitted, the saved plugin configuration is used.",
           items: { type: "string" },
         },
-        outputPath: { type: "string", description: "Optional output XLSX path. Defaults to the session working directory." },
+        outputPath: { type: "string", description: "Optional output path. Defaults to the session working directory." },
         ai: { type: "boolean", description: "Analyze commit diffs, commit messages and document excerpts with the current default model, then add per-day AI summaries to the workbook." },
+        format: { type: "string", enum: ["xlsx", "markdown", "csv", "html"], description: "Output format. Defaults to xlsx." },
         locale: { type: "string", enum: ["zh", "en"], description: "Report language. Defaults to zh." },
       },
     },
@@ -481,9 +500,9 @@ function registerTool(ctx) {
           for (const warning of result.ai.warnings || []) result.warnings.push("AI 分析：" + warning);
         }
       }
-      const filename = reportFileName(start, end);
-      const target = ensureAbsolute(cwd, input.outputPath) || outputPathFor(cwd, start, end);
-      const buffer = buildReportWorkbook(result);
+      const filename = reportFileName(start, end, normalizeFormat(input.format));
+      const target = ensureAbsolute(cwd, input.outputPath) || join(cwd, filename);
+      const buffer = buildReportBuffer(result, normalizeFormat(input.format));
       await fs.mkdir(dirname(target), { recursive: true });
       await fs.writeFile(target, buffer);
       return {
@@ -720,8 +739,10 @@ export function apply(ctx) {
       if (job.status !== "done" || !job.result) return sendError(res, 409, "job-not-ready", "生成任务尚未完成。");
       try {
         const edited = applyReportEdits(job.result, body.edits || {});
-        const buffer = buildReportWorkbook(edited);
-        return sendReportFile(res, buffer, job.filename, summarizeReport(edited));
+        const format = normalizeFormat(body.format);
+        const buffer = buildReportBuffer(edited, format);
+        const filename = reportFileName(edited.range.start, edited.range.end, format);
+        return sendReportFile(res, buffer, filename, summarizeReport(edited), formatContentType(format));
       } catch (error) {
         return sendError(res, 400, "export-failed", error.message || "导出日报失败。");
       }

package/lib/collect.js

@@ -166,6 +166,7 @@ export function sanitizeSettings(raw) {
     docs,
     aiEnabled: source.aiEnabled !== false,
     mineOnly: source.mineOnly !== false,
+    format: ["xlsx", "markdown", "csv", "html"].includes(source.format) ? source.format : "xlsx",
     range: start && end && start <= end ? { start: range.start, end: range.end } : null,
   };
 }

package/lib/formats.js

@@ -0,0 +1,190 @@
+/**
+ * Plain-text and HTML renderings of the same report result used by the XLSX
+ * writer. Keeping them here means every export format follows the same AI
+ * summaries, manual items and source data.
+ */
+
+function manualMap(result) {
+  const map = new Map();
+  for (const item of result.manualItems || []) {
+    if (!item || typeof item.date !== "string" || typeof item.text !== "string") continue;
+    if (!map.has(item.date)) map.set(item.date, []);
+    map.get(item.date).push(item.text);
+  }
+  return map;
+}
+
+function aiDayMap(result) {
+  const map = new Map();
+  for (const day of result.ai && result.ai.ok && Array.isArray(result.ai.days) ? result.ai.days : []) {
+    map.set(day.date, day);
+  }
+  return map;
+}
+
+function cellText(value) {
+  return value === null || value === undefined ? "" : String(value);
+}
+
+function markdownCell(value) {
+  return cellText(value).replace(/\|/g, "\\|").replace(/\r?\n/g, "<br>");
+}
+
+function csvCell(value) {
+  return '"' + cellText(value).replace(/"/g, '""') + '"';
+}
+
+function htmlEscape(value) {
+  return cellText(value)
+    .replace(/&/g, "&amp;")
+    .replace(/</g, "&lt;")
+    .replace(/>/g, "&gt;")
+    .replace(/"/g, "&quot;");
+}
+
+function summaryRows(result) {
+  const manual = manualMap(result);
+  const ai = aiDayMap(result);
+  return result.days.map((day) => {
+    const dayAi = ai.get(day.date);
+    return [
+      day.date,
+      day.weekday,
+      day.dayType,
+      day.commitCount,
+      day.docCount,
+      day.sources || "—",
+      day.summary,
+      (manual.get(day.date) || []).join("；"),
+      dayAi ? dayAi.summary || "" : "",
+    ];
+  });
+}
+
+export function buildMarkdownReport(result) {
+  const ai = result.ai && result.ai.ok ? result.ai : null;
+  const rows = summaryRows(result);
+  const lines = [
+    "# 日报汇总 " + result.range.start + " ~ " + result.range.end,
+    "",
+    "- Git 提交：" + result.stats.commits + " 条",
+    "- 文档：" + result.stats.docs + " 份",
+    "- 有记录天数：" + result.stats.activeDays + " 天",
+    "- 数据源：" + result.stats.okSources + "/" + result.stats.sources + " 个正常",
+    "",
+  ];
+  if (ai) {
+    lines.push("## 总体 AI 总结", "", ai.overall || "—", "");
+  } else if (result.ai && result.ai.error) {
+    lines.push("> AI 分析未完成：" + result.ai.error, "");
+  }
+  lines.push(
+    "## 每日汇总",
+    "",
+    "| 日期 | 星期 | 类型 | Git提交 | 文档 | 涉及仓库/文档 | 当日摘要 | 手动补充 | AI 分析 |",
+    "|---|---|---|---:|---:|---|---|---|---|",
+  );
+  for (const [date, weekday, dayType, commitCount, docCount, sources, summary, manual, aiSummary] of rows) {
+    lines.push(
+      "| " +
+        [date, weekday, dayType, commitCount, docCount, sources, summary, manual, aiSummary]
+          .map(markdownCell)
+          .join(" | ") +
+        " |",
+    );
+  }
+  if (result.commits.length > 0) {
+    lines.push("", "## Git 明细", "", "| 日期 | 仓库 | 分支 | 提交 | 作者 | 说明 |", "|---|---|---|---|---|---|");
+    for (const commit of result.commits) {
+      lines.push(
+        "| " +
+          [commit.date, commit.repo, commit.branch, commit.shortHash, commit.author, commit.subject]
+            .map(markdownCell)
+            .join(" | ") +
+          " |",
+      );
+    }
+  }
+  if (result.docs.length > 0) {
+    lines.push("", "## 文档明细", "", "| 日期 | 来源 | 文件 | 标题 | 摘要 |", "|---|---|---|---|---|");
+    for (const doc of result.docs) {
+      lines.push("| " + [doc.date, doc.source, doc.file, doc.title, doc.excerpt].map(markdownCell).join(" | ") + " |");
+    }
+  }
+  return lines.join("\n") + "\n";
+}
+
+export function buildCsvReport(result) {
+  const header = ["日期", "星期", "日类型", "Git提交", "文档", "涉及仓库/文档", "当日摘要", "手动补充", "AI 分析"];
+  const rows = summaryRows(result);
+  return "\ufeff" + [header, ...rows].map((row) => row.map(csvCell).join(",")).join("\r\n") + "\r\n";
+}
+
+export function buildHtmlReport(result) {
+  const ai = result.ai && result.ai.ok ? result.ai : null;
+  const rows = summaryRows(result);
+  const tableRows = rows
+    .map(
+      (row) =>
+        "<tr>" +
+        row
+          .map((value, index) => {
+            const cls = index >= 3 && index <= 4 ? ' class="num"' : "";
+            return "<td" + cls + ">" + htmlEscape(value) + "</td>";
+          })
+          .join("") +
+        "</tr>",
+    )
+    .join("\n");
+  const gitRows = result.commits
+    .map(
+      (commit) =>
+        "<tr>" +
+        [commit.date, commit.repo, commit.branch, commit.shortHash, commit.author, commit.subject, commit.fileCount]
+          .map((value) => "<td>" + htmlEscape(value) + "</td>")
+          .join("") +
+        "</tr>",
+    )
+    .join("\n");
+  return `<!doctype html>
+<html lang="zh-CN">
+<head>
+<meta charset="utf-8">
+<meta name="viewport" content="width=device-width, initial-scale=1">
+<title>日报汇总 ${htmlEscape(result.range.start)} ~ ${htmlEscape(result.range.end)}</title>
+<style>
+:root { color-scheme: light dark; }
+body { margin: 0; padding: 32px; font-family: "Microsoft YaHei", "Segoe UI", sans-serif; background: #f5f7fa; color: #1f2933; }
+main { max-width: 1400px; margin: 0 auto; background: #fff; border-radius: 12px; padding: 28px 32px; box-shadow: 0 2px 16px rgba(0,0,0,.08); }
+h1 { margin: 0 0 8px; font-size: 26px; }
+.meta { color: #617080; font-size: 13px; margin-bottom: 18px; }
+.stats { display: flex; flex-wrap: wrap; gap: 10px; margin: 16px 0 22px; }
+.stat { border: 1px solid #d9e1ea; border-radius: 8px; padding: 8px 12px; min-width: 110px; }
+.stat b { display: block; font-size: 20px; }
+.stat span { color: #617080; font-size: 12px; }
+h2 { margin: 26px 0 10px; font-size: 18px; }
+p { line-height: 1.75; margin: 0 0 12px; white-space: pre-wrap; }
+table { width: 100%; border-collapse: collapse; font-size: 12px; }
+th, td { border: 1px solid #d9e1ea; padding: 6px 8px; text-align: left; vertical-align: top; }
+th { background: #1f4e79; color: #fff; font-weight: 600; }
+tr:nth-child(even) td { background: #f7f9fc; }
+td.num { text-align: center; white-space: nowrap; }
+.note { color: #617080; font-size: 12px; }
+@media print { body { padding: 0; background: #fff; } main { box-shadow: none; border-radius: 0; } }
+</style>
+</head>
+<body>
+<main>
+<h1>日报汇总 ${htmlEscape(result.range.start)} ~ ${htmlEscape(result.range.end)}</h1>
+<div class="meta">Git 提交 ${result.stats.commits} 条 · 文档 ${result.stats.docs} 份 · 有记录 ${result.stats.activeDays} 天 · 数据源 ${result.stats.okSources}/${result.stats.sources} 个正常</div>
+${ai ? "<h2>总体 AI 总结</h2><p>" + htmlEscape(ai.overall || "—") + "</p>" : result.ai && result.ai.error ? '<p class="note">AI 分析未完成：' + htmlEscape(result.ai.error) + "</p>" : ""}
+<h2>每日汇总</h2>
+<table>
+<thead><tr><th>日期</th><th>星期</th><th>类型</th><th>Git提交</th><th>文档</th><th>涉及仓库/文档</th><th>当日摘要</th><th>手动补充</th><th>AI 分析</th></tr></thead>
+<tbody>${tableRows}</tbody>
+</table>
+${gitRows ? "<h2>Git 明细</h2><table><thead><tr><th>日期</th><th>仓库</th><th>分支</th><th>提交</th><th>作者</th><th>说明</th><th>变更文件数</th></tr></thead><tbody>" + gitRows + "</tbody></table>" : ""}
+</main>
+</body>
+</html>`;
+}

package/lib/report.js

@@ -25,8 +25,9 @@ function commitFileText(commit) {
   return text;
 }
 
-export function reportFileName(start, end) {
-  return "日报汇总_" + start + "_" + end + ".xlsx";
+export function reportFileName(start, end, format = "xlsx") {
+  const extension = format === "markdown" ? "md" : format === "html" || format === "csv" ? format : "xlsx";
+  return "日报汇总_" + start + "_" + end + "." + extension;
 }
 
 export function summarizeReport(result) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-plugin-daily-report",
-  "version": "1.0.1",
+  "version": "1.0.2",
   "description": "按天汇总多个 Git 仓库、分支与本地文档，支持 AI 分析并导出 XLSX 日报。",
   "license": "MIT",
   "type": "module",