dsh-wordpress-admin:在 DSH 裏通過 REST API 管理 WordPress 與 WooCommerce

前言

在 DeepSeek Harness(DSH)裏做站點運維或內容協作時,常見做法是手寫 curl、維護一長串 REST 端點說明,或單獨再跑一層 MCP。WordPress 與 WooCommerce 的接口面很廣,智能體容易在「該用哪個路由、要帶什麼 capability」上耗掉大量輪次。下面介紹社區插件 dsh-wordpress-admin(維護者 engbonuonga),它把站點管理收成五個面向對話的工具,走 WordPress REST API 與應用密碼(Application Password),在 Harness 裏完成文章、頁面、商品、媒體、主題、插件等操作。

這是什麼

dsh-wordpress-admin 的定位是:在 DeepSeek Harness 中,對單個(可配置多行)WordPress 站點做完整管理與 WooCommerce 商店操作,底層僅依賴 Node 內置 fetch,運行時無需額外 MCP 進程,也不要求在 WordPress 側安裝配套插件即可完成核心能力。社區目錄 SkillHub 插件頁 將其歸類爲聯網工具;源碼與說明見 GitHub 倉庫,當前包版本爲 0.1.1,許可證 MIT。

與「自行拼裝 REST 調用」相比,插件把能力按場景拆成 wp_site、wp_content、wp_media、wp_shop、wp_admin,工具說明與錯誤信息隨宿主語言支持英文與中文(locale: auto | en | zh)。

環境與依賴

使用前請對照 README 中的要求表覈對環境:

項目 要求
DeepSeek Harness 0.2.x
Node.js 22.19 或更新(Harness 運行時一般已滿足)
WordPress 6.0+,REST API 可達,已啓用 Application Passwords
WooCommerce 可選,使用 wp_shop 時需要
站點賬號 管理員,或具備你所用操作對應 capability 的角色

核心功能

插件暴露 五個工具,對應 README 能力說明(參數細節見倉庫內 docs/TOOLS.md):

工具 作用
wp_site 連接信息、能力報告、健康與延遲、讀取與更新站點設置
wp_content 文章、頁面及任意啓用 REST 的文章類型:列表、讀取、創建、更新、刪除
wp_media 媒體庫:列表、讀取、上傳(URL / base64 / 工作區文件)、更新 alt/標題/說明、刪除
wp_shop WooCommerce 產品、變體、訂單、優惠券、客戶與評價,含批量操作
wp_admin 插件(列表/安裝/啓用/停用/刪除)、主題(列表/激活)、區塊模板、菜單(需橋接插件時見下文)

默認安全策略:所有刪除類操作在 allowDestructive: false(默認)時被拒絕;憑據優先通過環境變量注入,避免寫入明文配置。憑據只發往配置的 siteUrl。

經典菜單與主題菜單位置:WordPress 核心 REST 未暴露時,可選用同倉庫內的可選配套插件 wordpress-plugin/dsh-bridge。

已知限制(以 README 爲準):核心 REST 不支持在線安裝主題,wp_admin 只能列出並激活已安裝主題;單配置行對應一個站點,多站需增加不同 id 的配置行;上傳上限約 25 MB,大文件宜用公開 URL 或工作區路徑。

安裝與啓用

DSH 生態強調「一切皆插件」;SkillHub 爲社區目錄,與 DeepSeek / 幻方無官方從屬關係。安裝方式以倉庫 README 爲準,不要憑倉庫名自行拼接 CLI 安裝命令。

從插件市場安裝

  1. 在 DSH 打開 Plugins → Discover。
  2. 搜索 dsh-wordpress-admin 並安裝 bundle。市場從本倉庫最新 GitHub Release 的 dsh-wordpress-admin.tgz 讀取包,無需 npm 賬號。

從本地包目錄安裝

將本插件文件夾的絕對路徑通過 DSH 插件安裝器安裝(Plugins 頁「從包目錄安裝」,或等價的 plugin_manager install 動作)。bundle 的 patch 會自動應用,安裝後需重啓應用。

說明: 插件以當前 DSH 進程的用戶權限與網絡能力運行;安裝前請自行查看源碼與 MIT 許可證,確認憑據與 destructive 開關策略符合你的安全基線。

配置

編輯當前 profile 的 patch 文件 ~/.dsh/profiles/<profile>/cordis.patch.yml,在插入行中寫入插件配置(片段來自 README):

- insert:
    - id: dsh-wordpress-admin
      name: dsh-wordpress-admin
      config:
        siteUrl: https://example.com
        username: admin
        appPasswordEnv: DSH_WP_APP_PASSWORD
        # WooCommerce (optional)
        wooKeyEnv: DSH_WOO_CONSUMER_KEY
        wooSecretEnv: DSH_WOO_CONSUMER_SECRET
        locale: auto            # auto | en | zh
        allowDestructive: false # true enables delete actions
        timeoutMs: 30000
        maxRetries: 2
        perPageDefault: 20

在啓動 DSH 的環境中設置密鑰(勿提交到版本庫)。Linux / macOS 示例:

export DSH_WP_APP_PASSWORD="xxxx xxxx xxxx xxxx xxxx xxxx"

Windows 可使用 setx DSH_WP_APP_PASSWORD "..."。也可在配置中內聯 appPassword、wooConsumerKey、wooConsumerSecret,但 patch 爲明文,仍建議環境變量。

完整步驟(創建 Application Password、WooCommerce API 密鑰等)見倉庫 docs/SETUP.md。

典型用法

README 中的對話示例可直接復現思路,例如:

  1. 先用 wp_site 確認站點可達,再用 wp_content 列出最新五條草稿文章。
  2. 要求模型以草稿創建指定標題與字數的文章,設置特色圖 URL,並歸入指定分類。
  3. 將工作區中的 PDF 上傳到媒體庫、設置 alt 文本,再掛到指定頁面 ID。

進行插件安裝、切換主題或修改站點設置前,建議在對話中讓模型先確認操作範圍;日常內容工作可考慮使用 capability 更窄的 WordPress 用戶。

適用場景與注意

適合: 已在 DSH 中開發或運營 WordPress / WooCommerce 站點、希望用自然語言驅動內容發佈、商品與媒體維護,又不想維護獨立 MCP 或手寫 REST 腳本的團隊或個人。

注意:

  • Application Password 可在 WordPress「用戶 → 個人資料 → Application Passwords」隨時吊銷;插件僅使用該密碼訪問配置的站點。
  • 特權操作(裝插件、換主題、改設置)影響面大,默認關閉刪除,並不等於無風險。
  • 主題安裝仍需 WordPress 後臺或 WP-CLI;菜單高級能力依賴可選 dsh-bridge。

結尾

dsh-wordpress-admin 把 WordPress 與 WooCommerce 的日常管理收斂爲五個 Harness 工具,REST + 應用密碼,默認拒絕刪除、支持中英文提示。安裝與配置以 README 與市場 bundle 爲準。

  • 社區目錄:https://www.skillhub.cn/plugins/engbonuonga/dsh-wordpress-admin
  • 源碼與文檔:https://github.com/engbonuonga/dsh-wordpress-admin
羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

小夜