zhihu-helper

name	zhihu-helper
description	知乎内容辅助工具。支持查看文章、搜索问题、提取热榜/用户数据。 提供浏览器操作辅助，Cookie 加密存储。
metadata	{"author":"Hermes + WorkBuddy","version":"2.0.7","requires":["node","playwright","python3"],"env":["ZHIHU_COOKIE_KEY (sensitive)","ZHIHU_APP_KEY (optional)","ZHIHU_APP_SECRET (optional)"]}

知乎内容辅助工具 (Zhihu Helper v2.0)

辅助查看知乎内容，提取数据，Cookie 加密存储，稳定可靠。

---

触发词（Trigger Phrases）

• "帮我发一篇知乎文章" / "写知乎文章"
• "发布知乎想法" / "发一条想法"
• "回答知乎问题" / "写回答"
• "知乎提问" / "问一个问题"
• "点赞" / "评论" / "关注"（知乎内容）
• "查看知乎热榜" / "知乎热搜"
• "搜索知乎" / "查一下知乎上的"
• "知乎数据" / "提取知乎信息"

快速开始

1. 安装依赖

# 依赖已安装，如首次使用：
cd zhihu-skill
npm install
npx playwright install chromium

2. 配置 Cookie 加密密钥

export ZHIHU_COOKIE_KEY="$(openssl rand -hex 32)"

3. 导出知乎 Cookie

# 会自动打开浏览器，手动登录后 Cookie 自动加密保存
node scripts/zhihu-export-cookie.js

4. 验证

# 检查 Cookie 是否有效
node tests/cookie-check.js

---

功能模块

1️⃣ 发布文章

在知乎专栏发布 Markdown 文章。

你: 帮我发一篇知乎文章，标题是"xxx"，内容是...
AI: 正在生成内容 → 展示预览 → 等待用户确认 → 发布 → 返回链接

⚠️ 重要：所有发布操作前 AI 必须展示预览并等待用户明确确认（"确认发布？"），未经确认不得执行任何公开操作。

CLI:

# 直接指定内容
node scripts/zhihu-publish.js article --title "标题" --content "正文"

# 从文件读取内容
node scripts/zhihu-publish.js article --title "标题" --content-file "文章.md"

# 保存为草稿（不发布）
node scripts/zhihu-publish.js article --title "标题" --content "正文" --draft

2️⃣ 发布想法

类似 Twitter 的短内容发布。

你: 发一条知乎想法，内容是xxx

CLI:

node scripts/zhihu-publish.js thought --content "想法内容"

# 带图片
node scripts/zhihu-publish.js thought --content "想法内容" --image "图片路径"

3️⃣ 回答问题

搜索问题并撰写回答。

你: 帮我在知乎搜索关于xxx的问题并回答
AI: 搜索问题 → 列出选项 → 用户选择 → 撰写 → 展示预览 → 等待确认 → 提交

CLI:

node scripts/zhihu-answer.js --question-id 123456789 --content "回答内容"

4️⃣ 提问

在知乎上提出新问题。

你: 帮我在知乎提问：xxx
AI: 展示预览 → 等待确认 → 提交

CLI:

node scripts/zhihu-ask.js --title "问题标题" --detail "补充说明"

5️⃣ 互动

点赞、评论、关注（执行前需用户确认）。

你: 给这篇知乎文章点赞 / 评论 / 关注这个用户
AI: 展示操作详情 → 等待确认 → 执行

⚠️ 所有互动操作（点赞/评论/关注）前必须等待用户明确确认。

CLI:

# 点赞
node scripts/zhihu-interact.js like --url "https://www.zhihu.com/question/xxx/answer/xxx"

# 取消点赞
node scripts/zhihu-interact.js unlike --url "..."

# 评论
node scripts/zhihu-interact.js comment --url "..." --content "评论内容"

# 关注用户
node scripts/zhihu-interact.js follow --user "用户ID"

6️⃣ 数据提取

从知乎提取结构化数据。

你: 今天知乎热榜是什么？
AI: 返回热榜 Top 20

CLI:

# 热榜
node scripts/zhihu-extract.js --type hot-list [--limit 20]

# 搜索
node scripts/zhihu-extract.js --type search --query "关键词" [--limit 10]

# 文章详情
node scripts/zhihu-extract.js --type article --id "文章ID"

# 用户信息
node scripts/zhihu-extract.js --type user --id "用户ID"

# 问题详情
node scripts/zhihu-extract.js --type question --id "问题ID"

# 回答列表
node scripts/zhihu-extract.js --type answers --id "问题ID" [--limit 10]

---

架构

                   AI Agent（用户自然语言触发）
                           │
                  ┌────────▼────────┐
                  │  Skill 调度层    │
                  │  SKILL.md → 路由  │
                  └────────┬────────┘
                           │
              ┌────────────┼────────────┐
              │                         │
    ┌─────────▼─────────┐    ┌─────▼─────────┐
    │  浏览器操作通道   │    │ Python/OpenAPI │
    │  zhihu-browser.js │    │ zhihu_bot.py  │
    │  zhihu-publish.js │    │ zhihu-bridge   │
    │  zhihu-interact.js│    └───────────────┘
    │  zhihu-answer.js   │
    │  zhihu-extract.js │
    └───────────────────┘

注：所有操作统一通过浏览器实现，Cookie 加密存储，稳定可靠。

安全

• Cookie 使用 AES-256-GCM 加密存储（权限 0600）
• 环境变量 ZHIHU_COOKIE_KEY 管理加密密钥
• 支持密钥轮换（rotateCookieKey）

Cookie 加密格式

~/.hermes/credentials/zhihu-cookies.enc
├── [12 bytes: 随机 IV]
├── [16 bytes: GCM 认证标签]
└── [AES-256-GCM 加密的 Cookie 数据]

环境变量

变量	必填	说明
ZHIHU_COOKIE_KEY	✅	Cookie 加密密钥（openssl rand -hex 32 生成）
ZHIHU_APP_KEY	❌	知乎 OpenAPI app_key（圈子互动）
ZHIHU_APP_SECRET	❌	知乎 OpenAPI app_secret

测试

# 选择器冒烟测试
node tests/smoke-test.js

# Cookie 到期检测
node tests/cookie-check.js

# 端到端集成测试（沙箱模式）
ZHIHU_TEST_MODE=sandbox node tests/e2e-test.js

注意事项

• ⚠️ 频率控制：HTTP 200-500ms 间隔，浏览器 5-10s 间隔
• ⚠️ Cookie 有效期：约 30 天，到期需重新登录导出
• ⚠️ 知乎改版：config/selectors.json 可能需更新
• ⚠️ 签名失效自动降级：C3b 失败自动切换 Plan B（浏览器通道）
• ⚠️ 浏览器崩溃恢复：withCrashRecovery 自动重建会话