常见问题
安装、授权、对话与文件访问等高频问题。
| 问题 | 处理办法 |
|---|---|
| 双击程序没反应 | 确认安装已完成；查看安装目录下 log 文件夹中的日志；勿单独复制 exe，需保持安装目录完整 |
| 提示缺少环境或组件 | 重新运行安装包，在「运行环境准备」向导中完成环境检测与组件安装；安装时建议暂时关闭杀毒软件 |
| 提示授权失效 | 试用授权到期后，将界面显示的机器码发给管理员；收到 .key 文件后放入安装目录并重启（见 2.2） |
| 无法与智能体对话 | 先在「系统设置 → 模型配置」中配置模型和 API 密钥；确认网络正常 |
| 智能体读不到项目文件 | 在输入框下方点击 「选择目录」 指定工作目录；目录图标置灰表示尚未选择 |
| 找不到以前的对话 | 在左侧历史会话中按业务应用分组查找（未关联应用的在「通用」分组）；确认工作目录与当时一致 |
| 智能体回复很慢或中断 | 可能是网络或模型服务繁忙，稍后重试；可在「更多控制」中手动压缩上下文 |
| 拖入 ZIP 未安装 | 确认包内结构正确（技能含 SKILL.md，业务应用含 conf.json）；也可拖入业务工作台页面重试 |
| 如何卸载 | 删除整个安装文件夹即可；对话记录保存在用户目录（~/.pi/agent/sessions），不会随程序删除 |
| 如何反馈问题 | 点击窗口标题栏 「帮助」 打开在线文档，或将安装目录 log 中的日志发送给技术支持 |