常见问题
安装、授权、对话、记忆、MCP 与卸载等高频问题。
一、常见问题
| 问题 | 处理办法 |
|---|---|
| 双击程序没反应 | 确认安装已完成；查看安装目录下 log 文件夹中的日志；勿单独复制 exe，需保持安装目录完整 |
| 提示缺少环境或组件 | 重新运行安装包，在「运行环境准备」向导中完成环境检测与组件安装；安装时建议暂时关闭杀毒软件 |
| 提示授权失效 | 试用授权到期后，将界面显示的机器码发给管理员；收到 .key 文件后拖入客户端确认覆盖，或放入安装目录并重启（详见 授权说明） |
| 无法与智能体对话 | 先在「系统设置 → 模型配置」中配置模型和 API 密钥；确认网络正常 |
| 智能体读不到项目文件 | 在输入框下方点击 「选择目录」 指定工作目录；目录图标置灰表示尚未选择 |
| 找不到以前的对话 | 在左侧栏下方当前工作目录的会话列表中 单击 打开；确认工作目录与当时一致；也可能在 会话归档 的「已归档」中 |
| 智能体每次都要重新自我介绍 / 忘了约定 | 到 高级管理 → 记忆力 查看是否已写入用户画像或长期记忆；必要时点「重建会话索引」 |
| 如何对接企业内部系统 / 浏览器 | 在 高级管理 → MCP 添加服务器；日常改本地文件一般不必配置 MCP |
| 智能体回复很慢或中断 | 可能是网络或模型服务繁忙，稍后重试；可在「更多控制」中手动压缩上下文 |
| 拖入 ZIP 未安装 | 确认包内结构正确（技能含 SKILL.md，业务应用含 conf.json）；也可拖入业务工作台页面重试 |
| 如何卸载 | 运行安装目录中的 uninstall.bat；也可删除整个安装文件夹。对话与记忆数据在用户目录（如 ~/.pi/agent/），不会随程序删除 |
| 弹出「需要授权」或危险操作确认 | 属 安全权限 正常拦截。可「允许一次」；频繁误拦再请管理员调整策略，勿一律永久放行 |
| 图片发了但提示无法识别 | 当前模型不支持识图，请换多模态模型或先用识图技能 |
| 高级管理找不到 | 试用授权可能隐藏该入口，见 授权说明；正式授权后可见记忆力 / MCP / 插件等 |
| 如何反馈问题 | 点击窗口标题栏 「授权与帮助」→ 帮助 打开在线文档，或将安装目录 log 中的日志发送给技术支持 |