Fable 5 CLI 使用指南：从装好到干活

先说结论：任务跨文件时，命令行的收益最大

如果只是问一个问题，网页版更省事；当任务需要在仓库里跨文件修改、跑测试、反复迭代时，命令行工具能直接读取项目上下文并执行命令，减少来回复制粘贴。

代价是它对环境更敏感：版本、权限、目录、网络任一项不对，都会以报错的形式阻塞你。所以先花十分钟把环境准备好，比事后排查更省时间。

安装与登录要准备什么

按顺序完成，避免装完才发现缺权限。

1. 1确认运行环境：安装目标运行环境并检查版本号，避免版本过低导致命令不可用。
2. 2确认安装来源：只使用官方文档给出的安装方式，不要执行来源不明的安装脚本。
3. 3确认登录方式：准备好登录所需的账号与凭证，必要时提前开启二次验证。
4. 4确认目录权限：在你实际要改的项目目录里操作，而不是在系统目录里试命令。
5. 5确认网络可用：公司网络与代理环境可能拦截请求，先做一次最小连通测试。

日常最常用的几类命令

不需要背命令表，先掌握下面几类即可覆盖绝大多数场景。

1. 1启动会话：在项目根目录启动，让它自动读取上下文。
2. 2交代任务：用一句话说明目标，并给出完成标准。
3. 3查看改动：动手前先让它列出计划改动的文件，避免误改。
4. 4执行验证：让它自己跑测试或构建，而不是只看它说「已完成」。
5. 5回退改动：改动不理想时按版本控制回滚，不要靠手工逐行删。

项目级配置：让它在你的仓库里干活

把项目约定写进仓库内的说明文件，工具每次进入目录时都会参考，效果比每次口头重复更好。至少要写清：用哪个包管理器、怎么装依赖、怎么跑测试、哪些目录不要动。

如果团队多人使用，把这些约定提交到版本库，可以避免每个人的使用方式不一致，也减少新人上手成本。

常见报错与排查顺序

遇到报错时按这个顺序查，能过滤掉大部分环境问题。

1. 1先看错误类型：是认证失败、网络超时，还是命令不存在。
2. 2认证问题：检查凭证是否过期、是否需要重新登录。
3. 3网络问题：确认代理与防火墙设置，换网络再试一次。
4. 4命令不存在：确认安装路径是否在环境变量中，重开终端后再试。
5. 5权限问题：确认当前目录与文件是否可写，避免在无权限目录操作。

额度和成本怎么盯

命令行工具同样消耗额度。跨文件任务、反复执行和多轮迭代会明显推高用量，长任务建议拆成几段，每段完成后确认结果再继续。

定期查看用量记录，如果发现单位时间内消耗异常，先检查是否有后台任务或异常请求，而不是直接加大额度。

还有一个容易忽略的点：把命令行任务和日常聊天混在同一个账号里时，很难判断到底是谁在消耗额度。分开使用或分开记录，排查会轻松很多。