@iflyrpa/actions 4.1.0-beta.5 → 4.1.0

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/shipinhaoPublishVideo/index.d.ts

@@ -1,5 +1,13 @@
 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>;
@@ -35,14 +43,50 @@ export declare const ShipinhaoPublishVideoParamsSchema: z.ZodObject<{
     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>;
-    scheduleTime: z.ZodOptional<z.ZodNumber>;
+    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>;

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/uploader.d.ts

@@ -8,6 +8,23 @@
  * 数据来源：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=封面 */
@@ -19,6 +36,8 @@ export interface UploadOptions {
         info: (msg: string) => void;
         error: (msg: string, ...args: any[]) => void;
     };
+    /** 超时调优，不传则用 DEFAULT_TUNING */
+    tuning?: UploadTuning;
 }
 export interface UploadResult {
     /** completepart 返回的 DownloadURL */

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

@@ -1,21 +1,31 @@
 /**
- * 从 MP4 文件解析视频元数据（宽高、时长）
+ * 从 MP4 文件解析视频元数据（宽高、时长、编码）
  *
  * 算法来源：scripts/api-explorer/shipinhao-video-upload/mp4-parse-poc.mjs
  * 已通过合成样本 8/8 + 真实 Chrome 编码视频交叉验证（见该 PoC）。
  *
- * 只读 ISO BMFF box 头部做跳转，不解码帧数据，内存占用与文件大小无关。
+ * 只读 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。
  *
- * @param filePath 本地视频文件路径
- * @returns {width, height, duration, rotation, fileSize} 或 null（解析失败）
+ * 时长按四级回退取值：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 */
+    /**
+     * 旋转角度（0/90/180/270），手机竖屏视频常为 90
+     *
+     * 仅用于把 tkhd 里的横屏尺寸换算成显示尺寸，不写进发布体。
+     * 由 buildVideoMetaFromParams 组装时恒为 0：浏览器给出的 videoWidth/videoHeight
+     * 已经是应用过旋转的显示尺寸，再换算一次会把宽高交换错。
+     */
     rotation: number;
     fileSize: number;
     /**
@@ -25,3 +35,31 @@ export interface VideoMeta {
     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

@@ -13,8 +13,10 @@ 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;
 /**
  * 校验视频是否满足视频号限制
  *
@@ -26,7 +28,7 @@ export declare function validateShipinhaoVideo(filePath: string, meta: VideoMeta
 /**
  * 校验标题是否满足视频号限制
  *
- * 标题为可选参数：未传时不校验；传了就必须满足最少字符数。
+ * 标题为可选参数：未传或为空白时不校验；填了就必须在 6-16 个字符之间。
  * 按 Unicode 码点计数，避免 emoji 等字符被算成多个。
  *
  * @param title 标题，可为空