开发工具CLI【免费下载链接】howdoiinstant coding answers via the command line项目地址https://gitcode.com/gh_mirrors/ho/howdoi点击查看免费下载howdoi 是一个开源的命令行工具让你在终端里直接输入自然语言问题如 format date bash就能从 Stack Overflow 等站点抓取并返回答案代码片段省去打开浏览器反复搜索的环节。本篇指南以docs/introduction.md为骨架结合仓库源码howdoi/howdoi.py、测试test_howdoi.py与打包配置setup.py完整讲解安装方式、命令行参数、环境变量、stash 收藏功能以及底层实现原理读完后你可以立即把它配置进自己的工作流。howdoi 是什么howdoi 面向所有遇到基础编程问题就想去 Google 一下的开发者。与其打开浏览器、翻阅博客还容易分心不如留在控制台里直接提问$ howdoi format date bash DATEdate %Y-%m-%d它支持各种各样的查询$ howdoi print stack trace python import traceback try: 1/0 except: print traceback traceback.print_exc() print end of traceback $ howdoi convert mp4 to animated gif video/path/to/video.avi outdir/path/to/output.gif mplayer $video \ -ao null \ -ss 00:01:00 \ # starting point -endpos 10 \ # duration in second -vo gif89a:fps13:output$outdir \ -vf scale240:180 $ howdoi create tar archive tar -cf backup.tar --exclude www/subf3 www从源码角度看工具的核心逻辑集中在 howdoi/howdoi.py 这一个文件中命令行参数通过argparse解析问题通过搜索引擎检索 Stack Overflow 链接再用 pyquery 解析答案页面、提取最高票回答中的代码块pre/code最终输出到终端。入口由 setup.py 中的console_scripts声明为howdoi howdoi.howdoi:command_line_runner安装后即可获得全局howdoi命令。安装 howdoi环境要求需要pipPython 3.7 及以上版本Python 2.7 支持已停止当前仓库版本号为 2.0.20见 howdoi/init.py其打包配置在 setup.py 中声明了 Pygments、requests、pyquery、cachelib、appdirs、keep、rich、colorama 等运行依赖这些依赖也会随pip install一并安装。方式一PyPI 安装pip install howdoi方式二直接从 Git 仓库安装pip install githttps://github.com/gleitz/howdoi.git#egghowdoi方式三基于 setuptools 安装源码安装如果你希望使用 setuptools 从本地源码安装可以在克隆本仓库后执行python setup.py install另外macOS 用户还可以通过 Homebrew 安装见 README.mdbrew install howdoi如果你还没有安装 pip可参考 pip 官方安装教程https://pip.pypa.io/en/stable/installing/。快速上手第一个问题安装完成后直接运行howdoi howdoi这是一个特殊的帮助型查询源码中的SUPPORTED_HELP_QUERIEShowdoi/howdoi.py会把howdoi howdoi、use howdoi、run howdoi、setup howdoi、do howdoi等写法识别为帮助请求返回常用命令示例对应_get_help_instructions函数。想要查看完整的命令帮助与参数说明howdoi -h命令参数详解howdoi 的完整用法如下同 docs/usage.mdusage: howdoi [-h] [-p POS] [-n NUM] [-a] [-l] [-c] [-x] [-C] [-j] [-v] [-e [ENGINE]] [--save] [--view] [--remove] [--empty] [QUERY ...] instant coding answers via the command line positional arguments: QUERY the question to answer optional arguments: -h, --help show this help message and exit -p POS, --pos POS select answer in specified position (default: 1) -n NUM, --num NUM number of answers to return (default: 1) -a, --all display the full text of the answer -l, --link display only the answer link -c, --color enable colorized output -x, --explain explain how answer was chosen -C, --clear-cache clear the cache -j, --json return answers in raw json format -v, --version display the current version of howdoi -e [ENGINE], --engine [ENGINE] search engine for this query (google, bing, duckduckgo) --save, --stash stash a howdoi answer --view view your stash --remove remove an entry in your stash --empty empty your stash常用参数实战-p POS选择第几个答案默认取搜索结果中的第 1 个答案。测试test_positiontest_howdoi.py验证了-p5与默认结果不同。-n NUM一次返回多个答案howdoi format date bash -n 3返回 3 个答案答案之间用分隔线隔开对应build_splitter生成的分隔线。-a输出完整回答默认只提取回答中的代码块加-a会输出整个回答正文对应_get_answer中对args[all]的分支处理。-l只显示答案链接便于你复制链接到浏览器查看原始讨论。-c启用语法高亮_format_outputhowdoi/howdoi.py会先用 Pygments 根据 Stack Overflow 标签或查询词尝试匹配 lexer匹配不到时用guess_lexer猜测语言再通过 rich 输出彩色代码。-j输出原始 JSON_format_answers会把结果序列化为 JSON字段包含answer、link、position见_get_answer_worker的返回结构方便脚本化使用。测试test_json_output验证了 JSON 字段与文本输出的等价性。-x解释答案如何被选中开启后日志级别被提升为 INFO会打印查询词、使用的搜索引擎、命中的链接列表等调试信息。-e指定搜索引擎支持google、bing、duckduckgo三者之一仅对当前这条查询生效。-C清空缓存_clear_cache会调用 cachelib 的cache.clear()并打印Cache cleared successfully。值得注意的是-p和-n的取值被限制在 1~20 的整数范围内超出会直接报参数错误见IntRange校验类相关边界情况在测试中有对应用例。环境变量howdoi 支持通过环境变量进行全局配置常用变量如下同样见howdoi -h输出的 epilog 部分以及 docs/howdoi_advanced_usage.md环境变量作用默认值HOWDOI_COLORIZE1始终启用彩色输出关闭等价于自动加-cHOWDOI_DISABLE_CACHE1禁用缓存功能启用缓存HOWDOI_DISABLE_SSL1关闭 SSL 证书校验并使用 HTTP 协议使用 HTTPSHOWDOI_SEARCH_ENGINEgoogle切换默认搜索引擎google另支持bing、duckduckgoHOWDOI_URLserverfault.com切换答案来源站点stackoverflow.com底层行为说明源码级SSL 开关模块加载时即读取HOWDOI_DISABLE_SSLhowdoi/howdoi.py决定全局的SCHEME与VERIFY_SSL_CERTIFICATE。当请求遇到 SSL 错误时日志会提示Try using HTTP instead of HTTPS by setting the environment variable HOWDOI_DISABLE_SSL。缓存机制默认使用 cachelib 的FileSystemCache缓存目录由appdirs.user_cache_dir(howdoi)决定Linux 下通常为~/.cache/howdoi最多缓存 128 个条目设置了HOWDOI_DISABLE_CACHE时替换为NullCache相当于永远失效的空缓存。查询关键词和答案页面都会被缓存命中时输出日志 Using cached response (add -C to clear the cache)。搜索引擎切换HOWDOI_SEARCH_ENGINE指定后_get_links会使用对应引擎的搜索 URL 模板SEARCH_URLS包含 google / bing / duckduckgo 三种构造site:{URL}%20{query}形式的检索请求。若某个引擎临时屏蔽了请求检测到验证码等BLOCK_INDICATORShowdoi 会自动尝试下一个可用引擎见howdoi主函数中的BlockError处理逻辑。来源站点切换HOWDOI_URL的值会被拼进site:搜索语法同时用于过滤_extract_links_from_google匹配到的链接域名因此可以切换到serverfault.com、pt.stackoverflow.com等其他 StackExchange 站点。stash 收藏功能保存常用答案如果你不想反复执行相同查询howdoi 提供了 stash 收藏功能基于keep库实现依赖声明见 requirements/common.txt 中的keep2.9收藏答案howdoi --save QUERY查看收藏howdoi --view删除某条收藏howdoi --remove会交互式提示选择要删除的条目清空全部收藏howdoi --empty清空前会要求确认从源码看_stash_save通过keep_utils.save_command把答案 查询保存下来查询参数剔除 stash 相关开关作为键回答文本作为值查看时按序号排版输出。--empty则直接执行keep init重置收藏库。用 alias 打造自己的快捷方式如果你每次都想带同一组参数可以在.bash_profile或对应 shell 配置中定义别名。下面的例子让每次查询默认返回 5 个彩色答案alias hfunction hdi(){ howdoi $* -c -n 5; }; hdi然后直接使用$ h format date bash还可以把其他 StackExchange 站点做成快捷方式例如查询美食问答站alias hcookfunction hcook(){ HOWDOI_URLcooking.stackexchange.com howdoi $* ; }; hcook hcook make pesto另一个实用技巧是把彩色输出交给less分页查看alias hlessfunction hdi(){ howdoi $* -c | less --raw-control-chars --quit-if-one-screen --no-init; }; hdi工作原理从问题到答案的调用链结合 howdoi/howdoi.py 可以完整还原一条查询的执行链路参数解析command_line_runner解析命令行参数版本、清缓存、stash 等开关优先处理随后把参数交给howdoi()主函数howdoi()内部会再次解析字符串形式的查询这意味着它也支持以编程方式被调用。搜索链接_get_links_with_cache先查缓存未命中则调用_get_links按所选搜索引擎构造搜索 URL用随机 User-Agent 发起请求USER_AGENTS列表中随机挑选模拟不同浏览器。若结果命中验证码特征字符串BLOCK_INDICATORS抛出BlockError并自动换引擎重试。筛选问题页_get_questions用正则questions/\d/过滤出 Stack Overflow 问题链接并排除webcache.googleusercontent.com这类缓存页。抓取答案_get_answer对每个链接请求?answertabvotes页面用 pyquery 定位第一个.answercell兜底.answer提取其中的pre/code代码块若回答中没有代码块且未加-a则退化为返回整个回答正文正文为空时输出 no answer given 。并发取多个答案_get_answers使用multiprocessing.Pool并行抓取多个问题页最终按位置排序、用分隔线拼接输出或输出 JSON / 纯链接。错误兜底网络异常时提示Unable to reach {engine}. Do you need to use a proxy?完全无结果时输出Sorry, couldnt find any help with that topic并提示可用--explain查看原因。上述流程在 test_howdoi.py 中有系统性的测试覆盖测试通过 mock_get_result读取仓库page_cache/目录下的 gzip HTML 快照如format date bash、print stack trace python等因此可以在离线环境下验证查询、-l链接输出、-a全文输出、-jJSON 结构、多答案与彩色输出等行为。仓库的page_cache/目录正是这些测试所用的缓存页面样本。周边集成与扩展howdoi 提供了丰富的生态集成方式社区中已有 Slack、Telegram、Discord、Emacs、Alfred 等集成方案见 README.md。本仓库内还包含官方维护的编辑器集成代码extension/vscode-howdoiVS Code 扩展源码与说明支持在编辑器中直接查询 howdoi 并插入答案extension/code-editor-integration通用的代码编辑器集成插件TypeScript 实现其中 plugin.ts 提供了与编辑器命令系统对接的插件逻辑并带有完整的单元测试plugin.test.ts。这意味着你可以把终端问答能力进一步嵌入日常编码环境在编辑器内完成提问—取答案—插入代码的闭环。常见问题与注意事项搜索引擎被临时屏蔽Google / Bing 等搜索引擎可能对频繁请求返回验证码页面。howdoi 会检测到BLOCK_INDICATORS并自动切换到下一个可用引擎若所有引擎都被屏蔽会提示无法从任何搜索引擎获取响应。也可以手动用-e duckduckgo或HOWDOI_SEARCH_ENGINEduckduckgo切换到更宽松的引擎。SSL 报错网络环境存在中间代理时可能遇到 SSL 错误可设置HOWDOI_DISABLE_SSL1改用 HTTP。缓存问题如果怀疑结果过期用-C清空缓存或设置HOWDOI_DISABLE_CACHE1完全禁用。结果不满意用-p 2、-p 3翻看后续位置的答案用-n一次查看更多候选用-a查看完整上下文说明。隐私与依赖howdoi 会向搜索引擎与目标问答站点发起网络请求查询内容会经搜索引擎转发请勿在受管控环境中提交敏感代码片段。更多细节可继续阅读仓库中的 docs/usage.md、docs/howdoi_advanced_usage.md 和 docs/troubleshooting.md若想参与贡献可参考 docs/contributing_to_howdoi.md。赞分享开发工具CLI【免费下载链接】howdoiinstant coding answers via the command line项目地址https://gitcode.com/gh_mirrors/ho/howdoi点击查看免费下载相关推荐CANN/ops-math QR分解算子aclnnQr 查看源码 https://link.gitcode.com/i/b7a58a95be5977dcb69cd553181bfef7 产品支持算子库人工智能CANN告别浏览器查答案命令行即时编程神器 howdoi 终极解析告别浏览器查答案命令行即时编程神器 howdoi 终极解析 howdoi 是一款开源命令行编程问答工具 让你在终端里直接输入自然语言问题几秒钟就能拿到来自开发工具CLIGogh 终端配色方案安装与数据指南从一行命令到源码级原理Gogh 终端配色方案安装与数据指南从一行命令到源码级原理 Gogh 是一个面向 Linux 与 macOS以及 Windows 上的 Cygwin/Min开发工具CLI创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考