Colibri 入门：在磁盘、内存与显存之间加载 MoE 专家
阅读 Colibri pip 入口：为什么找不到 c/coli
先检查打包布局和启动路径，再进入推理内核排错。
阅读 Colibri pip 入口：为什么找不到 c/coli知识学习CN编辑简报更新 2026-09-23
你将学会
- 追踪目录计算
- 理解进程内委托
- 限定验证范围
开始前需要
- 基本 Python 与命令行知识
- 明确的硬件与存储清单
先建立可复现记录，再尝试新的推理优化。
先看结论
- 包装器依赖相邻目录。
- runpy 在当前进程执行。
- 本文没有运行模型。
追踪目录计算
colibri/cli.py 获取自身绝对目录，向上一层后拼接 c/coli。脚本不存在时，main 会退出并提示找不到引擎目录，以及从源码安装的建议。
这是相对布局约定。Python 包可以导入，不代表相邻引擎目录已经包含或在移动时保留；重复下载权重前，应先检查安装包与 c 目录的实际位置。
理解进程内委托
脚本存在后，包装器将引擎目录加到 sys.path 前面，设置 sys.argv[0]，再用 runpy.run_path 和 __main__ 执行启动器。这个函数没有创建子进程。
其余参数留给启动器处理子命令。委托后的错误可能来自启动脚本或后续引擎，不能仅凭这个包装器判断具体的模型格式问题。
限定验证范围
本篇逐行阅读小型入口，没有实际执行 pip 安装或推理。下面展示预期目录关系，不代表已经在本机部署并验证了对应引擎。
可进一步在独立环境用无害假启动器测试缺失文件和成功委托，但这是建议的打包测试。采用前仍应审阅包安装流程，不把练习设想写成已有成绩。
如何选择
| 比较维度 | 方案 A | 方案 B |
|---|---|---|
| Best when | You need predictable behavior and easy auditing | You need adaptive optimization and have reliable telemetry |
| Main risk | May leave performance on the table | Can become difficult to explain or debug |
实施步骤
- 1
定位已安装 Python 包。
- 2
检查相邻 c/coli 布局。
- 3
区分委托前后错误。
可复制示例
text
installation-root/
colibri/cli.py
c/coli
c/<匹配的引擎和辅助文件>常见问题
这个函数会启动子进程吗？
不会，所检查的包装器使用进程内 runpy.run_path。
找不到 c/coli 就要重新下载权重吗？
应先检查包布局，错误发生在包装器委托模型处理之前。
资料来源
- Colibri / colibri/cli.py来源核查 2026-09-23