@qcplay/cli 1.0.10 → 1.0.12

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@qcplay/cli",
-  "version": "1.0.10",
+  "version": "1.0.12",
   "description": "QCPlay CLI",
   "type": "module",
   "bin": {

package/templates/skills/qcplay-publish-article/SKILL.md

@@ -5,24 +5,25 @@ description: "QCPlay 官网文章上传：Use when user mentions 发布文章、
 metadata:
   requires:
     bins: ["qcplay", "qcplay-cli"]
-    native_bins: ["publish-article.exe", "qcplay-auth.exe"]
   cliHelp: "qcplay article --help"
   authFile: "~/.qcplay/auth.json"
   templateCommand: "qcplay article"
   initCommand: "qcplay article init"
   importCommand: "qcplay article import <wechat-url> [file]"
   publishCommand: "qcplay www-article-list.store article.md"
+  updateCommand: "qcplay article update [id]"
+  deleteCommand: "qcplay article delete [id]"
 ---
 
 # qcplay www-article-list.store
 
 ## CRITICAL — 文章上传工作流，必须遵循
 
-本 Skill 用于通过 QCPlay CLI 上传 / 发布官网文章。
+本 Skill 用于通过 QCPlay CLI 保存、预览、上线和删除官网文章。
 
 文章参数必须写在 Markdown 文件顶部的 Front Matter 中，正文写在 Front Matter 之后。
 
-用户发布文章时，默认只需要执行：
+用户提交文章时，先执行：
 
 ```bash
 qcplay www-article-list.store article.md
@@ -42,7 +43,21 @@ qcplay-cli www-article-list.store article.md
 qcplay article import "https://mp.weixin.qq.com/s/..." article.md
 ```
 
-该命令只生成未发布的官网文章草稿，不会直接发布。确认草稿正文和 Front Matter 后，再执行发布命令。
+该命令只生成本地官网文章草稿，不会提交到官网。确认草稿正文和 Front Matter 后，再执行保存命令。
+
+保存命令始终以 `status: "0"` 创建未上线文章，并输出文章 ID 和可点击预览地址。必须先让用户检查 PC、移动端排版；只有用户明确确认上线后，才能执行：
+
+```bash
+qcplay article update [id]
+```
+
+用户要求删除时执行软删除，将状态更新为 `2`：
+
+```bash
+qcplay article delete [id]
+```
+
+`id` 省略时，只能使用当前账号最近一次保存的未上线文章；找不到时必须要求手动输入 ID。
 
 正确方式是：
 
@@ -53,7 +68,7 @@ Front Matter 解析文章参数
   ↓
 Markdown 正文作为 article_content
   ↓
-publish-article.exe 执行上传
+QCPlay CLI 调用认证后端保存文章
 ```
 
 ---
@@ -63,9 +78,7 @@ publish-article.exe 执行上传
 - **文章文件（Article File）**：一个 Markdown 文件，例如 `article.md`，顶部包含 YAML Front Matter，下面是正文内容。
 - **Front Matter**：`---` 包裹的 YAML 参数区，用来填写文章标题、缩略图、分类、标签、发布时间等。
 - **文章正文（article_content）**：Front Matter 后面的 Markdown 正文内容，程序自动作为 `article_content` 上传。
-- **发布程序（publish-article.exe）**：Go 编译的本地文章上传程序，负责读取文章文件、解析参数、读取登录凭证并调用发布接口。
-- **登录程序（qcplay-auth.exe）**：Go 编译的本地登录程序，负责浏览器登录并生成 `~/.qcplay/auth.json`。
-- **统一 CLI（qcplay / qcplay-cli）**：npm 包提供的统一入口，根据子命令调用不同 exe。
+- **统一 CLI（qcplay / qcplay-cli）**：npm 包提供的统一入口，负责解析文章、读取登录凭证并调用认证后端。
 - **认证文件（auth.json）**：登录成功后保存的本地认证文件，路径为 `~/.qcplay/auth.json`。
 - **文章模板**：通过 `qcplay article` 查看模板说明，或通过 `qcplay article init` 生成 `article.md`。
 - **微信文章导入**：通过 `qcplay article import <wechat-url> [file]` 提取推文正文，将图片转存到官网图片服务并生成 Markdown 草稿。
@@ -109,12 +122,12 @@ publish-article.exe 执行上传
 6. **文章正文不能为空**  
    Front Matter 后面的 Markdown 正文为空时不得上传。
 
-7. **正式发布需要用户明确设置**  
-   `status: "1"` 表示发布，`status: "0"` 表示未发布。  
-   如果用户没有明确要求上线，建议使用：
+7. **首次保存固定为未上线**
+   `www-article-list.store` 必须忽略 Front Matter 中的上线值并强制使用：
    ```yaml
    status: "0"
    ```
+   用户检查预览并明确确认后，使用 `article update [id]` 将状态更新为 `1`。不得通过首次保存直接上线。
 
 8. **不得伪造发布结果**  
    如果接口返回失败，必须原样提示失败原因，不得编造文章 URL 或成功状态。
@@ -302,10 +315,13 @@ qcplay article import "https://mp.weixin.qq.com/s/..." article.md
 该命令会：
 
 ```txt
-读取微信文章标题、作者、发布日期和正文
-逐张下载正文与封面图片
+读取微信文章标题、作者、发布日期和完整正文
+逐张下载正文图片、CSS 背景图与封面图片
 上传图片到官网图片服务并替换链接
-清理微信脚本、表单和交互节点
+清理脚本和危险属性，同时保留原文 HTML 层级、内联样式及特殊节点里的可读内容
+背景图片保留在原容器中，不得重复生成为普通图片
+生成保持微信 677px 阅读宽度并兼容窄屏的富 HTML 正文
+独占一行的图片使用块级布局，避免 PC 端标题行盒造成相邻图片重叠
 生成 status: "0" 的官网 Markdown 草稿
 ```
 
@@ -315,22 +331,41 @@ qcplay article import "https://mp.weixin.qq.com/s/..." article.md
 
 用户在 `article.md` 顶部 Front Matter 填写文章参数，在下方填写正文。
 
-6. **发布文章**
+6. **保存为未上线文章**
 
 ```bash
 qcplay www-article-list.store article.md
 ```
 
-7. **查看发布结果**
+7. **检查预览**
 
-发布成功后应输出：
+保存成功后必须输出：
 
 ```txt
-官网文章发布成功
+文章已保存为未上线状态
+文章 ID: 123
+文章状态: 未上线
+预览地址: https://snail.qingcigame.com/official/news-details.html?id=123
+```
+
+让用户打开预览地址检查 PC 和移动端排版。用户明确确认上线后执行：
 
-标题: xxx
-状态: 已发布 / 未发布
-文章链接: xxx
+```bash
+qcplay article update 123
+```
+
+也可以省略 ID，使用当前账号最近一次保存的未上线文章：
+
+```bash
+qcplay article update
+```
+
+8. **删除文章**
+
+用户明确要求删除时，将文章状态软删除为 `2`：
+
+```bash
+qcplay article delete 123
 ```
 
 ---
@@ -392,50 +427,54 @@ qcplay article init --force
 
 ---
 
-### 发布文章
+### 保存未上线文章
 
 ```bash
 qcplay www-article-list.store article.md
 ```
 
-内部应调用：
+首次保存始终将 `status` 强制为 `0`。成功后记录最近文章 ID，并输出预览地址。
+
+### 确认上线
 
 ```bash
-publish-article.exe --content-file <article.md绝对路径>
+qcplay article update [id]
 ```
 
-例如：
+等价命令：
 
 ```bash
-publish-article.exe --content-file E:\go-admin\article.md
+qcplay www-article-list.update [id]
 ```
 
----
+该命令通过更新操作将 `status` 修改为 `1`。
 
-### Dry Run，可选
+### 删除文章
 
-如果支持：
+```bash
+qcplay article delete [id]
+```
+
+等价命令：
 
 ```bash
-qcplay www-article-list.store article.md --dry-run
+qcplay www-article-list.delete [id]
 ```
 
-则只解析、校验并展示 payload，不真正调用发布接口。
+该命令通过更新操作将 `status` 修改为 `2`，不得执行物理删除。
 
 ---
 
-### 指定环境，可选
-
-```bash
-qcplay www-article-list.store article.md --env prod
-```
+### Dry Run，可选
 
-内部传给 Go 程序：
+如果支持：
 
 ```bash
-publish-article.exe --content-file E:\go-admin\article.md --env prod
+qcplay www-article-list.store article.md --dry-run
 ```
 
+则只解析、校验并展示 payload，不真正调用发布接口。
+
 ---
 
 ## article.md 文件格式
@@ -452,7 +491,7 @@ move_thumbnail: https://example.com/mobile-thumbnail.png
 article_excerpt: 文章描述，可以为空
 article_url: article-url-slug
 origin: QCPlay
-status: "1"
+status: "0"
 cate_id: "2"
 video_link: ""
 is_hot: "0"
@@ -494,7 +533,7 @@ index_move_img: ""
 | `article_excerpt` | 否 | 文章描述，可以为空 |
 | `article_url` | 建议 | 文章链接，建议使用英文 slug |
 | `origin` | 否 | 作者来源 |
-| `status` | 是 | `1` 发布，`0` 未发布 |
+| `status` | 是 | 模板填写 `0`；首次保存会强制为 `0` |
 | `cate_id` | 是 | 分类 ID |
 | `video_link` | 否 | 视频链接 |
 | `is_hot` | 是 | `1` 热门，`0` 非热门 |
@@ -583,20 +622,17 @@ Front Matter.index_move_img     -> index_move_img
 
 | 状态 | status |
 |---|---:|
-| 未发布 | 0 |
-| 发布 | 1 |
+| 未上线 | 0 |
+| 已上线 | 1 |
+| 已删除（软删除） | 2 |
 
-默认建议：
+首次保存固定使用：
 
 ```yaml
 status: "0"
 ```
 
-用户明确要求立即发布时：
-
-```yaml
-status: "1"
-```
+用户明确确认预览排版无误后，不修改 Front Matter，执行 `qcplay article update [id]` 上线。
 
 ---
 
@@ -815,7 +851,7 @@ index_move_img: ""
 1. `article_title` 不能为空；
 2. `thumbnail` 不能为空；
 3. `cate_id` 不能为空；
-4. `status` 只能是 `"0"` 或 `"1"`；
+4. Front Matter 的 `status` 只能是 `"0"` 或 `"1"`，首次保存请求固定覆盖为 `"0"`；
 5. `is_hot` 只能是 `"0"` 或 `"1"`；
 6. `is_index` 只能是 `"0"` 或 `"1"`；
 7. `release_time` 格式必须是 `YYYY-MM-DD`，例如：
@@ -877,7 +913,7 @@ qcplay article import "https://mp.weixin.qq.com/s/..." article.md
 - 输出状态固定为未发布，发布前必须检查分类、缩略图、发布日期和正文；
 - 不允许覆盖已经存在的文件。
 
-### 发布文章
+### 保存未上线文章
 
 ```bash
 qcplay www-article-list.store article.md
@@ -891,88 +927,21 @@ qcplay www-article-list.store ./articles/news.md
 
 ---
 
-## npm 调用到 Go 程序的约定
-
-Node CLI 只负责路由，不负责发布逻辑。
-
-当用户执行：
+## CLI 与后端约定
 
-```bash
-qcplay www-article-list.store article.md
-```
-
-Node CLI 内部应调用：
-
-```bash
-publish-article.exe --content-file <article.md绝对路径>
-```
+Node CLI 负责解析 Markdown、构建请求、读取本地认证状态和输出结果；Go 后端负责认证、权限校验和数据库更新。
 
-不要把 Front Matter 中的字段拆成命令行参数传递。
-
-正确：
-
-```bash
-publish-article.exe --content-file E:\go-admin\article.md
-```
-
-不推荐：
-
-```bash
-publish-article.exe --article-title "标题" --cate-id 2 --thumbnail xxx
-```
-
----
-
-## Go 程序实现要求
-
-`publish-article.exe` 必须完成：
-
-1. 读取 `--content-file`；
-2. 解析 Markdown Front Matter；
-3. 将正文作为 `article_content`；
-4. 从 `~/.qcplay/auth.json` 读取 `access_token`；
-5. 校验 token 是否存在；
-6. 校验 token 是否过期；
-7. 补充默认参数：
-   ```txt
-   is_index2 = 0
-   type = 1
-   ```
-8. 构建发布请求；
-9. 调用官网文章发布接口；
-10. 输出发布结果。
-
----
-
-## Go 字段结构参考
-
-```go
-type ArticleMeta struct {
-    ArticleTitle   string `yaml:"article_title"`
-    Thumbnail      string `yaml:"thumbnail"`
-    MoveThumbnail  string `yaml:"move_thumbnail"`
-    ArticleExcerpt string `yaml:"article_excerpt"`
-    ArticleURL     string `yaml:"article_url"`
-    Origin         string `yaml:"origin"`
-    Status         string `yaml:"status"`
-    CateID         string `yaml:"cate_id"`
-    VideoLink      string `yaml:"video_link"`
-    IsHot          string `yaml:"is_hot"`
-    IsIndex        string `yaml:"is_index"`
-    ReleaseTime    string `yaml:"release_time"`
-    Area           string `yaml:"area"`
-    Sort           string `yaml:"sort"`
-    GameID         string `yaml:"game_id"`
-    IndexPCImg     string `yaml:"index_pc_img"`
-    IndexMoveImg   string `yaml:"index_move_img"`
-}
-```
+- 首次保存：`POST /api/articles/publish`，后端再次强制 `status=0`；
+- 确认上线：`PATCH /api/articles/status`，请求 `{ "id": 123, "status": "1" }`；
+- 删除文章：`PATCH /api/articles/status`，请求 `{ "id": 123, "status": "2" }`；
+- 上线和删除都要求 `www-article-list.update` 权限；
+- 删除是状态更新，不得执行物理删除。
 
 ---
 
 ## Front Matter 解析要求
 
-Go 程序必须兼容：
+CLI 必须兼容：
 
 1. UTF-8 BOM；
 2. Windows 换行 `\r\n`；
@@ -997,9 +966,9 @@ Go 程序必须兼容：
 
 ---
 
-## 发布请求字段
+## 首次保存请求字段
 
-发布接口最终应收到：
+首次保存接口最终应收到：
 
 ```json
 {
@@ -1010,7 +979,7 @@ Go 程序必须兼容：
   "article_excerpt": "文章描述，可以为空",
   "article_url": "article-url-slug",
   "origin": "QCPlay",
-  "status": "1",
+  "status": "0",
   "cate_id": "2",
   "video_link": "",
   "is_hot": "0",
@@ -1030,23 +999,30 @@ Go 程序必须兼容：
 
 ## 成功输出
 
-发布成功后输出：
+首次保存成功后输出：
 
 ```txt
-官网文章发布成功
-
-标题: 文章标题
-状态: 已发布
-文章链接: xxx
+文章已保存为未上线状态
+文章 ID: 123
+文章状态: 未上线
+预览地址: https://snail.qingcigame.com/official/news-details.html?id=123
 ```
 
-如果 `status` 是 `"0"`：
+确认上线成功后输出：
 
 ```txt
-官网文章已保存为未发布状态
+文章已上线
+文章 ID: 123
+文章状态: 已上线
+文章地址: https://snail.qingcigame.com/official/news-details.html?id=123
+```
+
+删除成功后输出：
 
-标题: 文章标题
-状态: 未发布
+```txt
+文章已删除
+文章 ID: 123
+文章状态: 已删除
 ```
 
 ---
@@ -1139,13 +1115,12 @@ release_time 格式错误，请使用 YYYY-MM-DD，例如 2026-07-09
 4. 不要在命令中拼接全部文章字段；
 5. 文章字段从 `article.md` Front Matter 读取；
 6. Markdown 正文作为 `article_content`；
-7. Node CLI 只负责调用：
-   ```bash
-   publish-article.exe --content-file <file>
-   ```
-8. Go 程序负责解析、校验、读取 auth、调用接口；
-9. 发布成功或失败都在当前终端输出；
-10. 不得打印完整 token。
+7. Node CLI 负责解析、校验、读取 auth 并调用后端接口；
+8. Go 后端负责权限校验、强制草稿状态和数据库更新；
+9. 保存、上线或删除的成功和失败都在当前终端输出；
+10. 不得打印完整 token；
+11. 未得到用户确认，不得执行上线；
+12. 删除只能更新 `status=2`，不得物理删除数据。
 
 ---
 
@@ -1186,14 +1161,21 @@ qcplay article init
 qcplay www-article-list.store article.md
 ```
 
-读取 `article.md` 并发布文章。
+读取 `article.md` 并保存为未上线文章。
+
+```bash
+qcplay article update [id]
+qcplay article delete [id]
+```
+
+分别将文章状态更新为已上线和已删除。
 
 并满足：
 
 - 能解析 Front Matter；
 - 能读取 Markdown 正文；
 - 能读取 `~/.qcplay/auth.json`；
-- 能调用 `publish-article.exe`；
+- 能调用认证后端并处理接口错误；
 - 能处理无权限错误；
 - 能处理字段缺失错误；
 - 不要求用户在命令行传标题；
@@ -1208,8 +1190,11 @@ qcplay www-article-list.store article.md
 命令只传文章文件。
 正文自动作为 article_content。
 登录状态读取 auth.json。
-Node 只做路由。
-Go 负责发布。
+Node 解析文章并调用后端。
+Go 后端负责权限和数据库更新。
 默认参数程序内部补齐。
+首次保存固定 status=0。
+确认后更新 status=1。
+删除更新 status=2。
 发布失败不得伪造成成功。
 ```