<div align="center">

[![公告横幅](https://img.shields.io/badge/🌟_我们正在探索有趣的东西，敬请期待!-2563EB?style=for-the-badge)](https://costrict.ai)

</div>

<div align="center">

<img src="https://img.shields.io/badge/版本-latest-blue?style=flat-square" alt="Version">
<img src="https://img.shields.io/badge/许可证-Apache%202.0-green?style=flat-square" alt="License">
<img src="https://img.shields.io/badge/平台-VS%20Code%20%7C%20JetBrains-orange?style=flat-square" alt="Platform">
<img src="https://img.shields.io/badge/欢迎PR-brightgreen?style=flat-square" alt="PRs Welcome">

</div>

<div align="center">

# CoStrict

<img src="./assets/images/shenma_robot_logo_big.png" alt="CoStrict Logo" width="60">

**企业严肃开发的 AI 智能体伙伴**

_免费 • 开源 • 支持私有化部署_

English | [简体中文](./README.zh-CN.md)

</div>

---

**CoStrict** 是一款免费开源的 AI 辅助编程工具，专为企业级开发场景设计。支持私有化部署，是组织级安全、标准化 AI 开发工作流的最佳选择。

## ✨ 核心能力

| 功能            | 描述                                                               |
| --------------- | ------------------------------------------------------------------ |
| 🔒 **严肃编程** | 标准化 AI 代码生成流程，包含需求分析、架构设计、任务规划、测试生成 |
| 🔍 **代码审查** | 基于全仓库 RAG 的代码分析，采用多专家模型交叉验证                  |
| ⚡ **代码补全** | 秒级上下文感知代码生成                                             |
| 🎯 **氛围编程** | 自然语言多轮对话快速开发                                           |
| 🔗 **MCP 集成** | 标准化系统连接，支持 API、数据库、自定义工具集成                   |
| 🎨 **多模态**   | 支持图片上传和视觉上下文输入                                       |
| 🛠️ **技能支持** | 可扩展技能系统，支持专业化任务工作流                               |

## 📦 安装方式

<table>
  <tr>
    <td align="center" width="25%">
      <b>🌟 CoStrict Cloud（实验性）</b><br><br>
      <a href="https://docs.costrict.ai/cli/product-characteristics/cloud">
        <img src="https://img.shields.io/badge/Cloud-Documentation-blue?style=for-the-badge" alt="Cloud Docs">
      </a>
    </td>
    <td align="center" width="25%">
      <b>VS Code 扩展</b><br><br>
      <a href="https://marketplace.visualstudio.com/items?itemName=zgsm-ai.zgsm-nightly">
        <img src="https://img.shields.io/badge/Download-Nightly-success?style=for-the-badge" alt="下载">
      </a>
      <a href="https://marketplace.visualstudio.com/items?itemName=zgsm-ai.zgsm">
        <img src="https://img.shields.io/badge/Download-Latest-success?style=for-the-badge" alt="下载">
      </a>
    </td>
    <td align="center" width="25%">
      <b>命令行工具</b><br><br>
      <a href="https://docs.costrict.ai/cli/guide/installation">
        <img src="https://img.shields.io/badge/CLI-文档-blue?style=for-the-badge" alt="CLI 文档">
      </a>
      <a href="https://costrict.ai/download">
        <img src="https://img.shields.io/badge/下载-最新版本-success?style=for-the-badge" alt="下载">
      </a>
    </td>
    <td align="center" width="33%">
      <b>JetBrains 插件</b><br><br>
      <a href="https://github.com/zgsm-sangfor/costrict-for-jetbrains">
        <img src="https://img.shields.io/badge/GitHub-仓库-informational?style=for-the-badge" alt="JetBrains 仓库">
      </a>
      <a href="https://costrict.ai/download">
        <img src="https://img.shields.io/badge/下载-最新版本-success?style=for-the-badge" alt="下载">
      </a>
    </td>
  </tr>
</table>

## 🚀 主要特性

### 严肃编程（Strict Mode）

规范 AI 生成代码流程，使其符合企业开发场景，确保输出高质量、高可控。

<table bgcolor="#1e1e1e">
  <tr>
    <td align="center" width="50%">
      <a href="https://docs.costrict.ai/tutorial-videos/video#%E4%B8%A5%E8%82%83%E7%BC%96%E7%A8%8B">
        <img src="./assets/images/readme/strict_mode_zh_buffer.webp" alt="严肃编程演示" width="100%">
      </a>
    </td>
    <td align="center" width="50%">
      <img src="./assets/images/readme/strict_zh.webp" alt="严肃编程" width="100%">
    </td>
  </tr>
</table>

### 代码审查（Code Review）

全仓库索引解析，公司级编码知识库 RAG，采用多专家模型专项检查 + 多模型交叉确认策略。

<table bgcolor="#1e1e1e">
  <tr>
    <td align="center" width="50%">
      <a href="https://docs.costrict.ai/tutorial-videos/video#%E4%BB%A3%E7%A0%81%E5%AE%A1%E6%9F%A5">
        <img src="./assets/images/readme/codereview_buffer.webp" alt="代码审查演示" width="100%">
      </a>
    </td>
    <td align="center" width="50%">
      <img src="./assets/images/readme/codereview.webp" alt="代码审查" width="100%">
    </td>
  </tr>
</table>

### 更多特性

- 🌐 **多语言支持** - Python、Go、Java、JavaScript/TypeScript、C/C++ 及所有编程语言
- 🔐 **隐私与安全** - 专业私有化部署方案，物理隔离 + 端到端加密
- 🎛️ **API 与模型自定义** - 内置免费高级模型 + 支持 Anthropic、OpenAI、兼容 OpenAI 的 API 及本地模型
- 📁 **大仓库上下文** - 自动纳入全仓库上下文，支持 @ 文件/文件夹提及
- 🔧 **模式自定义** - 多种默认模式（Code、Orchestrator）+ 自定义模式支持
- 📝 **[OpenSpec 集成](https://github.com/Fission-AI/OpenSpec)** - 通过 `/openspec-init` 初始化标准化变更提案工作流
- 🖱️ **快捷菜单** - 选中代码右键菜单，支持解释、修复、改进、注释、审查、日志、容错、简化、性能优化等功能
- 🔗 **VSCode SCM 集成** - 与 Git 无缝集成，支持代码审查与协作
- **自动清理历史** - 自动清理历史记录，减少磁盘占用
- 📝 **历史导入导出** - 支持历史记录的导入与导出，便于离线迁移
- 🔗 **精简模式** - 减少上下文使用量，降低 Token 消耗

<img src="./assets/images/readme/more-feature.webp" alt="更多特性" width="100%">

## 📚 文档资源

| 资源       | 链接                                                                                         |
| ---------- | -------------------------------------------------------------------------------------------- |
| 安装指南   | [docs.costrict.ai/guide/installation](https://docs.costrict.ai/guide/installation)           |
| 私有化部署 | [docs.costrict.ai/deployment/introduction](https://docs.costrict.ai/deployment/introduction) |
| 教程视频   | [docs.costrict.ai/tutorial-videos/video](https://docs.costrict.ai/tutorial-videos/video)     |
| CLI 文档   | [docs.costrict.ai/cli/guide/installation](https://docs.costrict.ai/cli/guide/installation)   |

## 🤝 社区与支持

<table>
  <tr>
    <td align="center" width="33%">
      <img src="./assets/images/readme/wechat.png" width="120"><br>
      <b>微信群</b>
    </td>
    <td align="center" width="33%">
      <img src="./assets/images/readme/communication_group.webp" width="120"><br>
      <b>意见反馈</b>
    </td>
    <td align="center" width="33%">
      <a href="https://github.com/zgsm-ai/costrict/issues/new/choose">
        <img src="https://img.shields.io/badge/GitHub-Issues-blue?style=for-the-badge&logo=github" alt="GitHub Issues">
      </a>
    </td>
  </tr>
</table>

## 🤝 参与贡献

欢迎参与贡献！详情请查看 [贡献指南](assets/docs/devel/zh-CN/fork.md)。

### 上报问题

在 [Issues](https://github.com/zgsm-ai/costrict/issues) 搜索确认问题未被报告后，可 [新建 Issue](https://github.com/zgsm-ai/costrict/issues/new/choose)。

### 提交代码

采用 GitHub Forking 工作流，详见 [代码贡献流程](https://github.com/zgsm-ai/costrict/blob/main/assets/docs/devel/zh-CN/fork.md)。

## 📄 许可证

[Apache 2.0 © 2025 Sangfor, Inc.](./LICENSE)

## ⭐ Star 历史

<a href="https://www.star-history.com/#zgsm-ai/costrict&Date">
  <img src="https://api.star-history.com/svg?repos=zgsm-ai/costrict&type=Date" alt="Star 历史图表" width="100%">
</a>

## 🙏 致谢

特别感谢以下开源项目：

[![Roo Code](https://img.shields.io/badge/Roo%20Code-仓库-blue?style=flat-square)](https://github.com/RooCodeInc/Roo-Code)
[![OpenSpec](https://img.shields.io/badge/OpenSpec-仓库-blue?style=flat-square)](https://github.com/Fission-AI/OpenSpec)
[![OpenCode](https://img.shields.io/badge/OpenCode-仓库-blue?style=flat-square)](https://github.com/anomalyco/opencode)
[![agents.md](https://img.shields.io/badge/agents.md-仓库-blue?style=flat-square)](https://github.com/agentsmd/agents.md)
[![agentskills](https://img.shields.io/badge/agentskills-仓库-blue?style=flat-square)](https://github.com/agentskills/agentskills)

---

## 免责声明

**请注意**，Sangfor, Inc. **不**对与 CoStrict 相关的任何代码、模型或其他工具、任何相关的第三方工具或任何由此产生的输出作出任何陈述或保证。您承担使用任何此类工具或输出的**所有风险**；此类工具均按**"原样"**和**"可用"**的基础提供。此类风险可能包括但不限于知识产权侵权、网络漏洞或攻击、偏见、不准确、错误、缺陷、病毒、停机、财产损失或损害和/或人身伤害。您对自己使用任何此类工具或输出负全部责任（包括但不限于其合法性、适当性和结果）。
