From 81f4b8f827055bf180c5b54312e73cf5f554fe72 Mon Sep 17 00:00:00 2001 From: mateaix <57164338+mateaix@users.noreply.github.com> Date: Sat, 11 Jul 2026 20:03:34 +0800 Subject: [PATCH] =?UTF-8?q?feat(content-studio):=20=E5=B0=8F=E7=BA=A2?= =?UTF-8?q?=E4=B9=A6=E4=BB=A5=E5=9B=BE=E4=B8=BA=E4=B8=BB=E6=89=93=E5=8C=85?= =?UTF-8?q?=20xhs=5Fpackage=EF=BC=88=E5=BC=BA=E5=88=B6=E2=89=A53=E5=9B=BE?= =?UTF-8?q?=20+=20=E5=9C=A8=E7=BA=BF=E9=A2=84=E8=A7=88=EF=BC=89?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .../vip/mate/tool/builtin/XhsPackageTool.java | 366 ++++++++++++++++++ .../src/main/resources/db/data-en.sql | 4 + .../main/resources/db/data-kingbase-en.sql | 4 + .../main/resources/db/data-kingbase-zh.sql | 4 + .../src/main/resources/db/data-mysql-en.sql | 4 + .../src/main/resources/db/data-mysql-zh.sql | 4 + .../src/main/resources/db/data-zh.sql | 4 + .../h2/V168__content_studio_seed.sql | 6 +- .../kingbase/V168__content_studio_seed.sql | 6 +- .../mysql/V168__content_studio_seed.sql | 6 +- .../main/resources/skills/xhs_note/SKILL.md | 39 +- .../vip/mate/tool/builtin/XhsPackageTest.java | 84 ++++ 12 files changed, 518 insertions(+), 13 deletions(-) create mode 100644 mateclaw-server/src/main/java/vip/mate/tool/builtin/XhsPackageTool.java create mode 100644 mateclaw-server/src/test/java/vip/mate/tool/builtin/XhsPackageTest.java diff --git a/mateclaw-server/src/main/java/vip/mate/tool/builtin/XhsPackageTool.java b/mateclaw-server/src/main/java/vip/mate/tool/builtin/XhsPackageTool.java new file mode 100644 index 00000000..27c687fd --- /dev/null +++ b/mateclaw-server/src/main/java/vip/mate/tool/builtin/XhsPackageTool.java @@ -0,0 +1,366 @@ +package vip.mate.tool.builtin; + +import cn.hutool.http.HttpUtil; +import lombok.RequiredArgsConstructor; +import lombok.extern.slf4j.Slf4j; +import org.springframework.ai.chat.model.ToolContext; +import org.springframework.ai.tool.annotation.Tool; +import org.springframework.ai.tool.annotation.ToolParam; +import org.springframework.lang.Nullable; +import org.springframework.stereotype.Component; +import vip.mate.tool.browser.UrlSafetyChecker; +import vip.mate.tool.document.GeneratedFileCache; +import vip.mate.tool.guard.WorkspacePathGuard; + +import java.io.ByteArrayOutputStream; +import java.nio.charset.StandardCharsets; +import java.nio.file.Files; +import java.nio.file.Path; +import java.util.ArrayList; +import java.util.List; +import java.util.Optional; +import java.util.regex.Matcher; +import java.util.zip.ZipEntry; +import java.util.zip.ZipOutputStream; + +/** + * Built-in tool: assemble a Xiaohongshu (小红书) image-text note into an + * image-first online preview plus a downloadable material bundle — the + * flagship delivery step for 小红书, mirroring what {@code gzh_package} does for + * 公众号. + * + *

小红书 is an image-first medium: readers swipe a set of vertical (3:4) + * cards, and the copy is supporting. This tool therefore renders a phone-style + * preview where the images dominate (a horizontal swipe carousel up top) and the + * title / body / topic tags sit beneath as support, and it requires at least + * {@value #MIN_IMAGES} images (a cover plus content cards / photos) — packaging + * fewer is refused so a note never ships text-heavy. + * + *

Image references are usually {@code render_html_image} / {@code image_generate} + * outputs ({@code /api/v1/files/generated/{id}} links), resolved to bytes via + * {@link GeneratedFileCache}; plain http(s) URLs and workspace file paths also + * work. A reference that points at a file's logical name instead of its issued id + * is self-healed by filename, the same way {@code gzh_package} resolves its cover. + * + *

Outputs: an online preview (served {@code text/html} behind a strict CSP), + * plus a {@code .zip} of numbered card images + {@code 文案.txt}. Publishing stays + * manual — 小红书 has no official publish API — so the result carries the same + * creator-platform upload steps as {@code xhs_publish}. + */ +@Slf4j +@Component +@RequiredArgsConstructor +public class XhsPackageTool { + + /** 小红书 is image-first: a note must carry at least a cover plus two more images. */ + private static final int MIN_IMAGES = 3; + /** Xiaohongshu allows up to 18 images per note. */ + private static final int MAX_IMAGES = 18; + private static final String CREATOR_URL = "https://creator.xiaohongshu.com/publish/publish"; + + // Palette — light, clean, 小红书-ish. + private static final String INK = "#222222"; + private static final String MUTED = "#7a7a7a"; + private static final String TAG = "#13386c"; + private static final String CARD_BG = "#ffffff"; + private static final String PAGE_BG = "#f4f4f4"; + + private final GeneratedFileCache cache; + + @Tool(name = "xhs_package", description = """ + Package a Xiaohongshu (小红书) note into an IMAGE-FIRST online preview plus a + downloadable material bundle — the default delivery step of xhs_note. + + 小红书 leads with images: pass the ordered card images (first = cover) and the + copy plays a supporting role. REQUIRES at least 3 images (a cover + >=2 content + cards / photos); fewer is refused, so generate enough with image_generate + (aspectRatio=portrait) / render_html_image first. + + Params: title, body (with emoji + line breaks), tags (comma-separated), and + images (comma-separated references in display order — render_html_image / + image_generate URLs /api/v1/files/generated/{id}, http(s) image URLs, or + workspace file paths). + + Returns: an 在线预览 link (a phone-style swipe preview: images up top, copy + below), a 素材下载 .zip (numbered card images + 文案.txt), and the manual + creator-platform upload steps. 小红书 has no publish API — never auto-uploads. + """) + public String xhs_package( + @ToolParam(description = "Note title (小红书 标题, <=20 chars recommended)") + String title, + @ToolParam(description = "Note body text, with emoji and line breaks") + String body, + @ToolParam(description = "Topic tags, comma-separated, e.g. 咖啡,探店,周末去哪儿", required = false) + String tags, + @ToolParam(description = "Comma-separated image references in display order (first = cover); >=3 required") + String images, + @Nullable ToolContext ctx) { + + if (title == null || title.isBlank()) { + return "Error: title is required."; + } + + // Resolve images first — 小红书 is image-first, so this is the gate. + List imgs = new ArrayList<>(); + List skipped = new ArrayList<>(); + if (images != null && !images.isBlank()) { + for (String raw : images.split(",")) { + String ref = raw.trim(); + if (ref.isEmpty()) { + continue; + } + if (imgs.size() >= MAX_IMAGES) { + skipped.add(ref + " (超过 " + MAX_IMAGES + " 张上限)"); + continue; + } + try { + imgs.add(resolveImage(ref, ctx)); + } catch (Exception e) { + skipped.add(ref + " (" + e.getMessage() + ")"); + } + } + } + if (imgs.size() < MIN_IMAGES) { + StringBuilder err = new StringBuilder(); + err.append("⛔ 小红书以图为主，至少需要 ").append(MIN_IMAGES) + .append(" 张图（1 封面 + ≥").append(MIN_IMAGES - 1) + .append(" 张内容图/照片），当前只解析到 ").append(imgs.size()).append(" 张。\n"); + if (!skipped.isEmpty()) { + err.append("未解析：").append(String.join("；", skipped)).append("\n"); + } + err.append("请先用 image_generate(aspectRatio=portrait) 或 render_html_image 生成到 ≥") + .append(MIN_IMAGES).append(" 张竖版图，再调用 xhs_package。"); + return err.toString(); + } + + // Online preview — image-first phone layout served inline (text/html + CSP). + String previewDoc = buildPreview(title.trim(), body, tags, imgs); + String previewUrl = store(previewDoc.getBytes(StandardCharsets.UTF_8), "小红书预览.html", "text/html", ctx); + + // Material bundle — 文案.txt + numbered card images. + String copy = buildCopy(title, body, tags); + String zipUrl; + try { + zipUrl = store(buildZip(copy, imgs), "小红书素材.zip", "application/zip", ctx); + } catch (Exception e) { + log.warn("[XhsPackage] zip build failed: {}", e.getMessage()); + zipUrl = null; + } + + StringBuilder out = new StringBuilder(); + out.append("✅ 小红书笔记已打包完成（").append(imgs.size()).append(" 张图，以图为主）。\n\n"); + out.append("🔍 在线预览（手机版滑动预览，图在上、文案在下）：").append(previewUrl).append('\n'); + if (zipUrl != null) { + out.append("📦 素材下载（按 01、02… 编号的卡片图 + 文案.txt）：").append(zipUrl).append('\n'); + } + if (!skipped.isEmpty()) { + out.append("⚠️ 未打包：").append(String.join("；", skipped)).append('\n'); + } + out.append('\n').append(guideText()); + log.info("[XhsPackage] packaged '{}' ({} images, {} skipped)", title, imgs.size(), skipped.size()); + return out.toString(); + } + + /** Build the image-first phone-style preview: a swipe carousel of cards, copy beneath. */ + private String buildPreview(String title, @Nullable String body, @Nullable String tags, List imgs) { + StringBuilder cards = new StringBuilder(); + for (int i = 0; i < imgs.size(); i++) { + cards.append("

" + + "\"card
"); + } + String swipeHint = imgs.size() > 1 + ? "

← 左右滑动查看 " + + imgs.size() + " 张图 →

" + : ""; + String bodyHtml = (body != null && !body.isBlank()) + ? "

" + + nl2br(body.trim()) + "

" + : ""; + StringBuilder tagHtml = new StringBuilder(); + if (tags != null && !tags.isBlank()) { + tagHtml.append("

"); + for (String t : tags.split(",")) { + String tag = t.trim().replaceFirst("^#", ""); + if (!tag.isEmpty()) { + tagHtml.append("#") + .append(escapeText(tag)).append(""); + } + } + tagHtml.append("

"); + } + + String note = + "
" + // Image carousel — the hero, image-first. + + "
" + cards + "
" + + swipeHint + // Copy — supporting, beneath the images. + + "
" + + "

" + + escapeText(title) + "

" + + bodyHtml + tagHtml + + "
"; + + return "" + + "" + + "" + escapeText(title) + "" + + "" + + note + ""; + } + + private String buildCopy(@Nullable String title, @Nullable String body, @Nullable String tags) { + StringBuilder sb = new StringBuilder(); + if (title != null && !title.isBlank()) { + sb.append("【标题】\n").append(title.trim()).append("\n\n"); + } + if (body != null && !body.isBlank()) { + sb.append("【正文】\n").append(body.trim()).append("\n\n"); + } + if (tags != null && !tags.isBlank()) { + StringBuilder tagLine = new StringBuilder("【话题标签】\n"); + for (String t : tags.split(",")) { + String tag = t.trim().replaceFirst("^#", ""); + if (!tag.isEmpty()) { + tagLine.append('#').append(tag).append(' '); + } + } + sb.append(tagLine.toString().trim()).append('\n'); + } + return sb.toString().strip(); + } + + private byte[] buildZip(String copy, List imgs) throws Exception { + ByteArrayOutputStream bos = new ByteArrayOutputStream(); + try (ZipOutputStream zos = new ZipOutputStream(bos)) { + zos.putNextEntry(new ZipEntry("文案.txt")); + zos.write(copy.getBytes(StandardCharsets.UTF_8)); + zos.closeEntry(); + for (int i = 0; i < imgs.size(); i++) { + zos.putNextEntry(new ZipEntry(String.format("%02d.%s", i + 1, imgs.get(i).ext()))); + zos.write(imgs.get(i).bytes()); + zos.closeEntry(); + } + } + return bos.toByteArray(); + } + + /** + * Resolve an image reference to bytes + extension + a servable URL. Generated + * ids resolve via the cache (self-healing a name-based reference by filename); + * http(s) URLs are downloaded; workspace files are read and re-stored so the + * preview has a servable URL to embed. + */ + private ResolvedImg resolveImage(String ref, @Nullable ToolContext ctx) throws Exception { + Matcher m = GeneratedFileCache.GENERATED_URL_PATTERN.matcher(ref); + if (m.find()) { + String id = m.group(1); + Optional entry = cache.get(id); + if (entry.isEmpty() || entry.get().bytes() == null || entry.get().bytes().length == 0) { + // Self-heal: the ref may point at the file's name, not its id. + Optional healed = cache.findIdByFilename(lastSegment(ref), "image/"); + if (healed.isPresent()) { + id = healed.get(); + entry = cache.get(id); + } + } + if (entry.isEmpty() || entry.get().bytes() == null || entry.get().bytes().length == 0) { + throw new IllegalStateException("生成文件已过期或不存在"); + } + return new ResolvedImg(entry.get().bytes(), + extFromMime(entry.get().mimeType(), "png"), cache.downloadUrl(id, ctx)); + } + if (ref.startsWith("http://") || ref.startsWith("https://")) { + UrlSafetyChecker.check(ref); + byte[] bytes = HttpUtil.downloadBytes(ref); + if (bytes == null || bytes.length == 0) { + throw new IllegalStateException("下载为空"); + } + return new ResolvedImg(bytes, extFromUrl(ref), ref); + } + // Workspace file path — read, then re-store so the preview can serve it. + Path path = WorkspacePathGuard.validatePath(ref); + if (!Files.exists(path) || Files.isDirectory(path)) { + throw new IllegalStateException("文件不存在"); + } + byte[] bytes = Files.readAllBytes(path); + String ext = extFromUrl(ref); + String id = cache.put(bytes, path.getFileName().toString(), mimeFromExt(ext)); + return new ResolvedImg(bytes, ext, cache.downloadUrl(id, ctx)); + } + + private String store(byte[] bytes, String name, String mime, @Nullable ToolContext ctx) { + return cache.downloadUrl(cache.put(bytes, name, mime), ctx); + } + + private String guideText() { + return """ + 📮 小红书发布步骤（手动，小红书无官方发布 API）： + 1. 下载素材包并解压。 + 2. 打开创作平台 %s （需已登录），点「上传图文」。 + 3. 按 01、02… 顺序上传卡片图（首图即封面）。 + 4. 从「文案.txt」复制标题、正文、话题标签，粘贴到对应输入框。 + 5. 核对无违禁词后自行发布。""".formatted(CREATOR_URL); + } + + /** Last path segment of a reference, minus any {@code ?query} / {@code #fragment}. */ + private static String lastSegment(String ref) { + String s = ref.split("[?#]")[0]; + int slash = s.lastIndexOf('/'); + return slash >= 0 ? s.substring(slash + 1) : s; + } + + private static String extFromMime(String mime, String fallback) { + if (mime == null) { + return fallback; + } + return switch (mime.toLowerCase()) { + case "image/png" -> "png"; + case "image/jpeg", "image/jpg" -> "jpg"; + case "image/webp" -> "webp"; + case "image/gif" -> "gif"; + default -> fallback; + }; + } + + private static String mimeFromExt(String ext) { + return switch (ext.toLowerCase()) { + case "jpg", "jpeg" -> "image/jpeg"; + case "webp" -> "image/webp"; + case "gif" -> "image/gif"; + default -> "image/png"; + }; + } + + private static String extFromUrl(String url) { + String clean = url.split("[?#]")[0]; + int dot = clean.lastIndexOf('.'); + if (dot >= 0 && dot < clean.length() - 1) { + String ext = clean.substring(dot + 1).toLowerCase(); + if (ext.length() <= 4 && ext.matches("[a-z0-9]+")) { + return ext; + } + } + return "png"; + } + + private static String nl2br(String s) { + return escapeText(s).replace("\n", "
"); + } + + private static String escapeText(String s) { + return s.replace("&", "&").replace("<", "<").replace(">", ">"); + } + + private static String escapeAttr(String s) { + return escapeText(s).replace("\"", """); + } + + private record ResolvedImg(byte[] bytes, String ext, String url) {} +} diff --git a/mateclaw-server/src/main/resources/db/data-en.sql b/mateclaw-server/src/main/resources/db/data-en.sql index 5b1ef32f..6db36b2c 100644 --- a/mateclaw-server/src/main/resources/db/data-en.sql +++ b/mateclaw-server/src/main/resources/db/data-en.sql @@ -1950,3 +1950,7 @@ VALUES (1000000633, 'GzhPackageTool', 'WeChat Article Package', 'Package a finis MERGE INTO mate_tool (id, name, display_name, description, tool_type, bean_name, icon, enabled, builtin, create_time, update_time, deleted) KEY (id) VALUES (1000000634, 'ScreenshotTool', 'Console Screenshot', 'Capture a screenshot of a MateClaw console page (relative path like /chat, /channels) and return an embeddable image URL. Use it to put REAL product screenshots into how-to/tutorial articles; embed the returned URL as ![](url) in a gzh_package Markdown body.', 'builtin', 'screenshotTool', '📷', TRUE, TRUE, NOW(), NOW(), 0); + +MERGE INTO mate_tool (id, name, display_name, description, tool_type, bean_name, icon, enabled, builtin, create_time, update_time, deleted) +KEY (id) +VALUES (1000000635, 'XhsPackageTool', 'Xiaohongshu Package', 'Package a Xiaohongshu (小红书) note into an image-first online preview (phone-style swipe: images up top, copy below) plus a material zip (numbered card images + copy.txt). Requires at least 3 vertical images (1 cover + >=2 content); refuses fewer. 小红书 has no publish API; never auto-uploads.', 'builtin', 'xhsPackageTool', '🖼️', TRUE, TRUE, NOW(), NOW(), 0); diff --git a/mateclaw-server/src/main/resources/db/data-kingbase-en.sql b/mateclaw-server/src/main/resources/db/data-kingbase-en.sql index 2c8d7b49..a7f2f1e9 100644 --- a/mateclaw-server/src/main/resources/db/data-kingbase-en.sql +++ b/mateclaw-server/src/main/resources/db/data-kingbase-en.sql @@ -1875,3 +1875,7 @@ ON CONFLICT (id) DO UPDATE SET name=EXCLUDED.name, display_name=EXCLUDED.display INSERT INTO mate_tool (id, name, display_name, description, tool_type, bean_name, icon, enabled, builtin, create_time, update_time, deleted) VALUES (1000000634, 'ScreenshotTool', 'Console Screenshot', 'Capture a screenshot of a MateClaw console page (relative path like /chat, /channels) and return an embeddable image URL. Use it to put REAL product screenshots into how-to/tutorial articles; embed the returned URL as ![](url) in a gzh_package Markdown body.', 'builtin', 'screenshotTool', '📷', TRUE, TRUE, NOW(), NOW(), 0) ON CONFLICT (id) DO UPDATE SET name=EXCLUDED.name, display_name=EXCLUDED.display_name, description=EXCLUDED.description, tool_type=EXCLUDED.tool_type, bean_name=EXCLUDED.bean_name, icon=EXCLUDED.icon, enabled=EXCLUDED.enabled, builtin=EXCLUDED.builtin, update_time=EXCLUDED.update_time, deleted=EXCLUDED.deleted; + +INSERT INTO mate_tool (id, name, display_name, description, tool_type, bean_name, icon, enabled, builtin, create_time, update_time, deleted) +VALUES (1000000635, 'XhsPackageTool', 'Xiaohongshu Package', 'Package a Xiaohongshu (小红书) note into an image-first online preview (phone-style swipe: images up top, copy below) plus a material zip (numbered card images + copy.txt). Requires at least 3 vertical images (1 cover + >=2 content); refuses fewer. 小红书 has no publish API; never auto-uploads.', 'builtin', 'xhsPackageTool', '🖼️', TRUE, TRUE, NOW(), NOW(), 0) +ON CONFLICT (id) DO UPDATE SET name=EXCLUDED.name, display_name=EXCLUDED.display_name, description=EXCLUDED.description, tool_type=EXCLUDED.tool_type, bean_name=EXCLUDED.bean_name, icon=EXCLUDED.icon, enabled=EXCLUDED.enabled, builtin=EXCLUDED.builtin, update_time=EXCLUDED.update_time, deleted=EXCLUDED.deleted; diff --git a/mateclaw-server/src/main/resources/db/data-kingbase-zh.sql b/mateclaw-server/src/main/resources/db/data-kingbase-zh.sql index ef66abdd..dea6ce35 100644 --- a/mateclaw-server/src/main/resources/db/data-kingbase-zh.sql +++ b/mateclaw-server/src/main/resources/db/data-kingbase-zh.sql @@ -1872,3 +1872,7 @@ ON CONFLICT (id) DO UPDATE SET name=EXCLUDED.name, display_name=EXCLUDED.display INSERT INTO mate_tool (id, name, display_name, description, tool_type, bean_name, icon, enabled, builtin, create_time, update_time, deleted) VALUES (1000000634, 'ScreenshotTool', '后台截图', '截取 MateClaw 后台页面（站内相对路径如 /chat、/channels）并返回可嵌入的图片 URL。用于给「如何用 MateClaw 做 XX」这类操作教程配真实产品截图，把返回 URL 以 ![](url) 嵌进 gzh_package 的 Markdown。', 'builtin', 'screenshotTool', '📷', TRUE, TRUE, NOW(), NOW(), 0) ON CONFLICT (id) DO UPDATE SET name=EXCLUDED.name, display_name=EXCLUDED.display_name, description=EXCLUDED.description, tool_type=EXCLUDED.tool_type, bean_name=EXCLUDED.bean_name, icon=EXCLUDED.icon, enabled=EXCLUDED.enabled, builtin=EXCLUDED.builtin, update_time=EXCLUDED.update_time, deleted=EXCLUDED.deleted; + +INSERT INTO mate_tool (id, name, display_name, description, tool_type, bean_name, icon, enabled, builtin, create_time, update_time, deleted) +VALUES (1000000635, 'XhsPackageTool', '小红书打包', '把小红书笔记打包成在线预览（手机版滑动预览，以图为主、文字辅助）+ 素材下载 zip（编号卡片图 + 文案.txt）。强制至少 3 张竖版图（1 封面 + ≥2 内容图），不足则拒绝打包。小红书无发布 API，不自动上传。', 'builtin', 'xhsPackageTool', '🖼️', TRUE, TRUE, NOW(), NOW(), 0) +ON CONFLICT (id) DO UPDATE SET name=EXCLUDED.name, display_name=EXCLUDED.display_name, description=EXCLUDED.description, tool_type=EXCLUDED.tool_type, bean_name=EXCLUDED.bean_name, icon=EXCLUDED.icon, enabled=EXCLUDED.enabled, builtin=EXCLUDED.builtin, update_time=EXCLUDED.update_time, deleted=EXCLUDED.deleted; diff --git a/mateclaw-server/src/main/resources/db/data-mysql-en.sql b/mateclaw-server/src/main/resources/db/data-mysql-en.sql index 9d3e1a12..12452bf6 100644 --- a/mateclaw-server/src/main/resources/db/data-mysql-en.sql +++ b/mateclaw-server/src/main/resources/db/data-mysql-en.sql @@ -1991,3 +1991,7 @@ ON DUPLICATE KEY UPDATE name=VALUES(name), display_name=VALUES(display_name), de INSERT INTO mate_tool (id, name, display_name, description, tool_type, bean_name, icon, enabled, builtin, create_time, update_time, deleted) VALUES (1000000634, 'ScreenshotTool', 'Console Screenshot', 'Capture a screenshot of a MateClaw console page (relative path like /chat, /channels) and return an embeddable image URL. Use it to put REAL product screenshots into how-to/tutorial articles; embed the returned URL as ![](url) in a gzh_package Markdown body.', 'builtin', 'screenshotTool', '📷', TRUE, TRUE, NOW(), NOW(), 0) ON DUPLICATE KEY UPDATE name=VALUES(name), display_name=VALUES(display_name), description=VALUES(description), tool_type=VALUES(tool_type), bean_name=VALUES(bean_name), icon=VALUES(icon), enabled=VALUES(enabled), builtin=VALUES(builtin), update_time=VALUES(update_time), deleted=VALUES(deleted); + +INSERT INTO mate_tool (id, name, display_name, description, tool_type, bean_name, icon, enabled, builtin, create_time, update_time, deleted) +VALUES (1000000635, 'XhsPackageTool', 'Xiaohongshu Package', 'Package a Xiaohongshu (小红书) note into an image-first online preview (phone-style swipe: images up top, copy below) plus a material zip (numbered card images + copy.txt). Requires at least 3 vertical images (1 cover + >=2 content); refuses fewer. 小红书 has no publish API; never auto-uploads.', 'builtin', 'xhsPackageTool', '🖼️', TRUE, TRUE, NOW(), NOW(), 0) +ON DUPLICATE KEY UPDATE name=VALUES(name), display_name=VALUES(display_name), description=VALUES(description), tool_type=VALUES(tool_type), bean_name=VALUES(bean_name), icon=VALUES(icon), enabled=VALUES(enabled), builtin=VALUES(builtin), update_time=VALUES(update_time), deleted=VALUES(deleted); diff --git a/mateclaw-server/src/main/resources/db/data-mysql-zh.sql b/mateclaw-server/src/main/resources/db/data-mysql-zh.sql index 9efe9862..b34d5bbe 100644 --- a/mateclaw-server/src/main/resources/db/data-mysql-zh.sql +++ b/mateclaw-server/src/main/resources/db/data-mysql-zh.sql @@ -1988,3 +1988,7 @@ ON DUPLICATE KEY UPDATE name=VALUES(name), display_name=VALUES(display_name), de INSERT INTO mate_tool (id, name, display_name, description, tool_type, bean_name, icon, enabled, builtin, create_time, update_time, deleted) VALUES (1000000634, 'ScreenshotTool', '后台截图', '截取 MateClaw 后台页面（站内相对路径如 /chat、/channels）并返回可嵌入的图片 URL。用于给「如何用 MateClaw 做 XX」这类操作教程配真实产品截图，把返回 URL 以 ![](url) 嵌进 gzh_package 的 Markdown。', 'builtin', 'screenshotTool', '📷', TRUE, TRUE, NOW(), NOW(), 0) ON DUPLICATE KEY UPDATE name=VALUES(name), display_name=VALUES(display_name), description=VALUES(description), tool_type=VALUES(tool_type), bean_name=VALUES(bean_name), icon=VALUES(icon), enabled=VALUES(enabled), builtin=VALUES(builtin), update_time=VALUES(update_time), deleted=VALUES(deleted); + +INSERT INTO mate_tool (id, name, display_name, description, tool_type, bean_name, icon, enabled, builtin, create_time, update_time, deleted) +VALUES (1000000635, 'XhsPackageTool', '小红书打包', '把小红书笔记打包成在线预览（手机版滑动预览，以图为主、文字辅助）+ 素材下载 zip（编号卡片图 + 文案.txt）。强制至少 3 张竖版图（1 封面 + ≥2 内容图），不足则拒绝打包。小红书无发布 API，不自动上传。', 'builtin', 'xhsPackageTool', '🖼️', TRUE, TRUE, NOW(), NOW(), 0) +ON DUPLICATE KEY UPDATE name=VALUES(name), display_name=VALUES(display_name), description=VALUES(description), tool_type=VALUES(tool_type), bean_name=VALUES(bean_name), icon=VALUES(icon), enabled=VALUES(enabled), builtin=VALUES(builtin), update_time=VALUES(update_time), deleted=VALUES(deleted); diff --git a/mateclaw-server/src/main/resources/db/data-zh.sql b/mateclaw-server/src/main/resources/db/data-zh.sql index a9180ff6..6cfef638 100644 --- a/mateclaw-server/src/main/resources/db/data-zh.sql +++ b/mateclaw-server/src/main/resources/db/data-zh.sql @@ -1951,3 +1951,7 @@ VALUES (1000000633, 'GzhPackageTool', '公众号打包', '把公众号成稿（M MERGE INTO mate_tool (id, name, display_name, description, tool_type, bean_name, icon, enabled, builtin, create_time, update_time, deleted) KEY (id) VALUES (1000000634, 'ScreenshotTool', '后台截图', '截取 MateClaw 后台页面（站内相对路径如 /chat、/channels）并返回可嵌入的图片 URL。用于给「如何用 MateClaw 做 XX」这类操作教程配真实产品截图，把返回 URL 以 ![](url) 嵌进 gzh_package 的 Markdown。', 'builtin', 'screenshotTool', '📷', TRUE, TRUE, NOW(), NOW(), 0); + +MERGE INTO mate_tool (id, name, display_name, description, tool_type, bean_name, icon, enabled, builtin, create_time, update_time, deleted) +KEY (id) +VALUES (1000000635, 'XhsPackageTool', '小红书打包', '把小红书笔记打包成在线预览（手机版滑动预览，以图为主、文字辅助）+ 素材下载 zip（编号卡片图 + 文案.txt）。强制至少 3 张竖版图（1 封面 + ≥2 内容图），不足则拒绝打包。小红书无发布 API，不自动上传。', 'builtin', 'xhsPackageTool', '🖼️', TRUE, TRUE, NOW(), NOW(), 0); diff --git a/mateclaw-server/src/main/resources/db/migration/h2/V168__content_studio_seed.sql b/mateclaw-server/src/main/resources/db/migration/h2/V168__content_studio_seed.sql index 3a64c9d3..6c208aaa 100644 --- a/mateclaw-server/src/main/resources/db/migration/h2/V168__content_studio_seed.sql +++ b/mateclaw-server/src/main/resources/db/migration/h2/V168__content_studio_seed.sql @@ -1,7 +1,7 @@ -- V168: Content Studio scenario seed (公众号 / 小红书 图文创作). -- Delivers to EXISTING databases the rows fresh installs get from db/data-*.sql: -- built-in tools (wechat_article_extract, gzh_publish, xhs_publish, gzh_package, --- capture_screenshot), the 内容工作室 (Content Studio) agent, and two disabled +-- capture_screenshot, xhs_package), the 内容工作室 (Content Studio) agent, and two disabled -- cron templates. DatabaseBootstrapRunner skips seeding once a database is -- initialized, so these would otherwise never reach upgraders. Idempotent upsert -- on id; content is the default (zh-CN) locale — a fresh install re-runs the @@ -28,6 +28,10 @@ MERGE INTO mate_tool (id, name, display_name, description, tool_type, bean_name, KEY (id) VALUES (1000000634, 'ScreenshotTool', '后台截图', '截取 MateClaw 后台页面（站内相对路径如 /chat、/channels）并返回可嵌入的图片 URL。用于给「如何用 MateClaw 做 XX」这类操作教程配真实产品截图，把返回 URL 以 ![](url) 嵌进 gzh_package 的 Markdown。', 'builtin', 'screenshotTool', '📷', TRUE, TRUE, NOW(), NOW(), 0); +MERGE INTO mate_tool (id, name, display_name, description, tool_type, bean_name, icon, enabled, builtin, create_time, update_time, deleted) +KEY (id) +VALUES (1000000635, 'XhsPackageTool', '小红书打包', '把小红书笔记打包成在线预览（手机版滑动预览，以图为主、文字辅助）+ 素材下载 zip（编号卡片图 + 文案.txt）。强制至少 3 张竖版图（1 封面 + ≥2 内容图），不足则拒绝打包。小红书无发布 API，不自动上传。', 'builtin', 'xhsPackageTool', '🖼️', TRUE, TRUE, NOW(), NOW(), 0); + MERGE INTO mate_agent (id, name, description, agent_type, system_prompt, model_name, max_iterations, enabled, icon, tags, create_time, update_time, deleted) KEY (id) VALUES (1000000640, '内容工作室', '端到端创作公众号与小红书图文：选题搜集、成文、配图、去AI化、排版、入草稿箱发布。', 'react', '你是 MateClaw 的「内容工作室」——专门端到端创作微信公众号（公众号）与小红书图文。 diff --git a/mateclaw-server/src/main/resources/db/migration/kingbase/V168__content_studio_seed.sql b/mateclaw-server/src/main/resources/db/migration/kingbase/V168__content_studio_seed.sql index 78776575..1eec9f29 100644 --- a/mateclaw-server/src/main/resources/db/migration/kingbase/V168__content_studio_seed.sql +++ b/mateclaw-server/src/main/resources/db/migration/kingbase/V168__content_studio_seed.sql @@ -1,7 +1,7 @@ -- V168: Content Studio scenario seed (公众号 / 小红书 图文创作). -- Delivers to EXISTING databases the rows fresh installs get from db/data-*.sql: -- built-in tools (wechat_article_extract, gzh_publish, xhs_publish, gzh_package, --- capture_screenshot), the 内容工作室 (Content Studio) agent, and two disabled +-- capture_screenshot, xhs_package), the 内容工作室 (Content Studio) agent, and two disabled -- cron templates. DatabaseBootstrapRunner skips seeding once a database is -- initialized, so these would otherwise never reach upgraders. Idempotent upsert -- on id; content is the default (zh-CN) locale — a fresh install re-runs the @@ -28,6 +28,10 @@ INSERT INTO mate_tool (id, name, display_name, description, tool_type, bean_name VALUES (1000000634, 'ScreenshotTool', '后台截图', '截取 MateClaw 后台页面（站内相对路径如 /chat、/channels）并返回可嵌入的图片 URL。用于给「如何用 MateClaw 做 XX」这类操作教程配真实产品截图，把返回 URL 以 ![](url) 嵌进 gzh_package 的 Markdown。', 'builtin', 'screenshotTool', '📷', TRUE, TRUE, NOW(), NOW(), 0) ON CONFLICT (id) DO UPDATE SET name=EXCLUDED.name, display_name=EXCLUDED.display_name, description=EXCLUDED.description, tool_type=EXCLUDED.tool_type, bean_name=EXCLUDED.bean_name, icon=EXCLUDED.icon, enabled=EXCLUDED.enabled, builtin=EXCLUDED.builtin, update_time=EXCLUDED.update_time, deleted=EXCLUDED.deleted; +INSERT INTO mate_tool (id, name, display_name, description, tool_type, bean_name, icon, enabled, builtin, create_time, update_time, deleted) +VALUES (1000000635, 'XhsPackageTool', '小红书打包', '把小红书笔记打包成在线预览（手机版滑动预览，以图为主、文字辅助）+ 素材下载 zip（编号卡片图 + 文案.txt）。强制至少 3 张竖版图（1 封面 + ≥2 内容图），不足则拒绝打包。小红书无发布 API，不自动上传。', 'builtin', 'xhsPackageTool', '🖼️', TRUE, TRUE, NOW(), NOW(), 0) +ON CONFLICT (id) DO UPDATE SET name=EXCLUDED.name, display_name=EXCLUDED.display_name, description=EXCLUDED.description, tool_type=EXCLUDED.tool_type, bean_name=EXCLUDED.bean_name, icon=EXCLUDED.icon, enabled=EXCLUDED.enabled, builtin=EXCLUDED.builtin, update_time=EXCLUDED.update_time, deleted=EXCLUDED.deleted; + INSERT INTO mate_agent (id, name, description, agent_type, system_prompt, model_name, max_iterations, enabled, icon, tags, create_time, update_time, deleted) VALUES (1000000640, '内容工作室', '端到端创作公众号与小红书图文：选题搜集、成文、配图、去AI化、排版、入草稿箱发布。', 'react', '你是 MateClaw 的「内容工作室」——专门端到端创作微信公众号（公众号）与小红书图文。 diff --git a/mateclaw-server/src/main/resources/db/migration/mysql/V168__content_studio_seed.sql b/mateclaw-server/src/main/resources/db/migration/mysql/V168__content_studio_seed.sql index 9b5f9ea9..6c56b99c 100644 --- a/mateclaw-server/src/main/resources/db/migration/mysql/V168__content_studio_seed.sql +++ b/mateclaw-server/src/main/resources/db/migration/mysql/V168__content_studio_seed.sql @@ -1,7 +1,7 @@ -- V168: Content Studio scenario seed (公众号 / 小红书 图文创作). -- Delivers to EXISTING databases the rows fresh installs get from db/data-*.sql: -- built-in tools (wechat_article_extract, gzh_publish, xhs_publish, gzh_package, --- capture_screenshot), the 内容工作室 (Content Studio) agent, and two disabled +-- capture_screenshot, xhs_package), the 内容工作室 (Content Studio) agent, and two disabled -- cron templates. DatabaseBootstrapRunner skips seeding once a database is -- initialized, so these would otherwise never reach upgraders. Idempotent upsert -- on id; content is the default (zh-CN) locale — a fresh install re-runs the @@ -28,6 +28,10 @@ INSERT INTO mate_tool (id, name, display_name, description, tool_type, bean_name VALUES (1000000634, 'ScreenshotTool', '后台截图', '截取 MateClaw 后台页面（站内相对路径如 /chat、/channels）并返回可嵌入的图片 URL。用于给「如何用 MateClaw 做 XX」这类操作教程配真实产品截图，把返回 URL 以 ![](url) 嵌进 gzh_package 的 Markdown。', 'builtin', 'screenshotTool', '📷', TRUE, TRUE, NOW(), NOW(), 0) ON DUPLICATE KEY UPDATE name=VALUES(name), display_name=VALUES(display_name), description=VALUES(description), tool_type=VALUES(tool_type), bean_name=VALUES(bean_name), icon=VALUES(icon), enabled=VALUES(enabled), builtin=VALUES(builtin), update_time=VALUES(update_time), deleted=VALUES(deleted); +INSERT INTO mate_tool (id, name, display_name, description, tool_type, bean_name, icon, enabled, builtin, create_time, update_time, deleted) +VALUES (1000000635, 'XhsPackageTool', '小红书打包', '把小红书笔记打包成在线预览（手机版滑动预览，以图为主、文字辅助）+ 素材下载 zip（编号卡片图 + 文案.txt）。强制至少 3 张竖版图（1 封面 + ≥2 内容图），不足则拒绝打包。小红书无发布 API，不自动上传。', 'builtin', 'xhsPackageTool', '🖼️', TRUE, TRUE, NOW(), NOW(), 0) +ON DUPLICATE KEY UPDATE name=VALUES(name), display_name=VALUES(display_name), description=VALUES(description), tool_type=VALUES(tool_type), bean_name=VALUES(bean_name), icon=VALUES(icon), enabled=VALUES(enabled), builtin=VALUES(builtin), update_time=VALUES(update_time), deleted=VALUES(deleted); + INSERT INTO mate_agent (id, name, description, agent_type, system_prompt, model_name, max_iterations, enabled, icon, tags, create_time, update_time, deleted) VALUES (1000000640, '内容工作室', '端到端创作公众号与小红书图文：选题搜集、成文、配图、去AI化、排版、入草稿箱发布。', 'react', '你是 MateClaw 的「内容工作室」——专门端到端创作微信公众号（公众号）与小红书图文。 diff --git a/mateclaw-server/src/main/resources/skills/xhs_note/SKILL.md b/mateclaw-server/src/main/resources/skills/xhs_note/SKILL.md index 69f2f025..dfa7d8d6 100644 --- a/mateclaw-server/src/main/resources/skills/xhs_note/SKILL.md +++ b/mateclaw-server/src/main/resources/skills/xhs_note/SKILL.md @@ -1,7 +1,7 @@ --- name: xhs_note -description: '小红书图文创作 / 笔记 / 种草文案 (xiaohongshu / red note) — 端到端：成文→图文卡片(HTML→图)→去AI化→交付。标题四件套 + 碎句正文 + 话题标签，配 3:4 竖版卡片。honors user persona & style memory.' -version: 1.0.0 +description: '小红书图文创作 / 笔记 / 种草文案 (xiaohongshu / red note) — 端到端：成文→配图(≥3 张竖版)→去AI化→在线预览打包交付。以图为主、文字辅助：标题四件套 + 碎句正文 + 话题标签，配 3:4 竖版卡片，最少 3 张图。honors user persona & style memory.' +version: 1.1.0 tags: - 小红书 - 图文 @@ -18,6 +18,10 @@ platforms: 把一个主题做成可直接发布的小红书笔记：文案 + 竖版图文卡片。 +> 🖼️ **小红书是「以图为主、文字辅助」的平台**。读者先滑图、再看字——首图（封面）决定点不点进来，图不够好、不够多，文案再好也没人看。 +> +> **硬性要求：每篇笔记至少 3 张竖版图（1 封面 + ≥2 张内容图/照片）**。`xhs_package` 会强制校验，不足 3 张直接拒绝打包。图要成组、风格统一、信息落在图上（大标题/清单/对比都做进图里），正文只作补充。 + ## 开工前：读取共享人设记忆 先用 `recall_structured` 取回并全程遵守： @@ -52,7 +56,18 @@ platforms: 大词 + 中词 + 长尾组合，例：`#护肤` `#敏感肌护肤` `#学生党平价护肤`。 -### 2. 图文卡片（HTML → 图） +### 2. 配图（以图为主，**≥3 张竖版**） + +这是小红书的重头戏。**至少出 3 张 3:4 竖版图**，一组风格统一： + +1. **封面（第 1 张，必出）** — 大标题 + 一句钩子，缩略图上就能读懂、想点进来。 +2. **内容图（≥2 张）** — 把干货做进图里：清单卡、步骤卡、对比卡、金句卡，或用 `image_generate`（`aspectRatio=portrait`）出实拍风照片/场景图。一条要点一张，别把所有字堆一张。 +3. **结尾图（可选）** — 关注 / 互动引导卡。 + +两种出图方式，按需混用，凑够 ≥3 张： + +- **HTML 卡片 → 图**：用下面的模板库填文案后 `render_html_image` 渲染。 +- **AI 生成照片/背景**：`image_generate(action=generate, aspectRatio=portrait)`（3:4 竖版），做封面底图或实拍风内容图。 **卡片模板库**（竖版 3:4，挑选组合或据用户口味自创）： - `references/xhs_card_cover.html` — 封面 / 大标题。 @@ -81,21 +96,25 @@ platforms: `load_skill deai_humanize`，对正文跑"打分→改写→复检"循环，`platform=xhs`，目标 `score ≤ 55`。小红书口吻要碎、要有情绪，别写成公众号。 -### 4. 交付 +### 4. 打包交付（xhs_package —— 在线预览 + 素材下载） -用 `xhs_publish`（action=export）把**卡片图 + 正文 + 话题标签**打成一个 `.zip` 发布包，一键下载： +**默认用 `xhs_package` 交付**。它产出小红书风的**在线预览**（手机版：图在上、可左右滑动，标题/正文/标签在下辅助）+ **素材 zip**（按 01、02… 编号的卡片图 + 文案.txt），并附手动上传步骤： ``` -xhs_publish(action="export", title="<标题>", body="<正文>", +xhs_package(title="<标题>", body="<正文，含 emoji 与换行>", tags="标签1,标签2,标签3", - images="<封面卡的 render_html_image 下载链接>,<内容卡链接>,<结尾卡链接>") + images="<封面图链接>,<内容图1链接>,<内容图2链接>[,更多]") ``` -`images` 按顺序传每张卡片的 `render_html_image` 返回链接（首图即封面）。工具会返回发布包下载链接 + 手动上传步骤。 +`images` 按展示顺序传每张图的 `render_html_image` / `image_generate` 返回链接（**首图即封面**）。 -小红书**没有官方发布 API**：由用户下载后到创作平台手动上传完成发布，**不自动上传、不绕过任何风控/人机验证**。发布属于对外动作，必须用户明确同意。 +> ⚠️ **`xhs_package` 强制 ≥3 张图**：解析到的图不足 3 张会被直接拒绝，并提示去补图。所以第 2 步务必先把 ≥3 张竖版图都出好，再来打包。 -发布前对照 `banned_words` 扫一遍正文和标题，命中即标注替换。 +把返回的**在线预览链接**发给用户看；满意后由用户下载素材 zip，到创作平台手动上传。小红书**没有官方发布 API**：**不自动上传、不绕过任何风控/人机验证**。发布属于对外动作，必须用户明确同意。 + +（旧的 `xhs_publish` 只出 zip、无在线预览，`xhs_package` 已覆盖并更完整；仅在用户只要发布包、不需要预览时才用它。） + +打包前对照 `banned_words` 扫一遍正文和标题，命中即标注替换。 ## 保存自定义卡片模板 / 对话升级技能 diff --git a/mateclaw-server/src/test/java/vip/mate/tool/builtin/XhsPackageTest.java b/mateclaw-server/src/test/java/vip/mate/tool/builtin/XhsPackageTest.java new file mode 100644 index 00000000..283f27e6 --- /dev/null +++ b/mateclaw-server/src/test/java/vip/mate/tool/builtin/XhsPackageTest.java @@ -0,0 +1,84 @@ +package vip.mate.tool.builtin; + +import org.junit.jupiter.api.BeforeEach; +import org.junit.jupiter.api.DisplayName; +import org.junit.jupiter.api.Test; +import org.junit.jupiter.api.io.TempDir; +import vip.mate.tool.document.GeneratedFileCache; + +import java.nio.charset.StandardCharsets; +import java.nio.file.Path; +import java.util.regex.Matcher; + +import static org.junit.jupiter.api.Assertions.*; + +/** + * Pin {@link XhsPackageTool}: 小红书 is image-first, so packaging must (a) refuse + * a note with fewer than 3 resolvable images, (b) render an image-first preview + * (the images come before the copy), and (c) self-heal an image referenced by + * filename instead of its issued id. + */ +class XhsPackageTest { + + private GeneratedFileCache cache; + private XhsPackageTool tool; + + @BeforeEach + void setUp(@TempDir Path tempDir) { + cache = new GeneratedFileCache(tempDir); + tool = new XhsPackageTool(cache); + } + + private String putImg(String name) { + String id = cache.put("PNGDATA".getBytes(), name, "image/png"); + return "/api/v1/files/generated/" + id; + } + + /** Read back the online-preview HTML that the tool stored, given its result text. */ + private String previewHtml(String out) { + Matcher m = GeneratedFileCache.GENERATED_URL_PATTERN.matcher(out); + assertTrue(m.find(), "result should contain a preview URL"); + return new String(cache.get(m.group(1)).orElseThrow().bytes(), StandardCharsets.UTF_8); + } + + @Test + @DisplayName("fewer than 3 images → refused, no preview minted") + void refusesUnderThreeImages() { + String imgs = putImg("cover.png") + "," + putImg("c1.png"); + String out = tool.xhs_package("夏日穿搭", "正文", "穿搭,夏天", imgs, null); + assertTrue(out.contains("至少需要 3 张"), "should demand >=3 images; got:\n" + out); + assertFalse(out.contains("在线预览"), "must not produce a preview when refused"); + } + + @Test + @DisplayName("3 images → packaged; preview is image-first (images before the copy)") + void packagesThreeImagesImageFirst() { + String imgs = putImg("cover.png") + "," + putImg("c1.png") + "," + putImg("c2.png"); + String out = tool.xhs_package("3天2夜厦门citywalk", "第一天去了鼓浪屿\n人不多", "厦门,citywalk,旅行", imgs, null); + + assertTrue(out.contains("在线预览"), "should return a preview link"); + assertTrue(out.contains("素材下载"), "should return a material zip"); + assertTrue(out.contains("3 张图"), "should report the image count"); + + String html = previewHtml(out); + int imgCount = html.split("=3; got:\n" + out); + assertTrue(out.contains("3 张图"), "healed image should be counted"); + } +}