Method checkIn

packages/core/src/ECS/Utils/IdentifierPool.ts:147–176

* 回收一个ID * * 验证ID的有效性后，将其加入延迟回收队列。 * ID不会立即可重用，而是在延迟时间后才真正回收。 * * @param id 要回收的实体ID * @returns 是否成功回收（ID是否有效且未被重复回收）

(id: number)

     * @returns 是否成功回收（ID是否有效且未被重复回收）
     */
    public checkIn(id: number): boolean {
        const index = this._unpackIndex(id);
        const generation = this._unpackGeneration(id);

        // 验证ID有效性
        if (!this._isValidId(index, generation)) {
            return false;
        }

        // 检查是否已经在待回收队列中
        const alreadyPending = this._pendingRecycle.some(
            (item) => item.index === index && item.generation === generation
        );

        if (alreadyPending) {
            return false; // 已经在回收队列中，拒绝重复回收
        }

        // 加入延迟回收队列
        this._pendingRecycle.push({
            index,
            generation,
            timestamp: Date.now()
        });

        this._stats.currentActive--;
        this._stats.totalRecycled++;

        return true;
    }

    /**
     * 验证ID是否有效