TommyFang2077/gh-tea-npm-dsh

gh-tea-npm-dsh

npm
license
topic

简体中文 · English

一个 DeepSeek Harness（dsh）插件，把 GitHub（gh）、Gitea（tea） 和 npm 带进 agent。它检测并安装 CLI，用明确的选项引导用户完成认证，并操作 issue、发布包。

功能

gh / tea

- 检测安装、版本、鉴权状态、token 环境变量（值打码）
- 一键安装：有 Homebrew 用 Homebrew，否则免 sudo 安装二进制到 ~/.local/bin
- 引导式认证：环境变量导入 / 浏览器 OAuth 设备流 / 手动 token
- issue 操作：list · view · create · comment · close · reopen

npm

- 检测 node/npm、登录状态（npm whoami）、registry
- 引导式登录：浏览器 OAuth 设备流（npm login --auth-type=web）或 Automation token
- 发布包（npm publish --access public）
- 90 天 token 过期提醒与轮换引导

技能

- 注册配套 gh-tea-npm 技能，记录工作流，并把各 CLI 自带的 --help 作为权威命令源

环境要求

- Node.js ≥ 18 和 npm（用于 npm 工具）
- gh 和 tea 可选——缺失时插件可自动安装

安装

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

这是一个纯 Host 插件包：cordis.patch.yml（由包的 dsh.bundle 清单引用）插入插件行，dsh/index.js 注册工具和技能。

引导式配置

插件从不提出开放式问题：它返回一个菜单，agent 把它呈现为选项，用户一次推进一步。

gh / tea —— gitclis_configure：

1. gitclis_configure method=auto → 当前状态 + 下一步菜单
2. 用 gitclis_install 安装缺失的 CLI，或选择 token 来源：
- 环境变量导入 → method=env
- 浏览器 OAuth（GitHub）→ method=web（返回设备码）→ method=poll 验证
- 手动 → gitclis_set_token
3. 用 gitclis_status 验证

npm —— npm_configure：

1. npm_configure method=auto → 当前状态 + 下一步菜单
2. 浏览器 OAuth → method=web（返回登录链接）→ method=poll 验证，或 Automation token → method=token
3. 用 npm_publish 发布（或 npm_publish dry_run=true）

npm token 政策（90 天）

npm 现在把 access token（包括 Automation token）的最长有效期限制为 90 天。过期会中断 npm publish，请在到期前轮换：

- 在 https://www.npmjs.com/settings//tokens/new 生成新的 Automation token，再用 npm_configure method=token；或
- 重新运行 npm_configure method=web。

npm_status 会提示该政策，npm_configure 引导轮换。

工具

| 工具 | 说明 |
| --- | --- |
| gitclis_status | 检测 gh/tea 安装、版本、鉴权、环境 token（打码） |
| gitclis_configure | gh/tea 引导式配置 —— auto/env/web/manual/poll |
| gitclis_install | 一键安装 gh 和/或 tea |
| gitclis_set_token | 写入 gh/tea token（不回显） |
| gitclis_token_env | 读取/导入 token 环境变量 |
| gitclis_issue_list | 列出 issue |
| gitclis_issue_view | 查看单个 issue（可带评论） |
| gitclis_issue_create | 创建 issue |
| gitclis_issue_comment | 评论 issue |
| gitclis_issue_close | 关闭 issue |
| gitclis_issue_reopen | 重新打开 issue |
| npm_status | 检测 node/npm、登录状态、registry |
| npm_configure | npm 引导式认证 —— auto/web/token/poll |
| npm_publish | 发布到 npm |

issue 工具接受 provider 参数：github → gh，gitea → tea。

技能

配套技能在运行时注册，也以文件形式随包发布在 skills/gh-tea-npm/SKILL.md。它记录了 issue 工作流配方、认证流程和 npm token 政策，并指向 gh  --help、tea  --help、npm  --help 获取精确的命令标志。

目录结构

dsh/index.js        Host Cordis 插件 —— 注册工具 + 注册 gh-tea-npm 技能
cordis.patch.yml    dsh bundle 层 —— 插入本包
skills/gh-tea-npm/  配套技能 markdown
package.json        dsh + exports 清单

License

MIT