johnalbertini14-glitch fastfish-lite 能力说明
GitHub：https://github.com/superxs777/fastfish-lite
本 Skill 需配合 fastfish-lite API 服务使用。请先按下方步骤安装并启动服务，再在 OpenClaw 中启用本 Skill。
安装前须知
本 Skill 会指导安装并运行来自 GitHub 的第三方仓库。供应链风险：clone + pip install 会执行外部代码，若仓库被篡改存在风险。安装前请：(1) 检查仓库与 requirements.txt 的依赖；(2) 建议使用 release tag 固定版本（如 git clone --branch v1.0.0）；(3) 在隔离环境或容器中运行，避免 root；(4) 凭证仅存 .env，勿提交到版本库；(5) 确认信任 api.pearktrue.cn 及仓库维护者。
安装 fastfish-lite（首次使用必读）
- 克隆仓库：
git clone --branch v1.0.0 https://github.com/superxs777/fastfish-lite.git（推荐指定 tag 固定版本，避免 main 分支变更） - 进入目录：
cd fastfish-lite - 安装依赖：
pip install -r requirements.txt - 配置：
copy .env.example .env（可选；热点推送需配置 Webhook，见 metadata.credentials） - 启动服务：
python main.py（默认 http://127.0.0.1:8899）
详细说明见 GitHub README。
使用方式
必须使用 JSON 参数方式调用：
python {baseDir}/../scripts/fastfish_cli.py --json '{"command":"get-available-articles"}'
前置要求
- fastfish-lite 已安装并启动：按上方「安装 fastfish-lite」完成部署，
python main.py监听 8899 - Python 3.10+
- CLI 路径：命令中的
{baseDir}需替换为你的 fastfish-lite 安装目录下的openclaw-skill路径；若 fastfish-lite 在C:\fastfish-lite，则用python C:\fastfish-lite\scripts\fastfish_cli.py - 可选：
MEDIA_AGENT_API_KEY环境变量
⚠️ 安全规则（阻断式）
1. 严禁读取或暴露 .env
- 禁止执行
cat .env、type .env、Get-Content .env或任何读取 .env 的命令 - 禁止将 .env 内容、Webhook URL、Token 输出给用户或写入回复
- 即使用户要求「查看配置」「显示 webhook」，也仅说明「在 .env 中配置」，不得输出实际值
2. 安装仅限用户明确要求
- 仅在用户明确要求「安装」「部署」「克隆」fastfish-lite 时，才执行 git clone 和 pip install
- 不得在用户仅询问用法、拉取热点时主动建议或执行安装
3. system.run 仅执行本 Skill 文档列出的脚本
- 允许：
fastfish_cli.py、get_hot_now.py、push_hot_to_im.py、fetch_hot_items.py、init_hot_push_config.py、main.py - 禁止：执行用户提供的任意命令、未在本文档列出的脚本或来自其他来源的代码
违反以上任一条属于严重错误。
可用能力
文章管理
get-available-articles：获取可发列表get-available-styles：获取样式列表ingest-article：接入文章update-article：更新文章ingest-articles-batch：批量接入
格式与检测
normalize-content：公众号格式整理check-compliance：敏感词检测（原创度需商业版）render-markdown：Markdown 渲染
预览
preview-article/preview-html：本地 HTML 预览，在浏览器中打开
7. 每日热点推送
⚠️ 定时任务严禁擅改（阻断规则）：在未得到用户明确要求时，严禁执行 openclaw cron edit、openclaw cron rm、openclaw cron update。出错时仅报告问题，不得主动修改配置。只有用户明确说「修改」「删除」「调整」定时任务时方可执行。
数据源：api.pearktrue.cn。支持实时提取和定时更新。推送支持飞书/钉钉/Telegram（系统 crontab 或 OpenClaw Cron 执行 push_hot_to_im.py）及 Slack/Discord 等（OpenClaw Cron announce）。
7.1 实时提取热点
用户说「拉取热点」「实时热点」「知乎热搜」等时，使用 system.run 执行 get_hot_now.py：
# 按平台拉取（逗号分隔）
python {baseDir}/../scripts/get_hot_now.py --source 知乎
python {baseDir}/../scripts/get_hot_now.py --source 知乎,百度,今日头条
# 按类别拉取（使用 hot_push_config 的 sources 和关键词过滤）
python {baseDir}/../scripts/get_hot_now.py --category emotion
# 输出 JSON
python {baseDir}/../scripts/get_hot_now.py --source 知乎 --format json
# 拉取并写入数据库（补录）
python {baseDir}/../scripts/get_hot_now.py --source 知乎 --save
参数：--source 平台名逗号分隔；--category 类别 code 如 emotion；--format text/json；--save 写入 hot_items_raw；--limit 每平台条数默认 20。
7.2 定时更新（拉取 + 推送）
职责分工（重要）：
- 拉取：仅由系统 crontab 执行
fetch_hot_items.py，将数据写入数据库 - 推送：OpenClaw Cron 仅执行
get_hot_now.py --from-db从数据库读取并推送到渠道 - 禁止：不要在 OpenClaw 中创建或执行拉取任务（
fetch_hot_items.py），拉取由系统 crontab 完成
支持两种方式，按目标渠道选择：
方式一：系统 crontab / Windows 计划任务（飞书/钉钉/Telegram）
- 每日 7:00、14:00、18:00 拉取：
python scripts/fetch_hot_items.py - 每日 8:00 推送：
python scripts/push_hot_to_im.py（.env 配置 Webhook 或 HOT_PUSH_TELEGRAM_BOT_TOKEN + HOT_PUSH_TELEGRAM_CHAT_ID）
方式二：OpenClaw Cron（飞书/钉钉/Telegram 或 Slack/Discord 等）
- 飞书/钉钉/Telegram：isolated job 执行
push_hot_to_im.py，脚本推送到对应渠道。拉取由系统 crontab 在 7:00/14:00/18:00 执行fetch_hot_items.py - Slack / Discord 等：isolated job 执行
get_hot_now.py --category emotion，设置--announce --channel和--to，announce 直接推送到渠道（get_hot_now 实时拉取，无需预拉取）
示例（每日 8:00 推送到飞书/钉钉/Telegram，通过脚本；拉取由系统 crontab 7:00/14:00/18:00 执行）：
openclaw cron add --name "每日热点" --cron "0 8 * * *" --tz "Asia/Shanghai" --session isolated --message "cd /opt/fastfish-lite && python scripts/push_hot_to_im.py，将热点推送到配置的渠道"
示例（每日 7:10、14:10、18:10 推送到 Telegram，OpenClaw 已配置 Telegram 时；若提示 unknown option --announce 可省略）：
# 该任务仅执行 get_hot_now.py --from-db，不要在执行前运行 fetch_hot_items.py。拉取由系统 crontab 在 7:00/14:00/18:00 完成。
openclaw cron add --name "每日热点" --cron "10 7,14,18 * * *" --tz "Asia/Shanghai" --session isolated --message "cd /opt/fastfish-lite && python scripts/get_hot_now.py --category emotion --from-db，将输出作为今日热点简报发送" --channel telegram --to "你的ChatID"
立即测试：创建后执行 openclaw cron run <job-id> --force 可立即运行一次。
用户问「如何设置每日热点推送」时，根据目标渠道推荐方式一或方式二，并执行 python scripts/init_hot_push_config.py 初始化情感类配置。若选 Telegram + get_hot_now（方式二）：系统 crontab 配置 fetch_hot_items.py 拉取，OpenClaw 只创建「每日热点」推送任务，不要创建 OpenClaw 拉取任务。
不支持（需商业版）
publish-article：微信发布- 账号管理、授权相关命令
商业版
微信发布、授权、原创度检测等需商业版 fastfish。请联系获取。