{"id":23642025,"url":"https://github.com/hongping1963-source/shellsage","last_synced_at":"2026-04-10T00:48:07.070Z","repository":{"id":269503624,"uuid":"907623004","full_name":"hongping1963-source/shellsage","owner":"hongping1963-source","description":"🧙‍♂️ Intelligent VS Code extension that automatically corrects shell commands. Enhanced terminal experience with smart suggestions and multi-shell support.","archived":false,"fork":false,"pushed_at":"2025-01-03T08:34:11.000Z","size":5790,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-07-11T08:50:07.104Z","etag":null,"topics":["cli","command-correction","command-line","productivity","shell","terminal","vscode-extension"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/hongping1963-source.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","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,"zenodo":null}},"created_at":"2024-12-24T02:38:45.000Z","updated_at":"2025-01-03T08:34:14.000Z","dependencies_parsed_at":null,"dependency_job_id":"af3269e4-c227-4bfe-b37b-dd0aeaa0822a","html_url":"https://github.com/hongping1963-source/shellsage","commit_stats":null,"previous_names":["hongping1963-source/shellsage"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/hongping1963-source/shellsage","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hongping1963-source%2Fshellsage","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hongping1963-source%2Fshellsage/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hongping1963-source%2Fshellsage/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hongping1963-source%2Fshellsage/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/hongping1963-source","download_url":"https://codeload.github.com/hongping1963-source/shellsage/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hongping1963-source%2Fshellsage/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":278671729,"owners_count":26025743,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-10-06T02:00:05.630Z","response_time":65,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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":["cli","command-correction","command-line","productivity","shell","terminal","vscode-extension"],"created_at":"2024-12-28T10:39:00.748Z","updated_at":"2025-10-06T19:48:04.286Z","avatar_url":"https://github.com/hongping1963-source.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# ShellSage \n\n[![VS Code Extension](https://img.shields.io/badge/VS%20Code-Extension-blue.svg)](https://marketplace.visualstudio.com/items?itemName=shellsage)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](http://makeapullrequest.com)\n[![Maintenance](https://img.shields.io/badge/Maintained%3F-yes-green.svg)](https://github.com/hongping1963-source/shellsage/graphs/commit-activity)\n[![GitHub issues](https://img.shields.io/github/issues/hongping1963-source/shellsage)](https://github.com/hongping1963-source/shellsage/issues)\n\n\u003e 您的VS Code智能终端助手！基于 DeepSeek AI 的智能命令分析与纠正，提升您的终端使用效率。\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"images/demo.gif\" alt=\"ShellSage Demo\" width=\"600\"\u003e\n\u003c/p\u003e\n\n## 📌 项目状态\n\n当前版本：v0.2.0-alpha（早期开发阶段）\n\n[查看完整项目状态和路线图](./docs/_docs/PROJECT_STATUS.md)\n\n### 已实现功能\n- ✅ 基础Shell集成\n- ✅ DeepSeek AI 驱动的命令分析\n- ✅ 智能命令纠正与建议\n- ✅ VS Code扩展框架\n- ✅ 命令历史管理\n- ✅ 配置选项\n\n### 开发中功能\n- 🚧 更多 AI 模型支持\n- 🚧 命令执行风险评估\n- 🚧 更多Shell支持\n- 🚧 性能优化\n\n## 🌟 主要特性\n\n- **AI 驱动的命令分析**\n  - 基于 DeepSeek AI 的实时命令分析\n  - 智能错误检测与纠正\n  - 命令用途和风险说明\n  - 替代命令建议\n\n- **智能命令纠正**\n  - 实时检测并建议修正错误命令\n  - 置信度评分系统\n  - 详细的纠正解释\n  - 支持多种Shell环境\n\n- **VS Code深度集成**\n  - 无缝融入VS Code终端\n  - 快捷键支持\n  - 自定义配置选项\n  - 美观的分析结果展示\n\n- **命令历史管理**\n  - 智能命令历史记录\n  - 使用频率分析\n  - 错误模式识别\n  - 命令序列分析\n\n## 📥 安装\n\n### 系统要求\n- VS Code 1.60.0 或更高版本\n- Node.js 16.x 或更高版本\n- 支持的操作系统：Windows、macOS、Linux\n- DeepSeek API 密钥（可在设置中配置）\n\n### 安装步骤\n1. 打开VS Code\n2. 按下 `Ctrl+P` / `Cmd+P`\n3. 输入 `ext install shellsage`\n4. 按下回车键\n5. 在设置中配置 DeepSeek API 密钥\n\n## 🚀 快速开始\n\n1. 在VS Code中打开终端\n2. 输入命令（即使有拼写错误也没关系！）\n3. ShellSage会使用 DeepSeek AI 分析命令并提供建议\n4. 按回车键接受建议\n\n### 示例\n\n```bash\n# 错误输入 'git status'\n$ git stauts\n ShellSage: 建议修正为 'git status'\n 置信度: 0.98\n 解释: 'stauts' 是 'status' 的常见拼写错误\n\n# 错误输入 'docker ps'\n$ dcoker ps\n ShellSage: 建议修正为 'docker ps'\n 置信度: 0.95\n 解释: 'dcoker' 是 'docker' 的常见拼写错误\n```\n\n## ⚙️ 配置\n\n通过VS Code设置面板（`Ctrl+,`）配置ShellSage：\n\n- `shellsage.deepseekApiKey`: DeepSeek API 密钥\n- `shellsage.enableAutoCorrect`: 启用/禁用自动纠正\n- `shellsage.showInlineCorrections`: 显示内联建议\n- `shellsage.maxSuggestions`: 最大建议数量\n- `shellsage.confidenceThreshold`: 最低置信度阈值\n\n详细配置选项请参考[配置文档](./docs/_docs/CONFIGURATION.md)。\n\n## 📚 文档\n\n- [使用指南](./docs/_docs/FAQ_IMPROVEMENT.md)\n- [开发指南](./docs/_docs/DEVELOPMENT.md)\n- [贡献指南](./docs/_docs/CONTRIBUTING_GUIDE.md)\n- [项目状态](./docs/_docs/PROJECT_STATUS.md)\n- [常见问题](./docs/_docs/FAQ_IMPROVEMENT.md)\n\n## 🤝 参与贡献\n\n我们欢迎各种形式的贡献！\n\n- 🐛 [报告问题](https://github.com/hongping1963-source/shellsage/issues)\n- 💡 [提出建议](https://github.com/hongping1963-source/shellsage/issues)\n- 📝 [改进文档](./docs/_docs/CONTRIBUTING_GUIDE.md)\n- 💻 [提交代码](./docs/_docs/CONTRIBUTING_GUIDE.md)\n\n查看[贡献指南](./docs/_docs/CONTRIBUTING_GUIDE.md)了解更多信息。\n\n## 📄 许可证\n\n本项目采用 MIT 许可证 - 详见 [LICENSE](LICENSE) 文件。\n\n## 🙏 致谢\n\n- [DeepSeek](https://deepseek.ai) - AI 能力支持\n- [TheFuck](https://github.com/nvbn/thefuck) - 项目灵感来源\n- 所有[贡献者](./CONTRIBUTORS.md)\n- VS Code团队提供的优秀扩展API\n\n## 📬 联系我们\n\n- GitHub Issues: 问题报告和功能请求\n- GitHub Discussions: 一般讨论和问题解答\n- Email: support@shellsage.com（即将推出）\n\n---\n\n\u003cp align=\"center\"\u003e\n  Made with ❤️ by the ShellSage Team\n\u003c/p\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhongping1963-source%2Fshellsage","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhongping1963-source%2Fshellsage","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhongping1963-source%2Fshellsage/lists"}