使用指南
内置应用
JSOS 预装应用介绍
内置应用
JSOS 预装了以下应用,开箱即用。
终端 (dev.jsos.terminal)
基于 sh 的交互式 Shell(CLI 应用)。你可以用它:
ls -la
cd workspace/apps
npm install
node --version
jsos app list所有命令都在 WebContainer 沙箱中执行,不会影响你的电脑。
文件管理器 (dev.jsos.filemanager)
浏览和管理 WebContainer 内的文件。支持:
- 目录导航(面包屑 + 路径跳转)
- 文件查看、上传与下载
- 浏览应用目录(
workspace/apps)和数据目录(workspace/data) - 桌面小组件:磁盘统计(
disk-info)、拖拽上传(drag-upload)
应用管理器 (dev.jsos.appmanager)
管理已安装的应用。提供:
- 已安装应用列表与应用详情(版本、作者、仓库、目录路径等)
- 安装应用:本地 ZIP、远程 URL、GitHub Release
- 卸载应用(可选择同时删除数据)
- 导出应用快照包
- 为应用添加桌面小组件
应用商店 (dev.jsos.appstore)
浏览应用商店并一键安装第三方应用:
- 按分类筛选、搜索应用
- 按下载量 / 更新时间排序
- 已安装的应用显示版本状态与更新提示
设置 (dev.jsos.settings)
系统设置应用,包含以下页面:
| 页面 | 说明 |
|---|---|
| 关于 | 系统版本等运行环境信息 |
| 壁纸 | 每个工作区独立设置壁纸(默认 / 图片 / 视频,支持遮罩与模糊) |
| 主题 | 亮色 / 暗色 / 跟随系统 |
| 语言 | 中文 / English |
| Dock | Dock 位置、自动隐藏 |
| 窗口 | 未激活窗口透明度与磨砂模糊(透明度 20–100%,默认 90%;模糊 0–30px,默认 8px) |
| 终端背景 | 终端背景透明度与模糊度 |
| 代理 | CORS 代理配置(供跨域请求使用) |
| 持久化 | 管理持久化目录(添加 / 重命名 / 移除,含目录浏览器) |
| 备份 | 导出 / 导入 / 清空系统数据 |
浏览器 (dev.jsos.browser)
内置浏览器,重点服务于 WebContainer 内部 HTTP 服务:
- 起始页列出当前运行的服务(图标、名称、端口),每 3 秒刷新
- 地址栏可直接输入
127.0.0.1:4000、应用 ID(dev.jsos.settings)或应用名称(设置) - 自动隐藏 Daemon 端口(1993)、浏览器自身的服务以及已停止的端口,避免嵌套和无用条目
- 应用页面中的
target="_blank"链接与window.open会被拦截,改为在新的浏览器窗口中打开 - 终端中启动的未注册 HTTP 服务(端口 ≥ 3000)被检测到时,会自动在新浏览器窗口打开对应地址(同一端口只自动打开一次)
- 外部网站作为次要功能,通过
<iframe credentialless>嵌入(见嵌入外部网页)
文档 (dev.jsos.docs)
你现在正在看的就是文档应用。它本身也是一个 JSOS 应用,使用 fumadocs 构建,支持全文搜索,并提供桌面小组件(文档导航)。
这些内置应用也是用同样的 ZIP 格式打包的,和第三方应用没有任何区别。你可以参考它们的结构来学习应用开发。