TommyFang2077/gh-tea-npm-dsh

Plugin插件 Native原生 ⭐ 3 MIT Dev Workflow开发与代码工作流

GitHub (gh) + Gitea (tea) + npm 命令行工具,用于 DeepSeek Harness (dsh):引导式认证/配置、问题与包管理工具

Project Overview项目介绍

This is a native plugin built exclusively for DeepSeek Harness (DSH), that integrates the GitHub (gh), Gitea (tea) CLIs and the npm package manager directly into the DSH agent workflow. It automatically detects existing installations of these tools, checks their versions and auth status, and offers a one-command install if they are missing on your system. If you use Homebrew, it will install via Homebrew by default, otherwise it installs a sudo-free binary to ~/.local/bin. To install the plugin, you can simply run the one-line command npx -y @deepseek-ai/dsh plugin add @tommyfang/gh-tea-npm-dsh in your terminal, which completes the full setup automatically.

After installation, the plugin guides you through step-by-step configuration with clear menu options, so you never have to answer open-ended questions that confuse the agent workflow. For gh and tea, you can configure authentication automatically, import existing tokens from environment variables, use a browser-based OAuth flow, or enter a manual token. It supports full Issue lifecycle management: you can list, view, create, comment on, close, and reopen issues for both GitHub and Gitea. For npm, it detects your existing node and npm installation, checks your login status and current registry, and supports browser OAuth login and automated token authentication. This plugin is ideal for Node.js developers who use DSH for daily development workflows.

The core requirement for this plugin is Node.js version 18 or higher, along with a working npm installation on your local system. The gh and tea CLIs are optional, because the plugin will automatically detect if they are missing and install them for you. NPM now enforces a 90-day expiration policy for all access tokens, including automation tokens commonly used for package publishing. This plugin will notify you of upcoming token expiration and guide you through the full token rotation process to avoid broken npm publish workflows. The plugin is released under the permissive MIT open source license, so you can use it freely for both personal and commercial development projects.

这是一款专为DeepSeek Harness(DSH)开发的原生插件,将GitHub(gh)、Gitea(tea)命令行工具和npm包管理器集成到DSH代理中。它可以自动检测这些工具是否已安装,缺失时支持一键安装,还能引导用户分步完成身份验证。你可以通过命令 npx -y @deepseek-ai/dsh plugin add @tommyfang/gh-tea-npm-dsh 一键完成插件的安装配置。

该插件支持对gh/tea的Issue进行全流程管理操作,包括列出、查看、创建、评论、关闭和重开Issue,同时支持npm公共包的发布操作,还会主动提醒用户npm访问令牌90天的有效期限制,并引导用户完成令牌轮换。它面向需要在DSH代理中完成GitHub/Gitea协作和npm包发布开发工作的Node.js开发者。

该插件要求用户本地环境中预先安装Node.js 18及以上版本和npm,gh和tea属于可选工具,插件检测到缺失后会自动为用户完成安装。它全程采用菜单引导式配置,不会提出开放式问题,用户可以按步骤逐步完成配置。本插件采用MIT开源许可证,免费供开发者使用。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 1 warning1 项注意
  • Only 3 stars - very few users, little community feedback星标只有 3,几乎没人在用,遇到问题缺少社区反馈
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命令行安装

npx -y @deepseek-ai/dsh plugin add @tommyfang/gh-tea-npm-dsh

把 TommyFang2077/gh-tea-npm-dsh 加入你的 DSH 配置(web profile)即可启用。

READMEREADME

gh-tea-npm-dsh

npm license topic

English · 简体中文

A DeepSeek Harness (dsh) plugin that brings GitHub (gh), Gitea (tea), and npm into the agent. It detects and installs the CLIs, guides the user through authentication with explicit choices, and operates issues and publishes packages.

Features

gh / tea

  • detect installation, version, auth status, and token environment variables (values masked)
  • one-command install — Homebrew when available, otherwise a no-sudo binary into ~/.local/bin
  • guided auth: import from env, browser OAuth device flow, or manual token
  • issues: list · view · create · comment · close · reopen

npm

  • detect node/npm, login state (npm whoami), and registry
  • guided login: browser OAuth device flow (npm login --auth-type=web) or automation token
  • publish packages (npm publish --access public)
  • 90-day token expiry notice and rotation guidance

Skill

  • registers a companion gh-tea-npm skill that documents the workflows and points at each CLI's own --help as the authoritative command surface

Requirements

  • Node.js ≥ 18 and npm (for the npm tools)
  • gh and tea are optional — the plugin installs them if missing

Install

npx -y @deepseek-ai/dsh plugin add @tommyfang/gh-tea-npm-dsh

This is a host-only bundle: cordis.patch.yml (referenced by the package's dsh.bundle manifest) inserts the plugin row, and dsh/index.js registers the tools and the skill.

Guided configuration

The plugin never poses open-ended questions. It returns a menu, the agent presents it as options, and the user advances one step at a time.

gh / tea — gitclis_configure:

  1. gitclis_configure method=auto → current state + next-step menu
  2. install a missing CLI with gitclis_install, or pick a token source:
    • env import → method=env
    • browser OAuth (GitHub) → method=web (returns a device code) → method=poll to verify
    • manual → gitclis_set_token
  3. verify with gitclis_status

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-codeui 下一个 Next dsh-client-ui-monitor →