开始使用 Unfour

1. 1 从下载页安装 Unfour：Windows 可选 Microsoft Store 或独立安装包，macOS 使用对应架构的 DMG。Linux x64 AppImage 仍为实验性，详见下方安装说明。
2. 2 启动 Unfour，保留标题区域的默认工作区。在左侧导航打开 API Client，点击空白页的“新建请求”或请求标签栏旁的“+”。本地使用无需账户或 Pro 订阅。
3. 3 在方法选择框选择 GET，在 URL 输入框填写 https://httpbin.org/get。打开 Auth，选择 No Auth，请求体留空，不添加凭据、自定义请求头、查询参数或脚本。点击 URL 旁的“发送”（Send）。这会向公开的第三方服务发送一次只读测试请求，无需访问 Demo Lab。
4. 4 在响应面板检查 HTTP 200，以及 JSON 响应体中的 url 是否为 https://httpbin.org/get；查看响应头和耗时。这些是预期结果，不保证外部服务始终可用。请求失败时，按下方排查说明处理。
5. 5 点击“发送”旁的保存图标。在对话框中将请求名填为 First GET，保留默认集合或选择其他集合，然后点击“保存”（Save）。从 API 侧栏重新打开 First GET，确认方法和 URL 已保存。

https://httpbin.org/get

超时、DNS 错误或 HTTP 5xx 可能来自网络或公开演示服务。检查 URL，尝试在浏览器中打开，并与网络管理员确认当前网络是否需要代理。浏览器收到响应不代表桌面请求成功。证书错误时，请与网络管理员核对设备时间和受信任证书，保持 TLS 验证开启。

如果 httpbin 不可用，可以使用本地替代方案。已安装 Node.js 时，在独立终端运行下面的命令并保持终端开启。它仅监听本机，不需要账号或凭据，也不提供文件访问。

node -e "require('node:http').createServer((req,res)=>{res.writeHead(200,{'Content-Type':'application/json'});res.end(JSON.stringify({ok:true}));}).listen(8765,'127.0.0.1')"

在同一个 Unfour 请求中保留 GET 和 No Auth，将 URL 改为 http://127.0.0.1:8765/ 后点击“发送”。预期收到 HTTP 200 和 {"ok":true}。连接被拒绝通常表示本地服务未运行或端口不一致。若终端提示 EADDRINUSE，请选择其他未占用端口，并同步修改命令和 URL。完成后按 Ctrl+C 停止服务。

请从下载页获取当前平台对应的 Stable 软件包。签名、架构和平台可用状态见该页。

1. 1 启动 Unfour。应用会打开桌面工作台，并在首次使用时创建本地应用数据。
2. 2 从标题区域选择工作区，也可以先使用默认工作区。
3. 3 通过模块导航打开 API Client、SSH、数据库或工作区环境编辑器。
4. 4 打开 Settings 管理外观、账户、Cloud Sync 权益和 MCP 客户端配置。

工作区是相关 API 请求、SSH 与数据库连接、环境、变量、活动、标签页和 MCP 策略的共享上下文。不同服务或环境不应共享上下文时，请使用不同工作区。

• ✓ API 集合、文件夹、保存的请求和请求历史属于当前工作区。
• ✓ SSH 与数据库连接定义限制在工作区内，秘密值通过本地凭据引用保存。
• ✓ 工作区默认变量与当前环境会在工具执行前解析 {{base_url}} 等变量。
• ✓ MCP 工具依据工作区及其环境策略运行，而不是访问不受限制的全局资源。

将项目配置一起带走，无需逐个工具重新搭建：API 集合、文件夹与请求、SSH/Database 连接设置、工作区与环境变量、Saved SQL、SSH Tasks 和 Flow 定义。资源之间的引用会映射到导入后的副本。

1. 1 选中来源工作区，打开标题区域的工作区菜单，选择“导出当前 Workspace”。核对对话框中显示的工作区名称。
2. 2 选择“分享配置”或“加密备份”，检查“保留本地路径”。加密备份需要输入并确认至少 12 个字符的密码；检查“包含已保存的凭据和敏感变量”，不希望写入时取消勾选。
3. 3 点击“选择保存位置”并保存文件。向他人发送普通导出前先检查内容。加密备份与密码应分开保管。

1. 1 打开工作区菜单，选择“从文件导入 Workspace”，选取普通定义导出或加密备份。加密文件需要输入密码，点击“预览导入内容”后在本机解锁预览。
2. 2 检查资源数量、新工作区名称、排除内容与需要补充的字段。MCP 访问默认为“禁用”；如有需要，可明确选择适用于本机的权限策略。来源工作区的 MCP 策略不会导入。预览不会创建工作区，也不会执行请求、脚本、SQL 或任务。
3. 3 展开“检查并调整本地路径”，替换路径前缀或逐项编辑 SSH 私钥、SQLite 和 SSH 上传/下载路径，使其适用于本机。点击“应用并检查路径”，修改后重新检查预览。
4. 4 点击“创建并切换”。导入会创建独立工作区并重新映射资源引用；重名时追加副本序号，原有工作区保持不变。导入不会合并到或覆盖已有工作区。
5. 5 运行前补齐缺失凭据或已脱敏字段，单独准备引用的文件，并重新选择 API multipart 上传文件。复核 SSH 主机信任与导入工作区的 MCP 权限。路径检查不代表远程连接已验证。

• ✓ 包含的凭据仅恢复到支持的本地字段。SSH/Database 密码与 SSH 私钥口令会创建新的系统凭据存储引用；API 敏感字段和 Secret 变量值恢复到本地 SQLite 字段。加密备份文件不等于加密本地 SQLite 存储。
• ✓ 不会打包私钥文件、SQLite 数据库文件或上传/下载文件内容，也不包含历史记录、标签页、布局、SSH 主机信任和 Cloud Sync 绑定。这是配置备份，不是数据库备份或完整设备迁移。
• ✓ 即使使用加密备份，请求体、脚本、SQL 和 Flow 默认值中的硬编码敏感值仍会按规则脱敏。任意自由文本仍可能包含硬编码敏感信息；分享前须检查，执行前须复核已脱敏的定义。
• ✓ 本地备份与 Pro Cloud Sync 分开，不会开启 Secret 同步或端到端加密云同步。敏感值仍被排除在 Cloud Sync 之外。Pro 可同步 Flow 定义；运行历史、实际输入/输出、凭据与设备本地配置保留在本地。

本地 MCP、其他客户端或可选 Pro Cloud Sync 提交工作区修改后，打开的桌面视图会刷新。桌面可见时定期检查，并在激活时检查；这不是实时协同编辑，也不会执行请求、SQL 或 SSH 命令。

支持的 API、SSH Task、环境编辑器和编辑对话框可检测已保存记录在外部被修改或删除。未保存草稿会保留供复核，过期保存会被阻止。加载最新版本前，请复核或复制需要保留的编辑，因为重新加载会丢弃草稿。保护仅限支持的编辑器，不会使远程操作具备事务性。