# Lxy Code

**Repository Path**: liuxiaoyou/lxy-code

## Basic Information

- **Project Name**: Lxy Code
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-04-02
- **Last Updated**: 2026-04-02

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Lxy Code

AI 对话交互终端 - 基于 Ink 和 React 构建

## 功能特性

- 🎨 漂亮的终端 UI（基于 Ink）
- 🤖 支持任意 OpenAI 兼容的大模型 API
- ⚙️ 简单的配置向导
- 💬 流畅的对话交互体验
- 📝 历史消息展示
- 🔧 可自定义模型参数

## 快速开始

### 前置要求

- [Bun](https://bun.sh) 1.0+

### 安装

```bash
# 克隆项目
git clone https://gitee.com/liuxiaoyou/lxy-code.git
cd lxy-code

# 安装依赖
bun install

# 给入口脚本添加执行权限
chmod +x bin/lxy-code

# 启动
./bin/lxy-code
```

或者直接用 bun 运行：

```bash
bun install
bun run src/index.tsx
```

### 配置

首次启动会自动打开配置向导，你需要配置：

1. **配置名称** - 给你的配置起个名字（如：OpenAI、Claude）
2. **API 地址** - 你的 API 端点（如：https://api.openai.com）
3. **API Key** - 你的 API 密钥
4. **模型名称** - 要使用的模型（如：gpt-4、claude-3-opus）

配置文件保存在：`~/.config/lxy-code/config.yml`

### 支持的 API

任何兼容 OpenAI Chat Completions API 的服务都可以使用，包括：

- OpenAI (GPT-4, GPT-3.5)
- Anthropic Claude (通过兼容层)
- 第三方 API 服务
- 本地部署的模型

## 使用说明

### 基本操作

- **输入消息** - 直接打字输入
- **发送消息** - 按 Enter 键
- **移动光标** - 左右箭头键
- **删除字符** - Backspace / Delete
- **快速跳转** - Home / End 键

### 配置示例

#### OpenAI

```yaml
name: OpenAI
baseUrl: https://api.openai.com
apiKey: sk-xxxxxxxxxx
model: gpt-4
maxTokens: 2048
temperature: 0.7
```

#### 自定义 API

```yaml
name: 我的API
baseUrl: https://api.example.com
apiKey: your-api-key
model: custom-model
maxTokens: 4096
temperature: 0.5
```

## 项目结构

```
lxy-code/
├── bin/
│   └── lxy-code              # 入口脚本
├── src/
│   ├── index.tsx             # 主入口
│   ├── App.tsx               # 主应用组件
│   ├── types.ts              # 类型定义
│   ├── config.ts             # 配置管理
│   ├── api.ts                # API 客户端
│   └── components/
│       ├── MessageItem.tsx   # 单个消息
│       ├── MessageList.tsx   # 消息列表
│       ├── InputBox.tsx      # 输入框
│       └── ConfigWizard.tsx  # 配置向导
├── package.json
├── tsconfig.json
└── README.md
```

## 技术栈

- **运行时**: Bun
- **语言**: TypeScript
- **UI 框架**: React + Ink
- **CLI 解析**: Commander.js
- **HTTP 客户端**: Axios
- **配置格式**: YAML

## 开发

```bash
# 开发模式（监听文件变化）
bun run dev

# 类型检查
bunx tsc --noEmit

# 构建（可选，Bun 可直接运行 TS）
bun build src/index.tsx --outdir dist
```

## 许可证

MIT

## 致谢

- [Ink](https://github.com/vadimdemedes/ink) - React for interactive command-line apps
- [Claude Code](https://claude.ai) - 灵感来源