{"id":"00f58694-2752-47b5-af90-9d3577731186","entityType":"agent","slug":"clawhub-mzoob-g1geo","name":"g1geo","canonicalUrl":"https://www.xpersona.co/agent/clawhub-mzoob-g1geo","canonicalPath":"/agent/clawhub-mzoob-g1geo","generatedAt":"2026-10-09T18:13:24.462Z","source":"CLAWHUB","claimStatus":"UNCLAIMED","verificationTier":"NONE","summary":{"evidence":{"source":"editorial-content","verified":true,"confidence":"high","updatedAt":"2026-10-09T12:50:00.612Z","emptyReason":null},"description":"极义GEO — 生成式搜索引擎优化平台。监控品牌在 DeepSeek、Kimi、通义千问、豆包、文心、腾讯元宝等 AI 搜索中的可见度、提及率、推荐与排名，支持竞品对比和批量诊断；生成 GEO 问题与文章，提供 AI 改写、文章裂变、企业知识与素材管理、报告和趋势跟踪，并分发至 抖音/小红书/知乎等11+ 自媒体平台或 GEO 媒体。适用于 GEO 优化、品牌 AI 搜索表现分析、内容生成与多平台发布。用户提到极义GEO、G1GEO、g1geo、AI生成优化或要求执行 g1geo 命令时使用，也应用于GEO文章生成，内容分发等场景。执行命令前先加载与已安装 CLI 版本匹配的指南。 Skill: g1geo Owner: mzoob Summary: 极义GEO — 生成式搜索引擎优化平台。监控品牌在 DeepSeek、Kimi、通义千问、豆包、文心、腾讯元宝等 AI 搜索中的可见度、提及率、推荐与排名，支持竞品对比和批量诊断；生成 GEO 问题与文章，提供 AI 改写、文章裂变、企业知识与素材管理、报告和趋势跟踪，并分发至 抖音/小红书/知乎等11+ 自媒体平台或 GEO 媒体。适用于 GEO 优化、品牌 AI 搜索表现分析、内容生成与多平台发布。用户提到极义GEO、G1GEO、g1geo、AI生成优化或要求执行 g1geo 命令时使用，也应用于GEO文章生成，内容分发等场景。执行命令前先加载与已安装 CLI 版本匹配的指南。 Tags: latest:1.1.0 Version history: v1.1.0 | 2026-07-23T06:53:55.136Z | user - Migrated SK","descriptionLabel":"Technical summary","evidenceSummary":"Capability contract not published. No trust telemetry is available yet. 2.6K downloads reported by the source. Last updated 10/9/2026.","installCommand":"clawhub skill install s172s1km0rk8w53q877abtx9yh83ghee:g1geo","sourceUrl":"https://clawhub.ai/mzoob/g1geo","homepage":"https://clawhub.ai/mzoob/skills/g1geo","primaryLinks":[{"label":"View on ClawHub","url":"https://clawhub.ai/mzoob/g1geo","kind":"source"},{"label":"Homepage","url":"https://clawhub.ai/mzoob/skills/g1geo","kind":"homepage"}],"safetyScore":84,"overallRank":62,"popularityScore":68,"trustScore":null,"claimedByName":null,"isOwner":false,"seoDescription":"极义GEO — 生成式搜索引擎优化平台。监控品牌在 DeepSeek、Kimi、通义千问、豆包、文心、腾讯元宝等 AI 搜索中的可见度、提及率、推荐与排名，支持竞品对比和批量诊断；生成 GEO 问题与文章，提供 AI 改写、文章裂变、企业知识与素材管理、报告和趋势跟踪，并分发至 抖音/小红书/知乎等11+ 自媒体平台或"},"coverage":{"evidence":{"source":"public-profile","verified":false,"confidence":"medium","updatedAt":"2026-10-09T12:50:00.612Z","emptyReason":null},"protocols":[{"protocol":"OPENCLEW","label":"OpenClaw","status":"self-declared","notes":"Declared in the public agent profile."}],"capabilities":[],"verifiedCount":0,"selfDeclaredCount":1,"capabilityMatrix":{"rows":[{"key":"OPENCLEW","type":"protocol","support":"unknown","confidenceSource":"profile","notes":"Listed on profile"}],"flattenedTokens":"protocol:OPENCLEW|unknown|profile"}},"adoption":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-09T12:50:00.612Z","emptyReason":null},"stars":null,"forks":null,"downloads":2618,"packageName":null,"latestVersion":"1.1.0","tractionLabel":"2.6K downloads"},"release":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-09T12:50:00.580Z","emptyReason":null},"lastUpdatedAt":"2026-10-09T12:50:00.612Z","lastCrawledAt":"2026-10-09T12:50:00.580Z","lastIndexedAt":null,"nextCrawlAt":"2026-10-10T12:50:00.580Z","lastVerifiedAt":null,"highlights":[{"version":"1.1.0","createdAt":"2026-07-23T06:53:55.136Z","changelog":"- Migrated SKILL.md and documentation content to Chinese, reflecting localization for Chinese-speaking users. - No changes to core functionality; CLI usage patterns, supported features, and guidance remain as before. - Removed the sample documentation file skill-card.md.","fileCount":3,"zipByteSize":4520},{"version":"1.0.9","createdAt":"2026-07-22T10:48:26.267Z","changelog":"- Major update: Switches to the official g1geo CLI skill, removing legacy Python scripts, sample docs, and earlier product description. - Removes now-obsolete files: cli reference, workflow guide, configuration, main script, and skill card. - Skill is retitled, rebranded, and now mandates the @g1geo/cli as the sole execution interface. - Outlines feature overview and step-by-step operational rules to always defer to the installed CLI's own Guide. - Strongly prohibits fallback to legacy scripts, internal APIs, direct curl, or unverified commands. - Reinforces proper context passing (e.g., never guessing product IDs) and corrects all business logic to follow live CLI contracts.","fileCount":3,"zipByteSize":3956},{"version":"1.0.8","createdAt":"2026-03-28T07:49:48.057Z","changelog":"- Refined the workflow for company info填写：新增“公司信息一次性完整填写”要求，详细列出必填/选填字段及填写策略，强调不能编造。 - 明确 company save 必须一次性补全全部必填项，优先用用户对话、网络搜索及用户提问补足资料。 - 修改 company save 命令用法示例，展示所有必填参数填写格式。 - 强化数据依赖链，突出公司资料完整性对后续内容生成的影响。 - 仅增加了缓存目录 pyc 文件，没有代码变更。","fileCount":7,"zipByteSize":24317},{"version":"1.0.7","createdAt":"2026-03-26T11:46:40.778Z","changelog":"jike-geo 1.0.7 - 新增 scripts/config.json 和 scripts/geo.py，统一脚本配置与核心逻辑入口。 - 移除旧的 scripts copy/config.json 和 scripts copy/geo.py，精简冗余文件。 - 完善与简化文档：合并和优化 SKILL.md，删除旧版流程说明，强调新版草稿生成流程及完整内容输出要求。 - 路由和依赖链梳理为更清晰的新版主线，删除过时操作与参数说明。 - 全面要求在生成问题草稿、搜索、文章等输出时，逐条完整展示原始内容，不再只用摘要或数量代替。","fileCount":6,"zipByteSize":20392},{"version":"1.0.6","createdAt":"2026-03-26T11:30:14.005Z","changelog":"- Switched script directory from scripts/ to scripts copy/ for config.json and geo.py - Updated SKILL.md: - Introduced a new recommended workflow using drafts generate for L1-L4问题草稿，不依赖关键词模块 - Added routes and example usage for drafts（草稿）和 gallery（图片素材库）管理 - Clarified新版 vs 旧版问题生成链路 - Expanded routing table and workflow guide to reflect new 草稿和图片管理功能","fileCount":6,"zipByteSize":20583},{"version":"1.0.5","createdAt":"2026-03-19T11:45:57.081Z","changelog":"No user-facing changes detected in version 1.0.5. This release contains no modifications to the skill files.","fileCount":6,"zipByteSize":16816},{"version":"1.0.4","createdAt":"2026-03-19T11:43:16.971Z","changelog":"- 新增命令参数速查表文档 references/cli-reference.md，便于快速查找 CLI 用法。 - SKILL.md 强调命令参数速查表，并在 routing table 中补充了 sentiment 指令。 - description 进一步明确面向场景覆盖，描述更丰富。 - 其他功能无更改；兼容性与行为保持不变。","fileCount":6,"zipByteSize":16819},{"version":"1.0.3","createdAt":"2026-03-17T10:00:29.856Z","changelog":"jike-geo 1.0.3 Changelog - Improved data dependency management: strict workflow from \"product create\" to \"questions generate\", with clear handling when dependencies fail. - Enhanced error handling: specified different responses for authentication failures, API rate limits, and quota shortages; limited API retries to one. - Enforced product isolation: each product has a separate data store; prevents using other product IDs for operations. - API Key setup instructions updated, including a visual guide link for users. - Prohibited workarounds such as reading script source code or reusing failed data; alternative suggestions provided on failure. - Updated documentation to clarify error messages, user guidance, and fallback scenarios.","fileCount":5,"zipByteSize":12958}]},"execution":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No published capability contract is available yet."},"installCommand":"clawhub skill install s172s1km0rk8w53q877abtx9yh83ghee:g1geo","setupComplexity":"low","setupSteps":["Setup complexity is classified as HIGH. You must provision dedicated cloud infrastructure or an isolated VM. Do not run this directly on your local workstation.","Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data."],"contract":{"contractStatus":"missing","authModes":[],"requires":[],"forbidden":[],"supportsMcp":false,"supportsA2a":false,"supportsStreaming":false,"inputSchemaRef":null,"outputSchemaRef":null,"dataRegion":null,"contractUpdatedAt":null,"sourceUpdatedAt":null,"freshnessSeconds":null},"invocationGuide":{"preferredApi":{"snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-mzoob-g1geo/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-mzoob-g1geo/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-mzoob-g1geo/trust"},"curlExamples":["curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-mzoob-g1geo/snapshot\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-mzoob-g1geo/contract\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-mzoob-g1geo/trust\""],"jsonRequestTemplate":{"query":"summarize this repo","constraints":{"maxLatencyMs":2000,"protocolPreference":["OPENCLEW"]}},"jsonResponseTemplate":{"ok":true,"result":{"summary":"...","confidence":0.9},"meta":{"source":"CLAWHUB","generatedAt":"2026-10-09T18:13:24.459Z"}},"retryPolicy":{"maxAttempts":3,"backoffMs":[500,1500,3500],"retryableConditions":["HTTP_429","HTTP_503","NETWORK_TIMEOUT"]}},"endpoints":{"dossierUrl":"https://www.xpersona.co/api/v1/agents/clawhub-mzoob-g1geo/dossier","snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-mzoob-g1geo/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-mzoob-g1geo/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-mzoob-g1geo/trust"}},"reliability":{"evidence":{"source":"runtime-metrics","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No trust, reliability, or runtime telemetry is available."},"trust":{"status":"unavailable","handshakeStatus":"UNKNOWN","verificationFreshnessHours":null,"reputationScore":null,"p95LatencyMs":null,"successRate30d":null,"fallbackRate":null,"attempts30d":null,"trustUpdatedAt":null,"trustConfidence":"unknown","sourceUpdatedAt":null,"freshnessSeconds":null},"decisionGuardrails":{"doNotUseIf":["Contract metadata is missing or unavailable for deterministic execution."],"safeUseWhen":[],"riskFlags":["missing_or_unavailable_contract","trust_data_unavailable","schema_references_missing"],"operationalConfidence":"low"},"executionMetrics":{"observedLatencyMsP50":null,"observedLatencyMsP95":null,"estimatedCostUsd":null,"uptime30d":null,"rateLimitRpm":null,"rateLimitBurst":null,"lastVerifiedAt":null,"verificationSource":null},"runtimeMetrics":{"successRate":null,"avgLatencyMs":null,"avgCostUsd":null,"hallucinationRate":null,"retryRate":null,"disputeRate":null,"p50Latency":null,"p95Latency":null,"lastUpdated":null}},"benchmarks":{"evidence":{"source":"no-benchmark-data","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No benchmark suites or observed failure patterns are available."},"suites":[],"failurePatterns":[]},"artifacts":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"high","updatedAt":"2026-10-09T12:50:00.612Z","emptyReason":null},"readme":"Skill: g1geo\n\nOwner: mzoob\n\nSummary: 极义GEO — 生成式搜索引擎优化平台。监控品牌在 DeepSeek、Kimi、通义千问、豆包、文心、腾讯元宝等 AI 搜索中的可见度、提及率、推荐与排名，支持竞品对比和批量诊断；生成 GEO 问题与文章，提供 AI 改写、文章裂变、企业知识与素材管理、报告和趋势跟踪，并分发至 抖音/小红书/知乎等11+ 自媒体平台或 GEO 媒体。适用于 GEO 优化、品牌 AI 搜索表现分析、内容生成与多平台发布。用户提到极义GEO、G1GEO、g1geo、AI生成优化或要求执行 g1geo 命令时使用，也应用于GEO文章生成，内容分发等场景。执行命令前先加载与已安装 CLI 版本匹配的指南。\n\nTags: latest:1.1.0\n\nVersion history:\n\nv1.1.0 | 2026-07-23T06:53:55.136Z | user\n\n- Migrated SKILL.md and documentation content to Chinese, reflecting localization for Chinese-speaking users.\n- No changes to core functionality; CLI usage patterns, supported features, and guidance remain as before.\n- Removed the sample documentation file skill-card.md.\n\nv1.0.9 | 2026-07-22T10:48:26.267Z | user\n\n- Major update: Switches to the official g1geo CLI skill, removing legacy Python scripts, sample docs, and earlier product description.\n- Removes now-obsolete files: cli reference, workflow guide, configuration, main script, and skill card.\n- Skill is retitled, rebranded, and now mandates the @g1geo/cli as the sole execution interface.\n- Outlines feature overview and step-by-step operational rules to always defer to the installed CLI's own Guide.\n- Strongly prohibits fallback to legacy scripts, internal APIs, direct curl, or unverified commands.\n- Reinforces proper context passing (e.g., never guessing product IDs) and corrects all business logic to follow live CLI contracts.\n\nv1.0.8 | 2026-03-28T07:49:48.057Z | user\n\n- Refined the workflow for company info填写：新增“公司信息一次性完整填写”要求，详细列出必填/选填字段及填写策略，强调不能编造。\n- 明确 company save 必须一次性补全全部必填项，优先用用户对话、网络搜索及用户提问补足资料。\n- 修改 company save 命令用法示例，展示所有必填参数填写格式。\n- 强化数据依赖链，突出公司资料完整性对后续内容生成的影响。\n- 仅增加了缓存目录 pyc 文件，没有代码变更。\n\nv1.0.7 | 2026-03-26T11:46:40.778Z | auto\n\njike-geo 1.0.7\n\n- 新增 scripts/config.json 和 scripts/geo.py，统一脚本配置与核心逻辑入口。\n- 移除旧的 scripts copy/config.json 和 scripts copy/geo.py，精简冗余文件。\n- 完善与简化文档：合并和优化 SKILL.md，删除旧版流程说明，强调新版草稿生成流程及完整内容输出要求。\n- 路由和依赖链梳理为更清晰的新版主线，删除过时操作与参数说明。\n- 全面要求在生成问题草稿、搜索、文章等输出时，逐条完整展示原始内容，不再只用摘要或数量代替。\n\nv1.0.6 | 2026-03-26T11:30:14.005Z | user\n\n- Switched script directory from scripts/ to scripts copy/ for config.json and geo.py\n- Updated SKILL.md: \n  - Introduced a new recommended workflow using drafts generate for L1-L4问题草稿，不依赖关键词模块\n  - Added routes and example usage for drafts（草稿）和 gallery（图片素材库）管理\n  - Clarified新版 vs 旧版问题生成链路\n  - Expanded routing table and workflow guide to reflect new 草稿和图片管理功能\n\nv1.0.5 | 2026-03-19T11:45:57.081Z | user\n\nNo user-facing changes detected in version 1.0.5. This release contains no modifications to the skill files.\n\nv1.0.4 | 2026-03-19T11:43:16.971Z | user\n\n- 新增命令参数速查表文档 references/cli-reference.md，便于快速查找 CLI 用法。\n- SKILL.md 强调命令参数速查表，并在 routing table 中补充了 sentiment 指令。\n- description 进一步明确面向场景覆盖，描述更丰富。\n- 其他功能无更改；兼容性与行为保持不变。\n\nv1.0.3 | 2026-03-17T10:00:29.856Z | user\n\njike-geo 1.0.3 Changelog\n\n- Improved data dependency management: strict workflow from \"product create\" to \"questions generate\", with clear handling when dependencies fail.\n- Enhanced error handling: specified different responses for authentication failures, API rate limits, and quota shortages; limited API retries to one.\n- Enforced product isolation: each product has a separate data store; prevents using other product IDs for operations.\n- API Key setup instructions updated, including a visual guide link for users.\n- Prohibited workarounds such as reading script source code or reusing failed data; alternative suggestions provided on failure.\n- Updated documentation to clarify error messages, user guidance, and fallback scenarios.\n\nv1.0.2 | 2026-03-17T08:00:47.972Z | user\n\nNo user-facing changes in this release.\n\n- Version bumped from 1.0.0 to 1.0.2.\n- No file changes detected.\n\nv1.0.1 | 2026-03-17T07:39:44.568Z | user\n\n- No user-visible changes; version bump only.\n- Internal version updated from 1.0.0 to 1.0.1.\n\nv1.0.0 | 2026-03-17T07:03:42.215Z | user\n\n- Initial release of 极义GEO (v1.0.0): a platform for monitoring and optimizing brand visibility across 7+ AI search engines.\n- Supports brand/search visibility tracking, AI-generated question & article creation, and one-click distribution to 11+ media platforms.\n- Includes product, keyword, company, question, search, and article management via a unified CLI script.\n- Provides detailed output emphasizing brand mentions, sentiment analysis, and actionable next-steps for users.\n- Built-in authentication, async operation handling, and quota awareness.\n- All commands and outputs designed for a professional, friendly Chinese-language workflow.\n\nArchive index:\n\nArchive v1.1.0: 3 files, 4520 bytes\n\nFiles: skill-card.md (2261b), SKILL.md (5920b), _meta.json (124b)\n\nFile v1.1.0:SKILL.md\n\n---\n\n## name: g1geo description: \"极义GEO — 生成式搜索引擎优化平台。监控品牌在 AI 搜索引擎（DeepSeek、Kimi、通义千问、豆包、文心、腾讯元宝）中的可见度，诊断品牌提及、推荐与排名表现，生成优化问题和文章，并一键分发至 11+ 自媒体平台或 GEO 媒体。适用场景包括：GEO 优化、AI 搜索监控、品牌可见度分析、品牌在 AI 里的表现、AI 搜索排名、品牌提及率、AI 平台搜索诊断、问题集生成与管理、文章生成与管理、自媒体分发、批量监控品牌排名、查看品牌在 DeepSeek、Kimi、千问、豆包等平台里的排名或提及情况、判断 AI 搜索引擎是否推荐某品牌、竞品在 AI 搜索中的表现对比、生成 GEO 优化内容，以及其他涉及品牌在 AI 搜索引擎中的曝光和排名；也包括 AI 辅助写作、文章裂变、企业知识与素材管理、写作要求配置、报告生成与导出、趋势分析与跟踪，以及通过桌面发布设备、自媒体账号和 GEO 媒体完成文章或图文分发。用户提到极义GEO、G1GEO、g1geo、AI生成优化或要求执行 g1geo 命令时使用，也应用于GEO文章生成，内容分发等场景。执行任何 g1geo 命令前必须先调用本技能，并加载与已安装 CLI 版本匹配的指南。\"\n\n# 极义GEO\n\n使用官方 `@g1geo/cli` 作为极义GEO 内容处理、品牌可见度检测、分析和自动化任务的统一执行入口。当前可用命令、身份验证流程、输出约定和工作流程均以已安装的 CLI 版本为准。\n\n## 核心能力\n\n- 品牌可见度与 GEO 检测——发起一次结合企业知识的网页端或应用端检测，在限定范围内轮询各问题与平台的进度，获取最终结论，重试失败的检测单元，并分享或导出报告。\n- 企业知识与素材——管理产品、企业信息、参考文档、图片素材、图文素材、写作要求和写作配置。\n- 问题与文章生产——生成和管理问题集，查看趋势和近期 GEO 检测摘要，基于主题、问题集或文章组直接生成文章，管理手动文章组和恢复任务，以及创建、读取或更新文章。\n- 文章检查与改写——检测或修复 AI 痕迹，并预览或应用自然表达改写。\n- 文章裂变——基于一篇现有文章、公开网址或本地 Markdown 文件，生成最多十篇纯文本变体，并可按需引用产品的参考文档。\n- 分析与监控——生成企业品牌报告，查看整体 GEO 分析，并跟踪可见度趋势。\n- 桌面端发布——查看已授权团队、在线桌面设备和发布账号的登录状态；提交文章或图文发布任务；在不接触平台登录凭据的情况下查看、取消、重试或审计任务。\n- GEO 媒体发布——分页查看启用中的 3 类 GEO 媒体，可按需仅查看当前高收录媒体；根据精简的选择说明及积分、人民币价格进行选择；提交经用户确认的文章或图文媒体发布任务，同时不暴露上游标识和成本。\n- 智能体与持续集成自动化——安全完成身份验证，明确传递产品和发布上下文，发现当前可用能力，监控或取消异步任务，并使用稳定的机器可读结果。\n\n以上能力用于帮助智能体选择正确的极义GEO 业务流程。业务路径选择、安全默认值和结果处理方式以已安装 CLI 提供的指南为准；选定工作流程后，通过已安装 CLI 的帮助信息确认准确语法，并通过身份验证后的服务端能力信息确认功能当前是否可用。\n\n## 开始使用\n\n如果 `g1geo` 不可用，或者已安装版本不支持 `g1geo guide`，立即安装或更新：\n\n```bash\nnpm install --global @g1geo/cli@latest\n```\n\n不要仅仅因为缺少 CLI 就另行向用户请求确认，直接尝试安装。如果宿主环境本身要求审批，则使用该环境的常规审批机制，并在获批后继续。\n\n执行任何业务命令前，先加载与已安装版本匹配的说明：\n\n```bash\ng1geo guide\n```\n\n完整阅读输出内容。不得截断，也不得用其他 CLI 版本的缓存说明替代。已安装的 CLI 版本发生变化后，重新运行该命令。\n\n## 使用 CLI\n\n- 将指南作为已安装版本的权威约定。如果本技能与指南存在差异，以指南为准。\n- 将指南作为业务路径选择依据。把用户希望达成的结果转换为合适的工作流程，先通过读取类命令补全可安全获取的上下文，不要求用户了解极义GEO 的命令名称或标识。\n- 执行命令时，不要额外添加 `--output json`，也不要自行选择输出格式。每条命令都会声明最适合其结果的格式。只有当用户或集成适配器明确要求时，才覆盖输出格式。\n- 完成身份验证后，使用 `g1geo capabilities` 查看当前服务端、凭据和产品允许使用的能力。不要仅根据命令名称推断在线服务能力。\n- 不要编造不存在的命令，也不要改用旧版 Python CLI、旧的 `jike` 命名、浏览器 Cookie、前端内部接口或直接调用接口。\n- 严格按照指南的约定处理标准输出、标准错误、JSON 封装结果、退出码、`error.retryable` 和 `request_id`。不要盲目重试失败任务。\n- 当任务可能查看或影响多个产品时，明确指定产品上下文。绝不使用内部数字标识代替公开的 `prd_...` 标识。\n- 在需要时明确指定发布团队和桌面设备上下文，只使用 CLI 返回的公开标识。\n- 执行用户要求的完整工作流程，不要停留在准备阶段。即使业务退出码非零，也要检查完整结果并说明有业务意义的结果。\n- 浏览器登录会授予标准的账号级 CLI 权限包，适用于该身份当前以及之后可见的全部产品。智能体不能删除整个产品；不要虚构或绕过这一限制。\n\nFile v1.1.0:_meta.json\n\n{\n  \"ownerId\": \"kn74qzhsg7e17frgra373tqrpx832zv4\",\n  \"slug\": \"g1geo\",\n  \"version\": \"1.1.0\",\n  \"publishedAt\": 1784789635136\n}\n\nFile v1.1.0:skill-card.md\n\n## Description:\n\ng1geo guides agents in using the official @g1geo/cli for GEO content workflows, AI search visibility analysis, brand monitoring, article generation and rewriting, reporting, and multi-platform publishing.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[mzoob](https://clawhub.ai/user/mzoob)\n\n### License/Terms of Use:\n\nMIT-0\n\n## Use Case:\n\nDevelopers, marketers, and content operations teams use this skill to route g1geo tasks through the installed CLI for brand visibility checks, GEO optimization, article production, trend analysis, reports, and publishing workflows. It is intended for agents that need to discover available CLI capabilities, authenticate safely, and execute complete content or monitoring workflows.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: The skill asks agents to install or update a mutable global npm CLI and to treat the installed CLI guide as authoritative.\n\nMitigation: Review the skill before installation, require explicit approval for installs and updates, and prefer a pinned, reviewed @g1geo/cli version.\n\nRisk: Authenticated CLI use can grant account-level access and may initiate publishing workflows.\n\nMitigation: Require explicit approval for authentication and publication, confirm product and publishing context before execution, and review CLI results before acting on them.\n\n## Reference(s):\n\n- [ClawHub g1geo skill page](https://clawhub.ai/mzoob/skills/g1geo)\n\n## Skill Output:\n\n**Output Type(s):** [text, markdown, code, shell commands, configuration, guidance]\n\n**Output Format:** [Markdown guidance with inline shell commands and CLI output handling notes]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [May direct the agent to run authenticated CLI workflows that return text, JSON-wrapped results, reports, or publishing task status depending on the installed CLI version.]\n\n## Skill Version(s):\n\n1.1.0 (source: server release evidence)\n\n## Ethical Considerations:\n\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.\n\nArchive v1.0.9: 3 files, 3956 bytes\n\nFiles: skill-card.md (2085b), SKILL.md (5705b), _meta.json (124b)\n\nFile v1.0.9:SKILL.md\n\n---\nname: g1geo\ndescription: \"Official G1GEO CLI entry skill for AI agents. Always invoke this skill before running any g1geo command. Use when a user mentions G1GEO or g1geo, provides or asks to run a g1geo CLI command, or wants to work with G1GEO product and company knowledge, documents and materials, writing requirements, question sets, articles, AI writing assistance, article fission, GEO brand visibility and detection, reports and exports, analysis and tracking, desktop publishing devices and accounts, GEO media discovery and publishing, direct publishing jobs, asynchronous jobs, authentication, products, capabilities, installation, updates, or diagnostics. Load the installed CLI's version-matched guide before acting, and use the official g1geo CLI rather than legacy Python scripts, internal APIs, curl, or guessed commands.\"\n---\n\n# G1GEO\n\nUse the official `@g1geo/cli` as the execution surface for G1GEO content operations, brand visibility detection, analysis, and automation. The installed CLI owns its current commands, authentication flow, output contracts, and workflows.\n\n## Features\n\n- Brand visibility and GEO detection — start one Knowledge-aware web/app check, poll bounded question-platform progress, retrieve the final conclusion, retry failed cells, and share or export reports.\n- Company knowledge and materials — manage products, company information, reference documents, image assets, image-text materials, writing instructions, and writing configuration.\n- Questions and article production — generate and curate question sets, inspect trends and recent GEO detection summaries, generate articles directly from one topic, a question set, or an article group, manage manual groups and recovery tasks, and create, read, or update articles.\n- Article inspection and rewrites — detect or fix AI markers, and preview or apply natural-expression rewrites.\n- Article fission — generate up to ten text-only variants from one existing article, public URL, or local Markdown file, optionally using the product's reference documents.\n- Analysis and monitoring — create company brand reports, inspect overall GEO analysis, and track visibility trends.\n- Desktop publishing — inspect authorized teams, online desktop devices, publisher-account login state, submit article or image-text publishing jobs, and inspect, cancel, retry, or audit them without accessing platform credentials.\n- GEO media publishing — page through active type-3 GEO media, optionally restrict discovery to the current high-inclusion set, use compact selection remarks and credit/RMB pricing, and submit confirmed article or image-text media jobs without exposing upstream IDs or costs.\n- Agent and CI automation — authenticate securely, pass product and publishing context explicitly, discover live capabilities, monitor or cancel asynchronous jobs, and consume stable machine-readable results.\n\nThese features describe the G1GEO product surface so the Agent can choose the right workflow. Business routing, safe defaults, and result handling come from the installed CLI Guide; use the installed CLI's help for exact syntax after choosing a workflow, and use authenticated server capabilities for live availability.\n\n## Start here\n\nIf `g1geo` is unavailable, or the installed version does not provide `g1geo guide`, install or update it immediately:\n\n```bash\nnpm install --global @g1geo/cli@latest\n```\n\nDo not ask for separate conversational confirmation solely because the CLI is missing. Attempt the installation directly. If the host environment itself requires an approval step, use its normal approval mechanism and continue after approval.\n\nBefore running any operational command, load the installed version's instructions:\n\n```bash\ng1geo guide\n```\n\nRead the complete output before acting. Do not truncate it or substitute cached instructions from another CLI version. Run it again after the installed CLI version changes.\n\n## Use the CLI\n\n- Follow the Guide as the authoritative contract for the installed version. If this skill and the Guide differ, the Guide wins.\n- Treat the Guide as a business router. Translate the user's desired outcome into the appropriate workflow, resolve safe context with read commands, and do not require the user to know G1GEO command names or IDs.\n- Invoke commands without adding `--output json` or choosing an output format. Each command declares the format best suited to its result. Use an output override only when the user or an integration adapter explicitly requires it.\n- After authentication, use `g1geo capabilities` to discover what the current server, credential, and product permit. Do not infer SaaS capabilities from command names alone.\n- Do not invent unavailable commands or fall back to the historical Python CLI, old `jike` naming, browser cookies, frontend-internal endpoints, or direct API calls.\n- Treat stdout, stderr, JSON envelopes, exit codes, `error.retryable`, and `request_id` exactly as the Guide specifies. Do not blindly retry failures.\n- Keep product context explicit when the task could affect or inspect more than one product. Never substitute an internal numeric ID for a public `prd_...` ID.\n- Keep publishing team and desktop device context explicit when required. Use only public IDs returned by the CLI.\n- Execute the requested workflow instead of stopping after setup. Inspect the full result even on a non-zero domain exit code and report the meaningful outcome.\n- Browser login grants the standard account-level CLI permission bundle across all products currently or subsequently visible to that identity. Whole-product deletion is intentionally unavailable to Agents; do not invent or bypass that boundary.\n\nFile v1.0.9:_meta.json\n\n{\n  \"ownerId\": \"kn74qzhsg7e17frgra373tqrpx832zv4\",\n  \"slug\": \"g1geo\",\n  \"version\": \"1.0.9\",\n  \"publishedAt\": 1784717306267\n}\n\nFile v1.0.9:skill-card.md\n\n## Description: <br>\nG1GEO is an agent entry skill that routes G1GEO content operations, brand visibility checks, publishing workflows, reporting, authentication, and automation through the official @g1geo/cli. <br>\n\nThis skill is ready for commercial/non-commercial use. <br>\n\n## Publisher: <br>\n[mzoob](https://clawhub.ai/user/mzoob) <br>\n\n### License/Terms of Use: <br>\nMIT-0 <br>\n\n\n## Use Case: <br>\nDevelopers and operators use this skill to connect an agent to G1GEO workflows for brand visibility detection, content production, article fission, analysis, media discovery, and publishing through the installed CLI. <br>\n\n### Deployment Geography for Use: <br>\nGlobal <br>\n\n## Known Risks and Mitigations: <br>\nRisk: The skill instructs agents to install or update a global npm CLI package automatically. <br>\nMitigation: Use it only in trusted environments where global package installation is acceptable, and review the @g1geo/cli installation behavior before deployment. <br>\nRisk: Authenticated use can grant account-level access for product, content, reporting, and publishing workflows. <br>\nMitigation: Use credentials with appropriate account scope, review publishing permissions before use, and avoid shared or production environments unless those permissions are approved. <br>\n\n\n## Reference(s): <br>\n- [ClawHub skill page](https://clawhub.ai/mzoob/skills/g1geo) <br>\n\n\n## Skill Output: <br>\n**Output Type(s):** [guidance, shell commands, configuration, text] <br>\n**Output Format:** [Markdown guidance with inline shell commands and CLI output interpretation] <br>\n**Output Parameters:** [1D] <br>\n**Other Properties Related to Output:** [Requires the agent to load the installed CLI guide before operational use.] <br>\n\n## Skill Version(s): <br>\n1.0.9 (source: server release evidence) <br>\n\n## Ethical Considerations: <br>\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment. <br>\n\nArchive v1.0.8: 7 files, 24317 bytes\n\nFiles: references/cli-reference.md (10212b), references/workflow-guide.md (8878b), scripts/config.json (96b), scripts/geo.py (44146b), skill-card.md (2548b), SKILL.md (12474b), _meta.json (124b)\n\nFile v1.0.8:SKILL.md\n\n---\r\nname: jike-geo\r\nversion: 1.0.0                    \r\nlicense: MIT                      \r\ndescription: \"极义GEO — 生成式搜索引擎优化平台。监控品牌在 7+ AI 搜索引擎（DeepSeek、Kimi、通义千问、豆包、文心、智谱、腾讯元宝）中的可见度，AI 生成优化问题与文章，一键分发至 11+ 自媒体平台。适用场景包括：GEO 优化、AI 搜索监控、品牌可见度分析、品牌在 AI 里的表现、AI 搜索排名、品牌提及率、AI 平台搜索诊断、问题生成、文章生成、自媒体分发、批量监控品牌排名、查看品牌在 DeepSeek/Kimi/千问/豆包里的排名或提及情况、AI 搜索引擎里有没有推荐某品牌、竞品在 AI 搜索中的表现对比、生成 GEO 优化内容，以及其他涉及品牌在 AI 搜索引擎中的曝光、排名、引用、情感分析的场景。\"\r\nhomepage: https://jike-geo.100.city       \r\nmetadata: {\"openclaw\": {\"emoji\": \"🔍\", \"requires\": {\"bins\": [\"python3\"]}, \"primaryEnv\": \"JIKE_GEO_SECRET_KEY\"}}\r\n---\r\n\r\n# 极义GEO Skill\r\n\r\nScript: `python3 {baseDir}/scripts/geo.py`\r\n\r\n## Persona\r\n\r\n你是 **GEO 优化助手** — 一位专业的品牌 AI 搜索优化顾问。所有回复遵循：\r\n\r\n- 说中文，专业但亲切：\"搞定了～\"、\"分析完成\"、\"已为你生成\"。\r\n- 展示关键数据：品牌提及率、引用排名、情感倾向。\r\n- 完成操作后主动建议下一步（\"要不要生成优化文章？\"、\"需要批量搜索更多问题吗？\"）。\r\n- 搜索结果中重点标注品牌被引用的情况。\r\n\r\n## CRITICAL RULES\r\n\r\n1. **ALWAYS use the script** — 不要直接 curl API。\r\n2. **Secret Key 认证** — 所有接口通过 `JIKE_GEO_SECRET_KEY` 环境变量认证。\r\n3. **产品隔离严格** — 每个产品有独立的品牌资料库，**绝对不能用其他产品的 ID 来执行操作**。如果目标产品不存在或创建失败（如额度不足），必须停止后续操作，引导用户升级套餐后再继续。不要借用其他产品 ID 凑合执行，结果会完全不准。\r\n4. **搜索任务是异步的** — 创建搜索任务后需要轮询状态，脚本已内置轮询逻辑。\r\n5. **批量搜索耗时较长** — 创建批量任务前先告知用户需要等待。\r\n6. **命令参数速查表** — 见 `{baseDir}/references/cli-reference.md`。\r\n7. **API 失败最多重试 1 次** — 如果同一个接口连续失败 2 次，立即停止重试，告知用户原因并给出替代方案。不要反复尝试。\r\n8. **完整展示生成结果** — `drafts generate` 或 `questions generate` 完成后，必须将脚本输出的 L1-L4 各阶段问题**逐条完整展示**给用户，不要只说\"生成了 N 个问题\"或只给统计摘要。用户需要看到每一条具体问题内容才能判断质量和下一步操作。搜索结果、文章内容等同理，优先展示原始内容，再做分析总结。\r\n\r\n## Data Dependencies（核心依赖链）\r\n\r\n操作之间有严格的数据依赖，**必须按顺序执行**：\r\n\r\n```\r\nproducts create → company save（完整填写） → drafts generate → articles generate\r\n                                                ↑ 需要 keywords 文本    ↑ 需要 question_id\r\n```\r\n\r\n- `company save` 需要一次性完整填写公司信息，信息质量直接决定后续问题生成和文章生成的效果\r\n- `drafts generate` 需要先填写公司信息（`company save`），传入 `--keywords` 文本即可异步生成 L1-L4 四阶段问题草稿\r\n- `articles generate` 需要先有 `question_id`\r\n- `search create` 是**独立的**，只需要 `--question` 文本和 `--brand`，不依赖上述链路\r\n\r\n### company save 填写策略（重要）\r\n\r\n公司信息页面分为以下区块，Agent 应当一次性完整填写后调用 `company save`：\r\n\r\n**必填字段（必须准确填写）：**\r\n- `--product-name` — 产品名称\r\n- `--company-name` — 公司名称\r\n- `--industry` — 所属行业（从以下选项中选择：互联网/IT、教育培训、医疗健康、金融保险、房地产/建筑、制造业、零售/电商、餐饮/食品、旅游/酒店、汽车、法律服务、广告/营销、物流/运输、农业、能源/环保、其他）\r\n- `--business-scope` — 业务范围（`national` 或 `regional`，如果是指定城市还需配合 `--cities`）\r\n- `--company-description` — 企业介绍（200-500字，包含主营业务、核心优势、发展历程等）\r\n- `--product-description` — 产品介绍（200-500字，包含产品定位、核心功能、竞争优势等）\r\n- `--target-customer-type` — 客户类型（`To B` 或 `To C` 或 `To B,To C`）\r\n- `--customer-description` — 目标客户描述（100-200字）\r\n- `--competitors` — 主要竞争对手（逗号分隔，如：竞品A,竞品B,竞品C）\r\n- `--writing-style` — 写作风格（正式严谨型/轻松活泼型/专业技术型/营销推广型/新闻资讯型）\r\n\r\n**非必填字段（有则填，没有可跳过）：**\r\n- `--contact-phone` — 联系电话\r\n- `--website` — 公司网站\r\n- `--editor-name` — 编辑名称/文章作者署名\r\n\r\n**信息获取优先级：**\r\n1. **先从用户对话中提取** — 用户可能已经提到了公司名、产品名、行业等信息，直接使用\r\n2. **联网搜索补充** — 对于用户没有明确提供的必填字段，主动通过联网搜索获取准确信息。搜索关键词建议：`\"公司名\" 是做什么的`、`\"产品名\" 产品介绍`、`\"公司名\" 竞争对手`\r\n3. **与用户深度对话补充** — 联网搜索无法获取的信息（如目标客户描述、写作风格偏好），合并向用户提问，一次性收集，不要逐个字段反复追问\r\n\r\n**禁止行为：** 不要在没有事实依据的情况下编造公司信息。错误的公司信息会导致后续生成的问题和文章偏离实际，整个链路的产出质量都会受损。宁可多花时间搜索和确认，也不要凭感觉填写。\r\n\r\n**当依赖链断裂时（如 drafts generate 失败）：**\r\n- `articles generate` 无法执行，因为没有 question_id\r\n- 不要尝试绕过，不要去搜索历史里找 ID，不要反复重试\r\n- 直接告知用户：\"问题生成暂时不可用（原因：xxx），文章生成依赖问题 ID，目前无法通过系统生成\"\r\n- 提供替代方案：你可以直接为用户撰写 GEO 优化文章样稿作为参考\r\n\r\n## Error Handling（错误处理）\r\n\r\n| 错误场景 | 处理方式 |\r\n|---------|---------|\r\n| products create 额度不足 | **停止所有后续操作**，告知用户\"产品数量已达上限\"，引导前往 https://jike-geo.100.city 升级套餐。不要用其他产品 ID 替代 |\r\n| API 返回 500 / 服务过载 | 最多重试 1 次，失败后告知用户\"服务暂时不可用，建议稍后再试\" |\r\n| drafts generate 失败 | 告知用户原因，说明文章生成暂不可用，提供手写样稿作为替代 |\r\n| articles generate 缺少 question_id | 引导用户先完成 company save → drafts generate 流程 |\r\n| 认证失败 401 | 引导用户前往 https://jike-geo.100.city 获取 API Key |\r\n| 连续 2 次相同错误 | 停止重试，切换到替代方案或建议用户稍后再试 |\r\n\r\n## API Key Setup\r\n\r\n编辑 `{baseDir}/scripts/config.json`，填写 `secret_key`。或设置环境变量 `JIKE_GEO_SECRET_KEY`。\r\n\r\n快速检查：`python3 {baseDir}/scripts/geo.py check`\r\n\r\n**Key 获取方式：** 前往极义GEO官网登录后，在个人设置中创建 API Key。\r\n\r\n**⚠️ 重要：** 当 check 不通过时，务必引导用户前往 https://jike-geo.100.city 获取正确的 API Key，并在回复中附上操作指引图。\r\n\r\n操作指引图：https://file.dso100.com/geo_guide.png\r\n\r\n## Routing Table\r\n\r\n| 用户意图 | 命令 | 说明 |\r\n|---------|------|------|\r\n| 产品管理 | `products list/create/get/update/delete` | 管理产品 |\r\n| 公司信息 | `company get/save` | 获取或保存产品的公司信息（需完整填写，见填写策略） |\r\n| **生成问题草稿** | `drafts generate` | 异步生成 L1-L4 问题草稿 |\r\n| 草稿列表 | `drafts list` | 查看问题草稿历史 |\r\n| 最新草稿 | `drafts latest` | 获取最新一份草稿 |\r\n| 草稿详情 | `drafts get` | 查看指定草稿详情 |\r\n| 编辑草稿 | `drafts update` | 修改草稿内容 |\r\n| 删除草稿 | `drafts delete` | 删除指定草稿 |\r\n| 关键词管理 | `keywords list/add/delete` | 管理核心关键词 |\r\n| 图片分类管理 | `gallery categories-list/create/update/delete` | 管理素材库分类 |\r\n| 图片管理 | `gallery images-list/upload/delete` | 上传、查看、删除图片素材 |\r\n| **GEO 单次搜索** | `search create` | 创建单次搜索任务（核心功能） |\r\n| **GEO 批量搜索** | `search batch` | 批量搜索多个问题（核心功能） |\r\n| 搜索状态 | `search status` | 查询搜索任务状态和结果 |\r\n| 批量状态 | `search batch-status` | 查询批量任务状态 |\r\n| 搜索历史 | `search history` | 查看历史搜索记录 |\r\n| 生成文章 | `articles generate` | AI 生成 SEO 优化文章 |\r\n| 文章管理 | `articles list/get/update/delete` | 管理文章 |\r\n| 发布记录 | `publish record/list` | 记录和查看发布情况 |\r\n| 平台列表 | `platforms list` | 查看自媒体平台 |\r\n| AI 平台 | `ai-platforms` | 查看支持的 AI 搜索平台 |\r\n| 情感分析状态 | `sentiment` | 查看情感分析功能是否开启 |\r\n\r\n## Workflow Guide\r\n\r\n完整工作流和使用示例 → 阅读 `{baseDir}/references/workflow-guide.md`\r\n\r\n## Script Usage\r\n\r\n```bash\r\n# 检查连接和认证\r\npython3 {baseDir}/scripts/geo.py check\r\n\r\n# 产品管理\r\npython3 {baseDir}/scripts/geo.py products list\r\npython3 {baseDir}/scripts/geo.py products create --name \"我的产品\" --description \"产品描述\"\r\n\r\n# 公司信息 — 一次性完整填写所有必填字段\r\npython3 {baseDir}/scripts/geo.py company save --product-id 1 \\\r\n  --product-name \"极义GEO\" \\\r\n  --company-name \"极客增长\" \\\r\n  --industry \"互联网/IT\" \\\r\n  --business-scope \"national\" \\\r\n  --company-description \"极客增长是一家专注于AI搜索优化的科技公司...\" \\\r\n  --product-description \"极义GEO是国内首个GEO优化平台，帮助品牌提升在AI搜索引擎中的可见度...\" \\\r\n  --target-customer-type \"To B\" \\\r\n  --customer-description \"中小企业品牌营销负责人，关注品牌在AI搜索中的曝光和排名\" \\\r\n  --competitors \"竞品A,竞品B,竞品C\" \\\r\n  --writing-style \"专业技术型\"\r\npython3 {baseDir}/scripts/geo.py company get --product-id 1\r\n\r\n# 生成问题草稿\r\npython3 {baseDir}/scripts/geo.py drafts generate --product-id 1 --keywords \"AI搜索优化\"\r\npython3 {baseDir}/scripts/geo.py drafts list --product-id 1\r\npython3 {baseDir}/scripts/geo.py drafts latest --product-id 1\r\npython3 {baseDir}/scripts/geo.py drafts get --product-id 1 --id 1\r\npython3 {baseDir}/scripts/geo.py drafts update --product-id 1 --id 1 --inquiry \"新的L1问题内容\"\r\npython3 {baseDir}/scripts/geo.py drafts delete --product-id 1 --id 1\r\n\r\n# 图片素材库\r\npython3 {baseDir}/scripts/geo.py gallery categories-list --product-id 1\r\npython3 {baseDir}/scripts/geo.py gallery categories-create --product-id 1 --name \"产品图\" --scope product\r\npython3 {baseDir}/scripts/geo.py gallery images-upload --product-id 1 --category-id 1 --file ./img1.jpg ./img2.png\r\npython3 {baseDir}/scripts/geo.py gallery images-list --product-id 1\r\npython3 {baseDir}/scripts/geo.py gallery images-delete --product-id 1 --id 1\r\n\r\n# 关键词管理\r\npython3 {baseDir}/scripts/geo.py keywords add --product-id 1 --word \"AI搜索优化\"\r\npython3 {baseDir}/scripts/geo.py keywords list --product-id 1\r\n\r\n# GEO 搜索（核心）\r\npython3 {baseDir}/scripts/geo.py search create \\\r\n  --product-id 1 \\\r\n  --question \"什么是GEO优化\" \\\r\n  --brand \"极义GEO\" \\\r\n  --platforms deepseek,kimi,qianwen\r\n\r\n# 批量搜索\r\npython3 {baseDir}/scripts/geo.py search batch \\\r\n  --product-id 1 \\\r\n  --question-ids 1,2,3 \\\r\n  --platforms deepseek,kimi,qianwen,doubao\r\n\r\n# 文章生成\r\npython3 {baseDir}/scripts/geo.py articles generate \\\r\n  --product-id 1 \\\r\n  --question-id 1 \\\r\n  --instruction \"围绕品牌优势撰写\"\r\n```\r\n\r\n## Output\r\n\r\n- 所有输出默认为格式化文本，加 `--json` 获取原始 JSON。\r\n- 搜索结果包含：品牌提及率、引用来源、情感分析、各平台详情。\r\n- 错误信息包含 HTTP 状态码和 API 错误描述。\n\nFile v1.0.8:_meta.json\n\n{\n  \"ownerId\": \"kn74qzhsg7e17frgra373tqrpx832zv4\",\n  \"slug\": \"g1geo\",\n  \"version\": \"1.0.8\",\n  \"publishedAt\": 1774684188057\n}\n\nFile v1.0.8:references/cli-reference.md\n\n# geo.py 命令参数速查表\r\n\r\n所有命令格式：`python3 {baseDir}/scripts/geo.py <command> [action] [options]`\r\n\r\n全局说明：\r\n- 大部分命令支持 `--json` 输出原始 JSON\r\n- 需要 `--product-id` 的命令，如果 config.json 中设置了 `product_id` 默认值则可省略\r\n\r\n---\r\n\r\n## check\r\n\r\n检查连接和认证状态。\r\n\r\n```bash\r\npython3 geo.py check\r\n```\r\n\r\n无参数。输出配置信息、API Key（脱敏）、连接状态和用户信息。\r\n\r\n---\r\n\r\n## quota\r\n\r\n查询当前用户的套餐额度。\r\n\r\n```bash\r\npython3 geo.py quota [--json]\r\n```\r\n\r\n| 参数 | 必填 | 说明 |\r\n|------|------|------|\r\n| `--json` | 否 | 输出原始 JSON |\r\n\r\n---\r\n\r\n## products\r\n\r\n产品管理。\r\n\r\n```bash\r\npython3 geo.py products <action> [options]\r\n```\r\n\r\n| action | 说明 | 必填参数 | 可选参数 |\r\n|--------|------|---------|---------|\r\n| `list` | 列出所有产品 | — | `--json` |\r\n| `create` | 创建产品 | `--name` | `--description`, `--json` |\r\n| `get` | 查看产品详情 | `--id` | `--json` |\r\n| `update` | 更新产品 | `--id` | `--name`, `--description` |\r\n| `delete` | 删除产品 | `--id` | — |\r\n\r\n---\r\n\r\n## company\r\n\r\n产品的公司信息管理。\r\n\r\n```bash\r\npython3 geo.py company <action> [options]\r\n```\r\n\r\n| action | 说明 | 必填参数 | 可选参数 |\r\n|--------|------|---------|---------|\r\n| `get` | 查看公司信息 | `--product-id` | `--json` |\r\n| `save` | 保存公司信息 | `--product-id` + 至少一个字段 | 见下方字段列表 |\r\n\r\n公司信息字段（save 时建议一次性完整填写）：\r\n\r\n| 参数 | 说明 | 必填 |\r\n|------|------|------|\r\n| `--product-name` | 产品名称 | ✅ |\r\n| `--company-name` | 公司名称 | ✅ |\r\n| `--industry` | 所属行业（互联网/IT、教育培训、医疗健康等） | ✅ |\r\n| `--business-scope` | 业务范围（`national` 或 `regional`） | ✅ |\r\n| `--cities` | 服务城市（business-scope 为 regional 时填写） | — |\r\n| `--company-description` | 企业介绍（200-500字） | ✅ |\r\n| `--product-description` | 产品介绍（200-500字） | ✅ |\r\n| `--target-customer-type` | 客户类型（`To B` / `To C` / `To B,To C`） | ✅ |\r\n| `--customer-description` | 目标客户描述（100-200字） | ✅ |\r\n| `--competitors` | 竞争对手（逗号分隔） | ✅ |\r\n| `--writing-style` | 写作风格（正式严谨型/轻松活泼型/专业技术型/营销推广型/新闻资讯型） | ✅ |\r\n| `--contact-phone` | 联系电话 | 选填 |\r\n| `--website` | 公司网站 | 选填 |\r\n| `--editor-name` | 编辑名称/文章作者署名 | 选填 |\r\n| `--description` | 简要描述 | 选填 |\r\n\r\n---\r\n\r\n## keywords\r\n\r\n核心关键词管理。\r\n\r\n```bash\r\npython3 geo.py keywords <action> [options]\r\n```\r\n\r\n| action | 说明 | 必填参数 | 可选参数 |\r\n|--------|------|---------|---------|\r\n| `list` | 列出关键词 | `--product-id` | `--json` |\r\n| `add` | 添加关键词 | `--product-id`, `--word` | `--json` |\r\n| `delete` | 删除关键词 | `--product-id`, `--id` | — |\r\n\r\n---\r\n\r\n## questions\r\n\r\n问题管理。\r\n\r\n```bash\r\npython3 geo.py questions <action> [options]\r\n```\r\n\r\n| action | 说明 | 必填参数 | 可选参数 |\r\n|--------|------|---------|---------|\r\n| `generate` | AI 生成问题 | `--product-id`, `--keywords`（关键词文本，逗号分隔） | `--json` |\r\n| `list` | 按阶段分组列出问题 | `--product-id` | `--keyword-id`（筛选）, `--json` |\r\n| `toggle` | 切换问题选中状态 | `--product-id`, `--id` | — |\r\n\r\n`--keywords` 示例：`--keywords 代理记账,财税服务,财税数字化`\r\n\r\n---\r\n\r\n## drafts\r\n\r\n问题草稿管理。异步生成 L1-L4 四阶段问题，支持历史记录。\r\n\r\n```bash\r\npython3 geo.py drafts <action> [options]\r\n```\r\n\r\n| action | 说明 | 必填参数 | 可选参数 |\r\n|--------|------|---------|---------|\r\n| `generate` | 异步生成问题草稿 | `--product-id`, `--keywords` | `--no-wait`, `--json` |\r\n| `list` | 查看草稿历史 | `--product-id` | `--page`, `--page-size`, `--json` |\r\n| `latest` | 获取最新草稿 | `--product-id` | `--json` |\r\n| `get` | 查看指定草稿详情 | `--product-id`, `--id` | `--json` |\r\n| `update` | 修改草稿内容 | `--product-id`, `--id` + 至少一个字段 | 见下方字段列表 |\r\n| `delete` | 删除草稿 | `--product-id`, `--id` | — |\r\n\r\n草稿内容字段（update 时至少填一个）：\r\n\r\n| 参数 | 说明 |\r\n|------|------|\r\n| `--keywords` | 关键词 |\r\n| `--inquiry` | L1 认知层问题（换行分隔） |\r\n| `--understanding` | L2 探索层问题（换行分隔） |\r\n| `--consideration` | L3 评估层问题（换行分隔） |\r\n| `--purchase` | L4 决策层问题（换行分隔） |\r\n\r\n生成行为：`generate` 默认会轮询等待生成完成，加 `--no-wait` 立即返回草稿 ID。草稿状态：`generating`（生成中）、`completed`（已完成）、`failed`（失败）。\r\n\r\n---\r\n\r\n## gallery\r\n\r\n图片素材库管理。支持分类管理和图片上传/查看/删除。\r\n\r\n```bash\r\npython3 geo.py gallery <action> [options]\r\n```\r\n\r\n| action | 说明 | 必填参数 | 可选参数 |\r\n|--------|------|---------|---------|\r\n| `categories-list` | 查看分类列表 | `--product-id` | `--scope`, `--json` |\r\n| `categories-create` | 创建分类 | `--product-id`, `--name` | `--scope`（默认 product）, `--json` |\r\n| `categories-update` | 更新分类名称 | `--product-id`, `--id`, `--name` | `--json` |\r\n| `categories-delete` | 删除分类 | `--product-id`, `--id` | — |\r\n| `images-list` | 查看图片列表 | `--product-id` | `--scope`, `--category-id`, `--json` |\r\n| `images-upload` | 上传图片 | `--product-id`, `--category-id`, `--file` | `--scope`（默认 product）, `--json` |\r\n| `images-delete` | 删除图片 | `--product-id`, `--id` | — |\r\n\r\n参数详情：\r\n\r\n| 参数 | 说明 | 示例 |\r\n|------|------|------|\r\n| `--scope` | 分类/图片范围 | `--scope product`（产品级）或 `--scope public`（账号级） |\r\n| `--category-id` | 分类 ID | `--category-id 1` |\r\n| `--file` | 上传文件路径，支持多个 | `--file ./img1.jpg ./img2.png` |\r\n\r\n---\r\n\r\n## search\r\n\r\nGEO 搜索（核心功能）。\r\n\r\n```bash\r\npython3 geo.py search <action> [options]\r\n```\r\n\r\n| action | 说明 | 必填参数 | 可选参数 |\r\n|--------|------|---------|---------|\r\n| `create` | 创建单次搜索 | `--product-id`, `--question` | `--brand`, `--platforms`, `--mode`, `--no-wait`, `--json` |\r\n| `batch` | 批量搜索 | `--product-id`, `--question-ids` | `--platforms`, `--no-wait`, `--json` |\r\n| `status` | 查询任务状态 | `--product-id`, `--task-id` | `--json` |\r\n| `batch-status` | 查询批量任务状态 | `--product-id`, `--batch-id` | `--json` |\r\n| `history` | 搜索历史 | `--product-id` | `--page`, `--size`, `--json` |\r\n\r\n参数详情：\r\n\r\n| 参数 | 说明 | 示例 |\r\n|------|------|------|\r\n| `--question` | 搜索问题文本 | `--question \"什么是GEO优化\"` |\r\n| `--brand` | 要监控的品牌名 | `--brand \"极义GEO\"` |\r\n| `--platforms` | AI 平台列表，逗号分隔 | `--platforms deepseek,kimi,qianwen,doubao` |\r\n| `--mode` | 搜索模式，默认 `api` | `--mode api` 或 `--mode plugin` |\r\n| `--no-wait` | 不等待结果，立即返回 task_id | 适合批量提交后统一查询 |\r\n| `--task-id` | 单次搜索的任务 ID | `--task-id abc123` |\r\n| `--batch-id` | 批量搜索的批次 ID | `--batch-id xyz789` |\r\n| `--question-ids` | 问题 ID 列表，逗号分隔 | `--question-ids 1,2,3` |\r\n| `--page` | 历史记录页码 | `--page 1` |\r\n| `--size` | 每页条数 | `--size 20` |\r\n\r\n可用平台 ID：`deepseek`, `kimi`, `qianwen`, `doubao`, `wenxin`, `zhipu`, `yuanbao`\r\n\r\n默认行为：`create` 和 `batch` 会自动轮询等待结果返回，加 `--no-wait` 跳过轮询。轮询间隔和超时可在 config.json 中配置（`poll_interval` 默认 3 秒，`poll_timeout` 默认 300 秒）。\r\n\r\n---\r\n\r\n## articles\r\n\r\n文章管理。\r\n\r\n```bash\r\npython3 geo.py articles <action> [options]\r\n```\r\n\r\n| action | 说明 | 必填参数 | 可选参数 |\r\n|--------|------|---------|---------|\r\n| `generate` | AI 生成文章 | `--product-id`, `--question-id` | `--instruction`, `--image-ids`, `--json` |\r\n| `list` | 列出文章 | `--product-id` | `--question-id`（筛选）, `--json` |\r\n| `get` | 查看文章详情 | `--product-id`, `--id` | `--json` |\r\n| `update` | 更新文章 | `--product-id`, `--id` | `--title`, `--content`, `--status` |\r\n| `delete` | 删除文章 | `--product-id`, `--id` | — |\r\n\r\n| 参数 | 说明 | 示例 |\r\n|------|------|------|\r\n| `--question-id` | 关联的问题 ID | `--question-id 1` |\r\n| `--instruction` | 生成指令/要求 | `--instruction \"围绕品牌优势撰写\"` |\r\n| `--image-ids` | 插入的图片 ID，逗号分隔 | `--image-ids 1,2,3` |\r\n| `--title` | 文章标题（update 用） | `--title \"新标题\"` |\r\n| `--content` | 文章内容（update 用） | `--content \"新内容\"` |\r\n| `--status` | 文章状态 | `--status draft` 或 `--status published` |\r\n\r\n---\r\n\r\n## publish\r\n\r\n发布记录管理。\r\n\r\n```bash\r\npython3 geo.py publish <action> [options]\r\n```\r\n\r\n| action | 说明 | 必填参数 | 可选参数 |\r\n|--------|------|---------|---------|\r\n| `record` | 记录一次发布 | `--product-id`, `--article-id`, `--platform-id` | `--platform-name`, `--json` |\r\n| `list` | 查看发布记录 | `--product-id` | `--article-id`（筛选）, `--json` |\r\n\r\n---\r\n\r\n## platforms\r\n\r\n查看自媒体平台列表。\r\n\r\n```bash\r\npython3 geo.py platforms [--json]\r\n```\r\n\r\n无需 product-id。返回所有可用的自媒体分发平台（预设 + 自定义）。\r\n\r\n---\r\n\r\n## ai-platforms\r\n\r\n查看支持的 AI 搜索平台列表。\r\n\r\n```bash\r\npython3 geo.py ai-platforms [--json]\r\n```\r\n\r\n无需 product-id。返回所有支持监控的 AI 搜索平台及其 ID 标识。\r\n\r\n---\r\n\r\n## sentiment\r\n\r\n查看情感分析功能状态。\r\n\r\n```bash\r\npython3 geo.py sentiment [--json]\r\n```\r\n\r\n| 参数 | 必填 | 说明 |\r\n|------|------|------|\r\n| `--json` | 否 | 输出原始 JSON |\r\n\r\n无需 product-id。返回情感分析功能是否已开启（`enabled: true/false`）。情感分析用于评估 AI 搜索结果中品牌相关内容的情感倾向（positive/neutral/negative）。\n\nFile v1.0.8:references/workflow-guide.md\n\n# 极义GEO 工作流指南\r\n\r\n## 核心概念\r\n\r\n### 什么是 GEO？\r\nGEO（Generative Engine Optimization）= 生成式搜索引擎优化。\r\n与传统 SEO 优化搜索引擎排名不同，GEO 优化的是品牌在 AI 搜索引擎回答中的可见度和引用率。\r\n\r\n### 数据依赖链（重要）\r\n\r\n```\r\nproducts create → company save（完整填写） → drafts generate → articles generate\r\n                                                ↑ 需要 keywords 文本    ↑ 需要 question_id\r\n```\r\n\r\n- `company save` 需要一次性完整填写公司信息，信息质量直接决定后续问题生成和文章生成的效果\r\n\r\n#### company save 填写策略\r\n\r\n公司信息必须基于事实，不能凭感觉编造。按以下优先级获取信息：\r\n\r\n1. **先从用户对话中提取** — 用户可能已经提到了公司名、产品名、行业等信息，直接使用\r\n2. **联网搜索补充** — 对于用户没有明确提供的必填字段，主动通过联网搜索获取准确信息\r\n3. **与用户深度对话补充** — 联网搜索无法获取的信息（如目标客户描述、写作风格偏好），合并向用户提问，一次性收集\r\n- `drafts generate` 需要先填写公司信息（`company save`），传入 `--keywords` 文本即可异步生成 L1-L4 四阶段问题草稿\r\n- `articles generate` 必须先有问题（`drafts generate` 返回的 ID）\r\n- `search create` 是**独立的**，只需要问题文本和品牌名，不依赖上述链路\r\n- 依赖链中任何一步失败，后续步骤都无法执行，不要尝试绕过\r\n\r\n### 数据层级\r\n```\r\n用户 → 产品(多个) → 公司信息(每产品一份)\r\n                   → 问题草稿(多个) → 文章(多个) → 发布记录\r\n                   → 核心词(多个)\r\n                   → 图片素材库 → 分类(多个) → 图片(多个)\r\n```\r\n\r\n### 问题阶段（L1-L4）\r\n| 阶段 | 英文 | 含义 | 示例 |\r\n|------|------|------|------|\r\n| L1 | inquiry | 认知层 | \"什么是GEO优化？\" |\r\n| L2 | understanding | 探索层 | \"GEO优化有哪些方法？\" |\r\n| L3 | consideration | 评估层 | \"GEO优化工具哪个好？\" |\r\n| L4 | purchase | 决策层 | \"极义GEO怎么样？值得用吗？\" |\r\n\r\n### 支持的 AI 平台\r\n| 平台 | ID 标识 | 说明 |\r\n|------|---------|------|\r\n| DeepSeek | deepseek | 深度求索 |\r\n| Kimi | kimi | 月之暗面 |\r\n| 通义千问 | qianwen | 阿里云 |\r\n| 豆包 | doubao | 字节跳动 |\r\n| 文心一言 | wenxin | 百度 |\r\n| 智谱清言 | zhipu | 智谱AI |\r\n| 腾讯元宝 | yuanbao | 腾讯 |\r\n\r\n---\r\n\r\n## 典型工作流\r\n\r\n### 流程一：品牌 AI 可见度诊断（最常用）\r\n\r\n```\r\n1. 查看产品列表 → products list\r\n2. 创建搜索任务 → search create --question \"品牌名怎么样\" --brand \"品牌名\" --platforms deepseek,kimi,qianwen,doubao\r\n3. 查看结果 → search status --task-id xxx\r\n```\r\n\r\n注意：`search create` 不需要先创建关键词或问题，直接传文本即可。这是最快的诊断路径。\r\n\r\n### 流程二：内容优化与分发（完整链路）\r\n\r\n```\r\n1. 创建产品 → products create（如果还没有）\r\n2. 完整填写公司信息 → company save（通过搜索和对话收集所有必填字段，一次性保存）\r\n3. AI 生成问题草稿 → drafts generate --keywords \"AI搜索优化\"\r\n4. 查看草稿 → drafts latest 或 drafts get --id xxx\r\n5. （可选）编辑草稿 → drafts update --id xxx --inquiry \"修改后的问题\"\r\n6. 生成文章 → articles generate --question-id xxx\r\n7. （可选）上传配图 → gallery images-upload --category-id 1 --file ./img.jpg\r\n8. 分发到自媒体 → publish record\r\n```\r\n\r\n**⚠️ 步骤 2 的公司信息质量直接决定步骤 3 和步骤 6 的生成效果。必填字段务必准确完整填写。**\r\n**⚠️ 步骤 6 必须有 question_id。如果问题生成失败，文章生成无法执行。**\r\n\r\n### 流程三：图片素材管理\r\n\r\n```\r\n1. 创建分类 → gallery categories-create --name \"产品图\"\r\n2. 上传图片 → gallery images-upload --category-id 1 --file ./img1.jpg ./img2.png\r\n3. 查看图片 → gallery images-list\r\n4. 生成文章时引用图片 → articles generate --question-id xxx --image-ids 1,2,3\r\n```\r\n\r\n### 流程四：批量监控\r\n\r\n```\r\n1. 确保已有问题（questions list 查看）\r\n2. 批量搜索 → search batch --question-ids 1,2,3 --platforms deepseek,kimi,qianwen,doubao\r\n3. 查看批量进度 → search batch-status --batch-id xxx\r\n```\r\n\r\n---\r\n\r\n## 搜索结果解读\r\n\r\n### 单平台结果结构\r\n```json\r\n{\r\n  \"platform\": \"deepseek\",\r\n  \"answer\": \"AI 生成的回答全文...\",\r\n  \"brand_mentioned\": true,\r\n  \"brand_rank\": 2,\r\n  \"sentiment\": \"positive\",\r\n  \"citations\": [\r\n    {\r\n      \"position\": 1,\r\n      \"title\": \"引用来源标题\",\r\n      \"url\": \"https://...\",\r\n      \"domain\": \"example.com\"\r\n    }\r\n  ]\r\n}\r\n```\r\n\r\n### 关键指标\r\n- **brand_mentioned**: 品牌是否被提及\r\n- **brand_rank**: 品牌在回答中的排名位置（0=未排名）\r\n- **sentiment**: 情感倾向（positive/neutral/negative）\r\n- **citations**: 引用来源列表，可分析哪些内容被 AI 引用\r\n\r\n### 结果解读与建议策略\r\n\r\n拿到搜索结果后，不要只罗列数据，要根据结果给出有针对性的分析和建议。以下是常见场景的解读逻辑：\r\n\r\n#### 品牌提及率分析\r\n\r\n| 场景 | 解读 | 建议 |\r\n|------|------|------|\r\n| 全部平台 brand_mentioned = true | 品牌 AI 可见度良好 | 关注 brand_rank 和 sentiment，持续优化排名位置 |\r\n| 部分平台提及、部分未提及 | 品牌在不同 AI 平台的知识库覆盖不均 | 优先针对未提及的平台生成优化内容，分析已提及平台引用了哪些来源 |\r\n| 全部平台 brand_mentioned = false | 品牌在 AI 搜索中基本不可见 | 这是最需要 GEO 优化的情况。建议走完整链路：添加核心词 → 生成问题 → 生成文章 → 分发到自媒体，让 AI 平台能抓取到品牌相关内容 |\r\n\r\n#### 排名位置解读\r\n\r\n| brand_rank | 含义 | 建议 |\r\n|------------|------|------|\r\n| 0 | 未排名（品牌未出现在回答中） | 需要大量内容建设 |\r\n| 1-3 | 头部位置，AI 优先推荐 | 维持现状，关注 sentiment 是否正面 |\r\n| 4-6 | 中间位置，有提及但不突出 | 通过更多高质量内容提升排名 |\r\n| 7+ | 靠后位置，仅作为补充提及 | 需要针对性优化，分析排名靠前的竞品引用了什么来源 |\r\n\r\n#### 情感倾向处理\r\n\r\n| sentiment | 解读 | 建议 |\r\n|-----------|------|------|\r\n| positive | AI 对品牌评价正面 | 好消息，可以截图用于品牌宣传素材 |\r\n| neutral | AI 客观陈述，无明显倾向 | 正常状态，可通过优化内容引导更正面的表述 |\r\n| negative | AI 对品牌有负面评价 | 需要重点关注。分析 answer 全文找到负面表述的来源，通过发布正面内容稀释负面信息 |\r\n\r\n#### 引用来源分析\r\n\r\ncitations 是 GEO 优化的核心线索：\r\n- **用户自有域名出现在 citations 中** — 说明品牌内容已被 AI 平台收录和引用，这是最理想的状态\r\n- **citations 中全是第三方域名** — AI 平台引用的是别人写的关于品牌的内容，品牌对叙事缺乏控制力。建议在自有渠道发布更多权威内容\r\n- **citations 为空** — AI 平台的回答没有标注来源，品牌提及可能来自训练数据而非实时检索。这种情况下内容分发的效果会有延迟\r\n- **竞品域名出现在 citations 中** — 值得关注竞品的内容策略，分析他们发布了什么内容被 AI 引用\r\n\r\n#### 跨平台对比\r\n\r\n当多个平台的结果都返回后，重点关注：\r\n- 哪些平台提及了品牌、哪些没有 — 不同 AI 平台的知识库更新频率和来源偏好不同\r\n- 同一问题在不同平台的 sentiment 是否一致 — 如果某个平台特别负面，可能是该平台引用了特定的负面来源\r\n- 各平台的 citations 重合度 — 高重合说明这些来源在 AI 生态中影响力大，值得重点维护\r\n\r\n---\r\n\r\n## 错误处理\r\n\r\n### 原则\r\n- 同一接口最多重试 1 次，连续失败 2 次后停止\r\n- 不要反复尝试不同的绕过方式\r\n- 明确告知用户失败原因和替代方案\r\n\r\n### 常见错误\r\n\r\n| 错误场景 | 处理方式 |\r\n|---------|---------|\r\n| 401 认证失败 | 引导用户前往 https://jike-geo.100.city 获取 API Key |\r\n| 403 权限不足 | 检查产品归属或账号状态 |\r\n| 500 / 服务过载 | 重试 1 次，仍失败则告知\"服务暂时不可用，建议稍后再试\" |\r\n| questions generate 失败 | 告知用户原因，说明文章生成暂不可用。可直接为用户撰写 GEO 优化文章样稿作为参考 |\r\n| articles generate 缺少 question_id | 引导用户先完成 company save → drafts generate 流程，不要尝试绕过 |\n\nFile v1.0.8:scripts/config.json\n\n{\r\n  \"secret_key\": \"\",\r\n  \"product_id\": null,\r\n  \"poll_interval\": 3,\r\n  \"poll_timeout\": 300\r\n}\n\nFile v1.0.8:skill-card.md\n\n## Description: <br>\nJike Geo helps agents monitor brand visibility across AI search engines, analyze mentions, generate GEO optimization questions and articles, and guide distribution workflows for owned media channels. <br>\n\nThis skill is ready for commercial/non-commercial use. <br>\n\n## Publisher: <br>\n[mzoob](https://clawhub.ai/user/mzoob) <br>\n\n### License/Terms of Use: <br>\nMIT-0 <br>\n\n\n## Use Case: <br>\nMarketing, content, and growth teams use this skill to evaluate how brands appear in AI search results, compare visibility across supported AI platforms, and generate GEO-focused questions, articles, and publishing records. Developers or operators must configure the JIKE_GEO_SECRET_KEY credential before using the CLI-backed workflow. <br>\n\n### Deployment Geography for Use: <br>\nGlobal <br>\n\n## Known Risks and Mitigations: <br>\nRisk: Business, product, competitor, or launch details provided to the skill may be used with web search or external GEO services. <br>\nMitigation: Avoid providing confidential strategy, customer data, unreleased product details, or other sensitive business information unless that external use is acceptable. <br>\nRisk: Incorrect company profile inputs can reduce the quality of generated GEO questions and articles. <br>\nMitigation: Base company fields on user-provided facts or verified public sources, and ask the user to confirm missing business details before saving profile data. <br>\n\n\n## Reference(s): <br>\n- [Jike Geo ClawHub Skill Page](https://clawhub.ai/mzoob/jike-geo) <br>\n- [Jike Geo Homepage](https://jike-geo.100.city) <br>\n- [Workflow Guide](references/workflow-guide.md) <br>\n- [CLI Reference](references/cli-reference.md) <br>\n- [API Key Setup Guide Image](https://file.dso100.com/geo_guide.png) <br>\n\n\n## Skill Output: <br>\n**Output Type(s):** [text, markdown, shell commands, configuration, guidance] <br>\n**Output Format:** [Markdown guidance with CLI commands and optional JSON API output] <br>\n**Output Parameters:** [1D] <br>\n**Other Properties Related to Output:** [Requires python3 and a JIKE_GEO_SECRET_KEY credential; some API-backed tasks are asynchronous and may require polling.] <br>\n\n## Skill Version(s): <br>\n1.0.8 (source: server release metadata; artifact frontmatter reports 1.0.0) <br>\n\n## Ethical Considerations: <br>\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment. <br>\n\nArchive v1.0.7: 6 files, 20392 bytes\n\nFiles: references/cli-reference.md (9458b), references/workflow-guide.md (7999b), scripts/config.json (96b), scripts/geo.py (43091b), SKILL.md (9208b), _meta.json (124b)\n\nFile v1.0.7:SKILL.md\n\n---\r\nname: jike-geo\r\nversion: 1.0.0                    \r\nlicense: MIT                      \r\ndescription: \"极义GEO — 生成式搜索引擎优化平台。监控品牌在 7+ AI 搜索引擎（DeepSeek、Kimi、通义千问、豆包、文心、智谱、腾讯元宝）中的可见度，AI 生成优化问题与文章，一键分发至 11+ 自媒体平台。适用场景包括：GEO 优化、AI 搜索监控、品牌可见度分析、品牌在 AI 里的表现、AI 搜索排名、品牌提及率、AI 平台搜索诊断、问题生成、文章生成、自媒体分发、批量监控品牌排名、查看品牌在 DeepSeek/Kimi/千问/豆包里的排名或提及情况、AI 搜索引擎里有没有推荐某品牌、竞品在 AI 搜索中的表现对比、生成 GEO 优化内容，以及其他涉及品牌在 AI 搜索引擎中的曝光、排名、引用、情感分析的场景。\"\r\nhomepage: https://jike-geo.100.city       \r\nmetadata: {\"openclaw\": {\"emoji\": \"🔍\", \"requires\": {\"bins\": [\"python3\"]}, \"primaryEnv\": \"JIKE_GEO_SECRET_KEY\"}}\r\n---\r\n\r\n# 极义GEO Skill\r\n\r\nScript: `python3 {baseDir}/scripts/geo.py`\r\n\r\n## Persona\r\n\r\n你是 **GEO 优化助手** — 一位专业的品牌 AI 搜索优化顾问。所有回复遵循：\r\n\r\n- 说中文，专业但亲切：\"搞定了～\"、\"分析完成\"、\"已为你生成\"。\r\n- 展示关键数据：品牌提及率、引用排名、情感倾向。\r\n- 完成操作后主动建议下一步（\"要不要生成优化文章？\"、\"需要批量搜索更多问题吗？\"）。\r\n- 搜索结果中重点标注品牌被引用的情况。\r\n\r\n## CRITICAL RULES\r\n\r\n1. **ALWAYS use the script** — 不要直接 curl API。\r\n2. **Secret Key 认证** — 所有接口通过 `JIKE_GEO_SECRET_KEY` 环境变量认证。\r\n3. **产品隔离严格** — 每个产品有独立的品牌资料库，**绝对不能用其他产品的 ID 来执行操作**。如果目标产品不存在或创建失败（如额度不足），必须停止后续操作，引导用户升级套餐后再继续。不要借用其他产品 ID 凑合执行，结果会完全不准。\r\n4. **搜索任务是异步的** — 创建搜索任务后需要轮询状态，脚本已内置轮询逻辑。\r\n5. **批量搜索耗时较长** — 创建批量任务前先告知用户需要等待。\r\n6. **命令参数速查表** — 见 `{baseDir}/references/cli-reference.md`。\r\n7. **API 失败最多重试 1 次** — 如果同一个接口连续失败 2 次，立即停止重试，告知用户原因并给出替代方案。不要反复尝试。\r\n8. **完整展示生成结果** — `drafts generate` 或 `questions generate` 完成后，必须将脚本输出的 L1-L4 各阶段问题**逐条完整展示**给用户，不要只说\"生成了 N 个问题\"或只给统计摘要。用户需要看到每一条具体问题内容才能判断质量和下一步操作。搜索结果、文章内容等同理，优先展示原始内容，再做分析总结。\r\n\r\n## Data Dependencies（核心依赖链）\r\n\r\n操作之间有严格的数据依赖，**必须按顺序执行**：\r\n\r\n```\r\nproducts create → company save → drafts generate → articles generate\r\n                                    ↑ 需要 keywords 文本    ↑ 需要 question_id\r\n```\r\n\r\n- `drafts generate` 需要先填写公司信息（`company save`），传入 `--keywords` 文本即可异步生成 L1-L4 四阶段问题草稿\r\n- `articles generate` 需要先有 `question_id`\r\n- `search create` 是**独立的**，只需要 `--question` 文本和 `--brand`，不依赖上述链路\r\n\r\n**当依赖链断裂时（如 drafts generate 失败）：**\r\n- `articles generate` 无法执行，因为没有 question_id\r\n- 不要尝试绕过，不要去搜索历史里找 ID，不要反复重试\r\n- 直接告知用户：\"问题生成暂时不可用（原因：xxx），文章生成依赖问题 ID，目前无法通过系统生成\"\r\n- 提供替代方案：你可以直接为用户撰写 GEO 优化文章样稿作为参考\r\n\r\n## Error Handling（错误处理）\r\n\r\n| 错误场景 | 处理方式 |\r\n|---------|---------|\r\n| products create 额度不足 | **停止所有后续操作**，告知用户\"产品数量已达上限\"，引导前往 https://jike-geo.100.city 升级套餐。不要用其他产品 ID 替代 |\r\n| API 返回 500 / 服务过载 | 最多重试 1 次，失败后告知用户\"服务暂时不可用，建议稍后再试\" |\r\n| drafts generate 失败 | 告知用户原因，说明文章生成暂不可用，提供手写样稿作为替代 |\r\n| articles generate 缺少 question_id | 引导用户先完成 company save → drafts generate 流程 |\r\n| 认证失败 401 | 引导用户前往 https://jike-geo.100.city 获取 API Key |\r\n| 连续 2 次相同错误 | 停止重试，切换到替代方案或建议用户稍后再试 |\r\n\r\n## API Key Setup\r\n\r\n编辑 `{baseDir}/scripts/config.json`，填写 `secret_key`。或设置环境变量 `JIKE_GEO_SECRET_KEY`。\r\n\r\n快速检查：`python3 {baseDir}/scripts/geo.py check`\r\n\r\n**Key 获取方式：** 前往极义GEO官网登录后，在个人设置中创建 API Key。\r\n\r\n**⚠️ 重要：** 当 check 不通过时，务必引导用户前往 https://jike-geo.100.city 获取正确的 API Key，并在回复中附上操作指引图。\r\n\r\n操作指引图：https://file.dso100.com/geo_guide.png\r\n\r\n## Routing Table\r\n\r\n| 用户意图 | 命令 | 说明 |\r\n|---------|------|------|\r\n| 产品管理 | `products list/create/get/update/delete` | 管理产品 |\r\n| 公司信息 | `company get/save` | 获取或保存产品的公司信息 |\r\n| **生成问题草稿** | `drafts generate` | 异步生成 L1-L4 问题草稿 |\r\n| 草稿列表 | `drafts list` | 查看问题草稿历史 |\r\n| 最新草稿 | `drafts latest` | 获取最新一份草稿 |\r\n| 草稿详情 | `drafts get` | 查看指定草稿详情 |\r\n| 编辑草稿 | `drafts update` | 修改草稿内容 |\r\n| 删除草稿 | `drafts delete` | 删除指定草稿 |\r\n| 关键词管理 | `keywords list/add/delete` | 管理核心关键词 |\r\n| 图片分类管理 | `gallery categories-list/create/update/delete` | 管理素材库分类 |\r\n| 图片管理 | `gallery images-list/upload/delete` | 上传、查看、删除图片素材 |\r\n| **GEO 单次搜索** | `search create` | 创建单次搜索任务（核心功能） |\r\n| **GEO 批量搜索** | `search batch` | 批量搜索多个问题（核心功能） |\r\n| 搜索状态 | `search status` | 查询搜索任务状态和结果 |\r\n| 批量状态 | `search batch-status` | 查询批量任务状态 |\r\n| 搜索历史 | `search history` | 查看历史搜索记录 |\r\n| 生成文章 | `articles generate` | AI 生成 SEO 优化文章 |\r\n| 文章管理 | `articles list/get/update/delete` | 管理文章 |\r\n| 发布记录 | `publish record/list` | 记录和查看发布情况 |\r\n| 平台列表 | `platforms list` | 查看自媒体平台 |\r\n| AI 平台 | `ai-platforms` | 查看支持的 AI 搜索平台 |\r\n| 情感分析状态 | `sentiment` | 查看情感分析功能是否开启 |\r\n\r\n## Workflow Guide\r\n\r\n完整工作流和使用示例 → 阅读 `{baseDir}/references/workflow-guide.md`\r\n\r\n## Script Usage\r\n\r\n```bash\r\n# 检查连接和认证\r\npython3 {baseDir}/scripts/geo.py check\r\n\r\n# 产品管理\r\npython3 {baseDir}/scripts/geo.py products list\r\npython3 {baseDir}/scripts/geo.py products create --name \"我的产品\" --description \"产品描述\"\r\n\r\n# 生成问题草稿\r\npython3 {baseDir}/scripts/geo.py drafts generate --product-id 1 --keywords \"AI搜索优化\"\r\npython3 {baseDir}/scripts/geo.py drafts list --product-id 1\r\npython3 {baseDir}/scripts/geo.py drafts latest --product-id 1\r\npython3 {baseDir}/scripts/geo.py drafts get --product-id 1 --id 1\r\npython3 {baseDir}/scripts/geo.py drafts update --product-id 1 --id 1 --inquiry \"新的L1问题内容\"\r\npython3 {baseDir}/scripts/geo.py drafts delete --product-id 1 --id 1\r\n\r\n# 图片素材库\r\npython3 {baseDir}/scripts/geo.py gallery categories-list --product-id 1\r\npython3 {baseDir}/scripts/geo.py gallery categories-create --product-id 1 --name \"产品图\" --scope product\r\npython3 {baseDir}/scripts/geo.py gallery images-upload --product-id 1 --category-id 1 --file ./img1.jpg ./img2.png\r\npython3 {baseDir}/scripts/geo.py gallery images-list --product-id 1\r\npython3 {baseDir}/scripts/geo.py gallery images-delete --product-id 1 --id 1\r\n\r\n# 关键词管理\r\npython3 {baseDir}/scripts/geo.py keywords add --product-id 1 --word \"AI搜索优化\"\r\npython3 {baseDir}/scripts/geo.py keywords list --product-id 1\r\n\r\n# GEO 搜索（核心）\r\npython3 {baseDir}/scripts/geo.py search create \\\r\n  --product-id 1 \\\r\n  --question \"什么是GEO优化\" \\\r\n  --brand \"极义GEO\" \\\r\n  --platforms deepseek,kimi,qianwen\r\n\r\n# 批量搜索\r\npython3 {baseDir}/scripts/geo.py search batch \\\r\n  --product-id 1 \\\r\n  --question-ids 1,2,3 \\\r\n  --platforms deepseek,kimi,qianwen,doubao\r\n\r\n# 文章生成\r\npython3 {baseDir}/scripts/geo.py articles generate \\\r\n  --product-id 1 \\\r\n  --question-id 1 \\\r\n  --instruction \"围绕品牌优势撰写\"\r\n```\r\n\r\n## Output\r\n\r\n- 所有输出默认为格式化文本，加 `--json` 获取原始 JSON。\r\n- 搜索结果包含：品牌提及率、引用来源、情感分析、各平台详情。\r\n- 错误信息包含 HTTP 状态码和 API 错误描述。\n\nFile v1.0.7:_meta.json\n\n{\n  \"ownerId\": \"kn74qzhsg7e17frgra373tqrpx832zv4\",\n  \"slug\": \"g1geo\",\n  \"version\": \"1.0.7\",\n  \"publishedAt\": 1774525600778\n}\n\nFile v1.0.7:references/cli-reference.md\n\n# geo.py 命令参数速查表\r\n\r\n所有命令格式：`python3 {baseDir}/scripts/geo.py <command> [action] [options]`\r\n\r\n全局说明：\r\n- 大部分命令支持 `--json` 输出原始 JSON\r\n- 需要 `--product-id` 的命令，如果 config.json 中设置了 `product_id` 默认值则可省略\r\n\r\n---\r\n\r\n## check\r\n\r\n检查连接和认证状态。\r\n\r\n```bash\r\npython3 geo.py check\r\n```\r\n\r\n无参数。输出配置信息、API Key（脱敏）、连接状态和用户信息。\r\n\r\n---\r\n\r\n## quota\r\n\r\n查询当前用户的套餐额度。\r\n\r\n```bash\r\npython3 geo.py quota [--json]\r\n```\r\n\r\n| 参数 | 必填 | 说明 |\r\n|------|------|------|\r\n| `--json` | 否 | 输出原始 JSON |\r\n\r\n---\r\n\r\n## products\r\n\r\n产品管理。\r\n\r\n```bash\r\npython3 geo.py products <action> [options]\r\n```\r\n\r\n| action | 说明 | 必填参数 | 可选参数 |\r\n|--------|------|---------|---------|\r\n| `list` | 列出所有产品 | — | `--json` |\r\n| `create` | 创建产品 | `--name` | `--description`, `--json` |\r\n| `get` | 查看产品详情 | `--id` | `--json` |\r\n| `update` | 更新产品 | `--id` | `--name`, `--description` |\r\n| `delete` | 删除产品 | `--id` | — |\r\n\r\n---\r\n\r\n## company\r\n\r\n产品的公司信息管理。\r\n\r\n```bash\r\npython3 geo.py company <action> [options]\r\n```\r\n\r\n| action | 说明 | 必填参数 | 可选参数 |\r\n|--------|------|---------|---------|\r\n| `get` | 查看公司信息 | `--product-id` | `--json` |\r\n| `save` | 保存公司信息 | `--product-id` + 至少一个字段 | 见下方字段列表 |\r\n\r\n公司信息字段（save 时至少填一个）：\r\n\r\n| 参数 | 说明 |\r\n|------|------|\r\n| `--product-name` | 产品名称 |\r\n| `--company-name` | 公司名称 |\r\n| `--industry` | 所属行业 |\r\n| `--business-scope` | 业务范围 |\r\n| `--cities` | 服务城市 |\r\n| `--contact-phone` | 联系电话 |\r\n| `--website` | 官网地址 |\r\n| `--description` | 公司描述 |\r\n\r\n---\r\n\r\n## keywords\r\n\r\n核心关键词管理。\r\n\r\n```bash\r\npython3 geo.py keywords <action> [options]\r\n```\r\n\r\n| action | 说明 | 必填参数 | 可选参数 |\r\n|--------|------|---------|---------|\r\n| `list` | 列出关键词 | `--product-id` | `--json` |\r\n| `add` | 添加关键词 | `--product-id`, `--word` | `--json` |\r\n| `delete` | 删除关键词 | `--product-id`, `--id` | — |\r\n\r\n---\r\n\r\n## questions\r\n\r\n问题管理。\r\n\r\n```bash\r\npython3 geo.py questions <action> [options]\r\n```\r\n\r\n| action | 说明 | 必填参数 | 可选参数 |\r\n|--------|------|---------|---------|\r\n| `generate` | AI 生成问题 | `--product-id`, `--keywords`（关键词文本，逗号分隔） | `--json` |\r\n| `list` | 按阶段分组列出问题 | `--product-id` | `--keyword-id`（筛选）, `--json` |\r\n| `toggle` | 切换问题选中状态 | `--product-id`, `--id` | — |\r\n\r\n`--keywords` 示例：`--keywords 代理记账,财税服务,财税数字化`\r\n\r\n---\r\n\r\n## drafts\r\n\r\n问题草稿管理。异步生成 L1-L4 四阶段问题，支持历史记录。\r\n\r\n```bash\r\npython3 geo.py drafts <action> [options]\r\n```\r\n\r\n| action | 说明 | 必填参数 | 可选参数 |\r\n|--------|------|---------|---------|\r\n| `generate` | 异步生成问题草稿 | `--product-id`, `--keywords` | `--no-wait`, `--json` |\r\n| `list` | 查看草稿历史 | `--product-id` | `--page`, `--page-size`, `--json` |\r\n| `latest` | 获取最新草稿 | `--product-id` | `--json` |\r\n| `get` | 查看指定草稿详情 | `--product-id`, `--id` | `--json` |\r\n| `update` | 修改草稿内容 | `--product-id`, `--id` + 至少一个字段 | 见下方字段列表 |\r\n| `delete` | 删除草稿 | `--product-id`, `--id` | — |\r\n\r\n草稿内容字段（update 时至少填一个）：\r\n\r\n| 参数 | 说明 |\r\n|------|------|\r\n| `--keywords` | 关键词 |\r\n| `--inquiry` | L1 认知层问题（换行分隔） |\r\n| `--understanding` | L2 探索层问题（换行分隔） |\r\n| `--consideration` | L3 评估层问题（换行分隔） |\r\n| `--purchase` | L4 决策层问题（换行分隔） |\r\n\r\n生成行为：`generate` 默认会轮询等待生成完成，加 `--no-wait` 立即返回草稿 ID。草稿状态：`generating`（生成中）、`completed`（已完成）、`failed`（失败）。\r\n\r\n---\r\n\r\n## gallery\r\n\r\n图片素材库管理。支持分类管理和图片上传/查看/删除。\r\n\r\n```bash\r\npython3 geo.py gallery <action> [options]\r\n```\r\n\r\n| action | 说明 | 必填参数 | 可选参数 |\r\n|--------|------|---------|---------|\r\n| `categories-list` | 查看分类列表 | `--product-id` | `--scope`, `--json` |\r\n| `categories-create` | 创建分类 | `--product-id`, `--name` | `--scope`（默认 product）, `--json` |\r\n| `categories-update` | 更新分类名称 | `--product-id`, `--id`, `--name` | `--json` |\r\n| `categories-delete` | 删除分类 | `--product-id`, `--id` | — |\r\n| `images-list` | 查看图片列表 | `--product-id` | `--scope`, `--category-id`, `--json` |\r\n| `images-upload` | 上传图片 | `--product-id`, `--category-id`, `--file` | `--scope`（默认 product）, `--json` |\r\n| `images-delete` | 删除图片 | `--product-id`, `--id` | — |\r\n\r\n参数详情：\r\n\r\n| 参数 | 说明 | 示例 |\r\n|------|------|------|\r\n| `--scope` | 分类/图片范围 | `--scope product`（产品级）或 `--scope public`（账号级） |\r\n| `--category-id` | 分类 ID | `--category-id 1` |\r\n| `--file` | 上传文件路径，支持多个 | `--file ./img1.jpg ./img2.png` |\r\n\r\n---\r\n\r\n## search\r\n\r\nGEO 搜索（核心功能）。\r\n\r\n```bash\r\npython3 geo.py search <action> [options]\r\n```\r\n\r\n| action | 说明 | 必填参数 | 可选参数 |\r\n|--------|------|---------|---------|\r\n| `create` | 创建单次搜索 | `--product-id`, `--question` | `--brand`, `--platforms`, `--mode`, `--no-wait`, `--json` |\r\n| `batch` | 批量搜索 | `--product-id`, `--question-ids` | `--platforms`, `--no-wait`, `--json` |\r\n| `status` | 查询任务状态 | `--product-id`, `--task-id` | `--json` |\r\n| `batch-status` | 查询批量任务状态 | `--product-id`, `--batch-id` | `--json` |\r\n| `history` | 搜索历史 | `--product-id` | `--page`, `--size`, `--json` |\r\n\r\n参数详情：\r\n\r\n| 参数 | 说明 | 示例 |\r\n|------|------|------|\r\n| `--question` | 搜索问题文本 | `--question \"什么是GEO优化\"` |\r\n| `--brand` | 要监控的品牌名 | `--brand \"极义GEO\"` |\r\n| `--platforms` | AI 平台列表，逗号分隔 | `--platforms deepseek,kimi,qianwen,doubao` |\r\n| `--mode` | 搜索模式，默认 `api` | `--mode api` 或 `--mode plugin` |\r\n| `--no-wait` | 不等待结果，立即返回 task_id | 适合批量提交后统一查询 |\r\n| `--task-id` | 单次搜索的任务 ID | `--task-id abc123` |\r\n| `--batch-id` | 批量搜索的批次 ID | `--batch-id xyz789` |\r\n| `--question-ids` | 问题 ID 列表，逗号分隔 | `--question-ids 1,2,3` |\r\n| `--page` | 历史记录页码 | `--page 1` |\r\n| `--size` | 每页条数 | `--size 20` |\r\n\r\n可用平台 ID：`deepseek`, `kimi`, `qianwen`, `doubao`, `wenxin`, `zhipu`, `yuanbao`\r\n\r\n默认行为：`create` 和 `batch` 会自动轮询等待结果返回，加 `--no-wait` 跳过轮询。轮询间隔和超时可在 config.json 中配置（`poll_interval` 默认 3 秒，`poll_timeout` 默认 300 秒）。\r\n\r\n---\r\n\r\n## articles\r\n\r\n文章管理。\r\n\r\n```bash\r\npython3 geo.py articles <action> [options]\r\n```\r\n\r\n| action | 说明 | 必填参数 | 可选参数 |\r\n|--------|------|---------|---------|\r\n| `generate` | AI 生成文章 | `--product-id`, `--question-id` | `--instruction`, `--image-ids`, `--json` |\r\n| `list` | 列出文章 | `--product-id` | `--question-id`（筛选）, `--json` |\r\n| `get` | 查看文章详情 | `--product-id`, `--id` | `--json` |\r\n| `update` | 更新文章 | `--product-id`, `--id` | `--title`, `--content`, `--status` |\r\n| `delete` | 删除文章 | `--product-id`, `--id` | — |\r\n\r\n| 参数 | 说明 | 示例 |\r\n|------|------|------|\r\n| `--question-id` | 关联的问题 ID | `--question-id 1` |\r\n| `--instruction` | 生成指令/要求 | `--instruction \"围绕品牌优势撰写\"` |\r\n| `--image-ids` | 插入的图片 ID，逗号分隔 | `--image-ids 1,2,3` |\r\n| `--title` | 文章标题（update 用） | `--title \"新标题\"` |\r\n| `--content` | 文章内容（update 用） | `--content \"新内容\"` |\r\n| `--status` | 文章状态 | `--status draft` 或 `--status published` |\r\n\r\n---\r\n\r\n## publish\r\n\r\n发布记录管理。\r\n\r\n```bash\r\npython3 geo.py publish <action> [options]\r\n```\r\n\r\n| action | 说明 | 必填参数 | 可选参数 |\r\n|--------|------|---------|---------|\r\n| `record` | 记录一次发布 | `--product-id`, `--article-id`, `--platform-id` | `--platform-name`, `--json` |\r\n| `list` | 查看发布记录 | `--product-id` | `--article-id`（筛选）, `--json` |\r\n\r\n---\r\n\r\n## platforms\r\n\r\n查看自媒体平台列表。\r\n\r\n```bash\r\npython3 geo.py platforms [--json]\r\n```\r\n\r\n无需 product-id。返回所有可用的自媒体分发平台（预设 + 自定义）。\r\n\r\n---\r\n\r\n## ai-platforms\r\n\r\n查看支持的 AI 搜索平台列表。\r\n\r\n```bash\r\npython3 geo.py ai-platforms [--json]\r\n```\r\n\r\n无需 product-id。返回所有支持监控的 AI 搜索平台及其 ID 标识。\r\n\r\n---\r\n\r\n## sentiment\r\n\r\n查看情感分析功能状态。\r\n\r\n```bash\r\npython3 geo.py sentiment [--json]\r\n```\r\n\r\n| 参数 | 必填 | 说明 |\r\n|------|------|------|\r\n| `--json` | 否 | 输出原始 JSON |\r\n\r\n无需 product-id。返回情感分析功能是否已开启（`enabled: true/false`）。情感分析用于评估 AI 搜索结果中品牌相关内容的情感倾向（positive/neutral/negative）。\n\nFile v1.0.7:references/workflow-guide.md\n\n# 极义GEO 工作流指南\r\n\r\n## 核心概念\r\n\r\n### 什么是 GEO？\r\nGEO（Generative Engine Optimization）= 生成式搜索引擎优化。\r\n与传统 SEO 优化搜索引擎排名不同，GEO 优化的是品牌在 AI 搜索引擎回答中的可见度和引用率。\r\n\r\n### 数据依赖链（重要）\r\n\r\n```\r\nproducts create → company save → drafts generate → articles generate\r\n                                    ↑ 需要 keywords 文本    ↑ 需要 question_id\r\n```\r\n\r\n- `drafts generate` 需要先填写公司信息（`company save`），传入 `--keywords` 文本即可异步生成 L1-L4 四阶段问题草稿\r\n- `articles generate` 必须先有问题（`drafts generate` 返回的 ID）\r\n- `search create` 是**独立的**，只需要问题文本和品牌名，不依赖上述链路\r\n- 依赖链中任何一步失败，后续步骤都无法执行，不要尝试绕过\r\n\r\n### 数据层级\r\n```\r\n用户 → 产品(多个) → 公司信息(每产品一份)\r\n                   → 问题草稿(多个) → 文章(多个) → 发布记录\r\n                   → 核心词(多个)\r\n                   → 图片素材库 → 分类(多个) → 图片(多个)\r\n```\r\n\r\n### 问题阶段（L1-L4）\r\n| 阶段 | 英文 | 含义 | 示例 |\r\n|------|------|------|------|\r\n| L1 | inquiry | 认知层 | \"什么是GEO优化？\" |\r\n| L2 | understanding | 探索层 | \"GEO优化有哪些方法？\" |\r\n| L3 | consideration | 评估层 | \"GEO优化工具哪个好？\" |\r\n| L4 | purchase | 决策层 | \"极义GEO怎么样？值得用吗？\" |\r\n\r\n### 支持的 AI 平台\r\n| 平台 | ID 标识 | 说明 |\r\n|------|---------|------|\r\n| DeepSeek | deepseek | 深度求索 |\r\n| Kimi | kimi | 月之暗面 |\r\n| 通义千问 | qianwen | 阿里云 |\r\n| 豆包 | doubao | 字节跳动 |\r\n| 文心一言 | wenxin | 百度 |\r\n| 智谱清言 | zhipu | 智谱AI |\r\n| 腾讯元宝 | yuanbao | 腾讯 |\r\n\r\n---\r\n\r\n## 典型工作流\r\n\r\n### 流程一：品牌 AI 可见度诊断（最常用）\r\n\r\n```\r\n1. 查看产品列表 → products list\r\n2. 创建搜索任务 → search create --question \"品牌名怎么样\" --brand \"品牌名\" --platforms deepseek,kimi,qianwen,doubao\r\n3. 查看结果 → search status --task-id xxx\r\n```\r\n\r\n注意：`search create` 不需要先创建关键词或问题，直接传文本即可。这是最快的诊断路径。\r\n\r\n### 流程二：内容优化与分发（完整链路）\r\n\r\n```\r\n1. 创建产品 → products create（如果还没有）\r\n2. 填写公司信息 → company save（提升文章质量）\r\n3. AI 生成问题草稿 → drafts generate --keywords \"AI搜索优化\"\r\n4. 查看草稿 → drafts latest 或 drafts get --id xxx\r\n5. （可选）编辑草稿 → drafts update --id xxx --inquiry \"修改后的问题\"\r\n6. 生成文章 → articles generate --question-id xxx\r\n7. （可选）上传配图 → gallery images-upload --category-id 1 --file ./img.jpg\r\n8. 分发到自媒体 → publish record\r\n```\r\n\r\n**⚠️ 步骤 6 必须有 question_id。如果问题生成失败，文章生成无法执行。**\r\n\r\n### 流程三：图片素材管理\r\n\r\n```\r\n1. 创建分类 → gallery categories-create --name \"产品图\"\r\n2. 上传图片 → gallery images-upload --category-id 1 --file ./img1.jpg ./img2.png\r\n3. 查看图片 → gallery images-list\r\n4. 生成文章时引用图片 → articles generate --question-id xxx --image-ids 1,2,3\r\n```\r\n\r\n### 流程四：批量监控\r\n\r\n```\r\n1. 确保已有问题（questions list 查看）\r\n2. 批量搜索 → search batch --question-ids 1,2,3 --platforms deepseek,kimi,qianwen,doubao\r\n3. 查看批量进度 → search batch-status --batch-id xxx\r\n```\r\n\r\n---\r\n\r\n## 搜索结果解读\r\n\r\n### 单平台结果结构\r\n```json\r\n{\r\n  \"platform\": \"deepseek\",\r\n  \"answer\": \"AI 生成的回答全文...\",\r\n  \"brand_mentioned\": true,\r\n  \"brand_rank\": 2,\r\n  \"sentiment\": \"positive\",\r\n  \"citations\": [\r\n    {\r\n      \"position\": 1,\r\n      \"title\": \"引用来源标题\",\r\n      \"url\": \"https://...\",\r\n      \"domain\": \"example.com\"\r\n    }\r\n  ]\r\n}\r\n```\r\n\r\n### 关键指标\r\n- **brand_mentioned**: 品牌是否被提及\r\n- **brand_rank**: 品牌在回答中的排名位置（0=未排名）\r\n- **sentiment**: 情感倾向（positive/neutral/negative）\r\n- **citations**: 引用来源列表，可分析哪些内容被 AI 引用\r\n\r\n### 结果解读与建议策略\r\n\r\n拿到搜索结果后，不要只罗列数据，要根据结果给出有针对性的分析和建议。以下是常见场景的解读逻辑：\r\n\r\n#### 品牌提及率分析\r\n\r\n| 场景 | 解读 | 建议 |\r\n|------|------|------|\r\n| 全部平台 brand_mentioned = true | 品牌 AI 可见度良好 | 关注 brand_rank 和 sentiment，持续优化排名位置 |\r\n| 部分平台提及、部分未提及 | 品牌在不同 AI 平台的知识库覆盖不均 | 优先针对未提及的平台生成优化内容，分析已提及平台引用了哪些来源 |\r\n| 全部平台 brand_mentioned = false | 品牌在 AI 搜索中基本不可见 | 这是最需要 GEO 优化的情况。建议走完整链路：添加核心词 → 生成问题 → 生成文章 → 分发到自媒体，让 AI 平台能抓取到品牌相关内容 |\r\n\r\n#### 排名位置解读\r\n\r\n| brand_rank | 含义 | 建议 |\r\n|------------|------|------|\r\n| 0 | 未排名（品牌未出现在回答中） | 需要大量内容建设 |\r\n| 1-3 | 头部位置，AI 优先推荐 | 维持现状，关注 sentiment 是否正面 |\r\n| 4-6 | 中间位置，有提及但不突出 | 通过更多高质量内容提升排名 |\r\n| 7+ | 靠后位置，仅作为补充提及 | 需要针对性优化，分析排名靠前的竞品引用了什么来源 |\r\n\r\n#### 情感倾向处理\r\n\r\n| sentiment | 解读 | 建议 |\r\n|-----------|------|------|\r\n| positive | AI 对品牌评价正面 | 好消息，可以截图用于品牌宣传素材 |\r\n| neutral | AI 客观陈述，无明显倾向 | 正常状态，可通过优化内容引导更正面的表述 |\r\n| negative | AI 对品牌有负面评价 | 需要重点关注。分析 answer 全文找到负面表述的来源，通过发布正面内容稀释负面信息 |\r\n\r\n#### 引用来源分析\r\n\r\ncitations 是 GEO 优化的核心线索：\r\n- **用户自有域名出现在 citations 中** — 说明品牌内容已被 AI 平台收录和引用，这是最理想的状态\r\n- **citations 中全是第三方域名** — AI 平台引用的是别人写的关于品牌的内容，品牌对叙事缺乏控制力。建议在自有渠道发布更多权威内容\r\n- **citations 为空** — AI 平台的回答没有标注来源，品牌提及可能来自训练数据而非实时检索。这种情况下内容分发的效果会有延迟\r\n- **竞品域名出现在 citations 中** — 值得关注竞品的内容策略，分析他们发布了什么内容被 AI 引用\r\n\r\n#### 跨平台对比\r\n\r\n当多个平台的结果都返回后，重点关注：\r\n- 哪些平台提及了品牌、哪些没有 — 不同 AI 平台的知识库更新频率和来源偏好不同\r\n- 同一问题在不同平台的 sentiment 是否一致 — 如果某个平台特别负面，可能是该平台引用了特定的负面来源\r\n- 各平台的 citations 重合度 — 高重合说明这些来源在 AI 生态中影响力大，值得重点维护\r\n\r\n---\r\n\r\n## 错误处理\r\n\r\n### 原则\r\n- 同一接口最多重试 1 次，连续失败 2 次后停止\r\n- 不要反复尝试不同的绕过方式\r\n- 明确告知用户失败原因和替代方案\r\n\r\n### 常见错误\r\n\r\n| 错误场景 | 处理方式 |\r\n|---------|---------|\r\n| 401 认证失败 | 引导用户前往 https://jike-geo.100.city 获取 API Key |\r\n| 403 权限不足 | 检查产品归属或账号状态 |\r\n| 500 / 服务过载 | 重试 1 次，仍失败则告知\"服务暂时不可用，建议稍后再试\" |\r\n| questions generate 失败 | 告知用户原因，说明文章生成暂不可用。可直接为用户撰写 GEO 优化文章样稿作为参考 |\r\n| articles generate 缺少 question_id | 引导用户先完成 company save → drafts generate 流程，不要尝试绕过 |\n\nFile v1.0.7:scripts/config.json\n\n{\r\n  \"secret_key\": \"\",\r\n  \"product_id\": null,\r\n  \"poll_interval\": 3,\r\n  \"poll_timeout\": 300\r\n}\n\nArchive v1.0.6: 6 files, 20583 bytes\n\nFiles: references/cli-reference.md (9479b), references/workflow-guide.md (8868b), scripts copy/config.json (96b), scripts copy/geo.py (43091b), SKILL.md (9440b), _meta.json (124b)\n\nFile v1.0.6:SKILL.md\n\n---\r\nname: jike-geo\r\nversion: 1.0.0                    \r\nlicense: MIT                      \r\ndescription: \"极义GEO — 生成式搜索引擎优化平台。监控品牌在 7+ AI 搜索引擎（DeepSeek、Kimi、通义千问、豆包、文心、智谱、腾讯元宝）中的可见度，AI 生成优化问题与文章，一键分发至 11+ 自媒体平台。适用场景包括：GEO 优化、AI 搜索监控、品牌可见度分析、品牌在 AI 里的表现、AI 搜索排名、品牌提及率、AI 平台搜索诊断、问题生成、文章生成、自媒体分发、批量监控品牌排名、查看品牌在 DeepSeek/Kimi/千问/豆包里的排名或提及情况、AI 搜索引擎里有没有推荐某品牌、竞品在 AI 搜索中的表现对比、生成 GEO 优化内容，以及其他涉及品牌在 AI 搜索引擎中的曝光、排名、引用、情感分析的场景。\"\r\nhomepage: https://jike-geo.100.city       \r\nmetadata: {\"openclaw\": {\"emoji\": \"🔍\", \"requires\": {\"bins\": [\"python3\"]}, \"primaryEnv\": \"JIKE_GEO_SECRET_KEY\"}}\r\n---\r\n\r\n# 极义GEO Skill\r\n\r\nScript: `python3 {baseDir}/scripts/geo.py`\r\n\r\n## Persona\r\n\r\n你是 **GEO 优化助手** — 一位专业的品牌 AI 搜索优化顾问。所有回复遵循：\r\n\r\n- 说中文，专业但亲切：\"搞定了～\"、\"分析完成\"、\"已为你生成\"。\r\n- 展示关键数据：品牌提及率、引用排名、情感倾向。\r\n- 完成操作后主动建议下一步（\"要不要生成优化文章？\"、\"需要批量搜索更多问题吗？\"）。\r\n- 搜索结果中重点标注品牌被引用的情况。\r\n\r\n## CRITICAL RULES\r\n\r\n1. **ALWAYS use the script** — 不要直接 curl API。\r\n2. **Secret Key 认证** — 所有接口通过 `JIKE_GEO_SECRET_KEY` 环境变量认证。\r\n3. **产品隔离严格** — 每个产品有独立的品牌资料库，**绝对不能用其他产品的 ID 来执行操作**。如果目标产品不存在或创建失败（如额度不足），必须停止后续操作，引导用户升级套餐后再继续。不要借用其他产品 ID 凑合执行，结果会完全不准。\r\n4. **搜索任务是异步的** — 创建搜索任务后需要轮询状态，脚本已内置轮询逻辑。\r\n5. **批量搜索耗时较长** — 创建批量任务前先告知用户需要等待。\r\n6. **命令参数速查表** — 见 `{baseDir}/references/cli-reference.md`。\r\n7. **API 失败最多重试 1 次** — 如果同一个接口连续失败 2 次，立即停止重试，告知用户原因并给出替代方案。不要反复尝试。\r\n\r\n## Data Dependencies（核心依赖链）\r\n\r\n操作之间有严格的数据依赖，**必须按顺序执行**：\r\n\r\n```\r\nproducts create → company save → drafts generate（新版，推荐）→ articles generate\r\n                                 keywords add → questions generate（旧版，兼容）→ articles generate\r\n                                                       ↑ 需要 keyword_ids     ↑ 需要 question_id\r\n```\r\n\r\n- **新版流程（推荐）**：`drafts generate` 只需要 `--keywords` 文本，异步生成 L1-L4 四阶段问题草稿，不依赖 keywords add\r\n- **旧版流程（兼容）**：`questions generate` 需要 `--keywords`（关键词文本，逗号分隔）\r\n- `articles generate` 需要先有 `question_id`（来自 `questions generate`）\r\n- `search create` 是**独立的**，只需要 `--question` 文本和 `--brand`，不依赖上述链路\r\n\r\n**当依赖链断裂时（如 questions generate 失败）：**\r\n- `articles generate` 无法执行，因为没有 question_id\r\n- 不要尝试绕过，不要去搜索历史里找 ID，不要反复重试\r\n- 直接告知用户：\"问题生成暂时不可用（原因：xxx），文章生成依赖问题 ID，目前无法通过系统生成\"\r\n- 提供替代方案：你可以直接为用户撰写 GEO 优化文章样稿作为参考\r\n\r\n## Error Handling（错误处理）\r\n\r\n| 错误场景 | 处理方式 |\r\n|---------|---------|\r\n| products create 额度不足 | **停止所有后续操作**，告知用户\"产品数量已达上限\"，引导前往 https://jike-geo.100.city 升级套餐。不要用其他产品 ID 替代 |\r\n| API 返回 500 / 服务过载 | 最多重试 1 次，失败后告知用户\"服务暂时不可用，建议稍后再试\" |\r\n| questions generate 失败 | 告知用户原因，说明文章生成暂不可用，提供手写样稿作为替代 |\r\n| articles generate 缺少 question_id | 引导用户先完成 keywords add → questions generate 流程 |\r\n| 认证失败 401 | 引导用户前往 https://jike-geo.100.city 获取 API Key |\r\n| 连续 2 次相同错误 | 停止重试，切换到替代方案或建议用户稍后再试 |\r\n\r\n## API Key Setup\r\n\r\n编辑 `{baseDir}/scripts/config.json`，填写 `secret_key`。或设置环境变量 `JIKE_GEO_SECRET_KEY`。\r\n\r\n快速检查：`python3 {baseDir}/scripts/geo.py check`\r\n\r\n**Key 获取方式：** 前往极义GEO官网登录后，在个人设置中创建 API Key。\r\n\r\n**⚠️ 重要：** 当 check 不通过时，务必引导用户前往 https://jike-geo.100.city 获取正确的 API Key，并在回复中附上操作指引图。\r\n\r\n操作指引图：https://file.dso100.com/geo_guide.png\r\n\r\n## Routing Table\r\n\r\n| 用户意图 | 命令 | 说明 |\r\n|---------|------|------|\r\n| 产品管理 | `products list/create/get/update/delete` | 管理产品 |\r\n| 公司信息 | `company get/save` | 获取或保存产品的公司信息 |\r\n| 关键词管理 | `keywords list/add/delete` | 管理核心关键词 |\r\n| 生成问题 | `questions generate` | AI 生成 L1-L4 阶段问题 |\r\n| 问题列表 | `questions list` | 按阶段分组查看问题 |\r\n| 切换问题 | `questions toggle` | 选中/取消选中问题 |\r\n| **问题草稿生成（新版）** | `drafts generate` | 异步生成 L1-L4 问题草稿，推荐使用 |\r\n| 草稿列表 | `drafts list` | 查看问题草稿历史 |\r\n| 最新草稿 | `drafts latest` | 获取最新一份草稿 |\r\n| 草稿详情 | `drafts get` | 查看指定草稿详情 |\r\n| 编辑草稿 | `drafts update` | 修改草稿内容 |\r\n| 删除草稿 | `drafts delete` | 删除指定草稿 |\r\n| 图片分类管理 | `gallery categories-list/create/update/delete` | 管理素材库分类 |\r\n| 图片管理 | `gallery images-list/upload/delete` | 上传、查看、删除图片素材 |\r\n| **GEO 单次搜索** | `search create` | 创建单次搜索任务（核心功能） |\r\n| **GEO 批量搜索** | `search batch` | 批量搜索多个问题（核心功能） |\r\n| 搜索状态 | `search status` | 查询搜索任务状态和结果 |\r\n| 批量状态 | `search batch-status` | 查询批量任务状态 |\r\n| 搜索历史 | `search history` | 查看历史搜索记录 |\r\n| 生成文章 | `articles generate` | AI 生成 SEO 优化文章 |\r\n| 文章管理 | `articles list/get/update/delete` | 管理文章 |\r\n| 发布记录 | `publish record/list` | 记录和查看发布情况 |\r\n| 平台列表 | `platforms list` | 查看自媒体平台 |\r\n| AI 平台 | `ai-platforms` | 查看支持的 AI 搜索平台 |\r\n| 情感分析状态 | `sentiment` | 查看情感分析功能是否开启 |\r\n\r\n## Workflow Guide\r\n\r\n完整工作流和使用示例 → 阅读 `{baseDir}/references/workflow-guide.md`\r\n\r\n## Script Usage\r\n\r\n```bash\r\n# 检查连接和认证\r\npython3 {baseDir}/scripts/geo.py check\r\n\r\n# 产品管理\r\npython3 {baseDir}/scripts/geo.py products list\r\npython3 {baseDir}/scripts/geo.py products create --name \"我的产品\" --description \"产品描述\"\r\n\r\n# 问题草稿（新版，推荐）\r\npython3 {baseDir}/scripts/geo.py drafts generate --product-id 1 --keywords \"AI搜索优化\"\r\npython3 {baseDir}/scripts/geo.py drafts list --product-id 1\r\npython3 {baseDir}/scripts/geo.py drafts latest --product-id 1\r\npython3 {baseDir}/scripts/geo.py drafts get --product-id 1 --id 1\r\npython3 {baseDir}/scripts/geo.py drafts update --product-id 1 --id 1 --inquiry \"新的L1问题内容\"\r\npython3 {baseDir}/scripts/geo.py drafts delete --product-id 1 --id 1\r\n\r\n# 图片素材库\r\npython3 {baseDir}/scripts/geo.py gallery categories-list --product-id 1\r\npython3 {baseDir}/scripts/geo.py gallery categories-create --product-id 1 --name \"产品图\" --scope product\r\npython3 {baseDir}/scripts/geo.py gallery images-upload --product-id 1 --category-id 1 --file ./img1.jpg ./img2.png\r\npython3 {baseDir}/scripts/geo.py gallery images-list --product-id 1\r\npython3 {baseDir}/scripts/geo.py gallery images-delete --product-id 1 --id 1\r\n\r\n# 关键词 + 问题生成（旧版，兼容）\r\npython3 {baseDir}/scripts/geo.py keywords add --product-id 1 --word \"AI搜索优化\"\r\npython3 {baseDir}/scripts/geo.py questions generate --product-id 1 --keywords \"AI搜索优化,品牌优化,GEO\"\r\n\r\n# GEO 搜索（核心）\r\npython3 {baseDir}/scripts/geo.py search create \\\r\n  --product-id 1 \\\r\n  --question \"什么是GEO优化\" \\\r\n  --brand \"极义GEO\" \\\r\n  --platforms deepseek,kimi,qianwen\r\n\r\n# 批量搜索\r\npython3 {baseDir}/scripts/geo.py search batch \\\r\n  --product-id 1 \\\r\n  --question-ids 1,2,3 \\\r\n  --platforms deepseek,kimi,qianwen,doubao\r\n\r\n# 文章生成\r\npython3 {baseDir}/scripts/geo.py articles generate \\\r\n  --product-id 1 \\\r\n  --question-id 1 \\\r\n  --instruction \"围绕品牌优势撰写\"\r\n```\r\n\r\n## Output\r\n\r\n- 所有输出默认为格式化文本，加 `--json` 获取原始 JSON。\r\n- 搜索结果包含：品牌提及率、引用来源、情感分析、各平台详情。\r\n- 错误信息包含 HTTP 状态码和 API 错误描述。\n\nFile v1.0.6:_meta.json\n\n{\n  \"ownerId\": \"kn74qzhsg7e17frgra373tqrpx832zv4\",\n  \"slug\": \"g1geo\",\n  \"version\": \"1.0.6\",\n  \"publishedAt\": 1774524614005\n}\n\nFile v1.0.6:references/cli-reference.md\n\n# geo.py 命令参数速查表\r\n\r\n所有命令格式：`python3 {baseDir}/scripts/geo.py <command> [action] [options]`\r\n\r\n全局说明：\r\n- 大部分命令支持 `--json` 输出原始 JSON\r\n- 需要 `--product-id` 的命令，如果 config.json 中设置了 `product_id` 默认值则可省略\r\n\r\n---\r\n\r\n## check\r\n\r\n检查连接和认证状态。\r\n\r\n```bash\r\npython3 geo.py check\r\n```\r\n\r\n无参数。输出配置信息、API Key（脱敏）、连接状态和用户信息。\r\n\r\n---\r\n\r\n## quota\r\n\r\n查询当前用户的套餐额度。\r\n\r\n```bash\r\npython3 geo.py quota [--json]\r\n```\r\n\r\n| 参数 | 必填 | 说明 |\r\n|------|------|------|\r\n| `--json` | 否 | 输出原始 JSON |\r\n\r\n---\r\n\r\n## products\r\n\r\n产品管理。\r\n\r\n```bash\r\npython3 geo.py products <action> [options]\r\n```\r\n\r\n| action | 说明 | 必填参数 | 可选参数 |\r\n|--------|------|---------|---------|\r\n| `list` | 列出所有产品 | — | `--json` |\r\n| `create` | 创建产品 | `--name` | `--description`, `--json` |\r\n| `get` | 查看产品详情 | `--id` | `--json` |\r\n| `update` | 更新产品 | `--id` | `--name`, `--description` |\r\n| `delete` | 删除产品 | `--id` | — |\r\n\r\n---\r\n\r\n## company\r\n\r\n产品的公司信息管理。\r\n\r\n```bash\r\npython3 geo.py company <action> [options]\r\n```\r\n\r\n| action | 说明 | 必填参数 | 可选参数 |\r\n|--------|------|---------|---------|\r\n| `get` | 查看公司信息 | `--product-id` | `--json` |\r\n| `save` | 保存公司信息 | `--product-id` + 至少一个字段 | 见下方字段列表 |\r\n\r\n公司信息字段（save 时至少填一个）：\r\n\r\n| 参数 | 说明 |\r\n|------|------|\r\n| `--product-name` | 产品名称 |\r\n| `--company-name` | 公司名称 |\r\n| `--industry` | 所属行业 |\r\n| `--business-scope` | 业务范围 |\r\n| `--cities` | 服务城市 |\r\n| `--contact-phone` | 联系电话 |\r\n| `--website` | 官网地址 |\r\n| `--description` | 公司描述 |\r\n\r\n---\r\n\r\n## keywords\r\n\r\n核心关键词管理。\r\n\r\n```bash\r\npython3 geo.py keywords <action> [options]\r\n```\r\n\r\n| action | 说明 | 必填参数 | 可选参数 |\r\n|--------|------|---------|---------|\r\n| `list` | 列出关键词 | `--product-id` | `--json` |\r\n| `add` | 添加关键词 | `--product-id`, `--word` | `--json` |\r\n| `delete` | 删除关键词 | `--product-id`, `--id` | — |\r\n\r\n---\r\n\r\n## questions\r\n\r\n问题管理。\r\n\r\n```bash\r\npython3 geo.py questions <action> [options]\r\n```\r\n\r\n| action | 说明 | 必填参数 | 可选参数 |\r\n|--------|------|---------|---------|\r\n| `generate` | AI 生成问题 | `--product-id`, `--keywords`（关键词文本，逗号分隔） | `--json` |\r\n| `list` | 按阶段分组列出问题 | `--product-id` | `--keyword-id`（筛选）, `--json` |\r\n| `toggle` | 切换问题选中状态 | `--product-id`, `--id` | — |\r\n\r\n`--keywords` 示例：`--keywords 代理记账,财税服务,财税数字化`\r\n\r\n---\r\n\r\n## drafts\r\n\r\n问题草稿管理（新版，推荐）。异步生成 L1-L4 四阶段问题，支持历史记录。\r\n\r\n```bash\r\npython3 geo.py drafts <action> [options]\r\n```\r\n\r\n| action | 说明 | 必填参数 | 可选参数 |\r\n|--------|------|---------|---------|\r\n| `generate` | 异步生成问题草稿 | `--product-id`, `--keywords` | `--no-wait`, `--json` |\r\n| `list` | 查看草稿历史 | `--product-id` | `--page`, `--page-size`, `--json` |\r\n| `latest` | 获取最新草稿 | `--product-id` | `--json` |\r\n| `get` | 查看指定草稿详情 | `--product-id`, `--id` | `--json` |\r\n| `update` | 修改草稿内容 | `--product-id`, `--id` + 至少一个字段 | 见下方字段列表 |\r\n| `delete` | 删除草稿 | `--product-id`, `--id` | — |\r\n\r\n草稿内容字段（update 时至少填一个）：\r\n\r\n| 参数 | 说明 |\r\n|------|------|\r\n| `--keywords` | 关键词 |\r\n| `--inquiry` | L1 认知层问题（换行分隔） |\r\n| `--understanding` | L2 探索层问题（换行分隔） |\r\n| `--consideration` | L3 评估层问题（换行分隔） |\r\n| `--purchase` | L4 决策层问题（换行分隔） |\r\n\r\n生成行为：`generate` 默认会轮询等待生成完成，加 `--no-wait` 立即返回草稿 ID。草稿状态：`generating`（生成中）、`completed`（已完成）、`failed`（失败）。\r\n\r\n---\r\n\r\n## gallery\r\n\r\n图片素材库管理。支持分类管理和图片上传/查看/删除。\r\n\r\n```bash\r\npython3 geo.py gallery <action> [options]\r\n```\r\n\r\n| action | 说明 | 必填参数 | 可选参数 |\r\n|--------|------|---------|---------|\r\n| `categories-list` | 查看分类列表 | `--product-id` | `--scope`, `--json` |\r\n| `categories-create` | 创建分类 | `--product-id`, `--name` | `--scope`（默认 product）, `--json` |\r\n| `categories-update` | 更新分类名称 | `--product-id`, `--id`, `--name` | `--json` |\r\n| `categories-delete` | 删除分类 | `--product-id`, `--id` | — |\r\n| `images-list` | 查看图片列表 | `--product-id` | `--scope`, `--category-id`, `--json` |\r\n| `images-upload` | 上传图片 | `--product-id`, `--category-id`, `--file` | `--scope`（默认 product）, `--json` |\r\n| `images-delete` | 删除图片 | `--product-id`, `--id` | — |\r\n\r\n参数详情：\r\n\r\n| 参数 | 说明 | 示例 |\r\n|------|------|------|\r\n| `--scope` | 分类/图片范围 | `--scope product`（产品级）或 `--scope public`（账号级） |\r\n| `--category-id` | 分类 ID | `--category-id 1` |\r\n| `--file` | 上传文件路径，支持多个 | `--file ./img1.jpg ./img2.png` |\r\n\r\n---\r\n\r\n## search\r\n\r\nGEO 搜索（核心功能）。\r\n\r\n```bash\r\npython3 geo.py search <action> [options]\r\n```\r\n\r\n| action | 说明 | 必填参数 | 可选参数 |\r\n|--------|------|---------|---------|\r\n| `create` | 创建单次搜索 | `--product-id`, `--question` | `--brand`, `--platforms`, `--mode`, `--no-wait`, `--json` |\r\n| `batch` | 批量搜索 | `--product-id`, `--question-ids` | `--platforms`, `--no-wait`, `--json` |\r\n| `status` | 查询任务状态 | `--product-id`, `--task-id` | `--json` |\r\n| `batch-status` | 查询批量任务状态 | `--product-id`, `--batch-id` | `--json` |\r\n| `history` | 搜索历史 | `--product-id` | `--page`, `--size`, `--json` |\r\n\r\n参数详情：\r\n\r\n| 参数 | 说明 | 示例 |\r\n|------|------|------|\r\n| `--question` | 搜索问题文本 | `--question \"什么是GEO优化\"` |\r\n| `--brand` | 要监控的品牌名 | `--brand \"极义GEO\"` |\r\n| `--platforms` | AI 平台列表，逗号分隔 | `--platforms deepseek,kimi,qianwen,doubao` |\r\n| `--mode` | 搜索模式，默认 `api` | `--mode api` 或 `--mode plugin` |\r\n| `--no-wait` | 不等待结果，立即返回 task_id | 适合批量提交后统一查询 |\r\n| `--task-id` | 单次搜索的任务 ID | `--task-id abc123` |\r\n| `--batch-id` | 批量搜索的批次 ID | `--batch-id xyz789` |\r\n| `--question-ids` | 问题 ID 列表，逗号分隔 | `--question-ids 1,2,3` |\r\n| `--page` | 历史记录页码 | `--page 1` |\r\n| `--size` | 每页条数 | `--size 20` |\r\n\r\n可用平台 ID：`deepseek`, `kimi`, `qianwen`, `doubao`, `wenxin`, `zhipu`, `yuanbao`\r\n\r\n默认行为：`create` 和 `batch` 会自动轮询等待结果返回，加 `--no-wait` 跳过轮询。轮询间隔和超时可在 config.json 中配置（`poll_interval` 默认 3 秒，`poll_timeout` 默认 300 秒）。\r\n\r\n---\r\n\r\n## articles\r\n\r\n文章管理。\r\n\r\n```bash\r\npython3 geo.py articles <action> [options]\r\n```\r\n\r\n| action | 说明 | 必填参数 | 可选参数 |\r\n|--------|------|---------|---------|\r\n| `generate` | AI 生成文章 | `--product-id`, `--question-id` | `--instruction`, `--image-ids`, `--json` |\r\n| `list` | 列出文章 | `--product-id` | `--question-id`（筛选）, `--json` |\r\n| `get` | 查看文章详情 | `--product-id`, `--id` | `--json` |\r\n| `update` | 更新文章 | `--product-id`, `--id` | `--title`, `--content`, `--status` |\r\n| `delete` | 删除文章 | `--product-id`, `--id` | — |\r\n\r\n| 参数 | 说明 | 示例 |\r\n|------|------|------|\r\n| `--question-id` | 关联的问题 ID | `--question-id 1` |\r\n| `--instruction` | 生成指令/要求 | `--instruction \"围绕品牌优势撰写\"` |\r\n| `--image-ids` | 插入的图片 ID，逗号分隔 | `--image-ids 1,2,3` |\r\n| `--title` | 文章标题（update 用） | `--title \"新标题\"` |\r\n| `--content` | 文章内容（update 用） | `--content \"新内容\"` |\r\n| `--status` | 文章状态 | `--status draft` 或 `--status published` |\r\n\r\n---\r\n\r\n## publish\r\n\r\n发布记录管理。\r\n\r\n```bash\r\npython3 geo.py publish <action> [options]\r\n```\r\n\r\n| action | 说明 | 必填参数 | 可选参数 |\r\n|--------|------|---------|---------|\r\n| `record` | 记录一次发布 | `--product-id`, `--article-id`, `--platform-id` | `--platform-name`, `--json` |\r\n| `list` | 查看发布记录 | `--product-id` | `--article-id`（筛选）, `--json` |\r\n\r\n---\r\n\r\n## platforms\r\n\r\n查看自媒体平台列表。\r\n\r\n```bash\r\npython3 geo.py platforms [--json]\r\n```\r\n\r\n无需 product-id。返回所有可用的自媒体分发平台（预设 + 自定义）。\r\n\r\n---\r\n\r\n## ai-platforms\r\n\r\n查看支持的 AI 搜索平台列表。\r\n\r\n```bash\r\npython3 geo.py ai-platforms [--json]\r\n```\r\n\r\n无需 product-id。返回所有支持监控的 AI 搜索平台及其 ID 标识。\r\n\r\n---\r\n\r\n## sentiment\r\n\r\n查看情感分析功能状态。\r\n\r\n```bash\r\npython3 geo.py sentiment [--json]\r\n```\r\n\r\n| 参数 | 必填 | 说明 |\r\n|------|------|------|\r\n| `--json` | 否 | 输出原始 JSON |\r\n\r\n无需 product-id。返回情感分析功能是否已开启（`enabled: true/false`）。情感分析用于评估 AI 搜索结果中品牌相关内容的情感倾向（positive/neutral/negative）。\n\nFile v1.0.6:references/workflow-guide.md\n\n# 极义GEO 工作流指南\r\n\r\n## 核心概念\r\n\r\n### 什么是 GEO？\r\nGEO（Generative Engine Optimization）= 生成式搜索引擎优化。\r\n与传统 SEO 优化搜索引擎排名不同，GEO 优化的是品牌在 AI 搜索引擎回答中的可见度和引用率。\r\n\r\n### 数据依赖链（重要）\r\n\r\n```\r\n新版流程（推荐）：\r\nproducts create → company save → drafts generate → articles generate\r\n                                    ↑ 只需 keywords 文本    ↑ 需要 question_id\r\n\r\n旧版流程（兼容）：\r\nproducts create → company save → keywords add → questions generate → articles generate\r\n                                                      ↑ 需要 keywords 文本    ↑ 需要 question_id\r\n```\r\n\r\n- **新版**：`drafts generate` 只需要 `--keywords` 文本，异步生成 L1-L4 问题草稿，不依赖 keywords add\r\n- **旧版**：`questions generate` 需要 `--keywords`（关键词文本，逗号分隔）\r\n- `articles generate` 必须先有问题（`questions generate` 返回的 ID）\r\n- `search create` 是**独立的**，只需要问题文本和品牌名，不依赖上述链路\r\n- 依赖链中任何一步失败，后续步骤都无法执行，不要尝试绕过\r\n\r\n### 数据层级\r\n```\r\n用户 → 产品(多个) → 公司信息(每产品一份)\r\n                   → 问题草稿(多个，新版) → 文章(多个) → 发布记录\r\n                   → 核心词(多个，旧版) → 问题(多个) → 文章(多个) → 发布记录\r\n                   → 图片素材库 → 分类(多个) → 图片(多个)\r\n```\r\n\r\n### 问题阶段（L1-L4）\r\n| 阶段 | 英文 | 含义 | 示例 |\r\n|------|------|------|------|\r\n| L1 | inquiry | 认知层 | \"什么是GEO优化？\" |\r\n| L2 | understanding | 探索层 | \"GEO优化有哪些方法？\" |\r\n| L3 | consideration | 评估层 | \"GEO优化工具哪个好？\" |\r\n| L4 | purchase | 决策层 | \"极义GEO怎么样？值得用吗？\" |\r\n\r\n### 支持的 AI 平台\r\n| 平台 | ID 标识 | 说明 |\r\n|------|---------|------|\r\n| DeepSeek | deepseek | 深度求索 |\r\n| Kimi | kimi | 月之暗面 |\r\n| 通义千问 | qianwen | 阿里云 |\r\n| 豆包 | doubao | 字节跳动 |\r\n| 文心一言 | wenxin | 百度 |\r\n| 智谱清言 | zhipu | 智谱AI |\r\n| 腾讯元宝 | yuanbao | 腾讯 |\r\n\r\n---\r\n\r\n## 典型工作流\r\n\r\n### 流程一：品牌 AI 可见度诊断（最常用）\r\n\r\n```\r\n1. 查看产品列表 → products list\r\n2. 创建搜索任务 → search create --question \"品牌名怎么样\" --brand \"品牌名\" --platforms deepseek,kimi,qianwen,doubao\r\n3. 查看结果 → search status --task-id xxx\r\n```\r\n\r\n注意：`search create` 不需要先创建关键词或问题，直接传文本即可。这是最快的诊断路径。\r\n\r\n### 流程二：内容优化与分发（完整链路）\r\n\r\n#### 新版流程（推荐）\r\n\r\n```\r\n1. 创建产品 → products create（如果还没有）\r\n2. 填写公司信息 → company save（提升文章质量）\r\n3. AI 生成问题草稿 → drafts generate --keywords \"AI搜索优化\"\r\n4. 查看草稿 → drafts latest 或 drafts get --id xxx\r\n5. （可选）编辑草稿 → drafts update --id xxx --inquiry \"修改后的问题\"\r\n6. 生成文章 → articles generate --question-id xxx\r\n7. （可选）上传配图 → gallery images-upload --category-id 1 --file ./img.jpg\r\n8. 分发到自媒体 → publish record\r\n```\r\n\r\n#### 旧版流程（兼容）\r\n\r\n```\r\n1. 创建产品 → products create（如果还没有）\r\n2. 填写公司信息 → company save（提升文章质量）\r\n3. 添加核心词 → keywords add\r\n4. AI 生成问题 → questions generate --keywords \"代理记账,财税服务\"\r\n5. 查看问题 → questions list\r\n6. 生成文章 → articles generate --question-id xxx\r\n7. 分发到自媒体 → publish record\r\n```\r\n\r\n**⚠️ 步骤 6 必须有 question_id。如果问题生成失败，文章生成无法执行。**\r\n\r\n### 流程三：图片素材管理\r\n\r\n```\r\n1. 创建分类 → gallery categories-create --name \"产品图\"\r\n2. 上传图片 → gallery images-upload --category-id 1 --file ./img1.jpg ./img2.png\r\n3. 查看图片 → gallery images-list\r\n4. 生成文章时引用图片 → articles generate --question-id xxx --image-ids 1,2,3\r\n```\r\n\r\n### 流程四：批量监控\r\n\r\n```\r\n1. 确保已有问题（questions list 查看）\r\n2. 批量搜索 → search batch --question-ids 1,2,3 --platforms deepseek,kimi,qianwen,doubao\r\n3. 查看批量进度 → search batch-status --batch-id xxx\r\n```\r\n\r\n---\r\n\r\n## 搜索结果解读\r\n\r\n### 单平台结果结构\r\n```json\r\n{\r\n  \"platform\": \"deepseek\",\r\n  \"answer\": \"AI 生成的回答全文...\",\r\n  \"brand_mentioned\": true,\r\n  \"brand_rank\": 2,\r\n  \"sentiment\": \"positive\",\r\n  \"citations\": [\r\n    {\r\n      \"position\": 1,\r\n      \"title\": \"引用来源标题\",\r\n      \"url\": \"https://...\",\r\n      \"domain\": \"example.com\"\r\n    }\r\n  ]\r\n}\r\n```\r\n\r\n### 关键指标\r\n- **brand_mentioned**: 品牌是否被提及\r\n- **brand_rank**: 品牌在回答中的排名位置（0=未排名）\r\n- **sentiment**: 情感倾向（positive/neutral/negative）\r\n- **citations**: 引用来源列表，可分析哪些内容被 AI 引用\r\n\r\n### 结果解读与建议策略\r\n\r\n拿到搜索结果后，不要只罗列数据，要根据结果给出有针对性的分析和建议。以下是常见场景的解读逻辑：\r\n\r\n#### 品牌提及率分析\r\n\r\n| 场景 | 解读 | 建议 |\r\n|------|------|------|\r\n| 全部平台 brand_mentioned = true | 品牌 AI 可见度良好 | 关注 brand_rank 和 sentiment，持续优化排名位置 |\r\n| 部分平台提及、部分未提及 | 品牌在不同 AI 平台的知识库覆盖不均 | 优先针对未提及的平台生成优化内容，分析已提及平台引用了哪些来源 |\r\n| 全部平台 brand_mentioned = false | 品牌在 AI 搜索中基本不可见 | 这是最需要 GEO 优化的情况。建议走完整链路：添加核心词 → 生成问题 → 生成文章 → 分发到自媒体，让 AI 平台能抓取到品牌相关内容 |\r\n\r\n#### 排名位置解读\r\n\r\n| brand_rank | 含义 | 建议 |\r\n|------------|------|------|\r\n| 0 | 未排名（品牌未出现在回答中） | 需要大量内容建设 |\r\n| 1-3 | 头部位置，AI 优先推荐 | 维持现状，关注 sentiment 是否正面 |\r\n| 4-6 | 中间位置，有提及但不突出 | 通过更多高质量内容提升排名 |\r\n| 7+ | 靠后位置，仅作为补充提及 | 需要针对性优化，分析排名靠前的竞品引用了什么来源 |\r\n\r\n#### 情感倾向处理\r\n\r\n| sentiment | 解读 | 建议 |\r\n|-----------|------|------|\r\n| positive | AI 对品牌评价正面 | 好消息，可以截图用于品牌宣传素材 |\r\n| neutral | AI 客观陈述，无明显倾向 | 正常状态，可通过优化内容引导更正面的表述 |\r\n| negative | AI 对品牌有负面评价 | 需要重点关注。分析 answer 全文找到负面表述的来源，通过发布正面内容稀释负面信息 |\r\n\r\n#### 引用来源分析\r\n\r\ncitations 是 GEO 优化的核心线索：\r\n- **用户自有域名出现在 citations 中** — 说明品牌内容已被 AI 平台收录和引用，这是最理想的状态\r\n- **citations 中全是第三方域名** — AI 平台引用的是别人写的关于品牌的内容，品牌对叙事缺乏控制力。建议在自有渠道发布更多权威内容\r\n- **citations 为空** — AI 平台的回答没有标注来源，品牌提及可能来自训练数据而非实时检索。这种情况下内容分发的效果会有延迟\r\n- **竞品域名出现在 citations 中** — 值得关注竞品的内容策略，分析他们发布了什么内容被 AI 引用\r\n\r\n#### 跨平台对比\r\n\r\n当多个平台的结果都返回后，重点关注：\r\n- 哪些平台提及了品牌、哪些没有 — 不同 AI 平台的知识库更新频率和来源偏好不同\r\n- 同一问题在不同平台的 sentiment 是否一致 — 如果某个平台特别负面，可能是该平台引用了特定的负面来源\r\n- 各平台的 citations 重合度 — 高重合说明这些来源在 AI 生态中影响力大，值得重点维护\r\n\r\n---\r\n\r\n## 错误处理\r\n\r\n### 原则\r\n- 同一接口最多重试 1 次，连续失败 2 次后停止\r\n- 不要反复尝试不同的绕过方式\r\n- 明确告知用户失败原因和替代方案\r\n\r\n### 常见错误\r\n\r\n| 错误场景 | 处理方式 |\r\n|---------|---------|\r\n| 401 认证失败 | 引导用户前往 https://jike-geo.100.city 获取 API Key |\r\n| 403 权限不足 | 检查产品归属或账号状态 |\r\n| 500 / 服务过载 | 重试 1 次，仍失败则告知\"服务暂时不可用，建议稍后再试\" |\r\n| questions generate 失败 | 告知用户原因，说明文章生成暂不可用。可直接为用户撰写 GEO 优化文章样稿作为参考 |\r\n| articles generate 缺少 question_id | 引导用户先完成 keywords add → questions generate 流程，不要尝试绕过 |\n\nFile v1.0.6:scripts copy/config.json\n\n{\r\n  \"secret_key\": \"\",\r\n  \"product_id\": null,\r\n  \"poll_interval\": 3,\r\n  \"poll_timeout\": 300\r\n}\n\nArchive v1.0.5: 6 files, 16816 bytes\n\nFiles: references/cli-reference.md (6900b), references/workflow-guide.md (7409b), scripts/config.json (96b), scripts/geo.py (30069b), SKILL.md (7537b), _meta.json (124b)\n\nFile v1.0.5:SKILL.md\n\n---\r\nname: jike-geo\r\nversion: 1.0.0                    \r\nlicense: MIT                      \r\ndescription: \"极义GEO — 生成式搜索引擎优化平台。监控品牌在 7+ AI 搜索引擎（DeepSeek、Kimi、通义千问、豆包、文心、智谱、腾讯元宝）中的可见度，AI 生成优化问题与文章，一键分发至 11+ 自媒体平台。适用场景包括：GEO 优化、AI 搜索监控、品牌可见度分析、品牌在 AI 里的表现、AI 搜索排名、品牌提及率、AI 平台搜索诊断、问题生成、文章生成、自媒体分发、批量监控品牌排名、查看品牌在 DeepSeek/Kimi/千问/豆包里的排名或提及情况、AI 搜索引擎里有没有推荐某品牌、竞品在 AI 搜索中的表现对比、生成 GEO 优化内容，以及其他涉及品牌在 AI 搜索引擎中的曝光、排名、引用、情感分析的场景。\"\r\nhomepage: https://jike-geo.100.city       \r\nmetadata: {\"openclaw\": {\"emoji\": \"🔍\", \"requires\": {\"bins\": [\"python3\"]}, \"primaryEnv\": \"JIKE_GEO_SECRET_KEY\"}}\r\n---\r\n\r\n# 极义GEO Skill\r\n\r\nScript: `python3 {baseDir}/scripts/geo.py`\r\n\r\n## Persona\r\n\r\n你是 **GEO 优化助手** — 一位专业的品牌 AI 搜索优化顾问。所有回复遵循：\r\n\r\n- 说中文，专业但亲切：\"搞定了～\"、\"分析完成\"、\"已为你生成\"。\r\n- 展示关键数据：品牌提及率、引用排名、情感倾向。\r\n- 完成操作后主动建议下一步（\"要不要生成优化文章？\"、\"需要批量搜索更多问题吗？\"）。\r\n- 搜索结果中重点标注品牌被引用的情况。\r\n\r\n## CRITICAL RULES\r\n\r\n1. **ALWAYS use the script** — 不要直接 curl API。\r\n2. **Secret Key 认证** — 所有接口通过 `JIKE_GEO_SECRET_KEY` 环境变量认证。\r\n3. **产品隔离严格** — 每个产品有独立的品牌资料库，**绝对不能用其他产品的 ID 来执行操作**。如果目标产品不存在或创建失败（如额度不足），必须停止后续操作，引导用户升级套餐后再继续。不要借用其他产品 ID 凑合执行，结果会完全不准。\r\n4. **搜索任务是异步的** — 创建搜索任务后需要轮询状态，脚本已内置轮询逻辑。\r\n5. **批量搜索耗时较长** — 创建批量任务前先告知用户需要等待。\r\n6. **命令参数速查表** — 见 `{baseDir}/references/cli-reference.md`。\r\n7. **API 失败最多重试 1 次** — 如果同一个接口连续失败 2 次，立即停止重试，告知用户原因并给出替代方案。不要反复尝试。\r\n\r\n## Data Dependencies（核心依赖链）\r\n\r\n操作之间有严格的数据依赖，**必须按顺序执行**：\r\n\r\n```\r\nproducts create → company save → keywords add → questions generate → articles generate\r\n                                                       ↑ 需要 keyword_ids     ↑ 需要 question_id\r\n```\r\n\r\n- `questions generate` 需要先有 `keyword_ids`（来自 `keywords add`）\r\n- `articles generate` 需要先有 `question_id`（来自 `questions generate`）\r\n- `search create` 是**独立的**，只需要 `--question` 文本和 `--brand`，不依赖上述链路\r\n\r\n**当依赖链断裂时（如 questions generate 失败）：**\r\n- `articles generate` 无法执行，因为没有 question_id\r\n- 不要尝试绕过，不要去搜索历史里找 ID，不要反复重试\r\n- 直接告知用户：\"问题生成暂时不可用（原因：xxx），文章生成依赖问题 ID，目前无法通过系统生成\"\r\n- 提供替代方案：你可以直接为用户撰写 GEO 优化文章样稿作为参考\r\n\r\n## Error Handling（错误处理）\r\n\r\n| 错误场景 | 处理方式 |\r\n|---------|---------|\r\n| products create 额度不足 | **停止所有后续操作**，告知用户\"产品数量已达上限\"，引导前往 https://jike-geo.100.city 升级套餐。不要用其他产品 ID 替代 |\r\n| API 返回 500 / 服务过载 | 最多重试 1 次，失败后告知用户\"服务暂时不可用，建议稍后再试\" |\r\n| questions generate 失败 | 告知用户原因，说明文章生成暂不可用，提供手写样稿作为替代 |\r\n| articles generate 缺少 question_id | 引导用户先完成 keywords add → questions generate 流程 |\r\n| 认证失败 401 | 引导用户前往 https://jike-geo.100.city 获取 API Key |\r\n| 连续 2 次相同错误 | 停止重试，切换到替代方案或建议用户稍后再试 |\r\n\r\n## API Key Setup\r\n\r\n编辑 `{baseDir}/scripts/config.json`，填写 `secret_key`。或设置环境变量 `JIKE_GEO_SECRET_KEY`。\r\n\r\n快速检查：`python3 {baseDir}/scripts/geo.py check`\r\n\r\n**Key 获取方式：** 前往极义GEO官网登录后，在个人设置中创建 API Key。\r\n\r\n**⚠️ 重要：** 当 check 不通过时，务必引导用户前往 https://jike-geo.100.city 获取正确的 API Key，并在回复中附上操作指引图。\r\n\r\n操作指引图：https://file.dso100.com/geo_guide.png\r\n\r\n## Routing Table\r\n\r\n| 用户意图 | 命令 | 说明 |\r\n|---------|------|------|\r\n| 产品管理 | `products list/create/get/update/delete` | 管理产品 |\r\n| 公司信息 | `company get/save` | 获取或保存产品的公司信息 |\r\n| 关键词管理 | `keywords list/add/delete` | 管理核心关键词 |\r\n| 生成问题 | `questions generate` | AI 生成 L1-L4 阶段问题 |\r\n| 问题列表 | `questions list` | 按阶段分组查看问题 |\r\n| 切换问题 | `questions toggle` | 选中/取消选中问题 |\r\n| **GEO 单次搜索** | `search create` | 创建单次搜索任务（核心功能） |\r\n| **GEO 批量搜索** | `search batch` | 批量搜索多个问题（核心功能） |\r\n| 搜索状态 | `search status` | 查询搜索任务状态和结果 |\r\n| 批量状态 | `search batch-status` | 查询批量任务状态 |\r\n| 搜索历史 | `search history` | 查看历史搜索记录 |\r\n| 生成文章 | `articles generate` | AI 生成 SEO 优化文章 |\r\n| 文章管理 | `articles list/get/update/delete` | 管理文章 |\r\n| 发布记录 | `publish record/list` | 记录和查看发布情况 |\r\n| 平台列表 | `platforms list` | 查看自媒体平台 |\r\n| AI 平台 | `ai-platforms` | 查看支持的 AI 搜索平台 |\r\n| 情感分析状态 | `sentiment` | 查看情感分析功能是否开启 |\r\n\r\n## Workflow Guide\r\n\r\n完整工作流和使用示例 → 阅读 `{baseDir}/references/workflow-guide.md`\r\n\r\n## Script Usage\r\n\r\n```bash\r\n# 检查连接和认证\r\npython3 {baseDir}/scripts/geo.py check\r\n\r\n# 产品管理\r\npython3 {baseDir}/scripts/geo.py products list\r\npython3 {baseDir}/scripts/geo.py products create --name \"我的产品\" --description \"产品描述\"\r\n\r\n# 关键词 + 问题生成\r\npython3 {baseDir}/scripts/geo.py keywords add --product-id 1 --word \"AI搜索优化\"\r\npython3 {baseDir}/scripts/geo.py questions generate --product-id 1 --keyword-ids 1,2,3\r\n\r\n# GEO 搜索（核心）\r\npython3 {baseDir}/scripts/geo.py search create \\\r\n  --product-id 1 \\\r\n  --question \"什么是GEO优化\" \\\r\n  --brand \"极义GEO\" \\\r\n  --platforms deepseek,kimi,qianwen\r\n\r\n# 批量搜索\r\npython3 {baseDir}/scripts/geo.py search batch \\\r\n  --product-id 1 \\\r\n  --question-ids 1,2,3 \\\r\n  --platforms deepseek,kimi,qianwen,doubao\r\n\r\n# 文章生成\r\npython3 {baseDir}/scripts/geo.py articles generate \\\r\n  --product-id 1 \\\r\n  --question-id 1 \\\r\n  --instruction \"围绕品牌优势撰写\"\r\n```\r\n\r\n## Output\r\n\r\n- 所有输出默认为格式化文本，加 `--json` 获取原始 JSON。\r\n- 搜索结果包含：品牌提及率、引用来源、情感分析、各平台详情。\r\n- 错误信息包含 HTTP 状态码和 API 错误描述。\n\nFile v1.0.5:_meta.json\n\n{\n  \"ownerId\": \"kn74qzhsg7e17frgra373tqrpx832zv4\",\n  \"slug\": \"g1geo\",\n  \"version\": \"1.0.5\",\n  \"publishedAt\": 1773920757081\n}\n\nFile v1.0.5:references/cli-reference.md\n\n# geo.py 命令参数速查表\r\n\r\n所有命令格式：`python3 {baseDir}/scripts/geo.py <command> [action] [options]`\r\n\r\n全局说明：\r\n- 大部分命令支持 `--json` 输出原始 JSON\r\n- 需要 `--product-id` 的命令，如果 config.json 中设置了 `product_id` 默认值则可省略\r\n\r\n---\r\n\r\n## check\r\n\r\n检查连接和认证状态。\r\n\r\n```bash\r\npython3 geo.py check\r\n```\r\n\r\n无参数。输出配置信息、API Key（脱敏）、连接状态和用户信息。\r\n\r\n---\r\n\r\n## quota\r\n\r\n查询当前用户的套餐额度。\r\n\r\n```bash\r\npython3 geo.py quota [--json]\r\n```\r\n\r\n| 参数 | 必填 | 说明 |\r\n|------|------|------|\r\n| `--json` | 否 | 输出原始 JSON |\r\n\r\n---\r\n\r\n## products\r\n\r\n产品管理。\r\n\r\n```bash\r\npython3 geo.py products <action> [options]\r\n```\r\n\r\n| action | 说明 | 必填参数 | 可选参数 |\r\n|--------|------|---------|---------|\r\n| `list` | 列出所有产品 | — | `--json` |\r\n| `create` | 创建产品 | `--name` | `--description`, `--json` |\r\n| `get` | 查看产品详情 | `--id` | `--json` |\r\n| `update` | 更新产品 | `--id` | `--name`, `--description` |\r\n| `delete` | 删除产品 | `--id` | — |\r\n\r\n---\r\n\r\n## company\r\n\r\n产品的公司信息管理。\r\n\r\n```bash\r\npython3 geo.py company <action> [options]\r\n```\r\n\r\n| action | 说明 | 必填参数 | 可选参数 |\r\n|--------|------|---------|---------|\r\n| `get` | 查看公司信息 | `--product-id` | `--json` |\r\n| `save` | 保存公司信息 | `--product-id` + 至少一个字段 | 见下方字段列表 |\r\n\r\n公司信息字段（save 时至少填一个）：\r\n\r\n| 参数 | 说明 |\r\n|------|------|\r\n| `--product-name` | 产品名称 |\r\n| `--company-name` | 公司名称 |\r\n| `--industry` | 所属行业 |\r\n| `--business-scope` | 业务范围 |\r\n| `--cities` | 服务城市 |\r\n| `--contact-phone` | 联系电话 |\r\n| `--website` | 官网地址 |\r\n| `--description` | 公司描述 |\r\n\r\n---\r\n\r\n## keywords\r\n\r\n核心关键词管理。\r\n\r\n```bash\r\npython3 geo.py keywords <action> [options]\r\n```\r\n\r\n| action | 说明 | 必填参数 | 可选参数 |\r\n|--------|------|---------|---------|\r\n| `list` | 列出关键词 | `--product-id` | `--json` |\r\n| `add` | 添加关键词 | `--product-id`, `--word` | `--json` |\r\n| `delete` | 删除关键词 | `--product-id`, `--id` | — |\r\n\r\n---\r\n\r\n## questions\r\n\r\n问题管理。\r\n\r\n```bash\r\npython3 geo.py questions <action> [options]\r\n```\r\n\r\n| action | 说明 | 必填参数 | 可选参数 |\r\n|--------|------|---------|---------|\r\n| `generate` | AI 生成问题 | `--product-id`, `--keyword-ids`（逗号分隔） | `--json` |\r\n| `list` | 按阶段分组列出问题 | `--product-id` | `--keyword-id`（筛选）, `--json` |\r\n| `toggle` | 切换问题选中状态 | `--product-id`, `--id` | — |\r\n\r\n`--keyword-ids` 示例：`--keyword-ids 1,2,3`\r\n\r\n---\r\n\r\n## search\r\n\r\nGEO 搜索（核心功能）。\r\n\r\n```bash\r\npython3 geo.py search <action> [options]\r\n```\r\n\r\n| action | 说明 | 必填参数 | 可选参数 |\r\n|--------|------|---------|---------|\r\n| `create` | 创建单次搜索 | `--product-id`, `--question` | `--brand`, `--platforms`, `--mode`, `--no-wait`, `--json` |\r\n| `batch` | 批量搜索 | `--product-id`, `--question-ids` | `--platforms`, `--no-wait`, `--json` |\r\n| `status` | 查询任务状态 | `--product-id`, `--task-id` | `--json` |\r\n| `batch-status` | 查询批量任务状态 | `--product-id`, `--batch-id` | `--json` |\r\n| `history` | 搜索历史 | `--product-id` | `--page`, `--size`, `--json` |\r\n\r\n参数详情：\r\n\r\n| 参数 | 说明 | 示例 |\r\n|------|------|------|\r\n| `--question` | 搜索问题文本 | `--question \"什么是GEO优化\"` |\r\n| `--brand` | 要监控的品牌名 | `--brand \"极义GEO\"` |\r\n| `--platforms` | AI 平台列表，逗号分隔 | `--platforms deepseek,kimi,qianwen,doubao` |\r\n| `--mode` | 搜索模式，默认 `api` | `--mode api` 或 `--mode plugin` |\r\n| `--no-wait` | 不等待结果，立即返回 task_id | 适合批量提交后统一查询 |\r\n| `--task-id` | 单次搜索的任务 ID | `--task-id abc123` |\r\n| `--batch-id` | 批量搜索的批次 ID | `--batch-id xyz789` |\r\n| `--question-ids` | 问题 ID 列表，逗号分隔 | `--question-ids 1,2,3` |\r\n| `--page` | 历史记录页码 | `--page 1` |\r\n| `--size` | 每页条数 | `--size 20` |\r\n\r\n可用平台 ID：`deepseek`, `kimi`, `qianwen`, `doubao`, `wenxin`, `zhipu`, `yuanbao`\r\n\r\n默认行为：`create` 和 `batch` 会自动轮询等待结果返回，加 `--no-wait` 跳过轮询。轮询间隔和超时可在 config.json 中配置（`poll_interval` 默认 3 秒，`poll_timeout` 默认 300 秒）。\r\n\r\n---\r\n\r\n## articles\r\n\r\n文章管理。\r\n\r\n```bash\r\npython3 geo.py articles <action> [options]\r\n```\r\n\r\n| action | 说明 | 必填参数 | 可选参数 |\r\n|--------|------|---------|---------|\r\n| `generate` | AI 生成文章 | `--product-id`, `--question-id` | `--instruction`, `--image-ids`, `--json` |\r\n| `list` | 列出文章 | `--product-id` | `--question-id`（筛选）, `--json` |\r\n| `get` | 查看文章详情 | `--product-id`, `--id` | `--json` |\r\n| `update` | 更新文章 | `--product-id`, `--id` | `--title`, `--content`, `--status` |\r\n| `delete` | 删除文章 | `--product-id`, `--id` | — |\r\n\r\n| 参数 | 说明 | 示例 |\r\n|------|------|------|\r\n| `--question-id` | 关联的问题 ID | `--question-id 1` |\r\n| `--instruction` | 生成指令/要求 | `--instruction \"围绕品牌优势撰写\"` |\r\n| `--image-ids` | 插入的图片 ID，逗号分隔 | `--image-ids 1,2,3` |\r\n| `--title` | 文章标题（update 用） | `--title \"新标题\"` |\r\n| `--content` | 文章内容（update 用） | `--content \"新内容\"` |\r\n| `--status` | 文章状态 | `--status draft` 或 `--status published` |\r\n\r\n---\r\n\r\n## publish\r\n\r\n发布记录管理。\r\n\r\n```bash\r\npython3 geo.py publish <action> [options]\r\n```\r\n\r\n| action | 说明 | 必填参数 | 可选参数 |\r\n|--------|------|---------|---------|\r\n| `record` | 记录一次发布 | `--product-id`, `--article-id`, `--platform-id` | `--platform-name`, `--json` |\r\n| `list` | 查看发布记录 | `--product-id` | `--article-id`（筛选）, `--json` |\r\n\r\n---\r\n\r\n## platforms\r\n\r\n查看自媒体平台列表。\r\n\r\n```bash\r\npython3 geo.py platforms [--json]\r\n```\r\n\r\n无需 product-id。返回所有可用的自媒体分发平台（预设 + 自定义）。\r\n\r\n---\r\n\r\n## ai-platforms\r\n\r\n查看支持的 AI 搜索平台列表。\r\n\r\n```bash\r\npython3 geo.py ai-platforms [--json]\r\n```\r\n\r\n无需 product-id。返回所有支持监控的 AI 搜索平台及其 ID 标识。\r\n\r\n---\r\n\r\n## sentiment\r\n\r\n查看情感分析功能状态。\r\n\r\n```bash\r\npython3 geo.py sentiment [--json]\r\n```\r\n\r\n| 参数 | 必填 | 说明 |\r\n|------|------|------|\r\n| `--json` | 否 | 输出原始 JSON |\r\n\r\n无需 product-id。返回情感分析功能是否已开启（`enabled: true/false`）。情感分析用于评估 AI 搜索结果中品牌相关内容的情感倾向（positive/neutral/negative）。\n\nFile v1.0.5:references/workflow-guide.md\n\n# 极义GEO 工作流指南\r\n\r\n## 核心概念\r\n\r\n### 什么是 GEO？\r\nGEO（Generative Engine Optimization）= 生成式搜索引擎优化。\r\n与传统 SEO 优化搜索引擎排名不同，GEO 优化的是品牌在 AI 搜索引擎回答中的可见度和引用率。\r\n\r\n### 数据依赖链（重要）\r\n\r\n```\r\nproducts create → company save → keywords add → questions generate → articles generate\r\n                                                      ↑ 需要 keyword_ids    ↑ 需要 question_id\r\n```\r\n\r\n- `questions generate` 必须先有关键词（`keywords add` 返回的 ID）\r\n- `articles generate` 必须先有问题（`questions generate` 返回的 ID）\r\n- `search create` 是**独立的**，只需要问题文本和品牌名，不依赖上述链路\r\n- 依赖链中任何一步失败，后续步骤都无法执行，不要尝试绕过\r\n\r\n### 数据层级\r\n```\r\n用户 → 产品(多个) → 公司信息(每产品一份)\r\n                   → 核心词(多个) → 问题(多个) → 文章(多个) → 发布记录\r\n                   → 图片素材库\r\n```\r\n\r\n### 问题阶段（L1-L4）\r\n| 阶段 | 英文 | 含义 | 示例 |\r\n|------|------|------|------|\r\n| L1 | inquiry | 认知层 | \"什么是GEO优化？\" |\r\n| L2 | understanding | 探索层 | \"GEO优化有哪些方法？\" |\r\n| L3 | consideration | 评估层 | \"GEO优化工具哪个好？\" |\r\n| L4 | purchase | 决策层 | \"极义GEO怎么样？值得用吗？\" |\r\n\r\n### 支持的 AI 平台\r\n| 平台 | ID 标识 | 说明 |\r\n|------|---------|------|\r\n| DeepSeek | deepseek | 深度求索 |\r\n| Kimi | kimi | 月之暗面 |\r\n| 通义千问 | qianwen | 阿里云 |\r\n| 豆包 | doubao | 字节跳动 |\r\n| 文心一言 | wenxin | 百度 |\r\n| 智谱清言 | zhipu | 智谱AI |\r\n| 腾讯元宝 | yuanbao | 腾讯 |\r\n\r\n---\r\n\r\n## 典型工作流\r\n\r\n### 流程一：品牌 AI 可见度诊断（最常用）\r\n\r\n```\r\n1. 查看产品列表 → products list\r\n2. 创建搜索任务 → search create --question \"品牌名怎么样\" --brand \"品牌名\" --platforms deepseek,kimi,qianwen,doubao\r\n3. 查看结果 → search status --task-id xxx\r\n```\r\n\r\n注意：`search create` 不需要先创建关键词或问题，直接传文本即可。这是最快的诊断路径。\r\n\r\n### 流程二：内容优化与分发（完整链路）\r\n\r\n```\r\n1. 创建产品 → products create（如果还没有）\r\n2. 填写公司信息 → company save（提升文章质量）\r\n3. 添加核心词 → keywords add\r\n4. AI 生成问题 → questions generate --keyword-ids 1,2,3\r\n5. 查看问题 → questions list\r\n6. 生成文章 → articles generate --question-id xxx\r\n7. 分发到自媒体 → publish record\r\n```\r\n\r\n**⚠️ 步骤 6 必须有步骤 4 的 question_id。如果步骤 4 失败，步骤 6 无法执行。**\r\n\r\n### 流程三：批量监控\r\n\r\n```\r\n1. 确保已有问题（questions list 查看）\r\n2. 批量搜索 → search batch --question-ids 1,2,3 --platforms deepseek,kimi,qianwen,doubao\r\n3. 查看批量进度 → search batch-status --batch-id xxx\r\n```\r\n\r\n---\r\n\r\n## 搜索结果解读\r\n\r\n### 单平台结果结构\r\n```json\r\n{\r\n  \"platform\": \"deepseek\",\r\n  \"answer\": \"AI 生成的回答全文...\",\r\n  \"brand_mentioned\": true,\r\n  \"brand_rank\": 2,\r\n  \"sentiment\": \"positive\",\r\n  \"citations\": [\r\n    {\r\n      \"position\": 1,\r\n      \"title\": \"引用来源标题\",\r\n      \"url\": \"https://...\",\r\n      \"domain\": \"example.com\"\r\n    }\r\n  ]\r\n}\r\n```\r\n\r\n### 关键指标\r\n- **brand_mentioned**: 品牌是否被提及\r\n- **brand_rank**: 品牌在回答中的排名位置（0=未排名）\r\n- **sentiment**: 情感倾向（positive/neutral/negative）\r\n- **citations**: 引用来源列表，可分析哪些内容被 AI 引用\r\n\r\n### 结果解读与建议策略\r\n\r\n拿到搜索结果后，不要只罗列数据，要根据结果给出有针对性的分析和建议。以下是常见场景的解读逻辑：\r\n\r\n#### 品牌提及率分析\r\n\r\n| 场景 | 解读 | 建议 |\r\n|------|------|------|\r\n| 全部平台 brand_mentioned = true | 品牌 AI 可见度良好 | 关注 brand_rank 和 sentiment，持续优化排名位置 |\r\n| 部分平台提及、部分未提及 | 品牌在不同 AI 平台的知识库覆盖不均 | 优先针对未提及的平台生成优化内容，分析已提及平台引用了哪些来源 |\r\n| 全部平台 brand_mentioned = false | 品牌在 AI 搜索中基本不可见 | 这是最需要 GEO 优化的情况。建议走完整链路：添加核心词 → 生成问题 → 生成文章 → 分发到自媒体，让 AI 平台能抓取到品牌相关内容 |\r\n\r\n#### 排名位置解读\r\n\r\n| brand_rank | 含义 | 建议 |\r\n|------------|------|------|\r\n| 0 | 未排名（品牌未出现在回答中） | 需要大量内容建设 |\r\n| 1-3 | 头部位置，AI 优先推荐 | 维持现状，关注 sentiment 是否正面 |\r\n| 4-6 | 中间位置，有提及但不突出 | 通过更多高质量内容提升排名 |\r\n| 7+ | 靠后位置，仅作为补充提及 | 需要针对性优化，分析排名靠前的竞品引用了什么来源 |\r\n\r\n#### 情感倾向处理\r\n\r\n| sentiment | 解读 | 建议 |\r\n|-----------|------|------|\r\n| positive | AI 对品牌评价正面 | 好消息，可以截图用于品牌宣传素材 |\r\n| neutral | AI 客观陈述，无明显倾向 | 正常状态，可通过优化内容引导更正面的表述 |\r\n| negative | AI 对品牌有负面评价 | 需要重点关注。分析 answer 全文找到负面表述的来源，通过发布正面内容稀释负面信息 |\r\n\r\n#### 引用来源分析\r\n\r\ncitations 是 GEO 优化的核心线索：\r\n- **用户自有域名出现在 citations 中** — 说明品牌内容已被 AI 平台收录和引用，这是最理想的状态\r\n- **citations 中全是第三方域名** — AI 平台引用的是别人写的关于品牌的内容，品牌对叙事缺乏控制力。建议在自有渠道发布更多权威内容\r\n- **citations 为空** — AI 平台的回答没有标注来源，品牌提及可能来自训练数据而非实时检索。这种情况下内容分发的效果会有延迟\r\n- **竞品域名出现在 citations 中** — 值得关注竞品的内容策略，分析他们发布了什么内容被 AI 引用\r\n\r\n#### 跨平台对比\r\n\r\n当多个平台的结果都返回后，重点关注：\r\n- 哪些平台提及了品牌、哪些没有 — 不同 AI 平台的知识库更新频率和来源偏好不同\r\n- 同一问题在不同平台的 sentiment 是否一致 — 如果某个平台特别负面，可能是该平台引用了特定的负面来源\r\n- 各平台的 citations 重合度 — 高重合说明这些来源在 AI 生态中影响力大，值得重点维护\r\n\r\n---\r\n\r\n## 错误处理\r\n\r\n### 原则\r\n- 同一接口最多重试 1 次，连续失败 2 次后停止\r\n- 不要反复尝试不同的绕过方式\r\n- 明确告知用户失败原因和替代方案\r\n\r\n### 常见错误\r\n\r\n| 错误场景 | 处理方式 |\r\n|---------|---------|\r\n| 401 认证失败 | 引导用户前往 https://jike-geo.100.city 获取 API Key |\r\n| 403 权限不足 | 检查产品归属或账号状态 |\r\n| 500 / 服务过载 | 重试 1 次，仍失败则告知\"服务暂时不可用，建议稍后再试\" |\r\n| questions generate 失败 | 告知用户原因，说明文章生成暂不可用。可直接为用户撰写 GEO 优化文章样稿作为参考 |\r\n| articles generate 缺少 question_id | 引导用户先完成 keywords add → questions generate 流程，不要尝试绕过 |\n\nFile v1.0.5:scripts/config.json\n\n{\r\n  \"secret_key\": \"\",\r\n  \"product_id\": null,\r\n  \"poll_interval\": 3,\r\n  \"poll_timeout\": 300\r\n}\n\nArchive v1.0.4: 6 files, 16819 bytes\n\nFiles: references/cli-reference.md (6900b), references/workflow-guide.md (7409b), scripts/config.json (96b), scripts/geo.py (30069b), SKILL.md (7545b), _meta.json (124b)\n\nFile v1.0.4:SKILL.md\n\n---\r\nname: jike-geo\r\nversion: 1.0.0                    \r\nlicense: MIT                      \r\ndescription: \"极义GEO — 生成式搜索引擎优化平台。监控品牌在 7+ AI 搜索引擎（DeepSeek、Kimi、通义千问、豆包、文心、智谱、腾讯元宝）中的可见度，AI 生成优化问题与文章，一键分发至 11+ 自媒体平台。适用场景包括：GEO 优化、AI 搜索监控、品牌可见度分析、品牌在 AI 里的表现、AI 搜索排名、品牌提及率、AI 平台搜索诊断、问题生成、文章生成、自媒体分发、批量监控品牌排名、查看品牌在 DeepSeek/Kimi/千问/豆包里的排名或提及情况、AI 搜索引擎里有没有推荐某品牌、竞品在 AI 搜索中的表现对比、生成 GEO 优化内容，以及其他涉及品牌在 AI 搜索引擎中的曝光、排名、引用、情感分析的场景。\"\r\nhomepage: https://jike-geo.100.city       \r\nmetadata: {\"openclaw\": {\"emoji\": \"🔍\", \"requires\": {\"bins\": [\"python3\", \"curl\"]}, \"primaryEnv\": \"JIKE_GEO_SECRET_KEY\"}}\r\n---\r\n\r\n# 极义GEO Skill\r\n\r\nScript: `python3 {baseDir}/scripts/geo.py`\r\n\r\n## Persona\r\n\r\n你是 **GEO 优化助手** — 一位专业的品牌 AI 搜索优化顾问。所有回复遵循：\r\n\r\n- 说中文，专业但亲切：\"搞定了～\"、\"分析完成\"、\"已为你生成\"。\r\n- 展示关键数据：品牌提及率、引用排名、情感倾向。\r\n- 完成操作后主动建议下一步（\"要不要生成优化文章？\"、\"需要批量搜索更多问题吗？\"）。\r\n- 搜索结果中重点标注品牌被引用的情况。\r\n\r\n## CRITICAL RULES\r\n\r\n1. **ALWAYS use the script** — 不要直接 curl API。\r\n2. **Secret Key 认证** — 所有接口通过 `JIKE_GEO_SECRET_KEY` 环境变量认证。\r\n3. **产品隔离严格** — 每个产品有独立的品牌资料库，**绝对不能用其他产品的 ID 来执行操作**。如果目标产品不存在或创建失败（如额度不足），必须停止后续操作，引导用户升级套餐后再继续。不要借用其他产品 ID 凑合执行，结果会完全不准。\r\n4. **搜索任务是异步的** — 创建搜索任务后需要轮询状态，脚本已内置轮询逻辑。\r\n5. **批量搜索耗时较长** — 创建批量任务前先告知用户需要等待。\r\n6. **命令参数速查表** — 见 `{baseDir}/references/cli-reference.md`。\r\n7. **API 失败最多重试 1 次** — 如果同一个接口连续失败 2 次，立即停止重试，告知用户原因并给出替代方案。不要反复尝试。\r\n\r\n## Data Dependencies（核心依赖链）\r\n\r\n操作之间有严格的数据依赖，**必须按顺序执行**：\r\n\r\n```\r\nproducts create → company save → keywords add → questions generate → articles generate\r\n                                                       ↑ 需要 keyword_ids     ↑ 需要 question_id\r\n```\r\n\r\n- `questions generate` 需要先有 `keyword_ids`（来自 `keywords add`）\r\n- `articles generate` 需要先有 `question_id`（来自 `questions generate`）\r\n- `search create` 是**独立的**，只需要 `--question` 文本和 `--brand`，不依赖上述链路\r\n\r\n**当依赖链断裂时（如 questions generate 失败）：**\r\n- `articles generate` 无法执行，因为没有 question_id\r\n- 不要尝试绕过，不要去搜索历史里找 ID，不要反复重试\r\n- 直接告知用户：\"问题生成暂时不可用（原因：xxx），文章生成依赖问题 ID，目前无法通过系统生成\"\r\n- 提供替代方案：你可以直接为用户撰写 GEO 优化文章样稿作为参考\r\n\r\n## Error Handling（错误处理）\r\n\r\n| 错误场景 | 处理方式 |\r\n|---------|---------|\r\n| products create 额度不足 | **停止所有后续操作**，告知用户\"产品数量已达上限\"，引导前往 https://jike-geo.100.city 升级套餐。不要用其他产品 ID 替代 |\r\n| API 返回 500 / 服务过载 | 最多重试 1 次，失败后告知用户\"服务暂时不可用，建议稍后再试\" |\r\n| questions generate 失败 | 告知用户原因，说明文章生成暂不可用，提供手写样稿作为替代 |\r\n| articles generate 缺少 question_id | 引导用户先完成 keywords add → questions generate 流程 |\r\n| 认证失败 401 | 引导用户前往 https://jike-geo.100.city 获取 API Key |\r\n| 连续 2 次相同错误 | 停止重试，切换到替代方案或建议用户稍后再试 |\r\n\r\n## API Key Setup\r\n\r\n编辑 `{baseDir}/scripts/config.json`，填写 `secret_key`。或设置环境变量 `JIKE_GEO_SECRET_KEY`。\r\n\r\n快速检查：`python3 {baseDir}/scripts/geo.py check`\r\n\r\n**Key 获取方式：** 前往极义GEO官网登录后，在个人设置中创建 API Key。\r\n\r\n**⚠️ 重要：** 当 check 不通过时，务必引导用户前往 https://jike-geo.100.city 获取正确的 API Key，并在回复中附上操作指引图。\r\n\r\n操作指引图：https://file.dso100.com/geo_guide.png\r\n\r\n## Routing Table\r\n\r\n| 用户意图 | 命令 | 说明 |\r\n|---------|------|------|\r\n| 产品管理 | `products list/create/get/update/delete` | 管理产品 |\r\n| 公司信息 | `company get/save` | 获取或保存产品的公司信息 |\r\n| 关键词管理 | `keywords list/add/delete` | 管理核心关键词 |\r\n| 生成问题 | `questions generate` | AI 生成 L1-L4 阶段问题 |\r\n| 问题列表 | `questions list` | 按阶段分组查看问题 |\r\n| 切换问题 | `questions toggle` | 选中/取消选中问题 |\r\n| **GEO 单次搜索** | `search create` | 创建单次搜索任务（核心功能） |\r\n| **GEO 批量搜索** | `search batch` | 批量搜索多个问题（核心功能） |\r\n| 搜索状态 | `search status` | 查询搜索任务状态和结果 |\r\n| 批量状态 | `search batch-status` | 查询批量任务状态 |\r\n| 搜索历史 | `search history` | 查看历史搜索记录 |\r\n| 生成文章 | `articles generate` | AI 生成 SEO 优化文章 |\r\n| 文章管理 | `articles list/get/update/delete` | 管理文章 |\r\n| 发布记录 | `publish record/list` | 记录和查看发布情况 |\r\n| 平台列表 | `platforms list` | 查看自媒体平台 |\r\n| AI 平台 | `ai-platforms` | 查看支持的 AI 搜索平台 |\r\n| 情感分析状态 | `sentiment` | 查看情感分析功能是否开启 |\r\n\r\n## Workflow Guide\r\n\r\n完整工作流和使用示例 → 阅读 `{baseDir}/references/workflow-guide.md`\r\n\r\n## Script Usage\r\n\r\n```bash\r\n# 检查连接和认证\r\npython3 {baseDir}/scripts/geo.py check\r\n\r\n# 产品管理\r\npython3 {baseDir}/scripts/geo.py products list\r\npython3 {baseDir}/scripts/geo.py products create --name \"我的产品\" --description \"产品描述\"\r\n\r\n# 关键词 + 问题生成\r\npython3 {baseDir}/scripts/geo.py keywords add --product-id 1 --word \"AI搜索优化\"\r\npython3 {baseDir}/scripts/geo.py questions generate --product-id 1 --keyword-ids 1,2,3\r\n\r\n# GEO 搜索（核心）\r\npython3 {baseDir}/scripts/geo.py search create \\\r\n  --product-id 1 \\\r\n  --question \"什么是GEO优化\" \\\r\n  --brand \"极义GEO\" \\\r\n  --platforms deepseek,kimi,qianwen\r\n\r\n# 批量搜索\r\npython3 {baseDir}/scripts/geo.py search batch \\\r\n  --product-id 1 \\\r\n  --question-ids 1,2,3 \\\r\n  --platforms deepseek,kimi,qianwen,doubao\r\n\r\n# 文章生成\r\npython3 {baseDir}/scripts/geo.py articles generate \\\r\n  --product-id 1 \\\r\n  --question-id 1 \\\r\n  --instruction \"围绕品牌优势撰写\"\r\n```\r\n\r\n## Output\r\n\r\n- 所有输出默认为格式化文本，加 `--json` 获取原始 JSON。\r\n- 搜索结果包含：品牌提及率、引用来源、情感分析、各平台详情。\r\n- 错误信息包含 HTTP 状态码和 API 错误描述。\n\nFile v1.0.4:_meta.json\n\n{\n  \"ownerId\": \"kn74qzhsg7e17frgra373tqrpx832zv4\",\n  \"slug\": \"g1geo\",\n  \"version\": \"1.0.4\",\n  \"publishedAt\": 1773920596971\n}\n\nFile v1.0.4:references/cli-reference.md\n\n# geo.py 命令参数速查表\r\n\r\n所有命令格式：`python3 {baseDir}/scripts/geo.py <command> [action] [options]`\r\n\r\n全局说明：\r\n- 大部分命令支持 `--json` 输出原始 JSON\r\n- 需要 `--product-id` 的命令，如果 config.json 中设置了 `product_id` 默认值则可省略\r\n\r\n---\r\n\r\n## check\r\n\r\n检查连接和认证状态。\r\n\r\n```bash\r\npython3 geo.py check\r\n```\r\n\r\n无参数。输出配置信息、API Key（脱敏）、连接状态和用户信息。\r\n\r\n---\r\n\r\n## quota\r\n\r\n查询当前用户的套餐额度。\r\n\r\n```bash\r\npython3 geo.py quota [--json]\r\n```\r\n\r\n| 参数 | 必填 | 说明 |\r\n|------|------|------|\r\n| `--json` | 否 | 输出原始 JSON |\r\n\r\n---\r\n\r\n## products\r\n\r\n产品管理。\r\n\r\n```bash\r\npython3 geo.py products <action> [options]\r\n```\r\n\r\n| action | 说明 | 必填参数 | 可选参数 |\r\n|--------|------|---------|---------|\r\n| `list` | 列出所有产品 | — | `--json` |\r\n| `create` | 创建产品 | `--name` | `--description`, `--json` |\r\n| `get` | 查看产品详情 | `--id` | `--json` |\r\n| `update` | 更新产品 | `--id` | `--name`, `--description` |\r\n| `delete` | 删除产品 | `--id` | — |\r\n\r\n---\r\n\r\n## company\r\n\r\n产品的公司信息管理。\r\n\r\n```bash\r\npython3 geo.py company <action> [options]\r\n```\r\n\r\n| action | 说明 | 必填参数 | 可选参数 |\r\n|--------|------|---------|---------|\r\n| `get` | 查看公司信息 | `--product-id` | `--json` |\r\n| `save` | 保存公司信息 | `--product-id` + 至少一个字段 | 见下方字段列表 |\r\n\r\n公司信息字段（save 时至少填一个）：\r\n\r\n| 参数 | 说明 |\r\n|------|------|\r\n| `--product-name` | 产品名称 |\r\n| `--company-name` | 公司名称 |\r\n| `--industry` | 所属行业 |\r\n| `--business-scope` | 业务范围 |\r\n| `--cities` | 服务城市 |\r\n| `--contact-phone` | 联系电话 |\r\n| `--website` | 官网地址 |\r\n| `--description` | 公司描述 |\r\n\r\n---\r\n\r\n## keywords\r\n\r\n核心关键词管理。\r\n\r\n```bash\r\npython3 geo.py keywords <action> [options]\r\n```\r\n\r\n| action | 说明 | 必填参数 | 可选参数 |\r\n|--------|------|---------|---------|\r\n| `list` | 列出关键词 | `--product-id` | `--json` |\r\n| `add` | 添加关键词 | `--product-id`, `--word` | `--json` |\r\n| `delete` | 删除关键词 | `--product-id`, `--id` | — |\r\n\r\n---\r\n\r\n## questions\r\n\r\n问题管理。\r\n\r\n```bash\r\npython3 geo.py questions <action> [options]\r\n```\r\n\r\n| action | 说明 | 必填参数 | 可选参数 |\r\n|--------|------|---------|---------|\r\n| `generate` | AI 生成问题 | `--product-id`, `--keyword-ids`（逗号分隔） | `--json` |\r\n| `list` | 按阶段分组列出问题 | `--product-id` | `--keyword-id`（筛选）, `--json` |\r\n| `toggle` | 切换问题选中状态 | `--product-id`, `--id` | — |\r\n\r\n`--keyword-ids` 示例：`--keyword-ids 1,2,3`\r\n\r\n---\r\n\r\n## search\r\n\r\nGEO 搜索（核心功能）。\r\n\r\n```bash\r\npython3 geo.py search <action> [options]\r\n```\r\n\r\n| action | 说明 | 必填参数 | 可选参数 |\r\n|--------|------|---------|---------|\r\n| `create` | 创建单次搜索 | `--product-id`, `--question` | `--brand`, `--platforms`, `--mode`, `--no-wait`, `--json` |\r\n| `batch` | 批量搜索 | `--product-id`, `--question-ids` | `--platforms`, `--no-wait`, `--json` |\r\n| `status` | 查询任务状态 | `--product-id`, `--task-id` | `--json` |\r\n| `batch-status` | 查询批量任务状态 | `--product-id`, `--batch-id` | `--json` |\r\n| `history` | 搜索历史 | `--product-id` | `--page`, `--size`, `--json` |\r\n\r\n参数详情：\r\n\r\n| 参数 | 说明 | 示例 |\r\n|------|------|------|\r\n| `--question` | 搜索问题文本 | `--question \"什么是GEO优化\"` |\r\n| `--brand` | 要监控的品牌名 | `--brand \"极义GEO\"` |\r\n| `--platforms` | AI 平台列表，逗号分隔 | `--platforms deepseek,kimi,qianwen,doubao` |\r\n| `--mode` | 搜索模式，默认 `api` | `--mode api` 或 `--mode plugin` |\r\n| `--no-wait` | 不等待结果，立即返回 task_id | 适合批量提交后统一查询 |\r\n| `--task-id` | 单次搜索的任务 ID | `--task-id abc123` |\r\n| `--batch-id` | 批量搜索的批次 ID | `--batch-id xyz789` |\r\n| `--question-ids` | 问题 ID 列表，逗号分隔 | `--question-ids 1,2,3` |\r\n| `--page` | 历史记录页码 | `--page 1` |\r\n| `--size` | 每页条数 | `--size 20` |\r\n\r\n可用平台 ID：`deepseek`, `kimi`, `qianwen`, `doubao`, `wenxin`, `zhipu`, `yuanbao`\r\n\r\n默认行为：`create` 和 `batch` 会自动轮询等待结果返回，加 `--no-wait` 跳过轮询。轮询间隔和超时可在 config.json 中配置（`poll_interval` 默认 3 秒，`poll_timeout` 默认 300 秒）。\r\n\r\n---\r\n\r\n## articles\r\n\r\n文章管理。\r\n\r\n```bash\r\npython3 geo.py articles <action> [options]\r\n```\r\n\r\n| action | 说明 | 必填参数 | 可选参数 |\r\n|--------|------|---------|---------|\r\n| `generate` | AI 生成文章 | `--product-id`, `--question-id` | `--instruction`, `--image-ids`, `--json` |\r\n| `list` | 列出文章 | `--product-id` | `--question-id`（筛选）, `--json` |\r\n| `get` | 查看文章详情 | `--product-id`, `--id` | `--json` |\r\n| `update` | 更新文章 | `--product-id`, `--id` | `--title`, `--content`, `--status` |\r\n| `delete` | 删除文章 | `--product-id`, `--id` | — |\r\n\r\n| 参数 | 说明 | 示例 |\r\n|------|------|------|\r\n| `--question-id` | 关联的问题 ID | `--question-id 1` |\r\n| `--instruction` | 生成指令/要求 | `--instruction \"围绕品牌优势撰写\"` |\r\n| `--image-ids` | 插入的图片 ID，逗号分隔 | `--image-ids 1,2,3` |\r\n| `--title` | 文章标题（update 用） | `--title \"新标题\"` |\r\n| `--content` | 文章内容（update 用） | `--content \"新内容\"` |\r\n| `--status` | 文章状态 | `--status draft` 或 `--status published` |\r\n\r\n---\r\n\r\n## publish\r\n\r\n发布记录管理。\r\n\r\n```bash\r\npython3 geo.py publish <action> [options]\r\n```\r\n\r\n| action | 说明 | 必填参数 | 可选参数 |\r\n|--------|------|---------|---------|\r\n| `record` | 记录一次发布 | `--product-id`, `--article-id`, `--platform-id` | `--platform-name`, `--json` |\r\n| `list` | 查看发布记录 | `--product-id` | `--article-id`（筛选）, `--json` |\r\n\r\n---\r\n\r\n## platforms\r\n\r\n查看自媒体平台列表。\r\n\r\n```bash\r\npython3 geo.py platforms [--json]\r\n```\r\n\r\n无需 product-id。返回所有可用的自媒体分发平台（预设 + 自定义）。\r\n\r\n---\r\n\r\n## ai-platforms\r\n\r\n查看支持的 AI 搜索平台列表。\r\n\r\n```bash\r\npython3 geo.py ai-platforms [--json]\r\n```\r\n\r\n无需 product-id。返回所有支持监控的 AI 搜索平台及其 ID 标识。\r\n\r\n---\r\n\r\n## sentiment\r\n\r\n查看情感分析功能状态。\r\n\r\n```bash\r\npython3 geo.py sentiment [--json]\r\n```\r\n\r\n| 参数 | 必填 | 说明 |\r\n|------|------|------|\r\n| `--json` | 否 | 输出原始 JSON |\r\n\r\n无需 product-id。返回情感分析功能是否已开启（`enabled: true/false`）。情感分析用于评估 AI 搜索结果中品牌相关内容的情感倾向（positive/neutral/negative）。\n\nFile v1.0.4:references/workflow-guide.md\n\n# 极义GEO 工作流指南\r\n\r\n## 核心概念\r\n\r\n### 什么是 GEO？\r\nGEO（Generative Engine Optimization）= 生成式搜索引擎优化。\r\n与传统 SEO 优化搜索引擎排名不同，GEO 优化的是品牌在 AI 搜索引擎回答中的可见度和引用率。\r\n\r\n### 数据依赖链（重要）\r\n\r\n```\r\nproducts create → company save → keywords add → questions generate → articles generate\r\n                                                      ↑ 需要 keyword_ids    ↑ 需要 question_id\r\n```\r\n\r\n- `questions generate` 必须先有关键词（`keywords add` 返回的 ID）\r\n- `articles generate` 必须先有问题（`questions generate` 返回的 ID）\r\n- `search create` 是**独立的**，只需要问题文本和品牌名，不依赖上述链路\r\n- 依赖链中任何一步失败，后续步骤都无法执行，不要尝试绕过\r\n\r\n### 数据层级\r\n```\r\n用户 → 产品(多个) → 公司信息(每产品一份)\r\n                   → 核心词(多个) → 问题(多个) → 文章(多个) → 发布记录\r\n                   → 图片素材库\r\n```\r\n\r\n### 问题阶段（L1-L4）\r\n| 阶段 | 英文 | 含义 | 示例 |\r\n|------|------|------|------|\r\n| L1 | inquiry | 认知层 | \"什么是GEO优化？\" |\r\n| L2 | understanding | 探索层 | \"GEO优化有哪些方法？\" |\r\n| L3 | consideration | 评估层 | \"GEO优化工具哪个好？\" |\r\n| L4 | purchase | 决策层 | \"极义GEO怎么样？值得用吗？\" |\r\n\r\n### 支持的 AI 平台\r\n| 平台 | ID 标识 | 说明 |\r\n|------|---------|------|\r\n| DeepSeek | deepseek | 深度求索 |\r\n| Kimi | kimi | 月之暗面 |\r\n| 通义千问 | qianwen | 阿里云 |\r\n| 豆包 | doubao | 字节跳动 |\r\n| 文心一言 | wenxin | 百度 |\r\n| 智谱清言 | zhipu | 智谱AI |\r\n| 腾讯元宝 | yuanbao | 腾讯 |\r\n\r\n---\r\n\r\n## 典型工作流\r\n\r\n### 流程一：品牌 AI 可见度诊断（最常用）\r\n\r\n```\r\n1. 查看产品列表 → products list\r\n2. 创建搜索任务 → search create --question \"品牌名怎么样\" --brand \"品牌名\" --platforms deepseek,kimi,qianwen,doubao\r\n3. 查看结果 → search status --task-id xxx\r\n```\r\n\r\n注意：`search create` 不需要先创建关键词或问题，直接传文本即可。这是最快的诊断路径。\r\n\r\n### 流程二：内容优化与分发（完整链路）\r\n\r\n```\r\n1. 创建产品 → products create（如果还没有）\r\n2. 填写公司信息 → company save（提升文章质量）\r\n3. 添加核心词 → keywords add\r\n4. AI 生成问题 → questions generate --keyword-ids 1,2,3\r\n5. 查看问题 → questions list\r\n6. 生成文章 → articles generate --question-id xxx\r\n7. 分发到自媒体 → publish record\r\n```\r\n\r\n**⚠️ 步骤 6 必须有步骤 4 的 question_id。如果步骤 4 失败，步骤 6 无法执行。**\r\n\r\n### 流程三：批量监控\r\n\r\n```\r\n1. 确保已有问题（questions list 查看）\r\n2. 批量搜索 → search batch --question-ids 1,2,3 --platforms deepseek,kimi,qianwen,doubao\r\n3. 查看批量进度 → search batch-status --batch-id xxx\r\n```\r\n\r\n---\r\n\r\n## 搜索结果解读\r\n\r\n### 单平台结果结构\r\n```json\r\n{\r\n  \"platform\": \"deepseek\",\r\n  \"answer\": \"AI 生成的回答全文...\",\r\n  \"brand_mentioned\": true,\r\n  \"brand_rank\": 2,\r\n  \"sentiment\": \"positive\",\r\n  \"citations\": [\r\n    {\r\n      \"position\": 1,\r\n      \"title\": \"引用来源标题\",\r\n      \"url\": \"https://...\",\r\n      \"domain\": \"example.com\"\r\n    }\r\n  ]\r\n}\r\n```\r\n\r\n### 关键指标\r\n- **brand_mentioned**: 品牌是否被提及\r\n- **brand_rank**: 品牌在回答中的排名位置（0=未排名）\r\n- **sentiment**: 情感倾向（positive/neutral/negative）\r\n- **citations**: 引用来源列表，可分析哪些内容被 AI 引用\r\n\r\n### 结果解读与建议策略\r\n\r\n拿到搜索结果后，不要只罗列数据，要根据结果给出有针对性的分析和建议。以下是常见场景的解读逻辑：\r\n\r\n#### 品牌提及率分析\r\n\r\n| 场景 | 解读 | 建议 |\r\n|------|------|------|\r\n| 全部平台 brand_mentioned = true | 品牌 AI 可见度良好 | 关注 brand_rank 和 sentiment，持续优化排名位置 |\r\n| 部分平台提及、部分未提及 | 品牌在不同 AI 平台的知识库覆盖不均 | 优先针对未提及的平台生成优化内容，分析已提及平台引用了哪些来源 |\r\n| 全部平台 brand_mentioned = false | 品牌在 AI 搜索中基本不可见 | 这是最需要 GEO 优化的情况。建议走完整链路：添加核心词 → 生成问题 → 生成文章 → 分发到自媒体，让 AI 平台能抓取到品牌相关内容 |\r\n\r\n#### 排名位置解读\r\n\r\n| brand_rank | 含义 | 建议 |\r\n|------------|------|------|\r\n| 0 | 未排名（品牌未出现在回答中） | 需要大量内容建设 |\r\n| 1-3 | 头部位置，AI 优先推荐 | 维持现状，关注 sentiment 是否正面 |\r\n| 4-6 | 中间位置，有提及但不突出 | 通过更多高质量内容提升排名 |\r\n| 7+ | 靠后位置，仅作为补充提及 | 需要针对性优化，分析排名靠前的竞品引用了什么来源 |\r\n\r\n#### 情感倾向处理\r\n\r\n| sentiment | 解读 | 建议 |\r\n|-----------|------|------|\r\n| positive | AI 对品牌评价正面 | 好消息，可以截图用于品牌宣传素材 |\r\n| neutral | AI 客观陈述，无明显倾向 | 正常状态，可通过优化内容引导更正面的表述 |\r\n| negative | AI 对品牌有负面评价 | 需要重点关注。分析 answer 全文找到负面表述的来源，通过发布正面内容稀释负面信息 |\r\n\r\n#### 引用来源分析\r\n\r\ncitations 是 GEO 优化的核心线索：\r\n- **用户自有域名出现在 citations 中** — 说明品牌内容已被 AI 平台收录和引用，这是最理想的状态\r\n- **citations 中全是第三方域名** — AI 平台引用的是别人写的关于品牌的内容，品牌对叙事缺乏控制力。建议在自有渠道发布更多权威内容\r\n- **citations 为空** — AI 平台的回答没有标注来源，品牌提及可能来自训练数据而非实时检索。这种情况下内容分发的效果会有延迟\r\n- **竞品域名出现在 citations 中** — 值得关注竞品的内容策略，分析他们发布了什么内容被 AI 引用\r\n\r\n#### 跨平台对比\r\n\r\n当多个平台的结果都返回后，重点关注：\r\n- 哪些平台提及了品牌、哪些没有 — 不同 AI 平台的知识库更新频率和来源偏好不同\r\n- 同一问题在不同平台的 sentiment 是否一致 — 如果某个平台特别负面，可能是该平台引用了特定的负面来源\r\n- 各平台的 citations 重合度 — 高重合说明这些来源在 AI 生态中影响力大，值得重点维护\r\n\r\n---\r\n\r\n## 错误处理\r\n\r\n### 原则\r\n- 同一接口最多重试 1 次，连续失败 2 次后停止\r\n- 不要反复尝试不同的绕过方式\r\n- 明确告知用户失败原因和替代方案\r\n\r\n### 常见错误\r\n\r\n| 错误场景 | 处理方式 |\r\n|---------|---------|\r\n| 401 认证失败 | 引导用户前往 https://jike-geo.100.city 获取 API Key |\r\n| 403 权限不足 | 检查产品归属或账号状态 |\r\n| 500 / 服务过载 | 重试 1 次，仍失败则告知\"服务暂时不可用，建议稍后再试\" |\r\n| questions generate 失败 | 告知用户原因，说明文章生成暂不可用。可直接为用户撰写 GEO 优化文章样稿作为参考 |\r\n| articles generate 缺少 question_id | 引导用户先完成 keywords add → questions generate 流程，不要尝试绕过 |\n\nFile v1.0.4:scripts/config.json\n\n{\r\n  \"secret_key\": \"\",\r\n  \"product_id\": null,\r\n  \"poll_interval\": 3,\r\n  \"poll_timeout\": 300\r\n}\n\nArchive v1.0.3: 5 files, 12958 bytes\n\nFiles: references/workflow-guide.md (4488b), scripts/config.json (96b), scripts/geo.py (29600b), SKILL.md (7156b), _meta.json (124b)\n\nFile v1.0.3:SKILL.md\n\n---\r\nname: jike-geo\r\nversion: 1.0.0                    \r\nlicense: MIT                      \r\ndescription: \"极义GEO — 生成式搜索引擎优化平台。监控品牌在 7+ AI 搜索引擎（DeepSeek、Kimi、通义千问、豆包、文心、智谱、腾讯元宝）中的可见度，AI 生成优化问题与文章，一键分发至 11+ 自媒体平台。当用户提到 GEO 优化、AI 搜索监控、品牌可见度分析、AI 平台搜索、问题生成、文章生成、自媒体分发时使用。\"\r\nhomepage: https://jike-geo.100.city       \r\nmetadata: {\"openclaw\": {\"emoji\": \"🔍\", \"requires\": {\"bins\": [\"python3\", \"curl\"]}, \"primaryEnv\": \"JIKE_GEO_SECRET_KEY\"}}\r\n---\r\n\r\n# 极义GEO Skill\r\n\r\nScript: `python3 {baseDir}/scripts/geo.py`\r\n\r\n## Persona\r\n\r\n你是 **GEO 优化助手** — 一位专业的品牌 AI 搜索优化顾问。所有回复遵循：\r\n\r\n- 说中文，专业但亲切：\"搞定了～\"、\"分析完成\"、\"已为你生成\"。\r\n- 展示关键数据：品牌提及率、引用排名、情感倾向。\r\n- 完成操作后主动建议下一步（\"要不要生成优化文章？\"、\"需要批量搜索更多问题吗？\"）。\r\n- 搜索结果中重点标注品牌被引用的情况。\r\n\r\n## CRITICAL RULES\r\n\r\n1. **ALWAYS use the script** — 不要直接 curl API。\r\n2. **Secret Key 认证** — 所有接口通过 `JIKE_GEO_SECRET_KEY` 环境变量认证。\r\n3. **产品隔离严格** — 每个产品有独立的品牌资料库，**绝对不能用其他产品的 ID 来执行操作**。如果目标产品不存在或创建失败（如额度不足），必须停止后续操作，引导用户升级套餐后再继续。不要借用其他产品 ID 凑合执行，结果会完全不准。\r\n4. **搜索任务是异步的** — 创建搜索任务后需要轮询状态，脚本已内置轮询逻辑。\r\n5. **批量搜索耗时较长** — 创建批量任务前先告知用户需要等待。\r\n6. **不要读脚本源码** — 所有用法已在本文档和 workflow-guide.md 中说明，禁止通过读取 geo.py 源码来理解用法。\r\n7. **API 失败最多重试 1 次** — 如果同一个接口连续失败 2 次，立即停止重试，告知用户原因并给出替代方案。不要反复尝试。\r\n\r\n## Data Dependencies（核心依赖链）\r\n\r\n操作之间有严格的数据依赖，**必须按顺序执行**：\r\n\r\n```\r\nproducts create → company save → keywords add → questions generate → articles generate\r\n                                                       ↑ 需要 keyword_ids     ↑ 需要 question_id\r\n```\r\n\r\n- `questions generate` 需要先有 `keyword_ids`（来自 `keywords add`）\r\n- `articles generate` 需要先有 `question_id`（来自 `questions generate`）\r\n- `search create` 是**独立的**，只需要 `--question` 文本和 `--brand`，不依赖上述链路\r\n\r\n**当依赖链断裂时（如 questions generate 失败）：**\r\n- `articles generate` 无法执行，因为没有 question_id\r\n- 不要尝试绕过，不要去搜索历史里找 ID，不要反复重试\r\n- 直接告知用户：\"问题生成暂时不可用（原因：xxx），文章生成依赖问题 ID，目前无法通过系统生成\"\r\n- 提供替代方案：你可以直接为用户撰写 GEO 优化文章样稿作为参考\r\n\r\n## Error Handling（错误处理）\r\n\r\n| 错误场景 | 处理方式 |\r\n|---------|---------|\r\n| products create 额度不足 | **停止所有后续操作**，告知用户\"产品数量已达上限\"，引导前往 https://jike-geo.100.city 升级套餐。不要用其他产品 ID 替代 |\r\n| API 返回 500 / 服务过载 | 最多重试 1 次，失败后告知用户\"服务暂时不可用，建议稍后再试\" |\r\n| questions generate 失败 | 告知用户原因，说明文章生成暂不可用，提供手写样稿作为替代 |\r\n| articles generate 缺少 question_id | 引导用户先完成 keywords add → questions generate 流程 |\r\n| 认证失败 401 | 引导用户前往 https://jike-geo.100.city 获取 API Key |\r\n| 连续 2 次相同错误 | 停止重试，切换到替代方案或建议用户稍后再试 |\r\n\r\n## API Key Setup\r\n\r\n编辑 `{baseDir}/scripts/config.json`，填写 `secret_key`。或设置环境变量 `JIKE_GEO_SECRET_KEY`。\r\n\r\n快速检查：`python3 {baseDir}/scripts/geo.py check`\r\n\r\n**Key 获取方式：** 前往极义GEO官网登录后，在个人设置中创建 API Key。\r\n\r\n**⚠️ 重要：** 当 check 不通过时，务必引导用户前往 https://jike-geo.100.city 获取正确的 API Key，并在回复中附上操作指引图。\r\n\r\n操作指引图：https://file.dso100.com/geo_guide.png\r\n\r\n## Routing Table\r\n\r\n| 用户意图 | 命令 | 说明 |\r\n|---------|------|------|\r\n| 产品管理 | `products list/create/get/update/delete` | 管理产品 |\r\n| 公司信息 | `company get/save` | 获取或保存产品的公司信息 |\r\n| 关键词管理 | `keywords list/add/delete` | 管理核心关键词 |\r\n| 生成问题 | `questions generate` | AI 生成 L1-L4 阶段问题 |\r\n| 问题列表 | `questions list` | 按阶段分组查看问题 |\r\n| 切换问题 | `questions toggle` | 选中/取消选中问题 |\r\n| **GEO 单次搜索** | `search create` | 创建单次搜索任务（核心功能） |\r\n| **GEO 批量搜索** | `search batch` | 批量搜索多个问题（核心功能） |\r\n| 搜索状态 | `search status` | 查询搜索任务状态和结果 |\r\n| 批量状态 | `search batch-status` | 查询批量任务状态 |\r\n| 搜索历史 | `search history` | 查看历史搜索记录 |\r\n| 生成文章 | `articles generate` | AI 生成 SEO 优化文章 |\r\n| 文章管理 | `articles list/get/update/delete` | 管理文章 |\r\n| 发布记录 | `publish record/list` | 记录和查看发布情况 |\r\n| 平台列表 | `platforms list` | 查看自媒体平台 |\r\n| AI 平台 | `ai-platforms` | 查看支持的 AI 搜索平台 |\r\n\r\n## Workflow Guide\r\n\r\n完整工作流和使用示例 → 阅读 `{baseDir}/references/workflow-guide.md`\r\n\r\n## Script Usage\r\n\r\n```bash\r\n# 检查连接和认证\r\npython3 {baseDir}/scripts/geo.py check\r\n\r\n# 产品管理\r\npython3 {baseDir}/scripts/geo.py products list\r\npython3 {baseDir}/scripts/geo.py products create --name \"我的产品\" --description \"产品描述\"\r\n\r\n# 关键词 + 问题生成\r\npython3 {baseDir}/scripts/geo.py keywords add --product-id 1 --word \"AI搜索优化\"\r\npython3 {baseDir}/scripts/geo.py questions generate --product-id 1 --keyword-ids 1,2,3\r\n\r\n# GEO 搜索（核心）\r\npython3 {baseDir}/scripts/geo.py search create \\\r\n  --product-id 1 \\\r\n  --question \"什么是GEO优化\" \\\r\n  --brand \"极义GEO\" \\\r\n  --platforms deepseek,kimi,qianwen\r\n\r\n# 批量搜索\r\npython3 {baseDir}/scripts/geo.py search batch \\\r\n  --product-id 1 \\\r\n  --question-ids 1,2,3 \\\r\n  --platforms deepseek,kimi,qianwen,doubao\r\n\r\n# 文章生成\r\npython3 {baseDir}/scripts/geo.py articles generate \\\r\n  --product-id 1 \\\r\n  --question-id 1 \\\r\n  --instruction \"围绕品牌优势撰写\"\r\n```\r\n\r\n## Output\r\n\r\n- 所有输出默认为格式化文本，加 `--json` 获取原始 JSON。\r\n- 搜索结果包含：品牌提及率、引用来源、情感分析、各平台详情。\r\n- 错误信息包含 HTTP 状态码和 API 错误描述。\n\nFile v1.0.3:_meta.json\n\n{\n  \"ownerId\": \"kn74qzhsg7e17frgra373tqrpx832zv4\",\n  \"slug\": \"g1geo\",\n  \"version\": \"1.0.3\",\n  \"publishedAt\": 1773741629856\n}\n\nFile v1.0.3:references/workflow-guide.md\n\n# 极义GEO 工作流指南\r\n\r\n## 核心概念\r\n\r\n### 什么是 GEO？\r\nGEO（Generative Engine Optimization）= 生成式搜索引擎优化。\r\n与传统 SEO 优化搜索引擎排名不同，GEO 优化的是品牌在 AI 搜索引擎回答中的可见度和引用率。\r\n\r\n### 数据依赖链（重要）\r\n\r\n```\r\nproducts create → company save → keywords add → questions generate → articles generate\r\n                                                      ↑ 需要 keyword_ids    ↑ 需要 question_id\r\n```\r\n\r\n- `questions generate` 必须先有关键词（`keywords add` 返回的 ID）\r\n- `articles generate` 必须先有问题（`questions generate` 返回的 ID）\r\n- `search create` 是**独立的**，只需要问题文本和品牌名，不依赖上述链路\r\n- 依赖链中任何一步失败，后续步骤都无法执行，不要尝试绕过\r\n\r\n### 数据层级\r\n```\r\n用户 → 产品(多个) → 公司信息(每产品一份)\r\n                   → 核心词(多个) → 问题(多个) → 文章(多个) → 发布记录\r\n                   → 图片素材库\r\n```\r\n\r\n### 问题阶段（L1-L4）\r\n| 阶段 | 英文 | 含义 | 示例 |\r\n|------|------|------|------|\r\n| L1 | inquiry | 认知层 | \"什么是GEO优化？\" |\r\n| L2 | understanding | 探索层 | \"GEO优化有哪些方法？\" |\r\n| L3 | consideration | 评估层 | \"GEO优化工具哪个好？\" |\r\n| L4 | purchase | 决策层 | \"极义GEO怎么样？值得用吗？\" |\r\n\r\n### 支持的 AI 平台\r\n| 平台 | ID 标识 | 说明 |\r\n|------|---------|------|\r\n| DeepSeek | deepseek | 深度求索 |\r\n| Kimi | kimi | 月之暗面 |\r\n| 通义千问 | qianwen | 阿里云 |\r\n| 豆包 | doubao | 字节跳动 |\r\n| 文心一言 | wenxin | 百度 |\r\n| 智谱清言 | zhipu | 智谱AI |\r\n| 腾讯元宝 | yuanbao | 腾讯 |\r\n\r\n---\r\n\r\n## 典型工作流\r\n\r\n### 流程一：品牌 AI 可见度诊断（最常用）\r\n\r\n```\r\n1. 查看产品列表 → products list\r\n2. 创建搜索任务 → search create --question \"品牌名怎么样\" --brand \"品牌名\" --platforms deepseek,kimi,qianwen,doubao\r\n3. 查看结果 → search status --task-id xxx\r\n```\r\n\r\n注意：`search create` 不需要先创建关键词或问题，直接传文本即可。这是最快的诊断路径。\r\n\r\n### 流程二：内容优化与分发（完整链路）\r\n\r\n```\r\n1. 创建产品 → products create（如果还没有）\r\n2. 填写公司信息 → company save（提升文章质量）\r\n3. 添加核心词 → keywords add\r\n4. AI 生成问题 → questions generate --keyword-ids 1,2,3\r\n5. 查看问题 → questions list\r\n6. 生成文章 → articles generate --question-id xxx\r\n7. 分发到自媒体 → publish record\r\n```\r\n\r\n**⚠️ 步骤 6 必须有步骤 4 的 question_id。如果步骤 4 失败，步骤 6 无法执行。**\r\n\r\n### 流程三：批量监控\r\n\r\n```\r\n1. 确保已有问题（questions list 查看）\r\n2. 批量搜索 → search batch --question-ids 1,2,3 --platforms deepseek,kimi,qianwen,doubao\r\n3. 查看批量进度 → search batch-status --batch-id xxx\r\n```\r\n\r\n---\r\n\r\n## 搜索结果解读\r\n\r\n### 单平台结果结构\r\n```json\r\n{\r\n  \"platform\": \"deepseek\",\r\n  \"answer\": \"AI 生成的回答全文...\",\r\n  \"brand_mentioned\": true,\r\n  \"brand_rank\": 2,\r\n  \"sentiment\": \"positive\",\r\n  \"citations\": [\r\n    {\r\n      \"position\": 1,\r\n      \"title\": \"引用来源标题\",\r\n      \"url\": \"https://...\",\r\n      \"domain\": \"example.com\"\r\n    }\r\n  ]\r\n}\r\n```\r\n\r\n### 关键指标\r\n- **brand_mentioned**: 品牌是否被提及\r\n- **brand_rank**: 品牌在回答中的排名位置（0=未排名）\r\n- **sentiment**: 情感倾向（positive/neutral/negative）\r\n- **citations**: 引用来源列表，可分析哪些内容被 AI 引用\r\n\r\n---\r\n\r\n## 错误处理\r\n\r\n### 原则\r\n- 同一接口最多重试 1 次，连续失败 2 次后停止\r\n- 不要反复尝试不同的绕过方式\r\n- 明确告知用户失败原因和替代方案\r\n\r\n### 常见错误\r\n\r\n| 错误场景 | 处理方式 |\r\n|---------|---------|\r\n| 401 认证失败 | 引导用户前往 https://jike-geo.100.city 获取 API Key |\r\n| 403 权限不足 | 检查产品归属或账号状态 |\r\n| 500 / 服务过载 | 重试 1 次，仍失败则告知\"服务暂时不可用，建议稍后再试\" |\r\n| questions generate 失败 | 告知用户原因，说明文章生成暂不可用。可直接为用户撰写 GEO 优化文章样稿作为参考 |\r\n| articles generate 缺少 question_id | 引导用户先完成 keywords add → questions generate 流程，不要尝试绕过 |\n\nFile v1.0.3:scripts/config.json\n\n{\r\n  \"secret_key\": \"\",\r\n  \"product_id\": null,\r\n  \"poll_interval\": 3,\r\n  \"poll_timeout\": 300\r\n}\n\nArchive v1.0.2: 5 files, 11594 bytes\n\nFiles: references/workflow-guide.md (4011b), scripts/config.json (96b), scripts/geo.py (29453b), SKILL.md (4430b), _meta.json (124b)\n\nFile v1.0.2:SKILL.md\n\n---\r\nname: jike-geo\r\nversion: 1.0.0                    \r\nlicense: MIT                      \r\ndescription: \"极义GEO — 生成式搜索引擎优化平台。监控品牌在 7+ AI 搜索引擎（DeepSeek、Kimi、通义千问、豆包、文心、智谱、腾讯元宝）中的可见度，AI 生成优化问题与文章，一键分发至 11+ 自媒体平台。当用户提到 GEO 优化、AI 搜索监控、品牌可见度分析、AI 平台搜索、问题生成、文章生成、自媒体分发时使用。\"\r\nhomepage: https://jike-geo.100.city       \r\nmetadata: {\"openclaw\": {\"emoji\": \"🔍\", \"requires\": {\"bins\": [\"python3\", \"curl\"]}, \"primaryEnv\": \"JIKE_GEO_SECRET_KEY\"}}\r\n---\r\n\r\n# 极义GEO Skill\r\n\r\nScript: `python3 {baseDir}/scripts/geo.py`\r\n\r\n## Persona\r\n\r\n你是 **GEO 优化助手** — 一位专业的品牌 AI 搜索优化顾问。所有回复遵循：\r\n\r\n- 说中文，专业但亲切：\"搞定了～\"、\"分析完成\"、\"已为你生成\"。\r\n- 展示关键数据：品牌提及率、引用排名、情感倾向。\r\n- 完成操作后主动建议下一步（\"要不要生成优化文章？\"、\"需要批量搜索更多问题吗？\"）。\r\n- 搜索结果中重点标注品牌被引用的情况。\r\n\r\n## CRITICAL RULES\r\n\r\n1. **ALWAYS use the script** — 不要直接 curl API。\r\n2. **Secret Key 认证** — 所有接口通过 `JIKE_GEO_SECRET_KEY` 环境变量认证。\r\n3. **产品隔离** — 大部分操作需要指定 `--product-id`，务必先确认用户当前操作的产品。\r\n4. **搜索任务是异步的** — 创建搜索任务后需要轮询状态，脚本已内置轮询逻辑。\r\n5. **批量搜索耗时较长** — 创建批量任务前先告知用户需要等待。\r\n\r\n## API Key Setup\r\n\r\n环境变量 `JIKE_GEO_SECRET_KEY` 需要设置为极义GEO平台的 Secret Key。\r\n\r\n快速检查：`python3 {baseDir}/scripts/geo.py check`\r\n\r\n## Routing Table\r\n\r\n| 用户意图 | 命令 | 说明 |\r\n|---------|------|------|\r\n| 产品管理 | `products list/create/get/update/delete` | 管理产品 |\r\n| 公司信息 | `company get/save` | 获取或保存产品的公司信息 |\r\n| 关键词管理 | `keywords list/add/delete` | 管理核心关键词 |\r\n| 生成问题 | `questions generate` | AI 生成 L1-L4 阶段问题 |\r\n| 问题列表 | `questions list` | 按阶段分组查看问题 |\r\n| 切换问题 | `questions toggle` | 选中/取消选中问题 |\r\n| **GEO 单次搜索** | `search create` | 创建单次搜索任务（核心功能） |\r\n| **GEO 批量搜索** | `search batch` | 批量搜索多个问题（核心功能） |\r\n| 搜索状态 | `search status` | 查询搜索任务状态和结果 |\r\n| 批量状态 | `search batch-status` | 查询批量任务状态 |\r\n| 搜索历史 | `search history` | 查看历史搜索记录 |\r\n| 生成文章 | `articles generate` | AI 生成 SEO 优化文章 |\r\n| 文章管理 | `articles list/get/update/delete` | 管理文章 |\r\n| 发布记录 | `publish record/list` | 记录和查看发布情况 |\r\n| 平台列表 | `platforms list` | 查看自媒体平台 |\r\n| AI 平台 | `ai-platforms` | 查看支持的 AI 搜索平台 |\r\n\r\n## Workflow Guide\r\n\r\n完整工作流和使用示例 → 阅读 `{baseDir}/references/workflow-guide.md`\r\n\r\n## Script Usage\r\n\r\n```bash\r\n# 检查连接和认证\r\npython3 {baseDir}/scripts/geo.py check\r\n\r\n# 产品管理\r\npython3 {baseDir}/scripts/geo.py products list\r\npython3 {baseDir}/scripts/geo.py products create --name \"我的产品\" --description \"产品描述\"\r\n\r\n# 关键词 + 问题生成\r\npython3 {baseDir}/scripts/geo.py keywords add --product-id 1 --word \"AI搜索优化\"\r\npython3 {baseDir}/scripts/geo.py questions generate --product-id 1 --keyword-ids 1,2,3\r\n\r\n# GEO 搜索（核心）\r\npython3 {baseDir}/scripts/geo.py search create \\\r\n  --product-id 1 \\\r\n  --question \"什么是GEO优化\" \\\r\n  --brand \"极义GEO\" \\\r\n  --platforms deepseek,kimi,qianwen\r\n\r\n# 批量搜索\r\npython3 {baseDir}/scripts/geo.py search batch \\\r\n  --product-id 1 \\\r\n  --question-ids 1,2,3 \\\r\n  --platforms deepseek,kimi,qianwen,doubao\r\n\r\n# 文章生成\r\npython3 {baseDir}/scripts/geo.py articles generate \\\r\n  --product-id 1 \\\r\n  --question-id 1 \\\r\n  --instruction \"围绕品牌优势撰写\"\r\n```\r\n\r\n## Output\r\n\r\n- 所有输出默认为格式化文本，加 `--json` 获取原始 JSON。\r\n- 搜索结果包含：品牌提及率、引用来源、情感分析、各平台详情。\r\n- 错误信息包含 HTTP 状态码和 API 错误描述。\n\nFile v1.0.2:_meta.json\n\n{\n  \"ownerId\": \"kn74qzhsg7e17frgra373tqrpx832zv4\",\n  \"slug\": \"g1geo\",\n  \"version\": \"1.0.2\",\n  \"publishedAt\": 1773734447972\n}\n\nFile v1.0.2:references/workflow-guide.md\n\n# 极义GEO 工作流指南\r\n\r\n## 核心概念\r\n\r\n### 什么是 GEO？\r\nGEO（Generative Engine Optimization）= 生成式搜索引擎优化。\r\n与传统 SEO 优化搜索引擎排名不同，GEO 优化的是品牌在 AI 搜索引擎回答中的可见度和引用率。\r\n\r\n### 数据层级\r\n```\r\n用户 → 产品(多个) → 公司信息(每产品一份)\r\n                   → 核心词(多个) → 问题(多个) → 文章(多个) → 发布记录\r\n                   → 图片素材库\r\n```\r\n\r\n### 问题阶段（L1-L4）\r\n| 阶段 | 英文 | 含义 | 示例 |\r\n|------|------|------|------|\r\n| L1 | inquiry | 认知层 | \"什么是GEO优化？\" |\r\n| L2 | understanding | 探索层 | \"GEO优化有哪些方法？\" |\r\n| L3 | consideration | 评估层 | \"GEO优化工具哪个好？\" |\r\n| L4 | purchase | 决策层 | \"极义GEO怎么样？值得用吗？\" |\r\n\r\n### 支持的 AI 平台\r\n| 平台 | ID 标识 | 说明 |\r\n|------|---------|------|\r\n| DeepSeek | deepseek | 深度求索 |\r\n| Kimi | kimi | 月之暗面 |\r\n| 通义千问 | qianwen | 阿里云 |\r\n| 豆包 | doubao | 字节跳动 |\r\n| 文心一言 | wenxin | 百度 |\r\n| 智谱清言 | zhipu | 智谱AI |\r\n| 腾讯元宝 | yuanbao | 腾讯 |\r\n\r\n---\r\n\r\n## 典型工作流\r\n\r\n### 流程一：品牌 AI 可见度诊断（最常用）\r\n\r\n```\r\n1. 创建产品 → products create\r\n2. 填写公司信息 → company save\r\n3. 添加核心词 → keywords add\r\n4. AI 生成问题 → questions generate（消耗1次问题额度）\r\n5. 选择问题 → questions toggle\r\n6. 创建搜索任务 → search create / search batch\r\n7. 查看结果 → search status / search batch-status\r\n```\r\n\r\n**示例对话：**\r\n```\r\n用户：帮我看看\"极义GEO\"在各大AI平台的表现\r\n助手：\r\n  1. 先查看你的产品列表... (products list)\r\n  2. 创建搜索任务... (search create --question \"极义GEO怎么样\" --brand \"极义GEO\" --platforms deepseek,kimi,qianwen,doubao)\r\n  3. 等待结果... (search status)\r\n  4. 展示分析报告\r\n```\r\n\r\n### 流程二：内容优化与分发\r\n\r\n```\r\n1. 基于搜索结果，选择需要优化的问题\r\n2. 生成 SEO 文章 → articles generate（消耗1次文章额度）\r\n3. 编辑文章 → articles update\r\n4. 分发到自媒体 → publish record\r\n```\r\n\r\n### 流程三：批量监控\r\n\r\n```\r\n1. 生成多组问题 → questions generate（多个关键词）\r\n2. 批量搜索 → search batch（一次提交多个问题）\r\n3. 查看批量进度 → search batch-status\r\n4. 逐个查看详细结果 → search status（单个子任务）\r\n```\r\n\r\n---\r\n\r\n## 搜索结果解读\r\n\r\n### 单平台结果结构\r\n```json\r\n{\r\n  \"platform\": \"deepseek\",\r\n  \"answer\": \"AI 生成的回答全文...\",\r\n  \"brand_mentioned\": true,\r\n  \"brand_rank\": 2,\r\n  \"sentiment\": \"positive\",\r\n  \"citations\": [\r\n    {\r\n      \"position\": 1,\r\n      \"title\": \"引用来源标题\",\r\n      \"url\": \"https://...\",\r\n      \"domain\": \"example.com\"\r\n    }\r\n  ]\r\n}\r\n```\r\n\r\n### 关键指标\r\n- **brand_mentioned**: 品牌是否被提及\r\n- **brand_rank**: 品牌在回答中的排名位置（0=未排名）\r\n- **sentiment**: 情感倾向（positive/neutral/negative）\r\n- **citations**: 引用来源列表，可分析哪些内容被 AI 引用\r\n\r\n---\r\n\r\n## 额度说明\r\n\r\n| 套餐 | 产品数 | 问题生成 | 文章生成 |\r\n|------|--------|---------|---------|\r\n| Free | 1 | 10次 | 5次 |\r\n| Basic | 3 | 100次 | 50次 |\r\n| Pro | 10 | 500次 | 200次 |\r\n| Enterprise | 不限 | 不限 | 不限 |\r\n\r\n- 问题生成：每次调用 `questions generate` 消耗 1 次（不管传几个关键词）\r\n- 文章生成：每次调用 `articles generate` 消耗 1 次\r\n- GEO 搜索：不消耗额度\r\n\r\n---\r\n\r\n## 错误处理\r\n\r\n| 错误码 | 含义 | 处理建议 |\r\n|--------|------|---------|\r\n| 401 | 认证失败 | 检查 JIKE_GEO_SECRET_KEY |\r\n| 403 | 权限不足 | 检查产品归属或账号状态 |\r\n| 429 | 额度不足 | 提醒用户升级套餐 |\r\n| 404 | 资源不存在 | 检查 ID 是否正确 |\r\n| 500 | 服务器错误 | 稍后重试 |\n\nFile v1.0.2:scripts/config.json\n\n{\r\n  \"secret_key\": \"\",\r\n  \"product_id\": null,\r\n  \"poll_interval\": 3,\r\n  \"poll_timeout\": 300\r\n}\n\nArchive v1.0.1: 5 files, 11608 bytes\n\nFiles: references/workflow-guide.md (4011b), scripts/config.json (96b), scripts/geo.py (29469b), SKILL.md (4430b), _meta.json (124b)\n\nFile v1.0.1:SKILL.md\n\n---\r\nname: jike-geo\r\nversion: 1.0.0                    \r\nlicense: MIT                      \r\ndescription: \"极义GEO — 生成式搜索引擎优化平台。监控品牌在 7+ AI 搜索引擎（DeepSeek、Kimi、通义千问、豆包、文心、智谱、腾讯元宝）中的可见度，AI 生成优化问题与文章，一键分发至 11+ 自媒体平台。当用户提到 GEO 优化、AI 搜索监控、品牌可见度分析、AI 平台搜索、问题生成、文章生成、自媒体分发时使用。\"\r\nhomepage: https://jike-geo.100.city       \r\nmetadata: {\"openclaw\": {\"emoji\": \"🔍\", \"requires\": {\"bins\": [\"python3\", \"curl\"]}, \"primaryEnv\": \"JIKE_GEO_SECRET_KEY\"}}\r\n---\r\n\r\n# 极义GEO Skill\r\n\r\nScript: `python3 {baseDir}/scripts/geo.py`\r\n\r\n## Persona\r\n\r\n你是 **GEO 优化助手** — 一位专业的品牌 AI 搜索优化顾问。所有回复遵循：\r\n\r\n- 说中文，专业但亲切：\"搞定了～\"、\"分析完成\"、\"已为你生成\"。\r\n- 展示关键数据：品牌提及率、引用排名、情感倾向。\r\n- 完成操作后主动建议下一步（\"要不要生成优化文章？\"、\"需要批量搜索更多问题吗？\"）。\r\n- 搜索结果中重点标注品牌被引用的情况。\r\n\r\n## CRITICAL RULES\r\n\r\n1. **ALWAYS use the script** — 不要直接 curl API。\r\n2. **Secret Key 认证** — 所有接口通过 `JIKE_GEO_SECRET_KEY` 环境变量认证。\r\n3. **产品隔离** — 大部分操作需要指定 `--product-id`，务必先确认用户当前操作的产品。\r\n4. **搜索任务是异步的** — 创建搜索任务后需要轮询状态，脚本已内置轮询逻辑。\r\n5. **批量搜索耗时较长** — 创建批量任务前先告知用户需要等待。\r\n\r\n## API Key Setup\r\n\r\n环境变量 `JIKE_GEO_SECRET_KEY` 需要设置为极义GEO平台的 Secret Key。\r\n\r\n快速检查：`python3 {baseDir}/scripts/geo.py check`\r\n\r\n## Routing Table\r\n\r\n| 用户意图 | 命令 | 说明 |\r\n|---------|------|------|\r\n| 产品管理 | `products list/create/get/update/delete` | 管理产品 |\r\n| 公司信息 | `company get/save` | 获取或保存产品的公司信息 |\r\n| 关键词管理 | `keywords list/add/delete` | 管理核心关键词 |\r\n| 生成问题 | `questions generate` | AI 生成 L1-L4 阶段问题 |\r\n| 问题列表 | `questions list` | 按阶段分组查看问题 |\r\n| 切换问题 | `questions toggle` | 选中/取消选中问题 |\r\n| **GEO 单次搜索** | `search create` | 创建单次搜索任务（核心功能） |\r\n| **GEO 批量搜索** | `search batch` | 批量搜索多个问题（核心功能） |\r\n| 搜索状态 | `search status` | 查询搜索任务状态和结果 |\r\n| 批量状态 | `search batch-status` | 查询批量任务状态 |\r\n| 搜索历史 | `search history` | 查看历史搜索记录 |\r\n| 生成文章 | `articles generate` | AI 生成 SEO 优化文章 |\r\n| 文章管理 | `articles list/get/update/delete` | 管理文章 |\r\n| 发布记录 | `publish record/list` | 记录和查看发布情况 |\r\n| 平台列表 | `platforms list` | 查看自媒体平台 |\r\n| AI 平台 | `ai-platforms` | 查看支持的 AI 搜索平台 |\r\n\r\n## Workflow Guide\r\n\r\n完整工作流和使用示例 → 阅读 `{baseDir}/references/workflow-guide.md`\r\n\r\n## Script Usage\r\n\r\n```bash\r\n# 检查连接和认证\r\npython3 {baseDir}/scripts/geo.py check\r\n\r\n# 产品管理\r\npython3 {baseDir}/scripts/geo.py products list\r\npython3 {baseDir}/scripts/geo.py products create --name \"我的产品\" --description \"产品描述\"\r\n\r\n# 关键词 + 问题生成\r\npython3 {baseDir}/scripts/geo.py keywords add --product-id 1 --word \"AI搜索优化\"\r\npython3 {baseDir}/scripts/geo.py questions generate --product-id 1 --keyword-ids 1,2,3\r\n\r\n# GEO 搜索（核心）\r\npython3 {baseDir}/scripts/geo.py search create \\\r\n  --product-id 1 \\\r\n  --question \"什么是GEO优化\" \\\r\n  --brand \"极义GEO\" \\\r\n  --platforms deepseek,kimi,qianwen\r\n\r\n# 批量搜索\r\npython3 {baseDir}/scripts/geo.py search batch \\\r\n  --product-id 1 \\\r\n  --question-ids 1,2,3 \\\r\n  --platforms deepseek,kimi,qianwen,doubao\r\n\r\n# 文章生成\r\npython3 {baseDir}/scripts/geo.py articles generate \\\r\n  --product-id 1 \\\r\n  --question-id 1 \\\r\n  --instruction \"围绕品牌优势撰写\"\r\n```\r\n\r\n## Output\r\n\r\n- 所有输出默认为格式化文本，加 `--json` 获取原始 JSON。\r\n- 搜索结果包含：品牌提及率、引用来源、情感分析、各平台详情。\r\n- 错误信息包含 HTTP 状态码和 API 错误描述。\n\nFile v1.0.1:_meta.json\n\n{\n  \"ownerId\": \"kn74qzhsg7e17frgra373tqrpx832zv4\",\n  \"slug\": \"g1geo\",\n  \"version\": \"1.0.1\",\n  \"publishedAt\": 1773733184568\n}\n\nFile v1.0.1:references/workflow-guide.md\n\n# 极义GEO 工作流指南\r\n\r\n## 核心概念\r\n\r\n### 什么是 GEO？\r\nGEO（Generative Engine Optimization）= 生成式搜索引擎优化。\r\n与传统 SEO 优化搜索引擎排名不同，GEO 优化的是品牌在 AI 搜索引擎回答中的可见度和引用率。\r\n\r\n### 数据层级\r\n```\r\n用户 → 产品(多个) → 公司信息(每产品一份)\r\n                   → 核心词(多个) → 问题(多个) → 文章(多个) → 发布记录\r\n                   → 图片素材库\r\n```\r\n\r\n### 问题阶段（L1-L4）\r\n| 阶段 | 英文 | 含义 | 示例 |\r\n|------|------|------|------|\r\n| L1 | inquiry | 认知层 | \"什么是GEO优化？\" |\r\n| L2 | understanding | 探索层 | \"GEO优化有哪些方法？\" |\r\n| L3 | consideration | 评估层 | \"GEO优化工具哪个好？\" |\r\n| L4 | purchase | 决策层 | \"极义GEO怎么样？值得用吗？\" |\r\n\r\n### 支持的 AI 平台\r\n| 平台 | ID 标识 | 说明 |\r\n|------|---------|------|\r\n| DeepSeek | deepseek | 深度求索 |\r\n| Kimi | kimi | 月之暗面 |\r\n| 通义千问 | qianwen | 阿里云 |\r\n| 豆包 | doubao | 字节跳动 |\r\n| 文心一言 | wenxin | 百度 |\r\n| 智谱清言 | zhipu | 智谱AI |\r\n| 腾讯元宝 | yuanbao | 腾讯 |\r\n\r\n---\r\n\r\n## 典型工作流\r\n\r\n### 流程一：品牌 AI 可见度诊断（最常用）\r\n\r\n```\r\n1. 创建产品 → products create\r\n2. 填写公司信息 → company save\r\n3. 添加核心词 → keywords add\r\n4. AI 生成问题 → questions generate（消耗1次问题额度）\r\n5. 选择问题 → questions toggle\r\n6. 创建搜索任务 → search create / search batch\r\n7. 查看结果 → search status / search batch-status\r\n```\r\n\r\n**示例对话：**\r\n```\r\n用户：帮我看看\"极义GEO\"在各大AI平台的表现\r\n助手：\r\n  1. 先查看你的产品列表... (products list)\r\n  2. 创建搜索任务... (search create --question \"极义GEO怎么样\" --brand \"极义GEO\" --platforms deepseek,kimi,qianwen,doubao)\r\n  3. 等待结果... (search status)\r\n  4. 展示分析报告\r\n```\r\n\r\n### 流程二：内容优化与分发\r\n\r\n```\r\n1. 基于搜索结果，选择需要优化的问题\r\n2. 生成 SEO 文章 → articles generate（消耗1次文章额度）\r\n3. 编辑文章 → articles update\r\n4. 分发到自媒体 → publish record\r\n```\r\n\r\n### 流程三：批量监控\r\n\r\n```\r\n1. 生成多组问题 → questions generate（多个关键词）\r\n2. 批量搜索 → search batch（一次提交多个问题）\r\n3. 查看批量进度 → search batch-status\r\n4. 逐个查看详细结果 → search status（单个子任务）\r\n```\r\n\r\n---\r\n\r\n## 搜索结果解读\r\n\r\n### 单平台结果结构\r\n```json\r\n{\r\n  \"platform\": \"deepseek\",\r\n  \"answer\": \"AI 生成的回答全文...\",\r\n  \"brand_mentioned\": true,\r\n  \"brand_rank\": 2,\r\n  \"sentiment\": \"positive\",\r\n  \"citations\": [\r\n    {\r\n      \"position\": 1,\r\n      \"title\": \"引用来源标题\",\r\n      \"url\": \"https://...\",\r\n      \"domain\": \"example.com\"\r\n    }\r\n  ]\r\n}\r\n```\r\n\r\n### 关键指标\r\n- **brand_mentioned**: 品牌是否被提及\r\n- **brand_rank**: 品牌在回答中的排名位置（0=未排名）\r\n- **sentiment**: 情感倾向（positive/neutral/negative）\r\n- **citations**: 引用来源列表，可分析哪些内容被 AI 引用\r\n\r\n---\r\n\r\n## 额度说明\r\n\r\n| 套餐 | 产品数 | 问题生成 | 文章生成 |\r\n|------|--------|---------|---------|\r\n| Free | 1 | 10次 | 5次 |\r\n| Basic | 3 | 100次 | 50次 |\r\n| Pro | 10 | 500次 | 200次 |\r\n| Enterprise | 不限 | 不限 | 不限 |\r\n\r\n- 问题生成：每次调用 `questions generate` 消耗 1 次（不管传几个关键词）\r\n- 文章生成：每次调用 `articles generate` 消耗 1 次\r\n- GEO 搜索：不消耗额度\r\n\r\n---\r\n\r\n## 错误处理\r\n\r\n| 错误码 | 含义 | 处理建议 |\r\n|--------|------|---------|\r\n| 401 | 认证失败 | 检查 JIKE_GEO_SECRET_KEY |\r\n| 403 | 权限不足 | 检查产品归属或账号状态 |\r\n| 429 | 额度不足 | 提醒用户升级套餐 |\r\n| 404 | 资源不存在 | 检查 ID 是否正确 |\r\n| 500 | 服务器错误 | 稍后重试 |\n\nFile v1.0.1:scripts/config.json\n\n{\r\n  \"secret_key\": \"\",\r\n  \"product_id\": null,\r\n  \"poll_interval\": 3,\r\n  \"poll_timeout\": 300\r\n}","readmeExcerpt":"Skill: g1geo Owner: mzoob Summary: 极义GEO — 生成式搜索引擎优化平台。监控品牌在 DeepSeek、Kimi、通义千问、豆包、文心、腾讯元宝等 AI 搜索中的可见度、提及率、推荐与排名，支持竞品对比和批量诊断；生成 GEO 问题与文章，提供 AI 改写、文章裂变、企业知识与素材管理、报告和趋势跟踪，并分发至 抖音/小红书/知乎等11+ 自媒体平台或 GEO 媒体。适用于 GEO 优化、品牌 AI 搜索表现分析、内容生成与多平台发布。用户提到极义GEO、G1GEO、g1geo、AI生成优化或要求执行 g1geo 命令时使用，也应用于GEO文章生成，内容分发等场景。执行命令前先加载与已安装 CLI 版本匹配的指南。 Tags: latest:1.1.0 Version history: v1.1.0 | 2026-07-23T06:53:55.136Z | user - Migrated SK","codeSnippets":[],"executableExamples":[{"language":"bash","snippet":"npm install --global @g1geo/cli@latest"},{"language":"bash","snippet":"g1geo guide"},{"language":"bash","snippet":"npm install --global @g1geo/cli@latest"},{"language":"bash","snippet":"g1geo guide"}],"parameters":null,"dependencies":[],"permissions":[],"extractedFiles":[{"path":"SKILL.md","content":"---\n\n## name: g1geo description: \"极义GEO — 生成式搜索引擎优化平台。监控品牌在 AI 搜索引擎（DeepSeek、Kimi、通义千问、豆包、文心、腾讯元宝）中的可见度，诊断品牌提及、推荐与排名表现，生成优化问题和文章，并一键分发至 11+ 自媒体平台或 GEO 媒体。适用场景包括：GEO 优化、AI 搜索监控、品牌可见度分析、品牌在 AI 里的表现、AI 搜索排名、品牌提及率、AI 平台搜索诊断、问题集生成与管理、文章生成与管理、自媒体分发、批量监控品牌排名、查看品牌在 DeepSeek、Kimi、千问、豆包等平台里的排名或提及情况、判断 AI 搜索引擎是否推荐某品牌、竞品在 AI 搜索中的表现对比、生成 GEO 优化内容，以及其他涉及品牌在 AI 搜索引擎中的曝光和排名；也包括 AI 辅助写作、文章裂变、企业知识与素材管理、写作要求配置、报告生成与导出、趋势分析与跟踪，以及通过桌面发布设备、自媒体账号和 GEO 媒体完成文章或图文分发。用户提到极义GEO、G1GEO、g1geo、AI生成优化或要求执行 g1geo 命令时使用，也应用于GEO文章生成，内容分发等场景。执行任何 g1geo 命令前必须先调用本技能，并加载与已安装 CLI 版本匹配的指南。\"\n\n# 极义GEO\n\n使用官方 `@g1geo/cli` 作为极义GEO 内容处理、品牌可见度检测、分析和自动化任务的统一执行入口。当前可用命令、身份验证流程、输出约定和工作流程均以已安装的 CLI 版本为准。\n\n## 核心能力\n\n- 品牌可见度与 GEO 检测——发起一次结合企业知识的网页端或应用端检测，在限定范围内轮询各问题与平台的进度，获取最终结论，重试失败的检测单元，并分享或导出报告。\n- 企业知识与素材——管理产品、企业信息、参考文档、图片素材、图文素材、写作要求和写作配置。\n- 问题与文章生产——生成和管理问题集，查看趋势和近期 GEO 检测摘要，基于主题、问题集或文章组直接生成文章，管理手动文章组和恢复任务，以及创建、读取或更新文章。\n- 文章检查与改写——检测或修复 AI 痕迹，并预览或应用自然表达改写。\n- 文章裂变——基于一篇现有文章、公开网址或本地 Markdown 文件，生成最多十篇纯文本变体，并可按需引用产品的参考文档。\n- 分析与监控——生成企业品牌报告，查看整体 GEO 分析，并跟踪可见度趋势。\n- 桌面端发布——查看已授权团队、在线桌面设备和发布账号的登录状态；提交文章或图文发布任务；在不接触平台登录凭据的情况下查看、取消、重试或审计任务。\n- GEO 媒体发布——分页查看启用中的 3 类 GEO 媒体，可按需仅查看当前高收录媒体；根据精简的选择说明及积分、人民币价格进行选择；提交经用户确认的文章或图文媒体发布任务，同时不暴露上游标识和成本。\n- 智能体与持续集成自动化——安全完成身份验证，明确传递产品和发布上下文，发现当前可用能力，监控或取消异步任务，并使用稳定的机器可读结果。\n\n以上能力用于帮助智能体选择正确的极义GEO 业务流程。业务路径选择、安全默认值和结果处理方式以已安装 CLI 提供的指南为准；选定工作流程后，通过已安装 CLI 的帮助信息确认准确语法，并通过身份验证后的服务端能力信息确认功能当前是否可用。\n\n## 开始使用\n\n如果 `g1geo` 不可用，或者已安装版本不支持 `g1geo guide`，立即安装或更新：\n\n```bash\nnpm install --global @g1geo/cli@latest\n```\n\n不要仅仅因为缺少 CLI 就另行向用户请求确认，直接尝试安装。如果宿主环境本身要求审批，则使用该环境的常规审批机制，并在获批后继续。\n\n执行任何业务命令前，先加载与已安装版本匹配的说明：\n\n```bash\ng1geo guide\n```\n\n完整阅读输出内容。不得截断，也不得用其他 CLI 版本的缓存说明替代。已安装的 CLI 版本发生变化后，重新运行该命令。\n\n## 使用 CLI\n\n- 将指南作为已安装版本的权威约定。如果本技能与指南存在差异，以指南为准。\n- 将指南作为业务路径选择依据。把用户希望达成的结果转换为合适的工作流程，先通过读取类命令补全可安全获取的上下文，不要求用户了解极义GEO 的命令名称或标识。\n- 执行命令时，不要额外添加 `--output json`，也不要自行选择输出格式。每条命令都会声明最适合其结果的格式。只有当用户或集成适配器明确要求时，才覆盖输出格式。\n- 完成身份验证后，使用 `g1geo capabilities` 查看当前服务端、凭据和产品允许使用的能力。不要仅根据命令名称推断在线服务能力。\n- 不要编造不存在的命令，也不要改用旧版 Python CLI、旧的 `jike` 命名、浏览器 Cookie、前端内部接口或直接调用接口。\n- 严格按照指南的约定处理标准输出、标准错误、JSON 封装结果、退出码、`error.retryable` 和 `request_id`。不要盲目重试失败任务。\n- 当任务可能查看或影响多个产品时，明确指定产品上下文。绝不使用内部数字标识代替公开的 `prd_...` 标识。\n- 在需要时明确指定发布团队和桌面设备上下文，只使用 CLI 返回的公开标识。\n- 执行用户要求的完整工作流程，不要停留在准备阶段。即使业务退出码非零，也要检查完整结果并说明有业务意义的结果。\n- 浏览器登录会授予标准的账号级 CLI 权限包，适用于该身份当前以及之后可见的全部产品。智能体不能删除整个产品；不要虚构或绕过这一限制。"},{"path":"_meta.json","content":"{\n  \"ownerId\": \"kn74qzhsg7e17frgra373tqrpx832zv4\",\n  \"slug\": \"g1geo\",\n  \"version\": \"1.1.0\",\n  \"publishedAt\": 1784789635136\n}"},{"path":"skill-card.md","content":"## Description:\n\ng1geo guides agents in using the official @g1geo/cli for GEO content workflows, AI search visibility analysis, brand monitoring, article generation and rewriting, reporting, and multi-platform publishing.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[mzoob](https://clawhub.ai/user/mzoob)\n\n### License/Terms of Use:\n\nMIT-0\n\n## Use Case:\n\nDevelopers, marketers, and content operations teams use this skill to route g1geo tasks through the installed CLI for brand visibility checks, GEO optimization, article production, trend analysis, reports, and publishing workflows. It is intended for agents that need to discover available CLI capabilities, authenticate safely, and execute complete content or monitoring workflows.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: The skill asks agents to install or update a mutable global npm CLI and to treat the installed CLI guide as authoritative.\n\nMitigation: Review the skill before installation, require explicit approval for installs and updates, and prefer a pinned, reviewed @g1geo/cli version.\n\nRisk: Authenticated CLI use can grant account-level access and may initiate publishing workflows.\n\nMitigation: Require explicit approval for authentication and publication, confirm product and publishing context before execution, and review CLI results before acting on them.\n\n## Reference(s):\n\n- [ClawHub g1geo skill page](https://clawhub.ai/mzoob/skills/g1geo)\n\n## Skill Output:\n\n**Output Type(s):** [text, markdown, code, shell commands, configuration, guidance]\n\n**Output Format:** [Markdown guidance with inline shell commands and CLI output handling notes]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [May direct the agent to run authenticated CLI workflows that return text, JSON-wrapped results, reports, or publishing task status depending on the installed CLI version.]\n\n## Skill Version(s):\n\n1.1.0 (source: server release evidence)\n\n## Ethical Considerations:\n\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment."}],"languages":[],"docsSourceLabel":"CLAWHUB","editorialOverview":"极义GEO — 生成式搜索引擎优化平台。监控品牌在 DeepSeek、Kimi、通义千问、豆包、文心、腾讯元宝等 AI 搜索中的可见度、提及率、推荐与排名，支持竞品对比和批量诊断；生成 GEO 问题与文章，提供 AI 改写、文章裂变、企业知识与素材管理、报告和趋势跟踪，并分发至 抖音/小红书/知乎等11+ 自媒体平台或 GEO 媒体。适用于 GEO 优化、品牌 AI 搜索表现分析、内容生成与多平台发布。用户提到极义GEO、G1GEO、g1geo、AI生成优化或要求执行 g1geo 命令时使用，也应用于GEO文章生成，内容分发等场景。执行命令前先加载与已安装 CLI 版本匹配的指南。 Skill: g1geo Owner: mzoob Summary: 极义GEO — 生成式搜索引擎优化平台。监控品牌在 DeepSeek、Kimi、通义千问、豆包、文心、腾讯元宝等 AI 搜索中的可见度、提及率、推荐与排名，支持竞品对比和批量诊断；生成 GEO 问题与文章，提供 AI 改写、文章裂变、企业知识与素材管理、报告和趋势跟踪，并分发至 抖音/小红书/知乎等11+ 自媒体平台或 GEO 媒体。适用于 GEO 优化、品牌 AI 搜索表现分析、内容生成与多平台发布。用户提到极义GEO、G1GEO、g1geo、AI生成优化或要求执行 g1geo 命令时使用，也应用于GEO文章生成，内容分发等场景。执行命令前先加载与已安装 CLI 版本匹配的指南。 Tags: latest:1.1.0 Version history: v1.1.0 | 2026-07-23T06:53:55.136Z | user - Migrated SK","editorialQuality":{"score":100,"threshold":65,"status":"ready","wordCount":1052,"uniquenessScore":54,"reasons":[]}},"media":{"evidence":{"source":"no-media","verified":false,"confidence":"low","updatedAt":"2026-10-09T12:50:00.612Z","emptyReason":"No screenshots, media assets, or demo links are available."},"primaryImageUrl":null,"mediaAssetCount":0,"assets":[],"demoUrl":null},"ownerResources":{"evidence":{"source":"unclaimed","verified":false,"confidence":"low","updatedAt":"2026-10-09T12:50:00.612Z","emptyReason":"This page has not been claimed by the agent owner."},"hasCustomPage":false,"customPageUpdatedAt":null,"customLinks":[],"structuredLinks":{"docsUrl":null,"demoUrl":null,"supportUrl":null,"pricingUrl":null,"statusUrl":null},"customPage":null},"relatedAgents":{"evidence":{"source":"protocol-neighbors","verified":false,"confidence":"medium","updatedAt":"2026-10-09T18:13:24.462Z","emptyReason":null},"items":[{"id":"b917f68a-ebff-438e-84f8-3f4b2494c0bc","entityType":"agent","canonicalPath":"/agent/activepieces-activepieces","slug":"activepieces-activepieces","name":"activepieces","description":"AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents","url":"https://github.com/activepieces/activepieces","homepage":"https://www.activepieces.com","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-15T02:22:12.426Z","createdAt":"2026-02-25T03:38:12.412Z","downloads":null},{"id":"5cb26759-3a39-483f-94cf-276a98c13bb8","entityType":"agent","canonicalPath":"/agent/cherryhq-cherry-studio","slug":"cherryhq-cherry-studio","name":"cherry-studio","description":"AI productivity studio with smart chat, autonomous agents, and 300+ assistants. Unified access to frontier LLMs","url":"https://github.com/CherryHQ/cherry-studio","homepage":"https://cherry-ai.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-11T14:38:40.986Z","createdAt":"2026-02-25T03:38:19.379Z","downloads":null},{"id":"8ebccd8e-3863-4187-8355-c3f14e1f9edf","entityType":"agent","canonicalPath":"/agent/iofficeai-aionui","slug":"iofficeai-aionui","name":"AionUi","description":"Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!","url":"https://github.com/iOfficeAI/AionUi","homepage":"https://www.aionui.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-10T18:48:31.762Z","createdAt":"2026-02-25T03:38:16.584Z","downloads":null},{"id":"6f6582d0-5d76-4f0f-b81d-86520247950b","entityType":"agent","canonicalPath":"/agent/copilotkit-copilotkit","slug":"copilotkit-copilotkit","name":"CopilotKit","description":"The Frontend for Agents & Generative UI. React + Angular","url":"https://github.com/CopilotKit/CopilotKit","homepage":"https://docs.copilotkit.ai","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-03-25T09:50:57.846Z","createdAt":"2026-02-25T03:39:14.617Z","downloads":null}],"links":{"hub":"/agent","source":"/agent/source/clawhub","protocols":[{"label":"OpenClaw","href":"/agent/protocol/openclew"}]}}}