{"id":24117568,"url":"https://github.com/zyjarge/aido","last_synced_at":"2026-02-26T11:33:00.571Z","repository":{"id":271568716,"uuid":"913869379","full_name":"zyjarge/aido","owner":"zyjarge","description":"AIDO 是一个基于 AI 的命令行助手，它可以将自然语言转换为命令行指令。","archived":false,"fork":false,"pushed_at":"2025-02-10T07:02:22.000Z","size":754,"stargazers_count":2,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-04-03T04:33:01.727Z","etag":null,"topics":["ai-assistant","cli-app","deepseek-coder"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/zyjarge.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2025-01-08T14:07:07.000Z","updated_at":"2025-02-10T07:02:26.000Z","dependencies_parsed_at":"2025-02-28T15:10:59.661Z","dependency_job_id":"8e5bd967-946e-4df1-af4d-59111d8fa7a6","html_url":"https://github.com/zyjarge/aido","commit_stats":null,"previous_names":["zyjarge/aido"],"tags_count":6,"template":false,"template_full_name":null,"purl":"pkg:github/zyjarge/aido","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zyjarge%2Faido","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zyjarge%2Faido/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zyjarge%2Faido/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zyjarge%2Faido/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/zyjarge","download_url":"https://codeload.github.com/zyjarge/aido/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zyjarge%2Faido/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29857542,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-26T08:51:08.701Z","status":"ssl_error","status_checked_at":"2026-02-26T08:50:19.607Z","response_time":89,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai-assistant","cli-app","deepseek-coder"],"created_at":"2025-01-11T07:54:47.389Z","updated_at":"2026-02-26T11:33:00.553Z","avatar_url":"https://github.com/zyjarge.png","language":"Python","readme":"# AIDO - AI-Powered Command Line Assistant\n\nAIDO 是一个基于 AI 的命令行助手，它可以将自然语言转换为命令行指令。\n\n## 开发动机\n\n在日常开发过程中，我们经常需要：\n- 在浏览器中打开 AI 网站查询命令\n- 在不同窗口间切换复制粘贴\n- 重复查询一些常用但不容易记住的命令\n- 部分灵感来自于 [《AI帮你赢：人人都能用的AI方法论》](https://book.douban.com/subject/37152637/)\n\nAIDO 直接集成在终端中，让你可以：\n- 直接在终端中用自然语言获取命令\n- 自动复制命令到剪贴板\n- 获取命令的中文解释\n- 支持单轮查询和多轮对话两种模式\n- 减少在不同窗口间切换的时间\n\n## 安装方法\n\n### 前置要求\n- Python 3.8 或更高版本\n- Git（用于克隆仓库）\n- 支持的 API 服务之一：\n  - [DeepSeek](https://platform.deepseek.com/)\n  - [SiliconFlow](https://docs.siliconflow.cn/)\n- curl（用于安装脚本）\n\n### 快速安装（推荐）\n\n使用以下命令一键安装：\n\n```bash\n# MacOS/Linux\ncurl -fsSL https://raw.githubusercontent.com/zyjarge/aido/master/install.sh | bash\n\n# Windows (在管理员权限的 PowerShell 中运行)\nSet-ExecutionPolicy RemoteSigned -Scope Process\niwr -useb https://raw.githubusercontent.com/zyjarge/aido/master/install.ps1 | iex\n```\n\n安装脚本会自动完成以下操作：\n- 检查 Python 环境\n- 创建虚拟环境\n- 安装所需依赖（使用清华大学镜像源加速）\n- 创建配置文件\n- 设置启动器\n\n安装完成后，你需要：\n1. 编辑 `.env.local` 文件，配置以下信息：\n   - `BASE_URL`: API 服务地址\n   - `MODEL_NAME`: 使用的模型名称\n   - `API_KEY`: API 密钥\n2. 现在可以在任何目录使用 `aido` 命令了\n\n## 配置说明\n\n在 `.env.local` 文件中可以配置：\n\n### DeepSeek API 配置示例\n```bash\nBASE_URL=https://api.deepseek.com/v1\nMODEL_NAME=deepseek-chat\nAPI_KEY=your_api_key_here\n```\n\n### SiliconFlow API 配置示例\n```bash\nBASE_URL=https://api.siliconflow.com/v1\nMODEL_NAME=chatglm3-6b\nAPI_KEY=your_api_key_here\n```\n\n### 其他配置\n```bash\n# 日志级别：DEBUG, INFO, WARNING, ERROR, CRITICAL\nLOG_LEVEL=CRITICAL\n```\n\n## 支持的 API 服务\n\nAIDO 目前支持以下 API 服务：\n\n### 1. DeepSeek API\n- 官网：https://platform.deepseek.com\n- 特点：稳定性好，响应速度快\n- 默认模型：deepseek-chat\n\n### 2. SiliconFlow API\n- 官网：https://docs.siliconflow.cn\n- 特点：支持模型多，本地部署快\n- 可用模型：\n  - chatglm3-6b\n  - qwen-7b-chat\n  - baichuan2-13b\n  等\n\n## 使用方法\n\nAIDO 支持两种使用模式：\n\n### 1. 单轮查询模式\n适合快速查询单个命令：\n```bash\n# 直接跟随查询内容\naido 查看系统内存使用情况\naido 如何查找大文件\naido 统计当前目录下的文件数量\n```\n\n### 2. 多轮对话模式\n适合需要连续交互或复杂问题：\n```bash\n# 直接启动，进入交互模式\naido\n```\n- 使用 `\u003e\u003e\u003e` 提示符输入问题\n- 支持连续对话，保持上下文\n- 按 Ctrl+C 结束对话\n\n### 使用示例\n\n1. 单轮查询示例：\n```bash\n# 系统信息查询\naido 显示系统内存使用情况\naido 查看CPU使用率最高的进程\n\n# 文件操作\naido 查找当前目录下所有的jpg文件\naido 查找大于100MB的文件\n\n# 网络操作\naido 测试与google.com的连接延迟\naido 查看本机IP地址\n```\n\n2. 多轮对话示例：\n```bash\n$ aido\n欢迎使用 AIDO 聊天助手！\n\u003e\u003e\u003e 如何压缩文件？\n【建议命令】tar -czf archive.tar.gz files/\n【解释】使用tar命令压缩文件，-c创建新档案，-z使用gzip压缩，-f指定档案文件名\n\n\u003e\u003e\u003e 如何解压这个文件？\n【建议命令】tar -xzf archive.tar.gz\n【解释】解压tar.gz文件，-x表示解压，-z使用gzip解压，-f指定要解压的文件\n```\n\n### 特点\n- 支持单轮查询和多轮对话两种模式\n- 命令会自动复制到剪贴板\n- 提供命令的中文解释\n- 支持复杂的命令组合\n- 适配 MacOS/Linux/Windows 环境\n- 优雅的界面展示\n- 智能的上下文理解\n\n## 注意事项\n\n1. 需要有效的 DeepSeek API key\n2. 建议在执行命令前仔细检查 AI 生成的命令\n3. 某些命令可能需要 root/管理员权限\n4. Windows 环境下部分命令可能不适用\n5. 在多轮对话模式中，可以随时使用 Ctrl+C 优雅退出\n\n## 贡献\n\n欢迎提交 Issue 和 Pull Request！\n\n## 卸载方法\n\n如果你想卸载 AIDO，可以按照以下步骤操作：\n\n```bash\n# 运行卸载命令\nrm -f ~/.local/bin/aido \u0026\u0026 rm -rf ~/aido\n```\n\n3. 清理环境变量（可选）：\n- 如果你不再需要 `~/.local/bin` 目录用于其他程序，可以从 PATH 中移除：\n- 编辑 `~/.bashrc` 或 `~/.zshrc`，删除以下行：\n```bash\nexport PATH=\"$HOME/.local/bin:$PATH\"\n```\n- 然后重新加载配置：\n```bash\nsource ~/.bashrc  # 或 source ~/.zshrc\n```\n\n卸载完成后，所有 AIDO 相关的文件和配置都会被清除。如果你之后想重新安装，可以重新运行安装命令。\n\n## 许可证\n\nMIT License ","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzyjarge%2Faido","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fzyjarge%2Faido","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzyjarge%2Faido/lists"}