JSOS
使用指南

内置应用

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
DockDock 位置、自动隐藏
窗口未激活窗口透明度与磨砂模糊(透明度 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 格式打包的,和第三方应用没有任何区别。你可以参考它们的结构来学习应用开发。

On this page