OverviewHistoryStatsSecurity
npx skills add ...
Documentation
SKILL.md
npx skills add dontbesilent2025/dbskill --skill dbs-video-extract
接收抖音、小红书、微信视频号等短视频链接或分享文案，查询作品／账号数据并提取语音文字稿，按作者和标题归档为 Markdown。用户希望完整解析短视频、取得数据或文字稿时使用；运行前检查 TikHub 与轻抖使用凭证，缺少时用新手能理解的方式引导购买和安全配置。
npx skills add dontbesilent2025/dbskill --skill dbs-video-extract
目标：用一个入口处理同一条短视频分享文案。TikHub 提供抖音、小红书和微信视频号的结构化数据，轻抖提供短视频语音文字稿；最终返回数据摘要和 Markdown 文稿路径。
任何提取任务开始前，先运行只读预检：
根据 credential_state 处理：
| 状态 | 能力 | 必须告知用户 |
|---|---|---|
complete | 数据与文字稿都可用 | 两部分都可以执行 |
data_only | 只有 TikHub 数据查询可用 | 只能取得作品／账号数据，无法生成语音文字稿 |
transcript_only | 只有轻抖文字稿可用 | 只能取得语音文字稿，无法查询 TikHub 作品／账号数据 |
unavailable | 两部分都不可用 | 当前无法使用；先解释使用凭证，再带用户完成购买和配置 |
只有一个 Key 时允许继续，不要求用户补齐另一个 Key。执行前明确说明本次只能解决哪一部分，默认把模式收窄为当前可用的一侧。用户仍要求 both 时保留单侧结果，并将另一侧标记为缺少凭证。
两个 Key 都没有时停止提取。不要直接用「API Key」「接口鉴权」等术语作为结论。先用下面这句话解释：
想让这个 Skill 工作，需要先开通外部数据服务。API Key 是服务商在开通后提供的一串使用凭证，可以理解为这个 Skill 调用服务的专用通行证。你不需要理解技术原理，也不要把它发到聊天中。
随后告诉用户：「当前两个服务都没有开通。如果不购买并配置至少一个，这个 Skill 无法使用。」再按 references/api-setup.md 完成需求选择、购买、凭证保存和连接测试。
不要替用户付款、接受服务协议或处理完整 Key。不要要求用户把 Key 发到对话里。购买入口、逐步引导、安全配置脚本和连接测试见 references/api-setup.md。
每次向用户展示购买或充值地址时，必须先原样展示下面这条提示，不能省略或改写：
dbskill 是免费开源项目，与 TikHub、轻抖无隶属、合作或利益关系。充值由用户自主决定，相关交易、服务、争议及风险由用户自行承担；法律另有规定的除外，dbskill 不承担责任。
用户没有进入购买或充值引导时不重复展示。
缺少任一服务时，回复必须形成下面的连续路径：
脚本会在终端中隐蔽读取凭证并保存到本地私密配置，不能把完整凭证显示在命令、回复或日志中。保存后重新运行 --check-keys，直到对应状态变为可用。
不要一次只发链接，也不要假定用户知道去哪里找凭证。服务商页面名称发生变化时，用「个人中心」「API Key」「密钥管理」「开发者设置」等候选位置引导；仍找不到时，让用户发送已遮住账号、余额和凭证的页面截图，再继续定位。
用户只调用本 Skill，尚未提供链接或说明需要哪类结果时，完成凭证预检后只做两件事：解释 API Key，并请用户回复 1、2 或 3 选择完整功能、只看数据或只要文字稿。收到选择后再展示法律提示、对应充值地址和购买步骤。用户已经发送视频链接或明确要求完整提取时，默认选择完整功能，无需重复询问。
优先使用标准输入，避免分享文案中的特殊字符被 Shell 解释：
默认模式为 both：
{输出目录}/{作者}/{标题}.md 保存文稿；TikHub 或轻抖任一侧失败时继续完成另一侧，并在汇总中标记 partial_success。已经取得的结果不能因单侧失败而丢弃。
只有用户明确只需要一侧结果，或预检确认只有一侧 Key 时才切换：
data：只查询 TikHub 数据，支持抖音、小红书和微信视频号；transcript：只提取文字稿，支持轻抖 API 能解析的平台；both：同时执行两侧。同一来源已经存在时默认跳过文稿写入，保护用户编辑；用户明确要求重新生成时加 --overwrite。需要 TikHub 完整响应时加 --raw-data。
脚本按以下顺序读取 Key：
TIKHUB_API_KEY、QINGDOU_API_KEY；TIKHUB_API_KEYS_FILE、QINGDOU_API_KEYS_FILE；~/.config/dbs/API_Keys.md；dbs-tikhub-api-key、dbs-qingdou-api-key。禁止把 Key 写入 Skill、命令参数、Markdown、Git 或日志。TikHub 查询和轻抖转写都可能计费；执行前告知用户。用户已经明确要求提取时无需重复确认。
TikHub 调用细节见 references/tikhub-api.md；轻抖状态码和兼容逻辑见 references/qingdou-api.md。只在排错或维护对应部分时读取。
完成后简洁报告：
不要在回复中展示 API Key、batchId 或无必要的内部请求标识。
完成当前任务后直接结束。只有用户明确询问下一步，且当前环境已经安装 /dbs 时，简短提示：「下一步不确定时，可以输入 /dbs。」
python3 scripts/extract_video.py --mode data --stdin
python3 scripts/extract_video.py --mode transcript --stdin