siluzan-website-cli 1.0.1-beta.1 → 1.0.1-beta.3

package/dist/skill/SKILL.md

@@ -1,16 +1,16 @@
 ---
 name: siluzan-website
 description: >-
-  管理丝路赞 WordPress 站点（wp-k8s 托管）：列出我的站点、新增/编辑页面、从丝路赞目录安装插件。
-  当用户提到 WordPress、建站后台、新增页面、改官网、装插件、站点 guid、
-  siluzan-website、zionbuilder、visual-edit 时使用。不是 LPS / AI Sites，也不是 SEO JSON 生成。
+  管理丝路赞 WordPress 站点（wp-k8s 托管）：列出站点、页面/文章/产品、媒体、分类、插件。
+  当用户提到 WordPress、建站后台、新增页面、发文章、上传图片、改官网、装插件、
+  站点 guid、siluzan-website、zionbuilder、visual-edit 时使用。不是 LPS / AI Sites，也不是 SEO JSON 生成。
 ---
 
 # siluzan-website
 
 管理用户账号下的 **WordPress 站点**（TSO 建站 / wp-k8s）。通过 CLI 调平台 all-sites 与站点 WP REST，不要手写 curl，不要猜 guid / 页面 ID。
 
-**不是** `landing-page-system` 的 LPS Agent，也不是 `siluzan-seo` 的 schema 生成。用户要的是「我的官网加一页 / 看插件」才用本 Skill。
+**不是** `landing-page-system` 的 LPS Agent，也不是 `siluzan-seo` 的 schema 生成。用户要的是「我的官网加一页 / 发一篇资讯 / 上传图片 / 装插件」才用本 Skill。
 
 ## 一键安装
 
@@ -39,8 +39,13 @@ Windows 注意：部分 Agent 通过 PowerShell / cmd 代执行时可能失败
 | `siluzan-website config show/set/clear` | 查看 / 写入凭据 | [references/setup.md](references/setup.md) |
 | `siluzan-website init` / `update` | 写入 / 刷新 Skill 文件 | [references/setup.md](references/setup.md) |
 | `siluzan-website sites list` | 列出我的 WordPress 站点 | [references/sites.md](references/sites.md) |
-| `siluzan-website pages list/add/update` | 列出 / 新增 / 覆盖页面 | [references/pages.md](references/pages.md) |
-| `siluzan-website plugins list/catalog/install` | 已装列表 / 目录 / 安装并启用 | [references/plugins.md](references/plugins.md) |
+| `siluzan-website pages list/get/add/update/meta/trash` | Zion 页面 + 元数据 / 回收站 | [references/pages.md](references/pages.md) |
+| `siluzan-website content types/list/get/add/update/trash` | 文章/产品等 REST 类型 | [references/content.md](references/content.md) |
+| `siluzan-website media list/get/upload` | 媒体库 | [references/media.md](references/media.md) |
+| `siluzan-website terms …` | 分类 / 标签 | [references/terms.md](references/terms.md) |
+| `siluzan-website search` | 全站搜索 | [references/search.md](references/search.md) |
+| `siluzan-website plugins list/catalog/install/update/uninstall` | 已装列表 / 目录 / 安装 / 升级 / 卸载 | [references/plugins.md](references/plugins.md) |
+| `siluzan-website plugins helper-status/update-helper` | 查看 / 用镜像 zip 升级 helper | [references/plugins.md](references/plugins.md) |
 
 ---
 
@@ -50,26 +55,36 @@ Windows 注意：部分 Agent 通过 PowerShell / cmd 代执行时可能失败
 |--------------|------|--------|
 | 首次安装 / 登录 | `references/setup.md` | `login` 或复用已有 CSO/TSO 凭据 |
 | 我有哪些网站 | `references/sites.md` | `sites list`，不要猜 guid |
-| 加一页 / 改一页 | `references/pages.md` | 先 `sites list` 再 `pages add/update` |
-| 这个站装了哪些插件 | `references/plugins.md` | `plugins list` |
-| 安装 / 启用插件 | `references/plugins.md` | `catalog` 找 slug → 确认 → `install` |
+| 加一页 / 改一页正文 | `references/pages.md` | 先 `sites list` 再 `pages add/update` |
+| 改页面 slug / 状态 / 回收站 | `references/pages.md` | `pages meta` / `pages trash` |
+| 发资讯 / 改文章 / 产品字段 | `references/content.md` | `content types` → `list` → `add/update` |
+| 上传图片 | `references/media.md` | `media upload`，记下 id |
+| 分类标签 | `references/terms.md` | `terms list` 再 add/update |
+| 按关键词找内容 | `references/search.md` | `search --q` |
+| 这个站装了哪些插件 | `references/plugins.md` | `plugins list`（全部已装，不只是目录） |
+| 安装 / 启用目录插件 | `references/plugins.md` | `catalog` 找 slug → 确认 → `install --slug` |
+| 安装外部插件 | `references/plugins.md` | 确认 → `install --zip` |
+| 升级已装插件 | `references/plugins.md` | `list` 拿 plugin → 确认 → `update --plugin`；外部再加 `--zip` |
+| 卸载插件 | `references/plugins.md` | `list` 拿 plugin → 确认 → `uninstall --plugin` |
 
 ---
 
 ## AI 行为规范
 
 1. **计划 → 确认 → 执行 → 验证**
-   - 写操作（`pages add` / `pages update` / `plugins install`）会立刻生效，执行前必须复述目标站点与内容，获得用户确认。
-   - 只读（`sites list` / `pages list` / `plugins list` / `plugins catalog` / `config show`）可直接跑。
+   - 写操作（`pages add/update/meta/trash`、`content add/update/trash`、`media upload`、`terms add/update/delete`、`plugins install/update/uninstall/update-helper`）会立刻生效，执行前必须复述目标站点与内容，获得用户确认。
+   - 只读（`sites list`、`pages list/get`、`content types/list/get`、`media list/get`、`terms taxonomies/list`、`search`、`plugins list/catalog/helper-status`、`config show`）可直接跑。
 2. **不猜 ID**：站点用 `sites list` 的 `guid`；页面用 `pages list` 的 `id`。
 3. **先查再写**：改页面前先 `pages list` 确认目标页存在。
 4. **只认 API Key**：所有命令走 `x-api-key`（`SILUZAN_API_KEY` 或 `login` 写入的 config）。Agent 沙箱只注入 Key，不要向用户要 JWT，也不要设 `SILUZAN_AUTH_TOKEN`。
 5. **命令透明**：用一句话说明意图（「正在列出您的站点」），不要把整段命令当主回复；用户要细节时再给完整命令。
-6. **失败先自救**：401 → 引导重新 `login`；站点找不到 → 再跑 `sites list`；不要编造成功。
+6. **失败先自救**：401 → 引导重新 `login`；站点找不到 → 再跑 `sites list`；helper REST 404 时命令会先升 helper；oauth2 401/404 → 说明要 SiteMan 镜像升级。不要编造成功。
+7. **不传任意下载 URL**：外部插件只接受本地 `--zip`。helper 只从镜像 `1.0.*` zip 引导升级，不要上架 helper。
 
 ### 本版明确不做
 
 - 创建 / 删除 / 重启站点（SiteMan）
 - 绑定域名 / CDN / SSL
-- 停用 / 删除插件；安装目录里没有的第三方插件
+- 单独停用插件但留在磁盘（停用只作为卸载的一步）
+- 推荐插件的业务配置（选择器、Cron、模型）
 - LPS / AI Sites / SEO JSON 灌入

package/dist/skill/_meta.json

@@ -1,7 +1,7 @@
 {
   "slug": "siluzan-website",
-  "version": "1.0.1-beta.1",
-  "publishedAt": 1789609097006,
+  "version": "1.0.1-beta.3",
+  "publishedAt": 1789638021415,
   "homepage": "https://www.siluzan.com",
   "source": "https://dev.azure.com/jack4it/Sammamish/_git/siluzan-skill",
   "requiredBinaries": [

package/dist/skill/references/content.md

@@ -0,0 +1,39 @@
+# 通用内容（文章 / 产品等）
+
+走 WordPress 核心 `GET/POST/DELETE /wp-json/wp/v2/{rest_base}`。**页面正文不要用这组命令**，用 [pages.md](pages.md)（Zion visual-edit）。
+
+先看站点有哪些类型：
+
+```bash
+siluzan-website content types --site <guid>
+```
+
+记下 `rest_base`，后面都传 `--type`。常见：`posts`（文章）。产品若已 `show_in_rest`，一般是 `product` 或目录里写的 rest_base。
+
+## 列出 / 查看
+
+```bash
+siluzan-website content list --site <guid> --type posts
+siluzan-website content list --site <guid> --type posts --status draft
+siluzan-website content get --site <guid> --type posts --id 12
+```
+
+## 新增 / 更新
+
+写操作，执行前确认站点、类型、标题。默认新增为 **draft**。
+
+```bash
+siluzan-website content add --site <guid> --type posts --title "资讯标题" --content "<p>正文</p>" --status draft
+siluzan-website content update --site <guid> --type posts --id 12 --status publish --featured-media 34
+```
+
+分类 / 标签用术语 ID（先 `terms list`）：`--categories 3,5` `--tags 8`。
+
+## 回收站
+
+```bash
+siluzan-website content trash --site <guid> --type posts --id 12
+siluzan-website content trash --site <guid> --type posts --id 12 --force
+```
+
+`--force` 永久删除，必须再确认一次。

package/dist/skill/references/media.md

@@ -0,0 +1,11 @@
+# 媒体库
+
+`GET/POST /wp-json/wp/v2/media`。上传走 multipart，不接受任意 URL 拉文件。
+
+```bash
+siluzan-website media list --site <guid>
+siluzan-website media get --site <guid> --id 34
+siluzan-website media upload --site <guid> --file ./hero.png --title "首页图" --alt "工厂外观"
+```
+
+单文件不超过 20MB。上传成功后记下 `id`，给 `content update --featured-media` 或 `pages meta --featured-media` 用。

package/dist/skill/references/pages.md

@@ -19,6 +19,18 @@ siluzan-website pages list --url https://{guid}-prod.admin.mysiluzan.com --json
 
 记下 `id`，更新时必须用这个 id，不要猜。
 
+## 查看 / 改元数据 / 回收站
+
+正文仍走 Zion。只改 slug、状态、父页、特色图：
+
+```bash
+siluzan-website pages get --site <guid> --id 123
+siluzan-website pages meta --site <guid> --id 123 --slug about --status publish
+siluzan-website pages trash --site <guid> --id 123
+```
+
+`--force` 永久删除。特色图 ID 来自 `media upload` / `media list`。
+
 ## 新增
 
 ```bash

package/dist/skill/references/plugins.md

@@ -1,6 +1,11 @@
 # 插件
 
-鉴权一律 **API Key（x-api-key）**。安装走站点 `siluzan-helper-plugin` 的 REST，只允许丝路赞目录里的 zip，不接受任意 URL。
+鉴权一律 **API Key（x-api-key）**。
+
+- **已装列表**走 WordPress 核心 `GET /wp-json/wp/v2/plugins`，能看到站点上的全部插件。
+- **目录安装 / 无 zip 升级**走 `siluzan-helper-plugin` REST。目录包来自丝路赞目录，不接受任意 URL。
+- **外部插件**首次安装和升级都带本地 `--zip`。zip 根目录必须是插件目录本身（`插件名/xxx.php`），不能再套一层版本号目录。
+- helper 太旧、没有 REST 时，命令会先打 oauth2 `POST /wp-json/wposso/v1/helper/upgrade`，用镜像里的 `siluzan-helper-plugin.1.0.*.zip` 升 helper，再继续原来的操作。helper **不上架**。
 
 ## 已装列表
 
@@ -9,36 +14,73 @@ siluzan-website plugins list --site <guid>
 siluzan-website plugins list --site <guid> --json
 ```
 
-`GET /wp-json/wp/v2/plugins`。字段：`plugin`、名称、`status`、版本。
+字段：`plugin`、名称、`status`、版本、`updateSource`（有目录命中则为 `catalog`）、目录版本。
+
+`plugin` 列是后续 `update --plugin` / `uninstall --plugin` 要用的值，不要猜。
 
 ## 可安装目录
 
 ```bash
 siluzan-website plugins catalog --site <guid>
-siluzan-website plugins catalog --site <guid> --json
 ```
 
-`GET /wp-json/siluzan-helper/v1/plugins/catalog`。记下 `slug`，安装必须用这个值（或 `plugin` 路径）。不要猜。
+记下 `slug`。目录安装 / 目录升级都用这个值。
 
-## 安装并启用
+## 安装
 
 写操作，执行前必须和用户确认目标站点与插件名。
 
+目录插件：
+
 ```bash
 siluzan-website plugins install --site <guid> --slug <slug>
 ```
 
-`POST /wp-json/siluzan-helper/v1/plugins/install`，body：`{ "slug": "..." }`。
+外部插件：
+
+```bash
+siluzan-website plugins install --site <guid> --zip ./my-plugin.zip
+```
+
+`--slug` 和 `--zip` 只传一个。`install --slug` 已装时会按目录包覆盖升级。
+
+## 升级已装插件
+
+不传 zip 时：先查目录包，再查 WordPress `update_plugins`（含 wordpress.org）。都没有包则失败，提示带 `--zip`。
+
+```bash
+siluzan-website plugins update --site <guid> --plugin theme-manage/theme-manage
+siluzan-website plugins update --site <guid> --plugin zasp-smart-recommender/zasp-smart-recommender --zip ./zasp.zip
+```
+
+## 卸载
+
+写操作。会先停用再删除文件。`siluzan-helper-plugin` 和 `wp-oauth2` 拒绝卸载。
+
+```bash
+siluzan-website plugins uninstall --site <guid> --plugin dummy-plugin/dummy-plugin
+```
+
+`--plugin` 与 `plugins list` 的 plugin 列一致；只写目录名且能唯一对上也可以。
+
+## helper
+
+```bash
+siluzan-website plugins helper-status --site <guid>
+siluzan-website plugins update-helper --site <guid>
+```
 
-成功后命令会再跑一次 `plugins list` 复核。已装且已启用会返回 `already: true`，视为成功，不要再装一遍。
+`update-helper` 只装镜像本地 `1.0.*` 包，不会去目录拉 helper。
 
 ## Agent 流程
 
 1. `sites list` 确定 guid
-2. `plugins catalog` 找到 slug（用户说中文名时按 `name` 匹配）
-3. 复述「将在 {站点} 安装并启用 {名称}（slug）」并等确认
-4. `plugins install --site <guid> --slug <slug>`
-5. 看复核列表里是否 `active`
+2. 用户要「装了哪些插件」→ `plugins list`
+3. 用户要装目录插件 → `catalog` 对上 slug → 确认 → `install --slug`
+4. 用户要升级已装插件 → `list` 拿到 `plugin` → 确认 → `update --plugin`；外部插件再加 `--zip`
+5. 用户要卸载 → `list` 拿到 `plugin` → 确认不是 helper / oauth2 → `uninstall --plugin`
+6. catalog / install / update 报路由 404 → 命令会自动 `update-helper` 再重试；oauth2 本身 404 / 401 → 告诉用户要先 SiteMan 镜像升级
+7. 装完看复核列表是否 `active`；卸完确认列表里已经没有该项
 
 匹配到多个目录项时让用户选，不要猜。
 
@@ -46,9 +88,12 @@ siluzan-website plugins install --site <guid> --slug <slug>
 
 | 现象 | 处理 |
 |------|------|
-| catalog / install 404 或路由不存在 | 站点 helper 还没带 REST，需要更新 `siluzan-helper-plugin` |
-| 401 | API Key 无效或无权操作该站 |
-| Plugin not found | slug 不对，重新 `catalog` |
+| list 401 | 站点 oauth2 不认 API Key，需要 SiteMan 镜像升级 |
+| helper REST 404 | 先自动升 helper；oauth2 也没有引导接口则要镜像升级 |
+| update-helper 409 | 当前镜像没有 `siluzan-helper-plugin.1.0.*.zip` |
+| Plugin not found / not_in_catalog | slug 不对，重新 `catalog` |
+| 409 no_package | 目录和官方都没包，外部插件带 `--zip` |
+| zip 结构不对 | 重新打包，根目录必须是插件目录 |
 | 安装成功但激活失败 | 把站点返回的 message 原文告诉用户 |
 
-本 Skill **不能**停用、删除插件，也不能装 wordpress.org 上目录里没有的插件。
+本 Skill **不能**单独停用后留在磁盘上（停用只作为卸载的一步），也不能传任意下载 URL。不能卸载 helper / oauth2。

package/dist/skill/references/search.md

@@ -0,0 +1,12 @@
+# 搜索
+
+`GET /wp-json/wp/v2/search`。用来找页面 / 文章 / 媒体，不要猜 ID。
+
+```bash
+siluzan-website search --site <guid> --q "关于我们"
+siluzan-website search --site <guid> --q "泵" --type post
+```
+
+记下结果里的 `id` 和 `type`，再决定走 `pages` 还是 `content`。
+
+WordPress 搜索只返回**对外可见**的内容（已发布页面 / 文章 / 媒体）。草稿、私密、回收站不会出现；那些请用 `content list --status draft` 或 `pages list`。

package/dist/skill/references/terms.md

@@ -0,0 +1,14 @@
+# 分类与标签
+
+`/wp-json/wp/v2/categories`、`/tags`，以及其它 `show_in_rest` 的分类法。
+
+```bash
+siluzan-website terms taxonomies --site <guid>
+siluzan-website terms list --site <guid> --taxonomy category
+siluzan-website terms list --site <guid> --taxonomy post_tag
+siluzan-website terms add --site <guid> --taxonomy category --name "行业新闻"
+siluzan-website terms update --site <guid> --id 3 --name "新名称"
+siluzan-website terms delete --site <guid> --id 3
+```
+
+`--taxonomy` 可用 slug（`category`）或 rest_base（`categories`）。删除不可进回收站，执行前确认。

package/dist/skill/scripts/install.ps1

@@ -9,7 +9,7 @@ $ErrorActionPreference = 'Stop'
 # -- Package info (injected at build time) ------------------------------------
 $PKG_NAME    = 'siluzan-website-cli'
 # PKG_VERSION 锁定到与本脚本同批构建产物一致的版本，避免与 dist/skill 错位
-$PKG_VERSION = '1.0.1-beta.1'
+$PKG_VERSION = '1.0.1-beta.3'
 $CLI_BIN     = 'siluzan-website'
 $SKILL_LABEL = 'Siluzan Website'
 $INSTALL_CMD = 'npm install -g siluzan-website-cli@beta'

package/dist/skill/scripts/install.sh

@@ -9,7 +9,7 @@ set -euo pipefail
 # -- Package info (injected at build time) ------------------------------------
 readonly PKG_NAME="siluzan-website-cli"
 # PKG_VERSION 锁定到与本脚本同批构建产物一致的版本，避免与 dist/skill 错位
-readonly PKG_VERSION="1.0.1-beta.1"
+readonly PKG_VERSION="1.0.1-beta.3"
 readonly CLI_BIN="siluzan-website"
 readonly SKILL_LABEL="Siluzan Website"
 readonly INSTALL_CMD="npm install -g siluzan-website-cli@beta"

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "siluzan-website-cli",
-  "version": "1.0.1-beta.1",
-  "description": "Siluzan WordPress 站点管理 Skill CLI — 列出站点、新增/编辑页面、查看插件。",
+  "version": "1.0.1-beta.3",
+  "description": "Siluzan WordPress 站点管理 Skill CLI — 列出站点、新增/编辑页面、安装/升级插件。",
   "keywords": [
     "ai-skill",
     "cli",