项目与工作区

适用版本：StablEdge 0.4.4 及以上

StablEdge 的对话按项目组织。一个项目对应一个文件夹，Agent 默认在这个文件夹里读写文件。工作区里可以同时摆放对话区、编辑器、终端和文件面板，布局由你决定。

新建项目

在侧栏点击「新建项目」，按项目所在位置选择页签：

类型	说明
本地项目	电脑上的一个文件夹。点击「选择文件夹」选择或新建文件夹。
SSH 远程	远端服务器上的目录。先选择一个 SSH 连接，再浏览并选择「远端项目目录」。

1. 选择项目结构：「单项目」或「多项目联调」。
2. 单项目：选好位置后填写「项目名称」，按需勾选「初始化 Git 仓库」，点击「创建项目」。
3. 多项目联调：填写「联调组名称」，从已登记的本地或 SSH 项目中选择成员项目并指定「主项目」，可以为每个成员写一句职责描述，点击「创建联调组」。联调组里的对话可以同时访问所有成员项目。

项目右键菜单可以重命名、置顶或「删除项目」。删除项目只会从 StablEdge 中移除项目和它下面的对话，磁盘上的文件夹和文件会保留。

管理对话

• 在项目下点击「新建对话」。对话可以「新建分组」收纳，分组支持图标和颜色，也可以把对话拖到分组里。
• 侧栏对话的右键菜单里有「引用到新对话」，把这条对话作为参考带进新对话。
• 项目可以按住拖动调整顺序。
• 对话标签的右键菜单可以「向上拆分」「向下拆分」「向左拆分」「向右拆分」，在多个窗格里同时推进几个对话；不用的标签可以「折叠此对话」，收成搜索框旁的一叠。

项目文件

「项目文件」面板显示当前项目的目录树。右键文件或文件夹可以：

• 「新建文件」「新建文件夹」；
• 「在文件管理器中打开」「在集成终端中打开」；
• 「复制绝对地址」「复制相对地址」；
• 「添加到对话」「添加到新对话」，把文件作为附件交给 Agent。

「在项目中搜索」支持区分大小写、全词匹配、正则表达式和按文件名搜索。需要批量替换时，先「预览替换」确认结果，再「应用替换」。

编辑器

在文件面板或对话里点击文件，会在编辑器中打开。编辑器标签分为文件、终端、网页和子代理四种。

• 分屏：标签菜单中选择「向右拆分」或「向下拆分」，最多支持 4 个分屏。「固定标签种类到此分屏」后，勾选种类的新标签都会在这个分屏打开。
• 临时预览：从对话里打开的文件先以「临时预览」显示，需要长期保留时选择「在编辑器中固定」。
• 主页：没有打开标签时显示工作区主页，点击「编辑工作区主页」可以维护「常用网站」和「快捷操作」。
• 按住 Ctrl 点击对话里的文件路径，可以直接在编辑器中打开。

终端

• 点击「新建终端」打开集成终端，默认使用「设置 → 系统 → 默认终端」中选择的 shell。SSH 远程项目会打开远端终端。
• 终端的「命令历史」可以搜索执行过的命令，并「插入到终端」。
• 选中终端里的输出，可以作为引用发给 Agent。
• Agent 默认不能读取你自己打开的终端；需要时在「设置 → Agent」中开启「允许 Agent 读取我的终端日志」。

调整布局

工作区由文件、对话区、编辑器和终端四个板块组成。

1. 点击工作区顶栏的「布局」，选择官方预设：「办公布局」「代码布局」或「仅对话」。
2. 需要自定义时，选择「编辑布局」，把板块拖到目标栏的上下左右任一边重新排布，或者隐藏不需要的板块。
3. 满意后点「保存当前自定义布局」并命名，以后可以在「布局」中直接切换。

Git 状态栏

Git 功能集中在窗口底部的状态栏：项目是 Git 仓库时，可以在这里查看和切换分支、提交、推送与拉取、处理冲突。

CI/CD 有两个入口：

• 状态栏上的 CI/CD 徽章，需要先在「设置 › 远程 › 代码托管账号」里连接；
• 左侧对话栏顶部的 CI/CD 抽屉。

多窗口与岛

• 新建窗口：点击标题栏的「新建窗口」，每个窗口可以独立打开一个项目，或者选择「全局（不关联项目）」。
• 岛：点击标题栏的「岛」，主窗口会收成桌面上的小球。单击小球展开对话胶囊，双击回到完整工作区；有新回复或待你确认的事项时，小球旁会滑出提示。岛的「工作目录」「岛尺寸」「点击外部自动收起」等在「设置 → 岛」中调整。
• 关闭窗口：关闭主窗口时可以选择「最小化到托盘」或「直接退出」，也可以在「设置 → 系统 → 关闭主窗口时」中固定选择。

打开方式

回复里的路径、文件和网址都可以点开，可以选择内置预览、编辑器、VS Code、Office 或系统浏览器等。在「设置 → 打开方式」中可以按文件类型设置「默认打开方式」，也可以临时「选择其他应用…」。