Nodes/Tikpan Official Nodes/工具|最近异步任务列表
ComfyUI Node

工具|最近异步任务列表

What happened to my async jobs? Ask the task list instead of guessing

By htrert·Created 5 months ago·Updated 2 months ago· 1
工具|最近异步任务列表
    • Tasks_JSON
    Limit20

    This is the boring-but-life-saving node in the async engine: it dumps the metadata of your recent background tasks as JSON so you can see what ran, what's still queued, and what died and why. TikpanAsyncTaskListNode is the debugging window for TikpanAsyncImageSubmitNode - the place you look when a job went sideways and the Submit node has already forgotten about it.

    It comes from ComfyUI-Tikpan-Pro, the official plugin for the Tikpan.com API aggregator. Like the rest of the async family, it talks to a local in-process task table (with JSON backups on disk), not to Tikpan's servers. It's pure bookkeeping, and it's genuinely useful for reconnecting after a restart or a crash.

    How it works

    Every async task - submit, query, join - records its state in a shared task table kept in the ComfyUI process, and mirrors each record to output/TikpanAsync/<task_id>.json. The table prunes old finished jobs to keep itself bounded (300 entries by default, tunable with the TIKPAN_ASYNC_TASK_RETENTION env var). This node reads the most recent Limit tasks and serializes them to JSON: status, stage, progress, timestamps, the payload that was submitted, error messages, and the resulting image paths.

    So the classic use is: your workflow errored or you restarted ComfyUI, you still have a Task_ID (or you don't), and you want to know whether the job finished and where the files went. This node answers that. The on-disk JSON is also exactly what a disconnected TikpanAsyncImageResultNode reads when it looks a task up by ID.

    The one input

    • Limit - how many recent tasks to return, 1 to 200, default 20. That's it. There are no other knobs, which is refreshing.

    Output

    Just one: Tasks_JSON, a STRING holding the pretty-printed array of task records. It's a string, not a structured object, so you can't wire it into a JSON-parsing node's dict input directly - you'll want to view it in a text node or string-display widget, then eyeball it. For a headless setup you can also read output/TikpanAsync/*.json straight from disk, which is the same data.

    Install

    Bundled with the pack:

    cd ComfyUI/custom_nodes
    git clone https://github.com/htrert/ComfyUI-Tikpan-Pro
    

    or use ComfyUI Manager (search Tikpan) and restart. No new dependencies.

    Gotchas

    Keep the retention limit in mind: this node only shows tasks still in the table, and finished tasks get trimmed as new ones arrive - if a job vanished from the list, it was pruned, not lost mysteriously (the JSON files in the output folder may outlive the table). And the standing caveat for this whole pack: it's an obscure API-wrapper plugin with almost no community discussion behind it, so when something errors here, the JSON log is your only real documentation. Read it before you assume the node is broken.

    Category👑 Tikpan 官方独家节点/06 任务与并发 Tools/异步任务池 Async Engine

    Inputs (1)

    NameTypeDefaultDescription
    LimitINT201–200返回最近 N 个任务

    Outputs (1)

    NameTypeDescription
    Tasks_JSONSTRING