从装好，到会用。
安装、第一次设置、六步上手、语音、安全审批、数据备份、故障速查 —— 一页看完。 遇到这一页没写到的，直接问赛格斯本人：他读过自己的说明书。
01 · 安装两个文件，一个文件夹。
把两个文件放进同一个文件夹
一个安装程序 SEGUS-Desktop-Setup-1.22.2-Lite.exe，一个数据分卷
SEGUS-Desktop-Setup-1.22.2-Lite-1.bin。两个必须同目录，别改分卷名。
双击安装程序
安装程序会自动读取旁边的分卷，一路下一步即可；过程中不需要联网下载运行环境。
装完从桌面或开始菜单打开
程序装进 %LOCALAPPDATA%\SEGUS；你的数据另存在
%APPDATA%\SegusData（数据库 / 日志 / 配置），卸载不会动它。
02 · 首次设置打开就会问你 4 件事。
第一次打开会弹一段引导，把这 4 项配好，后面就不用再管：
模型路由
填一个云端模型的 Key，或启用本机 Ollama。填完就能对话；Key 存在本机，用 DPAPI 加密。
资料库路径
指向你的笔记库（Obsidian Vault 也可以）作为知识库目录；没有笔记库就先跳过。
知识库初始化
首次启动会自动建库，多半默认即可；只有想换位置时才需要改。
云端模型 Key（可选）
要多接几家云端模型再填；只用一个模型、或用 Ollama 本地模型，可以先跳过。
03 · 六步上手会聊天，也会动手。
先接模型
核心阵列 → ＋ 添加模型 → 选厂商（DeepSeek / 智谱 / 通义…）→ 填 Key，即填即用； 装了 Ollama 可一键启用本地模型。
文本对话
左侧「通信频道」直接输入，他会自己完成「理解 → 计划 → 调用工具 → 总结」。 写操作会弹审批，去「武器系统 · 待指挥官授权」批准后才执行。
语音对话
说「赛格斯」唤醒 → 声纹确认 → 直接下指令；再说一次「赛格斯」即可打断， 播报时直接开口说话也能打断。
沉浸模式
左上角顶栏的「经典 / 沉浸」切换里点「沉浸」，切到全屏语音工作台： 麦克风常开、武器库、呼吸灯都在。
记笔记 / 查资料
舰桥 → 数据舱 指向你的笔记库，对话会自动检索知识库；多轮确认后才沉淀为长期记忆。
扩展能力
技能库（市场安装 · 沙箱 · 签名校验）/ 巡航舱（浏览器自动化）/ IDE 工坊（改代码）/ 边缘设备（多端接入），按需用。
还有两样不在六步里：悬浮球（托盘菜单 →「悬浮球」，透明置顶小窗随手发指令）与 语音审批（工具要批准时他会念出问句，你回一句「批准 / 可以」即放行，全程脱手）。
04 · 语音三步，开口就能聊。
选麦克风
舰桥 → 语音 → 指定麦克风设备。设备选错是最常见的「语音没反应」原因。
让语音壳在前台
语音壳需要在前台运行；最小化到托盘一般也可以，被系统休眠后重启一次语音壳即可。
说「赛格斯」，然后直接说
唤醒并做声纹确认后直接下指令。播报优先走高音质本地合成，长文本自动降级。
打断是双通道
| 打断方式 | 怎么触发 | 开关 |
|---|---|---|
| 关键词打断 | 再说一次「赛格斯」 | 始终开启 |
| VAD 语音打断 | 播报时你直接开口说话 | JARVIS_VAD_BARGEIN=0 可关 |
06 · 安全模型要动你的东西，先问你。
每个工具调用都会先归到一个安全等级，等级决定它要不要你点头：
| 等级 | 含义 | 典型操作 | 是否需要审批 |
|---|---|---|---|
| L0 | 只读 | 检索、读文件、查状态 | 不需要，直接执行 |
| L1 | 可恢复写入 | 写文件、改笔记 | 需要（可撤销，走时间线） |
| L2 | 外部影响 | 点击、输入、浏览器操作 | 需要 |
| L3 | 敏感 | 敏感 / 不可逆操作 | 需要 |
所有调用都进审计链
每一次工具调用都会落进审计链（HMAC 篡改检测级），随时可在「航行日志」里查 —— 事后能对账，而不是「它说做了就做了」。
文件白名单
默认可读：程序目录 + 桌面 + 下载。默认可写：程序目录 + 桌面。
改法：舰桥 → 数据舱（路径矩阵）里的「文件读取 / 写入白名单」，
或改 .env 的 JARVIS_FILE_READ_DIRS / JARVIS_FILE_WRITE_DIRS（分号分隔）。
07 · 数据东西都在哪，怎么带走。
| 路径 | 是什么 | 卸载时 |
|---|---|---|
%LOCALAPPDATA%\SEGUS | 程序目录：代码 + 启动器 | 会删（重装即回） |
%APPDATA%\SegusData | 数据目录：数据库 / 日志 / 配置 | 不删 —— 记忆、知识库、密钥密文都在这里 |
%APPDATA%\SegusData\logs | 日志目录：排障第一现场 | 不删 |
备份 / 恢复 / 升级
- 立即备份：舰桥 → 系统维护 →「立即备份」，数据库在线一致备份，不用停服务。
- 恢复旧数据：舰桥 → 系统维护 → 备份列表 → 恢复，挑一个备份点回滚。
- 检查更新：托盘菜单 →「检查更新」，或舰桥 → 系统维护 →「检查更新」。
- 环境体检：舰桥 → 系统维护。升级前建议先跑一次，缺件先补齐。
升级时会自动备份 → 数据库 schema 迁移 → 写版本记录。
密钥怎么加密
用 Windows DPAPI 以当前账户的主密钥加密，落盘是 dpapi: 前缀的密文，不写明文。
密文绑定「本机 + 当前账户」—— 拷到别的机器解不开，这正是目的。
换机器时在新机器上重新填一次 Key 即可（约 30 秒）。
08 · 常见问题先看这里，再翻日志。
| 症状 | 最可能的原因 | 怎么处理 |
|---|---|---|
| 打开界面一直转圈 | 首次加载模型需要 30–90 秒 | 先等满 90 秒；仍不行看 %APPDATA%\SegusData\logs |
| 语音不响应 | 麦克风没指定，或语音壳不在前台 | 舰桥 → 语音 指定设备；让语音壳前台运行；说「赛格斯」 |
| 工具点了没反应 | 写操作正在等你批准 | 去「武器系统 · 待指挥官授权」批准（安全设计） |
| 浏览器打不开 / 点不动 | 本机没有 Chrome / Edge 或没有 CDP 通道 | 装一个 Chrome / Edge；无 CDP 时会自动降级为只读抓取 |
| 换机器后提示密钥无效 | DPAPI 密文绑定原机器 / 原账户 | 新机器重新填一次 Key（预期行为） |
日志里的 [WARN] 大多不是崩溃
它表示「某项能力没装配上，已自动降级」，每条都会写明降级的后果：
| 日志原文（节选） | 含义与影响 |
|---|---|
| 视觉大脑注册失败 | 看屏幕 / 点界面不可用，其余功能正常 |
| 浏览器工具注册失败 | 浏览器自动化整层不可用（多半缺 Chrome / Edge 或依赖） |
| MCP 初始化失败 | 依赖 MCP 的外部工具不可用；检查 config/mcp.yaml |
| UndoStore 初始化失败 | 多级撤销退化为单层，写文件仍可用 |
| embedding 注册失败 | 语义检索退化为纯关键词检索 |
自助三件事
- 看日志：
%APPDATA%\SegusData\logs，报错原文都在里面。 - 跑体检：舰桥 → 系统维护 → 环境体检，它会直接告诉你缺哪一件。
- 确认后端在跑：浏览器打开
127.0.0.1:8077/ui；打不开就从托盘菜单重启。
09 · 工具手册他能用的工具，按类速查。
完整的工具手册（每类工具的参数与示例）随安装包放在 apps/desktop/static/guides/manual.html，
也可以在应用内打开。下面是一页速查：
文件与目录
列目录、读文件（支持分段续读）、写文件、全盘找文件。白名单外碰不到。
浏览器与网页
内置浏览器：多标签、导航、点击、输入、截图、读取页面；无 CDP 时降级只读。
电脑操作与视觉
看屏幕、认窗口与控件、点按钮、填输入框、处理菜单与弹窗。
文档、表格与演示
Word / Excel / PPT / PDF 的读写与生成，做完在预览台打开。
影音
音频 / 视频文件的处理与转换（按已装组件决定可用范围）。
记忆与知识库
长期记忆、笔记沉淀、语义召回，支持 Obsidian 库。
技能与工具市场
用 Git 地址或本地目录装技能；插件市场挑着装；沙箱与签名校验。
任务与自动化
定时提醒、每日简报、长期任务看板、后台任务。
设备、账号与外部服务
多设备接入、企业微信等外部通道（按配置启用）。
MCP 桥接
本机启动的 MCP 服务与 Streamable HTTP 远程服务；连上就多一整套工具。