Commit Graph
45 Commits
Author SHA1 Message Date
胡绍康 cb4a119a47 release: v1.6.1 2026-03-15 12:57:01 +08:00
胡绍康 2c9312c737 chore: remove internal docs from release 2026-03-15 09:50:58 +08:00
胡绍康andCopilot 1dec707ac3 release: v1.6.0
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-03-13 12:47:21 +08:00
胡绍康 01d1dc0874 feat: implement external API security architecture (public mode, IP whitelist, rate limit)
- Add ExternalApiGuard for IP whitelisting, rate limiting, and public mode enforcement
- Update wait-message to support async mode
- Fix bugs in verification code extraction (BUG-00014 to BUG-00017)
- Update documentation and architectural diagrams
2026-03-13 11:27:34 +08:00
胡绍康andCopilot 09c3ab3416 fix: gate low-confidence verification extraction results as 404 (BUG-00017)
- Add code_confidence/link_confidence fine-grained fields to extractor
- Service-layer credibility gate: confidence != high -> nullify result -> 404
- Caller-directed extraction (code_regex only) gets high confidence
- Narrow LINK_CONTEXT_PHRASES with object nouns (email/account) prevent false positives
- 31 new tests (21 unit + 10 integration), 376 total passing
- Update docs/api.md with new fields, null semantics, v1.5 gating notes

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-03-12 23:24:02 +08:00
胡绍康andCopilot 7163b3bc17 docs: OpenAPI YAML 补全 P1 公网守卫响应与 P2 probe 异步探测端点
新增内容:
- Probe tag 与 /api/external/probe/{probe_id} 端点定义
- wait-message 增加 mode 参数与 202 异步响应
- ProbeCreatedData / ProbeStatusData / 对应 Response schema
- CapabilitiesData 增加 public_mode / restricted_features 字段
- Mode 查询参数定义(sync / async)
- P1 错误响应:IpNotAllowed / FeatureDisabled / RateLimitExceeded

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-03-12 00:20:16 +08:00
胡绍康andCopilot 7128edeaaa feat: PRD-00008 P2 wait-message 异步探测解耦 — probe 缓存、后台轮询、333 测试全绿
- DB v6→v7:新增 external_probe_cache 表(状态/结果/过期时间)
- external_api.py:create_probe / get_probe_status / poll_pending_probes / cleanup
- wait-message 支持 mode=sync(P0 向下兼容)和 mode=async(P2 异步探测)
- 新增 GET /api/external/probe/<probe_id> 查询探测状态
- scheduler.py:注册 5 秒间隔的 external_probe_poll Job
- 新增 12 个 P2 测试(TC-PROBE-01~12),总计 333 测试全绿
- api.md:新增 probe 端点文档、更新 wait-message 双模式说明
- TODO-00008 P2 勾选完成

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-03-11 22:47:19 +08:00
胡绍康andCopilot a01b48a813 feat: PRD-00008 P1 公网模式安全层 — 守卫模块、设置 UI、321 测试全绿
- 新增 external_api_guard.py:IP 白名单、限流(SQLite 分钟桶)、高风险端点禁用
- DB v5→v6:新增 external_api_rate_limits 表 + 5 项 P1 默认设置
- 10 个外部 API 端点集成 @external_api_guards() 装饰器
- capabilities 端点增强:public_mode / restricted_features
- settings 控制器 + 前端 UI:公网模式开关、IP 白名单、限流、功能禁用
- 新增 18 个 P1 守卫测试(TC-GUARD-01~18),总计 321 测试全绿
- 更新 api.md:P1 错误码、配置文档
- 默认 public_mode=false,与 P0 行为完全兼容

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-03-11 22:18:40 +08:00
胡绍康andCopilot c79a173c03 docs: api.md 补充 raw/wait-message 独立安全风险说明段落
- /messages/{id}/raw: 原始内容风险、无脱敏、公网应禁用
- /wait-message: 同步轮询线程占用、并发耗尽风险、P2 解耦计划
- TODO-00008 第8节全部勾选完成(6/6)

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-03-11 21:39:21 +08:00
胡绍康andCopilot a1bc3e0eed docs: TODO-00008 手动验证项全部勾选完成
- 3.1 节:脱敏值不回写、清空返回403、三路径鉴权验证全部实测通过
- 8 节:手动联调、README口径核查、发布确认为P0收口

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-03-11 21:27:00 +08:00
胡绍康andCopilot 085796eebe fix: PRD-00008 P0 审查修复 — OpenAPI schema 一致性、审计日志补全、测试覆盖 51→303
- fix(openapi): VerificationCodeData 补齐 verification_link/links/formatted 字段
- fix(openapi): confidence 枚举修正为 [high, low](无 medium)
- fix(openapi): AccountStatusData 补 status 字段
- fix(openapi): VerificationLinkData 补 email 属性
- fix(controllers): verification-code/link/wait-message 异常路径补审计日志
- test: 新增 30 条 P0 测试(auth、param、error、schema、regression)
- test: 新增 11 条 P1 extractor 边界测试(TC-EXT-01~04)
- docs: TODO-00008 更新至 V1.1(P0 已完成)

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-03-11 17:57:37 +08:00
胡绍康 bd9bafeb83 ci: harden quality gates and clean test warnings 2026-03-10 22:04:18 +08:00
胡绍康 1d4d848702 fix: align external api behavior with PRD-00008 2026-03-10 21:24:55 +08:00
胡绍康 9673b3524d feat: add external api docs tests and verification updates 2026-03-09 15:07:18 +08:00
胡绍康 98febc798a fix: resolve copy logout and favicon regressions 2026-03-09 12:58:01 +08:00
胡绍康 8ad5832a1d release: v1.5.1 — Microsoft Refresh Token 滚动更新 2026-03-07 18:49:10 +08:00
XiaoSihui c9e14231b1 release: v1.5.0 — Telegram 实时推送与去重稳定性优化 2026-03-06 23:00:59 +08:00
胡绍康andCopilot 721a037c0c docs: 更新 BUG-00011 文档补充 P2 Message-ID 去重章节
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-03-05 22:35:11 +08:00
胡绍康andCopilot d6af769401 fix: BUG-00011 游标竞态导致单封邮件重复推送
- cursor 从固定 job_start_time 改为 max(job_start_time, max_received_at)
- 防止邮件服务器时钟偏差 / fetch 窗口期间到达的邮件被重复拉取
- 新增 3 个 TestCursorClockSkew 测试 (时钟偏差 + 端到端防重)
- 224 tests passing

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-03-05 22:03:03 +08:00
胡绍康andCopilot 8dd085b223 docs: BUG-00010 推送性能与滚动优化文档
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-03-05 19:56:09 +08:00
胡绍康andCopilot f11096f30a docs: add BUG-00009 scroll reset and push interruption analysis
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-03-05 17:49:03 +08:00
胡绍康andCopilot d4f8f609cf fix: IMAP timezone mismatch causing duplicate pushes (BUG-TG-006)
Root cause: parsedate_to_datetime preserves local timezone (e.g., +0800)
but strftime strips it, producing local time string (17:00) compared
against UTC cursor (09:00). Local > UTC → same email never filtered.

Fix: convert received_dt to UTC via astimezone(timezone.utc) before
formatting to ISO string for comparison.

Verified: job log changed from sent=1 (every run) to sent=0 (no new mail).

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-03-05 17:21:36 +08:00
胡绍康andCopilot 7f2f739c00 fix: widen poll interval range 10-86400s + add BUG-00008 analysis doc
D-3: Relax telegram poll interval constraints:
- Backend: 60-3600 → 10-86400 seconds
- Frontend: min/max attributes updated
- Scheduler: floor changed from 60 to 10 seconds
- Test T-29: adjusted boundary value (30→5)

BUG-00008: Comprehensive analysis comparing our implementation with
MailAggregator_Pro, covering cursor reset, tag UI, and interval limits.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-03-05 16:56:23 +08:00
胡绍康andCopilot 9085f99ed3 fix: reset push cursor on re-enable + add push tag UI
- toggle_telegram_push: reset cursor to NOW when transitioning 0→1
  (idempotent when already enabled, prevents historical email flood)
- Add '🔔 推送' tag to account cards when push is enabled
- Tag is clickable to disable push (removes tag)
- Add .tg-push-tag CSS (Telegram blue #0088cc)
- Add test T-12b: verify re-enable resets cursor
- Update BUG-00007 doc with BUG-TG-005

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-03-05 16:42:27 +08:00
胡绍康andCopilot 40d7626c77 docs: add BUG-00007 Telegram push live testing issues
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-03-05 16:17:32 +08:00
胡绍康andCopilot 450fc6dd45 release: v1.4.0 — 账号导入导出无缝迁移
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-03-04 20:38:07 +08:00
胡绍康andCopilot 973412d44c feat: 账号导入导出无缝迁移(PRD-00006/FD-00006)
- 新增 auto 智能混合导入模式:自动识别 Outlook/IMAP/GPTMail 行类型
- 域名推断 provider(gmail/qq/163/126/yahoo/aliyun/outlook)
- 自动按 provider 创建/复用分组
- 支持重复策略(skip/overwrite)和兜底 IMAP 设置
- 导出升级为 v2:头部元信息 + GPTMail 分段 + 时间戳文件名
- 前端导入模态框支持 auto 模式 UI 交互
- 新增 41 个单元测试(163 总测试全部通过)

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-03-04 20:33:19 +08:00
胡绍康andClaude Opus 4.6 3e800c6198 release: v1.3.0 — 多邮箱统一管理系统
新增功能:
- 支持 Gmail/QQ/163/126/Yahoo/阿里邮箱/自定义 IMAP
- IMAP 通用服务与提供商配置系统
- 验证码提取支持 IMAP 邮箱
- 前端动态表单与账号类型标识

修复:
- 数据库 Schema v2 → v3 安全升级
- 定时刷新任务只处理 Outlook 账号
- IMAP 邮箱禁止远程删除保护

测试:122 个测试全部通过

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-03 22:58:09 +08:00
胡绍康andClaude Opus 4.6 64d8a6c357 feat(multi-mailbox): 实现多邮箱统一管理功能(PRD-00005)
核心变更:
- 数据库:Schema v3,accounts 表新增 account_type/provider/imap_host/imap_port/imap_password 字段
- 后端:新增通用 IMAP 服务(imap_generic.py)与邮箱提供商配置(providers.py)
- 导入:支持 Outlook/QQ/163/Gmail/自定义 IMAP 多格式批量导入,兼容注释行与导出格式
- 导出:按邮箱类型分组导出,保留 provider 信息便于重新导入
- 邮件读取:IMAP 账号走通用 IMAP 服务,Outlook 保持原 Graph/XOAUTH2 链路
- 验证码提取:IMAP 账号通过 IMAP 获取邮件详情后提取
- 安全约束:IMAP 账号禁用远程删除,敏感字段(imap_password)加密存储
- 前端:新增邮箱类型下拉、自定义 IMAP 配置区、provider 标签显示
- 调度器:定时刷新仅处理 Outlook 账号(IMAP 无 OAuth token 刷新语义)
- 日志:配置 outlook_web 命名空间日志输出到 stderr

技术细节:
- 保持 Outlook 旧格式完全兼容(四段式:email----password----client_id----refresh_token)
- IMAP 账号使用空字符串占位 client_id/refresh_token(满足 DB NOT NULL 约束)
- 支持导出格式智能识别(5 段 custom、3 段 provider、2 段配合输入框)
- 前端 DOMPurify 未加载时回退为基本 HTML 过滤(CDN 不可达场景)

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-03 22:54:39 +08:00
胡绍康andClaude Opus 4.6 ccef534a8c release: v1.2.1 — 修复 SECRET_KEY 持久化问题
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-02 12:24:10 +08:00
胡绍康andClaude Opus 4.6 8d5c8a04d6 feat: 增强启动脚本智能初始化 + 更新文档截图
- 新增 start.py 环境变量智能初始化功能
  - 自动从 .env.example 复制配置文件
  - 自动生成安全的 SECRET_KEY
  - 添加详细的用户提示和安全警告
- 更新 README.md 添加界面截图展示
  - 仪表盘、邮箱管理、验证码提取、系统设置
- 清理旧的中文命名图片文件

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-02 12:21:42 +08:00
胡绍康andCopilot ca14996c3b release: v1.2.0 — UI全局美化重设计 + CI/CD修复
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-03-01 22:35:36 +08:00
胡绍康andCopilot cf7817bb95 feat: UI全局美化重设计 + 恢复CI/测试/文档
UI 改进:
- 设置页面内嵌显示(不再弹窗)
- 临时邮箱卡片添加验证码提取按钮
- 导入账号弹窗 textarea 样式优化
- 账号头像 8 色渐变轮转
- 临时邮箱页顶栏邮箱点击复制
- 邮箱管理页自动选中默认分组
- 切换分组时重置邮件列 UI
- 修复收件箱/垃圾邮件 Tab 切换(.folder-tab → .email-tab)
- 修复从临时邮箱返回后账号列数据残留
- 仪表盘分组列表可点击导航

恢复:
- 恢复 .github/ CI 工作流
- 恢复 tests/ 测试目录
- 恢复 docs/ 文档目录
- 恢复 CONTRIBUTING.md, SECURITY.md

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-03-01 21:24:06 +08:00
胡绍康andClaude Opus 4.6 ba83ca3bf6 chore: 准备开源发布 - 只保留源代码
移除所有非源代码文件:
- 删除 docs/ 目录(所有内部文档)
- 删除 tests/ 目录(所有测试文件)
- 删除 .github/ 目录(CI/CD 配置)
- 删除 .kiro/ 目录(IDE 配置)
- 删除 CONTRIBUTING.md, SECURITY.md

更新项目文件:
- 重写 README.md,简洁清晰(从 1600+ 行压缩到 237 行)
- 更新 .gitignore,忽略所有非源代码文件
- 使用 ASCII art 展示界面布局
- 添加 Shields.io 徽章美化项目

保留的文件:
- 源代码:outlook_web/, static/, templates/
- 入口文件:web_outlook_app.py, start.py, outlook_mail_reader.py
- 配置文件:requirements.txt, Dockerfile, .dockerignore, .env.example
- 项目文档:README.md, LICENSE, .gitignore

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-01 21:11:55 +08:00
胡绍康andClaude Opus 4.6 39854520e6 chore: 准备开源发布 - 清理项目文件
- 更新 .gitignore,忽略所有文档和临时文件
- 删除迁移痕迹文件(AI提示词、PRD文档等)
- 更新 README.md,移除截图引用
- 只保留源代码用于开源发布

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-01 20:41:51 +08:00
胡绍康 7c6a794dfa chore(release): v1.1.1 2026-02-28 20:21:49 +08:00
胡绍康 20aa93be22 chore(release): v1.1.0 2026-02-27 17:04:20 +08:00
胡绍康andClaude Opus 4.6 0ab50db85f feat: 实现可调整布局系统
- 新增布局管理器支持拖拽调整面板宽度
- 新增状态管理器实现布局持久化
- 重构前端页面结构优化四栏式布局
- 新增 Jest 测试框架和完整测试用例
- 完善项目文档(PRD/FD/TDD/TODO/LOG)
- 清理 Python 缓存文件并更新 .gitignore

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-27 14:49:36 +08:00
胡绍康andClaude Opus 4.6 2aca6d9954 fix: 修复安全问题和错误处理改进
P0 安全修复:
- 添加 IP 信任链验证,防止 X-Forwarded-For 伪造攻击
- 导出验证 token 增加 IP 和 User-Agent 绑定校验
- 改用请求头传递导出 token,避免 URL 泄露

P1 改进:
- 错误响应自动使用正确的 HTTP 状态码(400/500)
- 4xx 错误使用 WARNING 日志级别,5xx 使用 ERROR

P2 文档更新:
- 更新 CLAUDE.md 架构说明,体现 controllers 层
- 添加 TRUSTED_PROXIES 和 PROXY_FIX_ENABLED 配置说明
- 修正登录锁定时长为 5 分钟

P3 工程卫生:
- 清理乱码字符
- 删除意外创建的 nul 文件

测试修复:
- 更新测试以适应新的 HTTP 状态码行为
- 添加测试前清理登录限制记录的逻辑

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-25 16:11:33 +08:00
胡绍康andClaude Opus 4.6 8738bd1fff refactor: 移除 legacy 依赖,迁移调度器到 services
新增文件:
- services/scheduler.py: 定时任务调度器服务
  - init_scheduler(): 初始化调度器
  - configure_scheduler_jobs(): 配置定时任务
  - scheduler_heartbeat_task(): 心跳任务
  - scheduled_refresh_task(): 定时刷新任务
  - should_autostart_scheduler(): 判断是否自动启动

更新文件:
- app.py: 移除 legacy 导入,使用 middleware 和 services/scheduler
- controllers/settings.py: 使用 services/scheduler 替代 legacy
- web_outlook_app.py: 直接从各模块导出兼容函数,移除 impl 代理

测试修复:
- tests/test_core_features.py: 修复 mock 从 impl 到 graph_service

架构改进:
- 完全移除对 outlook_web.legacy 的运行时依赖
- legacy.py 现仅作为参考保留,不再参与运行时调用

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-25 12:14:16 +08:00
胡绍康andClaude Opus 4.6 f31f042d89 feat: 迁移 accounts 模块批次 2 到 controllers 层 - 完成 accounts 全部迁移
迁移的路由(8个):
- Token 刷新:api_refresh_account, api_refresh_all_accounts,
  api_retry_refresh_account, api_refresh_failed_accounts,
  api_trigger_scheduled_refresh
- 刷新日志:api_get_refresh_logs, api_get_account_refresh_logs,
  api_get_failed_refresh_logs, api_get_refresh_stats

架构改进:
- 移除 routes/accounts.py 中的 impl 参数依赖
- 移除 app.py 中 accounts 蓝图的 legacy 传递
- 使用 services/refresh.py 的流式刷新服务
- 使用 repositories/settings.py 获取设置
- 使用 repositories/refresh_logs.py 记录刷新结果

里程碑:
- accounts 模块全部 20 个路由迁移完成
- 所有 54 个 API 路由迁移完成(100%)

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-25 10:56:47 +08:00
胡绍康andClaude Opus 4.6 5e4e5dcb64 feat: 迁移 accounts 模块批次 1 到 controllers 层
迁移的路由(12个):
- 基础 CRUD:api_get_accounts, api_get_account, api_add_account,
  api_update_account, api_delete_account, api_delete_account_by_email
- 批量操作:api_search_accounts, api_batch_update_account_group,
  api_batch_delete_accounts, api_batch_manage_tags
- 导出功能:api_export_all_accounts, api_export_selected_accounts,
  api_generate_export_verify_token

修复:
- parse_account_string 函数支持 refresh_token 包含 '----' 分隔符
- api_generate_export_verify_token 使用正确的 auth 模块函数

剩余 accounts 模块路由(8个)暂保留 legacy 实现:
- Token 刷新相关:refresh, refresh-all, retry-refresh, refresh-failed
- 刷新日志相关:refresh-logs, account-refresh-logs, refresh-stats, trigger-scheduled-refresh

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-25 10:23:07 +08:00
胡绍康andClaude Opus 4.6 66d9b9749b feat: 批量操作与自动化增强 - 全选/复制验证码/自动轮询
功能实现:
- 全选功能:跨分组保持选中状态,使用全局 Set 存储
- 验证码提取:支持 Graph API → IMAP 回退策略
- 自动轮询:新邮件通知、红点提示、连续错误自动停止

BUG 修复 (BUG-001 ~ BUG-008):
- Toast 通知位置移至右下角
- 切换分组时保持全选状态
- 添加批量删除邮箱功能
- 验证码提取支持 IMAP 回退
- 修复轮询开关类型不一致 (boolean vs string)
- 完善轮询通知内容与红点位置
- 轮询次数校验改为 0-100 (0 表示持续)
- 复制按钮添加加载状态与反馈

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-24 21:03:53 +08:00
胡绍康andClaude Opus 4.6 a9b3e4254f fix: 修复临时邮箱生成失败的BUG (BUG-00001)
【问题描述】
- 用户生成临时邮箱时返回笼统错误:生成临时邮箱失败,请稍后重试
- 错误码:LEGACY_ERROR,无法定位具体失败原因
- 可能原因:API Key未配置、网络问题、API服务不可用等

【修复内容】
1. 改进 gptmail_request 函数
   - 添加 API Key 配置检查
   - 区分 10+ 种错误类型(CONFIG_ERROR, AUTH_ERROR, TIMEOUT_ERROR等)
   - 返回结构化错误信息

2. 改进 generate_temp_email 函数
   - 返回值改为 (email_addr, error_msg) 元组
   - 保留详细错误信息

3. 改进 api_generate_temp_email 函数
   - 使用详细错误信息返回给前端
   - 添加日志记录

4. 更新前端错误提示
   - 显示详细的错误信息

5. 编写单元测试
   - 新增 11 个单元测试
   - 更新 2 个现有测试的 mock

【测试结果】
- 所有测试通过:51/51 ✅

【相关文档】
- BUG文档:docs/BUGS/BUG-00001-临时邮箱生成失败.md

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-23 20:52:27 +08:00
胡绍康andClaude Opus 4.6 192240436d refactor: 模块化架构重构 & 完善测试与文档体系
- 架构重构:拆分为 routes/services/repositories/security 分层结构
- 新增测试:添加完整的单元测试套件(烟雾测试/核心功能/错误处理等)
- 完善文档:添加开发者指南、运行验证、回归清单、性能基线等文档
- 前后端分离:静态资源独立,模板组件化
- CI/CD:添加 GitHub Actions 自动化测试
- Docker 优化:添加健康检查,修复调度器启动问题
- 配置增强:支持 SCHEDULER_AUTOSTART 环境变量

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-23 18:54:16 +08:00