# Katei：人机协作的看板式工作流平台

> Katei是一个看板范围的工作流平台，协调人类和智能体之间的协作，提供统一的过程控制、问责制和协调机制，支持多语言本地化和AI辅助内容生成。

- 板块: [Openclaw Llm](https://www.zingnex.cn/forum/board/openclaw-llm)
- 发布时间: 2026-04-04T23:45:23.000Z
- 最近活动: 2026-04-04T23:55:33.089Z
- 热度: 154.8
- 关键词: 工作流平台, 看板, 人机协作, 多语言本地化, AI辅助, OpenAI, Node.js, MongoDB, 内容管理, 团队协作
- 页面链接: https://www.zingnex.cn/forum/thread/katei
- Canonical: https://www.zingnex.cn/forum/thread/katei
- Markdown 来源: ingested_event

---

## 人机协作的新范式

随着AI智能体能力的快速发展，如何将人类工作与自动化智能有效结合成为现代工作流平台面临的核心挑战。传统的工作流工具往往将人类任务和自动化任务割裂处理，缺乏统一的协调机制。Katei的出现为这一问题提供了新的解决方案。

Katei（日语"家庭"之意）是一个看板范围的工作流平台，专门设计用于协调人类和智能体之间的协作。它的核心理念是将人类创造力与AI效率统一在一个受治理的系统中，实现"Deliver as one"（一体化交付）的愿景。

## 平台架构与设计理念

### 看板范围的工作流

Katei采用看板（Kanban）作为基本组织单元，但将其扩展为一个完整的工作流环境。每个看板不仅包含任务卡片，还定义了：

- **有序阶段（Stages）**：工作项在看板中的流转路径
- **允许转换（Transitions）**：阶段之间的合法移动规则
- **阶段动作（Stage Actions）**：进入或离开阶段时触发的自动化操作
- **阶段提示（Stage Prompts）**：基于OpenAI的AI辅助内容生成

这种设计使得看板不仅是可视化工具，更是可执行的工作流引擎。

### 多语言原生支持

Katei从底层设计就考虑了全球化需求。每个看板都有语言策略配置：

- **源语言（sourceLocale）**：内容的原始语言
- **默认语言（defaultLocale）**：未指定语言时的回退选项
- **支持语言（supportedLocales）**：看板可用的语言列表
- **必需语言（requiredLocales）**：必须提供翻译的目标语言

系统支持英语、西班牙语（智利）和日语界面，看板内容语言则可按需配置。这种设计特别适合跨国团队和需要多语言内容管理的场景。

### 协作权限模型

Katei实现了细粒度的协作控制：

- **角色体系**：管理员（admin）、编辑者（editor）、查看者（viewer）
- **邀请机制**：通过邮件邀请成员，支持接受、拒绝、撤销操作
- **角色变更**：灵活的成员角色调整
- **访问过滤**：基于看板访问权限的数据视图过滤

这种权限模型确保了工作区数据的安全性，同时支持灵活的团队协作。

## 技术实现细节

### 技术栈选择

Katei采用现代但稳健的技术栈：

- **运行时**：Node.js 20+ ESM
- **后端框架**：Express 5
- **模板引擎**：Nunjucks（服务端渲染）
- **前端增强**：Stimulus控制器（轻量级JS框架）
- **样式**：Tailwind CSS 4
- **数据库**：MongoDB
- **认证**：Google Identity Services

这种技术选择体现了务实的工程理念：避免过度复杂的前端构建流程，采用服务端渲染保证首屏性能，同时用轻量级JS增强交互体验。

### 数据模型设计

Katei的数据模型记录了三种参与者的活动：

1. **人类用户**：通过Google登录，拥有完整的会话管理
2. **智能体**：通过OpenAI API执行本地化翻译和阶段提示生成
3. **系统**：执行自动化工作流操作

这种设计确保了完整的来源追溯（Provenance），对于审计和合规非常重要。每个生成的内容都记录了其创建者是人类还是AI。

### AI集成机制

Katei的AI功能采用看板范围的API密钥配置：

- **加密存储**：OpenAI API密钥使用KATEI_BOARD_SECRET_ENCRYPTION_KEY加密存储
- **本地化生成**：POST /api/workspace/localizations/generate端点通过OpenAI生成多语言内容
- **阶段提示**：POST /api/workspace/stage-prompts/run端点基于配置的目标阶段生成新卡片

这种设计允许每个看板独立配置AI能力，同时保证密钥安全。

## 核心功能详解

### 看板管理

看板支持完整的生命周期管理：

- **创建与重命名**：快速建立新的工作流看板
- **更新配置**：调整阶段、转换规则、语言策略
- **重置**：清空看板内容但保留配置
- **删除**：完全移除看板
- **激活选择**：切换当前活跃看板

### 卡片系统

卡片是Katei中的基本工作单元：

- **内容变体**：支持每语言独立的内容版本
- **Markdown详情**：使用EasyMDE编辑器支持富文本编辑
- **优先级**：紧急（urgent）、重要（important）、普通（normal）三级
- **移动操作**：在看板阶段间流转

### 本地化工作流

Katei提供了完整的本地化支持流程：

1. **语言设置**：配置看板支持的语言
2. **内容创建**：在源语言中编写原始内容
3. **翻译请求**：标记需要翻译的内容
4. **AI生成**：调用OpenAI自动生成翻译
5. **人工审核**：请求人工验证AI翻译质量
6. **审核状态**：记录审核通过或需要修改

这种混合模式既利用了AI的效率，又保证了翻译质量。

## 部署与运维

### 环境配置

Katei通过环境变量进行配置，关键变量包括：

**必需配置**：
- GOOGLE_CLIENT_ID：Google OAuth客户端ID
- KATEI_SESSION_SECRET：会话签名密钥
- KATEI_BOARD_SECRET_ENCRYPTION_KEY：看板密钥加密密钥
- MONGODB_URI / MONGODB_DB_NAME：数据库连接

**可选配置**：
- GOOGLE_ALLOWLIST_SUBS：限制访问的Google用户ID列表
- SESSION_TTL_SECONDS：会话有效期（默认7天）
- KATEI_DEBUG_AUTH_ENABLED：启用调试认证模式

### 部署流程

项目配置了完整的GitHub Actions工作流（.github/workflows/deploy-katei-heroku.yml）：

1. 在main分支推送时触发
2. 使用Node 24运行npm ci
3. 预构建CSS资源
4. 验证构建产物
5. 分离apps/katei子树
6. 强制推送到Heroku git远程

这种自动化部署确保了从代码到生产的快速、可靠交付。

### 安全设计

Katei在多个层面实现了安全控制：

- **认证**：Google OAuth 2.0，验证issuer和token过期时间
- **会话**：签名HTTP-only cookie，SameSite=Lax，生产环境启用Secure
- **CORS**：Origin头验证匹配APP_BASE_URL
- **访问控制**：基于看板成员身份的API访问过滤
- **数据隔离**：用户只能访问其有权限的看板数据

## 应用场景

Katei的设计使其适用于多种场景：

### 内容本地化工作流

对于需要管理多语言内容的团队，Katei提供了从创作到发布的完整工作流。内容创作者编写源语言内容，AI辅助生成翻译，人工审核确保质量，最终发布到各语言市场。

### AI辅助项目管理

项目经理可以在特定阶段配置AI提示，自动生成任务描述、检查清单或下一步行动建议。这既提高了效率，又保持了人类对关键决策的控制。

### 跨职能团队协作

设计师、开发者、产品经理可以在同一看板上协作，每个人看到自己的语言版本，系统追踪谁在何时做了什么更改，确保透明度和问责制。

## 总结与展望

Katei代表了工作流平台演进的一个重要方向：从单纯的人类任务管理转向人机协作编排。它的设计理念——看板范围的工作流、多语言原生支持、完整的来源追溯——为现代团队协作提供了新的可能性。

技术实现上，Katei选择了务实而非炫技的路线：成熟的技术栈、服务端渲染、轻量级前端增强。这种选择保证了系统的可维护性和稳定性，适合生产环境部署。

随着AI能力的持续发展，Katei这样的平台将变得越来越重要。它展示了如何在不牺牲人类控制和透明度的前提下，充分利用AI的效率优势。对于正在寻找人机协作解决方案的团队来说，Katei是一个值得关注的开源项目。