前言¶
在 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 安裝命令。
從插件市場安裝¶
- 在 DSH 打開 Plugins → Discover。
- 搜索 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 中的對話示例可直接復現思路,例如:
- 先用
wp_site確認站點可達,再用wp_content列出最新五條草稿文章。 - 要求模型以草稿創建指定標題與字數的文章,設置特色圖 URL,並歸入指定分類。
- 將工作區中的 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