@qcplay/cli 1.0.11 → 1.0.13

package/README.md

@@ -9,7 +9,7 @@
 - 登录默认打开线上页面：`https://cli.qcg.ink/auth.html`
 - `qcplay-cli install` 初始化完成后会自动打开登录页并等待登录完成
 - 登录凭证保存在当前用户本机的 `~/.qcplay/auth.json`，不同客户端之间不共享账号
-- 状态、权限和发布请求通过 Bearer Token 识别当前账号
+- 状态、权限和文章请求通过 Bearer Token 识别当前账号
 - `qcplay-cli article import <微信文章链接> [文件]` 会提取正文、转存图片并生成未发布的官网文章草稿
 - `qcplay-cli update` 会更新 npm 全局包，并同步 `~/.agents/skills`
 - 本地调试时可直接使用 `--local`
@@ -26,12 +26,32 @@ qcplay-cli article import "https://mp.weixin.qq.com/s/..." article.md
 
 转换流程会读取微信文章标题、来源、发布日期和完整正文，经过安全清理后保留微信原文的 HTML 层级、内联样式、字号、颜色、对齐、间距、媒体链接和表格，并转存正文图片、CSS 背景图及封面图。背景图片仍保留在原容器中，不会额外生成一张普通图片。正文保持微信的 `677px` 阅读宽度并兼容窄屏；独占一行的图片会使用块级布局，纯图片标题容器会转换为普通区块，避免官网 PC 标题样式造成相邻图片重叠。任何正文节点遗漏或图片处理失败都会终止转换，不生成不完整草稿。输出固定为 `status: "0"`，并保留空的 `cate_id` 供发布前确认。
 
-确认草稿内容和业务字段后再发布：
+确认草稿内容和业务字段后保存为未上线文章：
 
 ```bash
 qcplay-cli www-article-list.store article.md
 ```
 
+保存成功后，CLI 会输出文章 ID、`未上线` 状态和可点击的排版预览地址，并自动在浏览器中打开该页面：
+
+```text
+https://snail.qingcigame.com/official/news-details.html?id=<文章ID>
+```
+
+文章内容和排版只由用户在打开的预览页面中检查，CLI 或 AI 不自动抓取、分析或判断预览内容。用户明确确认无误后再上线。ID 可以省略，此时只使用当前账号最近一次保存的未上线文章：
+
+```bash
+qcplay-cli article update [id]
+```
+
+删除使用软删除，将同一文章的 `status` 更新为 `2`：
+
+```bash
+qcplay-cli article delete [id]
+```
+
+兼容权限名形式的命令：`www-article-list.update [id]` 和 `www-article-list.delete [id]`。首次保存始终强制使用 `status: "0"`，不会因为 Front Matter 中误填 `1` 而直接上线。
+
 仓库整体需求说明仍在根目录：
 
 - `../docs/requirement.md`

package/bin/qcplay.js

@@ -99,6 +99,8 @@ const QCPLAY_DIR = path.join(os.homedir(), ".qcplay");
 const AGENTS_DIR = path.join(os.homedir(), ".agents");
 const CONFIG_FILE = path.join(QCPLAY_DIR, "config.json");
 const AUTH_FILE = path.join(QCPLAY_DIR, "auth.json");
+const ARTICLE_STATE_FILE = path.join(QCPLAY_DIR, "article-state.json");
+const ARTICLE_PREVIEW_BASE_URL = "https://snail.qingcigame.com/official/news-details.html";
 const SKILLS_DIR = path.join(AGENTS_DIR, "skills");
 
 function readPackageMetadata() {
@@ -149,7 +151,11 @@ Usage:
   qcplay-cli article init [file]
   qcplay-cli article import <wechat-url> [file]
   qcplay-cli article publish <file> [--local] [--backend <url>] [--dry-run]
+  qcplay-cli article update [id] [--local] [--backend <url>] [--dry-run]
+  qcplay-cli article delete [id] [--local] [--backend <url>] [--dry-run]
   qcplay-cli www-article-list.store <file> [--local] [--backend <url>] [--dry-run]
+  qcplay-cli www-article-list.update [id] [--local] [--backend <url>] [--dry-run]
+  qcplay-cli www-article-list.delete [id] [--local] [--backend <url>] [--dry-run]
   qcplay-cli features
   qcplay-cli where
 
@@ -175,7 +181,9 @@ function printArticleHelp() {
   qcplay-cli article
   qcplay-cli article init [file]
   qcplay-cli article import <wechat-url> [file]
-  qcplay-cli article publish <file> [--local] [--backend <url>] [--dry-run]`);
+  qcplay-cli article publish <file> [--local] [--backend <url>] [--dry-run]
+  qcplay-cli article update [id] [--local] [--backend <url>] [--dry-run]
+  qcplay-cli article delete [id] [--local] [--backend <url>] [--dry-run]`);
 }
 
 function printFeatures() {
@@ -193,6 +201,8 @@ function printFeatures() {
   console.log(chalk.cyan("3. 发布官网文章"));
   console.log("   qcplay-cli article import <微信文章链接> article.md");
   console.log("   qcplay-cli www-article-list.store article.md");
+  console.log("   qcplay-cli article update [id]");
+  console.log("   qcplay-cli article delete [id]");
   console.log("");
   console.log(chalk.cyan("4. 查看本地目录"));
   console.log("   qcplay-cli where");
@@ -497,12 +507,24 @@ function parsePublishOptions(args) {
     positional.push(current);
   }
 
+  if (positional.length > 1) {
+    throw new Error(`未知参数: ${positional.slice(1).join(" ")}`);
+  }
+
   return {
     file: positional[0],
     options
   };
 }
 
+function parseArticleMutationOptions(args) {
+  const parsed = parsePublishOptions(args);
+  return {
+    articleId: parsed.file,
+    options: parsed.options
+  };
+}
+
 function requestJson(method, baseUrl, pathname, payload, headers = {}) {
   return new Promise((resolve, reject) => {
     const url = new URL(pathname, baseUrl);
@@ -580,9 +602,11 @@ function openBrowser(targetUrl) {
       stdio: "ignore"
     });
 
-    child.on("error", reject);
-    child.unref();
-    resolve();
+    child.once("error", reject);
+    child.once("spawn", () => {
+      child.unref();
+      resolve();
+    });
   });
 }
 
@@ -874,6 +898,87 @@ async function authenticatedRequest(method, baseUrl, pathname, payload) {
   });
 }
 
+function normalizeArticleId(value) {
+  const text = normalizeText(value);
+  if (!/^\d+$/.test(text)) {
+    throw new Error("文章 ID 必须是正整数");
+  }
+
+  const articleId = Number(text);
+  if (!Number.isSafeInteger(articleId) || articleId <= 0) {
+    throw new Error("文章 ID 必须是正整数");
+  }
+  return articleId;
+}
+
+function articlePreviewUrl(articleId) {
+  const url = new URL(ARTICLE_PREVIEW_BASE_URL);
+  url.searchParams.set("id", String(articleId));
+  return url.toString();
+}
+
+function backendOriginsMatch(left, right) {
+  try {
+    return new URL(left).origin === new URL(right).origin;
+  } catch {
+    return false;
+  }
+}
+
+async function saveRecentArticleState(articleId, status, backendUrl, previewUrl = "") {
+  const authState = await loadAuthState();
+  await writeJson(ARTICLE_STATE_FILE, {
+    article_id: articleId,
+    status: String(status),
+    preview_url: previewUrl,
+    backend_url: backendUrl,
+    administrator_id: Number(authState.id || 0),
+    account: normalizeText(authState.account),
+    updated_at: Date.now()
+  });
+}
+
+async function trySaveRecentArticleState(articleId, status, backendUrl, previewUrl = "") {
+  try {
+    await saveRecentArticleState(articleId, status, backendUrl, previewUrl);
+    return "";
+  } catch (error) {
+    return normalizeText(error?.message) || String(error);
+  }
+}
+
+async function resolveArticleId(value, backendUrl) {
+  if (normalizeText(value)) {
+    return normalizeArticleId(value);
+  }
+
+  const [recentArticle, authState] = await Promise.all([readJson(ARTICLE_STATE_FILE), loadAuthState()]);
+  if (!recentArticle.article_id) {
+    throw new Error("没有找到最近发布的未上线文章，请手动输入文章 ID");
+  }
+  if (!backendOriginsMatch(recentArticle.backend_url, backendUrl)) {
+    throw new Error("最近文章属于其他后端，请手动输入文章 ID");
+  }
+  if (String(recentArticle.status) !== "0") {
+    throw new Error("最近文章不是未上线状态，请手动输入文章 ID");
+  }
+
+  const recentAdministratorId = Number(recentArticle.administrator_id || 0);
+  const currentAdministratorId = Number(authState.id || 0);
+  if (recentAdministratorId && recentAdministratorId !== currentAdministratorId) {
+    throw new Error("最近文章属于其他登录账号，请手动输入文章 ID");
+  }
+  if (
+    !recentAdministratorId &&
+    normalizeText(recentArticle.account) &&
+    normalizeText(recentArticle.account) !== normalizeText(authState.account)
+  ) {
+    throw new Error("最近文章属于其他登录账号，请手动输入文章 ID");
+  }
+
+  return normalizeArticleId(recentArticle.article_id);
+}
+
 function flattenPermissionTree(items, bucket = []) {
   for (const item of items) {
     bucket.push(item);
@@ -1640,6 +1745,7 @@ async function publishArticleCommand(file, options) {
   }
 
   const { articleFile, payload } = await parseArticleFile(file);
+  payload.status = "0";
   const config = await loadConfig();
   const backendUrl = resolvePublishBackendUrl(options, config);
 
@@ -1649,15 +1755,72 @@ async function publishArticleCommand(file, options) {
   }
 
   console.log("");
-  console.log(chalk.cyan("正在发布官网文章..."));
+  console.log(chalk.cyan("正在保存官网文章为未上线状态..."));
   console.log(chalk.gray(`文章文件: ${articleFile}`));
   console.log("");
 
   const response = await authenticatedRequest("POST", backendUrl, "/api/articles/publish", payload);
-  console.log(chalk.green(response.message || "发布成功"));
-  const articleId = response.data?.id ?? response.data?.article_id ?? response.data?.articleId;
-  if (articleId !== undefined) {
-    console.log(`文章 ID: ${articleId}`);
+  const rawArticleId = response.data?.id ?? response.data?.article_id ?? response.data?.articleId;
+  const articleId = normalizeArticleId(rawArticleId);
+  const previewUrl = normalizeText(response.data?.preview_url) || articlePreviewUrl(articleId);
+  const stateWarning = await trySaveRecentArticleState(articleId, "0", backendUrl, previewUrl);
+
+  console.log(chalk.green(response.message || "文章已保存为未上线状态"));
+  console.log(`文章 ID: ${articleId}`);
+  console.log("文章状态: 未上线");
+  console.log(`预览地址: ${previewUrl}`);
+  if (stateWarning) {
+    console.log(chalk.yellow(`本地未能记录最近文章 ID，后续操作请手动输入 ${articleId}: ${stateWarning}`));
+  }
+  console.log("");
+  try {
+    await openBrowser(previewUrl);
+    console.log(chalk.cyan("已打开文章预览页面，请由用户检查文章内容和排版。"));
+  } catch {
+    console.log(chalk.yellow("自动打开预览页面失败，请手动打开上面的预览地址。"));
+  }
+  console.log("用户确认无误后再执行:");
+  console.log("");
+  console.log(`  qcplay-cli article update ${articleId}`);
+  console.log("");
+}
+
+async function updateArticleStatusCommand(articleIdValue, targetStatus, options) {
+  const config = await loadConfig();
+  const backendUrl = resolvePublishBackendUrl(options, config);
+  const articleId = await resolveArticleId(articleIdValue, backendUrl);
+  const payload = {
+    id: articleId,
+    status: targetStatus
+  };
+
+  if (options.dryRun) {
+    console.log(JSON.stringify(payload, null, 2));
+    return;
+  }
+
+  const action = targetStatus === "2" ? "删除" : "上线";
+  console.log("");
+  console.log(chalk.cyan(`正在${action}官网文章...`));
+  console.log(chalk.gray(`文章 ID: ${articleId}`));
+  console.log("");
+
+  const response = await authenticatedRequest("PATCH", backendUrl, "/api/articles/status", payload);
+  const responseStatus = normalizeText(response.data?.status) || targetStatus;
+  const previewUrl =
+    responseStatus === "1"
+      ? normalizeText(response.data?.preview_url) || articlePreviewUrl(articleId)
+      : "";
+  const stateWarning = await trySaveRecentArticleState(articleId, responseStatus, backendUrl, previewUrl);
+
+  console.log(chalk.green(response.message || (responseStatus === "2" ? "文章已删除" : "文章已上线")));
+  console.log(`文章 ID: ${articleId}`);
+  console.log(`文章状态: ${responseStatus === "2" ? "已删除" : "已上线"}`);
+  if (previewUrl) {
+    console.log(`文章地址: ${previewUrl}`);
+  }
+  if (stateWarning) {
+    console.log(chalk.yellow(`本地未能记录文章状态，后续操作请手动输入 ${articleId}: ${stateWarning}`));
   }
 }
 
@@ -1747,6 +1910,16 @@ async function main() {
       return;
     }
 
+    if (subcommand === "update" || subcommand === "delete") {
+      const parsed = parseArticleMutationOptions(rest);
+      const targetStatus = subcommand === "delete" ? "2" : "1";
+      const errorTitle = subcommand === "delete" ? "删除失败" : "上线失败";
+      await runWithErrorBanner(errorTitle, () =>
+        updateArticleStatusCommand(parsed.articleId, targetStatus, parsed.options)
+      );
+      return;
+    }
+
     printArticleHelp();
     process.exit(1);
   }
@@ -1757,6 +1930,16 @@ async function main() {
     return;
   }
 
+  if (command === "www-article-list.update" || command === "www-article-list.delete") {
+    const parsed = parseArticleMutationOptions([subcommand, ...rest].filter(Boolean));
+    const targetStatus = command === "www-article-list.delete" ? "2" : "1";
+    const errorTitle = targetStatus === "2" ? "删除失败" : "上线失败";
+    await runWithErrorBanner(errorTitle, () =>
+      updateArticleStatusCommand(parsed.articleId, targetStatus, parsed.options)
+    );
+    return;
+  }
+
   if (command === "features") {
     printFeatures();
     return;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@qcplay/cli",
-  "version": "1.0.11",
+  "version": "1.0.13",
   "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 和可点击预览地址。保存成功后必须打开该预览网页，只让用户本人检查文章内容和排版。AI 不得自动访问、抓取、截图、分析、比较或判断预览内容。只有用户明确确认上线后，才能执行：
+
+```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"
    ```
+   CLI 打开预览网页后，由用户本人检查。AI 不检查预览内容，也不代替用户判断。用户明确确认后，使用 `article update [id]` 将状态更新为 `1`。不得通过首次保存直接上线。
 
 8. **不得伪造发布结果**  
    如果接口返回失败，必须原样提示失败原因，不得编造文章 URL 或成功状态。
@@ -318,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
+```
+
+CLI 必须自动打开预览地址，然后停止流程并让用户本人检查。AI 不读取或分析预览页面，不得自行确认上线。用户明确确认上线后执行：
 
-标题: xxx
-状态: 已发布 / 未发布
-文章链接: xxx
+```bash
+qcplay article update 123
+```
+
+也可以省略 ID，使用当前账号最近一次保存的未上线文章：
+
+```bash
+qcplay article update
+```
+
+8. **删除文章**
+
+用户明确要求删除时，将文章状态软删除为 `2`：
+
+```bash
+qcplay article delete 123
 ```
 
 ---
@@ -395,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 文件格式
@@ -455,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"
@@ -497,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` 非热门 |
@@ -586,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]` 上线。
 
 ---
 
@@ -818,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`，例如：
@@ -880,7 +913,7 @@ qcplay article import "https://mp.weixin.qq.com/s/..." article.md
 - 输出状态固定为未发布，发布前必须检查分类、缩略图、发布日期和正文；
 - 不允许覆盖已经存在的文件。
 
-### 发布文章
+### 保存未上线文章
 
 ```bash
 qcplay www-article-list.store article.md
@@ -894,88 +927,21 @@ qcplay www-article-list.store ./articles/news.md
 
 ---
 
-## npm 调用到 Go 程序的约定
+## CLI 与后端约定
 
-Node CLI 只负责路由，不负责发布逻辑。
+Node CLI 负责解析 Markdown、构建请求、读取本地认证状态和输出结果；Go 后端负责认证、权限校验和数据库更新。
 
-当用户执行：
-
-```bash
-qcplay www-article-list.store article.md
-```
-
-Node CLI 内部应调用：
-
-```bash
-publish-article.exe --content-file <article.md绝对路径>
-```
-
-不要把 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`；
@@ -1000,9 +966,9 @@ Go 程序必须兼容：
 
 ---
 
-## 发布请求字段
+## 首次保存请求字段
 
-发布接口最终应收到：
+首次保存接口最终应收到：
 
 ```json
 {
@@ -1013,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",
@@ -1033,23 +999,33 @@ Go 程序必须兼容：
 
 ## 成功输出
 
-发布成功后输出：
+首次保存成功后输出：
 
 ```txt
-官网文章发布成功
-
-标题: 文章标题
-状态: 已发布
-文章链接: xxx
+文章已保存为未上线状态
+文章 ID: 123
+文章状态: 未上线
+预览地址: https://snail.qingcigame.com/official/news-details.html?id=123
+已打开文章预览页面，请由用户检查文章内容和排版。
 ```
 
-如果 `status` 是 `"0"`：
+输出后必须等待用户明确答复。不能因为接口成功、页面可以打开或 AI 自行检查通过而自动上线。
+
+确认上线成功后输出：
 
 ```txt
-官网文章已保存为未发布状态
+文章已上线
+文章 ID: 123
+文章状态: 已上线
+文章地址: https://snail.qingcigame.com/official/news-details.html?id=123
+```
+
+删除成功后输出：
 
-标题: 文章标题
-状态: 未发布
+```txt
+文章已删除
+文章 ID: 123
+文章状态: 已删除
 ```
 
 ---
@@ -1142,13 +1118,14 @@ 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`，不得物理删除数据；
+13. 保存成功后只负责打开预览网页，由用户本人检查；
+14. AI 不得访问、抓取、截图、分析、比较或判断预览内容。
 
 ---
 
@@ -1165,7 +1142,9 @@ release_time 格式错误，请使用 YYYY-MM-DD，例如 2026-07-09
 7. 将 token 写入 article.md；
 8. 未校验正文直接发布；
 9. 将 `is_index2` 和 `type` 暴露给普通用户填写；
-10. 发布失败时伪造成功结果。
+10. 发布失败时伪造成功结果；
+11. AI 自动检查预览页面并代替用户决定上线；
+12. 未收到用户明确确认就把文章更新为 `status=1`。
 
 ---
 
@@ -1189,14 +1168,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`；
+- 能调用认证后端并处理接口错误；
 - 能处理无权限错误；
 - 能处理字段缺失错误；
 - 不要求用户在命令行传标题；
@@ -1211,8 +1197,11 @@ qcplay www-article-list.store article.md
 命令只传文章文件。
 正文自动作为 article_content。
 登录状态读取 auth.json。
-Node 只做路由。
-Go 负责发布。
+Node 解析文章并调用后端。
+Go 后端负责权限和数据库更新。
 默认参数程序内部补齐。
+首次保存固定 status=0。
+确认后更新 status=1。
+删除更新 status=2。
 发布失败不得伪造成成功。
 ```