@agentrhq/webcmd 0.1.2 → 0.2.0

package/clis/zsxq/utils.js

@@ -1,233 +0,0 @@
-import { ArgumentError, AuthRequiredError, CliError } from '@agentrhq/webcmd/errors';
-const SITE_DOMAIN = 'wx.zsxq.com';
-const SITE_URL = 'https://wx.zsxq.com';
-function asRecord(value) {
-    return value && typeof value === 'object' && !Array.isArray(value)
-        ? value
-        : null;
-}
-function pickArray(...values) {
-    for (const value of values) {
-        if (Array.isArray(value)) {
-            return value;
-        }
-    }
-    return [];
-}
-export async function ensureZsxqPage(page) {
-    await page.goto(SITE_URL);
-}
-export async function ensureZsxqAuth(page) {
-    // zsxq uses httpOnly cookies that may be on different subdomains.
-    // Verify auth by attempting a lightweight API call instead of checking cookies.
-    try {
-        const result = await page.evaluate(`
-      (async () => {
-        try {
-          const r = await new Promise((resolve, reject) => {
-            const xhr = new XMLHttpRequest();
-            xhr.open('GET', 'https://api.zsxq.com/v2/groups', true);
-            xhr.withCredentials = true;
-            xhr.setRequestHeader('accept', 'application/json');
-            xhr.onload = () => {
-              if (xhr.status >= 200 && xhr.status < 300) {
-                try { resolve(JSON.parse(xhr.responseText)); }
-                catch { resolve(null); }
-              } else { resolve(null); }
-            };
-            xhr.onerror = () => resolve(null);
-            xhr.send();
-          });
-          return r !== null;
-        } catch { return false; }
-      })()
-    `);
-        if (!result) {
-            throw new AuthRequiredError('zsxq.com');
-        }
-    }
-    catch (err) {
-        if (err instanceof AuthRequiredError)
-            throw err;
-        throw new AuthRequiredError('zsxq.com');
-    }
-}
-export async function getCookieValue(page, name) {
-    const cookies = await page.getCookies({ domain: SITE_DOMAIN });
-    return cookies.find(cookie => cookie.name === name)?.value;
-}
-export async function getActiveGroupId(page) {
-    const groupId = await page.evaluate(`
-    (() => {
-      const target = localStorage.getItem('target_group');
-      if (target) {
-        try {
-          const parsed = JSON.parse(target);
-          if (parsed.group_id) return String(parsed.group_id);
-        } catch {}
-      }
-      return null;
-    })()
-  `);
-    if (groupId)
-        return groupId;
-    throw new ArgumentError('Cannot determine active group_id', 'Pass --group_id <id> or open the target 知识星球 page in Chrome first');
-}
-export async function browserJsonRequest(page, path) {
-    return await page.evaluate(`
-    (async () => {
-      const path = ${JSON.stringify(path)};
-
-      try {
-        return await new Promise((resolve) => {
-          const xhr = new XMLHttpRequest();
-          xhr.open('GET', path, true);
-          xhr.withCredentials = true;
-          xhr.setRequestHeader('accept', 'application/json, text/plain, */*');
-          xhr.onload = () => {
-            let parsed = null;
-            if (xhr.responseText) {
-              try { parsed = JSON.parse(xhr.responseText); }
-              catch {}
-            }
-
-            resolve({
-              ok: xhr.status >= 200 && xhr.status < 300,
-              url: path,
-              status: xhr.status,
-              data: parsed,
-              error: xhr.status >= 200 && xhr.status < 300 ? undefined : 'HTTP ' + xhr.status,
-            });
-          };
-          xhr.onerror = () => resolve({
-            ok: false,
-            url: path,
-            error: 'Network error',
-          });
-          xhr.send();
-        });
-      } catch (error) {
-        return {
-          ok: false,
-          url: path,
-          error: error instanceof Error ? error.message : String(error),
-        };
-      }
-    })()
-  `);
-}
-export async function fetchFirstJson(page, paths) {
-    let lastFailure = null;
-    for (const path of paths) {
-        const result = await browserJsonRequest(page, path);
-        if (result.ok) {
-            return result;
-        }
-        lastFailure = result;
-    }
-    if (!lastFailure) {
-        throw new CliError('FETCH_ERROR', 'No candidate endpoint returned JSON', `Checked endpoints: ${paths.join(', ')}`);
-    }
-    throw new CliError('FETCH_ERROR', lastFailure.error || 'Failed to fetch ZSXQ API', `Checked endpoints: ${paths.join(', ')}`);
-}
-export function unwrapRespData(payload) {
-    const record = asRecord(payload);
-    if (!record) {
-        throw new CliError('PARSE_ERROR', 'Invalid ZSXQ API response');
-    }
-    if (record.succeeded === false) {
-        const code = typeof record.code === 'number' ? String(record.code) : 'API_ERROR';
-        const message = typeof record.info === 'string'
-            ? record.info
-            : typeof record.error === 'string'
-                ? record.error
-                : 'ZSXQ API returned an error';
-        throw new CliError(code, message);
-    }
-    return (record.resp_data ?? record.data ?? payload);
-}
-export function getTopicsFromResponse(payload) {
-    const data = unwrapRespData(payload);
-    if (Array.isArray(data))
-        return data;
-    return pickArray(data.topics, data.list, data.records, data.items, data.search_result);
-}
-export function getCommentsFromResponse(payload) {
-    const data = unwrapRespData(payload);
-    if (Array.isArray(data))
-        return data;
-    return pickArray(data.comments, data.list, data.items);
-}
-export function getGroupsFromResponse(payload) {
-    const data = unwrapRespData(payload);
-    if (Array.isArray(data))
-        return data;
-    return pickArray(data.groups, data.list, data.items);
-}
-export function getTopicFromResponse(payload) {
-    const data = unwrapRespData(payload);
-    if (Array.isArray(data))
-        return data[0] ?? null;
-    if (typeof data.topic_id === 'number' || typeof data.topic_id === 'string')
-        return data;
-    const record = asRecord(data);
-    if (!record)
-        return null;
-    const topic = record.topic;
-    return topic && typeof topic === 'object' ? topic : null;
-}
-export function getTopicAuthor(topic) {
-    return (topic.owner?.name ||
-        topic.talk?.owner?.name ||
-        topic.question?.owner?.name ||
-        topic.answer?.owner?.name ||
-        topic.task?.owner?.name ||
-        topic.solution?.owner?.name ||
-        '');
-}
-export function getTopicText(topic) {
-    const title = (topic.title || '').replace(/\s+/g, ' ').trim();
-    return title || getTopicContent(topic);
-}
-export function getTopicContent(topic) {
-    const primary = [
-        topic.talk?.text,
-        topic.question?.text,
-        topic.answer?.text,
-        topic.task?.text,
-        topic.solution?.text,
-    ].find(value => typeof value === 'string' && value.trim());
-    return (primary || '').replace(/\s+/g, ' ').trim();
-}
-export function getTopicUrl(topicId) {
-    return topicId ? `${SITE_URL}/topic/${topicId}` : SITE_URL;
-}
-export function summarizeComments(comments, limit = 3) {
-    return comments
-        .slice(0, limit)
-        .map((comment) => {
-        const author = comment.owner?.name || '匿名';
-        const target = comment.repliee?.name ? ` -> ${comment.repliee.name}` : '';
-        const text = (comment.text || '').replace(/\s+/g, ' ').trim();
-        return `${author}${target}: ${text}`;
-    })
-        .join(' | ');
-}
-export function toTopicRow(topic) {
-    const topicId = topic.topic_id ?? '';
-    const comments = pickArray(topic.show_comments, topic.comments);
-    return {
-        topic_id: topicId,
-        type: topic.type || '',
-        group: topic.group?.name || '',
-        author: getTopicAuthor(topic),
-        title: getTopicText(topic),
-        content: getTopicContent(topic),
-        comments: topic.comments_count ?? comments.length ?? 0,
-        likes: topic.likes_count ?? 0,
-        readers: topic.readers_count ?? topic.reading_count ?? 0,
-        time: topic.create_time || '',
-        comment_preview: summarizeComments(comments),
-        url: getTopicUrl(topicId),
-    };
-}

package/clis/zsxq/utils.test.js

@@ -1,31 +0,0 @@
-import { describe, expect, it } from 'vitest';
-import { getTopicText, toTopicRow } from './utils.js';
-
-describe('zsxq utils', () => {
-    it('keeps title and content separate when both fields exist', () => {
-        const topic = {
-            topic_id: '123',
-            title: 'A full title that should not be truncated',
-            talk: { text: 'This is the full body text.' },
-        };
-
-        expect(getTopicText(topic)).toBe('A full title that should not be truncated');
-        expect(toTopicRow(topic)).toMatchObject({
-            title: 'A full title that should not be truncated',
-            content: 'This is the full body text.',
-        });
-    });
-
-    it('falls back to body text for title when explicit title is absent', () => {
-        const topic = {
-            topic_id: '456',
-            talk: { text: 'Body-only topic text should still appear as the title preview.' },
-        };
-
-        expect(getTopicText(topic)).toBe('Body-only topic text should still appear as the title preview.');
-        expect(toTopicRow(topic)).toMatchObject({
-            title: 'Body-only topic text should still appear as the title preview.',
-            content: 'Body-only topic text should still appear as the title preview.',
-        });
-    });
-});

package/dist/src/weixin-download.test.js

@@ -1,45 +0,0 @@
-import { describe, expect, it } from 'vitest';
-async function loadModule() {
-    // @ts-expect-error JS adapter — no type declarations
-    return import('../clis/weixin/download.js');
-}
-describe('weixin publish time extraction', () => {
-    it('prefers publish_time text over create_time-like date strings', async () => {
-        const mod = await loadModule();
-        expect(mod.extractWechatPublishTime('2026年3月24日 22:38', 'var create_time = "2026年3月24日 22:38";')).toBe('2026年3月24日 22:38');
-    });
-    it('falls back to unix timestamp create_time values', async () => {
-        const mod = await loadModule();
-        expect(mod.extractWechatPublishTime('', 'var create_time = "1711291080";')).toBe('2024-03-24 22:38:00');
-    });
-    it('rejects malformed create_time values', async () => {
-        const mod = await loadModule();
-        expect(mod.extractWechatPublishTime('', 'var create_time = "2026年3月24日 22:38";')).toBe('');
-        expect(mod.extractWechatPublishTime('', 'var create_time = "1711291080abc";')).toBe('');
-        expect(mod.extractWechatPublishTime('', 'var create_time = "17112910800";')).toBe('');
-    });
-    it('builds a self-contained browser helper that matches fallback behavior', async () => {
-        const mod = await loadModule();
-        const extractInPage = eval(mod.buildExtractWechatPublishTimeJs());
-        expect(extractInPage('', 'var create_time = "1711291080";')).toBe('2024-03-24 22:38:00');
-    });
-    it('browser helper still prefers DOM publish_time text', async () => {
-        const mod = await loadModule();
-        const extractInPage = eval(mod.buildExtractWechatPublishTimeJs());
-        expect(extractInPage('2026年3月24日 22:38', 'var create_time = "1711291080";')).toBe('2026年3月24日 22:38');
-    });
-    it('detects WeChat verification gate pages', async () => {
-        const mod = await loadModule();
-        expect(mod.detectWechatAccessIssue('环境异常 当前环境异常，完成验证后即可继续访问。 去验证', '<html><body><a id="js_verify">去验证</a></body></html>')).toBe('environment verification required');
-    });
-    it('browser access detector matches the server-side verifier', async () => {
-        const mod = await loadModule();
-        const detectInPage = eval(mod.buildDetectWechatAccessIssueJs());
-        expect(detectInPage('环境异常 当前环境异常，完成验证后即可继续访问。 去验证', '<html>secitptpage/verify.html<a id="js_verify">去验证</a></html>')).toBe('environment verification required');
-    });
-    it('picks the first non-empty WeChat metadata field', async () => {
-        const mod = await loadModule();
-        expect(mod.pickFirstWechatMetaText('', 'Name cleared', '数字生命卡兹克')).toBe('数字生命卡兹克');
-        expect(mod.pickFirstWechatMetaText('', '  聊聊刚刚上线的PixVerse V6视频模型。  ')).toBe('聊聊刚刚上线的PixVerse V6视频模型。');
-    });
-});

package/skills/webcmd-adapter-author/references/site-memory/bilibili.md

@@ -1,70 +0,0 @@
-# bilibili（B 站）
-
-## 域名
-
-| 用途 | 域名 |
-|------|------|
-| 主 API | `api.bilibili.com` |
-| 个人主页 / 空间 | `space.bilibili.com` |
-| 登录 / 鉴权 | `passport.bilibili.com` |
-| 动态 | `t.bilibili.com` / `api.vc.bilibili.com` |
-| 直播 | `api.live.bilibili.com` |
-
-## 默认鉴权
-
-- `Strategy.COOKIE + browser: true`
-- 核心 cookie：`SESSDATA`（登录态）、`bili_jct`（CSRF token，部分写接口要带到 header `Referer + csrf`）
-- **未登录也能调多数读接口**，但有 wbi 签名要求
-
-## 关键：wbi 签名
-
-- 凡 URL 含 `/wbi/` 的接口都要 `w_rid + wts` 签名
-- 签名算法依赖每日轮换的 `img_key / sub_key`，从 `api.bilibili.com/x/web-interface/nav` 的 `wbi_img` 字段拿
-- **不要自己重新实现**：`clis/bilibili/utils.js` 里的 `apiGet(page, path, { signed: true, params })` 已经封装好
-- 普通 cookie JSON 接口优先用 `page.fetchJson(url)`；站点级签名逻辑仍复用 `utils.js`
-
-## 已知 endpoint
-
-- `GET api.bilibili.com/x/web-interface/nav` — 登录态 + 拿 wbi key
-- `GET api.bilibili.com/x/space/wbi/arc/search?mid=<uid>` — 用户视频（需 wbi 签）
-- `GET api.bilibili.com/x/space/acc/info?mid=<uid>` — 用户资料
-- `GET api.bilibili.com/x/web-interface/view?bvid=BV...` — 视频详情
-- `GET api.bilibili.com/x/web-interface/popular?ps=20&pn=1` — 热门
-- `GET api.bilibili.com/x/web-interface/ranking/v2?rid=0` — 排行
-- `GET api.bilibili.com/x/v2/reply/wbi/main?type=1&oid=<aid>&mode=3` — 评论（需 wbi）
-- `GET api.bilibili.com/x/web-interface/search/all/v2?keyword=<q>` — 综合搜索
-- `GET api.vc.bilibili.com/dynamic_svr/v1/dynamic_svr/space_history?host_uid=<uid>` — 用户动态（新版走 `api.bilibili.com/x/polymer/web-dynamic/v1/feed/space`）
-- `GET api.bilibili.com/x/v2/history/cursor` — 观看历史（需登录）
-- `GET api.bilibili.com/x/v3/fav/folder/created/list-all` — 收藏夹列表（需登录）
-
-## 字段
-
-字段基本人类可读，见 `../field-conventions.md` 的 bilibili 节（`mid / aid / bvid / cid / view / danmaku / reply / favorite / coin / share / like / pubdate / ctime`）。
-
-## 坑 / 陷阱
-
-1. **wbi 签名缓存 `img_key / sub_key`**：24 小时内有效，每次请求都重新 fetch `nav` 会被限频。utils.js 内部做了缓存
-2. **`mid` 和 `uid` 一回事**：接口不统一，`mid=` 居多，个别接口要 `host_mid=`
-3. **视频 ID 两种**：`aid`（老数字）和 `bvid`（BV1xxx），视频详情要用 `bvid`
-4. **`ps=` 最大 50**（popular/ranking），超过了多发几页拼
-5. **动态接口换版**：老的 `dynamic_svr` 已经废，新的走 `x/polymer/web-dynamic/v1/feed/space`，写新 adapter 直接用新接口
-6. **评论分页靠 `next` 游标**，不是页号
-7. **B 站限频 `-352 风控`**：短时间高频调会拦截，adapter 层加 500ms 间隔
-8. **搜索要先 "cold start"**：空 cookie 的 session 第一次搜会 412，先访问首页拿 `buvid3` cookie
-9. **直播接口在 `api.live.bilibili.com`**，不是主域名
-
-## 可参考的 adapter
-
-| 模板类型 | 参考文件 |
-|---------|---------|
-| 用户资料 / 视频列表 | `clis/bilibili/user-videos.js` / `me.js` |
-| 视频详情 / 字幕 | `clis/bilibili/download.js` / `subtitle.js` |
-| 评论 | `clis/bilibili/comments.js` |
-| 搜索 | `clis/bilibili/search.js` |
-| 热门 / 排行 | `clis/bilibili/hot.js` / `ranking.js` |
-| 动态 | `clis/bilibili/dynamic.js` |
-| 关注 | `clis/bilibili/following.js` |
-| 收藏 | `clis/bilibili/favorite.js` |
-| 观看历史 | `clis/bilibili/history.js` |
-
-通用工具：`clis/bilibili/utils.js`。新 adapter 先 `import { apiGet, fetchJson } from './utils.js'`，不要重写。

package/skills/webcmd-adapter-author/references/site-memory/eastmoney.md

@@ -1,70 +0,0 @@
-# eastmoney（东方财富）
-
-## 域名
-
-| 用途 | 域名 |
-|------|------|
-| 行情列表 / 批量报价 | `push2.eastmoney.com` |
-| K 线历史 | `push2his.eastmoney.com` |
-| 报表类（龙虎榜 / 十大股东） | `datacenter-web.eastmoney.com` |
-| 7x24 快讯 | `np-listapi.eastmoney.com` |
-| 公司公告 | `np-anotice-stock.eastmoney.com` |
-| 静态页（网页端入口） | `quote.eastmoney.com` / `data.eastmoney.com` |
-
-## 默认鉴权
-
-- `Strategy.PUBLIC + browser: false`
-- 统一带 `ut=bd1d9ddb04089700cf9c27f6f7426281`（push2 系列的公共 token）
-- User-Agent 随意给个 `Mozilla/5.0` 就行，不加会偶发被拦
-
-## 已知 endpoint
-
-- `GET push2.eastmoney.com/api/qt/clist/get` — 列表 / 排行
-  - 必需：`fs`（市场/板块过滤码）、`fields`（字段清单）
-  - 可选：`pn`（页码，1-based）、`pz`（每页数量）、`fid`（排序字段）、`po`（0=asc / 1=desc）、`fltt`（2=浮点格式化）、`invt`（2=固定）、`np`（1=固定）
-  - 返回：`data.diff[]` 数组
-- `GET push2.eastmoney.com/api/qt/ulist.np/get` — 批量报价（给定 secids）
-  - 必需：`secids`（逗号拼接的 `<market>.<code>`）、`fields`
-  - 返回：`data.diff[]` 数组
-- `GET push2.eastmoney.com/api/qt/stock/get` — 单只详情
-  - 必需：`secid`、`fields`
-- `GET push2his.eastmoney.com/api/qt/stock/kline/get` — K 线历史
-  - 必需：`secid`、`klt`（周期：1 分 / 5 / 15 / 30 / 60 / 101 日 / 102 周 / 103 月）、`fqt`（0=不复权 / 1=前复权 / 2=后复权）、`fields1`、`fields2`
-  - 返回：`data.klines[]` — CSV 字符串数组
-- `GET datacenter-web.eastmoney.com/api/data/v1/get` — 报表类
-  - 必需：`reportName`（如 `RPT_DAILYBILLBOARD_DETAILS`）、`columns`、`pageSize`、`pageNumber`、`sortColumns`、`sortTypes`
-  - 返回：`result.data[]`
-- `GET np-listapi.eastmoney.com/nlist/api/list/get` — 7x24 快讯
-  - 必需：`client=web`、`column_id`、`limit`、`last_time`
-- `GET np-anotice-stock.eastmoney.com/api/security/ann` — 公司公告
-  - 必需：`sr=-1`、`page_size`、`page_index`、`ann_type`、`stock_list`
-
-## 字段
-
-字段代号词典见 `../field-conventions.md` 的 eastmoney 节（`f2 / f3 / f12 / f14 / f62 / f229-f243` 等全集）。
-
-市场前缀、fs 过滤码、secid 格式也都在那里。
-
-## 坑 / 陷阱
-
-1. **`fltt=2` 必传**：否则价格字段是 `int × 10^f152` 的整数表示，要自己除
-2. **资金流单位混乱**：`f6` 成交额是元，但 `f62 / f66 / f72 / f78 / f84` 等净流入大部分接口返回"万元"，核对单条接口后再乘
-3. **secid vs code**：`0.000001 / 1.600000` 是 secid（market + code），只有纯 code 时要先判断所属市场前缀再拼。用 `clis/eastmoney/_secid.js` 导出的 `resolveSecid(input)`（单股）或 `splitSymbols(s)`（批量参数拆分），不要自己硬拼前缀
-4. **港股代码 `00700.HK` 不是 secid**：只有前缀属于 `{0, 1, 105, 106, 107, 116, 100, 90}` 才当 secid
-5. **kline CSV 列序**：`fields2=f51,f52,f53,f54,f55,f56,f57,f58,f59,f60,f61` 对应 `date,open,close,high,low,volume,turnover,amplitude,changePct,changeAmt,turnoverRate`
-6. **datacenter-web 字段名大写**：`SECURITY_CODE` 不是 `security_code`
-
-## 可参考的 adapter
-
-| 模板类型 | 参考文件 |
-|---------|---------|
-| clist 分页排行 | `clis/eastmoney/convertible.js` / `rank.js` / `etf.js` / `sectors.js` |
-| ulist 批量报价 | `clis/eastmoney/quote.js` |
-| K 线历史 | `clis/eastmoney/kline.js` |
-| 报表类 | `clis/eastmoney/longhu.js` / `holders.js` |
-| 7x24 快讯 | `clis/eastmoney/kuaixun.js` |
-| 公司公告 | `clis/eastmoney/announcement.js` |
-| 指数 / 北上 | `clis/eastmoney/index-board.js` / `northbound.js` |
-| 资金流 | `clis/eastmoney/money-flow.js` |
-
-新写 eastmoney adapter 时，照最像的那条 copy + 改 `name` / URL 参数 / 字段映射三处。

package/skills/webcmd-adapter-author/references/site-memory/tonghuashun.md

@@ -1,51 +0,0 @@
-# tonghuashun（同花顺 / ths）
-
-## 域名
-
-| 用途 | 域名 |
-|------|------|
-| 行情页 / 热榜 | `q.10jqka.com.cn` |
-| 数据中心（多维筛选） | `data.10jqka.com.cn` |
-| 行情推送 | `d.10jqka.com.cn` / `dq.10jqka.com.cn` |
-| 基本面 / F10 | `basic.10jqka.com.cn` |
-| 资讯 / 新闻 | `news.10jqka.com.cn` |
-
-## 默认鉴权
-
-- `Strategy.COOKIE + browser: true`（多数接口有 cookie 风控）
-- `Referer: http://q.10jqka.com.cn/` 是关键 header，很多接口缺它直接返回空
-- 有些 JSONP 接口没 cookie 要求，但 Referer 还是要带
-- 不支持登录态扩展（加密/签名客户端逻辑复杂）
-
-## 已知 endpoint
-
-- `GET d.10jqka.com.cn/v6/line/hs_<code>/01/last1200.js` — K 线（JSONP，返回 `quotebridge_v6_line_...({...})`）
-- `GET q.10jqka.com.cn/thsq/quote/v6/<code>` — 实时行情快照（页面内 XHR）
-- `GET q.10jqka.com.cn/stock/attention/` — 热度榜（HTML，抽表）
-- `GET data.10jqka.com.cn/funds/ggzjl/field/zdf/order/desc/page/1/ajax/1/` — 资金流排行（HTML 表格 + JSONP 混合）
-- `GET news.10jqka.com.cn/tapp/news/push/stock/?tag=&page=1&limit=20` — 快讯
-- `GET data.10jqka.com.cn/ifinance/hotNews/` — 热点新闻
-
-## 字段
-
-见 `../field-conventions.md` 的 tonghuashun 节（`openPrice / closePrice / zdf / hsl / zf` 等）。
-
-数值字段多数是字符串（带百分号或"万"单位），解析时 `parseFloat` 并处理单位。
-
-## 坑 / 陷阱
-
-1. **`Referer` 必须带**，否则 302 到错误页
-2. **多数 JSONP 接口回调名固定**：`quotebridge_v6_...`，adapter 里直接 `.replace(/^[\w_]+\((.*)\)$/, '$1')` 剥壳再 JSON.parse
-3. **HTML 表格接口**（如资金流）：`page.evaluate` 里 `document.querySelectorAll('table tr')` 抽，每列顺序在同类 adapter 之间复用
-4. **`<code>` 格式 `hs_600000`**：hs 是上海，sz 是深圳；港美股前缀不同
-5. **数据中心接口有日期快照切换**：`date=YYYYMMDD` 参数默认当天，历史日期要显式传
-6. **限频特别严**：连续 10 次会跳风控页，adapter 层 1s 间隔起
-7. **响应 gzip 强制**：某些接口不带 Accept-Encoding 会 406，`fetch` 默认 OK，node 原生 http 要显式加
-
-## 可参考的 adapter
-
-| 模板类型 | 参考文件 |
-|---------|---------|
-| 热度榜 | `clis/ths/hot-rank.js`（目前唯一一个，其他待补） |
-
-ths 覆盖度低，新写 adapter 参考 eastmoney 同类型 adapter 的结构，把 URL / 解析逻辑换成 ths 版本。

package/skills/webcmd-adapter-author/references/site-memory/xueqiu.md

@@ -1,58 +0,0 @@
-# xueqiu（雪球）
-
-## 域名
-
-| 用途 | 域名 |
-|------|------|
-| 行情 / 搜索 / 关注列表 | `stock.xueqiu.com` / `xueqiu.com` |
-| 动态 / 评论 / 热帖 | `xueqiu.com` |
-| 基金（蛋卷） | `danjuanfunds.com` |
-
-## 默认鉴权
-
-- `Strategy.COOKIE + browser: true`
-- 核心 cookie：`xq_a_token`（匿名也有，登录后含用户身份）
-- `page.evaluate` 里 `fetch(url, { credentials: 'include' })` 带 cookie
-- 浏览器先访问一次 `xueqiu.com` 触发 cookie 下发，再去调接口（否则 `xq_a_token` 不存在 → 400）
-
-## 已知 endpoint
-
-- `GET stock.xueqiu.com/v5/stock/quote.json?symbol=SH600000` — 单股详情
-- `GET stock.xueqiu.com/v5/stock/batch/quote.json?symbol=SH600000,SZ000001` — 批量报价
-- `GET stock.xueqiu.com/v5/stock/chart/kline.json?symbol=SH600000&begin=<ts>&period=day&type=before&count=-100` — K 线
-- `GET stock.xueqiu.com/v5/stock/screener/quote/list.json?market=CN&type=sh_sz` — 排行
-  - 可选：`order_by=percent`（涨幅）/ `volume`（成交量）/ `amount`（成交额）/ `market_capital`
-- `GET stock.xueqiu.com/v5/stock/search.json?keyword=<q>` — 搜索
-- `GET xueqiu.com/statuses/hot/list.json?since_id=-1&max_id=-1&size=20&type=stock` — 热门帖
-- `GET xueqiu.com/statuses/search.json?source=all&q=<q>` — 动态搜索
-- `GET xueqiu.com/service/v5/stock/portfolio/list.json` — 关注组合（需登录）
-- `GET xueqiu.com/v4/statuses/user_timeline.json?user_id=<uid>` — 用户动态
-
-## 字段
-
-字段基本人类可读（`symbol / name / current / chg / percent / volume / amount / market_capital / pe_ttm / pb`），详见 `../field-conventions.md` 的 xueqiu 节。
-
-## 坑 / 陷阱
-
-1. **必须先访问首页**：冷启动直接调 API 会 400 `cookie is invalid`，先 `page.goto('https://xueqiu.com/')` 再 fetch
-2. **`symbol` 前缀硬编码**：SH/SZ/HK/US —— 港股 `00700` 是 `'HK00700'`，美股 `AAPL` 是 `'AAPL'`（无前缀）
-3. **kline 的 `begin` 是毫秒 unix**，不是秒
-4. **screener 的 `type`**：`sh_sz / hk / us` 必传，漏了拿空数组
-5. **评论接口 `comments.json` 要传 `statusId`**，不是 `status_id`
-6. **限频明显**：同 symbol 短时间反复调会 403，adapter 层建议加 300ms 间隔
-7. **蛋卷基金（`danjuanfunds.com`）是独立子品牌**：cookie 域不同，要单独获取
-
-## 可参考的 adapter
-
-| 模板类型 | 参考文件 |
-|---------|---------|
-| 单股 / 批量报价 | `clis/xueqiu/stock.js` |
-| K 线 | `clis/xueqiu/kline.js` |
-| 排行 | `clis/xueqiu/hot-stock.js` |
-| 热帖 / feed | `clis/xueqiu/hot.js` / `feed.js` |
-| 关注 | `clis/xueqiu/watchlist.js` |
-| 搜索 | `clis/xueqiu/search.js` |
-| 评论 | `clis/xueqiu/comments.js` |
-| 基金持仓（蛋卷） | `clis/xueqiu/fund-holdings.js` |
-
-工具：`clis/xueqiu/utils.js` 有 `fetchWithRetry` + symbol normalize，直接用别重写。