安装指南
系统要求
| 平台 | 最低版本 | 支持状态 | 备注 |
|---|---|---|---|
| Windows 10/11 | 1809 (build 17763) | ✅ 已支持 | x64 NSIS 安装包 |
| macOS | 11 Big Sur | 🔜 规划中 | 暂未提供官方安装包 |
| Linux | Ubuntu 20.04 / Debian 11 | 🔜 规划中 | 暂未提供官方安装包 |
硬件方面：
- 内存 ≥ 4 GB（推荐 8 GB）
- 磁盘 ≥ 200 MB 可用空间
- 启用 Windows 凭据管理器（默认开启）
Windows 安装
1. 下载安装包
从 下载页 获取 sigil_x64-setup.exe，建议同时下载 SHA256 校验文件。
2. 校验完整性
powershell
Get-FileHash sigil_x64-setup.exe -Algorithm SHA256输出应与下载页公布的 SHA256 一致。
3. 运行安装程序
- 双击
sigil_x64-setup.exe - 安装程序支持简体中文 / English 双语，按提示一步步走完
- 默认安装到
%LOCALAPPDATA%\Sigil - 桌面快捷方式与开始菜单条目会自动创建
如果系统提示"Windows 已保护你的电脑"，点击"更多信息 → 仍要运行"。这是因为内测版本尚未购买完整 EV 签名证书，正式版上线后此提示会消失。
4. 首次启动
启动 Sigil 后会依次：
- 法律声明弹窗：显示用户协议、免责声明、隐私政策的完整内容，需勾选确认
- 密钥环初始化：弹出 Windows 凭据管理器的访问授权，请选择"允许"——后续所有凭据明文都保存在这里
- 进入首页：左侧侧边栏列出 Vault / MCP / Chat / Workspaces / 临时授权 / 审计 / 设置 等入口
到这里安装就完成了。下一步建议阅读 5 分钟快速上手。
故障排查
安装时报"无法访问凭据管理器"
凭据管理器服务可能被禁用。在 PowerShell 中以管理员身份执行：
powershell
Set-Service -Name VaultSvc -StartupType Automatic
Start-Service -Name VaultSvc然后重新启动 Sigil。
启动时窗口黑屏 / 白屏
通常是 WebView2 Runtime 缺失或版本过低。从微软官网下载 WebView2 Evergreen Runtime 安装后重启。
"无法连接到 MCP Server"
Sigil 启动时会绑定本机 TCP 端口（默认 127.0.0.1:8421）。如果端口被占用，会自动顺延到下一个可用端口。可在"MCP 配置"页面查看实际监听地址。
如果完全无法绑定，检查防火墙是否拦截了本地回环连接。
卸载
控制面板 → 程序与功能 → Sigil → 卸载。
卸载前请先在 Sigil 内导出凭据——卸载脚本默认会清理 Windows 凭据管理器中 com.agilefr.sigil 下的所有条目。如果想保留加密的本机数据，在卸载向导里取消勾选"清除应用数据"。
数据目录位置
| 内容 | 位置 |
|---|---|
| 元数据 SQLite | %APPDATA%\com.agilefr.sigil\sigil.db |
| 应用日志 | %APPDATA%\com.agilefr.sigil\logs\ |
| 凭据明文（加密） | Windows 凭据管理器（不在文件系统） |
开发版本数据隔离到 %APPDATA%\com.agilefr.sigil\dev-app.db，互不干扰。