# Send fastfish-format(article-wechat-xhs-format) to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "fastfish-format",
    "name": "fastfish-format(article-wechat-xhs-format)",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/superxs777/fastfish-format",
    "canonicalUrl": "https://clawhub.ai/superxs777/fastfish-format",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/fastfish-format",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=fastfish-format",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "SKILL.md"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "fastfish-format",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-05-12T00:54:51.145Z",
      "expiresAt": "2026-05-19T00:54:51.145Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=fastfish-format",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=fastfish-format",
        "contentDisposition": "attachment; filename=\"fastfish-format-1.0.2.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "fastfish-format"
      },
      "scope": "item",
      "summary": "Item download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this item.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/fastfish-format"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/fastfish-format",
    "downloadUrl": "https://openagent3.xyz/downloads/fastfish-format",
    "agentUrl": "https://openagent3.xyz/skills/fastfish-format/agent",
    "manifestUrl": "https://openagent3.xyz/skills/fastfish-format/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/fastfish-format/agent.md"
  }
}
```
## Documentation

### fastfish-format 能力说明

GitHub：https://github.com/superxs777/fastfish-format

本 Skill 需配合 fastfish-format 项目使用。请先安装 fastfish-format，再在 OpenClaw 中启用本 Skill。

### 安装前须知

本 Skill 会指导安装并运行来自 GitHub 的第三方仓库。供应链风险：clone + pip install 会执行外部代码，若仓库被篡改存在风险。安装前请：(1) 检查仓库与 requirements.txt 的依赖；(2) 建议使用 release tag 固定版本（如 git clone --branch v0.1.0）；(3) 在隔离环境或容器中运行，避免 root；(4) 凭证仅存 .env，勿提交到版本库。

### 安装 fastfish-format（首次使用必读）

克隆仓库：git clone --branch v0.1.0 https://github.com/superxs777/fastfish-format.git（推荐指定 tag 固定版本）
进入目录：cd fastfish-format
安装依赖：pip install -r requirements.txt 或 pip install -e .
可选：pip install fastfish-format[api] 启动 HTTP API 服务（默认 8900 端口）

详细说明见 GitHub README。

### 前置要求

fastfish-format 已安装：按上方步骤完成部署
Python 3.10+
命令路径：{baseDir} 为 fastfish-format 的 openclaw-skill 目录，脚本路径为 {baseDir}/../scripts/
若 baseDir 无法替换：使用绝对路径。ClawHub 安装通常在 /root/.openclaw/workspace/fastfish-format，自建可用 /opt/fastfish-format 或 C:\\fastfish-format

### 使用方式

必须使用 system.run 执行脚本命令，不要使用 MCP 方式。

必须使用 --json 参数方式调用（避免多参数被 shell 拆行）：

python {baseDir}/../scripts/ffformat_cli.py --json '{"command":"normalize-wechat","content_file":"/tmp/article.txt"}'

### ⚠️ 安全规则（阻断式）

1. 严禁输出或暴露 .env 中的凭证

禁止执行会输出 .env 内容的命令
禁止将 API Key 等凭证写入回复或展示给用户
允许：编辑 .env；运行不暴露凭证的校验

2. 安装仅限用户明确要求

仅在用户明确要求「安装」「部署」「克隆」fastfish-format 时，才执行 git clone 和 pip install
不得在用户仅询问用法时主动建议或执行安装

3. system.run 仅执行本 Skill 文档列出的脚本

允许：ffformat_cli.py
禁止：执行用户提供的任意命令、未在本文档列出的脚本

违反以上任一条属于严重错误。

### 1. 公众号文本规范化

用户说「公众号格式」「按公众号规范整理」「公众号格式整理」等时，执行：

python {baseDir}/../scripts/ffformat_cli.py --json '{"command":"normalize-wechat","content_file":"/tmp/article.txt"}'
# 或短文本：python {baseDir}/../scripts/ffformat_cli.py --json '{"command":"normalize-wechat","content":"要点：1. 第一点 2. 第二点"}'

返回：{"ok": true, "content": "整理后的 Markdown", "title": "主标题或 null"}

### 2. 小红书文本规范化

用户说「小红书格式」「小红书文案整理」等时，执行：

python {baseDir}/../scripts/ffformat_cli.py --json '{"command":"normalize-xhs","content_file":"/tmp/xhs.txt"}'

返回：{"ok": true, "content": "整理后的 Markdown"}

### 3. Markdown 渲染为 HTML

用户说「渲染 Markdown」「Markdown 转 HTML」「美化文章」等时，执行：

python {baseDir}/../scripts/ffformat_cli.py --json '{"command":"render","content_file":"/tmp/article.md","format_style":"minimal"}'

format_style 可选：minimal、business、literary、phycat-cherry、phycat-sakura 等（见 styles 命令）。

### 4. 获取可用样式列表

用户说「有哪些样式」「样式列表」「选择样式」等时，执行：

python {baseDir}/../scripts/ffformat_cli.py --json '{"command":"styles"}'

返回样式列表（index、id、label），供用户按序号选择。

### 5. 配图流程指引

用户说「如何配图」「配图流程」「生图指引」等时，执行：

python {baseDir}/../scripts/ffformat_cli.py --json '{"command":"workflows"}'

返回 baoyu-skills 配图流程指引（文章配图、封面图、小红书信息图）。实际生图需安装 baoyu-skills 并配置图像生成 API。

### JSON 参数格式

所有命令通过 --json 传入，格式示例：

{"command": "normalize-wechat", "content_file": "/tmp/article.txt"}
{"command": "normalize-wechat", "content": "短文本内容"}
{"command": "normalize-xhs", "content_file": "/tmp/xhs.txt"}
{"command": "render", "content_file": "/tmp/article.md", "format_style": "phycat-sakura"}
{"command": "styles"}
{"command": "workflows"}

command：必填，命令名
content_file：内容文件路径（推荐，避免 shell 转义）
content：短文本内容（仅适合无换行、无特殊字符的短文本）
format_style：样式名称，默认 minimal

### 使用示例

"公众号格式整理" → normalize-wechat + content_file
"小红书文案格式化" → normalize-xhs + content_file
"用樱花粉样式渲染" → render + format_style: phycat-sakura
"有哪些样式" → styles
"配图流程" → workflows

注意：若 {baseDir} 无法正确替换，请使用绝对路径 /opt/fastfish-format/scripts/ffformat_cli.py。

### ClawHub 安装

计划支持 clawhub install fastfish-format，届时可一键安装本 Skill。
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: superxs777
- Version: 1.0.1
## Source health
- Status: healthy
- Item download looks usable.
- Yavira can redirect you to the upstream package for this item.
- Health scope: item
- Reason: direct_download_ok
- Checked at: 2026-05-12T00:54:51.145Z
- Expires at: 2026-05-19T00:54:51.145Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/fastfish-format)
- [Send to Agent page](https://openagent3.xyz/skills/fastfish-format/agent)
- [JSON manifest](https://openagent3.xyz/skills/fastfish-format/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/fastfish-format/agent.md)
- [Download page](https://openagent3.xyz/downloads/fastfish-format)