Vibe Coding 法器体系说明
本文说明法器总表的对象边界、重要性分级和维护入口；具体来源事实与逐条分组以登记源和生成总表为准。
一句话
法器总表整理 Vibe Coding 流程中使用或依赖的工具、可调用入口及依赖类别，帮助读者理解它们在工作流中的位置。品级按对 Vibe Coding 的重要性暂定，不代表工具质量、运行可用性或任务效果。
字多不看
- 方法和能力要求归功法；工具、软件入口及依赖类别按其真实所指另行整理，不因出现在同一依赖图就变成同一种对象。
- 当前 30 项按重要性分为天阶 4 项、地阶 12 项、玄阶 9 项、黄阶 5 项；品级、名称、重要性范围与分级依据见法器浏览表，完整登记见法器登记源。
- 天阶强调模型推理与 Agent 协作；地阶强调代码操作、工具执行和运行基础；玄阶强调上下文、验证、复用与产品交付；黄阶强调可替代的专用或便利能力。
- 每阶高级、中级、初级表示该阶内的重要性次序，不是测试结果带或效能等级。
- 当前重要性分级与正式任务效果评级是两条独立轴；正式效能量表仍为 draft，阈值尚未校准。
对象边界
“法器”是本项目用于组织 Vibe Coding 工具与依赖能力的领域称呼，不等同于某个统一产品类别。登记必须按具体所指区分程序内容、当前运行实例、模型制品、服务/API、硬件资源、候选对象和抽象依赖类别。
总表中的不同记录不能仅凭名称、依赖图位置或功能相似而合并：
- 来源限定实现：绑定选定的仓内来源和代码内容，不自动代表本机运行版本。
- 运行实例或具名候选：记录实际观察到的入口，或依赖图中指向的候选；候选身份、版本和来源可能仍待核。
- 依赖类别：例如模型服务、CI 平台、终端接口或检索记忆。用户确认类别纳入范围，不等于确认了某个产品、部署、账号或可用实现。
- 外部资源行：索引原资源记录，不等同于一件独立法器，也不单独证明能力、许可或运行效果。
法器不替代功法、任务合同或权限。建议使用某种工具，不代表它是唯一依赖、已获授权或已通过验证；执行一个过程也不自动证明预期效果。
重要性分级
本次排序面向一般 Vibe Coding 工作流，综合考虑条目在核心闭环中的作用、对代码执行和验证的支撑程度、适用范围及可替代性。分级是用户确认的导航性判断，并非从版本新旧、依赖图深度、代码规模或烟测结果计算出来的分数。
| 品级方向 | 重要性含义 | 常见角色 |
|---|---|---|
| 天阶 | 决定核心 AI 协作链能否成立 | 模型推理、Agent 运行与编排 |
| 地阶 | 支撑代码真正被操作、运行和管理 | 终端命令、PTY、版本控制、语言与运行环境 |
| 玄阶 | 扩展复杂任务的上下文、质量和交付范围 | 检索记忆、自动验证、技能复用、部署与数据集成 |
| 黄阶 | 对特定工作方式有帮助，但通常存在替代路径 | 多会话终端、专用适配与格式转换 |
同阶内按高级、中级、初级表示重要性由高到低。等级只表示相对工作流位置：某项黄阶工具仍可能是某个具体任务的必要条件；高阶条目也不因此成为质量更好或已经可用的产品。
浏览表列品级、名称、重要性范围和分级依据；当前明细及每项完整登记以登记源为准。登记中的 10 项来源限定实现、13 条本地路径记录、12 项依赖图具名对象/运行观察和 8 项用户确认的依赖类别属于不同计数视角；依赖图另有 9 条本地关联，只表达关系、不重复计作对象；本地范围排除另有 9 条。158 条外部资源行也不等同于 158 件法器。
重要性与效能评级
| 维度 | 回答的问题 | 当前状态 |
|---|---|---|
| 重要性分级 | 该工具或类别在 Vibe Coding 工作流中有多关键、可由什么替代？ | 已按用户要求形成暂定排序，见法器总表。 |
| 正式效能评级 | 某一固定实现、版本和任务环境是否达到明确效果合同？ | 量表仍为 draft；任务合同、基线和阈值未校准，当前没有正式效能结论。 |
来源审查、版本观察、静态阅读或单次烟测都不能替代固定任务合同和可复核的效果证据。登记状态也不等于独立审查、运行验证、许可证批准或安全授权。正式效能规约及证据条件见统一本体中的法器品级规约。
选用流程
- 先定义要完成的任务、验收条件、环境和权限边界，不从最高品级反推工具选择。
- 从总表识别可能的工具或依赖类别，再核实具体实现、来源、版本和可用性；抽象类别不能直接当成已安装产品。
- 检查数据、网络、外部副作用、许可和恢复方式。类别纳入或版本观察不构成批准。
- 在适用任务中运行有界验证，保留成功与失败证据；验证范围不得超过实际测试的输入和环境。
- 若要提出正式效能评级，另按固定任务合同、合理基线、校准阈值和可复核结果评定，不沿用本页的重要性分组。
登记与维护
- 法器登记源是唯一可编辑总登记；字段边界见Schema。
- 法器浏览表由登记源生成，仅列品级、名称和解释；解释展示重要性范围与分级依据，完整字段以法器登记源及各来源所有者的数据为准，不手工编辑。
- 外部资源的原始名称、地址、状态和风险仍由外部资源登记维护。
- 正文类型及正式效能规约以修仙领域统一本体为准；本页不另建分类树或实现身份库。
更新登记或生成视图时使用：
make sync-faqi-catalog
make check-faqi-catalog
make test-faqi-catalog