@iflyrpa/actions 4.0.9 → 4.1.0-beta.1

package/dist/actions/searchAccountInfo/index.d.ts

@@ -38,9 +38,9 @@ export declare const SearchAccountInfoParamsSchema: z.ZodObject<{
     token: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
     platform: z.ZodEnum<{
         baijiahao: "baijiahao";
+        xiaohongshu: "xiaohongshu";
         douyin: "douyin";
         toutiao: "toutiao";
-        xiaohongshu: "xiaohongshu";
         weixin: "weixin";
         shipinhao: "shipinhao";
     }>;

package/dist/actions/searchPublishInfo/index.d.ts

@@ -48,9 +48,9 @@ export declare const FetchArticlesParamsSchema: z.ZodObject<{
     status: z.ZodOptional<z.ZodNumber>;
     includeAccount: z.ZodOptional<z.ZodBoolean>;
     postType: z.ZodOptional<z.ZodEnum<{
+        all: "all";
         article: "article";
         video: "video";
-        all: "all";
     }>>;
 }, z.core.$strip>;
 export type FetchArticlesParams = z.infer<typeof FetchArticlesParamsSchema>;

package/dist/actions/shipinhaoPublishVideo/index.d.ts

@@ -0,0 +1,95 @@
+import type { CommonAction } from "@iflyrpa/share";
+import { z } from "zod";
+/**
+ * 内容声明标注类型，对应发布体 `tagInfo.tagType`
+ *
+ * 取值来自 `post/finder_get_object_tag_list` 实测响应：
+ * 0=无需标注、1=含AI生成内容、2=内容包含营销广告、3=内容为虚构剧情仅供娱乐、
+ * 5=内容为自行拍摄、7=内容为转载、8=个人观点仅供参考
+ */
+export declare const ShipinhaoDeclareTagTypes: readonly [0, 1, 2, 3, 5, 7, 8];
+export declare const ShipinhaoPublishVideoParamsSchema: z.ZodObject<{
+    id: z.ZodOptional<z.ZodString>;
+    userAgent: z.ZodOptional<z.ZodString>;
+    viewport: z.ZodNullable<z.ZodOptional<z.ZodObject<{
+        width: z.ZodNumber;
+        height: z.ZodNumber;
+    }, z.core.$strip>>>;
+    url: z.ZodOptional<z.ZodString>;
+    cookies: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        value: z.ZodString;
+        domain: z.ZodOptional<z.ZodString>;
+        path: z.ZodOptional<z.ZodString>;
+        expires: z.ZodOptional<z.ZodNumber>;
+        httpOnly: z.ZodOptional<z.ZodBoolean>;
+        secure: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$catchall<z.ZodUnknown>>>;
+    localStorage: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        key: z.ZodString;
+        value: z.ZodString;
+    }, z.core.$catchall<z.ZodUnknown>>>>;
+    extraParam: z.ZodOptional<z.ZodAny>;
+    actionType: z.ZodOptional<z.ZodEnum<{
+        mockApi: "mockApi";
+        rpa: "rpa";
+        server: "server";
+    }>>;
+    accountId: z.ZodOptional<z.ZodNumber>;
+    proxyLoc: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    localIP: z.ZodOptional<z.ZodString>;
+    huiwenToken: z.ZodOptional<z.ZodString>;
+    articleId: z.ZodOptional<z.ZodString>;
+    saveType: z.ZodOptional<z.ZodString>;
+    uid: z.ZodOptional<z.ZodString>;
+    videoPath: z.ZodString;
+    videoMetadata: z.ZodObject<{
+        duration: z.ZodNumber;
+        width: z.ZodNumber;
+        height: z.ZodNumber;
+        fileSize: z.ZodNumber;
+        path: z.ZodOptional<z.ZodString>;
+        fileName: z.ZodString;
+    }, z.core.$strip>;
+    coverPath: z.ZodString;
+    verticalCoverPath: z.ZodOptional<z.ZodString>;
+    description: z.ZodString;
+    title: z.ZodOptional<z.ZodString>;
+    scheduledTime: z.ZodOptional<z.ZodNumber>;
+    isImmediatelyPublish: z.ZodOptional<z.ZodBoolean>;
+    topics: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    mentionedUsers: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        nickname: z.ZodString;
+    }, z.core.$strip>>>;
+    collection: z.ZodOptional<z.ZodObject<{
+        collectionId: z.ZodString;
+        collectionName: z.ZodString;
+    }, z.core.$strip>>;
+    event: z.ZodOptional<z.ZodObject<{
+        eventTopicId: z.ZodString;
+        eventName: z.ZodString;
+        eventCreatorNickname: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    link: z.ZodOptional<z.ZodObject<{
+        link: z.ZodString;
+        title: z.ZodString;
+        urlType: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$strip>>;
+    tagInfo: z.ZodOptional<z.ZodObject<{
+        /** 标注类型，取值见 ShipinhaoDeclareTagTypes */
+        tagType: z.ZodNumber;
+    }, z.core.$loose>>;
+    originalFlag: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<0>, z.ZodLiteral<1>]>>;
+    postWithMemberZoneLink: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<0>, z.ZodLiteral<1>]>>;
+    location: z.ZodOptional<z.ZodObject<{
+        latitude: z.ZodNumber;
+        longitude: z.ZodNumber;
+        city: z.ZodString;
+        poiName: z.ZodOptional<z.ZodString>;
+        address: z.ZodOptional<z.ZodString>;
+        poiClassifyId: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type ShipinhaoPublishVideoParams = z.infer<typeof ShipinhaoPublishVideoParamsSchema>;
+export type PublishVideoAction = CommonAction<ShipinhaoPublishVideoParams, string>;
+export declare const shipinhaoPublishVideo: PublishVideoAction;

package/dist/actions/shipinhaoPublishVideo/mock.d.ts

@@ -0,0 +1,4 @@
+import type { CommonAction } from "@iflyrpa/share";
+import type { ShipinhaoPublishVideoParams } from "./index";
+export type PublishVideoAction = CommonAction<ShipinhaoPublishVideoParams, string>;
+export declare const mockAction: PublishVideoAction;

package/dist/actions/shipinhaoPublishVideo/payload.d.ts

@@ -0,0 +1,70 @@
+/**
+ * post_create 发布体构建
+ *
+ * 字段结构以真实浏览器请求为准（见同目录 real.js，以及
+ * scripts/api-explorer/shipinhao-video-upload/dist/network-logs1.json 里捕获的 post_create 请求体）。
+ *
+ * 两次独立抓包一致的关键点：
+ * - 顶层 latitude/longitude/feedLatitude/feedLongitude 恒为 0，真实坐标只写在 objectDesc.location
+ * - objectDesc.shortTitle 是数组 `[{ shortTitle }]`，不是字符串
+ * - media[].md5sum 填 UUID 而非真实 md5（服务端不校验）
+ * - report 里的 width/height/duration/fileSize 是转码**前**的原始视频信息
+ */
+import type { ShipinhaoPublishVideoParams } from "./index";
+/** 描述文案中的话题片段：正文 → 话题 → @用户，与前端插入顺序一致 */
+export declare function buildDescription(params: {
+    description: string;
+    topics?: string[];
+    mentionedUsers?: Array<{
+        nickname: string;
+    }>;
+}): string;
+/** mentionedUser[].nickname：实测昵称后带一个普通空格 */
+export declare function buildMentionedUser(mentionedUsers?: Array<{
+    nickname: string;
+}>): Array<{
+    nickname: string;
+}>;
+/**
+ * 构建 finderTopicInfo XML
+ *
+ * value 节点按其在文案中出现的顺序排列：正文（非空时）为纯 CDATA，
+ * 话题为 `<topic><![CDATA[#name#]]></topic>`（注意首尾都有 #），
+ * @用户为 `@nickname` + U+2005 的 CDATA。
+ * `<style><at>` 指向第一个 @用户所在的 value 序号，没有 @用户时为空。
+ *
+ * ⚠️ `description` 传的必须是**原始正文**，不是 buildDescription 拼接后的结果 ——
+ * 拼接结果里已经含话题与 @用户，再进 value0 会重复一遍。
+ */
+export declare function buildTopicXml(params: {
+    description: string;
+    topics?: string[];
+    mentionedUsers?: Array<{
+        nickname: string;
+    }>;
+}): string;
+/** objectDesc.location：无位置时下发全 0 占位，与前端一致 */
+export declare function buildLocation(location?: ShipinhaoPublishVideoParams["location"]): Record<string, unknown>;
+/**
+ * objectDesc.topic：话题 XML + 合集信息合并在同一对象里
+ *
+ * `description` 同样要传原始正文，见 buildTopicXml 的说明。
+ */
+export declare function buildTopic(params: {
+    description: string;
+    topics?: string[];
+    mentionedUsers?: Array<{
+        nickname: string;
+    }>;
+    collection?: ShipinhaoPublishVideoParams["collection"];
+}): Record<string, unknown>;
+/** objectDesc.event：未参与活动时为空对象 */
+export declare function buildEvent(event?: ShipinhaoPublishVideoParams["event"]): Record<string, unknown>;
+/** objectDesc.extReading：无链接时也要带全字段占位（实测前端行为） */
+export declare function buildExtReading(link?: ShipinhaoPublishVideoParams["link"]): Record<string, unknown>;
+/**
+ * 顶层 tagInfo：原样透传调用方传入的对象，只补上实时 tagKey
+ *
+ * tagKey 由服务端每次下发且带时效，必须用当次取到的值，所以这里始终覆盖调用方传的同名字段。
+ */
+export declare function buildTagInfo(tagInfo: NonNullable<ShipinhaoPublishVideoParams["tagInfo"]>, tagKey: string): Record<string, unknown>;

package/dist/actions/shipinhaoPublishVideo/rpa.d.ts

@@ -0,0 +1,6 @@
+import type { PublishVideoAction } from "./mock";
+/**
+ * 视频号视频发布 - RPA 方式
+ * 通过浏览器自动化实现视频号视频发布
+ */
+export declare const rpaAction: PublishVideoAction;

package/dist/actions/shipinhaoPublishVideo/uploader.d.ts

@@ -0,0 +1,57 @@
+/**
+ * 视频号 CDN 上传器（视频 20302 / 封面 20304）
+ *
+ * 三阶段：applyupload → uploadpart×N → completepart
+ * 分片大小 8MB，ETag 用本地 MD5 拼装（服务端 ETag == 分片 MD5 已实测确认）
+ * 支持秒传/续传：同 taskid 已传分片服务端保留，不必重传
+ *
+ * 数据来源：network-logs.json (8/20) + network-logs1.json (8/19)
+ */
+import type { Http } from "../../utils/http";
+/**
+ * 上传超时调优参数
+ *
+ * 上传对网络远比普通接口敏感：8MB 分片在慢网下几十秒才走完一片，
+ * 撞上过短的超时只会触发无意义的重试并把整体时间拖长，
+ * 所以三个阶段统一给 3 分钟的宽松上限。每片独立计时，总时长不设上限。
+ */
+export interface UploadTuning {
+    /** 元数据请求（applyupload）超时 */
+    metaTimeout?: number;
+    /** 单分片上传超时 */
+    partTimeout?: number;
+    /** 单分片重试次数（PartNumber + Content-MD5 幂等，重试安全） */
+    partRetries?: number;
+    /** completepart 超时：服务端要落盘拼装整个文件，大视频天然慢 */
+    completeTimeout?: number;
+}
+export interface UploadOptions {
+    filePath: string;
+    /** filetype: 20302=视频, 20304=封面 */
+    fileType: number;
+    uin: number;
+    authKey: string;
+    http: Http;
+    logger?: {
+        info: (msg: string) => void;
+        error: (msg: string, ...args: any[]) => void;
+    };
+    /** 超时调优，不传则用 DEFAULT_TUNING */
+    tuning?: UploadTuning;
+}
+export interface UploadResult {
+    /** completepart 返回的 DownloadURL */
+    downloadUrl: string;
+    /** 文件 MD5 */
+    md5: string;
+    fileSize: number;
+}
+/**
+ * 上传单个文件到视频号 CDN
+ *
+ * @param opts.filePath 本地文件路径
+ * @param opts.fileType 20302=视频 / 20304=封面
+ * @param opts.uin weixinnum
+ * @param opts.authKey Authorization 头
+ */
+export declare function uploadFile(opts: UploadOptions): Promise<UploadResult>;

package/dist/actions/shipinhaoPublishVideo/videoMeta.d.ts

@@ -0,0 +1,65 @@
+/**
+ * 从 MP4 文件解析视频元数据（宽高、时长、编码）
+ *
+ * 算法来源：scripts/api-explorer/shipinhao-video-upload/mp4-parse-poc.mjs
+ * 已通过合成样本 8/8 + 真实 Chrome 编码视频交叉验证（见该 PoC）。
+ *
+ * 只读 ISO BMFF 的 box 头做定位，元数据 box（moov / moof）才单独读进内存，
+ * 媒体数据（mdat）直接跳过 —— 实测 78MB 视频只读 14.64KB（占全文 0.018%）。
+ * 因此内存占用与文件大小无关，也不受 fs.readFileSync 的 2GiB 上限约束
+ * （早先的实现整文件载入，2GB 以上必然抛 RangeError 并被误报成「格式不支持」）。
+ * 支持 MP4（ISO base media file format），不支持 AVI/MKV/FLV。
+ *
+ * 时长按四级回退取值：mvhd → 视频轨 mdhd → stts 累加 → moof/trun 累加。
+ * 分片 MP4（fMP4，moov 里带 mvex/trex）的 mvhd/mdhd/stts 全为 0，
+ * 真实时长只存在于各 moof 分片中，必须走最后一级才能拿到。
+ */
+export interface VideoMeta {
+    width: number;
+    height: number;
+    /** 时长（秒，浮点数） */
+    duration: number;
+    /**
+     * 旋转角度（0/90/180/270），手机竖屏视频常为 90
+     *
+     * 仅用于把 tkhd 里的横屏尺寸换算成显示尺寸，不写进发布体。
+     * 由 buildVideoMetaFromParams 组装时恒为 0：浏览器给出的 videoWidth/videoHeight
+     * 已经是应用过旋转的显示尺寸，再换算一次会把宽高交换错。
+     */
+    rotation: number;
+    fileSize: number;
+    /**
+     * 视频轨编码格式（stsd 里的 sample entry fourcc，小写）
+     * H.264 为 avc1/avc3，H.265 为 hvc1/hev1，解析不到时为 null
+     */
+    codec: string | null;
+}
+export declare function parseVideoMeta(filePath: string): VideoMeta | null;
+/** 调用方传入的视频元数据（浏览器 <video> + File 侧采集） */
+export interface VideoMetadataInput {
+    duration: number;
+    width: number;
+    height: number;
+    fileSize: number;
+}
+/**
+ * 只读视频轨编码格式，不解析其余字段
+ *
+ * 供「宽高时长由调用方给出，仅编码需要本地确认」的场景使用。
+ * 浏览器没有暴露编码格式的 API（canPlayType/MediaCapabilities 只能回答
+ * 「给定 MIME 能否播放」，无法反查文件实际编码），所以这一项只能读文件。
+ * 走的是同一套分段读，成本是几 KB。
+ *
+ * @returns fourcc（小写，如 avc1/hvc1），读不到时 null
+ */
+export declare function parseVideoCodec(filePath: string): string | null;
+/**
+ * 用调用方传入的元数据组装 VideoMeta，编码格式仍从文件读取
+ *
+ * 宽高时长直接采用传入值：浏览器的 videoWidth/videoHeight 是**已应用旋转**的显示尺寸，
+ * 正是发布体需要的值，所以 rotation 固定为 0，不再做二次换算（换算会把竖屏宽高交换错）。
+ *
+ * codec 读取失败不影响发布 —— validateShipinhaoVideo 对 codec=null 会跳过编码校验，
+ * 退化为由服务端判断，与文件解析不出编码时的既有行为一致。
+ */
+export declare function buildVideoMetaFromParams(filePath: string, metadata: VideoMetadataInput): VideoMeta;

package/dist/actions/shipinhaoPublishVideo/videoValidator.d.ts

@@ -0,0 +1,37 @@
+import type { VideoMeta } from "./videoMeta";
+/**
+ * 视频号视频发布前的本地校验
+ *
+ * 平台限制：时长 8 小时内、大小不超过 20GB、格式为 MP4/H.264。
+ * 在上传前拦截，避免把超限文件传完才被服务端拒绝。
+ */
+/** 时长上限：8 小时 */
+export declare const MAX_DURATION_SECONDS: number;
+/** 大小上限：20GB */
+export declare const MAX_FILE_SIZE: number;
+/** 容器格式白名单 */
+export declare const ALLOWED_EXTENSIONS: readonly [".mp4"];
+/** 视频轨编码白名单（ISO BMFF sample entry fourcc）：H.264 */
+export declare const ALLOWED_CODECS: readonly ["avc1", "avc3"];
+/** 标题最少字符数（填了才校验） */
+export declare const MIN_TITLE_LENGTH = 6;
+/** 标题最多字符数 */
+export declare const MAX_TITLE_LENGTH = 16;
+/**
+ * 校验视频是否满足视频号限制
+ *
+ * @param filePath 视频文件路径（用于取扩展名和文件名做提示）
+ * @param meta parseVideoMeta 的解析结果
+ * @returns 不满足时返回中文错误提示，满足时返回 null
+ */
+export declare function validateShipinhaoVideo(filePath: string, meta: VideoMeta): string | null;
+/**
+ * 校验标题是否满足视频号限制
+ *
+ * 标题为可选参数：未传或为空白时不校验；填了就必须在 6-16 个字符之间。
+ * 按 Unicode 码点计数，避免 emoji 等字符被算成多个。
+ *
+ * @param title 标题，可为空
+ * @returns 不满足时返回中文错误提示，满足时返回 null
+ */
+export declare function validateShipinhaoTitle(title?: string): string | null;