xiaoski
2f11aed44a
- Add build.rs: scan resources/skills/, compress each with tar+zstd, embed via include_bytes! - Add src/skills/builtin.rs: runtime auto-install built-in skills to ~/.picobot/skills/ - Add about-picobot built-in skill: SKILL.md index + references/ (config, db-schema, architecture, faq, commands) + assets/config.example.json - Update skill loading: reverse priority (agents < picobot < workspace), deduplicate by name - Update skills prompt: re-query get_skill when user asks about installed skills - Change max_tool_iterations default from 20 to 99
46 lines
2.0 KiB
Markdown
46 lines
2.0 KiB
Markdown
# PicoBot 常见问题
|
||
|
||
## Q: 如何切换模型？
|
||
|
||
修改 `config.json` 中 `agents` 配置，指定不同的 `provider` 和 `model`。如需新的 provider，在 `providers` 中添加对应 API 配置。
|
||
|
||
## Q: 如何添加新的渠道？
|
||
|
||
在 `config.json` 的 `channels` 中添加新条目。目前支持飞书 (feishu)，CLI 客户端无需配置。
|
||
|
||
## Q: 如何安装 skill？
|
||
|
||
将包含 `SKILL.md` 的目录放入 `~/.picobot/skills/`，程序自动检测。也可通过 agent 在 workspace 的 `skills/` 下创建新 skill。
|
||
|
||
## Q: 为什么 get_skill 找不到某个 skill？
|
||
|
||
确保 skill 目录中有 `SKILL.md` 文件，且文件头有正确的 frontmatter（name、description）。用 get_skill action="list" 查看当前加载的所有 skill。注意同名 skill 按目录优先级覆盖。
|
||
|
||
## Q: 内置的 about-picobot 文档在哪里？
|
||
|
||
`~/.picobot/skills/about-picobot/` 下，SKILL.md 为索引，references/ 下为各详细文档，assets/ 下为 config 示例。如被删除，重启程序自动重新安装。
|
||
|
||
## Q: 数据库文件在哪里？
|
||
|
||
默认 `{workspace}/picobot.db`，workspace 默认 `~/.picobot/workspace/`。
|
||
|
||
## Q: 如何查看历史会话？
|
||
|
||
使用 `chat_manager` 工具：`action="list_sessions"` 列出会话，`action="list_messages"` 查看指定会话消息，支持 offset 翻页、before_time/after_time 时间范围过滤。
|
||
|
||
## Q: 如何创建定时任务？
|
||
|
||
使用 `cron` 工具，支持一次性 (`once`)、周期性 (`every`) 和 cron 表达式调度。
|
||
|
||
## Q: 上下文压缩是什么意思？
|
||
|
||
对话历史过长超出模型 token 限制时，系统自动精简历史消息。压缩后旧消息可通过 `timeline_recall` 工具检索。
|
||
|
||
## Q: 如何修改 gateway 监听端口？
|
||
|
||
在 `config.json` 的 `gateway.port` 中设置，重启网关生效。默认 19876。
|
||
|
||
## Q: 如何查看 LLM 调用日志？
|
||
|
||
LLM 调用记录存储在 `llm_calls` 表中。可通过 SQLite 客户端直接查询，或在代码中通过 storage 模块访问。
|