# packages

**Repository Path**: starlight-apk/packages

## Basic Information

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

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-14
- **Last Updated**: 2026-03-14

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

<div align="center">

# 📦 NovaScript Packages

> 官方功能包仓库 · 模块化扩展 · 即装即用

[![License](https://img.shields.io/badge/license-MIT-blue.svg?style=for-the-badge)](LICENSE)
[![Packages](https://img.shields.io/badge/packages-8-green.svg?style=for-the-badge)](.)
[![NovaScript](https://img.shields.io/badge/NovaScript-v1.0.0-purple.svg?style=for-the-badge)](https://github.com/novascript/nova)

---

### 🌍 语言 / Language

[🇨🇳 简体中文](README.md) · [🇺🇸 English](README.en.md)

---

<div align="center">
  <img src="https://raw.githubusercontent.com/novascript/nova/main/assets/packages-banner.svg" alt="Packages Banner" width="100%" />
</div>

[📦 包列表](#-包列表) · [📥 安装](#-安装) · [🔧 开发](#-开发) · [📖 文档](#-文档) · [🤝 贡献](#-贡献)

</div>

---

## 📦 包列表

<div align="center">

| 包名 | 描述 | 版本 | 大小 |
|------|------|------|------|
| [🎨 image-generator](./packages/image-generator/) | 图片生成与编辑 | v1.0.0 | 5KB |
| [📝 code-editor](./packages/code-editor/) | 代码编辑器增强 | v1.0.0 | 6KB |
| [💻 terminal](./packages/terminal/) | 终端模拟器 | v1.0.0 | 7KB |
| [📂 file-manager](./packages/file-manager/) | 文件管理器 | v1.0.0 | 10KB |
| [🧰 utils](./packages/utils/) | 通用工具函数 | v1.0.0 | 3KB |
| [🎨 webui-themes](./packages/webui-themes/) | WebUI 主题包 | v1.0.0 | 5KB |
| [🔐 crypto-extended](./packages/crypto-extended/) | 加密扩展 | v1.0.0 | 8KB |
| [🌐 http-client](./packages/http-client/) | HTTP 客户端增强 | v1.0.0 | 6KB |

</div>

---

## 📥 安装

### 使用 nova 安装（推荐）

```bash
# 安装包
nova install novascript/image-generator

# 安装指定版本
nova install novascript/image-generator@v1.0.0

# 安装多个包
nova install image-generator code-editor terminal
```

### 从 GitHub 安装

```bash
# 克隆仓库
git clone https://github.com/novascript/packages.git
cd packages

# 复制包到 NovaScript 目录
cp -r packages/image-generator ~/novascript/packages/

# 或者使用符号链接
ln -s $PWD/packages/image-generator ~/novascript/packages/
```

### 手动安装

```bash
# 下载包
wget https://github.com/novascript/packages/archive/main.zip
unzip main.zip

# 复制包
cp -r packages-main/packages/image-generator ~/novascript/packages/
```

---

## 🔧 开发

### 创建新包

```bash
# 使用 nova 初始化
nova init my-package --template=package

# 或手动创建
mkdir -p my-package/{src,lib,docs,test}
```

### 包结构

```
my-package/
├── nova.json           # 包配置（必需）
├── README.md           # 包说明（推荐）
├── LICENSE             # 许可证（推荐）
├── src/
│   └── index.sh        # 主入口（必需）
├── lib/                # 库文件（可选）
├── docs/               # 文档（可选）
├── test/               # 测试（可选）
└── assets/             # 资源文件（可选）
```

### nova.json 配置

```json
{
  "name": "my-package",
  "version": "1.0.0",
  "description": "包的描述",
  "main": "src/index.sh",
  "author": "Your Name",
  "license": "MIT",
  "dependencies": {
    "other-package": "1.0.0"
  },
  "keywords": ["keyword1", "keyword2"],
  "os": ["linux", "darwin", "win32"],
  "cpu": ["x64", "arm64", "arm"]
}
```

### 发布包

```bash
# 1. 确保包结构正确
# 2. 提交到仓库
git add my-package
git commit -m "Add my-package"
git push origin main

# 3. 创建 Release（可选）
# 在 GitHub 上创建 Release 标签
```

---

## 📖 文档

### 包开发

- [包开发指南](./docs/DEVELOPMENT.md)
- [包结构规范](./docs/STRUCTURE.md)
- [API 参考](./docs/API.md)

### 包发布

- [发布指南](./docs/PUBLISHING.md)
- [版本规范](./docs/VERSIONING.md)
- [更新日志](./CHANGELOG.md)

### 使用指南

- [安装指南](./docs/INSTALL.md)
- [使用示例](./docs/EXAMPLES.md)
- [常见问题](./docs/FAQ.md)

---

## 🌟 精选包

### 🎨 image-generator

图片生成与编辑功能包。

```bash
nova install image-generator
```

**功能：**
- 创建 .novaimg 格式
- 渐变/纯色/棋盘格生成
- 二维码生成
- ASCII 艺术
- 图片滤镜

### 📝 code-editor

代码编辑器增强功能包。

```bash
nova install code-editor
```

**功能：**
- 语法高亮
- 代码格式化
- 语法检查
- 代码补全
- 代码片段

### 💻 terminal

终端模拟器功能包。

```bash
nova install terminal
```

**功能：**
- 彩色输出
- 进度条动画
- 加载动画
- 表格输出
- TUI 组件

---

## 🤝 贡献

### 提交包

1. Fork 本仓库
2. 创建包目录 `packages/your-package`
3. 确保包结构正确
4. 提交并推送
5. 创建 Pull Request

### 包要求

- ✅ 必须有 `nova.json` 配置
- ✅ 必须有 `src/index.sh` 主入口
- ✅ 必须有 `LICENSE` 文件
- ✅ 必须有 `README.md` 说明
- ✅ 代码必须有注释
- ✅ 遵循 NovaScript 代码规范

### 包审核

提交的包会经过以下审核：

1. **结构检查** - 确保文件完整
2. **功能测试** - 确保功能正常
3. **安全审查** - 确保无安全问题
4. **文档检查** - 确保文档完整

---

## 📊 统计

| 指标 | 数值 |
|------|------|
| 总包数 | 8 |
| 总下载 | 1000+ |
| 贡献者 | 5+ |
| 月更新 | 2+ |

---

## 🔗 相关链接

- [NovaScript 主仓库](https://github.com/novascript/nova)
- [NovaScript 文档](https://novascript.dev/docs)
- [包注册表](https://novascript.dev/packages)
- [问题反馈](https://github.com/novascript/packages/issues)

---

## 📄 许可证

MIT License - 详见 [LICENSE](LICENSE) 文件

---

<div align="center">

### 🌟 感谢使用 NovaScript Packages！

**Packages - Extend Your Possibilities**

[⬆ 返回顶部](#-novascript-packages)

</div>