# lingjie-os

**Repository Path**: xzh_Tim/lingjie-os

## Basic Information

- **Project Name**: lingjie-os
- **Description**: 一个运行在浏览器里的轻量级操作系统，支持窗口管理、锁屏、文件系统和第三方应用安装。内置 16 个应用 且都可以正常使用，界面非常好看。
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2026-08-28
- **Last Updated**: 2026-09-05

## Categories & Tags

**Categories**: Uncategorized

**Tags**: 操作系统, web-os, React

## README

[中文](README.md) · [English](README_EN.md)
# 灵界 1.2026810.916.Extremely unstable

> 一个运行在浏览器里的轻量级操作系统界面，支持窗口管理、锁屏、文件系统、内置应用和第三方应用安装。

> 💡 **几乎完全本地运行**：几乎所有功能不依赖任何服务器，断网可用，但部分功能需要使用联网功能 比如时间校准、天气、翻译等。

---

## ✨ 系统功能

- **🪟 窗口管理**：拖拽、缩放、最小化、最大化，配备精致的毛玻璃视觉效果。
- **🔒 锁屏系统**：支持**滑动解锁**、**4位数字密码**与**手势图案锁**三种模式。
- **📂 文件管理器**：支持文件的创建、删除、修改、重命名及文本内容编辑。
- **🖥️ 桌面系统**：桌面图标与文件管理器路径深度同步。
- **🪐 应用星环**：底部动态应用启动栏，支持应用多窗口同时运行。
- **🔋 电源控制**：包含锁定、重启、关机及定时关机功能。
- **🎨 个性化**：内置 10 种渐变风格壁纸，支持自定义强调色与屏幕亮度。
- **⏱️ 时间校准**：自动联网校准设备时间，确保时间准确，不受用户手动修改影响。
- **💙 蓝屏系统**：全屏错误捕获机制，捕获运行时异常并提供可视化恢复重启。
- **📦 应用安装器**：支持安装与卸载自定义的第三方应用。

---

## 🧩 内置应用（17 个）

| 类型 | 应用列表 |
| :--- | :--- |
| **系统工具** | 文件管理器、翻译、终端、设置、应用安装器 |
| **办公效率** | 笔记、计算器、浏览器 |
| **多媒体** | 音乐、相册、相机、录音 |
| **娱乐游戏** | 井字棋、五子棋、画图 |
| **生活实用** | 时间、天气 |

---

## 📱 第三方应用安装

灵界系统支持开发者通过 `.ljl` 格式制作和安装第三方应用。

### 📦 `.ljl` 包结构规范

`.ljl` 文件本质上是一个 **ZIP** 压缩包，必须包含以下文件结构：

| 文件名 | 必填 | 说明 |
| :--- | :---: | :--- |
| `1.txt` | ✅ | 应用名称（不支持超过 6 个中文字符） |
| `icon.png` / `icon.jpg` 等| ✅ | 应用图标（建议尺寸 128x128）支持目前的所有主流图片格式 |
| `index.html` | ✅ | 应用主页面入口（**必填**） |
| `index.js` | ❌ | 业务逻辑脚本（可选） |
| `index.css` | ❌ | 页面样式文件（可选） |

### 🔨 安装指南

1. 打开系统内置的 **「应用安装器」**。
2. 点击选择本地已有的 `.ljl` 文件。
3. 系统会自动解压文件包，读取元数据（名称、图标）并保存代码。
4. 安装完成后，应用将自动出现在 **空间应用层** 和 **应用星环** 中。
### 5. ⚠️重要提示，1.txt是应用名称，里面直接写应用的名字，不需要加其他任何内容。正确示例:“计算器”

### 🗑️ 卸载指南

进入 **「设置」→「应用管理」**，点击目标应用旁的「卸载」按钮，即可彻底移除应用及其所有本地数据。

---

## 🛠️ 技术架构

- **前端框架**：React 18.3.1
- **数据存储**：localStorage (轻量数据) + IndexedDB (大文件/应用数据)
- **应用隔离**：iframe 沙箱环境 (`sandbox="allow-scripts"`)
- **第三方库**：JSZip (用于解析 .ljl 应用包)

### 🌐 外部 API 接入

部分内置应用会向公开接口发送必要请求（用户数据仍保存在本机）：

- **天气**：Open-Meteo API（城市名）
- **音乐**：iTunes Search API（搜索词，仅 30 秒预览）
- **翻译**：MyMemory Translation API（待译文本）
- **时间校准**：公开时间服务
- **网页搜索**：百度搜索

请遵守各服务方的使用条款。第三方 `.ljl` 应用请只安装可信来源。

---

## 👨‍💻 开发者

**谢子涵**
- 贡献：**所有代码**
- 负责内容：系统整体架构设计、UI/UX 设计、全量内置应用代码编写、助手规则配置。
> 如果你有兴趣参与开发或反馈建议，请通过 Issue 或 PR 与我联系
---

## 📄 许可证

本项目遵循 **MIT License**，按「现状」提供。详见 `LICENSE.txt`。

笔记、照片等用户内容保存在本机。天气、翻译、音乐预览、时间校准、网页搜索会向第三方公开服务发送必要请求。请只安装可信的 `.ljl` 应用。

© 2026 谢子涵