sakthiveltofficial/dsh-gmail-plugins 预览 preview

sakthiveltofficial/dsh-gmail-plugins

Plugin插件 ⭐ 2 MIT Models & Routing模型与路由

A complete, production-ready Gmail plugin for DeepSeek Harness (DSH). It gives the agent typed, policy-aware access to Gmail over the official Gmail and People REST APIs — 63 model-facing tools (send, search, draft, label, filter, thread, settings, contacts) and 2 polling triggers — with automatic OAuth2 token management.

catalog descriptioncatalog 简介 / catalog description:dsh-gmail: Gmail plugin suite for DeepSeek Harness — 61 model-facing tools + 2 polling triggers over the Gmail & People APIs (OAuth2)

Project Overview项目介绍

This is a DSH-native Cordis plugin that adds 63 Gmail tools and 2 polling triggers to DeepSeek Harness agents. It connects to the official Gmail and People REST APIs to give agents full, policy-aware access to all core Gmail functionality, from reading and sending emails to managing labels, filters, account settings, and contacts. To install the plugin, you run the DSH CLI command dsh plugin --profile web add github:sakthiveltofficial/dsh-gmail-plugins then add one row to your profile patch or agent preset. It requires no build step, as the repository root is directly the installable package.

The plugin handles automatic OAuth2 token management, with interactive one-click authorization that opens the Google consent page in your browser and captures the refresh token automatically after sign-in. You only need to set your GMAIL_CLIENT_ID and GMAIL_CLIENT_SECRET as environment variables; credentials are never stored as plaintext in your plugin configuration. Access tokens are cached in memory only, and automatically refreshed when needed. Destructive tools like permanent deletes are clearly labeled, and require explicit user confirmation before running. It is built for developers who want to extend their DSH agents with full Gmail capability for automated email workflows.

The plugin requires Node.js version 20 or higher, because it relies on the global fetch API that was stabilized in this Node release. You also need a working DeepSeek Harness instance with an existing profile, and a Google Cloud OAuth client that has the Gmail and People APIs enabled. The plugin follows the minimum privilege principle, so you can drop unneeded scopes like gmail.settings.basic or contacts.readonly if you don’t use those features. It is released under the open-source MIT license, and syntax checks are run on all code before each release.

这是一个专为DeepSeek Harness(DSH)开发的原生Gmail插件,基于官方Gmail和People REST API,为DSH代理提供63个Gmail相关工具以及2个轮询触发器,涵盖收发邮件、搜索整理邮箱、管理邮箱设置和联系人等完整功能,支持自动OAuth2令牌管理。安装可通过DSH CLI命令直接从本仓库拉取,无需额外编译构建步骤。

该插件面向需要让DSH代理处理Gmail邮箱事务的开发者,典型工作流为:安装完成后,先配置Google Cloud OAuth客户端的对应环境变量,再运行gmail_authorize工具完成交互式谷歌登录,工具会自动捕获并存储刷新令牌。之后代理即可调用各类Gmail工具完成指定任务,轮询触发器会自动监测新收到和已发送的邮件。

该插件要求宿主环境安装Node.js 20及以上版本,以及已配置好运行的DeepSeek Harness实例,还需要用户提前在Google Cloud创建启用Gmail API的OAuth客户端。代码以MIT许可证开源,永久删除类工具有明确提示,要求用户确认后才可执行,密钥仅保存在环境变量中不会写入配置文件。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 2 warnings2 项注意
  • Only 2 stars - very few users, little community feedback星标只有 2,几乎没人在用,遇到问题缺少社区反馈
  • No DSH plugin manifest detected - it may only carry the dsh-plugin topic, so the install method must be confirmed on the spot未检测到 DSH 插件清单:可能只是打了 dsh-plugin 话题,安装方式要现场确认
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 github:sakthiveltofficial/dsh-gmail-plugins

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

READMEREADME

dsh-gmail · Gmail Plugin for DeepSeek Harness

DSH-GMAIL — The Gmail Capability for DeepSeek Harness

License: MIT

A complete, production-ready Gmail plugin for DeepSeek Harness (DSH). It gives the agent typed, policy-aware access to Gmail over the official Gmail and People REST APIs — 63 model-facing tools (send, search, draft, label, filter, thread, settings, contacts) and 2 polling triggers — with automatic OAuth2 token management.

Official ecosystem keyword: this is a dsh-plugin — add the dsh-plugin GitHub topic to this repository.


🤖 LLM-readable summary

  • What: a single Cordis plugin that extends DSH agents with 63 gmail_* tools + 2 polling triggers.
  • Install: dsh plugin --profile web add github:sakthiveltofficial/dsh-gmail-plugins, then add one row to your profile patch (or agent preset) — see Install.
  • Tools: gmail_send_email, gmail_fetch_emails, gmail_fetch_message_by_message_id, gmail_fetch_message_by_thread_id, gmail_list_threads, gmail_reply_to_thread, gmail_create_email_draft, gmail_send_draft, gmail_forward_message, label/filter/trash/settings/contacts tools — the full list is in the tool table.
  • Auth: OAuth2 (gmail.modify, gmail.settings.basic, gmail.compose, gmail.send, contacts.readonly scopes). Credentials are never stored in config — env-var references resolved per operation via ctx.credentials. gmail_authorize runs the interactive Google sign-in and captures + stores the refresh token automatically; only GMAIL_CLIENT_ID / GMAIL_CLIENT_SECRET need to be set.
  • Triggers: gmail/message-received (new mail) and gmail/message-sent (sent mail) — poll-based, seeded on first activation so the mailbox is never replayed.
  • Runtime requirements: DeepSeek Harness, Node.js ≥ 20 (global fetch), and a Google Cloud OAuth client with the Gmail (and People) API enabled.
  • Safety: permanent deletes (gmail_delete_message, gmail_batch_delete_messages, gmail_delete_thread, gmail_delete_label) are clearly labeled and require explicit user confirmation; the agent is prompted to prefer trash over permanent deletion unless the user asked for irreversible removal.
  • License: MIT.

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

← 上一个 Prev GovernLoop-DSH 下一个 Next dsh-computer-use →