配置手册

配置分类

CountBot 配置主要分为:

• Provider 与模型
• 会话与人格
• 工作空间与安全
• 渠道与账号
• 技能系统
• 智能体团队
• 定时任务
• 远程访问认证

配置存储

主配置

通过 settings API 存储到 SQLite 数据库:

方法	路径	说明
GET	/api/settings	获取完整配置
PUT	/api/settings	保存配置
GET	/api/settings/providers	获取 Provider 元数据
POST	/api/settings/test-connection	测试模型连接

工作空间配置

文件形式存储在工作空间目录:

workspace/
├── .skills_config.json      # 技能启用状态
├── skills/                  # 技能目录
├── memory/                  # 记忆文件
└── temp/                    # 临时文件

Provider 与模型

Provider 配置

每个 Provider 至少需要:

• enabled — 是否启用
• api_key — API 密钥
• api_base — API 地址

全局模型配置

• provider — 默认 Provider
• model — 默认模型
• temperature — 温度参数
• max_tokens — 最大输出
• max_iterations — 最大迭代次数

测试连接

1. 保存 Provider 的 api_key
2. 修改 api_base(如需要)
3. 选择目标模型
4. 调用 POST /api/settings/test-connection
5. 测试通过后再进行对话

会话自定义

会话级别可覆盖全局配置:

• model — 临时切换模型
• persona — 临时切换人格

方法	路径	说明
GET	/api/chat/sessions/{session_id}/config	获取会话配置
PUT	/api/chat/sessions/{session_id}/config	保存会话配置
DELETE	/api/chat/sessions/{session_id}/config	清空会话配置

生效优先级

1. 会话自定义配置
2. 全局 Provider 配置
3. Provider 默认元数据

不同会话可以使用不同模型而不影响全局设置。

人格配置

• ai_name — AI 名字
• user_name — 用户名字
• personality — 预设人格
• custom_personality — 自定义人格
• max_history_messages — 历史消息数量

max_history_messages 越大上下文越完整,但 token 成本越高。超出限制时会触发记忆系统做摘要。

工作空间

工作空间路径影响:

• 文件工具根目录
• Shell 工具工作目录
• 技能目录位置
• 记忆文件位置
• 截图和临时文件输出

修改工作空间路径后需要重启应用。

安全配置

• dangerous_commands_blocked — 拦截危险命令
• custom_deny_patterns — 自定义拒绝规则
• command_whitelist_enabled — 启用白名单
• custom_allow_patterns — 自定义允许规则
• audit_log_enabled — 启用审计日志
• command_timeout — 命令超时
• subagent_timeout — 子代理超时
• max_output_length — 最大输出长度
• restrict_to_workspace — 限制在工作空间

渠道与账号

渠道配置是账号级设计:

• enabled — 是否启用
• display_name — 显示名称
• account_id — 账号标识
• allow_from — 允许的用户
• routing_mode — 路由模式(ai/direct)
• external_coding_profile — 外部编码工具

方法	路径	说明
GET	/api/channels/list	获取渠道配置
GET	/api/channels/status	获取运行状态
POST	/api/channels/test	测试连通性
POST	/api/channels/update	保存并重载
GET	/api/channels/{channel}/config	获取单个渠道配置

技能系统

目录结构

workspace/skills/
└── {skill-name}/
    ├── SKILL.md
    └── scripts/

启用状态

workspace/.skills_config.json:

{
  "disabled_skills": ["news"]
}

技能 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	自动修复配置

需要额外配置的技能

技能	配置文件
baidu-search	scripts/config.json
email	scripts/config.json
image-analysis	scripts/config.json
image-gen	scripts/config.json
map	scripts/config.json
web-design	scripts/config.json

智能体团队

团队 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	保存团队模型配置

团队模式

• pipeline — 流水线
• graph — 图模式
• council — 议会模式

定时任务

常用字段

• name — 任务名称
• cron_expression — Cron 表达式
• prompt — 发送给 Agent 的指令
• target_channels — 输出渠道
• enabled — 是否启用

任务 API

方法	路径	说明
GET	/api/cron/jobs	获取任务列表
POST	/api/cron/jobs	创建任务
GET	/api/cron/jobs/{job_id}	获取任务详情
PUT	/api/cron/jobs/{job_id}	更新任务
DELETE	/api/cron/jobs/{job_id}	删除任务
POST	/api/cron/jobs/{job_id}/run	立即执行

远程访问认证

方法	路径	说明
GET	/api/auth/status	获取认证状态
POST	/api/auth/setup	首次设置密码
POST	/api/auth/login	登录
POST	/api/auth/logout	登出
POST	/api/auth/change-password	修改密码

推荐配置顺序

1. 配置 Provider 和模型
2. 确认工作空间路径与安全策略
3. 配置技能所需密钥和外部 CLI
4. 接入渠道
5. 配置团队(如需要)
6. 上线定时任务(如需要)

相关文档

• 渠道配置
• 快速参考
• 技能系统
• 智能体团队
• 定时任务