[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"similar-tom-doerr--zsh_codex":3,"tool-tom-doerr--zsh_codex":61},[4,18,26,36,44,53],{"id":5,"name":6,"github_repo":7,"description_zh":8,"stars":9,"difficulty_score":10,"last_commit_at":11,"category_tags":12,"status":17},4358,"openclaw","openclaw\u002Fopenclaw","OpenClaw 是一款专为个人打造的本地化 AI 助手，旨在让你在自己的设备上拥有完全可控的智能伙伴。它打破了传统 AI 助手局限于特定网页或应用的束缚，能够直接接入你日常使用的各类通讯渠道，包括微信、WhatsApp、Telegram、Discord、iMessage 等数十种平台。无论你在哪个聊天软件中发送消息，OpenClaw 都能即时响应，甚至支持在 macOS、iOS 和 Android 设备上进行语音交互，并提供实时的画布渲染功能供你操控。\n\n这款工具主要解决了用户对数据隐私、响应速度以及“始终在线”体验的需求。通过将 AI 部署在本地，用户无需依赖云端服务即可享受快速、私密的智能辅助，真正实现了“你的数据，你做主”。其独特的技术亮点在于强大的网关架构，将控制平面与核心助手分离，确保跨平台通信的流畅性与扩展性。\n\nOpenClaw 非常适合希望构建个性化工作流的技术爱好者、开发者，以及注重隐私保护且不愿被单一生态绑定的普通用户。只要具备基础的终端操作能力（支持 macOS、Linux 及 Windows WSL2），即可通过简单的命令行引导完成部署。如果你渴望拥有一个懂你",349277,3,"2026-04-06T06:32:30",[13,14,15,16],"Agent","开发框架","图像","数据工具","ready",{"id":19,"name":20,"github_repo":21,"description_zh":22,"stars":23,"difficulty_score":10,"last_commit_at":24,"category_tags":25,"status":17},3808,"stable-diffusion-webui","AUTOMATIC1111\u002Fstable-diffusion-webui","stable-diffusion-webui 是一个基于 Gradio 构建的网页版操作界面，旨在让用户能够轻松地在本地运行和使用强大的 Stable Diffusion 图像生成模型。它解决了原始模型依赖命令行、操作门槛高且功能分散的痛点，将复杂的 AI 绘图流程整合进一个直观易用的图形化平台。\n\n无论是希望快速上手的普通创作者、需要精细控制画面细节的设计师，还是想要深入探索模型潜力的开发者与研究人员，都能从中获益。其核心亮点在于极高的功能丰富度：不仅支持文生图、图生图、局部重绘（Inpainting）和外绘（Outpainting）等基础模式，还独创了注意力机制调整、提示词矩阵、负向提示词以及“高清修复”等高级功能。此外，它内置了 GFPGAN 和 CodeFormer 等人脸修复工具，支持多种神经网络放大算法，并允许用户通过插件系统无限扩展能力。即使是显存有限的设备，stable-diffusion-webui 也提供了相应的优化选项，让高质量的 AI 艺术创作变得触手可及。",162132,"2026-04-05T11:01:52",[14,15,13],{"id":27,"name":28,"github_repo":29,"description_zh":30,"stars":31,"difficulty_score":32,"last_commit_at":33,"category_tags":34,"status":17},1381,"everything-claude-code","affaan-m\u002Feverything-claude-code","everything-claude-code 是一套专为 AI 编程助手（如 Claude Code、Codex、Cursor 等）打造的高性能优化系统。它不仅仅是一组配置文件，而是一个经过长期实战打磨的完整框架，旨在解决 AI 代理在实际开发中面临的效率低下、记忆丢失、安全隐患及缺乏持续学习能力等核心痛点。\n\n通过引入技能模块化、直觉增强、记忆持久化机制以及内置的安全扫描功能，everything-claude-code 能显著提升 AI 在复杂任务中的表现，帮助开发者构建更稳定、更智能的生产级 AI 代理。其独特的“研究优先”开发理念和针对 Token 消耗的优化策略，使得模型响应更快、成本更低，同时有效防御潜在的攻击向量。\n\n这套工具特别适合软件开发者、AI 研究人员以及希望深度定制 AI 工作流的技术团队使用。无论您是在构建大型代码库，还是需要 AI 协助进行安全审计与自动化测试，everything-claude-code 都能提供强大的底层支持。作为一个曾荣获 Anthropic 黑客大奖的开源项目，它融合了多语言支持与丰富的实战钩子（hooks），让 AI 真正成长为懂上",147882,2,"2026-04-09T11:32:47",[14,13,35],"语言模型",{"id":37,"name":38,"github_repo":39,"description_zh":40,"stars":41,"difficulty_score":32,"last_commit_at":42,"category_tags":43,"status":17},2271,"ComfyUI","Comfy-Org\u002FComfyUI","ComfyUI 是一款功能强大且高度模块化的视觉 AI 引擎，专为设计和执行复杂的 Stable Diffusion 图像生成流程而打造。它摒弃了传统的代码编写模式，采用直观的节点式流程图界面，让用户通过连接不同的功能模块即可构建个性化的生成管线。\n\n这一设计巧妙解决了高级 AI 绘图工作流配置复杂、灵活性不足的痛点。用户无需具备编程背景，也能自由组合模型、调整参数并实时预览效果，轻松实现从基础文生图到多步骤高清修复等各类复杂任务。ComfyUI 拥有极佳的兼容性，不仅支持 Windows、macOS 和 Linux 全平台，还广泛适配 NVIDIA、AMD、Intel 及苹果 Silicon 等多种硬件架构，并率先支持 SDXL、Flux、SD3 等前沿模型。\n\n无论是希望深入探索算法潜力的研究人员和开发者，还是追求极致创作自由度的设计师与资深 AI 绘画爱好者，ComfyUI 都能提供强大的支持。其独特的模块化架构允许社区不断扩展新功能，使其成为当前最灵活、生态最丰富的开源扩散模型工具之一，帮助用户将创意高效转化为现实。",108111,"2026-04-08T11:23:26",[14,15,13],{"id":45,"name":46,"github_repo":47,"description_zh":48,"stars":49,"difficulty_score":32,"last_commit_at":50,"category_tags":51,"status":17},4721,"markitdown","microsoft\u002Fmarkitdown","MarkItDown 是一款由微软 AutoGen 团队打造的轻量级 Python 工具，专为将各类文件高效转换为 Markdown 格式而设计。它支持 PDF、Word、Excel、PPT、图片（含 OCR）、音频（含语音转录）、HTML 乃至 YouTube 链接等多种格式的解析，能够精准提取文档中的标题、列表、表格和链接等关键结构信息。\n\n在人工智能应用日益普及的今天，大语言模型（LLM）虽擅长处理文本，却难以直接读取复杂的二进制办公文档。MarkItDown 恰好解决了这一痛点，它将非结构化或半结构化的文件转化为模型“原生理解”且 Token 效率极高的 Markdown 格式，成为连接本地文件与 AI 分析 pipeline 的理想桥梁。此外，它还提供了 MCP（模型上下文协议）服务器，可无缝集成到 Claude Desktop 等 LLM 应用中。\n\n这款工具特别适合开发者、数据科学家及 AI 研究人员使用，尤其是那些需要构建文档检索增强生成（RAG）系统、进行批量文本分析或希望让 AI 助手直接“阅读”本地文件的用户。虽然生成的内容也具备一定可读性，但其核心优势在于为机器",93400,"2026-04-06T19:52:38",[52,14],"插件",{"id":54,"name":55,"github_repo":56,"description_zh":57,"stars":58,"difficulty_score":10,"last_commit_at":59,"category_tags":60,"status":17},4487,"LLMs-from-scratch","rasbt\u002FLLMs-from-scratch","LLMs-from-scratch 是一个基于 PyTorch 的开源教育项目，旨在引导用户从零开始一步步构建一个类似 ChatGPT 的大型语言模型（LLM）。它不仅是同名技术著作的官方代码库，更提供了一套完整的实践方案，涵盖模型开发、预训练及微调的全过程。\n\n该项目主要解决了大模型领域“黑盒化”的学习痛点。许多开发者虽能调用现成模型，却难以深入理解其内部架构与训练机制。通过亲手编写每一行核心代码，用户能够透彻掌握 Transformer 架构、注意力机制等关键原理，从而真正理解大模型是如何“思考”的。此外，项目还包含了加载大型预训练权重进行微调的代码，帮助用户将理论知识延伸至实际应用。\n\nLLMs-from-scratch 特别适合希望深入底层原理的 AI 开发者、研究人员以及计算机专业的学生。对于不满足于仅使用 API，而是渴望探究模型构建细节的技术人员而言，这是极佳的学习资源。其独特的技术亮点在于“循序渐进”的教学设计：将复杂的系统工程拆解为清晰的步骤，配合详细的图表与示例，让构建一个虽小但功能完备的大模型变得触手可及。无论你是想夯实理论基础，还是为未来研发更大规模的模型做准备",90106,"2026-04-06T11:19:32",[35,15,13,14],{"id":62,"github_repo":63,"name":64,"description_en":65,"description_zh":66,"ai_summary_zh":66,"readme_en":67,"readme_zh":68,"quickstart_zh":69,"use_case_zh":70,"hero_image_url":71,"owner_login":72,"owner_name":73,"owner_avatar_url":74,"owner_bio":75,"owner_company":75,"owner_location":75,"owner_email":76,"owner_twitter":77,"owner_website":78,"owner_url":79,"languages":80,"stars":89,"forks":90,"last_commit_at":91,"license":92,"difficulty_score":32,"env_os":93,"env_gpu":94,"env_ram":94,"env_deps":95,"category_tags":102,"github_topics":103,"view_count":32,"oss_zip_url":75,"oss_zip_packed_at":75,"status":17,"created_at":107,"updated_at":108,"faqs":109,"releases":150},5893,"tom-doerr\u002Fzsh_codex","zsh_codex","This is a ZSH plugin that enables you to use OpenAI's Codex AI in the command line.","zsh_codex 是一款专为命令行打造的智能辅助插件，它让开发者能在终端中直接调用 OpenAI Codex、Google Gemini、Groq 等多种大模型能力。当你输入自然语言注释或变量名时，只需按下快捷键，它就能自动生成对应的 Shell 命令或代码片段，极大提升了编写复杂指令的效率。\n\n这款工具主要解决了用户在记忆繁琐命令参数、构思正则表达式或编写快速脚本时的痛点，将“想做什么”直接转化为“怎么做”，减少了查阅文档和反复试错的时间。它不仅支持主流的云端 AI 服务，还独特地兼容自托管的 Ollama 等本地模型，允许用户通过简单的配置文件灵活切换不同的 AI 后端，兼顾了便利性与数据隐私需求。\n\nzsh_codex 非常适合频繁使用终端的软件开发人员、运维工程师以及数据科学家。对于希望提升命令行操作流畅度、减少机械性输入的极客用户而言，它是一个实用且强大的效率加速器，让命令行交互变得更加智能和人性化。","\u003Ch1 align=\"center\">⌨️ 🦾 Zsh Codex\u003C\u002Fh1>\n\n\u003Cp align=\"center\">\n    AI in the command line.\n\u003C\u002Fp>\n\n\u003Cp align=\"center\">\n    \u003Ca href=\"https:\u002F\u002Fgithub.com\u002Ftom-doerr\u002Fzsh_codex\u002Fstargazers\"\n        >\u003Cimg\n            src=\"https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fstars\u002Ftom-doerr\u002Fzsh_codex?colorA=2c2837&colorB=c9cbff&style=for-the-badge&logo=starship style=flat-square\"\n            alt=\"Repository's starts\"\n    \u002F>\u003C\u002Fa>\n    \u003Ca href=\"https:\u002F\u002Fgithub.com\u002Ftom-doerr\u002Fzsh_codex\u002Fissues\"\n        >\u003Cimg\n            src=\"https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fissues-raw\u002Ftom-doerr\u002Fzsh_codex?colorA=2c2837&colorB=f2cdcd&style=for-the-badge&logo=starship style=flat-square\"\n            alt=\"Issues\"\n    \u002F>\u003C\u002Fa>\n    \u003Ca href=\"https:\u002F\u002Fgithub.com\u002Ftom-doerr\u002Fzsh_codex\u002Fblob\u002Fmain\u002FLICENSE\"\n        >\u003Cimg\n            src=\"https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Flicense\u002Ftom-doerr\u002Fzsh_codex?colorA=2c2837&colorB=b5e8e0&style=for-the-badge&logo=starship style=flat-square\"\n            alt=\"License\"\n    \u002F>\u003Cbr \u002F>\n    \u003Ca href=\"https:\u002F\u002Fgithub.com\u002Ftom-doerr\u002Fzsh_codex\u002Fcommits\u002Fmain\"\n\t\t>\u003Cimg\n\t\t\tsrc=\"https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Flast-commit\u002Ftom-doerr\u002Fzsh_codex\u002Fmain?colorA=2c2837&colorB=ddb6f2&style=for-the-badge&logo=starship style=flat-square\"\n\t\t\talt=\"Latest commit\"\n    \u002F>\u003C\u002Fa>\n    \u003Ca href=\"https:\u002F\u002Fgithub.com\u002Ftom-doerr\u002Fzsh_codex\"\n        >\u003Cimg\n            src=\"https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Frepo-size\u002Ftom-doerr\u002Fzsh_codex?colorA=2c2837&colorB=89DCEB&style=for-the-badge&logo=starship style=flat-square\"\n            alt=\"GitHub repository size\"\n    \u002F>\u003C\u002Fa>\n\u003C\u002Fp>\n\n\u003Cp align=\"center\">\n    \u003Cimg src='https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Ftom-doerr_zsh_codex_readme_71d8ed17e932.gif'>\n    \u003Cp align=\"center\">\n        You just need to write a comment or variable name and the AI will write the corresponding code.\n    \u003C\u002Fp>\n\u003C\u002Fp>\n\n## What is it?\n\nThis is a ZSH plugin that enables you to use AI powered code completion in the command line. It now supports both OpenAI's Codex and Google's Generative AI (Gemini). OpenAI Codex is the AI that also powers GitHub Copilot, while Gemini is Google's advanced language model.\n\n## How do I install it?\n\n### Manual Installation\n\n1. Install the OpenAI package, the Google package, or boto3.\n\n```bash\npip3 install openai\n```\n\nor\n\n```bash\npip3 install google-generativeai\n```\n\nor\n\n```bash\npip3 install boto3\n```\n\n2. Download the ZSH plugin.\n\n```bash\ngit clone https:\u002F\u002Fgithub.com\u002Ftom-doerr\u002Fzsh_codex.git ~\u002F.oh-my-zsh\u002Fcustom\u002Fplugins\u002Fzsh_codex \n```\n\n3. Add the following to your `.zshrc` file.\n\nUsing oh-my-zsh:\n\n```bash\n    plugins=(zsh_codex)\n    bindkey '^X' create_completion\n```\n\nWithout oh-my-zsh:\n\n```bash\n    # in your\u002Fcustom\u002Fpath you need to have a \"plugins\" folder and in there you clone the repository as zsh_codex\n    export ZSH_CUSTOM=\"your\u002Fcustom\u002Fpath\"\n    source \"$ZSH_CUSTOM\u002Fplugins\u002Fzsh_codex\u002Fzsh_codex.plugin.zsh\"\n    bindkey '^X' create_completion\n```\n\n4. Create a file called `zsh_codex.ini` in `~\u002F.config`.\n   Example:\n\n```ini\n; Primary service configuration\n; Set 'service' to match one of the defined sections below.\n[service]\nservice = groq_service\n\n; Example configuration for a self-hosted Ollama service.\n[my_ollama]\napi_type = openai\napi_key = dummy_key\nmodel = llama3.1\nbase_url = http:\u002F\u002Flocalhost:11434\u002Fv1\n\n; OpenAI service configuration\n; Provide the 'api_key' and specify a 'model' if needed.\n[openai_service]\napi_type = openai\napi_key = \u003Copenai_apikey>\n\n; Groq service configuration\n; Provide the 'api_key'.\n[groq_service]\napi_type = groq\napi_key = \u003Cgroq_apikey>\nmodel = gemma2-9b-it\n\n; Mistral service configuration\n; Provide the 'api_key'.\n[mistral_service]\napi_type = mistral\napi_key = \u003Cmistral_apikey>\nmodel = mistral-small-latest\n```\n\nIn this configuration file, you can define multiple services with their own configurations. The required and optional parameters of the `api_type` are specified in `services\u002Fsevices.py`. Choose which service to use in the `[service]` section.\n\n6. Run `zsh`, start typing and complete it using `^X`!\n7. If you use virtual environments you can set `ZSH_CODEX_PYTHON` to python executable where `openai` or `google-generativeai` is installed.\n   e.g. for `miniconda` you can use:\n\n```bash\nexport ZSH_CODEX_PYTHON=\"$HOME\u002Fminiconda3\u002Fbin\u002Fpython\"\n```\n\n### Fig Installation\n\n\u003Ca href=\"https:\u002F\u002Ffig.io\u002Fplugins\u002Fother\u002Fzsh_codex_tom-doerr\" target=\"_blank\">\u003Cimg src=\"https:\u002F\u002Ffig.io\u002Fbadges\u002Finstall-with-fig.svg\" \u002F>\u003C\u002Fa>\n\n## Troubleshooting\n\n### Unhandled ZLE widget 'create_completion'\n\n```\nzsh-syntax-highlighting: unhandled ZLE widget 'create_completion'\nzsh-syntax-highlighting: (This is sometimes caused by doing `bindkey \u003Ckeys> create_completion` without creating the 'create_completion' widget with `zle -N` or `zle -C`.)\n```\n\nAdd the line\n\n```\nzle -N create_completion\n```\n\nbefore you call `bindkey` but after loading the plugin (`plugins=(zsh_codex)`).\n\n### Already exists and is not an empty directory\n\n```\nfatal: destination path '~.oh-my-zsh\u002Fcustom\u002Fplugins'\n```\n\nTry to download the ZSH plugin again.\n\n```\ngit clone https:\u002F\u002Fgithub.com\u002Ftom-doerr\u002Fzsh_codex.git ~\u002F.oh-my-zsh\u002Fcustom\u002Fplugins\u002Fzsh_codex\n```\n\n---\n\n\u003Cp align=\"center\">\n    \u003Ca href=\"https:\u002F\u002Fwww.buymeacoffee.com\u002FTomDoerr\" target=\"_blank\">\u003Cimg src=\"https:\u002F\u002Fwww.buymeacoffee.com\u002Fassets\u002Fimg\u002Fcustom_images\u002Forange_img.png\" alt=\"Buy Me A Coffee\" style=\"height: 41px !important;width: 174px !important;box-shadow: 0px 3px 2px 0px rgba(190, 190, 190, 0.5) !important;-webkit-box-shadow: 0px 3px 2px 0px rgba(190, 190, 190, 0.5) !important;\" >\u003C\u002Fa>\n\u003C\u002Fp>\n\n## Passing in context\n\nSince the current filesystem is not passed into the ai you will need to either\n1. Pass in all context in your descriptive command\n2. Use a command to collect the context\n\nIn order for option 2 to work you will need to first add `export ZSH_CODEX_PREEXECUTE_COMMENT=\"true\"` to your .zshrc file to enable the feature. \n\n> [!WARNING]\n> This will run your prompt using zsh each time before using it, which could potentially modify your system when you hit ^X.\n\nOnce you've done that and restarted your shell you can do things like this:\n\n`# git add all files. Also commit the current changeset with a descriptive message based on $(git diff). Then git push`\n\n## More usage examples\n\n\u003Cp align=\"center\">\n    \u003Cimg src='https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Ftom-doerr_zsh_codex_readme_1cdd9bd2dc44.gif'>\n    \u003Cp align=\"center\">\n    \u003C\u002Fp>\n\u003C\u002Fp>\n\n---\n\n[Fish Version](https:\u002F\u002Fgithub.com\u002Ftom-doerr\u002Fcodex.fish)\n\n[Traffic Statistics](https:\u002F\u002Ftom-doerr.github.io\u002Fgithub_repo_stats_data\u002Ftom-doerr\u002Fzsh_codex\u002Flatest-report\u002Freport.html)\n","\u003Ch1 align=\"center\">⌨️ 🦾 Zsh Codex\u003C\u002Fh1>\n\n\u003Cp align=\"center\">\n    命令行中的人工智能。\n\u003C\u002Fp>\n\n\u003Cp align=\"center\">\n    \u003Ca href=\"https:\u002F\u002Fgithub.com\u002Ftom-doerr\u002Fzsh_codex\u002Fstargazers\"\n        >\u003Cimg\n            src=\"https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fstars\u002Ftom-doerr\u002Fzsh_codex?colorA=2c2837&colorB=c9cbff&style=for-the-badge&logo=starship style=flat-square\"\n            alt=\"仓库的星标数\"\n    \u002F>\u003C\u002Fa>\n    \u003Ca href=\"https:\u002F\u002Fgithub.com\u002Ftom-doerr\u002Fzsh_codex\u002Fissues\"\n        >\u003Cimg\n            src=\"https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fissues-raw\u002Ftom-doerr\u002Fzsh_codex?colorA=2c2837&colorB=f2cdcd&style=for-the-badge&logo=starship style=flat-square\"\n            alt=\"问题数量\"\n    \u002F>\u003C\u002Fa>\n    \u003Ca href=\"https:\u002F\u002Fgithub.com\u002Ftom-doerr\u002Fzsh_codex\u002Fblob\u002Fmain\u002FLICENSE\"\n        >\u003Cimg\n            src=\"https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Flicense\u002Ftom-doerr\u002Fzsh_codex?colorA=2c2837&colorB=b5e8e0&style=for-the-badge&logo=starship style=flat-square\"\n            alt=\"许可证\"\n    \u002F>\u003Cbr \u002F>\n    \u003Ca href=\"https:\u002F\u002Fgithub.com\u002Ftom-doerr\u002Fzsh_codex\u002Fcommits\u002Fmain\"\n\t\t>\u003Cimg\n\t\t\tsrc=\"https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Flast-commit\u002Ftom-doerr\u002Fzsh_codex\u002Fmain?colorA=2c2837&colorB=ddb6f2&style=for-the-badge&logo=starship style=flat-square\"\n\t\t\talt=\"最新提交\"\n    \u002F>\u003C\u002Fa>\n    \u003Ca href=\"https:\u002F\u002Fgithub.com\u002Ftom-doerr\u002Fzsh_codex\"\n        >\u003Cimg\n            src=\"https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Frepo-size\u002Ftom-doerr\u002Fzsh_codex?colorA=2c2837&colorB=89DCEB&style=for-the-badge&logo=starship style=flat-square\"\n            alt=\"GitHub 仓库大小\"\n    \u002F>\u003C\u002Fa>\n\u003C\u002Fp>\n\n\u003Cp align=\"center\">\n    \u003Cimg src='https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Ftom-doerr_zsh_codex_readme_71d8ed17e932.gif'>\n    \u003Cp align=\"center\">\n        你只需要写下注释或变量名，AI 就会为你写出相应的代码。\n    \u003C\u002Fp>\n\u003C\u002Fp>\n\n## 这是什么？\n\n这是一个 ZSH 插件，它让你可以在命令行中使用由 AI 驱动的代码补全功能。目前支持 OpenAI 的 Codex 和 Google 的生成式 AI（Gemini）。OpenAI Codex 是 GitHub Copilot 背后使用的 AI 模型，而 Gemini 则是 Google 的先进语言模型。\n\n## 如何安装？\n\n### 手动安装\n\n1. 安装 OpenAI 包、Google 包或 boto3。\n\n```bash\npip3 install openai\n```\n\n或者\n\n```bash\npip3 install google-generativeai\n```\n\n或者\n\n```bash\npip3 install boto3\n```\n\n2. 下载 ZSH 插件。\n\n```bash\ngit clone https:\u002F\u002Fgithub.com\u002Ftom-doerr\u002Fzsh_codex.git ~\u002F.oh-my-zsh\u002Fcustom\u002Fplugins\u002Fzsh_codex \n```\n\n3. 在你的 `.zshrc` 文件中添加以下内容。\n\n使用 oh-my-zsh：\n\n```bash\n    plugins=(zsh_codex)\n    bindkey '^X' create_completion\n```\n\n不使用 oh-my-zsh：\n\n```bash\n    # 在你的自定义路径下需要有一个 \"plugins\" 文件夹，并在其中克隆 zsh_codex 仓库\n    export ZSH_CUSTOM=\"your\u002Fcustom\u002Fpath\"\n    source \"$ZSH_CUSTOM\u002Fplugins\u002Fzsh_codex\u002Fzsh_codex.plugin.zsh\"\n    bindkey '^X' create_completion\n```\n\n4. 在 `~\u002F.config` 目录下创建一个名为 `zsh_codex.ini` 的文件。示例：\n\n```ini\n; 主要服务配置\n; 将 'service' 设置为下面定义的其中一个部分。\n[service]\nservice = groq_service\n\n; 自托管 Ollama 服务的示例配置。\n[my_ollama]\napi_type = openai\napi_key = dummy_key\nmodel = llama3.1\nbase_url = http:\u002F\u002Flocalhost:11434\u002Fv1\n\n; OpenAI 服务配置\n; 提供 'api_key'，并在需要时指定 'model'。\n[openai_service]\napi_type = openai\napi_key = \u003Copenai_apikey>\n\n; Groq 服务配置\n; 提供 'api_key'。\n[groq_service]\napi_type = groq\napi_key = \u003Cgroq_apikey>\nmodel = gemma2-9b-it\n\n; Mistral 服务配置\n; 提供 'api_key'。\n[mistral_service]\napi_type = mistral\napi_key = \u003Cmistral_apikey>\nmodel = mistral-small-latest\n```\n\n在这个配置文件中，你可以定义多个具有各自配置的服务。`api_type` 的必填和可选参数在 `services\u002Fsevices.py` 中指定。在 `[service]` 部分选择你要使用的服务。\n\n6. 运行 `zsh`，开始输入并使用 `^X` 来完成代码！\n7. 如果你使用虚拟环境，可以将 `ZSH_CODEX_PYTHON` 设置为安装了 `openai` 或 `google-generativeai` 的 Python 可执行文件。\n   例如，对于 `miniconda`，你可以使用：\n\n```bash\nexport ZSH_CODEX_PYTHON=\"$HOME\u002Fminiconda3\u002Fbin\u002Fpython\"\n```\n\n### Fig 安装\n\n\u003Ca href=\"https:\u002F\u002Ffig.io\u002Fplugins\u002Fother\u002Fzsh_codex_tom-doerr\" target=\"_blank\">\u003Cimg src=\"https:\u002F\u002Ffig.io\u002Fbadges\u002Finstall-with-fig.svg\" \u002F>\u003C\u002Fa>\n\n## 故障排除\n\n### 未处理的 ZLE 小部件 'create_completion'\n\n```\nzsh-syntax-highlighting: 未处理的 ZLE 小部件 'create_completion'\nzsh-syntax-highlighting: （这有时是因为在没有使用 `zle -N` 或 `zle -C` 创建 'create_completion' 小部件的情况下执行了 `bindkey \u003Ckeys> create_completion`。）\n```\n\n在调用 `bindkey` 之前，但在加载插件（`plugins=(zsh_codex)`）之后，添加以下行：\n\n```\nzle -N create_completion\n```\n\n### 目标目录已存在且非空\n\n```\nfatal: destination path '~.oh-my-zsh\u002Fcustom\u002Fplugins'\n```\n\n尝试再次下载 ZSH 插件。\n\n```\ngit clone https:\u002F\u002Fgithub.com\u002Ftom-doerr\u002Fzsh_codex.git ~\u002F.oh-my-zsh\u002Fcustom\u002Fplugins\u002Fzsh_codex\n```\n\n---\n\n\u003Cp align=\"center\">\n    \u003Ca href=\"https:\u002F\u002Fwww.buymeacoffee.com\u002FTomDoerr\" target=\"_blank\">\u003Cimg src=\"https:\u002F\u002Fwww.buymeacoffee.com\u002Fassets\u002Fimg\u002Fcustom_images\u002Forange_img.png\" alt=\"请我喝杯咖啡\" style=\"height: 41px !important;width: 174px !important;box-shadow: 0px 3px 2px 0px rgba(190, 190, 190, 0.5) !important;-webkit-box-shadow: 0px 3px 2px 0px rgba(190, 190, 190, 0.5) !important;\" >\u003C\u002Fa>\n\u003C\u002Fp>\n\n## 传递上下文\n\n由于当前的文件系统不会传递给 AI，你需要要么\n1. 在描述性命令中直接传递所有上下文\n2. 使用一个命令来收集上下文\n\n为了使选项 2 能够工作，你需要先在 `.zshrc` 文件中添加 `export ZSH_CODEX_PREEXECUTE_COMMENT=\"true\"` 来启用该功能。\n\n> [!WARNING]\n> 这将在每次使用前运行你的 zsh 提示符，这可能会在你按下 ^X 时修改你的系统。\n\n完成这些操作并重启 shell 后，你可以这样操作：\n\n`# git add 所有文件。同时根据 $(git diff) 的内容提交当前的更改集，并附上描述性信息。然后 git push`\n\n## 更多使用示例\n\n\u003Cp align=\"center\">\n    \u003Cimg src='https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Ftom-doerr_zsh_codex_readme_1cdd9bd2dc44.gif'>\n    \u003Cp align=\"center\">\n    \u003C\u002Fp>\n\u003C\u002Fp>\n\n---\n\n[Fish 版本](https:\u002F\u002Fgithub.com\u002Ftom-doerr\u002Fcodex.fish)\n\n[流量统计](https:\u002F\u002Ftom-doerr.github.io\u002Fgithub_repo_stats_data\u002Ftom-doerr\u002Fzsh_codex\u002Flatest-report\u002Freport.html)","# zsh_codex 快速上手指南\n\n**zsh_codex** 是一个强大的 ZSH 插件，让你在命令行中直接利用 AI（支持 OpenAI Codex、Google Gemini、Groq、Mistral 及本地 Ollama 等模型）进行代码补全。只需输入注释或变量名，按下快捷键即可生成对应的 Shell 命令。\n\n## 环境准备\n\n在开始之前，请确保你的系统满足以下条件：\n\n*   **操作系统**: macOS 或 Linux\n*   **Shell**: 必须使用 **Zsh**\n*   **Python**: 已安装 Python 3 及 `pip`\n*   **前置依赖**: 根据你选择的 AI 服务商，需安装对应的 Python 库（任选其一或多选）：\n    *   OpenAI\u002FGroq\u002FMistral\u002FOllama: `pip3 install openai`\n    *   Google Gemini: `pip3 install google-generativeai`\n    *   AWS Bedrock: `pip3 install boto3`\n\n## 安装步骤\n\n### 1. 下载插件\n将插件克隆到 Oh My Zsh 的自定义插件目录：\n\n```bash\ngit clone https:\u002F\u002Fgithub.com\u002Ftom-doerr\u002Fzsh_codex.git ~\u002F.oh-my-zsh\u002Fcustom\u002Fplugins\u002Fzsh_codex\n```\n\n### 2. 配置 Zsh\n编辑你的 `~\u002F.zshrc` 文件，添加插件并绑定快捷键（默认为 `Ctrl+X`）：\n\n**如果你使用 Oh My Zsh：**\n```bash\nplugins=(zsh_codex)\nbindkey '^X' create_completion\nzle -N create_completion\n```\n> **注意**：`zle -N create_completion` 这一行非常重要，需放在 `bindkey` 之前或之后，但在插件加载后，用于避免 \"Unhandled ZLE widget\" 错误。\n\n**如果你不使用 Oh My Zsh：**\n```bash\nexport ZSH_CUSTOM=\"your\u002Fcustom\u002Fpath\" # 替换为你的实际路径\nsource \"$ZSH_CUSTOM\u002Fplugins\u002Fzsh_codex\u002Fzsh_codex.plugin.zsh\"\nbindkey '^X' create_completion\nzle -N create_completion\n```\n\n### 3. 配置 API 密钥\n在 `~\u002F.config` 目录下创建名为 `zsh_codex.ini` 的配置文件。你可以在其中配置多个服务，并通过 `[service]` 字段指定默认使用的服务。\n\n示例配置 (`~\u002F.config\u002Fzsh_codex.ini`)：\n\n```ini\n; 选择默认服务 (需与下方定义的 section 名称一致)\n[service]\nservice = openai_service\n\n; OpenAI 配置\n[openai_service]\napi_type = openai\napi_key = \u003C你的_openai_api_key>\nmodel = gpt-3.5-turbo-instruct\n\n; Groq 配置 (速度快，免费额度多)\n[groq_service]\napi_type = groq\napi_key = \u003C你的_groq_api_key>\nmodel = gemma2-9b-it\n\n; 本地 Ollama 配置\n[my_ollama]\napi_type = openai\napi_key = dummy_key\nmodel = llama3.1\nbase_url = http:\u002F\u002Flocalhost:11434\u002Fv1\n```\n\n*请将 `\u003C你的_..._api_key>` 替换为真实的 API Key。*\n\n### 4. 生效配置\n保存文件后，重启终端或运行以下命令使配置生效：\n\n```bash\nsource ~\u002F.zshrc\n```\n\n*(可选) 如果你使用 Python 虚拟环境（如 conda），且 AI 库安装在特定环境中，请设置以下环境变量：*\n```bash\nexport ZSH_CODEX_PYTHON=\"$HOME\u002Fminiconda3\u002Fbin\u002Fpython\"\n```\n\n## 基本使用\n\n安装完成后，在命令行中输入自然语言描述或注释，然后按下 **`Ctrl + X`** 即可触发 AI 补全。\n\n**使用示例：**\n\n1.  **生成命令**：\n    输入以下内容（以 `#` 开头作为注释）：\n    ```bash\n    # 查找当前目录下所有大于 100MB 的文件并按大小排序\n    ```\n    按下 `Ctrl + X`，AI 会自动将其替换为：\n    ```bash\n    find . -type f -size +100M -exec ls -lh {} \\; | sort -k5 -hr\n    ```\n\n2.  **基于上下文生成**（高级用法）：\n    若需在 `.zshrc` 中启用 `export ZSH_CODEX_PREEXECUTE_COMMENT=\"true\"`，你可以结合当前命令输出生成新命令：\n    ```bash\n    # git add all files. Also commit the current changeset with a descriptive message based on $(git diff). Then git push\n    ```\n    按下 `Ctrl + X`，AI 会解析 `$(git diff)` 的结果并生成完整的提交和推送命令。\n\n3.  **取消操作**：\n    如果生成的命令不符合预期，直接按 `Ctrl + C` 取消即可，不会执行任何操作。","一位后端工程师正在清理服务器日志，需要快速构建一条包含复杂时间范围过滤、多关键词排除及格式转化的 `find` 与 `grep` 组合命令。\n\n### 没有 zsh_codex 时\n- **记忆负担重**：开发者必须准确回忆 `find` 命令中 `-mtime`、`-exec` 等繁琐参数的具体语法，极易记错。\n- **查阅中断流**：不得不切换窗口去搜索引擎或 Man 手册查找正则表达式写法，打断了当前的操作思路。\n- **试错成本高**：手动拼接长命令时容易遗漏引号或转义字符，导致执行报错，需反复修改调试。\n- **效率低下**：原本只需几秒的简单任务，因查阅和纠错耗时长达数分钟，严重拖慢运维节奏。\n\n### 使用 zsh_codex 后\n- **自然语言驱动**：只需在命令行输入注释如\"# 查找过去 7 天修改过且不含 error 的 log 文件”，zsh_codex 即可自动补全完整命令。\n- **零上下文切换**：AI 直接在终端内生成代码，开发者无需离开当前界面，保持了高度的专注力。\n- **语法精准无误**：生成的命令自动处理了复杂的引号嵌套和参数顺序，首次执行成功率大幅提升。\n- **即时响应**：按下 `^X` 快捷键瞬间获得结果，将原本几分钟的检索编写过程压缩至几秒钟。\n\nzsh_codex 通过将自然语言意图直接转化为精准的 Shell 命令，彻底消除了命令行场景下的记忆障碍与查阅成本，让终端操作变得像对话一样流畅高效。","https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Ftom-doerr_zsh_codex_1cdd9bd2.gif","tom-doerr","Tom Dörr","https:\u002F\u002Foss.gittoolsai.com\u002Favatars\u002Ftom-doerr_998883e4.jpg",null,"tomdoerr96@gmail.com","tom_doerr","https:\u002F\u002Fmeta.stackoverflow.com\u002Fusers\u002F6105651\u002Ftom-d%c3%b6rr?tab=profile","https:\u002F\u002Fgithub.com\u002Ftom-doerr",[81,85],{"name":82,"color":83,"percentage":84},"Python","#3572A5",91.7,{"name":86,"color":87,"percentage":88},"Shell","#89e051",8.3,1719,100,"2026-04-08T23:12:41","MIT","Linux, macOS","未说明",{"notes":96,"python":97,"dependencies":98},"该工具是 ZSH 插件，依赖外部 API（如 OpenAI, Google Gemini, Groq, Mistral 或自托管 Ollama），而非本地运行大型模型，因此无特定 GPU\u002F内存要求。需配置 ~\u002F.config\u002Fzsh_codex.ini 文件以设置 API Key 和服务类型。若使用虚拟环境，需设置 ZSH_CODEX_PYTHON 环境变量指向正确的 Python 可执行文件。","未说明 (需安装 python3 及 pip3)",[99,100,101],"openai","google-generativeai","boto3",[14,15,13],[104,99,105,106],"zsh","codex","ai","2026-03-27T02:49:30.150509","2026-04-09T21:36:24.133238",[110,115,120,125,130,135,140,145],{"id":111,"question_zh":112,"answer_zh":113,"source_url":114},26744,"遇到 'No such organization: Personal' 认证错误如何解决？","在 `openaiapirc` 配置文件中，`organization_id` 不能直接填写为 \"Personal\"。您需要登录 OpenAI 官网，进入组织设置页面 (https:\u002F\u002Fbeta.openai.com\u002Faccount\u002Forg-settings)，复制您实际的 Organization ID 并填入配置文件中。","https:\u002F\u002Fgithub.com\u002Ftom-doerr\u002Fzsh_codex\u002Fissues\u002F5",{"id":116,"question_zh":117,"answer_zh":118,"source_url":119},26742,"遇到 'InvalidRequestError: The model does not exist' 或引擎未找到的错误怎么办？","这通常是因为模型名称已过时或您的账户没有访问权限。请尝试将配置中的 `engine` 替换为 `model`，并将模型名称从 `code-davinci-002` 更新为 `text-davinci-003`（或当前最新的可用模型）。此外，确保您的 OpenAI 账户已关联支付方式并拥有足够的额度，即使 Codex 本身免费，账户也需要有支付方法才能激活 API 访问。","https:\u002F\u002Fgithub.com\u002Ftom-doerr\u002Fzsh_codex\u002Fissues\u002F1",{"id":121,"question_zh":122,"answer_zh":123,"source_url":124},26743,"如何获取 OpenAI API 密钥（secret_key）？","您需要加入 OpenAI 的等待名单。请访问 https:\u002F\u002Fbeta.openai.com\u002F 注册并申请访问权限。获取密钥可能需要较长时间（有时长达数月），请耐心等待审核通过。","https:\u002F\u002Fgithub.com\u002Ftom-doerr\u002Fzsh_codex\u002Fissues\u002F4",{"id":126,"question_zh":127,"answer_zh":128,"source_url":129},26745,"生成的命令以 '#' 开头导致无法执行怎么办？","这是因为 Zsh 将 '#' 视为注释符号。请在您的 shell 配置中运行 `set -k` 命令，这将允许 Zsh 解释并执行以 '#' 开头的命令。执行后再次尝试运行生成的命令即可。","https:\u002F\u002Fgithub.com\u002Ftom-doerr\u002Fzsh_codex\u002Fissues\u002F7",{"id":131,"question_zh":132,"answer_zh":133,"source_url":134},26746,"如何在 Fish Shell 中使用此插件？","作者已经为该插件提供了 Fish Shell 的版本。您可以访问 https:\u002F\u002Fgithub.com\u002Ftom-doerr\u002Fcodex.fish 获取专为 Fish Shell 设计的插件代码并进行安装。","https:\u002F\u002Fgithub.com\u002Ftom-doerr\u002Fzsh_codex\u002Fissues\u002F10",{"id":136,"question_zh":137,"answer_zh":138,"source_url":139},26747,"配置 Gemini 或其他后端时出现错误怎么办？","首先检查配置文件中的拼写错误，例如将 `api_type` 设置为 `gemeni` 是错误的，应修正为 `gemini`。其次，确保您已在 `.config` 目录下正确创建了配置文件。该插件支持通过环境变量或配置文件指定兼容 OpenAI 协议的其他后端 URL。","https:\u002F\u002Fgithub.com\u002Ftom-doerr\u002Fzsh_codex\u002Fissues\u002F59",{"id":141,"question_zh":142,"answer_zh":143,"source_url":144},26748,"如何在多个 Python 虚拟环境中使用而不重复安装依赖？","插件通常会检查系统中是否有链接到 `\u002Fusr\u002Fbin\u002Fpython` 的 Python 二进制文件并使用它，从而避免在每个虚拟环境中单独安装 openai 包。如果遇到问题，可以尝试手动指定 Python 可执行文件路径，或者考虑使用 `pipx` 安装相关的 Python 包部分。","https:\u002F\u002Fgithub.com\u002Ftom-doerr\u002Fzsh_codex\u002Fissues\u002F17",{"id":146,"question_zh":147,"answer_zh":148,"source_url":149},26749,"是否支持兼容 OpenAI 协议的其他后端服务？","是的，项目已增加了对任意兼容 OpenAI API 后端的支持。您可以通过环境变量或配置文件来指定自定义的后端 URL，从而连接到非官方的兼容服务。","https:\u002F\u002Fgithub.com\u002Ftom-doerr\u002Fzsh_codex\u002Fissues\u002F50",[]]