zhihu valhalla

Persona Bot Skill — 知乎赛博分身部署向导

触发条件

当用户运行 /persona-bot 时激活本 skill。 适用场景：从零开始为任意知乎作者构建赛博分身 Discord Bot。

执行流程

Phase 1 — 环境确认

1. 询问用户：

• 目标作者的知乎用户名（URL 中的 slug，如 zhihu.com/people/xxx 中的 xxx）
• 是否已有 ZHIHU_AVATAR_API_KEY（Anthropic 兼容 API 密钥）

2. 确认以下文件存在：

• step1_scrape.js
• step2_import.py
• step3_distill.py
• bot/ 目录

3. 确认 Python 环境：

   pip install -r requirements.txt

Phase 2 — 抓取文章

推荐方案（浏览器控制台）：

1. 提示用户：

• 打开 Chrome，访问 https://www.zhihu.com，确认已登录
• 打开 step1_scrape.js，将第 19 行的 YOUR_ZHIHU_USERNAME 改为目标作者名
• F12 → Console → 输入 allow pasting → 粘贴脚本 → 运行
• 等待下载 {author}_articles.json

2. 验证：

• 将 JSON 文件放到项目根目录
• 检查文件大小 > 0

备选方案（Python 自动抓取）：

pip install requests beautifulsoup4
python zhihu_scraper.py --author YOUR_AUTHOR

注意：需要 cookies.txt，将浏览器登录 Cookie 粘贴到该文件。

Phase 3 — 蒸馏人格档案

运行一键管道：

# Linux/Mac
export ZHIHU_AVATAR_API_KEY=your_api_key_here
./run_pipeline.sh YOUR_AUTHOR

# Windows
set ZHIHU_AVATAR_API_KEY=your_api_key_here
python step2_import.py --author YOUR_AUTHOR --file YOUR_AUTHOR_articles.json
python step3_distill.py --author YOUR_AUTHOR

验证输出：

• PERSONA.md 文件已生成
• 检查是否包含 ## Avatar 角色卡 章节（这是 Discord Bot 使用的核心内容）

查看进度：

python step3_distill.py --author YOUR_AUTHOR --status

Phase 4 — 部署 Discord Bot

1. 注册 Discord Bot（如尚未完成）：

• 访问 https://discord.com/developers/applications
• New Application → Bot → 复制 Token
• 开启 Message Content Intent
• 邀请到目标 Discord 服务器

2. 配置环境变量：

   cd bot
   cp .env.example .env
   # 填写以下字段：
   # DISCORD_TOKEN=xxx
   # ZHIHU_AVATAR_API_KEY=xxx
   # BOT_CHANNEL_ID=xxx（右键频道 → 复制ID）
   # PERSONA_PATH=/absolute/path/to/PERSONA.md

3. 本地测试：

   pip install -r requirements.txt
   python bot.py

看到 Bot 上线：xxx 日志即成功。 在专用频道发一条消息，验证 Bot 以人格回复。

4. 生产部署（云端 VM）： 参考 bot/README.md 的 systemd 守护进程配置。

验证清单

完成后确认以下项目：

• [ ] PERSONA.md 包含 ## Avatar 角色卡 章节
• [ ] Bot 在线，发消息能得到回复
• [ ] !reset 能清空对话历史
• [ ] !status 显示正确的作者名和使用次数
• [ ] 发超过 DAILY_LIMIT 条消息后 Bot 提示已达上限

常见问题

Q：scrape.js 报 403 错误？ A：确认已在 zhihu.com 登录状态，且 Cookie 未过期。

Q：Phase A 蒸馏速度很慢？ A：正常，每篇文章约 2-3 秒（有速率限制保护）。支持断点续传，中断后重新运行会跳过已完成的文章。

Q：PERSONA.md 生成后 Bot 回复风格不对？ A：检查 PERSONA_PATH 是否指向正确文件，以及文件是否包含 ## Avatar 角色卡 章节。

Q：想换其他作者？ A：重新运行 Phase 2-3（使用新的 --author 参数），生成新的 PERSONA.md，更新 PERSONA_PATH 环境变量后重启 Bot。