UnknowCao/dsh-outlook

Plugin插件 Native原生 ⭐ 2 MIT Productivity & Tasks效率与任务

Project Overview项目介绍

dsh-outlook is a native plugin built for DSH (DeepSeek Harness) that drives a locally signed-in classic desktop Outlook client on Windows through COM automation, eliminating the need for an Azure app registration, mailbox credentials, or tenant admin rights that Graph-API-based alternatives typically require. After installation the plugin registers 18 tools with the host, covering mail search, full message read, draft creation, send, reply/forward with quoted originals and original attachments, attachment save with path-traversal and overwrite protection, GAL people search, calendar query with recurring instance expansion, meeting invitation response/update/cancel, free/busy lookups in 30-minute granularity, and room finder with availability checks. Every outbound action — sending mail, dispatching invitations, modifying meetings, or cancelling them — is blocked unless it passes a built-in three-layer human approval gate.

A typical workflow starts with dsh plugin --profile web add dsh-outlook (or the GitHub URL) followed by a profile reload; no further configuration is needed because the plugin talks to the already-running OUTLOOK.EXE through COM and a bundled PowerShell bridge. From a chat session the user can ask natural-language questions such as "what new mail arrived?", "search last week's emails from Zhang San about the deliverable", "forward this to Li Si with a note asking him to confirm", or "book a meeting with Wang Wu next Wednesday — check his availability first". The plugin additionally renders a sidebar badge with red unread count, hover previews of new messages, and [open] markdown links that open the original mail inside desktop Outlook, mark it read, and decrement the badge, all without opening new browser tabs.

Dependencies are Windows plus a logged-in classic Outlook client plus PowerShell 5.1 (already shipped with Windows), and the project is released under MIT. The plugin never reads, caches, or exfiltrates mailbox credentials and drafts are never auto-sent. Outbound actions are forced through a two-round confirm protocol, a SHA-256 content-hash binding that rejects any swap between shown and sent content, and a one-shot OLK_CONFIRM token enforced at the PowerShell bridge layer; an OLK_WATCH=0 environment variable disables the NewMailEx watcher, and 49 documented test cases in TESTCASES.md describe known edges such as 405 on modifier-clicks and shared per-tab unread queues. Diagnostic logs rotate at 1 MB under %TEMP%\dsh-outlook-watch-debug.log.

dsh-outlook 是一款面向 DSH(DeepSeek Harness)的原生插件,专为 Windows 上已登录的经典桌面版 Outlook 而设计。它通过 COM 自动化直接驱动本地 Outlook 客户端(OUTLOOK.EXE),无需 Azure 应用注册、邮箱密码或租户管理员权限。一次安装会交付 18 个 AI 工具,覆盖邮件搜索、读取、草稿、发送、回复/转发、附件保存、通讯录搜索、日程查询、会议室空闲检查、会议邀请响应与取消等场景。任何外发动作(发邮件、发邀请、改期、取消)均必须经过内置的三层人审门控才会真正执行。

典型使用流程是:在 DSH 的 web profile 中通过 dsh plugin add dsh-outlook 安装并重启 profile,随后直接在对话里发出自然语言指令,例如"有什么新邮件?""把这封转给李四并附言请他确认""帮我约周三和王五的会"等。插件会在聊天中给出可点击的 [打开] 链接、侧边栏角标和悬停预览,让用户先看到 AI 准备发送的内容,确认后再放行。它特别适合在公司 IT 锁死 Graph API 注册权限、却仍想用 AI 充当邮件秘书和日程助手的办公用户。

依赖与限制方面,要求 Windows 系统、经典桌面 Outlook 已登录、Windows PowerShell 5.1(系统自带),插件以 MIT 协议开源;不读取或保存邮箱凭据,草稿永不自动发送,附件保存会做路径穿越与同名覆盖防护。所有出站动作强制走"两轮确认 + SHA-256 内容哈希比对 + PowerShell 桥一次性 OLK_CONFIRM 令牌"三重门控,首次使用前请阅读 TESTCASES.md 中的 49 个用例和已知边界说明。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 1 warning1 项注意
  • Only 2 stars - very few users, little community feedback星标只有 2,几乎没人在用,遇到问题缺少社区反馈
DSH walks through these 9 checksDSH 会逐条核对这 9 项

Compatibility兼容性

  • DSH, Node, OS and profile requirementsDSH 版本 / Node 版本 / 操作系统 / profile 是否满足要求
  • External dependencies and runtimes (Electron / Python / Docker, ...)外部依赖与运行时(Electron / Python / Docker 等)是否齐备
  • Conflicts with installed plugins: command names, skill / tool names, ports, duplicate MCP registration与已装插件是否冲突:命令名、skill / tool 重名、端口占用、重复 MCP 注册

Security安全性

  • Repo matches the facts registered here; archived or abandoned?仓库是否与页面登记一致,是否归档或长期停更
  • Safety of preinstall / install / postinstall and install.sh / setup.ps1preinstall / install / postinstall 与 install.sh、setup.ps1 是否安全
  • curl|bash, download-then-execute, obfuscation, unrelated domains → stop immediatelycurl|bash、下载即执行、混淆代码、无关域名 → 立刻停止
  • Typosquatting or unmaintained packages among the new dependencies新增依赖里有没有 typosquatting 或无人维护的包
  • Requested permissions vs. what the feature actually needs申请了哪些权限、是否超出功能所需(filesystem / network / shell / clipboard)
  • Any sudo / admin requirement, plus uninstall and rollback是否要求 sudo / 管理员权限,以及卸载与回滚方式

Anything uncertain must be marked unknown with a note on how to confirm it. This site's signal screen is a static snapshot, not a security audit.拿不准的必须标「未知」并说明要我怎么确认。本站的信号筛查是静态快照,不能替代安全审计。

Or use CLI install (for developers)或使用命令行安装(适合开发者)

CLI Install命令行安装

dsh plugin --profile web add dsh-outlook

把 UnknowCao/dsh-outlook 加入你的 DSH 配置(web profile)即可启用。

READMEREADME

dsh-outlook

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

DSH Plugin Platform License: MIT Tools

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_check_new 新邮件到达推送(侧边栏角标同步) 只读
outlook_search_mail 搜邮件(天数/文件夹/发件人/主题/日期区间/收件人侧),结果可贴点击打开链接 只读
outlook_read_mail 读全文(正文/收件人/附件名,超长截断) 只读
outlook_open_mail 在桌面 Outlook 窗口中打开邮件(标记已读、角标减 1) 本地动作
outlook_account 当前账户名/SMTP 只读
outlook_draft_mail 建草稿(永不发送,可带附件) 安全
outlook_send_mail 发邮件 三层人审
outlook_reply_mail 回复/全部回复/转发(自动引用原文,转发带原附件) 三层人审
outlook_calendar_query 未来 N 天日程(含例会展开) 只读
outlook_calendar_create 个人日程直接建;带参会人则发邀请 邀请需人审
outlook_meeting_requests 待响应的会议邀请列表 只读
outlook_respond_meeting 接受/暂定/拒绝会议邀请 人审(通知组织者)
outlook_meeting_update 改日程/会议(组织者自动通知参会人) 人审
outlook_meeting_cancel 取消会议(通知参会人)/删个人日程 人审
outlook_search_people 通讯录(GAL)搜人名/邮箱/别名 只读
outlook_freebusy 同事忙闲时段(30 分钟粒度) 只读
outlook_search_rooms 会议室搜索 + 指定时段空闲检查 只读
outlook_save_attachment 附件保存到本地(防路径穿越、不覆盖同名) 本地写

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

Showing the opening section of the README — the full document lives in the repository以上为 README 开头摘要,完整文档在仓库内 · View the full README on GitHub →在 GitHub 查看完整 README →

← 上一个 Prev dsh-branch-visualizer 下一个 Next dsh-skin →