xiaoski 2f11aed44a feat(skills): add built-in skill packaging mechanism and about-picobot documentation
- 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
2026-05-15 12:00:18 +08:00

2.0 KiB
Raw Permalink Blame History

PicoBot 常见问题

Q: 如何切换模型?

修改 config.jsonagents 配置,指定不同的 providermodel。如需新的 providerproviders 中添加对应 API 配置。

Q: 如何添加新的渠道?

config.jsonchannels 中添加新条目。目前支持飞书 (feishu)CLI 客户端无需配置。

Q: 如何安装 skill

将包含 SKILL.md 的目录放入 ~/.picobot/skills/,程序自动检测。也可通过 agent 在 workspace 的 skills/ 下创建新 skill。

Q: 为什么 get_skill 找不到某个 skill

确保 skill 目录中有 SKILL.md 文件,且文件头有正确的 frontmattername、description。用 get_skill action="list" 查看当前加载的所有 skill。注意同名 skill 按目录优先级覆盖。

Q: 内置的 about-picobot 文档在哪里?

~/.picobot/skills/about-picobot/SKILL.md 为索引references/ 下为各详细文档assets/ 下为 config 示例。如被删除,重启程序自动重新安装。

Q: 数据库文件在哪里?

默认 {workspace}/picobot.dbworkspace 默认 ~/.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.jsongateway.port 中设置,重启网关生效。默认 19876。

Q: 如何查看 LLM 调用日志?

LLM 调用记录存储在 llm_calls 表中。可通过 SQLite 客户端直接查询,或在代码中通过 storage 模块访问。