Kanera

Kanera 在一个快速、精致的工作空间中，统筹各个项目、客户和团队中已分配、进行中、受阻和已完成的工作。它将看板、结构化任务、依赖关系图与时间线、笔记、任务分配、进度历史、自动化和集成汇集到一个专注的系统中，提供比基础 Kanban 看板更全面的可见性，同时避免重量级工作套件带来的繁琐。

使用托管服务，几分钟即可开始；也可以在自己的基础设施上自托管 Kanera。

集中一处，推动工作前进

• 选择适合的视图来规划。 在 Kanban、表格、日历、依赖关系、我的卡片、团队卡片和已完成工作之间切换，无需重复工作。
• 查看如何为团队扫清障碍。 跨看板关联前置任务，在地图、时间线或步骤视图中追踪依赖链，发现风险与瓶颈，并直接在地图上编辑阻塞关系。
• 让任务包含所有相关细节。 为卡片添加描述、评论、附件、标签、自定义字段、关注者和可分配的清单项。
• 明确设定优先级。 使用首页和按优先级排序的「接下来处理」队列，让所有看板上的紧急工作一目了然。
• 让进度清晰可见。 查看哪些内容已创建、已移动、已完成或已勾选，无需再追问状态更新。
• 随时查阅相关知识。 使用个人、工作空间和看板笔记记录决策、流程、参考资料和项目背景，并通过随时可用的草稿板快速记录内容。
• 用键盘操作，保持专注。 打开搜索和个人工具、跳转到核心页面、切换看板视图、创建卡片，以及使用上下文快捷键更新打开的卡片。按下 ? 查看可用操作。
• 将工作委派给 AI Agent。 为 Agent 指派待处理的卡片，实时跟进运行状态和阻碍，并通过清晰的 Agent 归属信息审核结果。
• 自动化并集成。 通过基于触发条件的自动化处理重复更新，将卡片动态发布到 Slack、Discord、Telegram 或 Zulip，并通过 REST API、webhook 和 MCP 服务连接其他工具。
• 按需在合适的渠道接收重要通知。 针对每种通知类型，选择通过电子邮件、浏览器推送、ntfy、Gotify 或自定义 webhook 接收更新；还可设置工作空间级别的例外，避免某个繁忙看板的信息淹没其他内容。
• 实时协作。 借助实时更新、提及、活动历史和受控访客访问，随时掌握最新动态。
• 在任何屏幕上开展工作。 完整的 Kanera 体验可适配手机、平板电脑和桌面设备，也可作为 PWA 安装在 iOS、Android 和桌面设备上。

依赖关系显示接下来可以推进什么

使用 Blocks、Blocked by 或 Relates to 关系连接卡片，也可以跨看板连接。Kanera 会显示被阻塞的工作，并指出最后一个活动前置任务何时解除阻塞，帮助下一位成员顺利接手。

在看板、My Cards 或 Team Cards 中打开 Dependencies。在 Map 中沿依赖链查看，在 Timeline 中比较到期周，或阅读会适配手机屏幕的编号 Steps 列表。在工作区看板上，可以在看板的依赖链和整个工作区的依赖链之间切换，同时保留每张卡片的来源和权限。

查找 Blocked、At risk、Start here 和 Ready 工作，同时保留周围的依赖链。最大的瓶颈会指出阻碍最多未完成工作的卡片；Critical path 会按未完成卡片数量突出显示最长路径。Timeline 会将每条依赖链与共享的到期周列对齐，并用琥珀色标记到期时间晚于其依赖项的前置任务。

在 Map 或 Timeline 中，从卡片的 + 手柄拖动即可添加阻塞链接，也可以选择连接线将其移除。还支持点按建立链接和键盘操作，并可使用 Undo 和 Redo 撤销或重做对依赖图的编辑。更改会实时更新，Agent 也可以通过 MCP、CLI、SDK 或 REST API 查看相同的依赖链。

阅读依赖关系视图、时间线和编辑指南，或了解卡片关系和阻塞。

工作区和独立看板

Organisation
  ├─ Workspace
  │    └─ Board
  │         └─ Card
  └─ Standalone board
       └─ Card

如果多个看板需要遵循相同的运作模式，请使用工作区。列表、标签、自定义字段、清单模板和自动化只需配置一次，即可在工作区的各个看板中使用；随着项目发展，工作流和报告也能保持一致。

这意味着，In Review 这样的状态或 Client 这样的字段在所有地方都具有相同含义——无需为每个看板重新配置，也不必日后协调不一致的设置。

如果某项工作无需共享这些设置，则可创建独立看板。它的列表、标签、自定义字段、清单模板、自动化、成员、访问权限和集成均独立于你的工作区。

与 AI Agent 协作，进度清晰可见

使用你已经在协作的 Claude、ChatGPT、Codex、Cursor 或其他 Agent 来接手卡片、阅读其背景信息、执行任务，并在 Kanera 中汇报进展。Agent 的工作与团队工作位于相同的看板上，进度实时可见，阻塞情况一目了然，也会记录谁为谁完成了哪些工作。

用于分派工作和审核结果的看板

从 Agent Workflow 模板开始：Backlog → Agent Working → Waiting on Me → Review → Done。在卡片上描述任务，然后让你的 Agent 接手。按照 Kanera 的 Agent 指令，它会在工作开始、需要你提供信息或任务完成时移动卡片。你可以审核结果，并决定何时将卡片移至 Done。

此工作流将普通卡片与 Agent 运行结合起来。运行会跟踪工作会话；卡片移动则始终是 Agent 或人员明确执行的操作，因此开始或完成运行不会悄悄移动卡片。

了解当前正在运行的内容，以及哪些事项需要你处理

Agent 会在开展多步骤工作前开启一个运行，并用简短的进度说明更新它。查看看板的所有人都会在卡片上看到实时状态标记；当 Agent 正在等待某人处理时，标记会变为琥珀色。打开卡片即可查看 Agent、它当前的工作，以及上次汇报的时间。你可以通过拉取请求或会话链接直接查看结果。

运行结束后，其结果和结束摘要会保留在卡片的活动记录中。停止汇报的运行会在十五分钟后标记为停滞，因此中断的 Agent 不会让工作看起来仍在进行。被阻塞的运行会明确显示正在等待；Agent 还应评论说明遇到的问题，以便通知关注者和负责人。

跟进 Agent 的工作，同时保留归属信息

通过 OAuth 连接后，评论和更改会显示 Agent 代表其执行操作的人员，以及 via Claude、via Codex 或其他 Agent 徽标。这也包括通过 CLI 浏览器登录：使用 kanera auth login --agent "Claude Code" 为 Agent 指定名称。个人 API 密钥会将操作归属到其所有者名下，但不会显示 via 徽标；工作区和看板密钥则使用密钥名称。

即使 Agent 代表你执行操作，它所做的更改也可以通知你。Agent 标签页会汇总这些更新，而 Work Done 会区分 Agent 的输出和你自己的操作。Agent 仍受已连接人员当前的看板权限约束；只读凭据则会在服务端禁止写入。

了解更多关于Agent 运行、归属信息和 Agent 工作流模板的内容。

通过 MCP 或 CLI 连接你的 Agent

接口	用途	开始使用
kanera CLI	终端、脚本、CI，以及能够运行 shell 命令的编码 Agent	npm install --global @kanera/cli · CLI 文档
MCP 服务	Claude、ChatGPT、Codex、GitHub Copilot、Cursor、Gemini CLI、OpenCode 和其他 MCP 客户端，通过 OAuth 连接	https://mcp.kanera.app/mcp · MCP 配置指南
Agent Skill	教 Claude Code、Codex 和其他 Agent 可靠地使用 Kanera	kanera setup claude 或 npx -y skills add https://github.com/happendev/Kanera/tree/main/integrations/skills/kanera · Skill 源码
TypeScript SDK	你自己的应用和集成	npm install @kanera/sdk · SDK 文档
REST API 和 Webhook	任何语言、同步任务和事件驱动型集成	API 文档

CLI 和 MCP 服务使用相同的工具层，因此 Agent 通过 MCP 能做的任何事，也能通过 shell 中的 kanera 完成。这包括 Timeline 视图中的排期：work.schedule（CLI kanera schedule <boardId>，SDK kanera.work.schedule()）会返回某个看板或工作区的关键路径、以工作日计的松弛时间、排期冲突和预计完成时间，让 Agent 能依据与图表相同的数据回答“何时能完成”和“如果这项工作延期会影响什么”；schedule.conflict_detected 和 schedule.critical_path_slipped 事件，或 scheduling_conflict_appears / critical_path_slips 自动化，则会在计划需要关注时通知它。无需安装即可试用 CLI：

npx -y @kanera/cli commands

服务器会强制执行只读凭据；可自托管的 Kanera 也会提供自己的 MCP 地址和 API，供相同的 CLI 和 SDK 使用。请参阅在终端中使用编码 Agent，了解如何通过 Claude Code 或 Codex 领取卡片并汇报进度。

查看 Kanera 的实际使用效果

Home 让你聚焦今天和本周

在一个专注的视图中查看逾期工作、今天到期的事项、未来七天的安排和近期进展。快速返回正在进行的看板，无需逐个打开项目即可浏览本周安排。

看板和共享列表让工作流一目了然

在各列表间移动卡片，同时查看标签、负责人、截止日期、清单进度和封面。工作区中的看板共用相同的排序列表，因此“收件箱”“进行中”“审核中”和“已完成”等阶段在相关项目中保持一致。

键盘快捷键让日常操作触手可及

按 ? 打开与当前屏幕对应的快捷键面板。使用双键组合跳转到 Home、My Cards、Team Cards 或 Settings；使用单键打开 Scratchpad、Up next、通知和看板工具；还可使用上下文相关的卡片快捷键来分配负责人、设置标签和截止日期、移动到列表、标记完成、关注卡片以及复制链接。输入文字时，字母快捷键会自动停用。

Up next 按优先级整理待办事项

将你在所有可访问看板中负责的卡片汇总成一个按优先级排序的队列。随着优先级变化重新排序，同时查看来源看板和截止日期；Home、My Cards、看板卡片和 Table 中都会显示相同的顺序。

表格视图将实时工作转化为结构化报告

按列表、负责人、截止日期、标签、状态或自定义字段对卡片分组和排序，然后选择重要的列，并直接编辑任意字段。数值型自定义字段支持按组计算总和与平均值，还可添加第二个细分维度，回答“按客户和工作类型划分的工时”等问题。

将筛选结果导出为 Excel 多工作表工作簿，其中包含卡片行、便于在电子表格中使用的摘要，以及启用汇总时生成的易读报告。

时间线视图为后续工作制定计划

为卡片设置开始日期和截止日期，面板的 时间线 视图便会在甘特风格图表中将其显示为条形，并按列表、负责人或标签分组。拖动条形可重新安排时间（工作日长度保持不变），拖动端点可调整长度，点击空白泳道可放置未安排的卡片，还可以从一个条形的末端拖到另一个条形，为后者设置前置依赖。关键路径会基于面板中的阻塞链接制定工作日计划，突出显示没有浮动时间的链路，淡化其余卡片，并显示其他卡片最多可以延后的时间。如果某张卡片的前置任务计划完成时间晚于该卡片的开始时间，系统会将其标记为排期冲突。

请阅读时间线和开始日期指南，了解工作日排期、桌面端和手机端控件、MCP 规划示例以及排期事件。

通知汇集重要变更

查看提及、任务分配、评论、截止日期变更及其他更新，同时保留其背后的面板上下文。按日期、面板或人员对动态流分组，可将范围缩小到单个面板或某位同事，也可按卡片、面板或列表搜索。

然后，选择每种通知类型的接收渠道：电子邮件、浏览器推送、ntfy、Gotify 或自定义的签名 Webhook。每个工作区的规则可以暂停或缩小单个嘈杂工作区的通知范围，而不会削弱账户默认设置；无论在其他位置关闭了哪些通知，应用内抽屉始终保留完整历史记录。

丰富的卡片将工作及其上下文集中在一起

描述、自定义字段、检查清单、截止日期、评论、附件和活动记录都集中在一个专注的卡片视图中。

Team Cards 汇总跨面板分配的工作

查看整个可见团队，或专注于某位队友，同时保留每张卡片所属的面板、列表、字段和权限。可在面板、团队概览、表格、日历、依赖关系和已完成工作视图之间切换，查看各项目的负责人、工作负荷和执行顺序。

团队概览展示每个人正在忙什么

每位队友各有一个面板，无需逐个打开看板，就能回答“每个人在做什么，接下来要做什么？”：按进行时间从长到短排列的「进行中」卡片及其进行时长、他们最近移动或自行创建的内容、「即将开始」队列的最前几张卡片、按截止日期排列的其他指派给他们的卡片，以及他们本周完成的工作。「未开始」、「进行中」、「已逾期」和「已完成」计数可展开为完整列表；未指派负责人的进行中工作会显示在单独的面板中；折叠某个分区后，所有人看到的都是折叠状态。

选择一位队友，即可只查看其面板，并在旁边停靠其「即将开始」队列。重新排列队列，并从他们尚未加入队列的未开始卡片中，选择接下来要做的工作；这些卡片按截止日期从近到远排列。

自动化让日常工作持续推进

通过 当 触发条件和按顺序排列的 执行 操作来构建自动化。触发条件可响应卡片进入或离开列表、自定义字段变为指定值、截止日期临近或到期、开始日期到来、指派人员或标签变更、清单或卡片完成，或卡片达到配置的非活动时长。随后，Kanera 可以添加标签、指派人员、应用清单模板、设置截止日期和自定义字段、移动卡片，或将工作标记为已完成。自动化可以属于单个独立看板，也可以在工作区的所有看板中运行。

「已完成工作」展示实际取得的进展

查看每日记录，其中包括创建、移动和完成的卡片，以及已完成的清单项。可在看板、「我的卡片」或「团队卡片」中使用，适用于每日站会、异步进度更新、进度回顾和客户沟通。

移动端功能齐全，也可安装为 PWA

Kanera 响应式、适合触控的界面，让你可以在手机和平板电脑上使用看板、卡片、表格、日历、「我的卡片」、「团队卡片」、通知、设置及产品中的其他功能。可在浏览器中使用，也可在 iOS、Android 或桌面设备上安装 PWA。已安装的设备支持推送通知，最近打开的看板在网络连接中断时仍可浏览。

在 kanera.app/features 了解完整的产品导览。

迁移到 Kanera，无需从头开始

Kanera 提供了 Trello JSON、Kanera 看板 JSON 导出文件和 CSV 文件的引导式导入工具。上传导出文件，映射其列或工作区数据，检查结果，然后确认执行一次性、受控的导入。如果导入时连接了 Trello，Kanera 可以保留附件链接并复制受支持的上传文件。原始看板或文件不会更改，之后源数据的变更也不会自动同步。

对于 Jira、ClickUp、Asana、monday.com、Notion、Linear、电子表格或内部系统，可将一个有代表性的项目导出为 CSV 并使用 CSV 导入工具。导入完整项目之前，请检查其列、用户、日期和多值字段。

• 从 Trello 导入
• 了解迁移选项

托管版或可自托管版

托管版 Kanera 是最简单的入门方式。新账户可享受 30 天 Pro 试用，无需绑定银行卡；之后，团队可以继续使用 Free，也可以升级到 Pro。Pro 提供无限数量的看板和自动化、供客户和承包商使用的看板访客、REST API、webhook、聊天目标、个人通知渠道和电子邮件支持，通常会在一个工作日内回复。请参阅当前定价。

可自托管的 Kanera 不设套餐限制，也不按席位收费。上述所有功能均包含在内，包括访客、REST API、webhook、聊天目标和个人通知渠道。基础设施、存储、维护和备份均由你掌控。

• 自托管指南
• Docker 部署
• Dokploy 部署
• 发布和 npm 发布流程

面向开发者

Kanera 是一个 pnpm monorepo，使用 Angular 22、Fastify 5、Socket.IO 4、PostgreSQL 18、Drizzle ORM 和 Valkey 构建。

如需了解 AI 工具和自动化研究，请参阅 LLM 可读文档索引。

apps/api/           Fastify API, worker, public API, and migrations
apps/web/           Angular web application
apps/admin-web/     Angular administration application
apps/mcp/           MCP server for AI clients
apps/cli/           kanera command-line interface for terminals and AI agents
packages/sdk/       @kanera/sdk TypeScript client for the public API
packages/shared/    Shared schema, DTOs, events, and workspace defaults
docker/             Local and production support files

本地设置

你需要 Node.js 24、pnpm 11（通常通过 corepack enable 启用）和 Docker。

pnpm install
cp .env.example .env

pnpm dev:db
pnpm db:migrate
pnpm dev

打开 http://localhost:4200。

示例环境使用运行于 localhost:5433 的 PostgreSQL 和运行于 localhost:6379 的 Valkey。在应用对外开放之前，请将 JWT_SECRET 和 MEDIA_SIGNING_SECRET 替换为唯一的随机值。可选设置和默认值请参阅 .env.full.example。

如需载入一个真实的演示工作区：

pnpm dev:db:reset:seed

种子账户详细信息记录在 dev-db-seed-content/README.md 中。

常用命令

pnpm dev                  # API :3000 + worker :3003 + web :4200
pnpm dev:public-api       # Public integration API on :3001
pnpm dev:mcp              # MCP server on :3002
pnpm cli -- whoami        # Run the kanera CLI from the workspace
pnpm dev:db               # Start local PostgreSQL and Valkey
pnpm dev:db:down          # Stop local database services
pnpm db:generate          # Generate Drizzle migrations
pnpm db:migrate           # Apply pending migrations
pnpm build                # Build and type-check all packages
pnpm lint                 # Type-check and lint all packages
pnpm test                 # Run unit and integration test suites
pnpm test:api             # Run API unit and route tests
pnpm test:cli             # Run CLI tests
pnpm test:sdk             # Run SDK tests
pnpm test:api:integration # Run API integration tests with isolated PostgreSQL

架构概览

• **灵活的看板模型：**工作区中的看板共享列表、标签和自定义字段，而独立看板则将配置彼此隔离。

• **实时协作：**REST 是写入路径，Socket.IO 会向已连接的客户端广播类型化事件。

• **持久化事件：**看板级和工作区级事件会记录到发件箱中，以支持跨进程实时传递和 webhook。

• **集成：**工作区 API 密钥支持外部工具接入，无需暴露用户凭据。

• **应用外部的消息投递：**聊天目标是设置了提供方的 webhook 端点，因此 Slack、Discord、Telegram 和 Zulip 可以共用 webhook 工作进程、重试策略和投递历史记录。个人通知渠道通过推送队列运行，用户拥有的端点会使用 HMAC 签名载荷。

• **Agent 原生 MCP：**支持 OAuth 的 AI 客户端可以使用短时令牌、结构化工具结果、明确的安全注释和可审计的访问权限进行连接。组织管理员可以向已连接的 Agent 提供一个空白账户，让它根据模板初始化工作区和独立看板。

• 类型安全的 API 客户端：@kanera/sdk 封装了公共 API，支持卡片键解析、游标迭代、幂等重试和 webhook 签名验证。请参阅 packages/sdk/README.md。

• Agent 原生命令行工具：kanera 向任何能够运行 shell 命令的 Agent 提供与 MCP 服务相同的工具层，包含机器可读的命令目录，并使用不同的退出码区分“无权执行”和“执行失败”。无需全局安装即可通过 npx -y @kanera/cli commands 试用，也可以使用 npm install --global @kanera/cli 安装。

Kanera 还支持 MCP 事件订阅，可通过经过验证的 HTTPS 回调接收卡片创建、更新、移动和新评论事件。有关筛选、订阅期限和部署检查，请参阅 MCP 事件。

托管版 MCP 客户端连接到 https://mcp.kanera.app/mcp。有关支持的客户端和设置说明，请参阅 AI 和 MCP 指南。命令行相关内容请参阅 apps/cli/README.md。

许可证

Kanera 的源代码采用 Elastic License 2.0 授权。你可以检查、修改并自托管，以供自己使用，但不得将 Kanera 作为托管或管理服务提供给第三方。

@kanera/sdk API 客户端是例外：它采用 MIT 许可证，因此可以嵌入任何应用，无需担心许可证政策限制。

Kanera 名称、徽标和品牌素材由 TRADEMARKS.md 单独规定。