WeChat Channels Search

Agreements

Unified installation and execution directory:

~/.agents/skills/wechat-search-collector/

. Navigate to this directory before execution:

bash

cd ~/.agents/skills/wechat-search-collector

Use
```
android-adb
```
to perform device operations; use
```
ai-vision
```
to locate elements from screenshots (do not use
```
dump-ui
```
).
Prioritize reusing function encapsulations in
```
references/commands.md
```
(
```
ADB
```
/
```
VISION
```
/
```
TASK
```
/
```
REPORT
```
) to avoid
```
cd
```
drift.
Output directory: If
```
TASK_ID
```
exists, write to
```
~/.eval/<TASK_ID>/
```
; otherwise, write to
```
~/.eval/debug/
```
(filename with timestamp).
Result collection and reporting: Use
```
result-bitable-reporter
```
; must execute
```
collect-start
```
before entering the WeChat process, and must execute
```
collect-stop
```
+
```
report
```
upon completion.

Preprocessing

Read device serial number: Use the environment variable
```
SerialNumber
```
(or confirm via
```
ADB devices
```
).
Prepare output directory:
```
TASK_ID
```
must be a number; create
```
~/.eval/<TASK_ID>/
```
.

Start collection: Execute

REPORT collect-start --task-id <TASK_ID> --db-path ~/.eval/records.sqlite --table capture_results

(see

references/commands.md

Optional task retrieval: Use
```
TASK claim
```
to retrieve tasks from Feishu; select the process based on
```
Scene
```
(Comprehensive Page Search / Personal Page Search).

Shared Subprocess: Scroll Results to Bottom (Check every 5 swipes)

Goal: Avoid visual misjudgment; prioritize using sqlite

capture_results

to incrementally determine if there are new entries.

After entering a keyword result page, record the baseline
```
LAST_COUNT
```
:
```
LAST_COUNT="$(REPORT stat --task-id <TASK_ID>)"
```
Loop until reaching the bottom:
- Swipe 5 times:
```
ADB -s <SERIAL> swipe 540 1800 540 400 --duration-ms 800
```
  (loop 5 times; wait randomly for 500~1000ms after each swipe)
- Query current total count:
```
CUR_COUNT="$(REPORT stat --task-id <TASK_ID>)"
```
- If
```
CUR_COUNT == LAST_COUNT
```
  occurs
```
N
```
  consecutive times (recommended
```
N=3
```
  ), judge as bottom reached; otherwise, update
```
LAST_COUNT=CUR_COUNT
```
  and continue.
If sqlite judgment is unavailable, use
```
ai-vision assert
```
as a binary fallback (must judge as no if uncertain), see
```
references/commands.md
```
.

Comprehensive Page Search Process

Applicable to the requirement of "searching for single or multiple keywords on the WeChat Channels comprehensive page and traversing results."

1. Task Parameter Validation

Task information must provide search keywords (split into
```
KEYWORDS
```
by commas)

2. Launch WeChat

If currently in WeChat, first use the
```
back-home
```
command of
```
android-adb
```
to return to the phone's home screen.
Launch WeChat after returning to the home screen.

3. Enter Discover -> WeChat Channels

Locate and click the
```
Discover
```
and
```
WeChat Channels
```
entries via screenshot + ai-vision.

4. Enter Search Interface

Click the search box/magnifying glass to enter the search page via screenshot + ai-vision; if blocked, swipe first then locate.

5. Enter Keywords in Sequence and Trigger Search

Execute for each keyword in the
```
KEYWORDS
```
list: Clear input box -> Enter keyword -> Trigger search.
If not entering the result page, retry triggering until entering the result page.

6. Scroll Results to Bottom and Switch to Next Keyword

Execute the "scroll results to bottom" swipe loop for each keyword's result page.
Execute the "Shared Subprocess: Scroll Results to Bottom (Check every 5 swipes)" for each keyword.
After confirming reaching the bottom: Click the search box to ensure it's activated -> Clear -> Enter next keyword -> Trigger search, until all keywords are traversed.

7. Scene Post-Processing

After the comprehensive page search task is successfully completed, call
```
piracy-handler
```
to implement piracy clustering screening, subtask creation, and webhook push plan creation.
If the comprehensive page search process fails or is interrupted, do not call this orchestrator.

Personal Page Search Process

Applicable to the requirement of "first entering an account's personal page, then searching for multiple keywords within the personal page and traversing results."

1. Task Parameter Validation

Task information must provide: Account name (
```
ACCOUNT_NAME
```
) and search keywords (split into
```
KEYWORDS
```
by commas)

2. Launch WeChat

If currently in WeChat, first use the
```
back-home
```
command of
```
android-adb
```
to return to the phone's home screen.
Launch WeChat after returning to the home screen.

3. Enter Discover -> WeChat Channels

Locate and click the
```
Discover
```
and
```
WeChat Channels
```
entries via screenshot + ai-vision.

4. Enter Search Interface

Click the search box/magnifying glass to enter the search page via screenshot + ai-vision; if blocked, swipe first then locate.

5. Search Account and Enter Personal Page

Enter the account name
```
ACCOUNT_NAME
```
and trigger the search
After entering the search results, if the target account exists, click directly to enter its personal page
Otherwise, click the
```
Accounts
```
tab first, then click the target account in the account list to enter its personal page

6. Search Keywords in Sequence on Personal Page

Execute for each keyword in the
```
KEYWORDS
```
list: First click the personal page search box to ensure it's activated -> Clear -> Enter keyword -> Trigger search -> Scroll results to bottom.
Execute the "scroll results to bottom" swipe loop for each keyword's result page.
Execute the "Shared Subprocess: Scroll Results to Bottom (Check every 5 swipes)" for each keyword.
Confirm being on the account's personal page before searching each keyword; if accidentally exited, re-enter the personal page then continue.

7. Scene Post-Processing

After the personal page task ends and enters the final state (
```
success/error
```
), if the task has a
```
GroupID
```
, call
```
group-webhook-dispatch
```
to perform "readiness check + webhook push".

Post-Task Cleanup Logic

If no task is retrieved via
```
claim
```
, end directly without cleanup.
After all keywords are traversed, use the
```
back-home
```
command of
```
android-adb
```
to return to the phone's home screen
Regardless of whether the task succeeds, fails, or is interrupted, the following actions must be executed (finally semantics):
- Call
```
collect-stop
```
  of
```
result-bitable-reporter
```
  to end current device collection, and print collection statistics.
- Call
```
report
```
  of
```
result-bitable-reporter
```
  with
```
--task-id <TASK_ID>
```
  , and only report data where
```
reported in (0,-1)
```
  in
```
capture_results
```
  of the current task to the Feishu Bitable collection results table.
Call
```
feishu-bitable-task-manager
```
to update the fields of this
```
TaskID
```
:
```
Status
```
->
```
success/failed/error
```
(based on task execution result),
```
EndAt
```
->
```
now
```

Notes and Troubleshooting

Inaccurate clicks: Take a new screenshot to let ai-vision provide more precise coordinates (do not switch to
```
dump-ui
```
).
Abnormal processes (pop-up blockage or step stuck): First identify and close the pop-up, then continue with the original step. See
```
references/commands.md
```
for processing commands.
Task timeout limit: If the execution time of a single task exceeds 30 minutes, terminate execution and update the task status to failed.

wechat-search-collector

NPX Install

Tags

SKILL.md Content (Chinese)

WeChat Channels Search

Agreements

Preprocessing

Shared Subprocess: Scroll Results to Bottom (Check every 5 swipes)

Comprehensive Page Search Process

1. Task Parameter Validation

2. Launch WeChat

3. Enter Discover -> WeChat Channels

4. Enter Search Interface

5. Enter Keywords in Sequence and Trigger Search

6. Scroll Results to Bottom and Switch to Next Keyword

7. Scene Post-Processing

Personal Page Search Process

1. Task Parameter Validation

2. Launch WeChat

3. Enter Discover -> WeChat Channels

4. Enter Search Interface

5. Search Account and Enter Personal Page

6. Search Keywords in Sequence on Personal Page

7. Scene Post-Processing

Post-Task Cleanup Logic

Notes and Troubleshooting