快速参考

这一页只保留“最常用、最容易忘”的内容，帮助你快速定位 CountBot 的关键入口。

关键路径

路径	用途
`backend/`	后端 API、调度与核心运行逻辑
`frontend/`	前端界面
`workspace/skills/`	技能目录
`workspace/.skills_config.json`	技能启用状态
`data/countbot.db`	主数据库
`data/logs/`	运行日志
`website/docs-site/`	文档站点源码

常用启动方式

本地运行

python start_app.py

后端开发

uvicorn backend.app:app --reload --host 0.0.0.0 --port 8000

文档站点

cd website/docs-site
npm install
npm run start

会话、团队与路由速记

模型优先级

普通会话：

会话自定义配置
全局 Provider 配置
Provider 默认元数据

预定义团队工作流：

团队专属模型配置
会话模型覆盖
全局模型配置
Provider 默认元数据

外部编码工具默认路由

每个 IM 渠道账号都可以保存：

routing_mode
external_coding_profile

含义：

ai：先走 CountBot 主 Agent
direct：普通消息直接转给外部编码工具

IM 常用命令

命令	作用
`/new` 或 `/n`	新建会话
`/list` 或 `/l`	查看当前可切换会话
`/all` 或 `/al`	查看全部会话
`/switch` 或 `/s`	切换会话
`/clear` 或 `/c`	清空当前会话
`/personality` 或 `/p`	查看或切换人格
`/provider` 或 `/m`	查看或切换模型提供商
`/route` 或 `/rt`	切换 `ai` / `direct` / `default`
`/coder` 或 `/cdr`	切换外部编码工具 profile
`/team`	查看或执行团队工作流
`/stop`	停止当前任务
`/help` 或 `/h`	查看命令帮助

详细说明见 IM 命令。

常用技能

技能	典型用途	说明
`agent-team-manager`	团队创建、成员维护、团队模型配置	团队管理专用入口
`cron-manager`	定时任务创建、批量管理、会话清理	支持批量和上下文自动识别
`agent-browser`	浏览器自动化、页面抓取、截图	依赖外部 CLI
`baidu-search`	检索补充资料	需要配置 Key
`email`	邮件收发	需要邮箱配置
`image-analysis`	OCR 与视觉理解	需要视觉模型配置
`image-gen`	图片生成	需要 Token
`map`	路线规划与 POI 查询	需要地图 Key
`news`	新闻与 AI 资讯聚合	开箱即用
`skill-creator`	生成和评估新技能	适合扩展能力
`terminal-session`	终端会话辅助	开箱即用
`weather`	天气查询	开箱即用
`web-design`	页面生成与部署	需要 Cloudflare Token

详细说明见技能系统。

外部编码工具速记

配置 API

方法	路径	说明
`GET`	`/api/settings/external-coding-tools`	获取 profile 列表
`PUT`	`/api/settings/external-coding-tools`	保存配置
`POST`	`/api/settings/external-coding-tools/check`	检查 profile 是否可运行

会话模式

模式	含义
`stateless`	单轮执行
`history`	附带最近历史
`native`	尽量复用工具原生会话

实现注意点：

claude 的 native 最稳定
其他工具即使配置为 native，运行时也可能回退到 history

团队与定时任务速记

团队 API

方法	路径	说明
`GET`	`/api/agent-teams/`	团队列表
`POST`	`/api/agent-teams/`	创建团队
`GET`	`/api/agent-teams/{team_id}`	团队详情
`PUT`	`/api/agent-teams/{team_id}`	更新团队
`DELETE`	`/api/agent-teams/{team_id}`	删除团队
`GET`	`/api/agent-teams/{team_id}/config`	查看团队模型配置
`PUT`	`/api/agent-teams/{team_id}/config`	设置团队模型配置
`DELETE`	`/api/agent-teams/{team_id}/config`	重置团队模型配置

定时任务 API

方法	路径	说明
`GET`	`/api/cron/jobs`	任务列表
`POST`	`/api/cron/jobs`	创建任务
`PUT`	`/api/cron/jobs/{job_id}`	更新任务
`DELETE`	`/api/cron/jobs/{job_id}`	删除任务
`POST`	`/api/cron/jobs/{job_id}/run`	立即执行
`POST`	`/api/cron/jobs/batch`	批量创建
`POST`	`/api/cron/jobs/batch-delete`	批量删除
`GET`	`/api/cron/jobs/{job_id}/messages`	查看任务会话消息
`POST`	`/api/cron/jobs/{job_id}/session/cleanup`	清理任务会话
`POST`	`/api/cron/jobs/{job_id}/session/reset`	重置任务会话

常见字段：

max_retries
retry_delay
delete_on_success
channel
account_id
chat_id

技能配置 API

方法	路径	说明
`GET`	`/api/skills`	技能列表
`POST`	`/api/skills/reload`	重载技能
`POST`	`/api/skills/{name}/toggle`	启用或禁用技能
`GET`	`/api/skills/{name}/config/schema`	获取配置 schema
`GET`	`/api/skills/{name}/config`	获取当前配置
`PUT`	`/api/skills/{name}/config`	保存配置
`GET`	`/api/skills/{name}/config/status`	获取配置状态
`POST`	`/api/skills/{name}/config/fix`	自动修复配置
`GET`	`/api/skills/{name}/config/help`	获取配置帮助

常用排查入口

目标	命令或接口
看服务是否存活	`GET /api/system/health`
看配置是否保存	`GET /api/settings`
看渠道是否运行	`GET /api/channels/status`
看技能是否加载	`GET /api/skills`
看团队是否存在	`GET /api/agent-teams/`
看定时任务是否创建	`GET /api/cron/jobs`
看外部编码工具是否可用	`POST /api/settings/external-coding-tools/check`

关键路径​

常用启动方式​

本地运行​

后端开发​

文档站点​

会话、团队与路由速记​

模型优先级​

外部编码工具默认路由​

IM 常用命令​

常用技能​

外部编码工具速记​

配置 API​

会话模式​

团队与定时任务速记​

团队 API​

定时任务 API​

技能配置 API​

常用排查入口​

推荐阅读顺序​

关键路径

常用启动方式

本地运行

后端开发

文档站点

会话、团队与路由速记

模型优先级

外部编码工具默认路由

IM 常用命令

常用技能

外部编码工具速记

配置 API

会话模式

团队与定时任务速记

团队 API

定时任务 API

技能配置 API

常用排查入口

推荐阅读顺序