# stcode

**Repository Path**: qhgiteecode/stcode

## Basic Information

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

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-01-29
- **Last Updated**: 2026-02-10

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# STCode

开源的 AI Coding Agent，基于 [opencode](https://github.com/anomalyco/opencode) 二次开发。

> 本项目非 OpenCode 官方项目，与 OpenCode 团队无隶属关系。

---

## 安装

```bash
# 从源码构建
git clone <your-repo-url>
cd stcode
bun install
bun run dev
```

## 桌面应用程序

| 平台                  | 下载文件                              |
| --------------------- | ------------------------------------- |
| macOS (Apple Silicon) | `stcode-desktop-darwin-aarch64.dmg` |
| macOS (Intel)         | `stcode-desktop-darwin-x64.dmg`     |
| Windows               | `stcode-desktop-windows-x64.exe`    |
| Linux                 | `.deb`、`.rpm` 或 AppImage            |

## Agents

STCode 内置两种 Agent，可用 `Tab` 键快速切换：

- **build** - 默认模式，具备完整权限，适合开发工作
- **plan** - 只读模式，适合代码分析与探索
  - 默认拒绝修改文件
  - 运行 bash 命令前会询问
  - 便于探索未知代码库或规划改动

另外还包含一个 **general** 子 Agent，用于复杂搜索和多步任务。

---

## 项目结构

```
stcode/
├── packages/                    # 核心包目录
│   ├── stcode/                 # 🎯 CLI 核心 - 命令行工具主逻辑
│   ├── app/                    # 📱 Web 应用 - 前端界面
│   ├── desktop/                # 🖥️ 桌面应用 - Tauri 封装
│   ├── ui/                     # 🎨 UI 组件库 - 共享组件
│   ├── web/                    # 🌐 Web 服务 - 官网/落地页
│   ├── docs/                   # 📖 文档站点
│   ├── sdk/                    # 📦 SDK
│   │   └── js/                 # JavaScript/TypeScript SDK
│   ├── plugin/                 # 🔌 插件系统
│   ├── console/                # 🎛️ 控制台相关
│   ├── enterprise/             # 🏢 企业版功能
│   ├── identity/               # 🔐 身份认证
│   ├── function/               # ⚙️ 函数服务
│   ├── script/                 # 📜 脚本工具
│   ├── util/                   # 🔧 工具函数库
│   ├── slack/                  # 💬 Slack 集成
│   ├── containers/             # 🐳 容器配置
│   └── extensions/             # 🧩 编辑器扩展
│       └── zed/                # Zed 编辑器扩展
├── sdks/                       # SDK 扩展
│   └── vscode/                 # VSCode 扩展
├── script/                     # 构建/发布脚本
├── nix/                        # Nix 配置
├── patches/                    # 依赖补丁
├── logs/                       # 日志目录
├── .stcode/                    # STCode 配置
├── package.json                # 项目配置
├── turbo.json                  # Turborepo 配置
├── bun.lock                    # Bun 锁文件
└── tsconfig.json               # TypeScript 配置
```

## 开发

```bash
# 安装依赖
bun install

# 启动 CLI 开发模式
bun run dev

# 启动桌面应用开发模式
bun run dev:desktop

# 启动 Web 应用开发模式
bun run dev:web

# 类型检查
bun run typecheck
```

## 技术栈

- **运行时**: Bun
- **构建工具**: Turborepo, Vite
- **前端框架**: SolidJS
- **桌面应用**: Tauri
- **样式**: TailwindCSS
- **语言**: TypeScript

## 许可证

MIT