# soloncodex

**Repository Path**: opensolon/soloncodex

## Basic Information

- **Project Name**: soloncodex
- **Description**: soloncodex
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-05-03
- **Last Updated**: 2026-05-03

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

<div align="center">
<h1>Solon Codex</h1>
<p>开源的下一代 VibeCoding 工作台，基于 <a href="https://github.com/opensolon/solon-ai">Solon AI</a> 构建。</p>
<p>最新版本：v2026.4.28</p>
<p><a href="README.en.md">English</a></p>
</div>

Solon Codex 是基于 Solon AI 构建的下一代 VibeCoding 工作台。

它不是一个简单的聊天界面，而是围绕项目、任务、运行、事件和代码变更组织 AI 编程过程。开发者可以在桌面端管理项目上下文、选择模型和 Agent、观察工具执行、审批高风险操作，并审查 AI 产生的代码变更。

核心工作流：

```text
Project -> Task -> Run -> Event -> Change
```

桌面端负责交互和可视化，Java Runtime 负责 Agent 执行、模型管理、workspace 访问、审批和事件流。

## 模块

```text
soloncodex/
├── desktop/    # React + TypeScript + Tauri 桌面客户端
├── runtime/    # Java + Solon + Solon AI 本地运行时
└── docs/       # 架构、产品、验收文档
```

## 核心能力

- 添加和切换本地项目。
- 创建代码任务，而不是一次性聊天会话。
- 在项目 workspace 中运行 Solon AI Agent。
- 流式展示模型输出、工具调用、命令日志、审批和错误。
- 查看任务产生的文件变更和 Git diff。
- 配置 OpenAI-compatible 和国产模型服务。
- 默认本地保存项目数据。

## 架构

```text
React / TypeScript UI
        │
Tauri / Rust shell    (窗口、原生桥接、Java 进程管理)
        │
Java runtime          (HTTP + WebSocket on 127.0.0.1)
        │
Solon AI Harness      (ChatModel, ReActAgent, Skills, HITL, Sessions)
```

Runtime 负责 Agent 执行、模型管理、workspace 访问、审批、任务状态和事件流。桌面端负责展示、交互、原生壳能力和本地进程管理。

## 本地开发

环境要求：Java 8+、Node 18+、Rust toolchain、Maven 3.9+。

```bash
# 1. 构建 Java Runtime
mvn -pl soloncode-runtime -am package

# 2. 另开一个终端，启动桌面端开发模式
cd soloncode-desktop
npm install
npm run tauri:dev
```

Runtime 默认监听 `127.0.0.1:17070`，Tauri 壳会自动发现它。

## 文档

- [产品定义](docs/product/soloncode-desktop-product.md)
- [MVP 范围](docs/product/soloncode-desktop-mvp.md)
- [桌面端架构](docs/architecture/soloncode-desktop-architecture.md)
- [Runtime API](docs/architecture/soloncode-runtime-api.md)
- [快速开始](docs/roadmap/soloncode-desktop-quickstart.md)
- [MVP 验收清单](docs/roadmap/soloncode-desktop-mvp-acceptance.md)

## 贡献

提交 PR 前请先阅读 [Solon 贡献指南](https://solon.noear.org/article/623)。

## 版权说明

本项目的桌面端前端在 [desktop-cc-gui](https://github.com/zhukunpenglinyutong/desktop-cc-gui) 基础上修改而来。相关版权声明见 [NOTICE](NOTICE) 和 [soloncode-desktop/LICENSE](soloncode-desktop/LICENSE)。

## 许可证

MIT License。详见 [LICENSE](LICENSE)。