优化PhpStorm对Laravel自定义查询构建器的代码智能提示

<?php

namespace App\Models;

use Illuminate\Database\Eloquent\Model;
use App\Builders\MyModelQueryBuilder; // 假设你的构建器在这个命名空间

class MyModel extends Model
{
    // ... 其他模型属性和方法

    /**
     * 创建一个新的Eloquent查询构建器实例
     *
     * @param  \Illuminate\Database\Query\Builder  $query
     * @return MyModelQueryBuilder
     */
    public function newEloquentBuilder($query): MyModelQueryBuilder
    {
        return new MyModelQueryBuilder($query);
    }
}

<?php

namespace App\Builders;

use Illuminate\Database\Eloquent\Builder;

class MyModelQueryBuilder extends Builder
{
    /**
     * 示例自定义查询方法：根据状态过滤
     *
     * @param string $status
     * @return $this
     */
    public function whereStatus(string $status): self
    {
        return $this->where('status', $status);
    }

    /**
     * 示例自定义查询方法：获取活跃用户
     *
     * @return $this
     */
    public function active(): self
    {
        return $this->where('is_active', true);
    }
}

<?php

namespace App\Models;

use Illuminate\Database\Eloquent\Model;
use App\Builders\MyModelQueryBuilder;

/**
 * @mixin MyModelQueryBuilder // 关键指令
 */
class MyModel extends Model
{
    // ... (newEloquentBuilder 方法和其他内容不变)
    public function newEloquentBuilder($query): MyModelQueryBuilder
    {
        return new MyModelQueryBuilder($query);
    }
}

<?php

namespace App\Traits;

use App\Builders\MyModelQueryBuilder; // 确保引入自定义构建器
use Illuminate\Database\Eloquent\Builder as EloquentBuilder;

/**
 * @mixin MyModelQueryBuilder // 将 @mixin 放在 Trait 的 PHPDoc 中
 */
trait HasCustomBuilder
{
    /**
     * 创建一个新的Eloquent查询构建器实例
     *
     * @param  \Illuminate\Database\Query\Builder  $query
     * @return MyModelQueryBuilder
     */
    public function newEloquentBuilder($query): MyModelQueryBuilder
    {
        return new MyModelQueryBuilder($query);
    }
}

<?php

namespace App\Models;

use Illuminate\Database\Eloquent\Model;
use App\Traits\HasCustomBuilder; // 引入 Trait
use App\Builders\MyModelQueryBuilder; // 建议也引入，以便PhpStorm更明确地识别类型

/**
 * @mixin MyModelQueryBuilder // Trait 已经包含了此指令，这里可以省略，但为了明确性也可以保留
 */
class MyModel extends Model
{
    use HasCustomBuilder; // 使用 Trait

    // ... 其他模型内容
}