01 下载安装
在下载中心获取 Windows x64 安装包并核对 SHA-256。当前构建面向 Windows 10 / 11 x64，采用当前用户安装，需要 Microsoft Edge WebView2 Runtime；缺少时安装程序会尝试下载。
本次安装包尚未代码签名，已完成编译与静态检查，尚未完成真实 Windows 设备验收。安装前请核对本站下载地址与文件校验值。
02 检查环境
打开左侧“环境管理”，点击重新检测。检查结果来自本机命令探测，并显示已发现的版本、路径与状态。需要使用 npm 安装的工具，应先准备 Node.js 与 npm。
- 查看缺失或异常的条目，选择自己需要的依赖。
- 确认安装方式后加入任务队列。若系统未提供 WinGet，按提示前往 Microsoft 官方渠道安装。
- 完成后重新检测。已有进程可能仍持有旧 PATH，必要时重启星桥再检查。
Python、uv 等仅按实际工作流需要安装；探测超时也会显示异常，不能直接等同于未安装。
03 使用安装任务中心
在 AI 商店确认安装或升级后，将任务加入队列。任务按顺序执行；同一会话中切换功能页面不会中断队列。可以查看任务状态与返回结果，取消尚未开始的任务，对失败项目确认后重试。
执行中的任务会等待底层安装器返回。界面不展示推算的下载百分比。任务记录仅在当前运行会话内保留，最多保留最近 50 条已结束记录；单项安装设有 20 分钟等待上限。退出应用前请等当前安装完成。
04 连接自己的模型
进入“模型管理”，先选择需要配置的工具，再新增供应商。填写该服务提供的请求地址、API Key 与模型名；不要把不同工具的协议或地址格式混用。
- 先确认第三方工具已安装，或已按官方方式登录。
- 新增供应商，检查请求地址与工具所支持的 API 协议。
- 保存并选择供应商；若工具仍使用旧配置，完整退出后重新启动。
- 需要路由或故障转移时，按对应工具提供的选项开启，并检查实际调用结果。
官方桌面客户端、CLI 与本地模型的适配能力不同。“出现在商店”不表示支持全部模型配置功能。具体适配以客户端实际提示为准。
05 整理 Skills、MCP 与提示词
在 Skills 中发现或导入技能包，选择要应用的受支持工具。在 MCP 中编辑命令、参数或服务地址，并按客户端适配规则同步。提示词按工具分别维护。
导入社区内容前检查来源与内容；MCP 命令及 Skills 可能包含本地执行行为。重要的已有配置建议先备份，再进行应用或覆盖。
06 诊断与排查
在环境管理中生成诊断报告，预览后另存为 JSON。报告只保留允许的应用版本、平台与依赖状态等字段，不读取供应商密钥、会话正文、代理凭据或完整配置文件。
安装失败时先查看任务中心返回的日志。完整安装日志可能含包管理器输出，分享前自行检查。诊断报告与数据库备份用途不同；备份可能包含敏感配置，避免公开上传。
- 工具找不到：重新检测，确认 PATH 后重启客户端。
- 网络超时：检查自己使用的网络或代理；npm 与 WinGet 采用各自的网络配置。
- 模型调用失败：核对服务地址、密钥权限、模型名与工具协议。
- 用量有差异：本地可读取日志的范围与供应商账单口径可能不同。