publishport-opencli 1.0.0

package/clis/12306/auth.js

@@ -0,0 +1,25 @@
+import{AuthRequiredError as i,CommandExecutionError as a}from"@jackwener/opencli/errors";import{registerSiteAuthCommands as s}from"../_shared/site-auth.js";async function n(t){return(await t.getCookies({url:"https://kyfw.12306.cn"})).some((r)=>r.name==="tk"&&r.value)}async function o(t){if(!await n(t))throw new i("12306.cn","12306 tk auth cookie missing");await t.goto("https://kyfw.12306.cn/otn/view/index.html");await t.wait(2);const e=await t.evaluate(`(async () => {
+    try {
+      const r = await fetch('/otn/index/initMy12306Api', {
+        method: 'POST',
+        credentials: 'include',
+        headers: { 'X-Requested-With': 'XMLHttpRequest' },
+      });
+      if (/login\\.html/.test(r.url)) {
+        return { kind: 'auth', detail: '12306 initMy12306Api redirected to login' };
+      }
+      const t = await r.text();
+      let d = null;
+      try { d = JSON.parse(t); } catch {}
+      if (!d || d.status === false || /未登录|登录超时|NotLogin/i.test(t)) {
+        return { kind: 'auth', detail: '12306 initMy12306Api returned NotLogin' };
+      }
+      const userName = d.data?.user_name || d.data?.userName || d.user_name || '';
+      if (!userName) {
+        return { kind: 'auth', detail: '12306 initMy12306Api 200 but no user_name surface' };
+      }
+      return { ok: true, user_name: String(userName) };
+    } catch (e) {
+      return { kind: 'exception', detail: String(e && e.message || e) };
+    }
+  })()`);if(e?.kind==="auth")throw new i("12306.cn",e.detail);if(e?.kind==="exception")throw new a(`12306 whoami failed: ${e.detail}`);if(!e?.ok)throw new a(`Unexpected 12306 probe: ${JSON.stringify(e)}`);return{user_name:e.user_name}}s({site:"12306",domain:"12306.cn",loginUrl:"https://kyfw.12306.cn/otn/resources/login.html",columns:["user_name"],quickCheck:n,verify:o,poll:async(t)=>{if(!await n(t))throw new i("12306.cn","Waiting for 12306 tk auth cookie");return o(t)}});

package/clis/12306/me.js

@@ -0,0 +1,9 @@
+import{cli as c,Strategy as l}from"@jackwener/opencli/registry";import{AuthRequiredError as s,CommandExecutionError as i}from"@jackwener/opencli/errors";import{isAuthLikePayload as d,maskEmail as f,maskMobile as _,maskChineseName as h,require12306Login as y,requireEvaluateObject as w}from"./utils.js";const b="https://kyfw.12306.cn/otn/modifyUser/initQueryUserInfoApi";c({site:"12306",name:"me",access:"read",description:"Show the logged-in 12306 account summary. Sensitive fields (real name, email, mobile, birth date) are masked by default; pass --include-sensitive to opt in.",domain:"kyfw.12306.cn",strategy:l.COOKIE,browser:!0,args:[{name:"include-sensitive",type:"boolean",default:!1,help:"Reveal unmasked real name / email / mobile / birth date. The 12306 ID-number mask is server-side and never decoded."}],columns:["username","real_name","email","mobile","birth_date","sex","country","user_type","member","active"],func:async(t,m)=>{if(!t)throw new i("Browser session required for 12306 me");await t.goto("https://kyfw.12306.cn/otn/view/index.html");await y(t,s);const r=w(await t.evaluate(`async () => {
+      const r = await fetch(${JSON.stringify(b)}, { credentials: 'include' });
+      if (!r.ok) return { __http: r.status };
+      try {
+        return await r.json();
+      } catch (err) {
+        return { __parse: String(err && err.message || err) };
+      }
+    }`),"account info");if(r?.__http){if([401,403].includes(Number(r.__http)))throw new s("kyfw.12306.cn","12306 account info requires a valid login session");throw new i(`12306 returned HTTP ${r.__http} for account info`)}if(r?.__parse)throw new i(`12306 account info returned non-JSON body: ${r.__parse}`);if(d(r))throw new s("kyfw.12306.cn","12306 account info requires a valid login session");if(r?.status!==!0||!r?.data?.userDTO)throw new i("12306 account info payload missing userDTO");const e=r.data.userDTO,n=e.loginUserDTO||{},u=n.user_name||n.name||"",o=n.real_name||n.realname||"",a=m["include-sensitive"]===!0;return[{username:u,real_name:a?o:h(o),email:a?e.email||"":f(e.email||""),mobile:a?e.mobile_no||"":_(e.mobile_no||""),birth_date:a?e.born_date||"":(e.born_date||"").slice(0,4),sex:e.sex_code==="M"?"男":e.sex_code==="F"?"女":"",country:e.country_code||"",user_type:r.data.userTypeName||"",member:e.flag_member==="1",active:e.is_active==="1"}]}});

package/clis/12306/orders.js

@@ -0,0 +1,13 @@
+import{cli as _,Strategy as c}from"@jackwener/opencli/registry";import{AuthRequiredError as o,CommandExecutionError as a,EmptyResultError as l}from"@jackwener/opencli/errors";import{isAuthLikePayload as m,maskChineseName as p,require12306Login as f,requireEvaluateObject as y}from"./utils.js";const h="https://kyfw.12306.cn/otn/queryOrder/queryMyOrderNoComplete";_({site:"12306",name:"orders",access:"read",description:"List in-progress 12306 orders (not yet ridden, refunded, or completed) for the logged-in user",domain:"kyfw.12306.cn",strategy:c.COOKIE,browser:!0,args:[{name:"include-sensitive",type:"boolean",default:!1,help:"Reveal unmasked passenger names in order rows. Masked by default."}],columns:["order_id","order_date","train_code","from_station","to_station","departure","passengers","status","amount"],func:async(s,i)=>{if(!s)throw new a("Browser session required for 12306 orders");await s.goto("https://kyfw.12306.cn/otn/view/index.html");await f(s,o);const d=i["include-sensitive"]===!0,r=y(await s.evaluate(`async () => {
+      const r = await fetch(${JSON.stringify(h)}, {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/x-www-form-urlencoded' },
+        body: '_json_att=', credentials: 'include',
+      });
+      if (!r.ok) return { __http: r.status };
+      try {
+        return await r.json();
+      } catch (err) {
+        return { __parse: String(err && err.message || err) };
+      }
+    }`),"orders");if(r?.__http){if([401,403].includes(Number(r.__http)))throw new o("kyfw.12306.cn","12306 orders requires a valid login session");throw new a(`12306 returned HTTP ${r.__http} for queryMyOrderNoComplete`)}if(r?.__parse)throw new a(`12306 orders returned non-JSON body: ${r.__parse}`);if(m(r))throw new o("kyfw.12306.cn","12306 orders requires a valid login session");if(r?.status!==!0)throw new a("12306 queryMyOrderNoComplete returned a failure status");let t;if(Array.isArray(r?.data?.orderDBList))t=r.data.orderDBList;else if(Array.isArray(r?.data?.orderDTODataList))t=r.data.orderDTODataList;else if(Array.isArray(r?.data?.orders))t=r.data.orders;else if(Array.isArray(r?.data))t=r.data;else throw new a("12306 queryMyOrderNoComplete payload missing order list array");if(t.length===0)throw new l("No in-progress 12306 orders on this account");return t.map((e)=>{const u=(Array.isArray(e.tickets)?e.tickets:[]).map((n)=>n.passenger_name||"").filter(Boolean).map((n)=>d?n:p(n)).join(", ");return{order_id:e.sequence_no||e.order_id||e.sequenceNo||"",order_date:e.order_date||"",train_code:e.train_code_page||e.station_train_code||e.train_code||"",from_station:e.from_station_name_page||e.from_station_name||"",to_station:e.to_station_name_page||e.to_station_name||"",departure:e.start_train_date_page||e.start_train_date||"",passengers:u,status:e.ticket_status_name||e.order_status_name||e.statusName||"",amount:e.ticket_total_price_page||e.ticket_total_price||""}})}});

package/clis/12306/passengers.js

@@ -0,0 +1,14 @@
+import{cli as c,Strategy as p}from"@jackwener/opencli/registry";import{ArgumentError as m,AuthRequiredError as o,CommandExecutionError as i,EmptyResultError as _}from"@jackwener/opencli/errors";import{isAuthLikePayload as y,maskChineseName as g,require12306Login as f,requireEvaluateObject as h}from"./utils.js";const w="https://kyfw.12306.cn/otn/passengers/query",d=50;function l(e,a,t){if(e===void 0||e===null||e==="")return a;const n=Number(e);if(!Number.isInteger(n)||n<1)throw new m(`limit must be a positive integer (1-${t})`);if(n>t)throw new m(`limit must be <= ${t}`);return n}c({site:"12306",name:"passengers",access:"read",description:"List the logged-in user's saved 12306 passengers. Sensitive fields are masked by default; pass --include-sensitive to opt in.",domain:"kyfw.12306.cn",strategy:p.COOKIE,browser:!0,args:[{name:"limit",type:"int",default:20,help:`Max passengers to return (1-${d})`},{name:"include-sensitive",type:"boolean",default:!1,help:"Reveal unmasked real names and birth dates. The 12306 ID-number / mobile masks are server-side and never decoded."}],columns:["name","sex","born_year","id_type","id_no","mobile","passenger_type","country"],func:async(e,a)=>{if(!e)throw new i("Browser session required for 12306 passengers");const t=l(a.limit,20,d),n=a["include-sensitive"]===!0;await e.goto("https://kyfw.12306.cn/otn/view/index.html");await f(e,o);const s=h(await e.evaluate(`async () => {
+      const body = "pageIndex=1&pageSize=${d}";
+      const r = await fetch(${JSON.stringify(w)}, {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/x-www-form-urlencoded' },
+        body, credentials: 'include',
+      });
+      if (!r.ok) return { __http: r.status };
+      try {
+        return await r.json();
+      } catch (err) {
+        return { __parse: String(err && err.message || err) };
+      }
+    }`),"passengers");if(s?.__http){if([401,403].includes(Number(s.__http)))throw new o("kyfw.12306.cn","12306 passengers requires a valid login session");throw new i(`12306 returned HTTP ${s.__http} for passengers/query`)}if(s?.__parse)throw new i(`12306 passengers returned non-JSON body: ${s.__parse}`);if(y(s))throw new o("kyfw.12306.cn","12306 passengers requires a valid login session");if(s?.status!==!0||!Array.isArray(s?.data?.datas))throw new i("12306 passengers payload missing data.datas array");const u=s.data.datas;if(u.length===0)throw new _("No saved passengers on this 12306 account");return u.slice(0,t).map((r)=>({name:n?r.passenger_name||"":g(r.passenger_name||""),sex:r.sex_name||"",born_year:(r.born_date||"").slice(0,4),id_type:r.passenger_id_type_name||"",id_no:r.passenger_id_no||"",mobile:r.mobile_no||"",passenger_type:r.passenger_type_name||"",country:r.country_code||""}))}});export const __test__={normalizeLimit:l};

package/clis/12306/price.js

@@ -0,0 +1 @@
+import{cli as x,Strategy as R}from"@jackwener/opencli/registry";import{ArgumentError as B,CommandExecutionError as $,EmptyResultError as _}from"@jackwener/opencli/errors";import{fetchStationBundle as j,mintSession as y,resolveStation as L,validateDate as T}from"./utils.js";const O="Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/127.0 Safari/537.36",U=/^[0-9A-Za-z]{8,18}$/,C=/^[A-Z0-9]{1,32}$/,b={A9:"商务座",P:"特等座",M:"一等座",O:"二等座",A1:"硬座",A3:"硬卧",A4:"软卧",F:"动卧",WZ:"无座"};async function q(Q,J,G,M,V,W=fetch){const X=`https://kyfw.12306.cn/otn/czxx/queryByTrainNo?train_no=${J}&from_station_telecode=${G}&to_station_telecode=${M}&depart_date=${V}`,K=await W(X,{headers:{"User-Agent":O,Referer:"https://kyfw.12306.cn/otn/leftTicket/init",Cookie:Q}});if(!K.ok)throw new $(`12306 queryByTrainNo returned HTTP ${K.status}`);let z;try{z=await K.json()}catch{throw new $("12306 queryByTrainNo returned non-JSON body")}if(z?.status!==!0||!Array.isArray(z?.data?.data))throw new $("12306 queryByTrainNo returned an unexpected payload shape");return z.data.data}function D(Q,J,G,M,V){const W=(z,Z,Y)=>z.station_name&&Y&&z.station_name===Y,X=Q.find((z)=>W(z,J,M)),K=Q.find((z)=>W(z,G,V));if(!X)throw new $(`Train does not stop at ${M}`);if(!K)throw new $(`Train does not stop at ${V}`);return{fromNo:X.station_no,toNo:K.station_no}}async function H(Q,J,G,M,V,W,X=fetch){const K=`https://kyfw.12306.cn/otn/leftTicket/queryTicketPrice?train_no=${J}&from_station_no=${G}&to_station_no=${M}&seat_types=${V}&train_date=${W}`,z=await X(K,{headers:{"User-Agent":O,Referer:"https://kyfw.12306.cn/otn/leftTicket/init",Cookie:Q}});if(!z.ok)throw new $(`12306 queryTicketPrice returned HTTP ${z.status}`);let Z;try{Z=await z.json()}catch{throw new $("12306 queryTicketPrice returned non-JSON body")}if(Z?.status!==!0||!Z?.data)throw new $("12306 queryTicketPrice returned an unexpected payload shape");return Z.data}function I(Q){const J=[];for(const[G,M]of Object.entries(Q)){if(G==="train_no"||G==="OT")continue;if(typeof M!=="string"||!M)continue;if(/^\d+$/.test(G))continue;if(!/^[A-Z]/.test(G))continue;const V=M.replace(/^¥/,"");if(!/^[\d.]+$/.test(V))continue;J.push({seat_code:G,seat_name:b[G]||G,price:V,currency:"CNY"})}J.sort((G,M)=>Number(M.price)-Number(G.price));return J}x({site:"12306",name:"price",access:"read",description:"Look up 12306 ticket prices by seat class for one train on a given date and segment (anonymous, no login required)",domain:"kyfw.12306.cn",strategy:R.PUBLIC,browser:!1,args:[{name:"train-no",positional:!0,required:!0,help:"Internal train_no from `12306 trains` (e.g. 24000000G10L)"},{name:"from",required:!0,help:"Origin station (Chinese name, telecode, or pinyin) - must be a stop of this train"},{name:"to",required:!0,help:"Destination station - must be a stop of this train"},{name:"date",required:!0,help:"Departure date in YYYY-MM-DD"},{name:"seat-types",default:"OM9PA1A3A4FWZ",help:"Seat-type letters to query (default covers the common classes). Examples: OM9 (二等/一等/商务), A1A3A4 (硬座/硬卧/软卧)."}],columns:["seat_code","seat_name","price","currency"],func:async(Q)=>{const J=String(Q["train-no"]??"").trim();if(!J)throw new B("<train-no> must not be empty");if(!U.test(J))throw new B(`<train-no> "${J}" does not look like a 12306 internal train_no`,"Use the train_no field from `12306 trains` output (e.g. 24000000G10L), not the public code (G1).");const G=String(Q.from??"").trim(),M=String(Q.to??"").trim();if(!G)throw new B("--from station must not be empty");if(!M)throw new B("--to station must not be empty");const V=T(Q.date),W=String(Q["seat-types"]??"").trim()||"OM9PA1A3A4FWZ";if(!C.test(W))throw new B("--seat-types must contain only 12306 seat letters/digits (A-Z, 0-9)");const X=await j(),K=L(X,G),z=L(X,M);if(K.code===z.code)throw new B(`--from and --to must differ; both resolved to ${K.name} (${K.code})`);const Z=await y(),Y=await q(Z,J,K.code,z.code,V),{fromNo:v,toNo:P}=D(Y,K.code,z.code,K.name,z.name),h=await H(Z,J,v,P,W,V),F=I(h);if(F.length===0)throw new _(`No prices returned for train_no=${J} ${K.name} -> ${z.name} on ${V}`,"Try a different seat-types letter set, or check that this train operates on the date.");return F}});export const __test__={parsePriceData:I,pickStationNos:D,queryStopsForPrice:q,queryPrice:H,SEAT_LETTERS:b,TRAIN_NO_RE:U};

package/clis/12306/stations.js

@@ -0,0 +1 @@
+import{cli as l,Strategy as u}from"@jackwener/opencli/registry";import{ArgumentError as s,EmptyResultError as d}from"@jackwener/opencli/errors";import{fetchStationBundle as y}from"./utils.js";const c=50;function m(n,t,r){if(n===void 0||n===null||n==="")return t;const i=Number(n);if(!Number.isInteger(i)||i<1)throw new s(`limit must be a positive integer (1-${r})`);if(i>r)throw new s(`limit must be <= ${r}`);return i}l({site:"12306",name:"stations",access:"read",description:"Search 12306 (China Railway) stations by Chinese name, telecode, or pinyin keyword",domain:"kyfw.12306.cn",strategy:u.PUBLIC,browser:!1,args:[{name:"keyword",positional:!0,required:!0,help:"Chinese substring (上海), telecode (AOH), or pinyin (shanghai)"},{name:"limit",type:"int",default:20,help:`Maximum results (1-${c})`}],columns:["name","code","pinyin","abbr","city"],func:async(n)=>{const t=String(n.keyword??"").trim();if(!t)throw new s("keyword must not be empty");const r=m(n.limit,20,c),i=await y(),o=t.toLowerCase(),a=i.filter((e)=>e.name.includes(t)||e.code===t.toUpperCase()||e.pinyin.includes(o)||e.abbr.includes(o)||e.short.includes(o)||e.city.includes(t));if(a.length===0)throw new d(`No 12306 stations match "${t}"`);return a.slice(0,r).map((e)=>({name:e.name,code:e.code,pinyin:e.pinyin,abbr:e.abbr,city:e.city}))}});export const __test__={normalizeLimit:m};

package/clis/12306/train.js

@@ -0,0 +1 @@
+import{cli as h,Strategy as y}from"@jackwener/opencli/registry";import{ArgumentError as a,CommandExecutionError as u,EmptyResultError as w}from"@jackwener/opencli/errors";import{fetchStationBundle as v,mintSession as g,resolveStation as p,validateDate as S}from"./utils.js";const b="Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/127.0 Safari/537.36",f=/^[0-9A-Za-z]{8,18}$/;async function _(o,e,s,m,c,d=fetch){const r=`https://kyfw.12306.cn/otn/czxx/queryByTrainNo?train_no=${e}&from_station_telecode=${s}&to_station_telecode=${m}&depart_date=${c}`,n=await d(r,{headers:{"User-Agent":b,Referer:"https://kyfw.12306.cn/otn/leftTicket/init",Cookie:o}});if(!n.ok)throw new u(`12306 queryByTrainNo returned HTTP ${n.status}`);let i;try{i=await n.json()}catch{throw new u("12306 queryByTrainNo returned non-JSON body")}if(i?.status!==!0||!Array.isArray(i?.data?.data))throw new u("12306 queryByTrainNo returned an unexpected payload shape");return i.data.data}h({site:"12306",name:"train",access:"read",description:"List every station a 12306 train calls at, with arrival / departure / stopover time (anonymous, no login required)",domain:"kyfw.12306.cn",strategy:y.PUBLIC,browser:!1,args:[{name:"train-no",positional:!0,required:!0,help:"Internal train_no from `12306 trains` (e.g. 24000000G10L), not the public code (G1)"},{name:"from",required:!0,help:"Origin station for the segment: Chinese name, telecode, or pinyin"},{name:"to",required:!0,help:"Destination station for the segment"},{name:"date",required:!0,help:"Departure date in YYYY-MM-DD"}],columns:["station_no","station_name","arrive_time","start_time","stopover_time"],func:async(o)=>{const e=String(o["train-no"]??"").trim();if(!e)throw new a("<train-no> must not be empty");if(!f.test(e))throw new a(`<train-no> "${e}" does not look like a 12306 internal train_no`,"Use the train_no field from `12306 trains` output (e.g. 24000000G10L), not the public code (G1).");const s=String(o.from??"").trim(),m=String(o.to??"").trim();if(!s)throw new a("--from station must not be empty");if(!m)throw new a("--to station must not be empty");const c=S(o.date),d=await v(),r=p(d,s),n=p(d,m);if(r.code===n.code)throw new a(`--from and --to must differ; both resolved to ${r.name} (${r.code})`);const i=await g(),l=await _(i,e,r.code,n.code,c);if(l.length===0)throw new w(`No stops returned for train_no=${e} on ${c}`);return l.map((t)=>({station_no:t.station_no||"",station_name:t.station_name||"",arrive_time:t.arrive_time==="----"?"":t.arrive_time||"",start_time:t.start_time==="----"?"":t.start_time||"",stopover_time:t.stopover_time==="----"?"":t.stopover_time||""}))}});export const __test__={queryStops:_,TRAIN_NO_RE:f};

package/clis/12306/trains.js

@@ -0,0 +1 @@
+import{cli as b,Strategy as R}from"@jackwener/opencli/registry";import{ArgumentError as H,CommandExecutionError as Y,EmptyResultError as j}from"@jackwener/opencli/errors";import{fetchStationBundle as C,mintSession as A,resolveStation as N,validateDate as v,parseTrainRecord as w}from"./utils.js";const f="Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/127.0 Safari/537.36",Q=["queryG","queryO","queryZ","queryA"],_=100,k=/^query[A-Z]$/;function q(F,K,J){if(F===void 0||F===null||F==="")return K;const G=Number(F);if(!Number.isInteger(G)||G<1)throw new H(`limit must be a positive integer (1-${J})`);if(G>J)throw new H(`limit must be <= ${J}`);return G}function U(F){const K=String(F??"").trim();if(!K)return"";const J=K.replace(/^leftTicket\//,"").trim();if(k.test(J))return J;try{const G=new URL(K,"https://kyfw.12306.cn");if(G.hostname!=="kyfw.12306.cn")return"";const $=G.pathname.match(/\/leftTicket\/(query[A-Z])$/);return $?$[1]:""}catch{return""}}async function I(F,K,J){let G;if(J)try{G=JSON.parse(J)}catch{}const $=U(G?.c_url);if($)return $;const z=U(F.headers?.get?.("location"));if(z)return z;if(F.status===302)throw new Y(`12306 ${K} redirected without a leftTicket query endpoint`);if(G?.c_url)throw new Y(`12306 ${K} returned an invalid rotation endpoint`);return""}async function L(F,K,J,G){const $={"User-Agent":f,Referer:"https://kyfw.12306.cn/otn/leftTicket/init",Cookie:F},z=`leftTicketDTO.train_date=${G}&leftTicketDTO.from_station=${K}&leftTicketDTO.to_station=${J}&purpose_codes=ADULT`;let B="";const V=[...Q],O=new Set;while(V.length>0){const W=V.shift();if(O.has(W))continue;O.add(W);const M=`https://kyfw.12306.cn/otn/leftTicket/${W}?${z}`,Z=await fetch(M,{headers:$,redirect:"manual"});if(!Z.ok){if(Z.status===302){const D=await Z.text(),P=await I(Z,W,D);if(P&&!O.has(P))V.unshift(P);continue}throw new Y(`12306 ${W} returned HTTP ${Z.status}`)}const X=await Z.text();B=X;let h;try{h=JSON.parse(X)}catch{throw new Y(`12306 ${W} returned non-JSON body`)}if(h?.c_url&&typeof h.c_url==="string"){const D=await I(Z,W,X);if(D&&!O.has(D))V.unshift(D);continue}if(Array.isArray(h?.data?.result))return h.data.result;throw new Y(`12306 ${W} returned an unexpected payload shape`)}throw new Y(`12306 rejected every known query endpoint name (${Q.join(", ")}); the wire protocol may have changed. Last body: ${B.slice(0,200)}`)}b({site:"12306",name:"trains",access:"read",description:"List trains between two 12306 stations on a given date (anonymous, no login required)",domain:"kyfw.12306.cn",strategy:R.PUBLIC,browser:!1,args:[{name:"from",positional:!0,required:!0,help:"Origin station: Chinese name (北京), telecode (BJP), or pinyin (beijing)"},{name:"to",positional:!0,required:!0,help:"Destination station: same forms as <from>"},{name:"date",required:!0,help:"Departure date in YYYY-MM-DD"},{name:"limit",type:"int",default:50,help:`Maximum rows (1-${_})`}],columns:["code","from_station","to_station","start_time","arrive_time","duration","available","business_seat","first_seat","second_seat","soft_sleeper","hard_sleeper","hard_seat","no_seat","train_no"],func:async(F)=>{const K=String(F.from??"").trim(),J=String(F.to??"").trim();if(!K)throw new H("<from> station must not be empty");if(!J)throw new H("<to> station must not be empty");const G=v(F.date),$=q(F.limit,50,_),z=await C(),B=N(z,K),V=N(z,J);if(B.code===V.code)throw new H(`<from> and <to> must differ; both resolved to ${B.name} (${B.code})`);const O=new Map(z.map((X)=>[X.code,X])),W=await A(),Z=(await L(W,B.code,V.code,G)).map((X)=>w(decodeURIComponent(X.replace(/%0A/g,"")),O)).filter(Boolean);if(Z.length===0)throw new j(`No trains found from ${B.name} to ${V.name} on ${G}`,"Try a different date or check whether the route is operated by 12306.");return Z.slice(0,$)}});export const __test__={normalizeLimit:q,extractQueryEndpoint:U,queryLeftTickets:L};

package/clis/12306/utils.js

@@ -0,0 +1 @@
+import{ArgumentError as Y,CommandExecutionError as X}from"@jackwener/opencli/errors";const M="https://kyfw.12306.cn/otn/resources/js/framework/station_name.js",j="https://kyfw.12306.cn/otn/leftTicket/init",$="Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/127.0 Safari/537.36",q=/^\d{4}-\d{2}-\d{2}$/,O=/^[A-Z]{2,4}$/;export function parseStationBundle(F){const z=F.match(/'([^']+)'/);if(!z)throw new X("Failed to parse 12306 station_name.js: source string not found");const K=z[1].split("@").filter(Boolean),Q=[];for(const Z of K){const V=Z.split("|");if(V.length<8||!V[2])continue;Q.push({short:V[0]||"",name:V[1]||"",code:V[2]||"",pinyin:V[3]||"",abbr:V[4]||"",city:V[7]||""})}if(Q.length===0)throw new X("Failed to parse 12306 station_name.js: no station records found");return Q}export function resolveStation(F,z){const G=String(z??"").trim();if(!G)throw new Y("station must not be empty");if(O.test(G)){const W=F.find((J)=>J.code===G);if(W)return W;throw new Y(`Unknown 12306 station telecode "${G}"`)}const K=G.toLowerCase(),Q=F.find((W)=>W.name===G);if(Q)return Q;const Z=F.find((W)=>W.pinyin===K);if(Z)return Z;const V=F.find((W)=>W.abbr===K||W.short===K);if(V)return V;throw new Y(`Unknown 12306 station "${G}"`,"Try the Chinese name (上海虹桥), the 3-4 letter telecode (AOH), or full pinyin (shanghaihongqiao).")}export function validateDate(F){if(!q.test(String(F??"")))throw new Y(`date must be YYYY-MM-DD, got "${F}"`);const[z,G,K]=F.split("-").map(Number),Q=new Date(Date.UTC(z,G-1,K));if(Q.getUTCFullYear()!==z||Q.getUTCMonth()!==G-1||Q.getUTCDate()!==K)throw new Y(`date "${F}" is not a real calendar date`);return F}export function buildCookieHeader(F){if(!Array.isArray(F)||F.length===0)return"";return F.map((z)=>z.split(";")[0]).filter(Boolean).join("; ")}export async function fetchStationBundle(F=fetch){const z=await F(M,{headers:{"User-Agent":$}});if(!z.ok)throw new X(`Failed to fetch 12306 station bundle: HTTP ${z.status}`);return parseStationBundle(await z.text())}export async function mintSession(F=fetch){const z=await F(j,{headers:{"User-Agent":$},redirect:"follow"});if(!z.ok)throw new X(`Failed to mint 12306 session: HTTP ${z.status}`);const G=typeof z.headers.getSetCookie==="function"?z.headers.getSetCookie():z.headers.raw?.()["set-cookie"]||[],K=buildCookieHeader(G);if(!K)throw new X("12306 init returned no session cookies");return K}export function parseTrainRecord(F,z){const G=F.split("|");if(G.length<33)return null;return{train_no:G[2]||"",code:G[3]||"",from_station:z.get(G[6])?.name||G[6]||"",to_station:z.get(G[7])?.name||G[7]||"",from_code:G[6]||"",to_code:G[7]||"",start_time:G[8]||"",arrive_time:G[9]||"",duration:G[10]||"",available:(G[1]||"").trim()==="预订"||(G[11]||"").trim()==="Y",business_seat:G[32]||"",first_seat:G[31]||"",second_seat:G[30]||"",soft_sleeper:G[23]||"",hard_sleeper:G[28]||"",hard_seat:G[29]||"",no_seat:G[26]||""}}export function maskEmail(F){const z=String(F||"").trim();if(!z)return"";const G=z.indexOf("@");if(G<=0)return z;const K=z.slice(0,G),Q=z.slice(G);if(K.length<=2)return K[0]+"*"+Q;return K[0]+"*".repeat(Math.max(1,K.length-2))+K.slice(-1)+Q}export function maskMobile(F){const z=String(F||"").trim();if(!z)return"";if(/\*/.test(z))return z;if(z.length<7)return z.replace(/.(?=.)/g,"*");return z.slice(0,3)+"*".repeat(z.length-7)+z.slice(-4)}export function maskChineseName(F){const z=String(F||"").trim();if(!z)return"";if(z.length===1)return z;if(z.length===2)return z[0]+"*";return z[0]+"*".repeat(z.length-2)+z.slice(-1)}export function unwrapEvaluateResult(F){if(F&&typeof F==="object"&&!Array.isArray(F)&&Object.prototype.hasOwnProperty.call(F,"session")&&Object.prototype.hasOwnProperty.call(F,"data"))return F.data;return F}export function requireEvaluateObject(F,z){const G=unwrapEvaluateResult(F);if(!G||typeof G!=="object"||Array.isArray(G))throw new X(`12306 ${z} returned a malformed browser payload`);return G}export function isAuthLikePayload(F){if(!F||typeof F!=="object")return!1;const z=[];if(Array.isArray(F.messages))z.push(...F.messages);if(F.message)z.push(F.message);if(F.msg)z.push(F.msg);if(F.validateMessages&&typeof F.validateMessages==="object")z.push(...Object.values(F.validateMessages).flat());const G=z.map((K)=>String(K??"")).join(" ");return/未登录|登录|请登录|身份|认证|session|Session|login/i.test(G)}export async function require12306Login(F,z){const G=unwrapEvaluateResult(await F.evaluate("document.cookie || ''")),K=typeof G==="string"?G:"";if(!/\btk=/.test(K)||!/JSESSIONID=/.test(K))throw new z("kyfw.12306.cn","Not logged into 12306. Sign in at https://kyfw.12306.cn first.")}export const __test__={parseStationBundle,resolveStation,validateDate,buildCookieHeader,parseTrainRecord,maskEmail,maskMobile,maskChineseName,unwrapEvaluateResult,requireEvaluateObject,isAuthLikePayload};

package/clis/1688/assets.js

@@ -0,0 +1,127 @@
+import{cli as g,Strategy as f}from"@jackwener/opencli/registry";import{assertAuthenticatedState as h,buildDetailUrl as m,buildProvenance as y,cleanText as o,extractOfferId as v,gotoAndReadState as w,uniqueMediaSources as I}from"./shared.js";function k(){return`
+    (() => {
+      const root = window.context ?? {};
+      const model = root.result?.global?.globalData?.model ?? null;
+      const gallery = root.result?.data?.gallery?.fields ?? null;
+      const defaultSrcProps = ['data-lazyload-src', 'data-src', 'data-ks-lazyload', 'currentSrc', 'src'];
+      const groups = [
+        { key: 'main', type: 'image', selectors: ['#dt-tab img', '.detail-gallery-turn img.detail-gallery-img', '.img-list-wrapper img.od-gallery-img', '.od-scroller-item span'] },
+        { key: 'video', type: 'video', selectors: ['.lib-video video', 'video[src]', 'video source[src]'] },
+        { key: 'sku', type: 'image', selectors: ['.pc-sku-wrapper .prop-item-inner-wrapper', '.sku-item-wrapper', '.specification-cell', '.sku-filter-button', '.expand-view-item', '.feature-item img'], srcProps: ['backgroundImage'] },
+        { key: 'detail', type: 'image', selectors: ['.de-description-detail img', '#detailContentContainer img', '.html-description img', '.html-description source', '.desc-lazyload-container img'] },
+      ];
+      const assets = [];
+      const seen = new Set();
+
+      const normalizeUrl = (value) => {
+        if (typeof value !== 'string') return '';
+        let next = value
+          .replace(/^url\\((.*)\\)$/i, '$1')
+          .replace(/^['"]|['"]$/g, '')
+          .replace(/\\\\u002F/g, '/')
+          .replace(/&/g, '&')
+          .trim();
+        if (!next || next.startsWith('blob:') || next.startsWith('data:')) return '';
+        if (next.startsWith('//')) next = 'https:' + next;
+        try {
+          return new URL(next, location.href).toString();
+        } catch {
+          return '';
+        }
+      };
+
+      const push = (type, group, url, source) => {
+        const normalized = normalizeUrl(url);
+        if (!normalized) return;
+        const key = type + ':' + normalized;
+        if (seen.has(key)) return;
+        seen.add(key);
+        assets.push({ type, group, url: normalized, source });
+      };
+
+      const queryAllDeep = (selector) => {
+        const results = [];
+        const visitedRoots = new Set();
+        const walkRoots = (root, fn) => {
+          if (!root || visitedRoots.has(root)) return;
+          visitedRoots.add(root);
+          fn(root);
+          const childElements = root.querySelectorAll ? Array.from(root.querySelectorAll('*')) : [];
+          for (const child of childElements) {
+            if (child && child.shadowRoot) {
+              walkRoots(child.shadowRoot, fn);
+            }
+          }
+        };
+        walkRoots(document, (root) => {
+          if (root.querySelectorAll) {
+            results.push(...Array.from(root.querySelectorAll(selector)));
+          }
+        });
+        return results;
+      };
+
+      const valuesFromElement = (element, srcProps) => {
+        const values = [];
+        const props = srcProps && srcProps.length ? srcProps : defaultSrcProps;
+        for (const prop of props) {
+          try {
+            if (prop === 'backgroundImage') {
+              const bg = getComputedStyle(element).backgroundImage || '';
+              const matches = bg.match(/url\\(([^)]+)\\)/g) || [];
+              for (const match of matches) {
+                const clean = match.replace(/^url\\(/, '').replace(/\\)$/, '');
+                values.push(clean);
+              }
+              continue;
+            }
+
+            const direct = element[prop];
+            if (typeof direct === 'string' && direct) values.push(direct);
+            const attr = element.getAttribute ? element.getAttribute(prop) : '';
+            if (attr) values.push(attr);
+          } catch {}
+        }
+
+        if (element.tagName === 'SOURCE' && element.parentElement?.tagName === 'VIDEO') {
+          values.push(element.src || element.getAttribute('src') || '');
+        }
+
+        if (element.tagName === 'VIDEO') {
+          values.push(element.currentSrc || '');
+          values.push(element.src || '');
+        }
+
+        return values;
+      };
+
+      for (const group of groups) {
+        for (const selector of group.selectors) {
+          for (const element of queryAllDeep(selector)) {
+            for (const value of valuesFromElement(element, group.srcProps)) {
+              push(group.type, group.key, value, 'dom:' + selector);
+            }
+          }
+        }
+      }
+
+      const scriptTexts = Array.from(document.scripts).map((script) => script.textContent || '');
+      const videoRegex = /https?:\\/\\/[^"'\\s]+\\.(?:mp4|m3u8)(?:\\?[^"'\\s]*)?/gi;
+      for (const scriptText of scriptTexts) {
+        const matches = scriptText.match(videoRegex) || [];
+        for (const match of matches) {
+          push('video', 'video', match, 'script');
+        }
+      }
+
+      const toJson = (value) => JSON.parse(JSON.stringify(value ?? null));
+      return {
+        href: window.location.href,
+        title: document.title || '',
+        offerTitle: model?.offerTitleModel?.subject ?? '',
+        offerId: model?.tradeModel?.offerId ?? '',
+        gallery: toJson(gallery),
+        scannedAssets: assets,
+      };
+    })()
+  `}function p(t){const r=o(String(t.offerId??""))||v(o(t.href))||null,a=r?m(r):o(t.href),n=[...(t.gallery?.mainImage??[]).map((e)=>({type:"image",group:"main",url:e,source:"page_state:mainImage"})),...(t.gallery?.offerImgList??[]).map((e)=>({type:"image",group:"main",url:e,source:"page_state:offerImgList"})),...(t.gallery?.wlImageInfos??[]).map((e)=>({type:"image",group:"main",url:e?.fullPathImageURI??"",source:"page_state:wlImageInfos"}))],s=I([...n,...t.scannedAssets??[]]),l=s.filter((e)=>e.type==="image"&&e.group==="main").map((e)=>e.url),i=s.filter((e)=>e.type==="image"&&e.group==="sku").map((e)=>e.url),c=s.filter((e)=>e.type==="image"&&e.group==="detail").map((e)=>e.url),u=s.filter((e)=>e.type==="video").map((e)=>e.url),d=s.filter((e)=>e.type==="image"&&!["main","sku","detail"].includes(e.group)).map((e)=>e.url);return{offer_id:r,title:o(t.offerTitle)||o(t.title)||null,item_url:a,main_images:l,sku_images:i,detail_images:c,videos:u,other_images:d,raw_assets:s,source:[...new Set(s.map((e)=>o(e.source)).filter(Boolean))],main_count:l.length,sku_count:i.length,detail_count:c.length,video_count:u.length,...y(o(t.href)||a)}}async function S(t,r){const a=await w(t,r,2500,"assets");h(a,"assets");await t.autoScroll({times:3,delayMs:400});await t.wait(1);return await t.evaluate(k())}export async function extractAssetsForInput(t,r){const a=m(String(r??"")),n=await S(t,a);return p(n)}g({site:"1688",name:"assets",access:"read",description:"列出 1688 商品页可提取的图片/视频素材",domain:"www.1688.com",strategy:f.COOKIE,args:[{name:"input",required:!0,positional:!0,help:"1688 商品 URL 或 offer ID（如 887904326744）"}],columns:["offer_id","title","main_count","sku_count","detail_count","video_count"],func:async(t,r)=>{return[await extractAssetsForInput(t,String(r.input??""))]}});export const __test__={normalizeAssets:p};

package/clis/1688/auth.js

@@ -0,0 +1 @@
+import{AuthRequiredError as n,CommandExecutionError as u}from"@jackwener/opencli/errors";import{registerSiteAuthCommands as s}from"../_shared/site-auth.js";async function e(o){return(await o.getCookies({url:"https://www.1688.com"})).some((t)=>t.name==="__cn_logon__"&&t.value==="true")}async function m(o){if(!await e(o))throw new n("1688.com","1688 __cn_logon__=true cookie missing — anonymous");await o.goto("https://www.1688.com/");await o.wait(2);const r=await o.getCookies({url:"https://www.1688.com"}),t=Object.fromEntries(r.map((a)=>[a.name,a.value]));if(t.__cn_logon__!=="true")throw new n("1688.com","1688 __cn_logon__ cookie absent after navigation");const c=t.unb||"";if(!c)throw new n("1688.com","1688 unb cookie missing — partial logged-in state");let i="";try{i=t.lid?decodeURIComponent(t.lid):""}catch{i=t.lid||""}return{user_id:String(c),name:i}}s({site:"1688",domain:"1688.com",loginUrl:"https://login.1688.com/member/signin.htm",columns:["user_id","name"],quickCheck:e,verify:m,poll:async(o)=>{if(!await e(o))throw new n("1688.com","Waiting for 1688 __cn_logon__=true cookie");return m(o)}});

package/clis/1688/download.js

@@ -0,0 +1 @@
+import*as O from"node:path";import{formatCookieHeader as P}from"@jackwener/opencli/download";import{downloadMedia as Q}from"@jackwener/opencli/download/media-download";import{cli as R,Strategy as V}from"@jackwener/opencli/registry";import{cleanText as W}from"./shared.js";import{extractAssetsForInput as X}from"./assets.js";function J(B,q){try{const v=O.extname(new URL(B).pathname).toLowerCase();if(v&&v.length<=8)return v}catch{}return q}function L(B,q){const v=[],z=(E,G)=>{E.forEach((K,N)=>{v.push({type:"image",url:K,filename:`${B}_${G}_${String(N+1).padStart(2,"0")}${J(K,".jpg")}`})})};z(q.main_images,"main");z(q.sku_images,"sku");z(q.detail_images,"detail");z(q.other_images,"other");q.videos.forEach((E,G)=>{v.push({type:"video",url:E,filename:`${B}_video_${String(G+1).padStart(2,"0")}${J(E,".mp4")}`})});return v}R({site:"1688",name:"download",access:"read",description:"批量下载 1688 商品页可提取的图片和视频素材",domain:"www.1688.com",strategy:V.COOKIE,args:[{name:"input",required:!0,positional:!0,help:"1688 商品 URL 或 offer ID（如 887904326744）"},{name:"output",default:"./1688-downloads",help:"输出目录"}],columns:["index","type","status","size"],func:async(B,q)=>{const v=await X(B,String(q.input??"")),z=W(v.offer_id)||"1688",E=L(z,v),G=await B.getCookies({domain:"1688.com"});return Q(E,{output:String(q.output||"./1688-downloads"),subdir:z,cookies:P(G),browserCookies:G,filenamePrefix:z,timeout:60000})}});export const __test__={extFromUrl:J,toDownloadItems:L};

package/clis/1688/item.js

@@ -0,0 +1,21 @@
+import{CommandExecutionError as J}from"@jackwener/opencli/errors";import{cli as E,Strategy as L}from"@jackwener/opencli/registry";import{isRecord as R}from"@jackwener/opencli/utils";import{assertAuthenticatedState as z,buildDetailUrl as x,buildProvenance as $,canonicalizeSellerUrl as B,cleanMultilineText as k,cleanText as o,extractLocation as H,extractMemberId as j,extractOfferId as _,extractShopId as C,gotoAndReadState as K,normalizePriceTiers as V,parseMoqText as W,parsePriceText as Q,toNumber as F,uniqueNonEmpty as b}from"./shared.js";function h(e){const t=o(e.href),r=k(e.bodyText),n=o(e.seller?.companyName),i=o(e.seller?.winportUrl??e.seller?.sellerWinportUrlMap?.defaultUrl??e.seller?.sellerWinportUrlMap?.indexUrl),s=B(i),l=o(String(e.offerId??""))||_(t)||null,w=o(e.seller?.memberId)||j(i||t)||null,q=C(s??t),u=o(e.trade?.unit),f=o(e.trade?.priceDisplay),m=Q(f?`¥${f}`:r),U=y(r,e.trade?.beginAmount,u),d=W(U),p=G(e),D=b(p.map((c)=>o(c.serviceName))),A=v(e.trade?.offerIDatacenterSellInfo),P=V(e.trade?.offerPriceModel?.currentPrices??[],u||null),N=b([...e.gallery?.mainImage??[],...e.gallery?.offerImgList??[],...(e.gallery?.wlImageInfos??[]).map((c)=>c.fullPathImageURI??"")]),g=l?x(l):t,O=$(t||g);return{offer_id:l,member_id:w,shop_id:q,title:o(e.offerTitle)||I(e.title)||X(r)||null,item_url:g,main_images:N,price_text:m.price_text||null,price_tiers:P,currency:m.currency,moq_text:d.moq_text||null,moq_value:d.moq_value,seller_name:n||null,seller_url:s,shop_name:n||null,origin_place:H(r),delivery_days_text:S(r,p,e.shipping),customization_text:a(r,["来样定制","来图定制","支持定制","可定制","定制"]),private_label_text:a(r,["贴牌","贴标","定制logo","打logo","OEM","ODM"]),visible_attributes:A,sales_text:T(r),service_badges:D,stock_quantity:M(r),...O}}function v(e){if(!R(e))return[];return Object.entries(e).filter(([t,r])=>t!=="sellPointModel"&&o(t)&&o(String(r))).map(([t,r])=>({key:o(t),value:o(String(r))}))}function G(e){const t=[...Array.isArray(e.services)?e.services:[],...Array.isArray(e.shipping?.protectionInfos)?e.shipping.protectionInfos:[],...Array.isArray(e.shipping?.buyerProtectionModel)?e.shipping.buyerProtectionModel:[]],r=new Set,n=[];for(const i of t){const s=o(i.serviceName);if(!s||r.has(s))continue;r.add(s);n.push(i)}return n}function I(e){return o(e).replace(/\s*-\s*阿里巴巴$/,"").trim()}function X(e){return e.split(`
+`).map((t)=>o(t)).find(Boolean)??""}function y(e,t,r){const n=e.match(/\d+(?:\.\d+)?\s*(件|个|套|箱|包|双|台|把|只)\s*起批/);if(n)return n[0];const i=F(t);if(i!==null)return`${i}${r||""}起批`;return""}function S(e,t,r){const n=o(r?.deliveryLimitText)||o(r?.logisticsText);if(n)return n;const i=e.match(/\d+\s*(?:小时|天)(?:内)?发货/);if(i)return i[0];const s=t.find((l)=>typeof l.agreeDeliveryHours==="number");if(s&&typeof s.agreeDeliveryHours==="number")return`${s.agreeDeliveryHours}小时内发货`;return null}function a(e,t){const r=e.split(`
+`).map((n)=>o(n)).filter(Boolean);for(const n of r)if(t.some((i)=>n.includes(i)))return n;return null}function T(e){const t=e.match(/(?:全网销量|已售)\s*\d+(?:\.\d+)?\+?\s*[件套个单]?/);return t?o(t[0]):null}function M(e){const t=e.match(/库存\s*(\d+)/);return t?Number.parseInt(t[1],10):null}async function Y(e,t){const r=await K(e,t,2500,"item");z(r,"item");const n=await e.evaluate(`
+    (() => {
+      const root = window.context ?? {};
+      const model = root.result?.global?.globalData?.model ?? null;
+      const toJson = (value) => JSON.parse(JSON.stringify(value ?? null));
+      return {
+        href: window.location.href,
+        title: document.title || '',
+        bodyText: document.body ? document.body.innerText || '' : '',
+        offerTitle: model?.offerTitleModel?.subject ?? '',
+        offerId: model?.tradeModel?.offerId ?? '',
+        seller: toJson(model?.sellerModel),
+        trade: toJson(model?.tradeModel),
+        gallery: toJson(root.result?.data?.gallery?.fields ?? null),
+        shipping: toJson(root.result?.data?.shippingServices?.fields ?? null),
+        services: toJson(root.result?.data?.shippingServices?.fields?.protectionInfos ?? []),
+      };
+    })()
+  `);if(!(o(String(n.offerId??""))||_(o(n.href))))throw new J("1688 item page did not expose product context","当前 tab 非商品详情上下文，请切到 detail.1688.com 商品页并重试");return n}E({site:"1688",name:"item",access:"read",description:"1688 商品详情（公开商品字段、价格阶梯、卖家基础信息）",domain:"www.1688.com",strategy:L.COOKIE,navigateBefore:!1,args:[{name:"input",required:!0,positional:!0,help:"1688 商品 URL 或 offer ID（如 887904326744）"}],columns:["offer_id","title","price_text","moq_text","seller_name","origin_place"],func:async(e,t)=>{const r=x(String(t.input??"")),n=await Y(e,r);return[h(n)]}});export const __test__={normalizeItemPayload:h,normalizeVisibleAttributes:v,stripAlibabaSuffix:I,extractMoqText:y,extractDeliveryDaysText:S,extractKeywordLine:a,extractSalesText:T,extractStockQuantity:M};

package/clis/1688/search.js

@@ -0,0 +1,129 @@
+import{CommandExecutionError as g,EmptyResultError as q}from"@jackwener/opencli/errors";import{cli as b,Strategy as z}from"@jackwener/opencli/registry";import{FACTORY_BADGE_PATTERNS as C,SERVICE_BADGE_PATTERNS as E,assertAuthenticatedState as I,buildProvenance as R,buildSearchUrl as U,canonicalizeItemUrl as P,canonicalizeSellerUrl as $,cleanText as c,extractBadges as B,extractLocation as M,extractMemberId as N,extractOfferId as k,extractShopId as H,gotoAndReadState as L,parseMoqText as O,parsePriceText as D,SEARCH_LIMIT_DEFAULT as T,SEARCH_LIMIT_MAX as K,parseSearchLimit as j,uniqueNonEmpty as y}from"./shared.js";const G=["detail.1688.com/offer/","detail.m.1688.com/page/index.html?offerId="],F=12;function v(e,t){const n=P(c(e.item_url)),r=c(e.container_text),d=p([i(e.price_text),i(W(e.hover_price_text))]),o=D(d||r),f=O(p([i(e.moq_text),i(w(r))])),s=$(c(e.seller_url)),a=y([r,...e.desc_rows??[],...e.tag_items??[],...e.hover_items??[]]).join(`
+`),m=B(a,[...C,...E]),u=p([_(e.sales_text),_(r)]),h=X([...e.tag_items??[],...e.hover_items??[]]),l=R(t);return{rank:0,offer_id:k(n??"")??null,member_id:N(s??"")??null,shop_id:H(s??"")??null,title:c(e.title)||S(r)||null,item_url:n,seller_name:c(e.seller_name)||null,seller_url:s,price_text:o.price_text||null,price_min:o.price_min,price_max:o.price_max,currency:o.currency,moq_text:f.moq_text||null,moq_value:f.moq_value,location:M(r),badges:m,sales_text:u||null,return_rate_text:h,source_url:l.source_url,fetched_at:l.fetched_at,strategy:l.strategy}}function w(e){const t=i(e);return t.match(/\d+(?:\.\d+)?\s*(件|个|套|箱|包|双|台|把|只)\s*起批/i)?.[0]??t.match(/≥\s*\d+(?:\.\d+)?\s*(件|个|套|箱|包|双|台|把|只)?/i)?.[0]??t.match(/\d+(?:\.\d+)?\s*(?:~|-|至|到)\s*\d+(?:\.\d+)?\s*(件|个|套|箱|包|双|台|把|只)/i)?.[0]??""}function W(e){return i(e).match(/[¥$€]\s*\d+(?:\.\d+)?/)?.[0]??""}function _(e){const t=i(e);if(!t)return"";if(/^\d+(?:\.\d+)?\+?\s*(件|套|个|单)$/.test(t))return t;const n=t.match(/(?:已售|销量|售)\s*\d+(?:\.\d+)?\+?\s*(件|套|个|单)?/);return n?c(n[0]):""}function S(e){return e.split(/\s+/).find(Boolean)??""}function p(e){return e.map((t)=>c(t)).find(Boolean)??""}function i(e){return c(e).replace(/([¥$€])\s+(?=\d)/g,"$1").replace(/(\d)\s*\.\s*(\d)/g,"$1.$2").replace(/\s*([~-])\s*/g,"$1").trim()}function X(e){return y(e.map((t)=>i(t))).find((t)=>/^回头率\s*\d+(?:\.\d+)?%$/.test(t))??null}function A(e){if(e.offer_id)return`offer:${e.offer_id}`;if(e.item_url)return`url:${e.item_url}`;return null}async function J(e,t){const n=await L(e,t,2500,"search");I(n,"search");const r=await e.evaluate(`
+    (() => {
+      const normalizeText = (value) => (value || '').replace(/\\s+/g, ' ').trim();
+      const normalizeUrl = (href) => {
+        if (!href) return '';
+        try {
+          return new URL(href, window.location.href).toString();
+        } catch {
+          return '';
+        }
+      };
+      const isItemHref = (href) => ${JSON.stringify(G)}
+        .some((pattern) => (href || '').includes(pattern));
+      const uniqueTexts = (values) => [...new Set(values.map((value) => normalizeText(value)).filter(Boolean))];
+      const collectTexts = (root, selector) => uniqueTexts(
+        Array.from(root.querySelectorAll(selector)).map((node) => node.innerText || node.textContent || ''),
+      );
+      const firstText = (root, selectors) => {
+        for (const selector of selectors) {
+          const node = root.querySelector(selector);
+          const value = normalizeText(node ? node.innerText || node.textContent || '' : '');
+          if (value) return value;
+        }
+        return '';
+      };
+      const findMoqText = (values, priceText) => {
+        const moqPattern = /(≥\\s*\\d+(?:\\.\\d+)?\\s*(件|个|套|箱|包|双|台|把|只)?)|(\\d+(?:\\.\\d+)?\\s*(?:~|-|至|到)\\s*\\d+(?:\\.\\d+)?\\s*(件|个|套|箱|包|双|台|把|只))|(\\d+(?:\\.\\d+)?\\s*(件|个|套|箱|包|双|台|把|只)\\s*起批)/i;
+        return values.find((value) => moqPattern.test(value))
+          || normalizeText(priceText).match(moqPattern)?.[0]
+          || '';
+      };
+      const isSellerHref = (href) => {
+        if (!href) return false;
+        try {
+          const url = new URL(href, window.location.href);
+          const host = url.hostname || '';
+          if (!host.endsWith('.1688.com')) return false;
+          if (
+            host === 's.1688.com'
+            || host === 'r.1688.com'
+            || host === 'air.1688.com'
+            || host === 'detail.1688.com'
+            || host === 'detail.m.1688.com'
+            || host === 'dj.1688.com'
+          ) {
+            return false;
+          }
+          return true;
+        } catch {
+          return false;
+        }
+      };
+      const pickContainer = (anchor) => {
+        let node = anchor;
+        while (node && node !== document.body) {
+          const text = normalizeText(node.innerText || node.textContent || '');
+          if (text.length >= 40 && text.length <= 2000) {
+            return node;
+          }
+          node = node.parentElement;
+        }
+        return anchor;
+      };
+      const collectCandidates = () => {
+        const anchors = Array.from(document.querySelectorAll('a')).filter((anchor) => isItemHref(anchor.href || ''));
+        const seen = new Set();
+        const items = [];
+        for (const anchor of anchors) {
+          const href = anchor.href || '';
+          if (!href || seen.has(href)) continue;
+          seen.add(href);
+
+          const container = pickContainer(anchor);
+          const tagItems = collectTexts(container, '.offer-tag-row .offer-desc-item');
+          const hoverItems = collectTexts(container, '.offer-hover-wrapper .offer-desc-item');
+          const sellerAnchor = Array.from(container.querySelectorAll('a'))
+            .find((link) => isSellerHref(link.href || ''));
+          const hoverPriceText = firstText(container, [
+            '.offer-hover-wrapper .hover-price-item',
+            '.offer-hover-wrapper .price-item',
+          ]);
+
+          items.push({
+            item_url: href,
+            title: firstText(container, ['.offer-title-row .title-text', '.offer-title-row'])
+              || normalizeText(anchor.innerText || anchor.textContent || ''),
+            container_text: normalizeText(container.innerText || container.textContent || ''),
+            desc_rows: collectTexts(container, '.offer-desc-row'),
+            price_text: firstText(container, ['.offer-price-row .price-item']),
+            sales_text: firstText(container, ['.offer-price-row .col-desc_after', '.offer-desc-row .col-desc_after']),
+            hover_price_text: hoverPriceText,
+            moq_text: findMoqText(hoverItems, hoverPriceText),
+            tag_items: tagItems,
+            hover_items: hoverItems,
+            seller_name: sellerAnchor ? normalizeText(sellerAnchor.innerText || sellerAnchor.textContent || '') : null,
+            seller_url: sellerAnchor ? sellerAnchor.href : null,
+          });
+        }
+        return items;
+      };
+      const findNextUrl = () => {
+        const selectors = [
+          'a.fui-next:not(.disabled)',
+          'a.next-pagination-item:not(.disabled)',
+          'a[rel="next"]:not(.disabled)',
+          'a[data-role="next"]:not(.disabled)',
+        ];
+        for (const selector of selectors) {
+          const node = document.querySelector(selector);
+          if (!node) continue;
+          const href = normalizeUrl(node.getAttribute('href') || node.href || '');
+          if (href) return href;
+        }
+        const textBased = Array.from(document.querySelectorAll('a'))
+          .find((node) => /下一页|next/i.test(normalizeText(node.textContent || '')));
+        if (!textBased) return '';
+        return normalizeUrl(textBased.getAttribute('href') || textBased.href || '');
+      };
+
+      return {
+        href: window.location.href,
+        title: document.title || '',
+        bodyText: document.body ? document.body.innerText || '' : '',
+        next_url: findNextUrl(),
+        candidates: collectCandidates(),
+      };
+    })()
+  `);if(!r||typeof r!=="object")throw new g("1688 search page did not return a readable payload","Open the same query in Chrome and verify the page is fully loaded before retrying.");return r}async function Q(e,t,n){const r=new Map,d=new Set;let o=U(t),f=0;while(o&&r.size<n&&f<F){if(d.has(o))break;d.add(o);f+=1;const s=await J(e,o),a=c(s.href)||o,m=Array.isArray(s.candidates)?s.candidates:[];for(const h of m){const l=v(h,a),x=A(l);if(!x||r.has(x))continue;r.set(x,l);if(r.size>=n)break}const u=c(s.next_url);if(!u||u===a)break;o=u}if(r.size===0)throw new q("1688 search","No visible results were extracted. Retry with a different query or open the same search page in Chrome first.");return[...r.values()].slice(0,n).map((s,a)=>({...s,rank:a+1}))}b({site:"1688",name:"search",access:"read",description:"1688 商品搜索（结果候选、卖家链接、价格/MOQ/销量文本）",domain:"www.1688.com",strategy:z.COOKIE,navigateBefore:!1,args:[{name:"query",required:!0,positional:!0,help:'搜索关键词，如 "置物架"'},{name:"limit",type:"int",default:T,help:`结果数量上限（默认 ${T}，最大 ${K}）`}],columns:["rank","offer_id","title","item_url","price_text","moq_text","seller_name","member_id","location"],func:async(e,t)=>{const n=String(t.query??""),r=j(t.limit);return Q(e,n,r)}});export const __test__={normalizeSearchCandidate:v,extractMoqText:w,extractSalesText:_,firstWord:S,buildDedupeKey:A};

package/clis/1688/shared.js

@@ -0,0 +1,11 @@
+import{ArgumentError as c,AuthRequiredError as x,CommandExecutionError as _}from"@jackwener/opencli/errors";export const SITE="1688",HOME_URL="https://www.1688.com/",SEARCH_URL_PREFIX="https://s.1688.com/selloffer/offer_search.htm?charset=utf8&keywords=",DETAIL_URL_PREFIX="https://detail.1688.com/offer/",STORE_MOBILE_URL_PREFIX="https://winport.m.1688.com/page/index.html?memberId=",STRATEGY="cookie",SEARCH_LIMIT_DEFAULT=20,SEARCH_LIMIT_MAX=100;const w=new Set(["www","detail","s","winport","work","air","dj"]),g=new Set(["spm","tracelog","clickid","source","scene","from","src","ns","cna","pvid"]),b="/_____tmd_____/punish",E=["请拖动下方滑块完成验证","请按住滑块，拖动到最右边","通过验证以确保正常访问","验证码拦截","访问验证","滑动验证"],R=["请登录","登录后","账号登录","手机登录","立即登录","扫码登录","请先完成登录","请先登录后查看"],T=["/member/login","passport","login.taobao.com","account.1688.com"];export const FACTORY_BADGE_PATTERNS=["源头工厂","深度验厂","实力工厂","工厂档案","加工专区","验厂报告","厂家直销","生产厂家","工厂直供"],SERVICE_BADGE_PATTERNS=["延期必赔","品质保障","破损包赔","退货包运费","晚发必赔","7*24小时响应","48小时发货","72小时发货","后天达","包邮","闪电拿样"];const u=["北京","天津","上海","重庆","河北","山西","辽宁","吉林","黑龙江","江苏","浙江","安徽","福建","江西","山东","河南","湖北","湖南","广东","海南","四川","贵州","云南","陕西","甘肃","青海","台湾","内蒙古","广西","西藏","宁夏","新疆","香港","澳门"];export function cleanText(e){return typeof e==="string"?e.replace(/\u00a0/g," ").replace(/\s+/g," ").trim():""}export function cleanMultilineText(e){return typeof e==="string"?e.replace(/\u00a0/g," ").split(`
+`).map((t)=>t.replace(/\s+/g," ").trim()).filter(Boolean).join(`
+`):""}export function uniqueNonEmpty(e){return[...new Set(e.map((t)=>cleanText(t)).filter(Boolean))]}export function parseSearchLimit(e){const t=Number.parseInt(String(e??SEARCH_LIMIT_DEFAULT),10);if(!Number.isFinite(t)||t<1)throw new c("1688 search --limit must be a positive integer",'Example: opencli 1688 search "桌面置物架" --limit 20');return Math.min(SEARCH_LIMIT_MAX,t)}export function buildSearchUrl(e){const t=cleanText(e);if(!t)throw new c("1688 search query cannot be empty",'Example: opencli 1688 search "桌面置物架" --limit 20');return`${SEARCH_URL_PREFIX}${encodeURIComponent(t)}`}export function buildDetailUrl(e){const t=extractOfferId(e);if(!t)throw new c("1688 item expects an offer URL or offer ID","Example: opencli 1688 item 887904326744");return`${DETAIL_URL_PREFIX}${t}.html`}export function resolveStoreUrl(e){const t=cleanText(e);if(!t)throw new c("1688 store expects a store URL or member ID","Example: opencli 1688 store https://yinuoweierfushi.1688.com/");const r=extractMemberId(t);if(r)return`${STORE_MOBILE_URL_PREFIX}${r}`;if(/^https?:\/\//i.test(t))return canonicalizeStoreUrl(t);if(t.endsWith(".1688.com"))return canonicalizeStoreUrl(`https://${t}`);if(/^[a-z0-9-]+$/i.test(t))return canonicalizeStoreUrl(`https://${t}.1688.com`);throw new c("1688 store expects a store URL or member ID","Example: opencli 1688 store b2b-22154705262941f196")}export function canonicalizeStoreUrl(e){const t=m(e),r=extractMemberId(t.toString());if(r)return`${STORE_MOBILE_URL_PREFIX}${r}`;const n=a(t.hostname);if(!n)throw new c("Invalid 1688 store URL","Example: opencli 1688 store https://yinuoweierfushi.1688.com/");return`https://${n}`}export function canonicalizeItemUrl(e){const t=extractOfferId(e);if(t)return`${DETAIL_URL_PREFIX}${t}.html`;const r=f(e);if(!r)return null;h(r);r.hash="";return r.toString()}export function canonicalizeSellerUrl(e){const t=extractMemberId(e);if(t)return`${STORE_MOBILE_URL_PREFIX}${t}`;const r=f(e);if(!r)return null;const n=a(r.hostname);if(!n)return null;return`https://${n}`}export function extractOfferId(e){const t=cleanText(e);if(!t)return null;const r=t.match(/^\d{6,}$/)?.[0];if(r)return r;const n=t.match(/\/offer\/(\d{6,})\.html/i);if(n)return n[1];const o=t.match(/[?&]offerId=(\d{6,})/i);if(o)return o[1];return null}export function extractMemberId(e){const t=cleanText(e);if(!t)return null;const r=t.match(/\bb2b-[a-z0-9]+\b/i)?.[0];if(r)return r;const n=t.match(/[?&]memberId=(b2b-[a-z0-9]+)/i);if(n)return n[1];const o=t.match(/\/winport\/(b2b-[a-z0-9]+)\.html/i);if(o)return o[1];return null}export function extractShopId(e){const t=cleanText(e);if(!t)return null;try{const r=new URL(/^https?:\/\//i.test(t)?t:`https://${t}`),n=a(r.hostname);if(!n)return null;return n.split(".")[0]??null}catch{return/^[a-z0-9-]+$/i.test(t)?t:null}}export function buildProvenance(e){return{source_url:e,fetched_at:new Date().toISOString(),strategy:STRATEGY}}export function parsePriceText(e){const t=l(cleanText(e)),n=(t.match(/\d+(?:,\d{3})*(?:\.\d+)?/g)??[]).map((o)=>Number.parseFloat(o.replace(/,/g,""))).filter((o)=>Number.isFinite(o));if(n.length===0)return{price_text:t,price_min:null,price_max:null,currency:null};return{price_text:t,price_min:n[0]??null,price_max:n[n.length-1]??n[0]??null,currency:t.includes("¥")||t.includes("元")?"CNY":null}}export function normalizePriceTiers(e,t){return e.map((r)=>{const n=toNumber(r.beginAmount),o=cleanText(r.price),i=toNumber(r.price);return{quantity_text:n!==null?`${n}${t??""}`:"",quantity_min:n,price_text:o,price:i,currency:o?"CNY":null}}).filter((r)=>r.price_text)}export function parseMoqText(e){const t=l(cleanText(e)),r=t.match(/(\d+(?:\.\d+)?)\s*(件|个|套|箱|包|双|台|把|只|pcs|piece|pieces)?\s*起批/i)??t.match(/≥\s*(\d+(?:\.\d+)?)/),n=t.match(/(\d+(?:\.\d+)?)\s*(?:~|-|至|到)\s*\d+(?:\.\d+)?\s*(件|个|套|箱|包|双|台|把|只|pcs|piece|pieces)/i);if(!r&&!n)return{moq_text:t,moq_value:null};return{moq_text:t,moq_value:Number.parseFloat((r??n)[1])}}export function extractLocation(e){const t=cleanMultilineText(e),r=t.split(/送至|发往/)[0]??t,n=r.split(`
+`);for(const i of n){const s=cleanText(i);if(!s||s.length>16)continue;if(u.some((d)=>s.startsWith(d)))return s}const o=new RegExp(`(${u.join("|")})[\\u4e00-\\u9fa5]{0,8}`);return r.match(o)?.[0]??null}export function extractAddress(e){const t=cleanMultilineText(e),r=t.match(/地址[:：]\s*([^\n]+)/);if(r)return cleanText(r[1]);return t.split(`
+`).map((n)=>cleanText(n)).find((n)=>n.includes("省")||n.includes("市")||n.includes("区")||n.includes("县"))??null}export function extractMetric(e,t){const r=cleanMultilineText(e),n=r.match(new RegExp(`(?:^|\\n)\\s*${p(t)}[:：]?\\s*([^\\n]+)`));if(n)return cleanText(n[1]);const o=r.match(new RegExp(`(?:^|\\n)\\s*${p(t)}\\n([^\\n]+)`));return o?cleanText(o[1]):null}export function extractYearsOnPlatform(e){return e.match(/入驻\d+年/)?.[0]??null}export function extractMainBusiness(e){const t=extractMetric(e,"主营");return t?t.replace(/^：/,"").trim():null}export function extractBadges(e,t){return uniqueNonEmpty(t.filter((r)=>cleanMultilineText(e).includes(r)))}export function guessTopCategories(e){const t=extractMainBusiness(e);if(!t)return[];return uniqueNonEmpty(t.split(/[、,/|]/).map((r)=>r.trim()))}export function isCaptchaState(e){const t=cleanText(e.href).toLowerCase(),r=cleanText(e.title),n=cleanMultilineText(e.body_text);if(t.includes(b))return!0;return E.some((o)=>r.includes(o)||n.includes(o))}export function isLoginState(e){const t=cleanText(e.href).toLowerCase(),r=cleanText(e.title),n=cleanMultilineText(e.body_text);if(T.some((o)=>t.includes(o)))return!0;return R.some((o)=>r.includes(o)||n.includes(o))}export function buildCaptchaHint(e){return[`Open a clean 1688 ${e} page in the shared Chrome profile and finish any slider challenge first.`,"If you run opencli via CDP, set OPENCLI_CDP_TARGET=1688.com or a more specific 1688 host before retrying."].join(" ")}export async function readPageState(e){const t=await e.evaluate(`
+    (() => ({
+      href: window.location.href,
+      title: document.title || '',
+      body_text: document.body ? document.body.innerText || '' : '',
+    }))()
+  `);return{href:cleanText(t.href),title:cleanText(t.title),body_text:cleanMultilineText(t.body_text)}}export async function gotoAndReadState(e,t,r=2500,n="page"){try{await e.goto(t,{settleMs:r});await e.wait(1.5);return readPageState(e)}catch(o){const i=o instanceof Error?o.message:String(o);if(i.includes("Inspected target navigated or closed")||i.includes("Cannot find context with specified id")||i.includes("Target closed"))throw new _(`1688 ${n} navigation lost the current browser target`,`${buildCaptchaHint(n)} If CDP is attached to a stale or blocked tab, open a fresh 1688 tab and point OPENCLI_CDP_TARGET at that tab.`);throw o}}export async function ensure1688Session(e){const t=await gotoAndReadState(e,HOME_URL,1500,"homepage");assertAuthenticatedState(t,"homepage")}export function assertAuthenticatedState(e,t){if(!isCaptchaState(e)&&!isLoginState(e))return;throw new x("1688.com",`请先在共享 Chrome 完成 1688 登录/验证，再重试（${t}）`)}export function assertNotCaptcha(e,t){assertAuthenticatedState(e,t)}export function toNumber(e){if(typeof e==="number"&&Number.isFinite(e))return e;if(typeof e==="string"){const t=e.replace(/,/g,"").trim();if(!t)return null;const r=Number.parseFloat(t);return Number.isFinite(r)?r:null}return null}export function limitCandidates(e,t){const r=Math.max(1,Math.trunc(t)||1);return e.slice(0,r)}export function normalizeMediaUrl(e){const t=cleanText(e);if(!t)return"";let r=t.replace(/^url\((.*)\)$/i,"$1").replace(/^['"]|['"]$/g,"").replace(/\\u002F/g,"/").replace(/&amp;/g,"&").trim();if(!r||r.startsWith("data:")||r.startsWith("blob:"))return"";if(r.startsWith("//"))r=`https:${r}`;try{return new URL(r).toString()}catch{return""}}export function uniqueMediaSources(e){const t=new Set,r=[];for(const n of e){const o=normalizeMediaUrl(n.url);if(!o)continue;const i=`${n.type}:${o}`;if(t.has(i))continue;t.add(i);r.push({...n,url:o,source:cleanText(n.source)||void 0})}return r}function l(e){return e.replace(/([¥$€])\s+(?=\d)/g,"$1").replace(/(\d)\s*\.\s*(\d)/g,"$1.$2").replace(/\s*([~-])\s*/g,"$1").trim()}function p(e){return e.replace(/[.*+?^${}()|[\]\\]/g,"\\$&")}function m(e){const t=cleanText(e);try{const r=new URL(t);if(!r.hostname.endsWith(".1688.com")&&r.hostname!=="1688.com"&&r.hostname!=="www.1688.com")throw Error("invalid-host");h(r);r.hash="";return r}catch{throw new c("Invalid 1688 URL","Use a URL under 1688.com (for example: https://detail.1688.com/offer/887904326744.html)")}}function f(e){try{return m(e)}catch{return null}}function a(e){const t=cleanText(e).toLowerCase();if(!t.endsWith(".1688.com"))return null;const[r]=t.split(".");if(!r||w.has(r))return null;return t}function h(e){const t=[...e.searchParams.keys()];for(const r of t)if(g.has(r)||r.toLowerCase().startsWith("utm_"))e.searchParams.delete(r)}export const __test__={SEARCH_LIMIT_DEFAULT,SEARCH_LIMIT_MAX,parseSearchLimit,buildSearchUrl,buildDetailUrl,resolveStoreUrl,canonicalizeStoreUrl,canonicalizeItemUrl,canonicalizeSellerUrl,extractOfferId,extractMemberId,extractShopId,parsePriceText,normalizePriceTiers,parseMoqText,extractLocation,extractAddress,extractMetric,extractYearsOnPlatform,extractMainBusiness,extractBadges,guessTopCategories,isCaptchaState,isLoginState,cleanText,cleanMultilineText,uniqueNonEmpty,normalizeMediaUrl,uniqueMediaSources,limitCandidates};

package/clis/1688/store.js

@@ -0,0 +1,26 @@
+import{CommandExecutionError as w,EmptyResultError as z}from"@jackwener/opencli/errors";import{cli as D,Strategy as J}from"@jackwener/opencli/registry";import{FACTORY_BADGE_PATTERNS as q,SERVICE_BADGE_PATTERNS as $,assertAuthenticatedState as U,buildDetailUrl as G,buildProvenance as W,canonicalizeSellerUrl as Y,canonicalizeStoreUrl as j,cleanMultilineText as y,cleanText as n,extractAddress as S,extractBadges as v,extractMemberId as h,extractMetric as x,extractOfferId as T,extractShopId as g,extractYearsOnPlatform as F,gotoAndReadState as I,guessTopCategories as K,resolveStoreUrl as V,uniqueNonEmpty as H}from"./shared.js";function P(e){const{storePayload:t,contactPayload:r,seed:o}=e,a=y(r?.bodyText),s=y(t?.bodyText),f=y(o?.bodyText),l=[a,s,f].filter(Boolean).join(`
+`),i=n(o?.seller?.winportUrl??o?.seller?.sellerWinportUrlMap?.defaultUrl??t?.href??e.resolvedUrl),c=A(i||e.resolvedUrl)??e.resolvedUrl,u=Y(i)??c,B=Q(r?.href,c),M=n(o?.seller?.memberId)||e.explicitMemberId||h(e.resolvedUrl)||h(t?.href??"")||null,N=g(u)??g(c),_=n(o?.seller?.companyName)||b(a)||b(s)||null,O=H([...v(l,$),...(o?.services??[]).map((L)=>n(L.serviceName))]),k=v(l,q);return{member_id:M,shop_id:N,store_name:_,store_url:c,company_name:_,company_url:B,business_model_text:m(l,["经营模式","生产加工","主营产品"]),years_on_platform_text:F(l),location:S(a)??S(s),staff_size_text:m(l,["员工人数","员工总数"]),factory_badges:k,service_badges:O,response_rate_text:m(l,["响应率","回复率","响应速度"]),return_rate_text:E(l),top_categories:K(l),phone_text:x(a,"电话"),mobile_text:x(a,"手机"),...W(n(r?.href)||n(t?.href)||e.resolvedUrl)}}function A(e){try{return j(e)}catch{return null}}function Q(e,t){const r=n(e);if(r){const o=d(r);if(o)return o}return d(t)}function d(e){try{const t=new URL(e);if(!t.hostname.endsWith(".1688.com"))return null;return`${t.protocol}//${t.hostname}/page/contactinfo.html`}catch{return null}}function b(e){return e.split(`
+`).map((t)=>n(t)).find((t)=>t.includes("有限公司")||t.includes("商行")||t.includes("工厂"))??null}function m(e,t){for(const r of t){const o=x(e,r);if(o)return o}return null}function E(e){const t=e.match(/回头率\s*([0-9.]+%)/);if(t)return n(t[0]);const r=e.match(/回头率\s*\n\s*([0-9.]+%)/);if(!r)return null;return`回头率${n(r[1])}`}function p(e){for(const t of e){const r=T(t);if(r)return r}return null}function C(e){for(const t of e){const r=d(t);if(r)return r}return null}async function R(e,t,r){const o=await I(e,t,2500,r);U(o,r);return await e.evaluate(`
+    (() => ({
+      href: window.location.href,
+      title: document.title || '',
+      bodyText: document.body ? document.body.innerText || '' : '',
+      offerLinks: Array.from(document.querySelectorAll('a[href*="detail.1688.com/offer/"], a[href*="offerId="]'))
+        .map((anchor) => anchor.href)
+        .filter(Boolean),
+      contactLinks: Array.from(document.querySelectorAll('a[href*="contactinfo"]'))
+        .map((anchor) => anchor.href)
+        .filter(Boolean),
+    }))()
+  `)}async function X(e,t){const r=G(t),o=await I(e,r,2500,"store seed item");U(o,"store seed item");const a=await e.evaluate(`
+    (() => {
+      const model = window.context?.result?.global?.globalData?.model ?? null;
+      const toJson = (value) => JSON.parse(JSON.stringify(value ?? null));
+      return {
+        href: window.location.href,
+        bodyText: document.body ? document.body.innerText || '' : '',
+        seller: toJson(model?.sellerModel),
+        services: toJson(model?.shippingServices?.fields?.buyerProtectionModel ?? []),
+      };
+    })()
+  `);if(!(!!n(a?.seller?.memberId)||!!n(a?.seller?.winportUrl)))throw new w("1688 store seed item did not expose seller context","当前 tab 非商品详情上下文，请切到 detail.1688.com 商品页并重试");return a}function Z(e,t,r){return!!n(e?.bodyText)||!!n(t?.bodyText)||!!n(r?.bodyText)}D({site:"1688",name:"store",access:"read",description:"1688 店铺/供应商公开信息（联系方式、主营、入驻年限、公开服务信号）",domain:"www.1688.com",strategy:J.COOKIE,navigateBefore:!1,args:[{name:"input",required:!0,positional:!0,help:"1688 店铺 URL 或 member ID（如 b2b-22154705262941f196）"}],columns:["store_name","years_on_platform_text","location","return_rate_text"],func:async(e,t)=>{const r=String(t.input??""),o=V(r),a=h(r),s=await R(e,o,"store"),f=C(s.contactLinks??[])||d(s.href||o),l=f?await R(e,f,"store contact"):null,i=T(r)||p(s.offerLinks??[])||p(l?.offerLinks??[]);let c=null;if(i)try{c=await X(e,i)}catch(u){if(!(u instanceof w))throw u}if(!Z(s,l,c))throw new z("1688 store","Store page is reachable but no visible fields were extracted. Open the store page in Chrome and retry.");return[P({resolvedUrl:o,storePayload:s,contactPayload:l,seed:c,explicitMemberId:a})]}});export const __test__={normalizeStorePayload:P,safeCanonicalStoreUrl:A,buildContactUrl:d,firstNamedLine:b,firstMetric:m,extractReturnRate:E,firstOfferId:p,firstContactUrl:C};

package/clis/1point3acres/auth.js

@@ -0,0 +1,18 @@
+import{AuthRequiredError as i,CommandExecutionError as s}from"@jackwener/opencli/errors";import{registerSiteAuthCommands as u}from"../_shared/site-auth.js";async function o(t){const e=await t.getCookies({url:"https://www.1point3acres.com"}),a=await t.getCookies({url:"https://.1point3acres.com"});return[...e,...a].some((n)=>/_auth$/.test(n.name)&&n.value)}async function r(t){if(!await o(t))throw new i("1point3acres.com","1point3acres Discuz *_auth cookie missing");await t.goto("https://www.1point3acres.com/bbs/");await t.wait(2);const e=await t.evaluate(`
+    (() => {
+      if (/auth\\.1point3acres\\.com\\/login/.test(location.href)) {
+        return { kind: 'auth', detail: '1point3acres bbs redirected to auth login' };
+      }
+      const loginLink = document.querySelector('a[href*="auth.1point3acres.com/login"], a[href*="member.php?mod=logging&action=login"]');
+      if (loginLink && /登录/.test(loginLink.innerText || '')) {
+        return { kind: 'auth', detail: '1point3acres bbs shows 登录 link — anonymous' };
+      }
+      const nameEl = document.querySelector('#um .vwmy h4 a, a.username, .vwmy a');
+      const username = (nameEl?.innerText || '').trim();
+      const uid = (nameEl?.getAttribute('href') || '').match(/uid[=-](\\d+)/)?.[1] || '';
+      if (!uid && !username) {
+        return { kind: 'auth', detail: '1point3acres bbs rendered but no #um identity — anonymous or shape drifted' };
+      }
+      return { ok: true, user_id: uid, username };
+    })()
+  `);if(e?.kind==="auth")throw new i("1point3acres.com",e.detail);if(!e?.ok)throw new s(`Unexpected 1point3acres probe: ${JSON.stringify(e)}`);return{user_id:e.user_id,username:e.username}}u({site:"1point3acres",domain:"1point3acres.com",loginUrl:"https://auth.1point3acres.com/login",columns:["user_id","username"],quickCheck:o,verify:r,poll:async(t)=>{if(!await o(t))throw new i("1point3acres.com","Waiting for 1point3acres Discuz *_auth cookie");return r(t)}});

package/clis/1point3acres/digest.js

@@ -0,0 +1 @@
+import{cli as a,Strategy as l}from"@jackwener/opencli/registry";import{fetchHtml as m,parseThreadList as o,normalizeLimit as n,BASE as p}from"./utils.js";a({site:"1point3acres",name:"digest",access:"read",description:"一亩三分地 精华帖（编辑推荐 / 加精）",domain:"www.1point3acres.com",strategy:l.PUBLIC,browser:!1,args:[{name:"limit",type:"int",default:20,help:"返回条数（默认 20，最多 50）"}],columns:["rank","tid","title","forum","author","replies","views","lastReplyTime","url"],func:async(i)=>{const t=n(i.limit,20,50),r=await m(`${p}/forum.php?mod=guide&view=digest`);return o(r).slice(0,t).map((e,s)=>({rank:s+1,tid:e.tid,title:e.title,forum:e.forum,author:e.author,replies:e.replies,views:e.views,lastReplyTime:e.lastReplyTime,url:e.url}))}});

package/clis/1point3acres/forum.js

@@ -0,0 +1 @@
+import{cli as K,Strategy as M}from"@jackwener/opencli/registry";import{ArgumentError as G}from"@jackwener/opencli/errors";import{fetchHtml as O,parseThreadList as P,parseThreadRows as Q,normalizeLimit as U,BASE as V}from"./utils.js";K({site:"1point3acres",name:"forum",access:"read",description:"浏览一亩三分地某个版块的帖子列表（按 fid）",domain:"www.1point3acres.com",strategy:M.PUBLIC,browser:!1,args:[{name:"fid",required:!0,positional:!0,help:"版块 ID，例如 145（海外面经）、198（海外职位内推）、27（研究生申请）"},{name:"page",type:"int",default:1,help:"页码（默认 1）"},{name:"limit",type:"int",default:20,help:"返回条数（默认 20，最多 50）"}],columns:["rank","tid","kind","title","author","replies","views","lastReplyTime","url"],func:async(v)=>{const C=String(v.fid||"").trim();if(!/^\d+$/.test(C))throw new G("fid must be a numeric forum id","e.g. 145 for 海外面经");const x=Number(v.page??1);if(!Number.isInteger(x)||x<=0)throw new G("page must be a positive integer");const I=U(v.limit,20,50),D=await O(`${V}/forum-${C}-${x}.html`);if(Q(D).length===0)return[];return P(D).slice(0,I).map((q,J)=>({rank:J+1,tid:q.tid,kind:q.kind==="stickthread"?"置顶":"普通",title:q.title,author:q.author,replies:q.replies,views:q.views,lastReplyTime:q.lastReplyTime,url:q.url}))}});

package/clis/1point3acres/forums.js

@@ -0,0 +1 @@
+import{cli as K,Strategy as L}from"@jackwener/opencli/registry";import{fetchHtml as M,decodeEntities as N,BASE as F}from"./utils.js";K({site:"1point3acres",name:"forums",access:"read",description:"一亩三分地 所有版块（fid + 版块名）",domain:"www.1point3acres.com",strategy:L.PUBLIC,browser:!1,args:[{name:"filter",type:"string",default:"",help:"按版块名关键字过滤（子串匹配，中英文）"}],columns:["fid","name","url"],func:async(G)=>{const I=await M(`${F}/forum.php`),x=new Map,J=/<a href="forum-(\d+)-1\.html"[^>]*class="[^"]*overflow-hidden[^"]*"[^>]*>\s*([^<]+?)\s*<\/a>/g;let z;while(z=J.exec(I)){const v=z[1];let q=N(z[2].trim());q=q.replace(/^\[(.+)\]$/,"$1").trim();if(!q||x.has(v))continue;x.set(v,q)}const C=String(G.filter||"").toLowerCase().trim(),D=[];for(const[v,q]of x){if(C&&!q.toLowerCase().includes(C))continue;D.push({fid:v,name:q,url:`${F}/forum-${v}-1.html`})}return D}});

package/clis/1point3acres/hot.js

@@ -0,0 +1 @@
+import{cli as a,Strategy as l}from"@jackwener/opencli/registry";import{fetchHtml as m,parseThreadList as o,normalizeLimit as n,BASE as p}from"./utils.js";a({site:"1point3acres",name:"hot",access:"read",description:"一亩三分地 今日热门帖子（按热度排序，约 50 条）",domain:"www.1point3acres.com",strategy:l.PUBLIC,browser:!1,args:[{name:"limit",type:"int",default:20,help:"返回条数（默认 20，最多 50）"}],columns:["rank","tid","title","forum","author","replies","views","lastReplyTime","url"],func:async(i)=>{const t=n(i.limit,20,50),r=await m(`${p}/forum.php?mod=guide&view=hot`);return o(r).slice(0,t).map((e,s)=>({rank:s+1,tid:e.tid,title:e.title,forum:e.forum,author:e.author,replies:e.replies,views:e.views,lastReplyTime:e.lastReplyTime,url:e.url}))}});

package/clis/1point3acres/latest.js

@@ -0,0 +1 @@
+import{cli as m,Strategy as o}from"@jackwener/opencli/registry";import{fetchHtml as a,parseThreadList as l,normalizeLimit as n,BASE as p}from"./utils.js";m({site:"1point3acres",name:"latest",access:"read",description:"一亩三分地 最新发帖（按发帖时间倒序）",domain:"www.1point3acres.com",strategy:o.PUBLIC,browser:!1,args:[{name:"limit",type:"int",default:20,help:"返回条数（默认 20，最多 50）"}],columns:["rank","tid","title","forum","author","replies","views","postTime","url"],func:async(i)=>{const t=n(i.limit,20,50),r=await a(`${p}/forum.php?mod=guide&view=new`);return l(r).slice(0,t).map((e,s)=>({rank:s+1,tid:e.tid,title:e.title,forum:e.forum,author:e.author,replies:e.replies,views:e.views,postTime:e.postTime,url:e.url}))}});

package/clis/1point3acres/notifications.js

@@ -0,0 +1 @@
+import{cli as C,Strategy as D}from"@jackwener/opencli/registry";import{AuthRequiredError as I,EmptyResultError as U}from"@jackwener/opencli/errors";import{fetchHtml as z,decodeEntities as H,getCookie as P,stripHtml as f,truncate as j,normalizePositiveInteger as B,BASE as K}from"./utils.js";C({site:"1point3acres",name:"notifications",access:"read",description:"一亩三分地 站内通知（互动 / 点评 / @ 我；需要登录）",domain:"www.1point3acres.com",strategy:D.COOKIE,browser:!0,navigateBefore:!1,args:[{name:"kind",type:"string",default:"mypost",help:"通知类型：mypost（我的帖子） / interactive（互动） / system（系统） / app（应用）"},{name:"limit",type:"int",default:20,help:"返回条数"}],columns:["index","from","summary","time","threadUrl"],func:async(W,L)=>{const X=String(L.kind||"mypost").trim(),Y=await P(W),Z=`${K}/home.php?mod=space&do=notice&view=${encodeURIComponent(X)}`,x=await z(Z,{cookie:Y,headers:{Referer:`${K}/`}});if(/<title>提示信息/.test(x)&&/请登录/.test(x))throw new I("www.1point3acres.com","请先登录一亩三分地");if(/暂时没有提醒内容/.test(x))throw new U("1point3acres notifications","暂时没有提醒内容");const J=[],_=B(L.limit,20,"limit"),$=/<dl class="[^"]*cl[^"]*"[^>]*>([\s\S]*?)<\/dl>/g;let N,O=0;while((N=$.exec(x))&&J.length<_){const F=N[1],Q=H((F.match(/<dt>([\s\S]*?)<\/dt>/)||[,""])[1]).replace(/<[^>]+>/g,"").trim(),T=(F.match(/<dd class="ntc_body">([\s\S]*?)<\/dd>/)||F.match(/<dd>([\s\S]*?)<\/dd>/)||[,""])[1],V=j(f(T),200),q=((F.match(/<dd class="[^"]*xg1[^"]*"[^>]*>([\s\S]*?)<\/dd>/)||[,""])[1]||"").replace(/<[^>]+>/g,"").trim(),G=T.match(/href="([^"]*thread-\d+[^"]*)"/),v=G?G[1].startsWith("http")?G[1]:`${K}/${G[1]}`:"";O+=1;if(!Q&&!V)continue;J.push({index:O,from:Q,summary:V,time:q,threadUrl:v})}return J}});

package/clis/1point3acres/search.js

@@ -0,0 +1 @@
+import{cli as X,Strategy as Y}from"@jackwener/opencli/registry";import{ArgumentError as Z,EmptyResultError as M}from"@jackwener/opencli/errors";import{fetchHtml as _,parseSearchList as $,assertNotGuestAlert as b,getCookie as C,decodeEntities as D,normalizeLimit as G,BASE as O}from"./utils.js";X({site:"1point3acres",name:"search",access:"read",description:"一亩三分地 站内关键字搜索（需要登录）",domain:"www.1point3acres.com",strategy:Y.COOKIE,browser:!0,navigateBefore:!1,args:[{name:"query",required:!0,positional:!0,help:"搜索关键字"},{name:"limit",type:"int",default:20,help:"返回条数（默认 20，最多 50）"},{name:"fid",type:"string",default:"",help:"限定版块 ID（可选）"}],columns:["rank","tid","title","forum","author","replies","views","postTime","url"],func:async(P,x)=>{const F=String(x.query||"").trim();if(!F)throw new Z("query 不能为空");const Q=G(x.limit,20,50),J=String(x.fid||"").trim(),T=await C(P),U=new URLSearchParams({mod:"forum",srchtxt:F,searchsubmit:"yes",...J?{srchfid:J}:{}}),V=`${O}/search.php?${U.toString()}`,I=await _(V,{cookie:T,headers:{Referer:`${O}/`}});b(I);const K=$(I);if(K.length===0){const v=I.match(/<p>([^<]*?抱歉[^<]*?)<\/p>/);if(v)throw new M("1point3acres search",D(v[1].trim()));throw new M("1point3acres search",`No results for "${F}"`)}return K.slice(0,Q).map((v,W)=>({rank:W+1,tid:v.tid,title:v.title,forum:v.forum,author:v.author,replies:v.replies,views:v.views,postTime:v.postTime,url:v.url}))}});

package/clis/1point3acres/thread.js

@@ -0,0 +1,2 @@
+import{cli as B,Strategy as b}from"@jackwener/opencli/registry";import{ArgumentError as w,EmptyResultError as H}from"@jackwener/opencli/errors";import{fetchHtml as x,decodeEntities as R,stripHtml as E,truncate as k,normalizePositiveInteger as Z,BASE as j}from"./utils.js";function F(O,J,K=1){const U=O.match(J);return U?U[K]:""}B({site:"1point3acres",name:"thread",access:"read",description:"一亩三分地 帖子详情 + 楼层（主楼 + 回复）",domain:"www.1point3acres.com",strategy:b.PUBLIC,browser:!1,args:[{name:"tid",required:!0,positional:!0,help:"帖子 ID（数字，见 `hot`/`latest` 返回的 tid）"},{name:"page",type:"int",default:1,help:"楼层分页页码（默认 1）"},{name:"limit",type:"int",default:10,help:"返回楼层条数（默认 10，含主楼）"},{name:"contentLimit",type:"int",default:400,help:"每楼正文截断长度（默认 400 字符，最少 50）"}],columns:["floor","pid","author","postTime","content","url"],func:async(O)=>{const J=String(O.tid||"").trim();if(!/^\d+$/.test(J))throw new w("tid must be a numeric thread id");const K=Z(O.page,1,"page"),U=Z(O.limit,10,"limit"),z=Z(O.contentLimit,400,"contentLimit",{min:50}),A=`${j}/thread-${J}-${K}-1.html`,N=await x(A);if(!/id="postlist"/.test(N)&&!/id="post_\d+"/.test(N))throw new H("1point3acres thread",`帖子 ${J} 不存在或被删除`);const W=[],I=/<div id="post_(\d+)"[^>]*>/g,Q=[];let X;while(X=I.exec(N))Q.push({postId:X[1],offset:X.index});for(let q=0;q<Q.length;q++){const V=Q[q].offset,D=q+1<Q.length?Q[q+1].offset:N.length;W.push({postId:Q[q].postId,body:N.slice(V,D)})}const G=[];for(let q=0;q<W.length&&G.length<U;q++){const{postId:V,body:D}=W[q],_=D.match(/<div class="authi"[\s\S]*?<\/div>/),$=_?_[0]:"",P=[/<a [^>]*class="[^"]*\bxi2\b[^"]*"[^>]*>\s*([^<]+?)\s*<\/a>/,/<a [^>]*href="space-uid-\d+\.html"[^>]*>\s*([^<]+?)\s*<\/a>/,/<a [^>]*class="[^"]*\bxw1\b[^"]*"[^>]*>\s*([^<]+?)\s*<\/a>/];let C="";for(const v of P){const Y=R(F($||D,v));if(Y&&!/匿名卡|变色卡|关贴卡/.test(Y)){C=Y;break}}const M=F($,/<span title="([^"]+)">/)||F(D,/id="authorposton\d+"[^>]*>\s*<span title="([^"]+)">/)||F(D,/id="authorposton\d+"[^>]*>\s*([^<]+?)\s*</)||F(D,/<meta itemprop="datePublished" content="([^"]+)"/),L=F(D,/<em>(\d+)<\/em>\s*#?\s*<\/a>/)||F(D,/id="postnum\d+"[^>]*>\s*<em>(\d+)<\/em>/),S=L?Number(L):K===1&&q===0?1:(K-1)*10+q+1,T=D.match(/id="postmessage_\d+"[^>]*>([\s\S]*?)<\/td>/),y=k(E(T?T[1]:""),z);G.push({floor:S,pid:V,author:C,postTime:M.trim(),content:y,url:`${j}/forum.php?mod=redirect&goto=findpost&ptid=${J}&pid=${V}`})}if(K===1&&G.length>0){const q=R(F(N,/<span id="thread_subject">([^<]+)<\/span>/).trim()||F(N,/<title>([^<]+?)\s*[-|]/).trim());G[0].content=q?`【${q}】
+${G[0].content}`:G[0].content}if(!G.length)throw new H("1point3acres thread",`帖子 ${J} 第 ${K} 页没有可读取楼层`);return G}});