dsh-outlook

dsh-outlook

在 IT 不给你 Graph API 权限的公司电脑上，让 AI 直接操作你正在用的 Outlook。 零凭据 · 零管理员权限 · 发任何东西都先问你。

Zero-credential Outlook automation for AI agents on Windows: drives your local desktop Outlook client via COM. No Graph API app registration, no SMTP passwords, no tenant admin rights — everything that leaves the machine passes a three-layer human approval gate.

你什么时候需要它？

1. 公司电脑装了经典版 Outlook，但 IT 不让你注册 Azure 应用——所有 Graph API 方案（outlook-mcp 等）第一步就死在 app registration 上，这个插件不需要：它直接驱动你已经登录的桌面客户端。
2. 想让 AI 当邮件秘书：早上到工位问一句"有什么新邮件"，它读给你听；说"回复这封，就说周三可以"，它起草、引用原文、弹窗给你过目后发出。
3. 要约会议但不知道谁有空：一句话查同事 free/busy、搜会议室空闲时段，邀请发出前同样先给你确认。

它会交付什么？

18 个 AI 工具（读操作自动执行；任何外发动作必须过确认弹窗）：

外加一个侧边栏角标：新邮件到达时 Outlook 按钮出现红色计数，点击弹层列出最新到达；点击弹层中的邮件可直接在 Outlook 中打开（自动标记已读、角标减 1），悬停预览。会话聊天里的 [打开] markdown 链接同样点击即开：插件在页面内拦截左键点击并原地触发（无新标签页，页面底部 toast 提示）。

快速开始

# npm 短名安装（推荐）
dsh plugin --profile web add dsh-outlook
# 或直接从 GitHub
dsh plugin --profile web add https://github.com/UnknowCao/dsh-outlook

然后重启 profile（或依赖 patchReload: live）。没有第二步——不配置凭据、不注册应用、不改 Outlook 设置。

前置条件：Windows + 经典桌面版 Outlook（Win32 OUTLOOK.EXE）已登录 + Windows PowerShell 5.1（系统自带）。无需租户管理员权限。

触发方式（装完试着说）

• "有什么新邮件？"
• "搜一下上周张三发的关于交付物的邮件"
• "把这封转给李四，附言说请他确认"
• "帮我约下周三和王五的会，先看看他什么时候有空"
• "找一间明天下午两点到三点空闲的宁波会议室"

它和同类方案有什么不同？

安全边界

任何离开这台机器的动作——发邮件、发会议邀请——都要过三道互相独立的门：

1. 两轮确认协议：第一次调用只返回"将要发送什么"的明细，AI 必须原样展示给你、你明确允许后，带 confirmed:true 重试才执行；
2. 内容哈希绑定：确认时展示的内容与最终发送的内容做 SHA-256 比对——给你看 A、实际发 B 的偷换在 host 层即被强制退回重新确认；
3. 桥接层令牌：PowerShell 桥独立拒绝一切没有一次性 OLK_CONFIRM 令牌的发送路径——即使未来某个 bug 或新工具绕过前两层，令牌不出，邮件不发。

它不会做的事：不静默发送任何内容；不保存/不回传邮箱凭据（根本不接触）；草稿永不自动发送；附件保存拒绝路径穿越、拒绝覆盖已有文件。

已知边界：/olk-notify/* 路由仅本机可达并做同源校验（非浏览器/导航类请求与其它本机进程仍可读新邮件主题元数据）；会话内"点击打开"链接里的端口不影响普通左键点击（client 按路径名拦截后向页面自身 origin 发送）；/olk-notify/open 为 POST-only，修饰键/中键点击聊天链接会得到 405（有意行为，outlook_open_mail 工具不受影响）；多标签页共享同一待读队列；用 OLK_WATCH=0 环境变量可关闭新邮件监听。

文件结构

index.js          宿主半：18 个工具注册、两轮确认、内容哈希、watcher 管理、状态/打开路由
client.js         浏览器半：sidebar.footer.action 槽位按钮、角标、弹层（React Portal，点击打开）
lib/olk.ps1       COM 桥：全部 Outlook 操作 + 令牌门 + 本地化怪癖（见文件头注释）
lib/watch.ps1     NewMailEx 常驻监听：推送新邮件到达，崩溃 30s 自愈
cordis.patch.yml  宿主行声明
TESTCASES.md      49 个测试用例（链路/渲染/共存/路由/点击打开/链接拦截/已知边界）
CHANGELOG.md      版本叙事（为什么改）

诊断日志：%TEMP%\dsh-outlook-watch-debug.log（1MB 自动截断轮转）。

验证与测试

• 49 个用例覆盖全链路（TESTCASES.md），自动化项全部通过实测：新邮件推送→角标→清空、watcher 强杀 30s 自愈、两种确认偷换攻击拦截、路由 405/413、日志轮转截断、打开即已读、GBK 代码页回归、聊天链接点击拦截（v2.11.0 H 组）；
• COM 怪癖（Jet/DASL 双阶段过滤、Restrict 日期格式、IncludeRecurrences 的 MaxInt 计数、PS 5.1 stdin 编码）全部编码在 lib/olk.ps1 并经真实 Exchange 环境验证。