# cc-connect-codefree

**Repository Path**: ruanliangbin/cc-connect-codefree

## Basic Information

- **Project Name**: cc-connect-codefree
- **Description**: CodeFree CLI 与飞书集成，支持多轮对话和上下文记忆
- **Primary Language**: Python
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-11
- **Last Updated**: 2026-03-12

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# cc-connect-codefree

## 简介

cc-connect-codefree 是一个将 CodeFree CLI 集成到 cc-connect 的解决方案，支持通过飞书与 CodeFree 进行交互。

## 版本

当前版本：**v1.1.0**（最新）

## 特性

### v1.1.0 新增特性

- ✅ **流式对话支持**：实时显示 AI 回复，无需等待完整生成
- ✅ **智能编码检测**：自动检测输出编码，确保中文正确显示
- ✅ **多线程处理**：使用独立线程处理输出，提高性能
- ✅ **进度反馈**：实时显示处理进度
- ✅ **更快响应**：用户可以提前看到部分内容

### 基础特性（继承自 v1.0.0）

- ✅ 基于文本文件的对话历史管理
- ✅ 简单的会话恢复功能
- ✅ 基础的消息格式转换
- ✅ 支持多编码自动检测
- ✅ 详细的调试日志
- ✅ 使用 skills 目录结构

## 快速开始

### 1. 系统要求

- Windows 10/11
- Python 3.7+
- Node.js 14.0+
- cc-connect
- CodeFree CLI

### 2. 安装

#### 2.1 安装 Python

访问 [Python 官网](https://www.python.org/downloads/) 下载并安装 Python 3.7 或更高版本。

**重要**：安装时务必勾选 "Add Python to PATH"。

#### 2.2 安装 CodeFree CLI

```bash
npm install -g codefree-cli
```

#### 2.3 安装 cc-connect

访问 cc-connect 官方仓库下载并安装。

### 3. 配置

详细的配置步骤请参考：
- [V1.1_INTEGRATION_GUIDE.md](V1.1_INTEGRATION_GUIDE.md) - v1.1.0 完整集成指南（推荐）
- [V1_INTEGRATION_GUIDE.md](V1_INTEGRATION_GUIDE.md) - v1.0.0 集成指南

### 4. 部署

#### v1.1.0（推荐，支持流式对话）

```bash
mkdir "%USERPROFILE%\.cc-connect\skills\codefree"
copy v1.1.0\gemini-wrapper-v1.1.bat "%USERPROFILE%\.cc-connect\skills\codefree\"
copy v1.1.0\gemini-wrapper-v1.1.py "%USERPROFILE%\.cc-connect\skills\codefree\"
```

#### v1.0.0（稳定版本）

```bash
mkdir "%USERPROFILE%\.cc-connect\skills\codefree"
copy v1.0.0\gemini-wrapper.bat "%USERPROFILE%\.cc-connect\skills\codefree\"
copy v1.0.0\gemini-wrapper.py "%USERPROFILE%\.cc-connect\skills\codefree\"
```

### 5. 测试

#### v1.1.0 测试

```bash
cd C:\Users\Administrator\.cc-connect\skills\codefree
gemini-wrapper-v1.1.bat -p "测试流式对话"
```

#### v1.0.0 测试

```bash
cd C:\Users\Administrator\.cc-connect\skills\codefree
gemini-wrapper.bat -p "测试"
```

## 文档

### v1.1.0 文档（推荐）
- [V1.1_INTEGRATION_GUIDE.md](V1.1_INTEGRATION_GUIDE.md) - v1.1.0 完整集成指南
- [v1.1.0/README.md](v1.1.0/README.md) - v1.1.0 版本说明

### v1.0.0 文档
- [V1_INTEGRATION_GUIDE.md](V1_INTEGRATION_GUIDE.md) - v1.0.0 集成指南
- [V1_CONFIG_SUMMARY.md](V1_CONFIG_SUMMARY.md) - v1.0.0 配置总结
- [v1.0.0/README.md](v1.0.0/README.md) - v1.0.0 版本说明

## 目录结构

```
cc-connect-codefree/
├── README.md                    # 项目说明
├── LICENSE                      # 许可证
├── .gitignore                   # Git 忽略文件
├── V1.1_INTEGRATION_GUIDE.md    # v1.1.0 集成指南
├── V1_INTEGRATION_GUIDE.md      # v1.0.0 集成指南
├── V1_CONFIG_SUMMARY.md         # v1.0.0 配置总结
├── v1.1.0/                      # v1.1.0 源代码（推荐）
│   ├── gemini-wrapper-v1.1.bat  # 批处理文件
│   ├── gemini-wrapper-v1.1.py   # Python 脚本（支持流式）
│   └── README.md                # v1.1.0 版本说明
└── v1.0.0/                      # v1.0.0 源代码（稳定）
    ├── gemini-wrapper.bat       # 批处理文件
    ├── gemini-wrapper.py        # Python 脚本
    └── README.md                # v1.0.0 版本说明
```

## 故障排除

### 常见问题

1. **Python 未找到**
   - 检查 Python 路径是否正确
   - 使用 `where python` 查找 Python 路径

2. **CodeFree CLI 未找到**
   - 检查 CodeFree CLI 路径是否正确
   - 使用 `where codefree` 查找 CodeFree CLI 路径

3. **编码错误**
   - v1.0.0 已内置多编码自动检测功能
   - 查看日志文件获取详细信息

### 调试技巧

```bash
# 查看调试日志
type C:\Users\Administrator\.cc-connect\converter-debug.log

# 查看对话历史
type C:\Users\Administrator\.cc-connect\skills\codefree\conversation_history.txt

# 清除对话历史
type nul > C:\Users\Administrator\.cc-connect\skills\codefree\conversation_history.txt
```

## 版本历史

### v1.1.0 (2026-03-12) - 最新版本

- ✅ 新增流式对话支持
- ✅ 实时显示 AI 回复
- ✅ 智能编码检测
- ✅ 多线程处理
- ✅ 进度反馈
- ✅ 更快响应体验
- ✅ 完全兼容 v1.0.0 功能

### v1.0.0 (2026-03-12)

- ✅ 初始版本发布
- ✅ 基于文本文件的对话历史管理
- ✅ 简单的会话恢复功能
- ✅ 基础的消息格式转换
- ✅ 支持多编码自动检测
- ✅ 详细的调试日志
- ✅ 使用 skills 目录结构

## 贡献

欢迎提交 Issue 和 Pull Request！

## 许可证

请参考 [LICENSE](LICENSE) 文件。

## 联系方式

- 项目维护者：CodeFree Integration Team
- 问题反馈：请提交 Issue

---

**最后更新**: 2026-03-12
**当前版本**: v1.1.0