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
羽毛球分组比赛记分
小程序二维码

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

小夜