前言¶
在 DSH 中，智能體要操作 GitHub issue、Gitea issue 或發佈 npm 包時，往往要先處理 CLI 是否安裝、登錄態是否可用、token 從哪裏來、如何發佈等前置步驟。@tommyfang/gh-tea-npm-dsh 把這類流程做成插件工具：先檢測當前環境，再根據返回的菜單選擇安裝、導入 token、瀏覽器 OAuth 或手工 token，最後執行 issue 操作或 npm 發佈。
這是什麼¶
@tommyfang/gh-tea-npm-dsh 是一個 DeepSeek Harness（dsh）插件，面向 GitHub CLI（gh）、Gitea CLI（tea）和 npm。它提供 CLI 檢測/安裝、引導認證/配置、issue 操作和 npm 包發佈工具。插件由 TommyFang2077 維護，採用 MIT 許可證。
它以 host-only bundle 形式進入 dsh：cordis.patch.yml 插入插件條目，dsh/index.js 註冊工具和配套 skill。
核心功能¶
gh / tea¶
- 檢測
gh/tea的安裝情況、版本、認證狀態和 token 環境變量；token 值會被掩碼顯示。 - 一鍵安裝：優先使用 Homebrew，否則安裝不需要 sudo 的二進制到
~/.local/bin。 - 引導認證：支持從環境變量導入、瀏覽器 OAuth device flow、手工 token。
- issue 操作：支持列表、查看、創建、評論、關閉、重開。
npm¶
- 檢測 Node.js、npm、登錄狀態（
npm whoami）和 registry。 - 引導登錄：支持瀏覽器 OAuth device flow（
npm login --auth-type=web）或使用 automation token。 - 發佈 npm 包：使用
npm publish --access public。 - npm access tokens，包括 automation tokens，有 90 天生命週期上限；插件提供到期提醒和輪換引導。
配套 skill¶
插件註冊一個 gh-tea-npm 配套 skill，用於說明工作流，並把具體命令參數指向各 CLI 自身的 --help。
安裝與啓用¶
安裝前確認本機滿足 npm 工具要求：Node.js >= 18 和 npm。gh 和 tea 是可選組件；如果缺失，插件可以安裝。
運行下面命令安裝插件：
npx -y @deepseek-ai/dsh plugin add @tommyfang/gh-tea-npm-dsh
安裝後，插件會在 dsh 中註冊相應工具和 gh-tea-npm skill。
典型用法¶
下面列出插件提供的工具名和常見調用參數。插件不會提出開放式問題，而是返回當前狀態和下一步菜單，用戶按步驟選擇。
配置 gh / tea¶
先查看當前狀態和可選操作：
gitclis_configure method=auto
如果 CLI 未安裝，可以先安裝：
gitclis_install
選擇 token 來源時，可以從環境變量導入：
gitclis_configure method=env
也可以走瀏覽器 OAuth：
gitclis_configure method=web
gitclis_configure method=poll
這裏 method=web 會返回 device code，method=poll 用於驗證登錄狀態。
如果已經有手工 token，可以寫入：
gitclis_set_token
最後驗證 gh / tea 狀態：
gitclis_status
配置 npm¶
先查看 npm 環境和下一步菜單：
npm_configure method=auto
走瀏覽器登錄時：
npm_configure method=web
npm_configure method=poll
method=web 返回登錄 URL，method=poll 用於驗證。
如果使用 automation token：
npm_configure method=token
發佈 npm 包¶
可以先做 dry run：
npm_publish dry_run=true
確認無誤後再正式發佈：
npm_publish
issue 工具需要 provider 參數：github 走 gh，gitea 走 tea。
適用場景與注意¶
適合需要在 DSH 中讓智能體處理 gh / tea issue、配置登錄態、發佈 npm 包的開發者。它比較適合把“檢測、安裝、認證、發佈”串成固定流程的場景。
注意：
- npm 工具需要 Node.js >= 18 和 npm。
gh和tea可選，插件可安裝缺失的 CLI。- npm access tokens，包括 automation tokens，有 90 天生命週期上限，需要按引導輪換。
- 插件以當前 dsh 進程權限運行，會調用本機
gh、tea、npm並使用你配置的 token 或瀏覽器登錄態。安裝前應檢查源碼、許可證和將要執行的 CLI 操作。
結尾¶
gh-tea-npm-dsh 的價值在於把 GitHub、Gitea 和 npm 的常見前置操作收斂爲 dsh 工具：檢測環境、安裝 CLI、引導認證、操作 issue、發佈 npm 包，並提供 token 輪換提示。倉庫地址：https://github.com/TommyFang2077/gh-tea-npm-dsh
