终端速查与代码示例检索

要解决什么问题

写脚本或查 CLI 时，你往往只记得「大概有个 API」，却懒得打开浏览器翻官方文档；反过来，在终端里 man 或 --help 能说明参数，却很少给出「怎么读文件」「Flask 路由怎么写」这类可直接对照的片段。本技能把 cheat.sh 风格的示例检索 接到对话/工作流里：用自然语言或固定触发词发起查询，按语言、框架或工具缩小范围，把匹配的代码块和简短说明返回给你，必要时还能落成 Markdown 备忘。

怎么工作

核心能力可以概括为几条：

• 按关键词查示例：例如 python 文件读取、docker logs，支持部分关键词的模糊匹配。
• 领域过滤：用 语言:框架 限定范围，如 python:flask 路由，避免结果漂到别的生态。
• 可选参数：--lang / --tool 指定语言或工具；--random 随机一条；--export md 把结果写到当前目录（默认类似 cheat_.md 命名）。
• 输出规范：结果带示例标题、语言标识和 Markdown 代码块，方便复制。

典型流程是：确认网络可用 → 输入 cheat.sh 加查询词（可加 语言:框架）→ 查看终端输出 → 需要留存时加 --export md。信息不足时不会瞎编，可能标 [需核实:语言] 等占位并建议查官方文档；网络失败等有对应错误码（如 E001、E002）。

边界与注意

• 不执行代码，只返回示例文本；不保证片段在你当前版本/环境下可直接运行。
• 不提供完整项目脚手架，也不能离线查库，必须能连上远程示例源。
• 查询别太宽（只写 python 往往不够），框架类问题尽量带上 python:flask 这类前缀；复制示例前先看版本与依赖，速查不能替代官方文档。