# solondevx

**Repository Path**: opensolon/solondevx

## Basic Information

- **Project Name**: solondevx
- **Description**: solondevx is coding agent
- **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-15

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

<div align="center">

<img src="logo.png" alt="Solon DevX" width="120" />

# Solon DevX

**Solon AI 原生的 AI 编程工作台**


[![Version](https://img.shields.io/badge/version-v0.1.0--alpha-blue)](https://github.com/opensolon/soloncode-app)
[![License](https://img.shields.io/badge/license-MIT-green)](LICENSE)
[![Java](https://img.shields.io/badge/Java-21%2B-orange)](https://adoptium.net/)
[![Node](https://img.shields.io/badge/Node-18%2B-brightgreen)](https://nodejs.org/)


[English](README.en.md)

</div>

---

## 介绍

Solon DevX 是 [Solon AI](https://github.com/opensolon/solon-ai) 原生的 AI 编程工作台，面向**国产化**、**私有化**与**多协议**开发场景。

它不是通用聊天工具，也不是多个外部 coding runner 的聚合入口。Solon DevX 以本地工程项目为核心，把模型接入、Agent 模板、Skill / MCP 工具体系、Runtime 事件、权限审批和代码变更审查统一到一个可扩展的本地工作台中。

**核心链路：**

```text
Workspace → Thread → Turn → Run → ThreadEvent → ChangeSet / Artifact
```

桌面端负责交互与可视化，Java Runtime 负责 Agent 执行、模型管理、Workspace 访问、审批和事件流。Runtime 原生集成 Solon AI Harness，不在前端或桌面壳中重写 Agent Loop。

---

## 模块

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

---

## 核心能力

- 🏠 添加和切换本地项目 Workspace
- 🧵 创建持续代码任务，而不是一次性聊天会话
- 🤖 在项目 Workspace 中运行 Solon AI Agent
- 🌐 接入国产模型、私有模型网关和 OpenAI-compatible 模型服务
- 🔧 管理 Skill / MCP / REST API 等多协议工具扩展
- 📡 流式展示模型输出、工具调用、命令日志、审批和错误
- 📂 查看任务产生的文件变更、Git Diff 和 Artifact
- 🔒 默认本地保存项目数据，适配私有化开发环境

---

## 架构

```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 21+ · Node 18+ · Rust Toolchain · Maven 3.9+

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

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

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

---

## 文档

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

---

## 贡献

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

---

## 版权说明

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

---

## 许可证

MIT License · 详见 [LICENSE](LICENSE)