知乎内容辅助工具。支持查看文章、搜索问题、提取热榜/用户数据。提供浏览器操作辅助，Cookie 加密存储。
SKILL.md

---
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. 安装依赖
```bash
# 依赖已安装，如首次使用：
cd zhihu-skill
npm install
npx playwright install chromium
```

### 2. 配置 Cookie 加密密钥
```bash
export ZHIHU_COOKIE_KEY="$(openssl rand -hex 32)"
```

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

### 4. 验证
```bash
# 检查 Cookie 是否有效
node tests/cookie-check.js
```

---

## 功能模块

### 1️⃣ 发布文章
在知乎专栏发布 Markdown 文章。

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

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

**CLI:**
```bash
# 直接指定内容
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:**
```bash
node scripts/zhihu-publish.js thought --content "想法内容"

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

### 3️⃣ 回答问题
搜索问题并撰写回答。

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

**CLI:**
```bash
node scripts/zhihu-answer.js --question-id 123456789 --content "回答内容"
```

### 4️⃣ 提问
在知乎上提出新问题。

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

**CLI:**
```bash
node scripts/zhihu-ask.js --title "问题标题" --detail "补充说明"
```

### 5️⃣ 互动
点赞、评论、关注（执行前需用户确认）。

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

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

**CLI:**
```bash
# 点赞
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:**
```bash
# 热榜
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 |

## 测试

```bash
# 选择器冒烟测试
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 自动重建会话