1. 安装与设置
1.1 安装技能
复制以下内容发送给 OpenClaw 即可自动安装：
Agent 会读取 manifest.json 获取文件清单，自动下载到 skills/ 目录并生效。
1.2 配置部署参数
在 Agent 工作区的 TOOLS.md 中添加配置。技能有四个独立部署目标：
| 配置组 | 变量 | 说明 | 示例 |
|---|
| 本地报告 | REPORT_LOCAL_DIR | 本地站点根目录 | /home/user/my-site |
REPORT_LOCAL_URL | 站点访问地址 | https://example.com |
REPORT_SITE_NAME | 站点显示名称 | 我的报告站 |
| 远程报告 | REPORT_CF_PROJECT | 报告站 CF Pages 项目名 | my-reports |
| 技能 CF | SKILL_CF_PROJECT | 技能站 CF Pages 项目名 | report-expert-skill |
| 技能 ClawHub | SKILL_CLAWHUB_SLUG | ClawHub 技能标识 | report-expert |
SKILL_CLAWHUB_NAME | ClawHub 显示名 | 报告专家 |
| 通用 | CLOUDFLARE_API_TOKEN | CF API Token（CF 操作需要） | cfut_xxx |
1.3 快速配置示例
1.3.1 本地报告模式
文件直接写入本地目录，适合自建站点。复制以下配置粘贴到 TOOLS.md：
REPORT_LOCAL_DIR=/home/user/my-site
REPORT_LOCAL_URL=https://example.com
REPORT_SITE_NAME=我的报告站
复制
1.3.2 远程报告模式
报告部署到 Cloudflare Pages。需要先创建 CF Pages 项目并获取 API Token：
2头像 → API Tokens → Create Token
3Pages → Edit → 创建 Token
REPORT_LOCAL_DIR=/home/user/my-site
REPORT_LOCAL_URL=https://example.com
REPORT_SITE_NAME=我的报告站
REPORT_CF_PROJECT=my-reports
CLOUDFLARE_API_TOKEN=cfut_你的Token
复制
将 cfut_你的Token 替换为实际 Token 值。
1.3.3 完整配置（四目标）
同时启用本地报告、远程报告、技能 CF 发布和 ClawHub 发布：
# 本地报告
REPORT_LOCAL_DIR=/home/user/my-site
REPORT_LOCAL_URL=https://example.com
REPORT_SITE_NAME=我的报告站
# 远程报告
REPORT_CF_PROJECT=my-reports
# 技能发布
SKILL_CF_PROJECT=report-expert-skill
SKILL_CLAWHUB_SLUG=report-expert
SKILL_CLAWHUB_NAME=报告专家
# 通用
CLOUDFLARE_API_TOKEN=cfut_你的Token
复制
2. 使用方式
以下所有操作均通过自然语言对话完成，Agent 会自动调用技能执行。
Agent 自动调研、生成内容、转为 HTML、部署到站点并更新索引。你只需描述需求，整个流程自动完成。
支持直接部署 HTML 文件，或将 Markdown 自动转换后部署。可选择分类、指定标题和描述。
扫描全站页面，提取标题、日期、描述等信息，自动识别分类并重建完整索引。
将独立部署的页面（游戏、工具等）添加到站点索引，支持站内 iframe 内嵌查看。
支持发布技能到 Cloudflare Pages（预览+生产）和 ClawHub。每次自动更新版本号、文件哈希和介绍页。
3. 技能详细介绍
3.1 核心能力
点击展开查看工作流程
内置专业配色方案、SVG 图标体系、响应式栅格布局。生成的报告页面视觉统一，无需额外样式调整。
接受 Markdown 或 HTML 输入，自动提取内容并套用模板生成完整页面，包含大纲导航、滚动进度等交互组件。
Markdown/HTML
内容提取
模板渲染
完整 HTML
自动扫描站点下所有页面，提取标题、日期、描述、分类等信息，重建索引数据并刷新首页。
扫描 dist/
提取信息
识别分类
生成 index.json
刷新首页
外部页面可在站内通过 iframe 打开查看，保持导航体验一致。支持 hash 路由和 postMessage 通信。
点击外部链接
写入 #v=hash
打开 iframe
postMessage 返回
四个独立部署目标，统一配置管理。报告可部署到本地目录或 Cloudflare Pages，技能可发布到 CF Pages 或 ClawHub。
支持从远程升级技能、发布到 CF Pages（预览+生产）、发布到 ClawHub。每次发布自动更新版本号、文件哈希和介绍页。
3.2 内容分类体系
分类不是固定枚举，而是通过扫描页面内容自动识别。Agent 读取每个页面的 HTML，根据标题和正文语义判断所属分类，该分类决定页面在索引首页中归入哪个分组。
内置分类标识：
research深度研究
analysis数据分析
project项目作品
summary内容摘要
comparison对比评测
tutorial教程指南
other其他
3.3 技能文件结构
report-expert/
├── SKILL.md 技能定义（Agent 自动读取）
├── deploy.py CLI 入口（参数解析与命令分发）
├── upgrade.py 自动升级工具
├── manifest.json 版本清单（发布用）
├── lib/
│ ├── config.py 统一配置管理（四组部署目标）
│ ├── page.py HTML 模板生成
│ ├── local_deploy.py 本地报告部署（写文件到 dist/）
│ ├── remote_deploy.py远程报告部署（Cloudflare Pages）
│ ├── skill_cf_publish.py 技能发布到 CF Pages
│ ├── skill_clawhub_publish.py 技能发布到 ClawHub
│ ├── index.py 索引管理（重建/添加/扫描）
│ └── backup.py 备份恢复与页面模板更新
├── templates/
│ ├── base.css 全局样式
│ └── index.html 首页模板
└── scripts/
└── main.js 首页交互脚本
复制
3.4 版本更新记录
最新四目标部署系统：本地报告、远程报告、技能CF发布、技能ClawHub发布独立管理
v1.4统一页头页脚注入、iframe hash 路由、非报告页面隔离
v1.3iframe 内嵌查看器、报告页自动刷新
v1.2自适应部署配置、项目分类支持