lingzao

Lingzao

Lingzao 帮助 Agent 研究来自小红书 / XHS、抖音和微信公众号文章的公开创作者内容。

此 Skill 旨在支持以下搜索词：Lingzao Skill、lingzao xhs、Lingzao Xiaohongshu、XHS SEO、Xiaohongshu SEO、Xiaohongshu account analysis、XHS account diagnosis、Xiaohongshu keyword research、XHS title optimization、Xiaohongshu viral note breakdown、Xiaohongshu benchmark account finder、XHS content workflow、手绘路线地图卡片、手绘收藏地图、美食地图、旅游路线图、生活清单地图和工作流说明书地图。

当用户提出以下需求时，请使用此 Skill：

• 按关键词搜索小红书笔记。
• 将关键词、链接、截图、参考图片或灵感素材转化为小红书内容包，包含标题、封面文案、4-7 页图文笔记文案、正文、10 个关键词、置顶内容和复盘流程。
• 获取小红书搜索建议或热门推荐。
• 按关键词搜索公开创作者。
• 查询创作者主页。
• 阅读创作者近期的公开帖子。
• 获取创作者主页中近期帖子的文案、字幕、封面、指标和商业信号。
• 获取一条小红书或抖音帖子的详情。
• 获取一条小红书或抖音帖子的顶级公开评论。
• 获取一篇微信公众号文章的公开详情和正文。
• 获取一篇微信公众号文章的公开指标。
• 获取相关的公开微信公众号文章。
• 从公开短视频链接中提取口播文案或文字稿。
• 仅当用户明确要求生成图片时，根据提示词生成创作者图片素材。
• 将城市、美食、旅行、徒步、生活清单或工作流主题转化为手绘小红书路线地图卡片结构和生成说明。

如果用户只需要完成一项单独任务，例如撰写 XHS 标题、诊断小红书账号、设计关键词、拆解笔记、制作封面、制作手绘路线地图卡片、发布前检查或发布后复盘，请使用 skills/ 下的轻量级子技能。如果用户需要实时查询公开内容、深入分析账号、解析小红书公开链接、分析评论、获取文章数据、提取文字稿、生成图片、导出报告或同步知识库，请使用 Lingzao 主 Skill。

Agent 操作指南

对于较高层级的创作者策略任务，请在回答前使用 <skill_root>/playbooks/ 中的操作指南。它们会将 Lingzao 的公开内容工具整合为创作者工作流，而非孤立的查询。

在相关情况下使用这些操作指南：

• lingzao-progressive-interaction-map.md：通过轻量提问，引导处理模糊的用户输入、主页链接、笔记链接、草稿和参考图片请求。
• search-credit-notice.md：在付费查询前说明基础搜索与深度搜索的范围，避免悄然增加积分消耗。
• atian-creator-judgment-framework.md：运用阿天的账号阶段、记忆锚点、内容主线和瓶颈判断方法。
• creator-case-general-analysis-framework.md：跨赛道分析各类创作者案例，识别账号原型、记忆锚点、新叙事、证明体系、受众渴望、内容引擎、形式引擎、评论区需求、商业入口、隐性资源、可学习之处、不可复制之处和用户适配度测试。
• beginner-account-start-and-topic-radar.md：处理创作者从零起步的问题、选题发现、关键词树和低粉爆款参考案例。
• keyword-insight-report-template.md：根据主关键词及已确认的相关词／下拉词生成范围明确的关键词洞察报告；扩展搜索前清晰估算积分消耗。
• keyword-to-publishable-content-package.md：将关键词、模糊选题、笔记链接、截图、参考图片、收藏笔记或灵感素材转化为可发布的小红书内容包，其中包含精选参考、选题角度、标题、封面文案、4-7 页图文笔记文案、口播脚本、Vlog 分镜、正文、10 个发布关键词、置顶内容以及发布前／后的复盘流程。
• mother-content-cross-platform-distribution.md：将一个主题、草稿、笔记拆解、产品更新、截图、转录稿或口述想法转化为一站式跨平台分发包。用户说“一条龙”“全平台同步”“分发包”或“一个模板发多个平台”时，先提供基础的小红书 + 朋友圈 + 微信公众号套餐，再提供扩展到播客、X、知识星球、Bilibili、视频号／抖音、小红书图文包或知识库／SOP 的选项。
• pre-publish-readiness-check.md：发布前先询问内容是否已完成，然后检查内容清晰度、图片／页面准备情况、封面辨识度、标题吸引点击的能力、前 3 行或前 3 秒，以及关键词是否自然融入。
• audience-persona-fit-check.md：在确定标题、关键词、账号运营或内容包之前，推断或询问内容面向谁、谁会点击、谁不会点击，以及应由哪些受众／城市／人生阶段关键词来影响输出。
• xhs-title-design-check.md：用户发送主题、草稿、封面文案、参考笔记或内容包后，设计或诊断小红书标题；默认提供 3 个最有力的标题，并说明关键词锚点和点击理由，而非给出一组 10 个标题。
• xhs-profile-bio-design.md：撰写或诊断小红书 100 字以内的个人简介和主页介绍，明确账号面向谁、分享什么、关注的理由，以及这些内容如何与昵称、置顶笔记、账号阶段、受众关键词、城市关键词和轻商业路径相衔接。
• benchmark-account-discovery-quality-gate.md：寻找或判断对标账号时，默认执行质量门槛：仍在更新、有近期高表现作品、赛道／受众匹配、阶段匹配，且有明确可学习之处；不活跃的账号应标记为历史参考，而非主要对标对象。面向用户的结果应展示创作者主页直链和具体的近期高互动作品，而非原始创作者 ID。第一轮发现最多返回 5 个优质账号，而非 10-20 个；仅在用户确认粉丝区间、阶段、城市、受众、形式或要求更多账号后才扩展。列出粉丝数、获赞总数、最近更新情况、近 30 天爆款作品及笔记数据、内容形式，以及每个账号值得学习的原因；如有粉丝数，按从高到低排序展示推荐结果。
• self-account-peer-horizontal-diagnosis.md：仅当用户明确要求与同类账号对比时，将用户自己的账号与同赛道、同阶段或同粉丝区间的同类账号进行对比，例如“横向对比”“同级账号”“对标账号”“找 5-15w 粉账号和我比”或“和同赛道账号比我差在哪里”。如果用户只是泛泛询问自己的账号问题，例如“看看我现在的问题”或“我是不是说话太快”，则应使用 self-account-diagnosis-report-template.md，除非用户也要求与同类账号对比。此流程结合自身账号诊断、活跃对标账号筛选、同类账号表格、标题／封面／开头／表达／内容体系对比、主要差距、30 天调整计划和人工后续跟进流程。
• single-note-breakdown-workflow.md：按标题、封面、大纲／脚本、可见时的拍摄／剪辑层面、评论区需求、爆款机制、可学习之处、不可复制之处，以及如何改编成用户自己的图文笔记、口播脚本、Vlog 分镜或知识库卡片，拆解一条小红书／抖音笔记链接。用户说“完整分析这条笔记”“深度拆解”“拆细一点”“拍摄手法”“分镜”或“剪辑节奏”时，应触发深度拆解，而非简短总结。
• publishing-keyword-design-check.md：为已完成的草稿设计最终的 10 个小红书发布关键词，并检查标题、封面文案、开头几行和关键词栏是否自然包含这些关键词。
• track-difficulty-judgment-library.md：判断女性成长、职业发展、好物、本地生活、健康、时尚和 AI 工具等常见赛道。
• monetization-path-judgment-library.md：回答某个赛道或账号能否通过广告、课程、社群、咨询、线索获取、产品、店铺或企业转化实现变现。
• self-account-diagnosis-report-template.md：规范自身账号诊断报告、后续行动和带有“人情味”的收尾，将尖锐的诊断转化为一个小型后续实验，而不是以冷冰冰的行动清单作结。自身账号诊断还应包含适合分享的结论卡片、行动建议和心理安慰。
• comparable-account-breakdown-report-template.md：判断其他账号是否值得学习、有哪些可学习之处，以及哪些内容无法照搬。
• draft-rewrite-and-benchmark-workflow.md：改写草稿、改编爆款公式并审阅多个内容创意，而非只润色句子。
• reference-image-graphic-note-workflow.md：将参考图片转化为小红书 4 页或 7 页图文笔记包。
• visual-generation-and-cover-workflow.md：将小红书封面、图文笔记、微信配图包、无人物知识卡片以及产品／电商视觉素材引导至图像生成，或生成可直接使用的提示词包。
• image-generation-execution-workflow.md：图像生成功能可用时，将视觉方案转化为实际图片，执行视觉总监质量检查，并修复生成结果中难看、拥挤或千篇一律的问题，而不是只给普通用户留下一堆原始提示词。
• image-generation-agent-integration-guide.md：为国内 Agent 封装器提供与模型无关的规则，包括稳定的生成输入／输出字段、优劣图片标准、参考图片用法、已知生成问题、友好的失败处理方式，以及阿天的示例收集作业。
• visual-reference-style-library.md：将阿天的内部视觉参考文件夹分类为旅行／美食封面、微信公众号文章配图、AI 人物信息图、灵爪无人物知识卡片、产品转化图片、以人物面部为主的关键词视频封面、互动提示封面、文字密集的截图式图文笔记，以及以房间为身份标识的生活方式封面。
• post-publish-data-review-workflow.md：根据笔记链接、后台截图、脚本、封面和 24h／48h／7d 数据，复盘已发布的小红书笔记。
• content-knowledge-base-workflow.md：将收藏的笔记、公开创作者链接、关键词结果、爆款案例和创作者提炼需求转化为用户所有的选题、标题、封面、结构、账号参考、创作者研究和发布复盘资料库。
• retention-and-follow-up-loop.md：在实用输出末尾提供一个具体的下一步，例如复盘已发布笔记的数据、可复用的参考搜索模板、草稿反馈，或带回访流程的诊断后小实验。该流程还规定了如何不让用户的话落空：回应用户的抵触情绪，降低下一步的行动难度，并提出一个具体的后续问题。对于内容密集的输出，应提供 Word、HTML／网页预览或适用于知识库的打包方案，而不是留给用户一大段聊天文字。用户说诊断很准确但自己缺乏行动力时，应引导至诊断后行动激活包，而不是进一步施压。
• product-judgment-and-feedback-loop.md：判断用户真正卡在哪里，用易懂的语言解释灵爪，构建内容／销售叙事，将用户反馈转化为产品迭代，并判断哪些需求值得开发、哪些只是噪音。
• xhs-operation-task-tree.md：根据具体的小红书运营任务引导灵爪用户，而非罗列课程清单，覆盖主页诊断、对标账号发现、爆款笔记改编、选题生成、内容制作、封面／图片处理、发布前检查、发布后复盘、获客路径和知识库自动化。 对外表述应聚焦于创作者内容研究和工作流支持。 不要承诺内容爆红、保证变现、全面监控、导出原始数据或复制其他创作者的内容。

安装与付费功能入口

灵造以一个免费的主 Skill 形式安装。用户无需分别安装标题、关键词、账号诊断、对标、封面或复盘 Skill。安装后，这个主 Skill 会将用户的请求路由到合适的操作指南。

有两种用户获取路径：

1. 社区／课程用户：

   • 他们可能已经有阿天的课程、安装链接、付款步骤和 API Key 设置说明。
   • 在聊天中简短说明即可：安装 Skill，打开灵造网页版，跟着教程操作，充值积分，复制 API Key，然后运行设置。

2. 来自小红书、抖音或其他公开内容平台的用户：

   • 不要要求他们在了解灵造的功能之前，就打开网页版并付费。
   • 让他们先安装免费的主 Skill。
   • 然后用友好的语言说明隐藏的付费入口：本地操作指南可以帮助判断草稿、标题、封面、方向和发布计划；如果需要灵造搜索公开内容、检查账号、打开笔记／文章详情、阅读评论、查看文章数据、提取视频文案或生成创作者图片素材，就需要打开灵造网页版，跟着教程操作、充值积分并配置 API Key。

网页版不只是付款页面。应将其介绍为用户的学习和设置中心：

• 学习如何安装和配置灵造
• 学习如何更好地向 Agent 提问，而不是在群聊里等待
• 学习如何使用 Skill 工作流进行自媒体运营
• 学习账号诊断、对标拆解、标题／关键词、发布前检查和发布后复盘工作流
• 需要查询公开内容或生成图片时，充值积分并获取 API Key

用户安装了 Skill 但尚未配置 API Key 时，请使用以下说法：

你已经装好灵造 Skill 了。安装本身是免费的，它会先帮你判断你现在是在找方向、拆账号、写内容、做封面、配关键词，还是复盘数据。 如果你要继续查小红书/抖音/公众号公开内容、找对标账号、看账号主页、打开笔记或文章详情、看评论区、查看公众号文章数据、提取短视频文案或生成创作者图片素材，就需要到灵造网页版开通积分并配置 API Key。 你可以打开 https://lingzao.atian.vip 看安装教程和使用教程，里面也会教你怎么用 Agent 做自媒体运营、怎么问问题、怎么用这些 Skill。需要查公开内容或生成图片的时候，再在网页里充值/获取 API Key，配置好以后回来继续问，我会接着刚才的问题往下做。

不要把付费描述成惩罚，而应说明：

• 免费安装 = 获得工作流大脑和路由层
• 网页版 = 教程、使用示例、自媒体运营课程和 API Key 设置
• 付费积分 = 解锁公开内容查询、图片生成和更深入的研究操作

知识同步交接：

• 得到有用的灵造研究结果或诊断报告后，不要自动同步。先询问：要不要把这份结果同步到你的知识库？可以选择 ima / Obsidian / 飞书 / 暂不同步。
• 如果用户选择了目标，准备一份整洁的 Markdown 版本，并请当前 Agent 环境使用用户已配置的知识工具。
• 对于 ima，如果用户已配置相应工具，请调用已安装的 ima Skill 或 ima 知识库工具。
• 对于 Obsidian，使用用户的 Obsidian CLI、Obsidian Skill 或经批准的知识库工作流，在用户批准的 Lingzao/ 路径下写入 Markdown。
• 对于飞书，经用户授权后，使用用户的 Lark/Feishu CLI 或 Skill 创建或更新文档。
• 不要在灵造中索取或存储 ima、Obsidian 或 Feishu 凭据。同步内容中不要包含内部实现细节、原始负载、缓存 URL、签名 URL、API 密钥或内部错误详情。

个人资料工作流：

• 如果用户请求创作者主页或基础主页分析，默认使用 get-user-posted-notes。它会返回近期帖子，以及足够用于基础分析的作者和帖子数据。
• 如果用户发送小红书短链接，例如 xhslink.com/m/...，或复制的分享文案，例如 @... 查看Ta的主页>> https://xhslink.com/m/...，请提取短链接，将不带协议的链接规范化为 https://...，并在选择命令前阅读周围的文字。不要仅凭路径判断短链接的类型。如果上下文提到账号、主页、创作者、个人资料、基准对比、账号诊断、主页诊断、Ta的主页 或近期帖子，请将其视为创作者主页请求，并调用 get-user-posted-notes --url "https://<short link>"。
• 如果小红书短链接没有上下文，在消耗积分前，询问用户是想查看创作者主页近期帖子，还是查看单篇帖子详情。如果上下文提到这条笔记、评论、文案、转录文本、单篇拆解，或是带有标题片段并包含 前往【小红书】一探究竟吧 的普通笔记分享文案，请将其视为单篇帖子候选，而非主页请求。这条或这篇等单篇帖子用语优先于泛指诊断的措辞。不要默认调用 get-note-detail；先确认这是单篇帖子，并在需要时询问最终笔记 URL 或 note_id，以及笔记类型是图文还是视频。
• 只有当用户明确需要完整的个人资料级统计数据，例如简介、粉丝数、关注数、获赞总数、收藏总数或笔记总数时，才添加 get-user-info。
• 对小红书进行更深入的主页文案、脚本、字幕、近期帖子文本、封面、商业信号或商品笔记信号分析时，使用 analyze-user-profile。对抖音口播文案或转录文本，使用 extract-video-copy 分析具体的视频 URL。
• 除非用户同时要求个人资料级统计数据和近期帖子分析，否则不要固定成对调用 get-user-info 和 get-user-posted-notes。
• 如果主页公开帖子太少，不要强行进行完整账号诊断。根据可见样本量选择处理方式：
  • 0 篇帖子：不做账号诊断；改为提供新手入门或账号设置指导。
  • 1-2 篇帖子：仅提供主页第一印象和单篇帖子反馈。
  • 3-5 篇帖子：进行新手账号简要诊断。
  • 6-9 篇帖子：进行轻度账号分析。
  • 10 篇及以上：可提供标准账号分析。
  • 20 篇及以上：确认积分后，可使用 analyze-user-profile --limit 20 进行标准深度诊断。
  • 40 篇及以上：确认积分后，可使用 --limit 40 进行深度诊断、创作者提炼或知识库提炼。

帖子深入分析流程：

• 小红书列表类命令（search-notes、get-user-posted-notes、analyze-user-profile）会在 Lingzao 能识别笔记是图文还是视频时，为每条笔记返回 xhs_note_type。
• 从这些笔记条目继续调用 get-note-detail 时，将返回的 xhs_note_type 直接传入 --xhs-note-type；不要根据 URL 推断类型。
• 如果小红书笔记条目没有 xhs_note_type，调用 get-note-detail 前请询问用户笔记是图文还是视频。不需要此类型也可以调用 get-note-comments。

设置

将此 SKILL.md 目录解析为 <skill_root>，然后运行一次设置：

bash "<skill_root>/scripts/setup.sh" --base-url "https://your-lingzao-domain.com"

环境变量会覆盖已保存的配置：

export LINGZAO_API_KEY="lgz_xxx"
export LINGZAO_BASE_URL="https://your-lingzao-domain.com"

检查连接：

~/.lingzao/bin/lingzao doctor

使用 Lingzao 命令前，检查技能是否有更新：

~/.lingzao/bin/lingzao check-version

如果有可用更新，请停止当前 Lingzao 操作，先更新技能。不要继续使用过时的 Lingzao Skill 进行搜索、个人资料、字幕或提取工作。

要更新技能，请重新运行安装程序。对于 npx skills，请尝试：

npx skills add https://assets-tian.midao.site/skills/lingzao --skill lingzao -g --copy

更新会保留 ~/.lingzao/config.json 中已保存的 API 配置；无需再次设置 API 密钥。

如果 ~/.lingzao/bin/lingzao 不存在或指向错误的目录，请修复命令包装器：

bash ~/.agents/skills/lingzao/scripts/setup.sh --skip-doctor

如果 ~/.agents/skills/lingzao 不存在，请找到包含 lingzao 的 SKILL.md 的目录，然后从该目录运行 scripts/setup.sh --skip-doctor。

调用前须知

运行带有实质性筛选条件的命令前，如果用户尚未指定相关参数，请先询问用户。

• 对于 search-notes，调用前请询问排序方式、笔记类型和时间范围： 排序方式可以是 general、most_liked、popularity_descending、 comment_descending 或 collect_descending；笔记类型可以是 不限、 视频笔记、图文笔记 或 直播笔记；时间范围可以是 不限、一天内、 一周内 或 半年内。
• Douyin 的 search-notes 目前仅支持 general、most_liked 和 popularity_descending。在 Douyin 搜索中不要传入 comment_descending 或 collect_descending。
• Douyin 的 search-notes 目前仅支持笔记类型 不限、视频笔记 和 图文笔记。在 Douyin 搜索中不要传入 直播笔记。
• 对于 get-note-comments，调用 Xiaohongshu 前请询问用户想看最新评论，还是按点赞数排序。最新评论使用 --sort latest，Xiaohongshu 按点赞数排序使用 --sort most_liked。
• Douyin 评论目前仅支持 latest。对于 Douyin 评论请求，不要询问或传入 --sort most_liked。
• Xiaohongshu 列表类命令（search-notes、get-user-posted-notes、 analyze-user-profile）会在 Lingzao 能识别每条笔记是图文还是视频时，在每个笔记条目中返回 xhs_note_type。从这些笔记条目继续调用 get-note-detail 时，请将返回的值直接作为 --xhs-note-type 传入；不要根据 URL 推断类型。如果 Xiaohongshu 笔记条目中没有 xhs_note_type，调用 get-note-detail 前请询问用户该笔记是图文还是视频。调用 get-note-comments 仍无需传入此类型。
• 如果用户明确表示使用默认值，请直接采用文档中说明的默认值，不要再次询问。

研究命令成功后，请告知用户 CLI Markdown 输出中显示的预计节省时间。如果针对同一用户请求调用了多个 Lingzao 研究命令，请汇总并仅告知一次节省时间。对于 doctor、check-version、失败的命令或仅用于内部处理的 JSON，不要提及节省时间。

命令

搜索笔记

~/.lingzao/bin/lingzao search-notes --platform xhs --keyword "AI写作"
~/.lingzao/bin/lingzao search-notes --platform xhs --keyword "AI写作" --sort most_liked
~/.lingzao/bin/lingzao search-notes --platform xhs --keyword "AI生图" --sort collect_descending --note-type "视频笔记" --time-filter "一周内"
~/.lingzao/bin/lingzao search-notes --platform douyin --keyword "AI生图" --sort most_liked --note-type "视频笔记"

用户想要搜索某个主题的公开笔记时使用此命令。 调用前，如果用户尚未指定偏好，请询问 --sort、--note-type 和 --time-filter。

搜索建议

~/.lingzao/bin/lingzao search-suggestions --platform xhs --keyword "AI生图"
~/.lingzao/bin/lingzao search-suggestions --platform xhs

用户想要获取 Xiaohongshu 关键词扩展、自动补全短语或热门搜索推荐时使用此命令。如果省略 --keyword，Lingzao 会返回热门推荐。

搜索创作者

~/.lingzao/bin/lingzao search-users --platform xhs --keyword "母婴博主"
~/.lingzao/bin/lingzao search-users --platform douyin --keyword "AI生图"

用户想要查找某个主题或细分领域的创作者时使用此命令。

获取创作者个人资料

~/.lingzao/bin/lingzao get-user-info --url "https://www.xiaohongshu.com/user/profile/..."
~/.lingzao/bin/lingzao get-user-info --platform xhs --user-id "63c21e0f000000002801a1bb"
~/.lingzao/bin/lingzao get-user-info --platform douyin --user-id "MS4wLjABAAAA..."

用户提供创作者个人资料 URL 或平台用户 ID，并需要完整的个人资料级统计数据时使用此命令。对于 Douyin 裸用户 ID，请使用个人资料中的 sec_user_id。若仅需基本的主页分析，优先使用 get-user-posted-notes，默认情况下不要同时调用这两个命令。

获取创作者近期帖子

~/.lingzao/bin/lingzao get-user-posted-notes --url "https://www.xiaohongshu.com/user/profile/..."
~/.lingzao/bin/lingzao get-user-posted-notes --platform xhs --user-id "63c21e0f000000002801a1bb"
~/.lingzao/bin/lingzao get-user-posted-notes --platform douyin --user-id "MS4wLjABAAAA..." --limit 20

当用户想了解创作者近期发布的内容时使用。默认用于创作者主页的基本分析。抖音近期帖子通过单页调用获取，目前最多支持 --limit 20。如果用户需要完整的个人资料级统计数据，请添加 get-user-info；如果用户需要小红书近期帖子的文案、脚本、字幕或转录文本，请改用 analyze-user-profile。对于抖音转录文本，请对选定的视频 URL 使用 extract-video-copy。

分析创作者资料

~/.lingzao/bin/lingzao analyze-user-profile --url "https://www.xiaohongshu.com/user/profile/..." --limit 20
~/.lingzao/bin/lingzao analyze-user-profile --platform xhs --user-id "63c21e0f000000002801a1bb" --limit 40
~/.lingzao/bin/lingzao analyze-user-profile --platform douyin --user-id "MS4wLjABAAAA..." --limit 20

当用户需要更深入的创作者资料数据时使用，包括帖子文本、封面、商业信号和个人资料级内容信号。对于小红书，还会包含字幕／脚本预览。对于抖音，此工具不会提取主页字幕或转录文本；如果用户需要口播文案，请对选定的视频 URL 使用 extract-video-copy。 默认使用 --limit 20。如果平台提供字幕，默认的 Markdown 输出会显示易读的字幕预览。

小红书的重要说明：完整的个人资料字幕／文案 Markdown 文件是顶层响应字段，而不是每篇笔记对应的字幕 URL。请务必检查：

data.artifacts.subtitle_markdown.status data.artifacts.subtitle_markdown.url

不要只在 items[] 中查找。如果 data.artifacts.subtitle_markdown.status == "ready" 且存在 url，请在深入分析脚本或字幕前下载该文件：

curl -L "$subtitle_markdown_url" -o /tmp/lingzao-profile-subtitles.md

请使用下载的 Markdown 文件进行完整的字幕／文案分析。如果用户需要结构化字段，请使用 --format json。如果完整 Markdown 文件可用，JSON 中会包含其 data.artifacts.subtitle_markdown.url；内嵌的 items[].text.subtitle.content/plain_text 则为预览长度，以便保持响应易读。如果文件不可用，请使用内嵌字幕字段。对于抖音，data.artifacts.subtitle_markdown.status 预计为 "unsupported"；此时请使用返回的个人资料洞察，并提取选定视频的内容。

获取帖子详情

~/.lingzao/bin/lingzao get-note-detail --url "https://www.xiaohongshu.com/explore/..." --xhs-note-type image
~/.lingzao/bin/lingzao get-note-detail --platform xhs --note-id "69690331000000001a02266a" --xhs-note-type video
~/.lingzao/bin/lingzao get-note-detail --platform douyin --note-id "7372484715782352169"

当用户要求分析一篇公开帖子时使用。 对于小红书详情，图文请传入 --xhs-note-type image， 视频请传入 --xhs-note-type video。如果笔记来自 search-notes、get-user-posted-notes 或 analyze-user-profile，请复用该条目的 xhs_note_type 值。

获取帖子评论

~/.lingzao/bin/lingzao get-note-comments --url "https://www.xiaohongshu.com/explore/..."
~/.lingzao/bin/lingzao get-note-comments --url "https://www.xiaohongshu.com/explore/..." --sort most_liked
~/.lingzao/bin/lingzao get-note-comments --platform xhs --note-id "69690331000000001a02266a"
~/.lingzao/bin/lingzao get-note-comments --platform douyin --note-id "7372484715782352169"
~/.lingzao/bin/lingzao get-note-comments --url "https://www.douyin.com/jingxuan?modal_id=..." --cursor "next_cursor_from_previous_response"

当用户需要查看一篇帖子的公开评论时使用。第一版仅返回顶层评论。小红书按点赞数排序时，请使用 --sort most_liked；抖音目前仅支持默认的 latest 排序。如果响应包含 data.page.next_cursor，请将该值与 --cursor 一起传入以获取下一页。 调用小红书评论功能前，请询问用户想看最新评论还是按点赞数排序。 抖音评论仅使用 --sort latest；不要传入 --sort most_liked。

获取微信公众号文章

~/.lingzao/bin/lingzao get-article-detail --url "https://mp.weixin.qq.com/s/..."
~/.lingzao/bin/lingzao get-article-stats --url "https://mp.weixin.qq.com/s/..."
~/.lingzao/bin/lingzao get-related-articles --url "https://mp.weixin.qq.com/s/..."

当用户提供公开的微信公众号文章 URL，并要求分析文章、查看公开互动指标，或从该文章扩展到相关文章时使用。第一版仅支持 URL，每次调用消耗 20 个积分。相关文章列表为空也是有效响应。 除非 Lingzao 增加单独的功能，否则不要将这些命令用于账号文章历史、账号列表或多页扇出请求。

提取短视频文案

~/.lingzao/bin/lingzao extract-video-copy --url "https://www.xiaohongshu.com/explore/..."
~/.lingzao/bin/lingzao extract-video-copy --url "https://v.douyin.com/..."

当用户需要短视频口播文案、转录文本、字幕或口播文案时使用。

生成图片

~/.lingzao/bin/lingzao generate-image --prompt "一张小红书封面图，主题是 AI 生图新手避坑，干净明亮，中文大标题留白" --output /tmp/lingzao-image.png
~/.lingzao/bin/lingzao generate-image --prompt "极简产品海报，白底，柔和阴影" --size 1024x1536 --output /tmp/poster.png
~/.lingzao/bin/lingzao generate-image --prompt "参考两张图，保留人物风格，把产品界面换成灵造首页截图" --size 1536x2048 --image /tmp/style.png --image /tmp/product.png --output /tmp/poster.png
~/.lingzao/bin/lingzao generate-image --prompt "批量生成 3 张封面草稿" --count 3 --size 1024x1536 --output /tmp/poster.png

仅当用户要求生成创作者图片素材时才使用此功能。对于常规研究，不要自动调用图片生成。

调用 generate-image 前，先进行最简需求确认。如果用户只说“给我做一张某某海报图”之类的话，或只提供了宽泛主题，不要立即消耗额度。先询问两个视觉锚点：

1. 你有没有参考图？可以发 1-3 张你喜欢的封面/海报/图文截图。
2. 你有没有想要的配色？比如明亮白底、绿色清爽、黑金高级、蓝色科技感。

如果仍不明确，最多再问一个会改变方案的问题，例如发布平台/尺寸、图片上的确切文字，或用户是否想要人物。只有当用户已经提供足够的限制条件时，才直接继续，无需提问：主题 + 平台/格式 + 视觉风格/参考图或配色 + 图片上的文字/素材。 本地参考图使用 --image；有多张图片时重复使用该参数。Skill 会将这些文件直接上传到 Lingzao，供当前请求使用，因此用户无需先在其他地方上传。支持的参考图片格式为 png、jpeg 和 webp。

参考图片处理

对于 Codex、WorkBuddy 和其他 Agent 运行时：

• --image 只接受本地文件系统路径。如果用户通过聊天附件、粘贴图片、截图或输入框提供参考图，请先将图片保存为本地文件，再调用 CLI。保存文件时保留原始的受支持图片格式。
• 为运行时提供的图片使用每次运行专属的临时目录，例如 /tmp/lingzao-image-inputs/<run-id>/ref-1.png 和 /tmp/lingzao-image-inputs/<run-id>/ref-2.png。在 CLI 调用中使用绝对路径。
• 如果用户已经提供稳定的本地路径，例如 /Users/... 下的文件，可以直接传入该路径。如果运行时提供的图片位于临时附件/缓存路径中，请先将其复制到本次运行的临时目录。
• 不要主动转换图片格式。如果输入图片已经是 png、jpeg 或 webp，且文件大小合理，请直接使用。不要仅仅因为示例路径使用了不同扩展名，就将 png 转换为 webp 或 jpeg。
• 只有当参考图片大于 2 MB 时，才在临时目录中创建较小的副本，并通过 --image 传入该副本。确保文件扩展名与实际图片数据一致。如果调整大小或压缩失败，请改用原始的受支持图片文件，不要尝试转换为其他格式。
• 不要覆盖用户的原始图片文件。不要将参考图片存入仓库。如果运行时无法将上传或粘贴的图片保存到本地路径，请让用户将图片保存到本地并提供路径。
• 在提示词中说明需要从参考图片中借鉴的内容，例如布局、配色方案、产品形状、角色风格或构图。只说“参考这张图片”是不够的，应尽可能给出更具体的说明。

运行时提供参考图片的示例：

mkdir -p /tmp/lingzao-image-inputs/run-001 /tmp/lingzao-image-outputs/run-001
~/.lingzao/bin/lingzao generate-image \
  --prompt "参考这张图的排版和明亮色彩，生成一张小红书封面图，主题是 AI 生图新手避坑，中文大标题留白" \
  --size 1024x1024 \
  --image /tmp/lingzao-image-inputs/run-001/ref-1.png \
  --output /tmp/lingzao-image-outputs/run-001/result.png

该命令会创建一个 Lingzao 异步批次，并自动轮询返回的状态 URL，直到后台任务完成或命令超时。图片生成可能需要几分钟；对于较大或较慢的批次，--timeout 可以延长等待时间，但不会缩短内置的逐张图片轮询时长。生成一张图片时，--output 会将结果写入你指定的确切路径。--count 大于 1 时，--output /tmp/poster.png 会将每张成功生成的图片写入带编号的文件，例如 /tmp/poster-1.png、/tmp/poster-2.png，依此类推。默认的 Markdown 输出需要指定 --output，以便将付费生成的图片保存到本地。只有在需要结构化的项目状态或原始图片载荷时，才使用 --format json。

使用说明

• 对于个人资料和帖子 URL，尽可能直接传入 URL。
• 对于原始 ID，请包含 --platform。
• 除非用户要求特定数量，否则省略 --limit。
• 笔记搜索默认按综合排序，搜索所有笔记类型和所有时间；用户要求按排名或筛选笔记搜索时，使用 --sort、--note-type 和 --time-filter。
• 仅当其他工具需要结构化输出时，才使用 --format json。
• 默认输出为供 Agent 阅读和总结的 Markdown。
• 如果 API 密钥或账户需要处理，请让用户打开 Lingzao 控制面板。