[KuramiWan]

新增 Bug 报告投递：契约、桌面端收集与三条投递通道

What changed（改了什么）

用户从社区弹窗点「报告问题」，看到主进程收集并已脱敏的报告，自己选一条通道送出：

• 邮件：mailto: 拉起默认邮件客户端；正文可带邮件列表名与订阅地址，报告人想跟进才订阅。
• 收件箱仓库 issue：预填 issues/new 链接，正文第一行是隐藏签名块，供收件箱仓库的 workflow 按签名折叠。
• 代发（可选，默认关闭）：配了 Web3Forms / Formspree，或自有 eleckoi-relay Worker 时显示「直接发送」；Worker 会回执（issue 编号）。
• 兜底：退出时不变——复制报告到剪贴板、导出 JSON。

两个不做的事，都写进了 ADR 0041：不常驻上报（不启动 crashReporter、不引入 Sentry/Bugsnag），不自动建 issue（客户端不带 token；Worker 中转那条是显式 opt-in，见 ADR 决定 10）。

底层：

• 主进程 modules/diagnostics：从日志的 session.started / session.ended 配对判断上次会话是否异常结束（跨天、跨轮转文件），收集失败行（只认 phase: 'failure' + 字符串契约码），拼报告后出口即脱敏（家目录 / Android 沙箱 / POSIX / macOS 路径、用户名、邮箱、token= 类参数）。
• 契约 packages/shared/src/contracts/bugReport/：形状与校验、脱敏、邮件正文与 mailto:、issue Markdown 与隐藏签名块、代发请求（含自有 Worker 信封与回执解析）。
• 收件邮箱、收件仓库、代发配置全部来自环境变量，仓库里不硬编码地址。

Architecture route（架构归属）

• Main 新文件仅承担桌面壳职责，位于 host / modules / platform / i18n
• Shared 新文件位于闭合集合：contracts / foundation
• 产品跨 Host/Client 查询与命令使用生成的 Typert Remote；会话事件、分页与 projection 使用 DSH Connection 正式协议，未新增业务 IPC 或私有桥（本次只新增壳自己的最小 IPC 通道，见 contracts/desktopShell.ts）
• Renderer 未直接访问 Electron、Node、SQLite 或 DSH SDK
• 官方运行时装配隔离在 @eleckoi/dsh-runtime；本次未触碰
• 新业务进入 DSH Host/Client 插件；本次不涉及产品数据
• 长生命周期资源已注册为 Host/Cordis Plugin，并能反向释放（diagnosticsPlugin 注销自己的 IPC handler）
• 新增失败带契约码、用户可见文案只在渲染层产生（check:error-contract 0 处）

Data and compatibility（数据与兼容）

• Schema 改动：无
• 没有把会话、消息、角色或模型配置写入 localStorage
• 取消路径：保存对话框取消 → { saved: false }，不写文件；收集失败 → 对话框显示错误，不发送
• 报告格式带 schemaVersion，字段只增不改

Verification（验证）

• pnpm test：bug-report 相关 3 个文件共 65 条用例（契约 40、桌面侧 20、对话框 5）
• bash gates.sh 全绿（check:docs / check:architecture / check:plugin-types / check:plugin-docs / typecheck 等 10 步）
• node scripts/check-error-contract.mjs：四条规则 0 处
• Windows 真机验收：清单在 win-dev/checklists/bug-report.md，1–8 步通过（2026-10-27，dev 窗口 889644f）
• 没有启动 Android、Docker、QEMU 或 ARM64 DSH 核心编译
• UI 未定稿阶段没有借底层改造擅自改变样式（新对话框只新增 .bug-report-* 类）

已知与本改动无关的失败：apps/web/tests/chat/chat-display-preview.test.jsx 与
apps/web/tests/mobile/mobile-settings.test.jsx 各有 1 条在干净树上同样失败（已用 git stash 复跑确认）。

Review scope（审查范围）

• docs/adr/0041-bug-report-delivery.md、docs/adr/README.md
• packages/shared/src/contracts/bugReport/（report.ts / redact.ts / mailto.ts / issue.ts / relay.ts / delivery.ts）
• packages/shared/src/contracts/desktopShell.ts、logActions.ts
• apps/desktop/src/main/modules/diagnostics/
• apps/desktop/src/preload/preload.ts、apps/desktop/src/main/host/DesktopHost.ts
• apps/web/src/app/windows/shell/components/BugReportDialog.jsx、CommunityDialog.jsx、apps/web/src/app/windows/MainWindow.jsx
• 测试：packages/shared/tests/bug-report.test.ts、apps/desktop/tests/bug-report-collection.test.ts、apps/web/tests/ui/bug-report-dialog.test.jsx

特别希望被挑战的点：

1. 脱敏是否够。当前只处理有明确形态的东西（路径前缀、用户名全词、邮箱、凭据参数），刻意不猜 QQ 号、角色名、对话内容。日志尾默认关闭，用户勾选才带；但 details.what 里可能出现角色名。
2. ADR 0040 决定 1 的解释：「不引入运行时错误服务」是否容得下「用户发起的导出」与「显式 opt-in 的代发」。
3. 代发通道的边界：Web3Forms / Formspree 的公开标识会被提取并耗掉免费额度；ADR 承认这是取舍而非防线。

[coderabbitai]

Important

Draft PR not reviewed

Draft PRs are not automatically reviewed by default.

• Trigger a manual review

To automatically review draft PRs, update your CodeRabbit configuration:

reviews:
  auto_review:
    drafts: true

• Autofix · Keep fixing CodeRabbit findings and required CI, and resolving merge conflicts

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}