Skip to content

全局设置 ​

description: Rhost 外观、终端、SFTP、端口转发、日志、快捷键、监控与 AI 助手等设置项说明

created: 2026-10-09 19:31:50

updated: 2026-10-12 13:52:29

author: sjzhao

1. 入口 ​

  • 快捷键:⌘,
  • 菜单:应用菜单 → 设置

设置项持久化到 app_config.json 的 settings 节(日志相关字段归入 logs 节),修改后即时写入。

全局设置面板全貌

2. 外观 ​

2.1 界面 ​

设置项取值默认值说明状态
界面主题跟随系统 / 深色 / 浅色深色跟随系统时随系统外观自动切换⚠️ 未开发
强调色颜色值#3ddc84用于按钮、选中态与焦点环✅
背景不透明度60~100(%)96降低数值可获得毛玻璃效果⚠️ 未开发

2.2 启动动画 ​

设置项取值默认值说明
动画时长200~5000(ms)400动画最短展示时间,需等待主界面就绪,重启生效
透明背景开 / 关开开启后 LOGO 悬浮在桌面之上(macOS 依赖私有 API);关闭时使用深色背景。重启生效

3. 终端 ​

终端设置

3.1 字体 ​

设置项取值默认值说明
等宽字体系统已安装字体JetBrains Mono未安装时自动回退到系统等宽
字号10~20(px)13终端字体大小
行高100~200(%)145行高倍数
字重300 / 400 / 500 / 700400字体粗细

3.2 MOTD 横幅 ​

设置项取值默认值说明
登录欢迎面板开 / 关开连接成功后采集服务器负载、内存、磁盘、IP 等状态绘制 MOTD 横幅;开启时自动屏蔽 sshd 原生 MOTD 与 Last login
自定义 LOGOASCII 文本空开启开关后用文本域中的 ASCII art 替换内置 LOGO;最多 30 行、每行 200 字符

3.3 行为 ​

设置项取值默认值说明
彩色提示符开 / 关开为无颜色的远端 shell 配置彩色 PS1;远端已有彩色配置时自动跳过
回滚缓冲区1000~100000(行)10000可向上滚动的历史行数
复制时去除行尾空格开 / 关开复制选中文本时修剪行尾空白
粘贴保护开 / 关关多行粘贴或含控制字符时弹窗确认
断线自动重连开 / 关开网络异常断开时自动重连(1s 起指数退避,封顶 30s);远端主动 exit、手动断开不触发
自动重连次数上限0~20(次)5达到上限后停止并保留标签等待手动重连;0 表示不限
右键行为菜单 / 粘贴菜单终端内右键弹出菜单或直接粘贴

3.4 光标 ​

设置项取值默认值说明
光标样式block / bar / underlinebar方块 / 竖线 / 下划线
光标闪烁开 / 关开空闲 1 秒后开始闪烁

3.5 环境变量 ​

可配置 SSH 会话建立时注入的环境变量,默认注入 EDITOR=nvim 与 LANG=zh_CN.UTF-8。

4. SFTP 文件传输 ​

SFTP 传输设置

4.1 传输 ​

设置项取值默认值状态
传输块大小32 / 64 / 128 / 256 / 512 / 1024 KB64 KB✅
文件覆盖策略仅源更新时覆盖 / 跳过 / 直接覆盖 / 每次询问仅源更新时覆盖⚠️ 未开发
上传临时文件机制开 / 关关⚠️ 未开发
保留文件元数据开 / 关关⚠️ 未开发

4.2 断点续传 ​

设置项取值默认值状态
启用断点续传开 / 关开✅
断点校验方式文件大小 / 大小+mtime / SHA256文件大小⚠️ 未开发

4.3 并发与限速 ​

设置项取值默认值状态
全局最大并发传输任务1~203⚠️ 未开发
单主机最大并发传输任务1~101⚠️ 未开发
全局带宽限速KB/s,0 不限0⚠️ 未开发
单任务带宽限速KB/s,0 不限0⚠️ 未开发
失败重试次数0~203⚠️ 未开发
重试间隔ms1000⚠️ 未开发

4.4 安全与完整性 ​

设置项取值默认值状态
SFTP 会话空闲超时秒,0 不关闭300⚠️ 未开发
传输完成后 Hash 校验开 / 关关⚠️ 未开发
文件黑名单 glob一行一条.DS_Store
Thumbs.db
⚠️ 未开发

4.5 浏览 ​

设置项取值默认值状态
显示隐藏文件开 / 关关✅

5. 端口转发 ​

5.1 规则 ​

设置项取值默认值说明状态
连接后自动启用规则开 / 关关SSH 连接建立后自动启动已保存的转发规则✅
本地端口占用处理终止 / 跳过 / 顺延端口终止监听端口被占用时的处理方式✅
建立失败重试次数0~203转发通道建立失败时的自动重试次数✅

5.2 选项 ​

设置项取值默认值说明状态
通道断开自动重建开 / 关开断线重连成功后按断开前状态恢复转发规则✅
通道保活间隔秒15主连接 RTT 心跳已覆盖该作用⚠️ 未开发
空闲自动断开秒,0 不断开0通道持续无流量超过时长后自动关闭⚠️ 未开发
SOCKS 域名解析位置本地 / 远端本地动态转发中域名在哪一侧解析✅

6. 日志 ​

日志设置

6.1 基本 ​

设置项取值默认值说明
日志采集开 / 关开关闭后不再采集和显示日志
日志级别debug / info / warn / errorinfo低于该级别的日志不会被采集
最大保留行数正整数5000内存中保留的日志行数上限,超出丢弃最旧

6.2 持久化 ​

设置项取值默认值说明
开启持久化开 / 关开关闭后日志仅存内存,退出即丢失
存储路径目录路径空(平台默认)留空使用平台默认目录;修改后需重启
文件命名模板文本rhost_app_${date}.log${date} 按切割策略格式化为日期
切割策略按天 / 按周 / 按月 / 不切割按天按时间切割日志文件
最大文件数量0 不限100超出后删除最旧文件
保留天数正整数30超过后按时间清理旧文件

7. 快捷键 ​

点击任意组合即可重新录制,按 Esc 取消。

7.1 会话 ​

设置项默认值状态
新建标签页⌘+T⚠️ 未开发
关闭标签页⌘+W⚠️ 未开发
垂直分屏⌘+D⚠️ 未开发
水平分屏⌘+E⚠️ 未开发

7.2 操作 ​

设置项默认值状态
清空屏幕⌘+L⚠️ 未开发
命令面板⌘+K⚠️ 未开发
查找⌘+F⚠️ 未开发
打开设置⌘+,⚠️ 未开发

快捷键录制入口已提供,但当前均未绑定实际键盘事件。

8. 监控 ​

监控设置

8.1 性能与采集 ​

设置项取值默认值说明状态
内存采集间隔秒2采集 Rhost 主进程 RSS 用于底部状态栏✅
主机指标采集间隔1~10 秒3采集远端 CPU/内存/网络/磁盘/进程/GPU✅
不可见时暂停采集开 / 关开回首页或窗口最小化时停止内存采集✅

8.2 内存告警 ​

设置项取值默认值说明状态
内存告警阈值MB300主进程 RSS 持续超过该值时状态栏告警✅

9. AI 助手 ​

9.1 功能 ​

设置项取值默认值说明状态
启用 AI 助手开 / 关开关闭后右侧栏隐藏 AI 入口,快捷键随之停用✅

9.2 连接与凭据 ​

设置项取值默认值说明状态
服务商custom / openai / deepseek / ollamacustom选择后自动填充兼容 API 地址,仍可手动修改;均走 OpenAI 兼容协议✅
接口地址 Base URLURL空OpenAI 兼容接口地址✅
API 密钥字符串空已加密存储于系统钥匙串;设置项常态为空,留空表示不修改;Ollama 本地服务可留空✅
模型字符串空命令生成场景推荐使用中等规模模型,延迟更低✅
测试连接按钮—使用面板草稿值(可能尚未保存)请求模型列表,验证地址与密钥是否可用✅

9.3 技能 SKILL ​

技能为用户维护的 Markdown 文件,注入对话上下文供模型参考。文件内容将随对话发送给模型服务商。

设置项取值默认值说明状态
启用技能注入开 / 关开将技能目录下的 .md 文件注入对话上下文✅
技能目录按钮—在系统文件管理器中打开 app_config_dir/ai/skills/;目录首次打开时自动创建✅
技能文件逐条开关全部启用文件名(含扩展名)为稳定标识,重命名文件后需重新设置✅

文件格式与注入规则:

  • 仅扫描目录顶层的 .md 文件(扩展名小写比较);跳过隐藏文件(. 开头)、子目录与符号链接;按文件名字典序注入;
  • 可选 frontmatter 声明 name / description(--- 围栏内逐行 key: value),缺省时名称取文件名去扩展名;
  • 单文件超过 8KB 时只注入前 8KB 并在标题标注「内容已截断」;每类合计注入预算 16KB(UTF-8 字节),超限丢弃靠后文件;
  • 发送对话时实时读取,无需重启应用。

9.4 规则 Rules ​

规则与技能同构,目录为 app_config_dir/ai/rules/,注入顺序先于技能(越稳定的约定越靠前)。

设置项取值默认值说明状态
启用规则注入开 / 关开将规则目录下的 .md 文件注入对话上下文✅
规则目录按钮—在系统文件管理器中打开 app_config_dir/ai/rules/;目录首次打开时自动创建✅
规则文件逐条开关全部启用文件名(含扩展名)为稳定标识,重命名文件后需重新设置✅

9.5 记忆 Memory ​

记忆为应用从对话中自动提取(或用户手动添加)的用户级事实,全局存储、全局注入。记忆内容将随对话发送给模型服务商。

设置项取值默认值说明状态
启用跨会话记忆开 / 关开开启后,智能体将从对话中提取你的偏好与项目上下文,跨会话生效✅
记忆条数上限10~1000100超出后自动淘汰最旧的记录✅
手动添加记忆文本 + 按钮—直接写入一条记忆(≤ 200 字符),随对话注入✅
记忆列表逐条删除—展示内容、创建时间与来源(手动添加 / 全局对话 / 会话),可逐条删除✅
清空记忆按钮—删除全部记忆条目(二次确认),不可恢复✅

存储与注入规则:

  • 存储于 app_config_dir/ai/memory/memory.json(原子写),不参与配置导入导出;解析失败按空记忆降级,不影响对话;
  • 对话正常完成后后台自动提取:未提取新增内容 ≥ 4000 字符时触发,已摘要部分不重复提取;提取失败静默,下轮完成后重试;
  • 单条记忆 ≤ 200 字符;注入合计预算 8KB(UTF-8 字节),超限时从最旧开始丢弃并标注;
  • 提取指令禁止记录密码、私钥、API Key、Token 等敏感凭据。

9.6 终端执行 ​

设置项取值默认值说明状态
允许多行命令直接执行开 / 关关关闭时,含多行的命令仅可插入终端人工编辑;开启后多行命令整块提交执行✅
执行结果自动回传开 / 关关开启后,AI 提案命令执行完成时自动捕获终端输出回传给模型,实现自主多步执行;关闭时保持零回传(隐私优先)✅
直接执行确认always / risky / neverrisky每次确认 / 高危命令确认 / 不确认✅
自定义高危关键词一行一条空命令包含任一关键词(或内置高危规则,如 rm -rf、mkfs)时需确认;支持 # 注释行✅

10. 关于 ​

设置项取值默认值说明
自动更新开 / 关开检测到新版本时自动更新
更新通道stable / beta / devstable选择更新接收的通道

11. 下一步 ​