deepscan-record-list

DeepScan View Scan Record List

All script paths are relative to this Skill directory.

Prerequisites: Requires being logged in and having selected a scan book (refer to deepscan-login, deepscan-task Skill).

Pre-check

Before executing, first confirm that a scan book has been selected:

python ../deepscan-task/scripts/task.py current

• Exit code is 1 → First execute the deepscan-task Skill to select a scan book, then continue.
• Success → Continue querying records.

Query Record List

python scripts/recordlist.py list

Example of a successful return:

{
  "task_id": "019c30a1-...",
  "task_title": "默认扫码本",
  "records": [
    {
      "id": "019cb14d-...",
      "seq_number": "R3",
      "scan_result": "https://qr71.cn/o2eikt/qGkeF3M",
      "scan_type": "qrcode",
      "remark": "",
      "created_at": "2026-03-03 09:26:28",
      "session_id": "019cb14a-...",
      "session_name": "20260303092317扫描列表"
    }
  ],
  "total": 3,
  "has_more": false,
  "next_page_token": ""
}

When displaying to the user, present it in table or list form, including: sequence number (seq_number), scan content (scan_result), time (created_at), batch (session_name).

Optional Parameters

Specify the number of items per page (default 20)

python scripts/recordlist.py list --page-size 10

Pagination (use the next_page_token returned last time)

python scripts/recordlist.py list --page-token "{next_page_token}"

Filter by batch

If you only want to see records of the current batch, first get the current batch ID:

python ../deepscan-session/scripts/session.py current

Then filter:

python scripts/recordlist.py list --session-id "{session_id}"

Display Format Suggestions

After records are returned, inform the user in the following format (displayed as a Markdown table or list):

The scan book "{task_title}" has a total of {total} records:

No.	Scan Content	Time	Batch
R3	https://...	2026-03-03 09:26	20260303...

• If has_more is true, prompt the user "there are more records, you can continue paging to view them".
• If records is an empty list, inform the user "the current scan book has no records yet".

Error Handling

• No scan book selected: Guide the user to execute the deepscan-task Skill to select a scan book.
• Not logged in: Guide the user to execute the deepscan-login Skill to complete login.