Function stackAsyncTask

src/pkg/utils/async_queue.ts:54–76

(key: string, task: TStackFn<T>)

 * 若该队列没有正在执行的任务（!stack.tail），则启动执行
 */
export const stackAsyncTask = <T>(key: string, task: TStackFn<T>): Promise<T> => {
  return new Promise((resolve, reject) => {
    // 获取或初始化对应 key 的队列
    const stack: TStack<T> = stacks[key] || (stacks[key] = { head: null, tail: null });
    const newNode: TNode<T> = { task, resolve, reject, next: null };

    // 入队逻辑
    if (!stack.tail) {
      // 队列为空时，设为首尾节点
      stack.head = newNode;
      stack.tail = newNode;

      // ⚠️ 注意：此时会启动任务执行
      // 请勿在外部代码中同时多次调用 startAsync
      // 当前逻辑依赖 “!stack.tail” 判断来避免并发执行
      startAsync<T>(stack);
    } else {
      // 队列不为空时，追加到尾部
      stack.tail.next = newNode;
      stack.tail = newNode;
    }
  });
};