配置

• 配置
  • 空间设置
    • 智能体
    • 功能
    • 频道
  • Webhooks
  • 管理员设置
  • 环境变量
  • 常用命令

空间设置

前往空间设置（侧边栏中的齿轮图标）进行配置：

智能体

• 模型：驱动智能体的 Claude 模型（例如 claude-sonnet-4-6）
• 温度：创造性级别（0.0 = 确定性，1.0 = 创造性）
• 身份 / 名称：自定义智能体角色和显示名称
• 自定义指令：注入到每个智能体系统提示中的额外上下文
• 一级：开启/关闭轻量快速智能体，适用于 Web 和频道上下文

功能

按空间启用或禁用各功能模块：

• 项目 —— 项目跟踪和管理
• 活动 —— 跨频道活动流
• 自动化 —— 定时和事件触发的工作流
• 技能 —— 可复用的智能体知识库

频道

为每个外部服务添加凭据。每个频道需要：

1. API 凭据 —— 令牌、密钥或密钥（加密存储）
2. Webhook 密钥 —— 自动生成，用于验证传入事件

示例 —— 连接 GitHub：

1. 前往空间设置 > 频道 > GitHub
2. 输入您的 GitHub 个人访问令牌（需要 repo、workflow、pull-request 权限范围）
3. 复制显示的 Webhook URL
4. 在 GitHub 仓库设置中，添加一个指向该 URL 的 Webhook，使用显示的密钥

Webhooks

在您的外部服务中注册这些 URL 以接收事件：

服务	Webhook URL	事件
GitHub	https://yourhost/webhooks/github	Pull Request、工单、评论、推送
Linear	https://yourhost/webhooks/linear	工单、评论
Sentry	https://yourhost/webhooks/sentry	问题警报
Teams	https://yourhost/webhooks/teams	频道消息
Telegram	https://yourhost/webhooks/telegram	消息、语音笔记

Webhook 认证因服务而异 —— GitHub 使用 HMAC 签名，Linear 使用 JWT，Telegram 使用签名请求。Themis 通过 WebhookSpaceResolver 自动处理验证。

管理员设置

全局设置位于 /admin/settings（仅管理员用户）：

• 模型配置 —— 将短模型名称映射到完整 API 模型 ID
• 默认温度 —— 智能体创造性的全局回退值
• 费用跟踪 —— 跨提供商的累计 API 支出

环境变量

按空间的设置优先级更高，但以下环境变量提供实例级别的默认值：

变量	用途	默认值
THEMIS_BOT_LOGINS	用于标识机器人的 GitHub 用户名列表（逗号分隔，用于自我提及过滤）。	themis-bot
THEMIS_BOT_NAME	代码生成提交的 Git 作者名称。	首个已配置的 bot login
THEMIS_BOT_EMAIL	代码生成提交的 Git 作者邮箱。	themis-bot@users.noreply.github.com
THEMIS_LINEAR_ORG_SLUG	用于构建工单 URL 的 Linear 组织 slug。	(无 —— 未设置时省略 Linear 链接)
THEMIS_LINEAR_BOT_NAMES	用于检测机器人的 Linear 显示名称／邮箱片段列表（逗号分隔）。	智能体显示名称
THEMIS_DOCS_URL	侧边栏 Docs 链接的目标地址。	https://github.com/themis-ai/themis
ALLOW_PASSWORD_LOGIN	在登录页上与 Google OAuth 一起显示邮箱/密码登录表单。docker-compose.yml 中默认启用,以便已种子化的管理员可以登录。	false
METABASE_MCP_COMMAND	覆盖 Metabase MCP 服务器二进制文件的路径。	metabase-server
LANGFUSE_PUBLIC_KEY	设置后启用到 Langfuse 的 OpenTelemetry 追踪。	(已禁用)
API_JOB_THREADS / API_JOB_PROCESSES	api Solid Queue 队列的专用工作池规模。	3 / 1

常用命令

# 开发
bin/dev                                    # 启动所有服务
bin/rails console                          # 交互式 Rails 控制台
bin/rails db:migrate                       # 运行待执行的迁移
bundle exec rubocop -a                     # 自动修复代码规范问题

# 测试
bin/rails test                             # 运行所有测试
bin/rails test test/path/to/file.rb:42     # 运行指定行的单个测试

# 数据
bin/rails support:sync                     # 同步配置即代码的自动化

# 生产环境 (Kamal)
kamal deploy                               # 部署到生产环境
kamal app exec -i --reuse 'bin/rails console'  # 生产环境控制台
kamal app logs -f                          # 实时查看日志