跳到主要内容

应用中心与编辑器导览

Theseus Desktop 以应用中心作为项目入口。打开项目会进入编辑器;打开文件夹会进入应用中心会话,需要编辑器时选择打开编辑器。

应用中心​

启动 Theseus Desktop 后首先进入应用中心。这里用于创建和进入本机项目:

  • 新建项目:在选择的位置创建一个新项目
  • 打开项目:选择本地 .the 项目文件并打开编辑器
  • 打开文件夹:选择本地目录并进入会话,自动识别其中的 Theseus 项目,不自动打开编辑器
  • 导入项目:从 Git 仓库克隆项目
  • 项目:搜索、重命名、拖拽排序,以及重新打开已登记的项目
  • 学习:打开产品文档
  • 系统设置:管理 Desktop 的通用设置和运行目标

在项目列表中,可以选中项目进入其 AI 会话,或选择打开编辑器。右键菜单中的重命名项目只修改列表显示名;移除项目只移除列表记录。这两项操作都不会修改项目目录、.the 文件或项目文档。项目及其展开后的多个 AI 会话都可以拖拽排序。

应用中心右上角的文件面板按钮可展开右侧查看区,默认占工作区宽度的 40%,中间分隔线可拖动。右侧查看区左边显示内容,最右边的资源栏底部有 页面、流程、手册、文件四个标签,默认显示文件树;页面和流程按列表浏览资源,手册列出 manual/ 下的文件,文件标签保留目录层级。顶部可按名称或路径筛选,点击资源在查看区打开;路径栏的文件夹按钮可收起或展开资源栏。普通 UTF-8 文本提供只读高亮、行号和滚动,每个打开的文件有独立标签,可切换、拖动排序或逐个关闭,按下标签即显示对应文件,继续拖动可调整顺序,重复打开会定位已有标签,并自动将标签滚入可视区域;页面和 QG 程序提供对应预览,其他尚未支持的文件会显示无法预览提示。收起面板后对话恢复完整宽度,再次展开保留文件标签,切换项目时清空。此处不提供编辑或保存功能。macOS 用 ⌘W、Windows/Linux 用 Ctrl+W 关闭右侧当前标签;关闭最后一个标签会自动收起右侧面板,再按一次该快捷键关闭窗口。关闭应用中心窗口使用 ⌘⇧W / Ctrl+Shift+W。

编辑器主要区域​

编辑器的标签栏与左右侧栏标题行等高,底部分隔线对齐。

每个编辑器窗口只对应一个项目。需要同时编辑多个项目时,从应用中心分别打开多个编辑器窗口。

编辑器中的主要区域包括:

  • 资源(Resources):管理 Pages、Components、Objects、Scripts、Vision、Safety 和 Assets 等项目资源
  • 文件(Files):按项目路径浏览和编辑文件
  • Git:查看修改并使用版本管理功能
  • 设置(Settings):管理 General、Variables、Queries、I18n、Users / Roles 和已启用模块的设置
  • 中间工作区:打开 Page、QG、Safety、Vision 和文本编辑 Tab
  • 属性面板(Properties):检查和修改当前选中内容的属性
  • 问题 / 控制台(Problems / Console):查看检查结果和操作信息
  • AI Command Center:让 AI 检查或修改当前项目

项目刚打开时,部分编辑能力可能仍在准备。Files、Git、源码和 Settings 可以先使用;Design、Flow 或补全会在准备完成后可用。

系统原生菜单栏提供 文件、编辑、视图、运行、窗口、帮助 六组入口。运行菜单统一放置 Build、Run、Debug、Continue、Stop 和运行目标入口,但不会把 Build 和 Run 隐式合并成一个动作。

返回应用中心​

从 文件菜单选择返回应用中心;也可以点击编辑器左上角的 App 名称,在 App 菜单中选择同一操作。若只想显示应用中心而不关闭当前编辑器,可从窗口菜单选择显示应用中心。

如果窗口中存在未保存草稿、文件冲突或已删除源码,界面会显示离开编辑器?。选择返回会关闭窗口并放弃这些未保存状态;选择取消会留在编辑器。这个确认不会替你保存内容。

认识 Page 的三种模式​

打开一个 Page 后,可以在 Design / Preview / Source 之间切换:

模式用途
Design在画布中调整布局、选择 Component,并在 Properties 中检查属性
Preview直接操作页面;真实调用需要 Run / Debug,失败写入 Console
Source查看和编辑 Page 源码,并处理当前文档的提示

Design 用于查看、编辑和基础交互验证。按住 Alt 操作本地控件;Object / Query 不执行,也不输出跳过调用日志。预览可直接操作页面,Stopped 时调用失败并记录到 Console,Start / Debug 初始化完成后可真实调用。

Design 不需要 Runtime 部署。完整的构建、测试和运行流程见后续章节。

下一步​

继续完成本机快速入门,或者进一步了解编辑器工作区。