- 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
2.0 KiB
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 模块访问。