publishport-opencli 1.0.0

package/clis/deepseek/send.js

@@ -0,0 +1,50 @@
+import{cli as Z,Strategy as $}from"@jackwener/opencli/registry";import{CommandExecutionError as H}from"@jackwener/opencli/errors";import{DEEPSEEK_DOMAIN as h,MESSAGE_SELECTOR as F,TEXTAREA_SELECTOR as V,parseDeepSeekConversationId as G}from"./utils.js";export const sendCommand=Z({site:"deepseek",name:"send",access:"write",description:"Send a prompt to a specific DeepSeek conversation by ID, without waiting for a response",domain:h,strategy:$.COOKIE,browser:!0,siteSession:"persistent",navigateBefore:!1,args:[{name:"id",required:!0,positional:!0,help:"Conversation ID (UUID) or full /a/chat/s/<id> URL"},{name:"prompt",required:!0,positional:!0,help:"Prompt to send"},{name:"timeout",type:"int",required:!1,default:60,help:"Max seconds for the overall command (default: 60)"}],columns:["Status","InjectedText"],func:async(q,z)=>{const B=G(z.id),Q=z.prompt;await q.goto(`https://chat.deepseek.com/a/chat/s/${B}`);await J(q);if(!await q.evaluate(`(() => {
+            const box = document.querySelector('${V}');
+            if (!box) return false;
+            box.focus();
+            return document.activeElement === box;
+        })()`))throw new H("Could not focus DeepSeek textarea before native input");if(typeof q.nativeType!=="function")throw new H("Native CDP input is not available on this page object","deepseek send relies on Input.insertText; ensure the daemon and extension are up to date.");await q.nativeType(Q);await q.wait(0.6);const Y=JSON.stringify(Q),W=await q.evaluate(`(async () => {
+            const TEXTAREA = '${V}';
+            const MESSAGE = '${F}';
+            const expected = ${Y};
+            const isUser = (m) => m.className.split(/\\s+/).length > 2;
+            const box = document.querySelector(TEXTAREA);
+            if (!box) return { ok: false, reason: 'textarea not found' };
+            if ((box.value || '').trim() !== expected.trim()) {
+                return { ok: false, reason: 'native input did not populate textarea (got ' + JSON.stringify(box.value) + ')' };
+            }
+            let container = box.parentElement;
+            while (container && !container.querySelector('div[role="button"]')) {
+                container = container.parentElement;
+            }
+            const btns = container ? container.querySelectorAll('div[role="button"]:not(.ds-toggle-button)') : [];
+            const sendBtn = btns[btns.length - 1];
+            if (!sendBtn || sendBtn.querySelectorAll('svg').length === 0) {
+                return { ok: false, reason: 'send button not found' };
+            }
+            if (sendBtn.getAttribute('aria-disabled') !== 'false') {
+                return { ok: false, reason: 'send button stayed disabled after native input' };
+            }
+            sendBtn.click();
+            // Verify the prompt rendered as a user-class bubble that includes
+            // the expected text. Counting bubbles is unreliable under DeepSeek
+            // virtualization (the visible message list is windowed); a text
+            // match on any user bubble is the authoritative signal.
+            const matchesPrompt = (m) => isUser(m) && (m.innerText || '').trim().includes(expected);
+            const findUserBubble = () => Array.from(document.querySelectorAll(MESSAGE)).reverse().find(matchesPrompt);
+            let appeared = false;
+            for (let i = 0; i < 20 && !appeared; i++) {
+                await new Promise(r => setTimeout(r, 500));
+                if (findUserBubble()) appeared = true;
+            }
+            if (!appeared) return { ok: false, reason: 'prompt never rendered as a user bubble within 10s' };
+            // Settle: must still be present after 3s; an optimistic render
+            // that gets rolled back fails this check.
+            for (let i = 0; i < 3; i++) {
+                await new Promise(r => setTimeout(r, 1000));
+                if (!findUserBubble()) {
+                    return { ok: false, reason: 'prompt rendered then disappeared during the 3s settle window' };
+                }
+            }
+            return { ok: true };
+        })()`).catch((U)=>{if(String(U?.message||U).includes("Promise was collected"))return{ok:!0};throw U});if(!W?.ok)throw new H(W?.reason||"Failed to send message");return[{Status:"Success",InjectedText:Q}]}});async function J(q){const z=`(() => !!document.querySelector('${V}'))()`;for(let B=0;B<10;B++){if(await q.evaluate(z))return;await q.wait(1)}throw new H("DeepSeek textarea did not mount within 10s; the conversation page may not have loaded")}

package/clis/deepseek/status.js

@@ -0,0 +1 @@
+import{cli as a,Strategy as s}from"@jackwener/opencli/registry";import{DEEPSEEK_DOMAIN as n,ensureOnDeepSeek as r,getPageState as o}from"./utils.js";export const statusCommand=a({site:"deepseek",name:"status",access:"read",description:"Check DeepSeek page availability and login state",domain:n,strategy:s.COOKIE,browser:!0,siteSession:"persistent",navigateBefore:!1,args:[],columns:["Status","Login","Url"],func:async(t)=>{await r(t);const e=await o(t);return[{Status:e.hasTextarea?"Connected":"Page not ready",Login:e.isLoggedIn?"Yes":"No",Url:e.url}]}});

package/clis/deepseek/utils.js

@@ -0,0 +1,202 @@
+import{ArgumentError as F}from"@jackwener/opencli/errors";export const DEEPSEEK_DOMAIN="chat.deepseek.com",DEEPSEEK_URL="https://chat.deepseek.com/",TEXTAREA_SELECTOR='textarea[placeholder*="DeepSeek"]',MESSAGE_SELECTOR=".ds-message";const I=/^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}$/i;export function parseDeepSeekConversationId(q){const z=String(q??"").trim();if(!z)throw new F("id","must be a non-empty conversation ID or URL");const B=z.match(/\/a\/chat\/s\/([a-f0-9-]+)/i),Q=B?B[1]:z;if(!I.test(Q))throw new F("id",`not a valid DeepSeek conversation ID (got "${q}"); expected a UUID like "749e6bbd-6a45-4440-beaa-ae5238bf06d8" or a full /a/chat/s/<id> URL`);return Q.toLowerCase()}export async function isOnDeepSeek(q){const z=await q.evaluate("window.location.href").catch(()=>"");if(typeof z!=="string"||!z)return!1;try{const B=new URL(z).hostname;return B==="deepseek.com"||B.endsWith(".deepseek.com")}catch{return!1}}export async function ensureOnDeepSeek(q){if(await isOnDeepSeek(q))return!1;await q.goto(DEEPSEEK_URL);try{await q.wait({selector:TEXTAREA_SELECTOR,timeout:8})}catch{}return!0}export async function getPageState(q){return q.evaluate(`(() => {
+        const url = window.location.href;
+        const title = document.title;
+        const textarea = document.querySelector('${TEXTAREA_SELECTOR}');
+        const avatar = document.querySelector('img[src*="user-avatar"]');
+        return {
+            url,
+            title,
+            hasTextarea: !!textarea,
+            isLoggedIn: !!avatar,
+        };
+    })()`)}export async function selectModel(q,z){return q.evaluate(`(() => {
+        var radios = document.querySelectorAll('div[role="radio"]');
+        if (radios.length === 0) return { ok: false };
+        var name = '${z}'.toLowerCase();
+        var index = name === 'instant' ? 0 : name === 'expert' ? 1 : name === 'vision' ? 2 : -1;
+        if (index < 0 || index >= radios.length) return { ok: false };
+        var target = radios[index];
+        var alreadySelected = target.getAttribute('aria-checked') === 'true';
+        if (!alreadySelected) target.click();
+        return { ok: true, toggled: !alreadySelected };
+    })()`)}export async function setFeature(q,z,B){var Q=z==="DeepThink"?0:1;return q.evaluate(`(() => {
+        var toggles = Array.from(document.querySelectorAll('.ds-toggle-button'));
+        var btn = toggles[${Q}];
+        if (!btn) return { ok: false };
+        var isActive = btn.classList.contains('ds-toggle-button--selected');
+        if (${B} !== isActive) btn.click();
+        return { ok: true, toggled: ${B} !== isActive };
+    })()`)}export async function sendMessage(q,z){const B=JSON.stringify(z);return q.evaluate(`(async () => {
+        const box = document.querySelector('${TEXTAREA_SELECTOR}');
+        if (!box) return { ok: false, reason: 'textarea not found' };
+
+        box.focus();
+        box.value = '';
+        document.execCommand('selectAll');
+        document.execCommand('insertText', false, ${B});
+        await new Promise(r => setTimeout(r, 800));
+
+        // Find the send button: last non-toggle button in the textarea's container
+        var container = box.parentElement;
+        while (container && !container.querySelector('div[role="button"]')) {
+            container = container.parentElement;
+        }
+        if (container) {
+            var btns = container.querySelectorAll('div[role="button"]:not(.ds-toggle-button)');
+            var sendBtn = btns[btns.length - 1];
+            if (sendBtn && sendBtn.getAttribute('aria-disabled') === 'false'
+                && sendBtn.querySelectorAll('svg').length > 0) {
+                sendBtn.click();
+                return { ok: true };
+            }
+        }
+
+        box.dispatchEvent(new KeyboardEvent('keydown', { key: 'Enter', code: 'Enter', keyCode: 13, bubbles: true }));
+        return { ok: true, method: 'enter' };
+    })()`)}export async function getBubbleCount(q){return await q.evaluate(`(() => {
+        return document.querySelectorAll('${MESSAGE_SELECTOR}').length;
+    })()`)||0}export function parseThinkingResponse(q){if(!q)return null;const z=q.match(/^(Thought for ([\d.]+) seconds?|已思考（用时 ([\d.]+) 秒）)\s*/);if(!z)return{response:q,thinking:null,thinking_time:null};const B=z[2]||z[3];return{response:"",thinking:q.slice(z[0].length).trim(),thinking_time:B}}export async function waitForResponse(q,z,B,Q,Z=!1){const Y=Date.now();let $="",J=0;while(Date.now()-Y<Q){await q.wait(3);let W;try{W=await q.evaluate(`(() => {
+                const bubbles = document.querySelectorAll('${MESSAGE_SELECTOR}');
+                const texts = Array.from(bubbles).map(b => (b.innerText || '').trim()).filter(Boolean);
+                var last = texts[texts.length - 1] || '';
+
+                // DOM-level thinking/response separation.
+                // DeepSeek renders thinking in a collapsible container with a
+                // distinct class (e.g. .ds-markdown--think or similar) and the
+                // final answer in the main .ds-markdown region.  By querying
+                // these separately we avoid any text-heuristic split.
+                var thinkEl = null, answerEl = null, thinkTime = null;
+                if (${Z} && bubbles.length > 0) {
+                    var lastBubble = bubbles[bubbles.length - 1];
+                    // Thinking container — DeepSeek uses various class names;
+                    // try common selectors.
+                    thinkEl = lastBubble.querySelector('.ds-markdown--think')
+                           || lastBubble.querySelector('[class*="think"]');
+                    // Final answer container — the main markdown block that is
+                    // NOT the thinking section.
+                    var markdownEls = lastBubble.querySelectorAll('.ds-markdown');
+                    for (var i = 0; i < markdownEls.length; i++) {
+                        if (markdownEls[i] !== thinkEl
+                            && !(thinkEl && thinkEl.contains(markdownEls[i]))
+                            && !markdownEls[i].classList.contains('ds-markdown--think')) {
+                            answerEl = markdownEls[i];
+                        }
+                    }
+                    // Thinking time from the toggle/header element
+                    var timeEl = lastBubble.querySelector('[class*="think"] ~ *')
+                              || lastBubble.querySelector('.ds-thinking-header');
+                    if (!timeEl) {
+                        // Fallback: parse from raw text header
+                        var m = last.match(/^(?:Thought for ([\\d.]+) seconds?|已思考（用时 ([\\d.]+) 秒）)/);
+                        if (m) thinkTime = m[1] || m[2];
+                    } else {
+                        var tm = (timeEl.textContent || '').match(/([\\d.]+)/);
+                        if (tm) thinkTime = tm[1];
+                    }
+                }
+
+                return {
+                    count: texts.length,
+                    last: last,
+                    // DOM-separated fields (null when not available)
+                    thinkText: thinkEl ? (thinkEl.innerText || '').trim() : null,
+                    answerText: answerEl ? (answerEl.innerText || '').trim() : null,
+                    thinkTime: thinkTime,
+                };
+            })()`)}catch{continue}if(!W)continue;const j=W.last;if(j&&W.count>z&&j!==B.trim()){if(j===$){J++;if(J>=3){if(Z){if(W.thinkText!=null||W.answerText!=null)return{thinking:W.thinkText||"",response:W.answerText||"",thinking_time:W.thinkTime||null};return parseThinkingResponse(j)}return j}}else J=0;$=j}}if(Z&&$)return parseThinkingResponse($);return $||null}export async function getVisibleMessages(q){const z=await q.evaluate(`(() => {
+        const msgs = document.querySelectorAll('${MESSAGE_SELECTOR}');
+        return Array.from(msgs).map(m => {
+            // User messages carry an extra hash-class alongside ds-message
+            const isUser = m.className.split(/\\s+/).length > 2;
+            return {
+                Role: isUser ? 'user' : 'assistant',
+                Text: (m.innerText || '').trim(),
+            };
+        }).filter(m => m.Text);
+    })()`);return Array.isArray(z)?z:[]}export async function getConversationList(q){await ensureOnDeepSeek(q);await q.evaluate(`(() => {
+        if (document.querySelectorAll('a[href*="/a/chat/s/"]').length === 0) {
+            const btn = document.querySelector('div[tabindex="0"][role="button"]');
+            if (btn) btn.click();
+        }
+    })()`);for(let z=0;z<5;z++){await q.wait(2);const B=await q.evaluate(`(() => {
+            const items = [];
+            const links = document.querySelectorAll('a[href*="/a/chat/s/"]');
+            links.forEach((link, i) => {
+                const title = (link.innerText || '').trim().split('\\n')[0].trim();
+                const href = link.getAttribute('href') || '';
+                const idMatch = href.match(/\\/s\\/([a-f0-9-]+)/);
+                items.push({
+                    Index: i + 1,
+                    Id: idMatch ? idMatch[1] : href,
+                    Title: title || '(untitled)',
+                    Url: 'https://chat.deepseek.com' + href,
+                });
+            });
+            return items;
+        })()`);if(Array.isArray(B)&&B.length>0)return B}return[]}export async function pickResumeUrl(q){await q.evaluate(`(() => {
+        if (document.querySelectorAll('a[href*="/a/chat/s/"]').length === 0) {
+            const btn = document.querySelector('div[tabindex="0"][role="button"]');
+            if (btn) btn.click();
+        }
+    })()`);for(let z=0;z<5;z++){await q.wait(2);const B=await q.evaluate(`(() => {
+            const links = document.querySelectorAll('a[href*="/a/chat/s/"]');
+            if (links.length === 0) return null;
+            const PINNED_HEADER = /^\\s*(置\\s*顶|Pinned)\\s*$/i;
+            const isPinned = (link) => {
+                const section = link.parentElement;
+                const header = section && section.firstElementChild;
+                if (!header || header === link) return false;
+                return PINNED_HEADER.test((header.innerText || header.textContent || '').trim());
+            };
+            const target = Array.from(links).find((l) => !isPinned(l)) || links[0];
+            const href = target.getAttribute('href') || '';
+            return href ? 'https://chat.deepseek.com' + href : null;
+        })()`);if(B)return B}return null}async function G(q,z){for(let B=0;B<8;B++){await q.wait(2);if(await q.evaluate(`(() => {
+            var name = ${JSON.stringify(z)};
+            var hasFileName = Array.from(document.querySelectorAll('div'))
+                .some(function(el) { return el.children.length === 0 && (el.textContent || '').trim() === name; });
+            if (hasFileName) return true;
+            // Vision mode shows an image thumbnail, not filename text. Require
+            // a preview-like node here; send-button readiness is checked later.
+            var box = document.querySelector('${TEXTAREA_SELECTOR}');
+            if (!box) return false;
+            var c = box.parentElement;
+            while (c && !c.querySelector('div[role="button"]')) c = c.parentElement;
+            if (!c) return false;
+            return !!c.querySelector('img[src], canvas, video, [style*="background-image"], [class*="preview"], [class*="upload"]');
+        })()`))return!0}return!1}export async function sendWithFile(q,z,B){const Q=await import("node:fs"),Z=await import("node:path"),Y=Z.default.resolve(z);if(!Q.default.existsSync(Y))return{ok:!1,reason:`File not found: ${Y}`};const $=Q.default.statSync(Y);if($.size>104857600)return{ok:!1,reason:`File too large (${($.size/1024/1024).toFixed(1)} MB). Max: 100 MB`};const J=Z.default.basename(Y);await q.evaluate(`(() => {
+        if (document.querySelectorAll('a[href*="/a/chat/s/"]').length > 0) {
+            const btn = document.querySelector('div[tabindex="0"][role="button"]');
+            if (btn) btn.click();
+        }
+    })()`);await q.wait(0.5);let W=!1;if(q.setFileInput)try{await q.setFileInput([Y],'input[type="file"]');W=!0}catch(y){const K=String(y?.message||y);if(!K.includes("Unknown action")&&!K.includes("not supported")&&!K.includes("Not allowed"))throw y}if(!W){const K=Q.default.readFileSync(Y).toString("base64"),U=await q.evaluate(`(async () => {
+            var binary = atob('${K}');
+            var bytes = new Uint8Array(binary.length);
+            for (var i = 0; i < binary.length; i++) bytes[i] = binary.charCodeAt(i);
+
+            var file = new File([bytes], ${JSON.stringify(J)});
+            var dt = new DataTransfer();
+            dt.items.add(file);
+
+            var inp = document.querySelector('input[type="file"]');
+            if (!inp) return { ok: false, reason: 'file input not found' };
+
+            var propsKey = Object.keys(inp).find(function(k) { return k.startsWith('__reactProps$'); });
+            if (!propsKey || typeof inp[propsKey].onChange !== 'function') {
+                return { ok: false, reason: 'React onChange not found' };
+            }
+
+            inp.files = dt.files;
+            // Use inp.files, not dt.files; assignment transfers ownership
+            inp[propsKey].onChange({ target: { files: inp.files } });
+            return { ok: true };
+        })()`);if(U&&!U.ok)return U}if(!await G(q,J))return{ok:!1,reason:"file preview did not appear"};let V=!1;for(let y=0;y<15;y++){if(await q.evaluate(`(() => {
+            var box = document.querySelector('${TEXTAREA_SELECTOR}');
+            if (!box) return false;
+            var c = box.parentElement;
+            while (c && !c.querySelector('div[role="button"]')) c = c.parentElement;
+            if (!c) return false;
+            var btns = c.querySelectorAll('div[role="button"]:not(.ds-toggle-button)');
+            var last = btns[btns.length - 1];
+            return !!(last && last.getAttribute('aria-disabled') === 'false');
+        })()`)){V=!0;break}await q.wait(1)}if(!V)return{ok:!1,reason:"send button did not enable after upload"};return sendMessage(q,B)}export async function withRetry(q,z=2){for(let B=0;B<=z;B++)try{return await q()}catch(Q){const Z=String(Q?.message||Q);if(B<z&&Z.includes("Promise was collected")){await new Promise((Y)=>setTimeout(Y,2000));continue}throw Q}}export function parseBoolFlag(q){if(typeof q==="boolean")return q;return String(q??"").trim().toLowerCase()==="true"}

package/clis/defillama/protocol.js

@@ -0,0 +1 @@
+import{cli as b,Strategy as f}from"@jackwener/opencli/registry";import{EmptyResultError as q}from"@jackwener/opencli/errors";import{LLAMA_BASE as U,llamaFetch as V,requireSlug as R,unixToDate as W}from"./utils.js";b({site:"defillama",name:"protocol",access:"read",description:"Single DefiLlama protocol details (current TVL, mcap, chains, twitter, github, description)",domain:"defillama.com",strategy:f.PUBLIC,browser:!1,args:[{name:"slug",positional:!0,type:"string",required:!0,help:'DefiLlama protocol slug (e.g. "aave", "lido")'}],columns:["slug","name","category","isParent","tvl","tvlAt","mcap","chains","twitter","github","audits","listedAt","description","website","url"],func:async(X)=>{const G=R(X.slug,"slug"),z=await V(`${U}/protocol/${encodeURIComponent(G)}`,`defillama protocol ${G}`);if(!z||!z.name)throw new q("defillama protocol",`DefiLlama returned no metadata for "${G}".`);const J=Array.isArray(z.tvl)?z.tvl:[],I=J.length?J[J.length-1]:null,Y=I&&Number.isFinite(Number(I.totalLiquidityUSD))?Number(I.totalLiquidityUSD):null,Z=I?W(I.date):null,O=z.isParentProtocol===!0;let Q="";const K=new Set(Array.isArray(z.chains)?z.chains:[]),N=await V(`${U}/protocols`,`defillama protocol ${G} list lookup`);if(Array.isArray(N)){if(!O){const C=N.find((H)=>H&&H.slug===G);if(C&&typeof C.category==="string")Q=C.category;if(C&&Array.isArray(C.chains))for(const H of C.chains)K.add(H)}else for(const C of N)if(C&&C.parentProtocol===z.id&&Array.isArray(C.chains))for(const H of C.chains)K.add(H)}const $=Array.isArray(z.github)?z.github:[];return[{slug:G,name:String(z.name).trim(),category:Q,isParent:O,tvl:Y,tvlAt:Z,mcap:z.mcap==null?null:Number(z.mcap),chains:[...K].join(", "),twitter:String(z.twitter??"").trim(),github:$.join(", "),audits:String(z.audits??"").trim(),listedAt:W(z.listedAt),description:String(z.description??"").trim(),website:String(z.url??"").trim(),url:`https://defillama.com/protocol/${G}`}]}});

package/clis/defillama/protocols.js

@@ -0,0 +1 @@
+import{cli as s,Strategy as c}from"@jackwener/opencli/registry";import{EmptyResultError as l}from"@jackwener/opencli/errors";import{LLAMA_BASE as m,llamaFetch as u,requireBoundedInt as d,unixToDate as g}from"./utils.js";s({site:"defillama",name:"protocols",access:"read",description:"Top DeFi protocols on DefiLlama by current TVL (slug, name, category, TVL, mcap, change_1d/7d, chains)",domain:"defillama.com",strategy:c.PUBLIC,browser:!1,args:[{name:"limit",type:"int",default:30,help:"Number of rows to return (1-500)"}],columns:["rank","slug","name","category","tvl","mcap","change_1d","change_7d","chains","listedAt","url"],func:async(n)=>{const i=d(n.limit,30,500,"limit"),t=await u(`${m}/protocols`,"defillama protocols");if(!Array.isArray(t)||t.length===0)throw new l("defillama protocols","DefiLlama returned no protocol entries.");const o=t.filter((e)=>e&&(e.slug||e.name)&&Number.isFinite(Number(e.tvl))).sort((e,r)=>Number(r.tvl)-Number(e.tvl)).slice(0,i);if(o.length===0)throw new l("defillama protocols","DefiLlama returned no protocols with numeric TVL.");return o.map((e,r)=>{const a=String(e.slug??"").trim();return{rank:r+1,slug:a,name:String(e.name??"").trim(),category:String(e.category??"").trim(),tvl:Number(e.tvl),mcap:e.mcap==null?null:Number(e.mcap),change_1d:e.change_1d==null?null:Number(e.change_1d),change_7d:e.change_7d==null?null:Number(e.change_7d),chains:Array.isArray(e.chains)?e.chains.join(", "):"",listedAt:g(e.listedAt),url:a?`https://defillama.com/protocol/${a}`:""}})}});

package/clis/defillama/utils.js

@@ -0,0 +1 @@
+import{ArgumentError as H,CommandExecutionError as I,EmptyResultError as K}from"@jackwener/opencli/errors";export const LLAMA_BASE="https://api.llama.fi";const M="opencli-defillama-adapter (+https://github.com/jackwener/opencli)",N=/^[a-z0-9][a-z0-9._-]{0,99}$/;export function requireString(B,q){const z=String(B??"").trim();if(!z)throw new H(`defillama ${q} cannot be empty`);return z}export function requireSlug(B,q="slug"){const z=String(B??"").trim();if(!z)throw new H(`defillama ${q} is required (e.g. "aave", "lido")`,"Use the protocol slug as it appears on https://defillama.com/protocol/<slug>.");if(!N.test(z))throw new H(`defillama ${q} "${B}" is not a valid DefiLlama slug`,'Slugs are lowercase ASCII (letters / digits / "._-"), e.g. "aave", "lido", "pancakeswap-amm".');return z}export function requireBoundedInt(B,q,z,F="limit"){const D=B??q,J=typeof D==="number"?D:Number(D);if(!Number.isInteger(J)||J<=0)throw new H(`defillama ${F} must be a positive integer`);if(J>z)throw new H(`defillama ${F} must be <= ${z}`);return J}export async function llamaFetch(B,q){let z;try{z=await fetch(B,{headers:{"user-agent":M,accept:"application/json"}})}catch(D){throw new I(`${q} request failed: ${D?.message??D}`,"Check that api.llama.fi is reachable from this network.")}if(z.status===404)throw new K(q,`DefiLlama returned 404 for ${B}.`);if(z.status===400){const D=await z.text().catch(()=>"");if(/not\s*found/i.test(D))throw new K(q,`DefiLlama: ${D.trim()||"not found"}.`);throw new I(`${q} returned HTTP 400: ${D.slice(0,200)}`)}if(z.status===429)throw new I(`${q} returned HTTP 429 (rate limited)`,"DefiLlama throttles unauthenticated traffic; wait a few seconds and retry.");if(!z.ok)throw new I(`${q} returned HTTP ${z.status}`);let F;try{F=await z.json()}catch(D){throw new I(`${q} returned malformed JSON: ${D?.message??D}`)}return F}export function unixToDate(B){if(B==null)return null;const q=typeof B==="number"?B:Number(B);if(!Number.isFinite(q)||q<=0)return null;const z=q>1000000000000?q:q*1000,F=new Date(z);if(Number.isNaN(F.getTime()))return null;return F.toISOString().slice(0,10)}

package/clis/devto/auth.js

@@ -0,0 +1,9 @@
+import{AuthRequiredError as B}from"@jackwener/opencli/errors";import{registerSiteAuthCommands as J}from"../_shared/site-auth.js";const F="https://dev.to";async function G(x){return(await x.getCookies({url:F})).some((z)=>z.name==="remember_user_token"&&z.value)}async function I(x){await x.goto(F);const f=await x.evaluate(`(() => {
+    try {
+      var du = document.body && document.body.getAttribute('data-user');
+      if (!du) return { ok: false, reason: 'no data-user' };
+      var u = JSON.parse(du);
+      if (!u || u.id == null) return { ok: false, reason: 'anonymous' };
+      return { ok: true, id: String(u.id), username: String(u.username || ''), name: String(u.name || '') };
+    } catch (e) { return { ok: false, reason: String(e && e.message || e) }; }
+  })()`);if(!f||!f.ok)throw new B("dev.to",`Not logged in (${f?f.reason:"no probe"})`);return{user_id:f.id,username:f.username,name:f.name}}J({site:"devto",domain:"dev.to",loginUrl:"https://dev.to/enter",columns:["user_id","username","name"],loginDescription:"打开 dev.to 登录页并等待浏览器完成登录（供桌面客户端引导登录）。",quickCheck:G,verify:I,poll:async(x)=>{if(!await G(x))throw new B("dev.to","Waiting for dev.to session cookie");return I(x)}});

package/clis/devto/latest.js

@@ -0,0 +1 @@
+import{cli as p,Strategy as m}from"@jackwener/opencli/registry";import{ArgumentError as c,CommandExecutionError as i,EmptyResultError as g}from"@jackwener/opencli/errors";function u(a,n,r){const s=a??n,e=typeof s==="number"?s:Number(s);if(!Number.isInteger(e)||e<=0)throw new c("devto limit must be a positive integer");if(e>r)throw new c(`devto limit must be <= ${r}`);return e}p({site:"devto",name:"latest",access:"read",description:"Newest dev.to articles (firehose, all tags)",domain:"dev.to",strategy:m.PUBLIC,browser:!1,args:[{name:"limit",type:"int",default:20,help:"Articles per page (1-100)"},{name:"page",type:"int",default:1,help:"Page number (1-based)"}],columns:["rank","id","title","author","tags","reactions","comments","published","url"],func:async(a)=>{const n=u(a.limit,20,100),r=u(a.page,1,1000),s=`https://dev.to/api/articles/latest?per_page=${n}&page=${r}`;let e;try{e=await fetch(s,{headers:{accept:"application/json"}})}catch(t){throw new i(`devto latest request failed: ${t?.message??t}`,"Check that dev.to is reachable from this network.")}if(!e.ok)throw new i(`devto latest returned HTTP ${e.status}`);let o;try{o=await e.json()}catch(t){throw new i(`devto latest returned malformed JSON: ${t?.message??t}`)}const l=Array.isArray(o)?o:[];if(!l.length)throw new g("devto latest",`dev.to /articles/latest returned no items at page ${r}.`);return l.map((t,d)=>({rank:(r-1)*n+d+1,id:t.id!=null?String(t.id):"",title:String(t.title??""),author:String(t?.user?.username??""),tags:String(t.tag_list??"").replace(/,\s*/g,", "),reactions:t.public_reactions_count!=null?Number(t.public_reactions_count):null,comments:t.comments_count!=null?Number(t.comments_count):null,published:String(t.published_at??"").slice(0,10),url:String(t.url??"")}))}});

package/clis/devto/publish.js

@@ -0,0 +1,17 @@
+import*as V from"node:fs";import{cli as q,Strategy as B}from"@jackwener/opencli/registry";import{ArgumentError as K,AuthRequiredError as U,CommandExecutionError as O}from"@jackwener/opencli/errors";import{assertLiteralContent as v}from"../_shared/content-guard.js";const W=4;export function resolveBody(z){if(z["body-file"]){const D=String(z["body-file"]);if(!V.statSync(D,{throwIfNoEntry:!1})?.isFile())throw new K(`--body-file not found: ${D}`);return V.readFileSync(D,"utf8")}if(z.body!==void 0&&z.body!==null){v(String(z.body),{fileFlag:"--body-file"});return String(z.body)}return}export function resolveTagList(z){if(z===void 0||z===null||z==="")return;const D=String(z).split(",").map((F)=>F.trim().toLowerCase()).filter(Boolean);if(D.length>W)throw new K(`Too many tags: ${D.length} (DEV.to max ${W})`);for(const F of D)if(!/^[a-z0-9]+$/.test(F))throw new K(`Invalid tag "${F}". DEV.to tags must be lowercase alphanumeric (no spaces/punctuation).`);return D.join(", ")}export function buildArticle(z,D,F){const H={};if(z.title!==void 0)H.title=String(z.title);if(D!==void 0)H.body_markdown=D;if(z.published!==void 0)H.published=!!z.published;if(F!==void 0)H.tag_list=F;if(z["cover-image"])H.main_image=String(z["cover-image"]);if(z["canonical-url"])H.canonical_url=String(z["canonical-url"]);if(z.series)H.series=String(z.series);if(z.description)H.description=String(z.description);return H}q({site:"devto",name:"publish",access:"write",description:"Publish or update a DEV.to article (markdown). Draft by default; pass --published to go live.",domain:"dev.to",strategy:B.COOKIE,browser:!0,args:[{name:"title",type:"string",required:!1,help:"Article title (required for new articles)"},{name:"body",type:"string",required:!1,help:"Article body in Markdown (or use --body-file)"},{name:"body-file",type:"string",required:!1,help:"Path to a Markdown file for the body"},{name:"published",type:"boolean",required:!1,default:!1,help:"Publish live now (default: save as draft)"},{name:"tags",type:"string",required:!1,help:"Comma-separated tags, max 4, lowercase alphanumeric"},{name:"cover-image",type:"string",required:!1,help:"Cover image URL (main_image)"},{name:"canonical-url",type:"string",required:!1,help:"Canonical URL (original source)"},{name:"series",type:"string",required:!1,help:"Series name to group articles"},{name:"description",type:"string",required:!1,help:"Social/SEO description"},{name:"id",type:"string",required:!1,help:"Existing article id to update (PUT instead of POST)"}],columns:["status","id","url","published","slug"],func:async(z,D)=>{if(!z)throw new O("Browser session required for devto publish");const F=D.id?String(D.id).trim():"",H=resolveBody(D),Y=resolveTagList(D.tags);if(!F&&!D.title)throw new K("--title is required when creating a new article");if(!F&&H===void 0)throw new K("--body or --body-file is required when creating a new article");const P=buildArticle(D,H,Y),Z=F?"PUT":"POST",$=F?`/articles/${encodeURIComponent(F)}`:"/articles";await z.goto("https://dev.to/");const I=await z.evaluate(`(async () => {
+      try {
+        var csrf = (document.querySelector('meta[name="csrf-token"]') || {}).content || window.csrfToken;
+        if (!csrf) return { kind: 'auth', detail: 'no csrf-token meta — not logged in?' };
+        var r = await fetch(${JSON.stringify($)}, {
+          method: ${JSON.stringify(Z)},
+          credentials: 'include',
+          headers: { 'Accept': 'application/json', 'Content-Type': 'application/json', 'X-CSRF-Token': csrf },
+          body: JSON.stringify({ article: ${JSON.stringify(P)} }),
+        });
+        var text = await r.text();
+        var data = null; try { data = JSON.parse(text); } catch (e) {}
+        if (r.status === 401 || r.status === 403) return { kind: 'auth', detail: 'HTTP ' + r.status };
+        if (!r.ok) return { kind: 'http', status: r.status, detail: text.slice(0, 300) };
+        return { kind: 'ok', data: data };
+      } catch (e) { return { kind: 'exception', detail: String(e && e.message || e) }; }
+    })()`);if(I?.kind==="auth")throw new U("dev.to",`Not logged in (${I.detail}). Run \`opencli devto login\`.`);if(I?.kind==="http")throw new O(`dev.to publish failed: HTTP ${I.status} ${I.detail}`);if(I?.kind==="exception")throw new O(`dev.to publish error: ${I.detail}`);if(I?.kind!=="ok"||!I.data)throw new O(`Unexpected dev.to response: ${JSON.stringify(I)}`);const J=I.data,Q=!!P.published;let N="";if(J.current_state_path)try{N=new URL(J.current_state_path,"https://dev.to").href}catch(G){N=String(J.current_state_path)}else if(J.url)N=String(J.url);return[{status:F?"updated":"created",id:J.id??"",url:Q?N:"",published:Q,slug:J.slug??""}]}});

package/clis/devto/read.js

@@ -0,0 +1,3 @@
+import{cli as Z,Strategy as $}from"@jackwener/opencli/registry";import{ArgumentError as U,CommandExecutionError as K,EmptyResultError as W}from"@jackwener/opencli/errors";const f="https://dev.to/api/articles";async function z(G){let H;try{H=await fetch(`${f}/${G}`)}catch(J){const F=J instanceof Error?J.message:String(J);throw new K(`DEV.to API request failed for article ${G}`,F)}if(H.status===404)throw new W(`devto/${G}`,"Article not found");if(!H.ok)throw new K(`DEV.to API HTTP ${H.status} for article ${G}`,"Check the article id");try{return await H.json()}catch{throw new K(`DEV.to API returned invalid JSON for article ${G}`,"Retry later or open the article URL directly")}}function D(G,H,J){const F=typeof G==="number"?G:Number(G);if(!Number.isInteger(F)||F<H)throw new U(`${J} must be an integer >= ${H}`);return F}function M(G,H){if(typeof G.body_markdown==="string"&&G.body_markdown.trim())return G.body_markdown;throw new K(`DEV.to article ${H} did not include body_markdown`,"DEV.to API response shape may have changed. Open the article URL directly or retry later.")}Z({site:"devto",name:"read",access:"read",description:"Read a DEV.to article body by id",domain:"dev.to",strategy:$.PUBLIC,browser:!1,args:[{name:"id",required:!0,positional:!0,help:"DEV.to article id (numeric, e.g. 3605688)"},{name:"max-length",type:"int",default:20000,help:"Max characters of body to return (min 100)"}],columns:["id","title","author","reactions","reading_time","tags","published_at","body","url"],func:async(G)=>{const H=String(G.id||"").trim();if(!/^\d+$/.test(H))throw new U(`Invalid DEV.to article id: ${G.id}`,"Pass a numeric id like 3605688");const J=D(G["max-length"]??20000,100,"devto read --max-length"),F=await z(H);if(!F||!F.id)throw new W(`devto/${H}`,"Article not found");const P=M(F,H),X=P.length>J?P.slice(0,J)+`
+
+... [truncated]`:P,Q=F.tag_list??F.tags??"",Y=Array.isArray(Q)?Q.join(", "):String(Q);return[{id:F.id,title:F.title||"",author:F.user?.username||"[deleted]",reactions:F.public_reactions_count??0,reading_time:F.reading_time_minutes??0,tags:Y,published_at:F.published_at||"",body:X,url:F.url||""}]}});

package/clis/devto/stats.js

@@ -0,0 +1,27 @@
+import{cli as C,Strategy as F}from"@jackwener/opencli/registry";import{EmptyResultError as G}from"@jackwener/opencli/errors";const I="https://dev.to/dashboard";C({site:"devto",name:"stats",access:"read",description:"dev.to 文章数据（每篇浏览/反应/评论等运营指标，含草稿）。首次调用要拉起浏览器会话、偏慢，客户端超时属正常，重试一次即可",domain:"dev.to",strategy:F.COOKIE,browser:!0,navigateBefore:!1,args:[{name:"limit",type:"number",default:20,help:"返回条数"}],columns:["id","type","title","url","published_at","views","likes","comments","collects","shares","tags","read_time","extra"],func:async(h,x)=>{const z=Math.max(1,Number(x.limit)||20);await h.goto(I);const f=await h.evaluate(`(async () => {
+      try {
+        if (!location.href.includes('dev.to')) {
+          return { error: '未登录 dev.to（页面被重定向到 ' + location.href + '），请先在 Chrome 里登录 dev.to' };
+        }
+        const limit = ${JSON.stringify(z)};
+        const items = [];
+        for (let pageNo = 1; items.length < limit && pageNo <= 50; pageNo++) {
+          const per = Math.min(100, limit - items.length + 1);
+          const resp = await fetch('/api/articles/me/all?per_page=' + per + '&page=' + pageNo, {
+            credentials: 'include',
+            headers: { accept: 'application/json' },
+          });
+          if (resp.status === 401) return { error: '未登录 dev.to：请先在 Chrome 里登录 dev.to 再运行 devto stats' };
+          if (!resp.ok) return { error: 'dev.to 接口 HTTP ' + resp.status + '（/api/articles/me/all 第 ' + pageNo + ' 页）' };
+          const batch = await resp.json();
+          if (!Array.isArray(batch) || batch.length === 0) break;
+          items.push(...batch);
+          if (batch.length < per) break;
+        }
+        // body_markdown 是全文、体积巨大，出页面前先剔掉
+        for (const it of items) { delete it.body_markdown; delete it.user; }
+        return { items: items.slice(0, limit) };
+      } catch (e) {
+        return { error: String((e && e.message) || e) };
+      }
+    })()`);if(!f||f.error)throw Error(f?.error||"devto stats：evaluate 无返回（浏览器会话异常）");const q=Array.isArray(f.items)?f.items:[];if(q.length===0)throw new G("devto stats","该 dev.to 账号没有任何文章（含草稿）。");return q.map((b)=>({id:String(b.id??""),type:"article",title:b.title||"",url:b.url||"",published_at:b.published_at||"",views:b.page_views_count??0,likes:b.public_reactions_count??0,comments:b.comments_count??0,collects:"",shares:"",tags:Array.isArray(b.tag_list)?b.tag_list.join("|"):String(b.tag_list||""),read_time:b.reading_time_minutes?`${b.reading_time_minutes}min`:"",extra:JSON.stringify({published:b.published??null,positive_reactions:b.positive_reactions_count??null,description:b.description||"",cover_image:b.cover_image||"",canonical_url:b.canonical_url||""})}))}});

package/clis/devto/tag.js

@@ -0,0 +1 @@
+import{cli as t,Strategy as e}from"@jackwener/opencli/registry";t({site:"devto",name:"tag",access:"read",description:"Latest DEV.to articles for a specific tag",domain:"dev.to",strategy:e.PUBLIC,browser:!1,args:[{name:"tag",required:!0,positional:!0,help:"Tag name (e.g. javascript, python, webdev)"},{name:"limit",type:"int",default:20,help:"Number of articles"}],columns:["rank","id","title","author","reactions","comments","reading_time","published_at","tags","url"],pipeline:[{fetch:{url:"https://dev.to/api/articles?tag=${{ args.tag }}&per_page=${{ args.limit }}"}},{map:{rank:"${{ index + 1 }}",id:"${{ item.id }}",title:"${{ item.title }}",author:"${{ item.user.username }}",reactions:"${{ item.public_reactions_count }}",comments:"${{ item.comments_count }}",reading_time:"${{ item.reading_time_minutes }}",published_at:"${{ item.published_at }}",tags:"${{ item.tag_list | join(', ') }}",url:"${{ item.url }}"}},{limit:"${{ args.limit }}"}]});

package/clis/devto/top.js

@@ -0,0 +1 @@
+import{cli as t,Strategy as e}from"@jackwener/opencli/registry";t({site:"devto",name:"top",access:"read",description:"Top DEV.to articles of the day",domain:"dev.to",strategy:e.PUBLIC,browser:!1,args:[{name:"limit",type:"int",default:20,help:"Number of articles"}],columns:["rank","id","title","author","reactions","comments","reading_time","published_at","tags","url"],pipeline:[{fetch:{url:"https://dev.to/api/articles?top=1&per_page=${{ args.limit }}"}},{map:{rank:"${{ index + 1 }}",id:"${{ item.id }}",title:"${{ item.title }}",author:"${{ item.user.username }}",reactions:"${{ item.public_reactions_count }}",comments:"${{ item.comments_count }}",reading_time:"${{ item.reading_time_minutes }}",published_at:"${{ item.published_at }}",tags:"${{ item.tag_list | join(', ') }}",url:"${{ item.url }}"}},{limit:"${{ args.limit }}"}]});

package/clis/devto/user.js

@@ -0,0 +1 @@
+import{cli as e,Strategy as t}from"@jackwener/opencli/registry";e({site:"devto",name:"user",access:"read",description:"Recent DEV.to articles from a specific user",domain:"dev.to",strategy:t.PUBLIC,browser:!1,args:[{name:"username",required:!0,positional:!0,help:"DEV.to username (e.g. ben, thepracticaldev)"},{name:"limit",type:"int",default:20,help:"Number of articles"}],columns:["rank","id","title","reactions","comments","reading_time","published_at","tags","url"],pipeline:[{fetch:{url:"https://dev.to/api/articles?username=${{ args.username }}&per_page=${{ args.limit }}"}},{map:{rank:"${{ index + 1 }}",id:"${{ item.id }}",title:"${{ item.title }}",reactions:"${{ item.public_reactions_count }}",comments:"${{ item.comments_count }}",reading_time:"${{ item.reading_time_minutes }}",published_at:"${{ item.published_at }}",tags:"${{ item.tag_list | join(', ') }}",url:"${{ item.url }}"}},{limit:"${{ args.limit }}"}]});

package/clis/dianping/__fixtures__/search.html

@@ -0,0 +1,168 @@
+<!DOCTYPE html><html class="trancy-und"><head>
+    <title>北京火锅相关搜索结果推荐-大众点评网</title>
+</head>
+<body>
+    <div class="section Fix J-shop-search">
+        <div class="content-wrap">
+            <div class="shop-wrap">
+                <div class="content">
+<div class="shop-list J_shop-list shop-all-list" id="shop-all-list">
+  <ul>
+  <li class="">
+    <div class="pic">
+      <a href="https://www.dianping.com/shop/H20FrTRI6kbXbgTu" data-shopid="H20FrTRI6kbXbgTu" title="">
+        <img title="芈重山老火锅(五道口店)" alt="芈重山老火锅(五道口店)" src="placeholder.png">
+      </a>
+    </div>
+    <div class="txt">
+      <div class="tit">
+        <a data-shopid="H20FrTRI6kbXbgTu" title="芈重山老火锅(五道口店)" href="https://www.dianping.com/shop/H20FrTRI6kbXbgTu">
+            <h4>芈重山老火锅(五道口店)</h4>
+        </a>
+        <div class="promo-icon J_promo_icon">
+              <a href="https://www.dianping.com/shop/H20FrTRI6kbXbgTu#promo=0" title="" class="ipromote icon-only" data-shopid="H20FrTRI6kbXbgTu"></a>
+        </div>
+      </div>
+      <div class="comment">
+        <div class="nebula_star">
+          <div class="star_icon">
+              <span class="star star_50 star_sml"></span>
+              <span class="star star_50 star_sml"></span>
+              <span class="star star_50 star_sml"></span>
+              <span class="star star_50 star_sml"></span>
+              <span class="star star_50 star_sml"></span>
+          </div>
+        </div>
+          <a href="https://www.dianping.com/shop/H20FrTRI6kbXbgTu#comment" class="review-num" data-shopid="H20FrTRI6kbXbgTu">
+              <b>21231</b>
+条评价</a>
+        <em class="sep">|</em>
+        <a href="https://www.dianping.com/shop/H20FrTRI6kbXbgTu" class="mean-price" data-shopid="H20FrTRI6kbXbgTu">
+            人均
+            <b>￥109</b>
+        </a>
+      </div>
+      <div class="tag-addr">
+        <a href="https://www.dianping.com/beijing/ch10/g32733" data-shopid="H20FrTRI6kbXbgTu"><span class="tag">重庆火锅</span></a>
+        <em class="sep">|</em>
+        <a href="https://www.dianping.com/beijing/ch0/r1489" data-shopid="H20FrTRI6kbXbgTu"><span class="tag">五道口</span></a>
+      </div>
+    </div>
+      <div class="svr-info">
+              <a href="https://www.dianping.com/shop/H20FrTRI6kbXbgTu#promo=0" title="" data-shopid="H20FrTRI6kbXbgTu" class="tuan ">
+                <span class="tit">优惠：</span>此餐馆有优惠券
+              </a>
+      </div>
+    <div class="operate J_operate Hide">
+      <a href="javascript:void(0);" title="" class="o-nearby J_o-nearby" data-shopid="H20FrTRI6kbXbgTu">附近</a>
+    </div>
+    </li>
+  <li class="">
+    <div class="pic">
+      <a href="https://www.dianping.com/shop/H6uJDRHtNUreCoBa" data-shopid="H6uJDRHtNUreCoBa" title="">
+        <img title="百年前门铜锅涮肉(前门总店)" alt="百年前门铜锅涮肉(前门总店)" src="placeholder.png">
+      </a>
+    </div>
+    <div class="txt">
+      <div class="tit">
+        <a data-shopid="H6uJDRHtNUreCoBa" title="百年前门铜锅涮肉(前门总店)" href="https://www.dianping.com/shop/H6uJDRHtNUreCoBa">
+            <h4>百年前门铜锅涮肉(前门总店)</h4>
+        </a>
+        <div class="promo-icon J_promo_icon">
+              <a data-shopid="H6uJDRHtNUreCoBa" href="http://t.dianping.com/deal/671044080" title="百年前门铜锅涮肉!【春季新品】拔草必点超值 2-3人餐✨13店通用" class="igroup">
+              </a>
+              <a href="https://www.dianping.com/shop/H6uJDRHtNUreCoBa#promo=0" title="" class="ipromote icon-only" data-shopid="H6uJDRHtNUreCoBa"></a>
+        </div>
+      </div>
+      <div class="comment">
+        <div class="nebula_star">
+          <div class="star_icon">
+              <span class="star star_45 star_sml"></span>
+              <span class="star star_45 star_sml"></span>
+              <span class="star star_45 star_sml"></span>
+              <span class="star star_45 star_sml"></span>
+              <span class="star star_45 star_sml"></span>
+          </div>
+        </div>
+          <a href="https://www.dianping.com/shop/H6uJDRHtNUreCoBa#comment" class="review-num" data-shopid="H6uJDRHtNUreCoBa">
+              <b>15649</b>
+条评价</a>
+        <em class="sep">|</em>
+        <a href="https://www.dianping.com/shop/H6uJDRHtNUreCoBa" class="mean-price" data-shopid="H6uJDRHtNUreCoBa">
+            人均
+            <b>￥81</b>
+        </a>
+      </div>
+      <div class="tag-addr">
+        <a href="https://www.dianping.com/beijing/ch10/g34277" data-shopid="H6uJDRHtNUreCoBa"><span class="tag">老北京火锅</span></a>
+        <em class="sep">|</em>
+        <a href="https://www.dianping.com/beijing/ch0/r1503" data-shopid="H6uJDRHtNUreCoBa"><span class="tag">前门/大栅栏</span></a>
+      </div>
+    </div>
+      <div class="svr-info">
+              <a href="https://www.dianping.com/shop/H6uJDRHtNUreCoBa#promo=0" title="" data-shopid="H6uJDRHtNUreCoBa" class="tuan privilege">
+                <span class="tit">优惠：</span>此餐馆有优惠券
+              </a>
+      </div>
+    <div class="operate J_operate Hide">
+      <a href="javascript:void(0);" title="" class="o-nearby J_o-nearby" data-shopid="H6uJDRHtNUreCoBa">附近</a>
+    </div>
+    </li>
+  <li class="">
+    <div class="pic">
+      <a href="https://www.dianping.com/shop/H7gQoQ1L5p7CoUEs" data-shopid="H7gQoQ1L5p7CoUEs" title="">
+        <img title="东来顺饭庄(前门大街店)" alt="东来顺饭庄(前门大街店)" src="placeholder.png">
+      </a>
+    </div>
+    <div class="txt">
+      <div class="tit">
+        <a data-shopid="H7gQoQ1L5p7CoUEs" title="东来顺饭庄(前门大街店)" href="https://www.dianping.com/shop/H7gQoQ1L5p7CoUEs">
+            <h4>东来顺饭庄(前门大街店)</h4>
+        </a>
+        <div class="promo-icon J_promo_icon">
+              <a data-shopid="H7gQoQ1L5p7CoUEs" href="http://t.dianping.com/deal/788879631" title="东来顺饭庄!仅售95元！价值100元的代金券1张，全场通用，可叠加使用10张，可免费使用包间。" class="igroup">
+              </a>
+              <a href="https://www.dianping.com/shop/H7gQoQ1L5p7CoUEs#promo=0" title="" class="ipromote icon-only" data-shopid="H7gQoQ1L5p7CoUEs"></a>
+        </div>
+      </div>
+      <div class="comment">
+        <div class="nebula_star">
+          <div class="star_icon">
+              <span class="star star_50 star_sml"></span>
+              <span class="star star_50 star_sml"></span>
+              <span class="star star_50 star_sml"></span>
+              <span class="star star_50 star_sml"></span>
+              <span class="star star_50 star_sml"></span>
+          </div>
+        </div>
+          <a href="https://www.dianping.com/shop/H7gQoQ1L5p7CoUEs#comment" class="review-num" data-shopid="H7gQoQ1L5p7CoUEs">
+              <b>21537</b>
+条评价</a>
+        <em class="sep">|</em>
+        <a href="https://www.dianping.com/shop/H7gQoQ1L5p7CoUEs" class="mean-price" data-shopid="H7gQoQ1L5p7CoUEs">
+            人均
+            <b>￥124</b>
+        </a>
+      </div>
+      <div class="tag-addr">
+        <a href="https://www.dianping.com/beijing/ch10/g34277" data-shopid="H7gQoQ1L5p7CoUEs"><span class="tag">老北京火锅</span></a>
+        <em class="sep">|</em>
+        <a href="https://www.dianping.com/beijing/ch0/r1503" data-shopid="H7gQoQ1L5p7CoUEs"><span class="tag">前门/大栅栏</span></a>
+      </div>
+    </div>
+      <div class="svr-info">
+              <a href="https://www.dianping.com/shop/H7gQoQ1L5p7CoUEs#promo=0" title="" data-shopid="H7gQoQ1L5p7CoUEs" class="tuan privilege">
+                <span class="tit">优惠：</span>此餐馆有优惠券
+              </a>
+      </div>
+    <div class="operate J_operate Hide">
+      <a href="javascript:void(0);" title="" class="o-nearby J_o-nearby" data-shopid="H7gQoQ1L5p7CoUEs">附近</a>
+    </div>
+    </li>
+  </ul>
+</div>
+                </div>
+            </div>
+        </div>
+    </div>
+</body></html>

package/clis/dianping/__fixtures__/shop.html

@@ -0,0 +1,6 @@
+<!DOCTYPE html><html class="trancy-und"><head>
+  <title>【芈重山老火锅(五道口店)】电话_地址_价格_营业时间_五道口重庆火锅团购 - [undefined] - 大众点评网</title>
+</head>
+<body>
+<div id="cocktail-root" class="cocktail-root"><div id="shop-head" class="shop-head shop-head-pc wx-view"><div id="pc-shop-head" class="wx-view"><div class="pc-shopInfo wx-view"><div class="leftPanel wx-view"><span class="shopName wx-text">芈重山老火锅(五道口店)</span><div class="smallPanel iconPanelPc wx-view"><div class="component-star"><div class="star-container star-50 wx-view"><div class="light wx-view">★</div><div class="light wx-view">★</div><div class="light wx-view">★</div><div class="light wx-view">★</div><div class="light wx-view">★</div><div class="star-score score-50 wx-view">4.8</div></div></div><div class="smallPanel wx-view"><span class="reviews wx-text">21241条</span><span class="price wx-text">¥109/人</span></div></div><div class="bottomPanel wx-view"><div class="wx-view"><span class="region wx-text">五道口</span><span class="category wx-text">重庆火锅</span></div></div><div class="middlePanel no-float wx-view"><span class="scoreText wx-text">口味:4.8 环境:4.8 服务:4.8 食材:4.9 </span></div><div class="rankPanel wx-view"><div class="rank-left wx-view"><img src="placeholder.png" class="rank-icon"><div class="rank-text wx-view">海淀区重庆火锅口味榜 · 第1名</div></div><div class="rank-right wx-view"><div class="rank-entry wx-view"></div></div></div><div class="shop-info wx-view"><div class="shopinfo wx-view"><div class="shopinf-wrap wx-view"><div class="key-services retina-boder-top  wx-view"><div class="left-service wx-view"><div class="biz-title  wx-view"><span class="biz-txt wx-text">营业中</span><span class="biz-time wx-text">11:00-次日02:00</span></div><div class="shop-tag-title wx-view"><div class="shop-feature wx-view"><span class="feature-txt wx-text">有包厢</span></div><div class="shop-feature wx-view"><span class="feature-txt wx-text">有大桌</span></div><div class="shop-feature wx-view"><span class="feature-txt wx-text">付费停车</span></div></div></div><div class="wx-view"><div class="entry wx-view"></div></div></div></div></div></div><div class="wx-view"><div id="shop-map" class="shopmap wx-view"><div class="shopmap-wrap wx-view"><div class="desc-content wx-view"><div class="desc-left wx-view"><div class="desc-info wx-view"><div class="iconAddress wx-view"></div><span class="addressText wx-text"> 成府路35号东源大厦2层东侧</span></div><div class="desc-addr wx-view"><span class="desc-addr-txt wx-text">距地铁13号线五道口站A北口步行90m</span></div></div><div class="desc-right wx-view"><div class="desc-car wx-view"><span class="tips wx-text">到店</span></div><div class="desc-phone wx-view"></div></div></div></div></div></div></div><div class="rightPanel wx-view"><img src="placeholder.png" class="shopPic fetchImgStart fecthImgEnd"><div class="picCount wx-view">7万+</div></div></div></div></div><div class="component-review-list-v2" id="review-list-new-pc"><div class="review-list-container wx-view"><div class="component-review-header"><div class="review-header wx-view"><div class="review-title wx-view"><span class="count-text wx-text">评价(21241)</span><span class="tip-text wx-text">1小时前有新增评价</span></div></div></div></div></div></div>
+</body></html>

package/clis/dianping/auth.js

@@ -0,0 +1,10 @@
+import{AuthRequiredError as F,CommandExecutionError as K}from"@jackwener/opencli/errors";import{registerSiteAuthCommands as L}from"../_shared/site-auth.js";async function H(z){return(await z.getCookies({url:"https://www.dianping.com"})).some((B)=>B.name==="dper"&&B.value)}async function J(z){if(!await H(z))throw new F("dianping.com","Dianping dper cookie missing");await z.goto("https://www.dianping.com/citylist");await z.wait(2);const G=await z.evaluate("location.href");if(/account\.dianping\.com\/(pc)?login/.test(String(G||"")))throw new F("dianping.com",`Dianping page redirected to login: ${G}`);const B=await z.evaluate(`
+    (() => {
+      const trigger = document.querySelector('.userinfo-container .J-user-trigger, .userinfo-container a.username');
+      if (!trigger) return { loggedOut: true };
+      const nickname = (trigger.textContent || '').trim();
+      const href = trigger.getAttribute('href') || '';
+      const uid = (String(href).match(/\\/member\\/(\\d+)/) || [])[1] || '';
+      return { user_id: uid, nickname };
+    })()
+  `);if(B?.loggedOut)throw new F("dianping.com","Dianping session anonymous — no logged-in user trigger in top nav");if(!B?.user_id)throw new K("Dianping user trigger found but no /member/<id> href — layout drift");return{user_id:String(B.user_id),nickname:String(B.nickname||"")}}L({site:"dianping",domain:"dianping.com",loginUrl:"https://account.dianping.com/pclogin",columns:["user_id","nickname"],quickCheck:H,verify:J,poll:async(z)=>{if(!await H(z))throw new F("dianping.com","Waiting for Dianping dper cookie");return J(z)}});

package/clis/dianping/cityResolver.js

@@ -0,0 +1,4 @@
+import{ArgumentError as B,CommandExecutionError as J}from"@jackwener/opencli/errors";import{CITY_ID as b,resolveCityId as j}from"./utils.js";const $=/^[一-龥]+$/,F=/^[a-z]+$/,Z=new Map;export function clearCityResolverCache(){Z.clear()}export async function resolveCityIdAsync(z,G){if(G==null||G==="")return null;const q=String(G).trim();if(!q)return null;if(/^\d+$/.test(q))return Number(q);const W=q.toLowerCase();try{const Q=j(q);if(Q!=null)return Q}catch(Q){if(Q?.code!=="ARGUMENT")throw Q}if(Z.has(W))return Z.get(W);if(Z.has(q))return Z.get(q);let K=null;if(F.test(W))K=W;else if($.test(q)){K=await T(z,q);if(!K){const Q=Object.keys(b).filter((X)=>/^[a-z]+$/.test(X)).join(", ");throw new B("city",`unknown city '${G}'. pass a numeric cityId, a pinyin slug (e.g. shantou), a Chinese name listed on dianping.com/citylist, or one of: ${Q}`)}}else{const Q=Object.keys(b).filter((X)=>/^[a-z]+$/.test(X)).join(", ");throw new B("city",`unknown city '${G}'. pass a numeric cityId, a pinyin slug (e.g. shantou), a Chinese name listed on dianping.com/citylist, or one of: ${Q}`)}const U=await v(z,K);if(!U)throw new J(`dianping could not resolve cityId for '${G}' (pinyin=${K}); the city page rendered without a /search/keyword/{id}/ link`);Z.set(W,U);Z.set(K,U);if($.test(q))Z.set(q,U);return U}export async function resolveDefaultCityId(z){await z.goto("https://www.dianping.com/");await z.wait(1);const G=await z.evaluate(`(() => {
+        const el = document.querySelector('.city-select-text, .city-select-content');
+        return el ? (el.textContent || '').trim() : '';
+    })()`);if(!G||!$.test(G))return null;return resolveCityIdAsync(z,G)}async function T(z,G){await z.goto("https://www.dianping.com/citylist");const q=await z.evaluate(`(${buildCitylistMap.toString()})()`);if(!q||typeof q!=="object"||Object.keys(q).length===0)throw new J("dianping citylist did not render any city anchors; cannot resolve Chinese city names");if(q&&typeof q==="object"&&q[G])return String(q[G]).toLowerCase();return null}export function buildCitylistMap(){const z={};document.querySelectorAll("a").forEach((q)=>{const W=q.getAttribute("href")||"",K=(q.textContent||"").trim();if(!K||!/^[一-龥]+$/.test(K))return;const U=W.replace(/^https?:/,""),Q=U.match(/^\/\/(?:www\.)?dianping\.com\/([a-z]+)\/?$/)||U.match(/^\/([a-z]+)\/?$/);if(!Q)return;const X=Q[1].toLowerCase();if(X==="citylist"||X==="promo"||X==="events")return;if(!z[K])z[K]=X});return z}async function v(z,G){await z.goto(`https://www.dianping.com/${G}`);const q=await z.evaluate(`(${extractCityIdFromPage.toString()})()`);return Number.isInteger(q)&&q>0?q:null}export function extractCityIdFromPage(){const z=typeof location<"u"&&location.href||"https://www.dianping.com/",G=document.querySelectorAll("a[href]");for(const q of G){const W=q.getAttribute("href")||"";let K;try{K=new URL(W,z)}catch{continue}if(K.protocol!=="https:")continue;if(K.hostname!=="www.dianping.com"&&K.hostname!=="dianping.com")continue;const U=K.pathname.match(/^\/search\/keyword\/(\d+)(?:\/|$)/);if(!U)continue;const Q=Number(U[1]);if(Number.isInteger(Q)&&Q>0)return Q}return null}