常见问题

安装、使用、性能、安全相关的常见问题解答。本文以**个人版（Lite）**为主，企业版相关差异见各功能文档与 API 参考。

安装相关

安装失败怎么办？

1. 确认系统为 Windows 10 及以上 64 位版本
2. 右键安装包 → 属性 → 勾选"解除锁定"（如从网络下载）
3. 以管理员身份运行安装程序
4. 检查杀毒软件是否拦截，必要时临时关闭后重试
5. 确保安装路径不含中文或特殊字符

Lyncore 默认使用哪个端口？

本地服务默认监听 19824（界面通过 http://127.0.0.1:19824 访问）。如果被占用：

1. 启动桌面壳时可在设置中指定其他端口
2. 或结束占用该端口的进程：netstat -ano | findstr :19824

如何卸载？

1. 运行安装目录下的 uninstall.exe
2. 或通过 Windows 设置 → 应用 → 找到 Lyncore → 卸载
3. 卸载不会删除用户数据（本地库位于 ~/.lyncore/，日志位于 %APPDATA%\Lyncore\logs）

安装后无法启动？

1. 检查是否有其他实例正在运行
2. 查看日志文件（%APPDATA%\Lyncore\logs）
3. 尝试以管理员身份运行
4. 确保系统已安装最新 Windows 更新

---

使用相关

对话无响应？

可能原因和解决方法：

1. 未配置模型：进入模型管理，配置至少一个 LLM 模型的 API Key 或端点
2. API Key 无效：检查 API Key 是否正确、是否过期、余额是否充足
3. 网络问题：若使用官方中继或云端模型，需确保网络通畅
4. 模型服务故障：尝试切换到其他模型

工具调用失败？

1. 权限不足：部分高风险工具（如代码执行）需要你在对话中确认后才执行
2. 配置缺失：如 email 工具需要先配置 SMTP_* 环境变量；calendar 需要配置 CALDAV_URL
3. 沙箱限制：代码执行在沙箱中运行，可能缺少某些依赖
4. 超时：复杂操作可能超时，尝试简化任务

知识库检索不准确？

1. 文档质量：确保上传的文档内容清晰、格式规范（支持 TXT/JSON/PDF/CSV/XLS/XLSX）
2. 重新索引：删除并重新上传文档，触发重新向量化
3. 查询方式：使用更具体的关键词或问题描述
4. 文档数量：文档太少时检索效果可能不佳，建议积累更多文档

如何切换模型？

1. 进入 模型管理
2. 修改默认模型（系统模型或你添加的自定义模型）
3. 或在对话中指定使用特定模型

如何配置邮件 / 日历接入？

• 邮件：email 工具基于 SMTP 发送，需在环境变量中配置 SMTP_HOST / SMTP_PORT / SMTP_FROM（以及可选的 SMTP_USER / SMTP_PASS），使用 587 端口（STARTTLS）。当前只发不收，无收件箱、无 OAuth、无 Gmail/Outlook 专用集成。
• 日历：calendar 工具基于 CalDAV，需配置 CALDAV_URL（以及可选的 CALDAV_USER / CALDAV_PASS）。当前仅支持 list_events（列出事件）与 create_event（创建事件）。

---

性能相关

如何提升响应速度？

1. 选择更快的模型：不同模型响应速度差异较大，可尝试切换
2. 使用本地模型：把模型指向本地推理端点（如 Ollama http://localhost:11434/v1），消除调用云端模型的网络延迟
3. 减少上下文：定期清理不活跃的会话
4. 优化知识库：只保留必要的文档，减少检索范围

Token 用量过高怎么办？

1. 检查对话长度：长对话会消耗大量 Token，适时创建新会话
2. 调整模型配置：部分模型支持设置 max_tokens 限制
3. 查看用量统计：监控面板中查看 Token 用量明细
4. 设置配额：企业版可为用户或租户设置 Token 配额上限

如何优化知识库检索？

1. 精简文档：去除无关内容，只保留核心信息
2. 合理分段：文档较长时考虑拆分为多个小文档
3. 定期清理：删除过时或不再需要的文档
4. 选择合适的嵌入模型：不同嵌入模型对中文的支持程度不同

---

安全相关

数据存储在哪里？

个人版数据默认存储在本地：

• 数据库文件（SQLite）：~/.lyncore/
• 知识库向量数据（本地向量库）
• 用户配置
• 日志文件：%APPDATA%\Lyncore\logs

需要联网的场景：① 激活校验（个人版需联网激活，并每 6 小时心跳回连一次）；② 使用官方出厂模型时，对话内容会发送给中继网关 relay.lyncore.cn。如果你把模型指向自己的本地/自托管端点，则可减少对外网络依赖。

如何备份数据？

个人版当前没有内置的一键备份 / 还原端点。你可以手动备份本地数据目录 ~/.lyncore/（包含许可证与本地库）。企业版提供完整的备份、审计与导出能力。

是否支持数据导出？

支持部分导出：

• 技能包：GET /api/v1/skills/:id/export
• 会话 / 知识库等可通过对应 API 读取（见 API 参考）
• 企业版额外提供 GDPR 相关的导出 / 删除能力

个人版与企业版有什么区别？

能力	个人版（Lite）	企业版（Enterprise）
部署形态	单机桌面 / 单进程	服务端 / 云（PostgreSQL + Redis + NATS + Temporal + Vault）
数据库	本地 SQLite	PostgreSQL + pgvector
沙箱	WASM	gVisor（runsc 不可用时降级为 runc）
长任务	DAG 引擎	Temporal 分布式调度
多租户 / 部门隔离	❌	✅
RBAC / 审计日志	基础角色（无管理台）	✅ 完整管理台 + 审计 + 合规导出
计费 / 配额 / GDPR / OIDC	❌	✅
并发上限 / 工具超时	5 / 300s	100 / 600s

沙箱真的安全吗？

• 个人版默认使用 WASM 沙箱；代码执行（python_exec / bash_exec）仅在个人版注册，且有模块黑名单与命令黑名单。
• 企业版使用 gVisor 容器级隔离；但当运行环境未安装 runsc 时，会自动降级为普通 runc 运行时——不要因此宣称"强隔离"。
• 所有工具调用都经过安全管线（注入检测、越权检测、审计），高风险操作需用户确认。