应用中心与编辑器导览
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 部署。完整的构建、测试和运行流程见后续章节。