# shouchakoudai

**Repository Path**: rycwj/shouchakoudai

## Basic Information

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

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-11-01
- **Last Updated**: 2026-11-07

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 手插口袋

个人 AI 办公桌面助手。把 Agent 对话、项目文件、代码编辑、终端、Git、任务执行与 IM 渠道交付装进同一个工作台。

桌面端基于 Tauri 2 + React 18 + TypeScript，引擎为 Java（Solon 框架 + Solon AI，兼容 Java 8+ 运行时）。

> 本项目 fork 自开源项目 [SolonCode](https://gitee.com/opensolon/soloncode) 并已全面品牌独立：安装标识、数据卷、更新通道与原版互不相通，可同机共存。许可证沿用原项目 MIT。

## 界面预览

| 主工作台（对话 + 工具面板） | 设置中心（外观 / 模型 / 渠道绑定） |
| --- | --- |
| ![主工作台](docs/images/desktop-main.png) | ![设置中心](docs/images/desktop-settings.png) |

## 架构

当前形态为「引擎单体 + 桌面壳」双进程：

```
┌────────────────────────────────┐
│ KoudaiDesktop（Tauri 壳）        │
│  React 前端 + Rust 本地能力层    │
└───────────────┬────────────────┘
                │ HTTP /api/v1/* + WebSocket
                │ localhost:7890（被占自动 +1 顺延）
                ▼
┌────────────────────────────────┐
│ koudai-engine（Java / Solon）    │
│ Agent 运行时 + 模型接入 + 工具集 │
└────────────────────────────────┘
```

壳负责窗口、文件系统、终端与引擎生命周期托管；引擎负责 Agent 执行、模型调度、会话与凭据存储。历史形态中的 CLI/Web 入口已退役。

## 主要能力

- **Agent 对话** — 多供应商模型管理、实时流式回复、附件与工作区上下文、排队续跑
- **工作模式** — 审批执行、自动编辑、只读规划、Goal 长任务
- **可靠会话** — 持久历史、长期记忆、回溯重做、工作区检查点
- **开发工具** — 文件树、Monaco 编辑器、内置终端、Git 工作流、任务清单、全局搜索
- **可扩展运行时** — 技能 / Agent / MCP / 自动化，市场拉取
- **IM 渠道** — 飞书 / 钉钉 / 企业微信扫码绑定，任务结果渠道交付
- **多空间多账号** — 空间侧边栏、账号卷隔离、审批中心

## 从源码构建

```bash
# 1) 构建引擎（产物 soloncode-engine/target/koudai-engine.jar）
mvn clean package -DskipTests

# 2) 桌面端
cd soloncode-desktop
npm install
npm run tauri:dev          # 开发模式，壳自动拉起引擎
npm run package -- windows # 打安装包（可选 mac / linux）
```

Windows 产物为 `KoudaiDesktop_<版本>_x64_zh-CN.msi`（NSIS EXE 同步产出）。

## 数据位置

| 位置 | 用途 |
|---|---|
| `~/.koudai` | 用户卷：技能、Agent、config.yml、AGENTS.md、bin/koudai-engine*.jar |
| `~/.koudai-engine` | 引擎卷：账号数据、会话、凭据、引擎日志 |
| `%LOCALAPPDATA%\com.koudai.desktop` | WebView 数据（主题、皮肤、会话映射） |
| `<工作区>/.koudai` | 工作区卷 |

从旧版 SolonCode 升级：首次启动自动迁移（用户卷合并复制、WebView 目录继承、工作区卷改名），旧数据保留不删。

## 常用环境变量

| 变量 | 作用 |
|---|---|
| `KOUDAI_ENGINE_HOME` | 覆盖引擎卷位置（默认 `~/.koudai-engine`） |
| `KOUDAI_ENGINE_PORT` | 覆盖引擎端口（默认 7890） |
| `KOUDAI_ENGINE_JAR` | 指定引擎 jar 路径（开发调试用） |
| `KOUDAI_SKIP_MIGRATE` | 置 1 跳过旧版数据迁移 |

## 目录结构

```
├── soloncode-engine      # 引擎（Agent 运行时，Java/Solon）
├── soloncode-desktop     # 桌面壳（Tauri + React）
├── soloncode-sdk-java    # 嵌入式 Java SDK（独立库）
├── soloncode-plugins     # 插件（auth 等）
├── examples              # 扩展示例
└── docs                  # 设计与实施文档
```

## 更新通道

桌面端「检查更新」指向自有发布仓库 [gitee.com/rycwj/shouchakoudai](https://gitee.com/rycwj/shouchakoudai)，不会回落任何上游地址；首个 release 发布前显示无可用更新，发布后通过 `koudai-desktop_{版本}_zh-CN.msi` 资产自动升级。

## 许可证

MIT（沿用上游 SolonCode，见 [LICENSE](LICENSE)）。