宜博 / pixelphone

Commit 03a1b343569a5d6d55929f43a5c774b10a5cd9d0

Authored by yibo
1 parent 3d4fb0d1

docs: 加 HANDOFF_PROMPTS.md — claude-run / hermes 接手 prompt（复制粘贴用） 

两个角色各一段可复用 prompt：claude-run（改代码，靠 .restart-request flag 自助重启）+
hermes（跑需要 root 的设备操作）。纳入 deploy-to-phone.sh DOCS 一起部署到 ~/hermes-wechat/。

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
Inline Side-by-side
Showing 2 changed files with 58 additions and 1 deletions
server/services/wechat/HANDOFF_PROMPTS.md 0 → 100644
  View file @03a1b34
  1 +# HANDOFF_PROMPTS.md — 接手 prompt（复制粘贴用）
  2 +
  3 +把对应 prompt 贴给对应 agent 即可让它接手。分工见 `AGENTS.md`：
  4 +**claude-run = 脑子（写/改/审代码）**；**hermes = 手（跑需要 root 的设备操作）**。
  5 +
  6 +---
  7 +
  8 +## ① 给 claude-run（在 `~/hermes-wechat/` 里启动后贴）
  9 +
  10 +```
  11 +你接手维护 ~/hermes-wechat/ 的微信自动回复 bot 的代码开发与调试。
  12 +第一件事：完整读 ~/hermes-wechat/AGENTS.md 和 HANDOFF.md（尤其 §零 环境须知）。
  13 +
  14 +你的角色 = 写 / 改 / 审代码。你跑在 proot、身份是 u0_a327：
  15 +- 能直接编辑本目录 *.js、读 auto-reply.log、读改 .whitelist.json；
  16 +- 拿不到 Magisk root，所以查微信 DB / 发测试消息 / logcat 这类要 root 的操作你做不了，
  17 + 把确切的 `su -c '...'` 命令列给我，由我或 hermes 在 Termux 执行。
  18 +
  19 +工作闭环（全程无需 su）：
  20 + ① 改 ~/hermes-wechat/*.js
  21 + ② touch ~/hermes-wechat/.restart-request → keepalive ~15s 内用新代码重启 bot
  22 + ③ tail ~/hermes-wechat/auto-reply.log → 看结果
  23 + ④ 把需要同步回 Mac repo(server/services/wechat/) 的改动列清楚
  24 +
  25 +bot 实跑只依赖 auto-reply.js + android-wechat-tracker-sqlcipher.js + android-wechat-sender.js，
  26 +其余文件不参与运行。唯一 live 日志就是本目录的 auto-reply.log。
  27 +
  28 +若你的 Bash 一启动就报 EACCES '.../.claude/session-env'，按 AGENTS.md 第 3 条让我在 Termux 修。
  29 +
  30 +先读那两份文档，然后告诉我：bot 当前状态 + HANDOFF §七/§八 里你建议先处理的待办。
  31 +```
  32 +
  33 +---
  34 +
  35 +## ② 给 hermes（`hermes chat` 里贴；要它自动连跑加 `--yolo`）
  36 +
  37 +```
  38 +你是这台 Pixel 上微信 bot 的「设备操作执行器」：你在 Termux、能 su，
  39 +claude-run 负责改代码，你负责跑需要 root 的设备操作。
  40 +先读 ~/hermes-wechat/AGENTS.md（末尾「调试设备状态的常用 su 命令」就是你的活）。
  41 +
  42 +常见任务：
  43 +- 重启 bot：su -c 'pkill -f auto-reply.js'（keepalive 自动用新代码重启）
  44 +- 查微信 DB 最近消息：确认 tracker 是否捕获/被过滤（DB 路径 + key 见 AGENTS.md）
  45 +- 发测试 broadcast：验证 A11y 发送链路
  46 +- 看 logcat -s HermesA11y:*：排查 UI 自动化卡在哪一步
  47 +- A11y 被系统关掉时重新启用（命令见 AGENTS.md）
  48 +
  49 +执行 su 命令前先说明意图，执行后把输出回贴给我。claude-run 给你的 su 命令也可直接代跑。
  50 +```
  51 +
  52 +---
  53 +
  54 +## 用法备注
  55 +
  56 +- claude-run 改完代码靠 `touch .restart-request` 自助重启（keepalive 桥，无需 su）；深度调试（DB/发测试/logcat）交给 hermes 或你手动 Termux 执行。
  57 +- 两个 agent 同时只用一种改码入口（claude-run 现场改 vs Mac 改 deploy），别互相覆盖；手机改完尽快同步回 Mac repo。
server/services/wechat/deploy-to-phone.sh
  View file @03a1b34
@@ -19,7 +19,7 @@ TERMUX_UID=&quot;${TERMUX_UID:-u0_a327}&quot; # Termux app çš„ uid（claude-run ä¹Ÿæ˜¯å® @@ -19,7 +19,7 @@ TERMUX_UID=&quot;${TERMUX_UID:-u0_a327}&quot; # Termux app çš„ uid（claude-run 也是å®
19 # è¿è¡Œæ—¶å¿…需：auto-reply.js åª require 这三个文件，bot 实跑就这些 19 # è¿è¡Œæ—¶å¿…需：auto-reply.js åª require 这三个文件，bot 实跑就这些
20 RUNTIME="auto-reply.js android-wechat-tracker-sqlcipher.js android-wechat-sender.js" 20 RUNTIME="auto-reply.js android-wechat-tracker-sqlcipher.js android-wechat-sender.js"
21 # 文档（接手 / 维护必读）。AGENTS.md/CLAUDE.md 是 agent ä¸€æ¬¡æ€§è¯»çš„å…¥å£ 21 # 文档（接手 / 维护必读）。AGENTS.md/CLAUDE.md 是 agent 一次性读的入å£
22 -DOCS="AGENTS.md CLAUDE.md HANDOFF.md README.md SKILL.md" 22 +DOCS="AGENTS.md CLAUDE.md HANDOFF.md HANDOFF_PROMPTS.md README.md SKILL.md"
23 # 守护脚本（改了è¦æ‰‹åŠ¨é‡å¯ keepalive，è§æœ«å°¾æ示） 23 # 守护脚本（改了è¦æ‰‹åŠ¨é‡å¯ keepalive，è§æœ«å°¾æ示）
24 SCRIPTS="keepalive.sh" 24 SCRIPTS="keepalive.sh"
25 FILES="$RUNTIME $DOCS $SCRIPTS" 25 FILES="$RUNTIME $DOCS $SCRIPTS"