# 结绳编程-VSC插件

**Repository Path**: knot-community/knot-programming---vsc-plugin

## Basic Information

- **Project Name**: 结绳编程-VSC插件
- **Description**: No description available
- **Primary Language**: Java
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-09-02
- **Last Updated**: 2025-09-02

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 结绳编程-VSC插件

[![VS Code版本](https://img.shields.io/badge/VS%20Code-%5E1.54.0-blue)](https://code.visualstudio.com/)
[![许可证](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)
[![版本](https://img.shields.io/badge/Version-0.0.1-orange)](package.json)

## 📖 介绍
结绳编程-VSC插件是一款专为结绳中文编程语言设计的Visual Studio Code扩展，旨在提升开发者的编码效率。该插件提供了一系列实用功能，包括代码提示、代码检查、语法高亮、多平台编译等，帮助开发者更高效地编写和维护结绳代码。

> **🔄 项目来源**: 本项目基于 [https://gitee.com/scave/Tiecode-VSCode-Plugin](https://gitee.com/scave/Tiecode-VSCode-Plugin) 进行二次开发重构，在原有基础上进行了功能完善和架构优化。

## 🏗️ 软件架构
本插件基于TypeScript和Java构建，利用了Visual Studio Code的强大扩展能力。主要组件包括：

- **CodeServiceKit**: 提供代码服务的核心功能
- **CompilerManager**: 管理编译过程和多平台输出
- **ProjectManager**: 管理项目创建、模板和工程配置
- **OutputManager**: 管理输出信息和诊断信息
- **TiecodeCodeServiceProvider**: 提供智能代码服务

## ✨ 主要特性

### 🎯 语言支持
- ✅ 结绳语言（.t文件）语法高亮
- ✅ 智能代码补全和提示
- ✅ 实时错误检查和警告
- ✅ 快速跳转到定义（F12）
- ✅ 代码格式化和美化

### 🛠️ 开发工具
- 🚀 **多平台编译**: 支持Android、Windows、Web等平台
- 📱 **APK构建**: 直接构建Android应用
- 🎨 **项目模板**: 内置多种项目模板
- 🔧 **集成编译器**: 内置Tiecode-Compiler
- 📊 **实时诊断**: 即时代码错误提示

### 📦 项目管理
- 📋 创建新的结绳工程
- 🏗️ 多平台项目模板（Android、Windows、Web）
- 🔗 绳包（库）管理和依赖
- 📁 智能项目结构识别

## 🔧 安装教程

### 方式一：从VSIX文件安装
1. 在Gitee平台上下载插件包（.vsix文件）
2. 打开Visual Studio Code，点击左侧活动栏中的扩展图标
3. 点击"..."按钮，选择"从VSIX安装..."
4. 选择下载的.vsix文件进行安装

### 方式二：开发者安装
```bash
# 克隆仓库
git clone https://gitee.com/your-repo/tiecode-vscode-plugin.git

# 安装依赖
npm install

# 编译插件
npm run compile

# 在VS Code中按F5启动调试
```

## 📋 系统要求
- Visual Studio Code ^1.54.0
- Node.js（开发时需要）
- Java运行环境（用于编译器）

## 🚀 使用说明

### 基础功能
1. **代码提示**: 在编写代码时，插件会自动提供相关的代码补全建议
2. **代码检查**: 插件会在后台对代码进行实时检查，并在问题出现时提供警告或错误提示
3. **高亮显示**: 关键代码元素会被高亮显示，便于快速识别
4. **转到定义**: 将光标放在变量或函数上，按下F12可以快速跳转到其定义位置

### 命令面板功能
- `结绳: 创建工程` - 创建新的结绳项目
- `结绳: 编译工程` - 编译当前项目
- `结绳: 运行工程` - 运行当前项目
- `结绳: 编译当前文件` - 编译当前文件
- `结绳: 构建APK` - 构建Android APK文件

### 项目结构示例
```
MyTiecodeProject/
├── project.json          # 项目配置文件
├── 源代码/
│   └── 初始代码.t        # 主程序入口
├── 绳包/                 # 依赖库目录
│   └── 基本库/
└── 输出/                 # 编译输出目录
```

## ⚙️ 配置选项

在VS Code设置中可以配置以下选项：

- `tiecode.compiler.useBundled`: 优先使用插件内置的编译器
- `tiecode.compiler.path`: 自定义编译器路径
- `tiecode.android.sdkPath`: 自定义Android SDK路径

## 🔄 开发和构建

### 本地开发
```bash
# 安装依赖
npm install

# 编译TypeScript
npm run compile

# 监视文件变化
npm run watch

# 运行测试
npm test

# 代码格式检查
npm run lint
```

### 打包发布
```bash
# 编译并打包
npm run vscode:prepublish

# 生成VSIX文件
vsce package
```

## 🤝 参与贡献

我们欢迎所有形式的贡献！

1. Fork本仓库
2. 新建Feat_xxx分支
3. 提交代码
4. 新建Pull Request

### 贡献指南
- 提交前请运行 `npm run lint` 检查代码格式
- 确保所有测试通过 `npm test`
- 提交信息请使用中文，格式清晰
- 新功能请添加相应的测试用例

### 致谢
- 🙏 感谢原始项目 [scave/Tiecode-VSCode-Plugin](https://gitee.com/scave/Tiecode-VSCode-Plugin) 提供的基础框架
- 🤝 感谢所有为结绳编程语言生态做出贡献的开发者

## 📊 项目状态

- 🔄 **当前版本**: 0.0.1 (开发中)
- 🎯 **开发阶段**: Alpha
- 📅 **最后更新**: 2025年9月2日

## 🐛 已知问题

- [ ] 大型项目编译性能优化
- [ ] 某些复杂语法的智能提示待完善


## 🗺️ 发展路线

- [ ] v1.0.0: 基础功能完善，正式发布
- [ ] v1.1.0: 添加调试功能
- [ ] v1.2.0: 增强代码重构工具
- [ ] v2.0.0: 支持更多目标平台

## 📚 相关资源

1. 使用Readme_XXX.md来支持不同的语言，例如Readme_en.md, Readme_zh.md
2. Gitee官方博客 [blog.gitee.com](https://blog.gitee.com)
3. 你可以访问 [https://gitee.com/explore](https://gitee.com/explore) 来了解Gitee上的优秀开源项目
4. [GVP](https://gitee.com/gvp) 全称是Gitee最有价值开源项目，是综合评定出的优秀开源项目
5. Gitee官方提供的使用手册 [https://gitee.com/help](https://gitee.com/help)
6. Gitee封面人物是一档用来展示Gitee会员风采的栏目 [https://gitee.com/gitee-stars/](https://gitee.com/gitee-stars/)

## 📄 许可证

本项目采用 MIT 许可证 - 查看 [LICENSE](LICENSE) 文件了解详情。

## 📞 联系我们

- 💬 问题反馈: [Issues](https://gitee.com/your-repo/tiecode-vscode-plugin/issues)
- 📧 邮箱联系: tiecode@example.com
- 🌐 官方网站: [tiecode.com](https://tiecode.com)

---

⭐ 如果这个项目对你有帮助，请给我们一个星标！