简介：本教程面向开发者、运维人员与技术负责人，系统拆解命令行 AI 编程助手的十个高价值隐藏功能：会话恢复、上下文压缩、代码回滚、图片解析、外部工具联动、项目记忆、自动化钩子、技能文档、子代理与插件扩展。每个功能均按“作用—操作—注意点”展开，并附验证方法与排查思路，帮助你把 AI 编程助手从“问答工具”升级为覆盖开发全流程的效率搭档。
许多开发者已经在终端中使用 AI 编程助手生成代码、修复缺陷、重构模块，但多数使用仍停留在“输入问题—接收答案”的浅层交互。事实上，这类命令行 AI 编程工具普遍内置了一批不常被提及、却对日常效率影响很大的能力。本教程将带你逐一实操这十个隐藏玩法，学完后你应当能够：
在开始之前，请确认以下条件已经满足：
/help，都能查看当前版本支持的全部指令与简要说明，这是确认“某个功能怎么用”的第一入口，后续排查问题时也应最先使用它。做什么：重新进入工具时，在启动命令后追加续接参数（常见为 -c）即可直接接续最近一次对话；如果需要找回更早的会话，在交互界面输入 /resume，从历史会话列表中选择目标记录即可。
为什么：真实开发中，一次需求往往跨越数天、多个终端窗口。如果不掌握会话恢复，每次都要重新交代背景、目标与约束，沟通成本极高。
注意什么：会话记录通常与项目目录绑定，请回到原项目目录再启动；本地会话数据被手动清理后无法找回，重要结论建议同时落盘到文件。
做什么：当对话变长、响应明显变慢时，输入 /compact 对当前上下文进行压缩，工具会保留关键结论、裁剪冗余细节；如需彻底重来，使用 /clear 清空全部上下文。
为什么：上下文体积直接影响响应速度、信息密度与资源消耗。长会话中早期大量试错过程，往往会稀释 AI 对当前任务的注意力。
注意什么：/clear 是不可恢复操作，执行前务必确认重要决策已经写入项目记忆文件或文档；日常优先用 /compact，把 /clear 留给“切换到全新任务”的场景。
做什么：当代码被修改到不符合预期的状态时，输入 /rewind 或连按两次 ESC，即可一键回退到之前的代码版本。
为什么：AI 批量重构或大规模修改时，难免出现与预期不符的结果。有了快速回滚，你可以大胆尝试激进方案，而不必担心“改坏了回不去”。
注意什么：回滚能力通常只对纳入版本管理的文件生效，未被跟踪的新文件、临时文件可能无法恢复——这也再次印证了前置准备中“先做版本管理基线提交”的必要性；回滚前最好先用版本管理工具查看当前差异，明确要回到哪个时间点。
做什么：将设计稿截图、界面参考图或报错截图直接拖拽进终端窗口，或使用粘贴快捷键发送给工具，AI 会自动识别图片内容，并按需生成界面代码、定位报错原因。
为什么：界面还原、样式对齐、异常排查是前端与全栈开发中的高频工作。用图片直接沟通，比用文字描述“左边距差 8 像素”高效得多。
注意什么：图片清晰度与完整性直接影响识别效果，建议截取完整界面而非局部碎片；复杂页面可按模块分多次投喂，并在文字中补充“这是登录页顶部导航”之类的上下文说明，识别准确率会显著提升。
做什么：借助模型上下文协议这类业界通用的标准化接入方式，把设计协作工具、文档系统等外部服务接入 AI 编程助手：先在配置中声明要连接的外部服务，完成授权后，AI 即可按需读取设计稿的尺寸、色值、组件结构等资源信息。
为什么：手工对照设计稿逐项抄写数值，是设计还原环节最大的时间消耗。打通外部工具后，“读取设计资源—生成代码—比对差异”可以形成闭环。
注意什么：授权时遵循最小权限原则，只授予读取所需资源的权限；授权凭证要妥善保管，避免提交到代码仓库；接入后建议先用一个简单页面验证链路，再投入真实需求。
做什么：在项目根目录执行 /init，工具会生成一份项目配置文件，把技术栈、目录结构、代码风格、常用命令等项目规则写入其中。此后每次在该项目下启动会话，AI 都会自动加载这份记忆。
为什么：没有项目记忆时，AI 每次都可能“重新发明”项目约定——比如忽略团队规定的命名风格、用错依赖管理方式。固化到配置文件后，规则对所有会话生效，新成员的使用体验也能与老成员保持一致。
注意什么：建议把这份配置文件纳入版本管理，随代码一起评审与演进；规则要写得具体、可执行，例如“缩进使用 2 个空格、组件采用函数式写法”，避免“代码要规范”这类无法落地的表述。
通用示意结构如下：
# 项目规则（通用示意）技术栈: 前端框架 + 静态类型语言代码风格:缩进: 2 空格命名: 变量驼峰、常量全大写提交信息: 类型前缀 + 简述（如 fix: 修复登录校验）常用命令:测试: 运行单元测试脚本检查: 执行代码规范检查禁区:- 不得直接修改自动生成目录下的文件- 不得引入未评审的新依赖
做什么：在配置文件中声明自动化钩子，例如“AI 每次编辑代码文件之后，自动对该文件执行格式化命令”。钩子配置通常支持按事件类型（编辑后、保存前等）与文件匹配规则定义触发条件。
为什么：格式化、规范检查这类操作如果依赖人工记得去做，迟早出现遗漏。交给钩子自动执行后，代码风格一致性不再依赖个人自觉。
注意什么：钩子命令应当快速、幂等（重复执行结果不变），避免在钩子里挂载耗时任务拖慢每次编辑；涉及网络请求或删除类操作的要格外谨慎，防止自动执行带来副作用。
# 钩子配置（通用示意）事件: 文件编辑后匹配: *.ts, *.js, *.py执行: 调用本机已安装的格式化工具处理该文件失败策略: 输出警告，不中断主流程
做什么：把团队中重复性任务的执行方法写成一份份技能文档，例如“生成规范化提交说明”“按清单检查接口设计”。技能文档与当前会话共享上下文，需要时随时调用触发。
为什么：同一件事（比如写提交说明）反复用自然语言向 AI 解释，输出质量不稳定；固化成技能文档后，执行步骤与输出格式都被约束住，结果可预期、可复制。
注意什么：技能文档要小而聚焦，一个技能解决一类问题；定期回顾并更新，过时的技能及时下线，避免误导。
# 技能文档目录（通用示意）skills/commit-message.md # 规范化提交说明生成api-checklist.md # 接口设计检查清单refactor-steps.md # 安全重构标准步骤
做什么：为代码审核、批量检查这类专项任务创建独立的子代理，让它在单独的上下文中完成任务，并输出结构化结果（如问题清单）。
为什么：如果审核、排查等长流程任务直接在主会话中进行，大量中间信息会挤占主上下文，干扰当前开发任务。子代理执行完毕后只把结论带回主会话，既保持隔离，又不丢结果。
注意什么：给子代理的任务描述要明确边界，例如“只审核本次改动，不修改任何文件”；理解子代理与主会话相互隔离的设计，它需要的信息要主动在任务说明中传递。
做什么：进入工具的插件管理入口，浏览或检索社区插件，一键安装。插件通常把“指令集 + 配置模板 + 技能文档”打包成成套能力，安装后立即生效。
为什么：很多通用场景（如某类框架的开发规范、某类流程的自动化）已有成熟的插件沉淀，不必从零自己配置，可以直接复用社区验证过的实践。
注意什么：安装前确认插件来源可信，查看其请求的权限范围；安装后建议在非关键分支上先试用，确认行为符合预期再推广到团队。
完成上述配置后，可按以下清单逐项验证：
/resume 列表中能看到历史会话并可正常切换；/compact 后，对话仍能正确引用此前的关键结论；/clear 后界面提示上下文已清空；/rewind 后用版本管理工具对比，文件内容回到目标状态；/clear 后丢失重要上下文：这是设计内行为。可检查此前是否有导出的文档或提交记录作为补救；长期方案是把关键结论及时写入项目记忆文件。任何时候，先输入 /help 确认当前版本是否支持对应指令，再对照本文逐项排查，可以少走很多弯路。
/compact 归纳结论，再进入下一阶段，兼顾速度与连续性；本教程围绕命令行 AI 编程助手的十个隐藏玩法，完成了从“会话管理—安全兜底—多模态与外部联动—项目定制—自动化与扩展”的完整进阶路径。核心要点可以浓缩为三句话：用会话恢复与上下文压缩管好“记忆”；用版本回滚与子代理守住“安全与隔离”；用项目记忆、钩子、技能与插件把重复劳动沉淀为“自动化资产”。建议你按本文顺序在自己最常用的项目上逐项实操一遍，遇到不确定的指令随时用 /help 查询，逐步把这些能力固化成个人与团队的日常工程实践。