12 · 灵镜帮助中心
常见问题
这页能帮你做什么: 遇到问题先来这里找。每个问题的第一句就是最快的解决办法,后面才是原因和更多情况。
安装
Windows 双击安装包,弹出「Windows 已保护你的电脑」,装不了?
点「更多信息」→「仍要运行」。 安装包暂时没有数字签名,Windows 对所有未签名的软件都会这样提示,不代表有问题。
安装到一半提示「这个安装位置太深,装不下」?
点「浏览」换一个更短的安装位置,用提示框里推荐的路径即可。默认位置一般不会遇到这个问题,通常是手动改到了很深的文件夹里。
Mac 上打开灵镜提示「无法打开」或「无法验证开发者」?
打开「系统设置 → 隐私与安全性」,拉到最底部,点「仍要打开」。 应用暂时还没做苹果公证,第一次打开需要你手动放行一次,之后就不会再问了。
另外请确认已经把灵镜拖进了「应用程序」文件夹再打开,不要直接在安装窗口里运行。
Mac 版能装在 Intel 芯片的 Mac 上吗?
目前不能。 Mac 安装包只支持 M 系列芯片(Apple Silicon)、macOS 13 及以上。Intel 芯片的 Mac 可以试试〔02 安装〕里的「让 AI 助手替你装」。
安卓手机装不上?
先确认系统是 Android 8.0 及以上的 64 位手机,然后在安装时允许「安装未知应用」。 第一次打开要准备运行环境,大约 1 分钟,期间别关掉。
让 AI 助手装,它装到一半失败了?
把它给出的错误原文复制下来发给我们。 常见原因有两个:
- 用的是 WorkBuddy:先在 WorkBuddy 里开启「完全访问」,再重新发一次安装那句话。不开的话它不能往工作文件夹外面写文件,必然装不上。
- 电脑访问不了官网:在浏览器里打开 https://startupworld.cn 试试,打不开就先处理网络。
实在搞不定,直接改用桌面安装包(〔02 安装〕方式一),双击就能装。
打开与登录
浏览器打不开 localhost:9090?
先确认灵镜在运行: Windows 看屏幕右下角托盘里有没有灵镜图标,Mac 看顶部菜单栏有没有 ∞ 图标。没有就从开始菜单 / 启动台重新打开「灵镜 SoulMirror」。
还是打不开,按顺序试:
- 用桌面版的窗口打开,不要手敲地址:点托盘(或菜单栏)的灵镜图标 →「打开灵镜」。
- 重启灵镜服务:托盘图标右键 →「重启服务」。
- 地址写对了吗:是
http://localhost:9090(或http://127.0.0.1:9090),注意是http不是https。 - 用 AI 助手装的:对它说「灵镜起来了吗?没起就启动一下」。
打开灵镜窗口,一直停在「正在唤醒」,或者显示「灵镜服务没有按时响应」?
点页面上的「重试」。 正常 1–3 秒就能进去,超过 20 秒才会出现这个提示。重试不行:
- 点「用浏览器打开」,看看浏览器里能不能进。
- 点「查看日志」,把日志文件发给我们,我们帮你看。
截图准备中启动超时页:「灵镜服务没有按时响应」,下方有「查看日志」「重试」「用浏览器打开」
登录密码是什么?
默认密码是 soulmirror。 进去后建议马上改掉:「我的 → 设置 → 修改面板密码」。
忘了自己改过的密码?
目前只能把密码恢复成默认值再重新设置,步骤见下面「进阶」。你的分身、Wiki、聊天记录都不受影响。
进阶:把面板密码恢复成默认的 soulmirror
- 退出灵镜:托盘(或菜单栏)的灵镜图标 →「退出(停止灵镜服务)」。
- 打开你的数据文件夹(Windows:
C:\Users\<你的用户名>\.soulmirror\;Mac:~/.soulmirror/),找到auth.json这个文件,把它移到桌面(先别删,留着备用)。 - 重新打开灵镜,用
soulmirror登录,然后立刻到「我的 → 设置 → 修改面板密码」设一个新密码。
从外面(手机、别的电脑)远程打开面板,登录键是灰的,提示「远程访问前请先在本机面板修改密码」?
回到装灵镜的那台电脑上,先改掉默认密码。 改完再从外面登录就可以了。这是为了防止别人用人人都知道的默认密码登进你的分身。
登录键是灰的,提示「正在同步数据,完成后才能登录」?
等它同步完。 这通常发生在你刚把分身加入到这台设备、或刚在另一台设备上登录的时候,同步完会自动放开。多台设备之间怎么切换,见〔11 手机和电脑一起用〕。
连接与数据
已经连上了,为什么分身说没读到东西?
到「连接」→「采集」标签页,点开那个来源的卡片看状态。
- 显示「● 采集中」或卡片上「正在读」:第一次读历史资料比较慢,资料多的话(比如一年的微信记录)可能要几个小时,耐心等。
- 显示「○ 从未运行」:可能还没轮到。每张卡片都写着「每 X 采一次」,等一个间隔再看。
- 显示「⏸ 未激活」:点卡片进去,点右上角「▶ 激活」。
- 显示「● 失败」或采集历史里有「⚠ 失败」:点「📜 采集日志」看原因,按〔03 连接〕里「常见接不上怎么办」处理。
- 采集历史里全是「— 无变化」:说明这段时间没有新内容,是正常的。
提示「采集已停用」「蒸馏与采集暂停」?
灵镜的试用期或授权到期了。 Wiki 仍然可以查看,但不会再读新资料、也不会再整理。到「我的 → 设置」页面的「授权」区输入授权码就能恢复。购买方式见官网。
微信聊天记录接不上?
在「聊天」里对分身说「帮我把微信聊天记录接进来」,让它带你装好需要的技能并提取微信密钥。 提取时电脑上的微信要保持登录。只支持电脑版微信 4.x。Mac 用户还要在卡片上点「去打开权限」,给灵镜开「完全磁盘访问」。
邮箱接不上?
确认填的是「授权码」,不是邮箱登录密码。 并且邮箱网页版的设置里 IMAP 服务要是开着的。具体步骤见〔03 连接〕。
分身的回答
分身答非所问,或者说不认识我身边的人?
先看它对你了解多少:点左栏「我的」,看「蒸馏度」。 蒸馏度是分身对你的了解程度(0–100),数字低说明它读到的资料还少。
- 多接几个来源:微信和邮箱最能帮分身认识你身边的人,见〔03 连接〕。接上后给它一些时间读。
- 纠正它记错的地方:到左栏「Wiki」里找到那一条,直接改。见〔05 Wiki〕。
- 问得具体一点:带上人名、时间、事情,比如「我上周答应王总什么了」,比「最近怎么样」好答得多。
分身完全不回话,或者回复报错?
到「我的 → 设置 → 运行模式与模型」,确认选了一个可用的 Agent 和模型。 分身思考要用模型,没选好、Key 失效或额度用完时就会不回话或报错。另外检查「我的 → 设置」里的「授权」是否到期。
升级
怎么升级到新版本?
桌面版:「我的 → 设置 → 检查更新」,有新版就点「下载并更新」,下好后点「更新并重启」。 几秒钟就能完成,数据不受影响。
点「检查更新」后:已经是最新版,会显示「已是最新版本」和当前版本号,不用做什么;有新版时,会显示「发现新版本」和新版本号,下面是「下载并更新」按钮。下载校验完,按钮变成「更新并重启」,点它即可。
其他方式:
- 桌面版托盘 / 菜单栏:点灵镜图标 →「检查更新…」。新版下载好后,菜单里会出现「更新到 X 并重启」。
- 登录不进去也能升级:登录页下方有「检查更新」,不登录也能查、能装。
- 用 AI 助手装的:对它说「帮我升级灵镜」。
- 安卓 App:同样在「我的 → 设置 → 检查更新」里操作。
我装了新版,为什么功能还是老样子?
彻底退出灵镜再打开一次: 托盘(或菜单栏)的灵镜图标 →「退出(停止灵镜服务)」,然后重新打开。用 AI 助手装的,对它说「重启一下灵镜」。
备份、换电脑与卸载
怎么备份?
退出灵镜后,把整个 .soulmirror 文件夹复制一份到别的地方。 这个文件夹就是你分身的全部:连接、应用、Wiki、聊天都在里面。
- Windows:
C:\Users\<你的用户名>\.soulmirror\ - Mac:
~/.soulmirror/(在「访达」里按Command + Shift + G,粘贴这个路径前往;它默认是隐藏文件夹)
请整个文件夹一起复制,不要只挑几个文件。复制前先退出灵镜(托盘或菜单栏图标 →「退出(停止灵镜服务)」),避免复制到一半的文件。
换了新电脑,怎么把分身带过去?
新电脑装好灵镜后,在「加入已有分身」里输入旧电脑「添加设备」给出的 6 位码,分身和数据就一起过去了,不用手动拷文件。 每一步怎么做、搬完旧电脑怎么处理,见〔11 手机和电脑一起用〕。
怎么卸载?
Windows: 打开系统「设置 → 应用 → 已安装的应用」,找到「灵镜 SoulMirror」,点「卸载」。卸载最后会问你「是否同时删除灵镜数据」——想保留就选「否」(默认保留);选「是」会删掉 Wiki、采集的数据、应用和身份密钥,不可恢复。
Mac: 点菜单栏的 ∞ 图标 →「卸载灵镜…」。你的数据文件夹 ~/.soulmirror/ 不会被删除。
安卓: 像普通 App 一样卸载即可。注意:卸载会把手机上的灵镜数据一起删掉,想保留请先把手机加入你电脑上的同一个分身(见〔11 手机和电脑一起用〕)。
进阶:卸载桌面版后,AI 助手里的灵镜也不能用了?
Windows 上卸载桌面版会把灵镜程序一起删掉,AI 助手用的也是这一份。只想去掉桌面窗口、继续在 AI 助手里用的话,卸载后把〔02 安装〕「方式四」那句话再发给 AI 助手一次即可——数据还在,重新装好就能接着用。
手机上的常见问题
安卓 App 打不开,或者一直停在启动屏?
第一次打开要准备运行环境,大约 1 分钟,期间别关掉。 启动屏显示「启动失败」(比如「灵镜服务 90 秒内没有就绪」)时,点「重试」;还不行,点「查看日志」,在日志页点「分享」把日志发给我们。
App 用着用着显示「面板暂时打不开」,或者过一阵分身就掉线?
点页面上的「重试」;还不行,进「服务状态」点「重启服务」。 「服务状态」在「我的 → 设置」里,打不开面板时点手机通知栏里常驻的「灵镜运行中」也能进。
经常是息屏一段时间后掉线的,多半是系统为了省电把灵镜关了:在「服务状态」里点「去设置电池白名单」,把灵镜加进去。
手机上输配对码,提示过期或「没找到这个配对码」?
回电脑上重新「添加设备」出一个新码,10 分钟内在手机上输完。 一个码只能用一次,过了 10 分钟或点过「取消」都会失效。其它配对问题见〔11 手机和电脑一起用〕末尾「常见接不上怎么办」。
在外面用手机浏览器,打不开远程访问的网址?
先确认电脑开着、灵镜在运行。 远程访问打开的是电脑上的灵镜,电脑关机、睡眠或灵镜退出,网址就打不开。电脑开着还打不开,到电脑上「我的 → 设置 → 远程访问」看状态是不是「● 已连接」。登录键是灰的、提示先改密码,见上面打开与登录。完整排查步骤见〔11 手机和电脑一起用〕。
另外,http://电脑的局域网地址:9090 这种地址只在和电脑同一个 Wi-Fi 时能用,出了门要用远程访问的网址。
手机上找不到铃铛(消息中心)?
手机上没有铃铛按钮。 用手机浏览器的,在「我的 → 设置」点「开启推送通知」授权一次,分身有事时手机会弹通知,点通知就进消息中心。用安卓 App 不用设,它自带通知。
手机上怎么新建定时任务?
手机上不能新建,也不能编辑。 手机上的「我的 → 定时任务」只能开关、立即运行、看运行记录和删除。要新建,在聊天里跟分身说「帮我每天……」,或者回电脑上建,见〔08 定时〕。
手机上的灵镜和电脑上长得不一样?
是同一个灵镜,只是屏幕窄时自动换成手机布局: 底部五个入口(首页 · Wiki · 事项 · 应用 · 我的),电脑左栏的「连接」「定时」在「我的」里,「发现」在「应用」右上角,通讯录在「首页」顶部。电脑上把浏览器窗口拉得很窄,也会变成这样,拉宽就回来。对照表见〔01 认识灵镜〕。
隐私:数据在哪,会不会上传
我的数据存在哪?
全部存在你自己的电脑上的 .soulmirror 文件夹里(Windows:C:\Users\<你的用户名>\.soulmirror\;Mac:~/.soulmirror/;安卓:App 自己的数据目录)。分身整理出来的 Wiki 就是这个文件夹里的一组普通文本文件,你随时可以打开看。
会不会上传到你们的服务器?
读到的资料只存在你的设备,以及你自己登录过的其它设备里。 具体来说:
- 在你自己的设备之间同步时,是加密传输的。
- 你有两台以上设备时,「云端备份」会把分身的核心数据(Wiki、聊天、应用、设置等)用你分身自己的密钥加密后存一份在灵镜的服务器上,方便另一台关机时也能接上;我们解不开、看不到内容,读来的原始资料不上传。见〔11 手机和电脑一起用〕。
- 我们不会把你的资料给到任何第三方,不用它做广告,也不拿它训练模型。
- 分身整理你的资料、回答你的问题时,会把当次需要的那一部分交给模型处理——这是它认识你的方式;只送需要的,处理完不留存。
- 微信聊天记录在你的电脑上解密和读取,不上传。
不想让分身再读某个来源了?
到「连接」→「连接器」,点那一项的「断开」。 断开后就不再读它。想把已经读进来的内容也删掉,见〔03 连接〕末尾的「进阶:重置或删除一个采集器」。
别人能看到我的分身吗?
默认不能。 打开面板都要输面板密码。不过有两点要知道:
- 同一个 Wi-Fi 下别的设备也能打开登录页。 和你连着同一个 Wi-Fi(同一个局域网)的手机、电脑,用浏览器输入你电脑的局域网地址,就能看到灵镜的登录页,输对密码就能进。所以装好后请尽早改掉默认密码,见〔02 安装〕里的「第一件事:改掉默认密码」。
- 从外网访问要你自己开。 只有你在「我的 → 设置」里主动开启「远程访问」,外面的网络才访问得到;开启远程访问前必须先改掉默认密码。另外,只有你主动分享了自己的公开主页,别人才看得到那个主页。
还没找到答案?把问题和截图发给我们的客服,越具体越好(哪一页、点了什么、看到什么提示)。
灵镜 SoulMirror