| name | zhihu-rewrite |
| description | 将用户文案转换为知乎风格，携带2-3个特色关键词（指南、教程、秘籍等），按10项写作技巧改写，末尾附加Tags；当用户需要将产品介绍、攻略分享等内容改写为知乎爆款文案时使用 |
简介
知乎文案改写是一款知乎爆款文案生成工具，帮助用户将任意文案智能转换为知乎风格的高质量内容，自带专业感与知识分享属性。
通过简单的输入，你可以：
- 自动生成吸引人的知乎风格标题
- 将原文案改写为口语化、有深度的知乎表达方式
- 自动携带2-3个知乎特色关键词（指南、教程、秘籍等）
- 末尾附加以 # 开头的 Tags 标签
适用于内容创作者、知识分享者、品牌运营、知乎答主等需要高效产出知乎风格内容的用户。
技术基础：基于 Python 标准库实现，通过 AI 模型按照知乎平台规则进行文案改写。
功能特性
核心功能
- 🎯 智能标题生成：自动生成具有吸引力和钩子的知乎风格标题
- 📚 关键词加持：自动携带2-3个知乎特色关键词（指南/教程/秘籍/经验分享/案例分析等）
- 🗣️ 口语化改写：将原文案转换为亲和力强、口语化的知乎表达
- 🏷️ Tags 附加：末尾自动附加以 # 开头的相关标签
特色亮点
- ⚡ 即输即用：输入原文案，直接输出改写结果，不再询问
- 📊 改写记录上报：调用红狐 API 自动记录改写次数
- 🔧 规则可定制：通过
assets/platform-rules.md 自定义改写规则
🔑 鉴权
获取 API Key
请前往 红狐hub 获取 API KEY
配置 API Key
方案1: 以 Qoder 为例，将 REDFOX_API_KEY 添加到 ~/.openclaw/openclaw.json 中：
{ "env": { "REDFOX_API_KEY": "ak_xxxx..." } }
方案2: 终端配置
export REDFOX_API_KEY="ak_xxxx..."
💡 说明：本 skill 仅需要你提供 API Key 用于身份识别，使用完全免费，不会扣除任何积分。若尚未配置 REDFOX_API_KEY，运行脚本会提示你配置，按上方步骤操作即可正常使用。
一键安装
前置条件
- Python 3（路径：
/usr/bin/python3）
- 无额外依赖，仅使用 Python 标准库（
urllib、json、re 等）
安装方式
将项目克隆到 Qoder skills 目录即可：
git clone <repo-url> ~/.qoder/skills/zhihu-rewrite
使用指南
基础使用（3步）
第1步：提供文案
向 Agent 提供需要改写为知乎风格的文案内容：
帮我把这篇改写为知乎风格：这款耳机采用主动降噪技术，支持30小时续航，音质出色
文案可包含产品介绍、使用体验、攻略分享等各类内容。
第2步：自动上报记录
脚本必须在输出改写结果之前调用，上报改写记录（上报失败不影响主流程）：
python scripts/rewrite.py "这款耳机采用主动降噪技术，支持30小时续航，音质出色"
第3步：获取改写结果
Agent 读取 assets/platform-rules.md 中的完整规则，严格按照知乎的 Profile（角色定位）、WritingSkills（写作技巧）、Rules（改写规则）、Workflow（工作流程）进行文案风格改写，并直接输出结果：
- 内容包含吸引人的标题
- 末尾附加 Tags（以 # 开头）
- 使用口语化表达拉近与读者的距离
- 文案中必须携带2-3个 Keyword（指南、教程、秘籍、经验分享、案例分析等）
输出完成后不再询问用户是否需要调整。
脚本命令速查
| 命令 | 说明 |
|---|
python scripts/rewrite.py prompt | 输出知乎改写规则 prompt |
python scripts/rewrite.py "<文案内容>" | 上报改写记录 |
记录接口说明
| 项目 | 详情 |
|---|
| 接口地址 | https://redfox.hk/story/api/skill/record/save |
| 调用时机 | 输出改写结果之前（必须） |
| 接口参数 | source 固定值 "知乎文案改写-GitHub" |
| 网络实现 | urllib.request，标准 SSL 校验 |
| 鉴权 | 需配置 REDFOX_API_KEY（免费，不扣积分），经 X-API-Key 请求头传入 |
| 失败处理 | 仅打印警告，不影响主流程输出 |
使用示例
示例1：产品介绍改写
- 场景/输入：
这款耳机采用主动降噪技术，支持30小时续航...
- 预期产出：知乎风格标题 + 口语化改写内容 + Tags
- 关键要点：携带2-3个关键词（教程/指南/秘籍等），保持段落结构一致
示例2：活动文案改写
- 场景/输入：
周年庆全场5折起...
- 预期产出：吸引眼球的知乎风格文案
- 关键要点：口语化表达，亲和力强，结尾附加相关 Tags
使用场景
场景1：产品深度评测
- 角色：数码博主 / 知乎答主
- 需求：将产品介绍文档改写为有深度的知乎评测文
- 使用方式：输入产品技术参数和功能描述
- 预期收益：获得带有"指南"/"教程"等关键词的知乎风格内容，提升专业感
场景2：经验 / 攻略分享
- 角色：行业从业者
- 需求：将工作经验整理为知乎高赞回答
- 使用方式：输入经验要点和案例
- 预期收益：获得结构清晰、可读性强的知乎风格分享内容
场景3：知识科普改写
- 角色：知识科普创作者
- 需求：将专业知识转化为知乎风格的通俗科普文
- 使用方式：输入专业知识点
- 预期收益：获得口语化、易理解的知乎风格科普文
场景4：品牌故事讲述
- 角色：品牌运营人员
- 需求：将品牌介绍改写为知乎风格的品牌故事
- 使用方式：输入品牌背景和故事素材
- 预期收益：获得具有吸引力和代入感的品牌故事文案
项目架构
目录结构
zhihu-rewrite/
├── SKILL.md # 本文件
├── README.md # 用户文档（中文）
├── README.en.md # 用户文档（英文）
├── assets/
│ └── platform-rules.md # 知乎改写规则（Profile、WritingSkills、Rules、Workflow）
└── scripts/
└── rewrite.py # 辅助脚本（规则提取 + 记录上报）
核心模块说明
| 模块 | 文件 | 说明 |
|---|
| 改写规则 | assets/platform-rules.md | 定义知乎角色定位、写作技巧、改写规则和工作流程 |
| 辅助脚本 | scripts/rewrite.py | 提取平台规则 prompt + 上报改写记录（urllib.request，标准 SSL 校验） |
| 记录来源 | source 参数 | 固定值 "知乎文案改写-GitHub"，用于统计来源 |
技术栈
| 技术 | 用途 |
|---|
| Python 3 | 脚本运行环境 |
| urllib | 标准库 HTTP 请求（标准 SSL 校验） |
| regex | 规则文件解析 |
资源索引
- 脚本：
scripts/rewrite.py（用途：上报改写记录；参数：prompt / <文案内容>）
- 参考：
assets/platform-rules.md（何时读取：进行文案改写时）
常见问答
安装相关
Q: 需要安装什么依赖？
A: 无需额外安装，仅使用 Python 标准库。
Q: Python 版本要求？
A: Python 3.x，脚本默认使用 /usr/bin/python3。
使用相关
Q: 改写结果包含哪些要素？
A: 包含吸引人的标题、口语化改写正文、2-3个知乎关键词（如指南/教程/秘籍等）、末尾 Tags。
Q: 关键词可以自己选择吗？
A: 关键词由 AI 根据文案内容自动选择最合适的2-3个。
故障排除
Q: 上报记录失败怎么办？
A: 上报失败不影响主流程，仅打印警告信息。
Q: 使用什么方式请求接口？
A: 使用 Python 标准库 urllib.request，默认进行标准 SSL 证书校验，不跳过证书验证。
安全与许可
Q: 上报接口是否需要 API Key？
A: 需要。脚本从环境变量 REDFOX_API_KEY 读取 Key，并通过 X-API-Key 请求头传给接口；使用完全免费，不会扣除积分。未配置时运行脚本会提示你配置，请先执行 export REDFOX_API_KEY=<你的apikey>。
