specific-ai-cli 0.0.0-stage → 0.1.1

package/dist/platforms/weibo/web/normalize.js

@@ -0,0 +1,137 @@
+import * as n from '../../../core/normalize.js';
+import { midToBid } from './sign.js';
+/**
+ * 微博原始对象 → 归一化类型（AGENTS 6.2）。
+ * weibo.com（ajax）与 m.weibo.cn 的微博对象字段大体相同，差别在图片（pic_infos / pics）、视频（page_info）和正文（text_raw / HTML）。
+ */
+export const userUrl = (uid) => `https://weibo.com/u/${uid}`;
+/** 微博的规范链接：weibo.com/<uid>/<mblogid>；不知道作者时用 m.weibo.cn/detail/<mid>。 */
+export function itemUrl(mid, uid, bid) {
+    if (uid == null || uid === '')
+        return `https://m.weibo.cn/detail/${mid}`;
+    return `https://weibo.com/${uid}/${bid || midToBid(mid)}`;
+}
+export function ref(u) {
+    const id = u?.idstr ?? u?.id;
+    return n.userRef({ id, name: u?.screen_name, url: id == null || id === '' ? null : userUrl(id) });
+}
+/** "21万次播放" / "1,234" → 整数。 */
+function plays(v) {
+    if (typeof v === 'number')
+        return n.count(v);
+    const m = /^\s*([\d.,]+\s*[万亿wW]?)/.exec(String(v ?? ''));
+    return m ? n.count(m[1].replace(/\s/g, '')) : null;
+}
+function isVideo(m) {
+    return m?.page_info?.type === 'video' || m?.page_info?.object_type === 'video';
+}
+/** 图片：weibo.com 是 pic_infos（按 pic_ids 的顺序），m.weibo.cn 是 pics。 */
+function images(m) {
+    if (m?.pic_infos && typeof m.pic_infos === 'object') {
+        const ids = Array.isArray(m.pic_ids) && m.pic_ids.length ? m.pic_ids : Object.keys(m.pic_infos);
+        return ids
+            .map((pid) => m.pic_infos[pid])
+            .filter(Boolean)
+            .map((p) => {
+            const best = p.largest ?? p.mw2000 ?? p.original ?? p.large ?? p.bmiddle;
+            return n.media({ id: n.idOrNull(p.pic_id), type: 'image', url: n.url(best?.url), width: n.count(best?.width), height: n.count(best?.height) }, p);
+        })
+            .filter((x) => x.url);
+    }
+    if (Array.isArray(m?.pics)) {
+        return m.pics
+            .map((p) => {
+            const large = p.large ?? p;
+            return n.media({ id: n.idOrNull(p.pid), type: 'image', url: n.url(large.url), width: n.count(large.geo?.width), height: n.count(large.geo?.height) }, p);
+        })
+            .filter((x) => x.url);
+    }
+    return [];
+}
+/** 视频：weibo.com 的 media_info.playback_list 按清晰度从高到低；m.weibo.cn 是 urls。 */
+function video(m) {
+    const p = m.page_info ?? {};
+    const info = p.media_info ?? {};
+    const best = info.playback_list?.[0]?.play_info;
+    const url = best?.url ??
+        p.urls?.mp4_720p_mp4 ??
+        p.urls?.mp4_hd_mp4 ??
+        p.urls?.mp4_ld_mp4 ??
+        info.mp4_720p_mp4 ??
+        info.mp4_hd_url ??
+        info.stream_url_hd ??
+        info.stream_url;
+    if (!url)
+        return null;
+    return n.media({
+        id: n.idOrNull(info.media_id ?? p.object_id),
+        type: 'video',
+        url: n.url(url),
+        width: n.count(best?.width),
+        height: n.count(best?.height),
+        duration: n.seconds(best?.duration ?? info.duration),
+    }, info);
+}
+const VISIBLE = { 0: 'published', 1: 'private', 6: 'published', 10: 'published' };
+/**
+ * 一条微博。own 为 true 时（自己的微博）按 visible.type 给出 status：仅自己可见为 private，其余为 published。
+ */
+export function mblog(m, own = false) {
+    const id = n.id(m.idstr ?? m.mid ?? m.id);
+    const author = ref(m.user);
+    const vid = isVideo(m) ? video(m) : null;
+    const pics = images(m);
+    const media = vid ? [vid] : pics;
+    const kind = vid ? 'video' : m.page_info?.object_type === 'article' || m.page_info?.type === 'article' ? 'article' : pics.length || Number(m.pic_num) > 0 ? 'image' : 'text';
+    const cover = vid ? n.url(m.page_info?.page_pic?.url ?? m.page_info?.page_pic) : (pics[0]?.url ?? null);
+    return n.item({
+        id,
+        kind,
+        url: itemUrl(id, author?.id, m.mblogid ?? m.bid),
+        title: kind === 'article' ? n.str(m.page_info?.page_title ?? m.page_info?.content1) : null,
+        text: n.str(m.text_raw) ?? n.plainText(m.text),
+        author,
+        created_at: n.time(m.created_at),
+        cover,
+        media,
+        stats: {
+            views: vid ? plays(m.page_info?.play_count ?? m.page_info?.media_info?.online_users_number) : null,
+            likes: n.count(m.attitudes_count),
+            comments: n.count(m.comments_count),
+            shares: n.count(m.reposts_count),
+        },
+        status: own ? (VISIBLE[Number(m.visible?.type ?? 0)] ?? 'published') : null,
+    }, m);
+}
+/** weibo.com/ajax/profile/info 的 data.user。 */
+export function user(u) {
+    const id = n.id(u.idstr ?? u.id);
+    return n.user({
+        id,
+        name: n.str(u.screen_name),
+        handle: n.str(u.domain) ?? n.str(u.weihao),
+        avatar: n.url(u.avatar_hd ?? u.avatar_large ?? u.profile_image_url),
+        url: userUrl(id),
+        bio: n.str(u.description),
+        stats: {
+            followers: n.count(u.followers_count),
+            following: n.count(u.friends_count ?? u.follow_count),
+            items: n.count(u.statuses_count),
+            likes: n.count(u.status_total_counter?.like_cnt),
+        },
+    }, u);
+}
+/** buildComments 的一条评论。 */
+export function comment(c, itemId) {
+    const id = n.id(c.idstr ?? c.id);
+    const root = n.idOrNull(c.rootidstr ?? c.rootid);
+    return n.comment({
+        id,
+        item_id: itemId,
+        parent_id: root && root !== id ? root : null,
+        author: ref(c.user),
+        text: n.str(c.text_raw) ?? n.plainText(c.text) ?? '',
+        created_at: n.time(c.created_at),
+        stats: { likes: n.count(c.like_counts), replies: n.count(c.total_number) },
+    }, c);
+}

package/dist/platforms/weibo/web/profile.js

@@ -0,0 +1,246 @@
+/**
+ * 请求头：逐字照抄上游 utils/weibo_utils.py、weibo_mobile_utils.py、weibo_creator_utils.py，
+ * 键名大小写和顺序都不改（对拍测试逐字节比较）。
+ *
+ * 与上游的差异：上游写死的 `content-length` 不发（上游的 requests 发送前会用真实长度覆盖它，
+ * 而 get_post_video_headers 里写的是视频大小、与表单体不符），由 HTTP 库按实际请求体计算。
+ */
+export const WEB = 'https://weibo.com';
+export const MOBILE = 'https://m.weibo.cn';
+export const COOKIE_DOMAIN = '.weibo.com';
+/** 上游 HTML 请求头里的 UA（Chrome 132），访客接口也用它。 */
+export const UA_132 = 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/132.0.0.0 Safari/537.36';
+const SEC_CH_UA_132 = '"Not A(Brand";v="8", "Chromium";v="132", "Google Chrome";v="132"';
+const UA_130 = 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/130.0.0.0 Safari/537.36 Edg/130.0.0.0';
+const SEC_CH_UA_130 = '"Chromium";v="130", "Microsoft Edge";v="130", "Not?A_Brand";v="99"';
+const DOC_ACCEPT = 'text/html,application/xhtml+xml,application/xml;q=0.9,image/avif,image/webp,image/apng,*/*;q=0.8,application/signed-exchange;v=b3;q=0.7';
+const XHR_ACCEPT = 'application/json, text/plain, */*';
+// ================================================================ utils/weibo_utils.py
+/** get_common_headers：weibo.com 的 ajax 接口。xsrf 取 cookie 里的 XSRF-TOKEN，游客为空串。 */
+export function commonHeaders(xsrf) {
+    return [
+        ['accept', XHR_ACCEPT],
+        ['accept-language', 'zh-CN,zh;q=0.9,en;q=0.8,en-GB;q=0.7,en-US;q=0.6'],
+        ['cache-control', 'no-cache'],
+        ['client-version', 'v2.46.7'],
+        ['pragma', 'no-cache'],
+        ['priority', 'u=1, i'],
+        ['referer', 'https://weibo.com/u/5266778656'],
+        ['sec-ch-ua', '"Chromium";v="128", "Not;A=Brand";v="24", "Microsoft Edge";v="128"'],
+        ['sec-ch-ua-mobile', '?0'],
+        ['sec-ch-ua-platform', '"Windows"'],
+        ['sec-fetch-dest', 'empty'],
+        ['sec-fetch-mode', 'cors'],
+        ['sec-fetch-site', 'same-origin'],
+        ['server-version', 'v2024.08.30.1'],
+        ['user-agent', 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/128.0.0.0 Safari/537.36 Edg/128.0.0.0'],
+        ['x-requested-with', 'XMLHttpRequest'],
+        ['x-xsrf-token', xsrf],
+    ];
+}
+/** get_html_headers：weibo.com 首页（取 $CONFIG）。 */
+export function htmlHeaders() {
+    return [
+        ['accept', DOC_ACCEPT],
+        ['accept-language', 'zh-CN,zh;q=0.9'],
+        ['cache-control', 'no-cache'],
+        ['pragma', 'no-cache'],
+        ['priority', 'u=0, i'],
+        ['referer', 'https://weibo.com/tv/home'],
+        ['sec-ch-ua', SEC_CH_UA_132],
+        ['sec-ch-ua-mobile', '?0'],
+        ['sec-ch-ua-platform', '"Windows"'],
+        ['sec-fetch-dest', 'document'],
+        ['sec-fetch-mode', 'navigate'],
+        ['sec-fetch-site', 'same-origin'],
+        ['sec-fetch-user', '?1'],
+        ['upgrade-insecure-requests', '1'],
+        ['user-agent', UA_132],
+    ];
+}
+// ================================================================ utils/weibo_mobile_utils.py
+/** get_search_headers：m.weibo.cn 的搜索接口。 */
+export function searchHeaders() {
+    return [
+        ['sec-ch-ua-platform', '"Windows"'],
+        ['X-XSRF-TOKEN', 'a1d843'],
+        ['Referer', 'https://m.weibo.cn/'],
+        ['sec-ch-ua', SEC_CH_UA_130],
+        ['sec-ch-ua-mobile', '?0'],
+        ['MWeibo-Pwa', '1'],
+        ['X-Requested-With', 'XMLHttpRequest'],
+        ['User-Agent', UA_130],
+        ['Accept', XHR_ACCEPT],
+    ];
+}
+/** get_detail_headers：m.weibo.cn 的详情页。 */
+export function detailHeaders() {
+    return [
+        ['accept', DOC_ACCEPT],
+        ['accept-language', 'zh-CN,zh;q=0.9,en;q=0.8,en-GB;q=0.7,en-US;q=0.6'],
+        ['cache-control', 'no-cache'],
+        ['pragma', 'no-cache'],
+        ['priority', 'u=0, i'],
+        ['sec-ch-ua', SEC_CH_UA_130],
+        ['sec-ch-ua-mobile', '?0'],
+        ['sec-ch-ua-platform', '"Windows"'],
+        ['sec-fetch-dest', 'document'],
+        ['sec-fetch-mode', 'navigate'],
+        ['sec-fetch-site', 'none'],
+        ['sec-fetch-user', '?1'],
+        ['upgrade-insecure-requests', '1'],
+        ['user-agent', UA_130],
+    ];
+}
+// ================================================================ utils/weibo_creator_utils.py
+/** generate_upload_image_media_headers：picupload 上传图片。 */
+export function uploadImageHeaders() {
+    return [
+        ['accept', XHR_ACCEPT],
+        ['accept-language', 'zh-CN,zh;q=0.9'],
+        ['cache-control', 'no-cache'],
+        ['content-type', 'application/octet-stream'],
+        ['origin', 'https://weibo.com'],
+        ['pragma', 'no-cache'],
+        ['priority', 'u=1, i'],
+        ['referer', 'https://weibo.com/'],
+        ['sec-ch-ua', SEC_CH_UA_132],
+        ['sec-ch-ua-mobile', '?0'],
+        ['sec-ch-ua-platform', '"Windows"'],
+        ['sec-fetch-dest', 'empty'],
+        ['sec-fetch-mode', 'cors'],
+        ['sec-fetch-site', 'same-site'],
+        ['user-agent', UA_132],
+    ];
+}
+/** generate_video_check_headers：fileplatform check.json。 */
+export function videoCheckHeaders(auth) {
+    return [
+        ['Accept', XHR_ACCEPT],
+        ['Accept-Language', 'zh-CN,zh;q=0.9'],
+        ['Cache-Control', 'no-cache'],
+        ['Connection', 'keep-alive'],
+        ['Content-Type', 'application/x-www-form-urlencoded'],
+        ['Origin', 'https://weibo.com'],
+        ['Pragma', 'no-cache'],
+        ['Referer', 'https://weibo.com/'],
+        ['Sec-Fetch-Dest', 'empty'],
+        ['Sec-Fetch-Mode', 'cors'],
+        ['Sec-Fetch-Site', 'same-site'],
+        ['User-Agent', UA_132],
+        ['X-Up-Auth', auth],
+        ['sec-ch-ua', SEC_CH_UA_132],
+        ['sec-ch-ua-mobile', '?0'],
+        ['sec-ch-ua-platform', '"Windows"'],
+    ];
+}
+/** generate_video_output_headers：multimedia/output 轮询转码结果。 */
+export function videoOutputHeaders() {
+    return [
+        ['accept', XHR_ACCEPT],
+        ['accept-language', 'zh-CN,zh;q=0.9'],
+        ['cache-control', 'no-cache'],
+        ['pragma', 'no-cache'],
+        ['priority', 'u=1, i'],
+        ['referer', 'https://weibo.com/upload/channel'],
+        ['sec-ch-ua', SEC_CH_UA_132],
+        ['sec-ch-ua-mobile', '?0'],
+        ['sec-ch-ua-platform', '"Windows"'],
+        ['sec-fetch-dest', 'empty'],
+        ['sec-fetch-mode', 'cors'],
+        ['sec-fetch-site', 'same-origin'],
+        ['user-agent', UA_132],
+    ];
+}
+/** generate_upload_video_media_headers：up.video.weibocdn.com 上传视频（content-length 见文件头注释）。 */
+export function uploadVideoHeaders(auth) {
+    return [
+        ['accept', XHR_ACCEPT],
+        ['accept-encoding', 'gzip, deflate, br, zstd'],
+        ['accept-language', 'zh-CN,zh;q=0.9'],
+        ['cache-control', 'no-cache'],
+        ['content-type', 'application/octet-stream'],
+        ['host', 'up.video.weibocdn.com'],
+        ['origin', 'https://weibo.com'],
+        ['pragma', 'no-cache'],
+        ['priority', 'u=1, i'],
+        ['referer', 'https://weibo.com/'],
+        ['sec-ch-ua', SEC_CH_UA_132],
+        ['sec-ch-ua-mobile', '?0'],
+        ['sec-ch-ua-platform', '"Windows"'],
+        ['sec-fetch-dest', 'empty'],
+        ['sec-fetch-mode', 'cors'],
+        ['sec-fetch-site', 'same-site'],
+        ['user-agent', UA_132],
+        ['x-up-auth', auth],
+    ];
+}
+function postHeaders() {
+    return [
+        ['accept', XHR_ACCEPT],
+        ['accept-language', 'zh-CN,zh;q=0.9'],
+        ['cache-control', 'no-cache'],
+        ['client-version', 'v2.47.25'],
+        ['content-type', 'application/x-www-form-urlencoded'],
+        ['origin', 'https://weibo.com'],
+        ['pragma', 'no-cache'],
+        ['priority', 'u=1, i'],
+        ['referer', 'https://weibo.com/'],
+        ['sec-ch-ua', SEC_CH_UA_132],
+        ['sec-ch-ua-mobile', '?0'],
+        ['sec-ch-ua-platform', '"Windows"'],
+        ['sec-fetch-dest', 'empty'],
+        ['sec-fetch-mode', 'cors'],
+        ['sec-fetch-site', 'same-origin'],
+        ['server-version', 'v2025.01.23.1'],
+        ['user-agent', UA_132],
+        ['x-requested-with', 'XMLHttpRequest'],
+    ];
+}
+/** get_post_image_headers：发图文（statuses/update）。 */
+export function postImageHeaders(xsrf) {
+    return [...postHeaders(), ['x-xsrf-token', xsrf]];
+}
+/** get_post_video_headers：发视频（statuses/update）。上游这里不带 x-xsrf-token，照抄。 */
+export function postVideoHeaders() {
+    return postHeaders();
+}
+/** get_form_headers：fileplatform init.json，multipart/mixed 的 boundary 带秒级时间戳。 */
+export function formHeaders(t) {
+    return [
+        ['Accept', XHR_ACCEPT],
+        ['Accept-Language', 'zh-CN,zh;q=0.9'],
+        ['Cache-Control', 'no-cache'],
+        ['Connection', 'keep-alive'],
+        ['Content-Type', `multipart/mixed; boundary=2067456weiboPro${t}`],
+        ['Origin', 'https://weibo.com'],
+        ['Pragma', 'no-cache'],
+        ['Referer', 'https://weibo.com/'],
+        ['Sec-Fetch-Dest', 'empty'],
+        ['Sec-Fetch-Mode', 'cors'],
+        ['Sec-Fetch-Site', 'same-site'],
+        ['User-Agent', UA_132],
+        ['sec-ch-ua', SEC_CH_UA_132],
+        ['sec-ch-ua-mobile', '?0'],
+        ['sec-ch-ua-platform', '"Windows"'],
+    ];
+}
+// ================================================================ 访客（上游没有，见 client.ts）
+/** 新浪访客系统 genvisitor2 的 XHR 头：与访客页里 ufp.util.postData 发出的一致。 */
+export function visitorHeaders(origin, referer) {
+    return [
+        ['sec-ch-ua-platform', '"Windows"'],
+        ['user-agent', UA_132],
+        ['sec-ch-ua', SEC_CH_UA_132],
+        ['content-type', 'application/x-www-form-urlencoded'],
+        ['sec-ch-ua-mobile', '?0'],
+        ['accept', '*/*'],
+        ['origin', origin],
+        ['sec-fetch-site', 'same-origin'],
+        ['sec-fetch-mode', 'cors'],
+        ['sec-fetch-dest', 'empty'],
+        ['referer', referer],
+        ['accept-language', 'zh-CN,zh;q=0.9'],
+        ['priority', 'u=1, i'],
+    ];
+}

package/dist/platforms/weibo/web/resolve.js

@@ -0,0 +1,60 @@
+import { SpecificAIError } from '../../../core/errors.js';
+import * as api from './api.js';
+import { bidToMid } from './sign.js';
+const toMid = (token) => (/^\d+$/.test(token) ? token : bidToMid(token));
+/**
+ * 微博：mid（16 位数字）、mblogid（如 OuIv3hbiw），或链接
+ * weibo.com/<uid>/<mblogid|mid>、weibo.com/detail/<mid>、m.weibo.cn/detail|status/<mid|mblogid>、m.weibo.cn/<uid>/<mid>。
+ */
+export function resolveItem(input) {
+    const s = input.trim();
+    if (/^\d+$/.test(s) || /^[0-9A-Za-z]{8,10}$/.test(s))
+        return { mid: toMid(s), uid: null };
+    let url = null;
+    try {
+        url = new URL(/^https?:\/\//i.test(s) ? s : `https://${s}`);
+    }
+    catch { }
+    if (url && /(^|\.)weibo\.(com|cn)$/.test(url.hostname)) {
+        const parts = url.pathname.split('/').filter(Boolean);
+        if (parts.length >= 2 && /^(detail|status)$/.test(parts[0]) && /^[0-9A-Za-z]+$/.test(parts[1]))
+            return { mid: toMid(parts[1]), uid: null };
+        if (parts.length >= 2 && /^\d+$/.test(parts[0]) && /^[0-9A-Za-z]+$/.test(parts[1]))
+            return { mid: toMid(parts[1]), uid: parts[0] };
+        const q = url.searchParams.get('id') ?? url.searchParams.get('mid');
+        if (q && /^[0-9A-Za-z]+$/.test(q))
+            return { mid: toMid(q), uid: null };
+    }
+    throw new SpecificAIError('USAGE', `无法识别的微博：${input}`, { hint: '传 mid、mblogid 或微博链接，例如 https://weibo.com/<uid>/<mblogid>' });
+}
+/** 用户：uid、主页链接（weibo.com/u/<uid>、weibo.com/<uid>、m.weibo.cn/u|profile/<uid>）或 `me`。 */
+export async function resolveUser(w, input) {
+    const s = input.trim();
+    if (s === 'me') {
+        const saved = w.ctx.credential.user?.id;
+        if (saved)
+            return saved;
+        const self = await api.selfInfo(w);
+        if (!self)
+            throw new SpecificAIError('AUTH_REQUIRED', 'me 表示当前账号，需要先登录', { hint: 'specific-ai weibo auth login' });
+        return self.uid;
+    }
+    if (/^\d+$/.test(s))
+        return s;
+    let url = null;
+    try {
+        url = new URL(/^https?:\/\//i.test(s) ? s : `https://${s}`);
+    }
+    catch { }
+    if (url && /(^|\.)weibo\.(com|cn)$/.test(url.hostname)) {
+        const parts = url.pathname.split('/').filter(Boolean);
+        if (parts.length >= 2 && /^(u|profile)$/.test(parts[0]) && /^\d+$/.test(parts[1]))
+            return parts[1];
+        if (parts.length >= 1 && /^\d+$/.test(parts[0]))
+            return parts[0];
+        const uid = url.searchParams.get('uid');
+        if (uid && /^\d+$/.test(uid))
+            return uid;
+    }
+    throw new SpecificAIError('USAGE', `无法识别的用户：${input}`, { hint: '传用户 uid（数字）或主页链接 https://weibo.com/u/<uid>' });
+}

package/dist/platforms/weibo/web/sign.js

@@ -0,0 +1,85 @@
+import { crc32 } from 'node:zlib';
+import { md5Hex } from '../../../core/hash.js';
+import { urlencode } from '../../../core/py.js';
+import * as rand from '../../../core/rand.js';
+/** 上传参数（上游 utils/weibo_creator_utils.py）。 */
+export const APP_SOURCE = '339644097';
+export { md5Hex };
+/** generate_params：CRC32（上游手写的查表实现，与标准 CRC32 相同）、MD5、大小。 */
+export function fileParams(file) {
+    return { cs: crc32(file), md5: md5Hex(file), fileSize: file.length };
+}
+/** generate_session_id：md5(`毫秒|大小|文件名|video|秒`)。 */
+export function sessionId(fileSize, fileName) {
+    return md5Hex(`${rand.now()}|${fileSize}|${fileName}|video|${rand.nowSeconds()}`);
+}
+/** generate_upload_image_media_params，已 urlencode。 */
+export function uploadImageParams(uid, nick, file) {
+    const p = fileParams(file);
+    const params = [
+        ['file_source', '1'],
+        ['cs', String(p.cs)],
+        ['ent', 'miniblog'],
+        ['appid', APP_SOURCE],
+        ['uid', uid],
+        ['raw_md5', p.md5],
+        ['ori', '1'],
+        ['mpos', '1'],
+        ['nick', nick],
+        ['pri', '0'],
+        ['request_id', String(rand.now())],
+        ['file_size', String(p.fileSize)],
+    ];
+    return urlencode(params);
+}
+/** generate_upload_video_media_params，已 urlencode。整个文件作为一个分片上传。 */
+export function uploadVideoParams(uploadId, mediaId, file) {
+    const p = fileParams(file);
+    const params = [
+        ['source', APP_SOURCE],
+        ['upload_id', uploadId],
+        ['media_id', mediaId],
+        ['upload_protocol', 'binary'],
+        ['type', 'video'],
+        ['client', 'web'],
+        ['check', p.md5],
+        ['index', '0'],
+        ['size', String(p.fileSize)],
+        ['start_loc', '0'],
+        ['count', '1'],
+    ];
+    return urlencode(params);
+}
+// ================================================================ mid ↔ mblogid
+/** 微博的 62 进制：mid 从右往左每 7 位十进制一组，每组转成 4 位 62 进制（最高组不补零）。 */
+const ALPHABET = '0123456789abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ';
+function groups(s, size) {
+    const out = [];
+    for (let end = s.length; end > 0; end -= size)
+        out.unshift(s.slice(Math.max(0, end - size), end));
+    return out;
+}
+/** 数字 mid → mblogid（URL 里的 9 位短码，如 OuIv3hbiw）。 */
+export function midToBid(mid) {
+    return groups(mid, 7)
+        .map((g, i) => {
+        let n = Number(g);
+        let s = '';
+        do {
+            s = ALPHABET[n % 62] + s;
+            n = Math.floor(n / 62);
+        } while (n > 0);
+        return i === 0 ? s : s.padStart(4, '0');
+    })
+        .join('');
+}
+/** mblogid → 数字 mid。 */
+export function bidToMid(bid) {
+    return groups(bid, 4)
+        .map((g, i) => {
+        const n = [...g].reduce((acc, ch) => acc * 62 + ALPHABET.indexOf(ch), 0);
+        return i === 0 ? String(n) : String(n).padStart(7, '0');
+    })
+        .join('')
+        .replace(/^0+(?=\d)/, '');
+}

package/dist/platforms/x/index.js

@@ -0,0 +1,107 @@
+import { z } from 'zod';
+import { filter, PUBLISH, QUOTE, visibility } from '../../core/options.js';
+import { definePlatform, handlers } from '../../core/registry.js';
+/** 懒加载 web 端的 handler：只有执行到这条命令时才加载实现。 */
+const { h, impl } = handlers(() => import('./web/commands.js'));
+export default definePlatform({
+    id: 'x',
+    name: 'X',
+    aliases: ['twitter'],
+    item: '推文',
+    endpoints: {
+        web: {
+            // 上游的账密登录依赖 Castle token，不移植：只支持从浏览器导入 cookie
+            login: { methods: ['cookie'], default: 'cookie' },
+            commands: {
+                'auth login': impl('full', 'authLogin'),
+                'auth status': impl('full', 'authStatus'),
+                'user get': impl('full', 'userGet'),
+                'user search': impl('full', 'userSearch'),
+                'user items': impl('full', 'userItems'),
+                'user likes': 'none',
+                'user collects': 'none',
+                'user reposts': 'none',
+                'user followers': 'none',
+                'user following': 'none',
+                'user follow': impl('full', 'userFollow'),
+                'user unfollow': impl('full', 'userUnfollow'),
+                'item get': impl('full', 'itemGet'),
+                'item search': impl('full', 'itemSearch', {
+                    note: '--type video / image 走媒体搜索，按类型过滤，不能和 --sort latest 一起用',
+                    options: { sort: filter.sort('general', 'latest'), type: filter.type('all', 'video', 'image') },
+                }),
+                'item media': impl('full', 'itemMedia'),
+                'item download': impl('full', 'itemDownload'),
+                'item like': impl('full', 'itemLike'),
+                'item unlike': impl('full', 'itemUnlike'),
+                'item collect': impl('full', 'itemCollect'),
+                'item uncollect': impl('full', 'itemUncollect'),
+                'item repost': impl('full', 'itemRepost'),
+                'item unrepost': impl('full', 'itemUnrepost'),
+                'item publish': impl('full', 'itemPublish', {
+                    note: '正文超过 280 权重时自动按长推发（需要 Premium）；--thread 发 thread',
+                    supports: ['text', 'image', 'video', 'visibility'],
+                    options: {
+                        visibility: visibility('public'),
+                        quote: QUOTE,
+                        thread: z.array(z.string()).optional().describe('thread 的后续各条，依次回复上一条'),
+                    },
+                }),
+                'item delete': impl('full', 'itemDelete'),
+                'comment list': impl('full', 'commentList'),
+                'comment replies': 'none',
+                'comment add': impl('full', 'commentAdd'),
+                'comment delete': impl('full', 'commentDelete'),
+                'comment like': impl('full', 'commentLike'),
+                'comment unlike': impl('full', 'commentUnlike'),
+                'feed list': impl('partial', 'feedList', {
+                    note: 'following 规划中',
+                    options: { kind: filter.kind('recommend', 'following') },
+                }),
+                'keyword suggest': 'none',
+                'keyword hot': 'none',
+                'notice list': 'none',
+                'notice count': 'none',
+                'msg list': impl('partial', 'msgList', { note: '只取收件箱首页（最近 20 个会话），上游没有翻页' }),
+                'msg history': impl('partial', 'msgHistory', { note: '消息端到端加密，只给出占位消息' }),
+                // 上游的 send_message 只是占位：X Chat 端到端加密，要先在网页设 passcode、再逆向加密后的发送请求
+                'msg send': 'none',
+                'msg listen': 'none',
+                'msg read': 'none',
+                'msg revoke': 'none',
+                'msg delete': 'none',
+                'media upload': impl('full', 'mediaUpload'),
+                'folder list': 'none',
+                'folder items': 'none',
+                'folder create': 'none',
+                'folder update': 'none',
+                'folder delete': 'none',
+                // 平台扩展（AGENTS 4.7）
+                'article publish': {
+                    upstream: 'full',
+                    summary: '发文章（Premium 长文）：建草稿，写标题、正文、封面，再发布',
+                    args: [],
+                    options: {
+                        title: z.string().optional().describe('标题，不给时取正文第一行的 # 标题'),
+                        text: z.string().describe('正文（Markdown），@file 表示从文件读取；独占一行的 ![](图片) 会上传成插图，相对路径按该文件所在目录解析'),
+                        cover: PUBLISH.cover,
+                    },
+                    auth: 'required',
+                    output: '{id url}',
+                    handler: h('articlePublish'),
+                },
+                'article delete': {
+                    upstream: 'full',
+                    summary: '删文章（草稿或已发布的）',
+                    args: [{ name: 'article', summary: '文章：ID 或 URL' }],
+                    auth: 'required',
+                    confirm: true,
+                    output: '{id}',
+                    handler: h('articleDelete'),
+                },
+            },
+        },
+        app: 'planned',
+        pc: 'planned',
+    },
+});