​

Server 项目管理

​

项目详情

• 成员列表来自 GET /api/workflows/{name}/members，支持 owner / manager / runner / viewer 四类角色。
• owner 和 manager 可以用 PUT /api/workflows/{name}/members/{userId} 授权或调整成员；当前阶段不支持 owner 转移，manager 也不能把任何人提升为 owner。
• 邀请同事加入项目用 POST /api/workflows/{name}/invitations，请求体 { "role": "manager" | "runner" | "viewer" }；服务端会签发一次性 7 天有效 token 并返回 { invitation, token }。owner 角色不通过邀请授予。前端管理端把这个接口暴露在项目成员 tab 的“邀请成员”区块，复制 ${origin}/invite/${token} 链接发给已注册同事即可。被邀请人在浏览器打开链接会进入 /invite/:token 接受页；后端先调用公开的 GET /api/invitations/:token 校验 token 并返回项目名 + 角色（接口本身不需要登录，token 就是 bearer 凭据），未登录用户在页面会被引导先登录，登录后调用 POST /api/invitations/:token/accept 把该用户写入项目成员表。DELETE /api/workflows/{name}/invitations/:invitationId 可撤销尚未接受的邀请；过期、撤销或重复接受的 token 会返回 410 或 409。
• PATCH /api/workflows/{name}/visibility 在 private / public 之间切换项目可见性。public 只放开“已登录用户可读/可运行”，匿名访问仍不开放。
• GET /api/workflows/{name}/run-users 展示按 actor 聚合的运行用户统计，包括 run count、success/failed、最近运行时间和 token usage 汇总。
• GET /api/workflows/{name}/run-blocks、PUT /api/workflows/{name}/run-blocks/{userId} 与 DELETE /api/workflows/{name}/run-blocks/{userId} 管理运行禁止名单；owner 和 manager 不能被加入 run block。

​

版本详情

​

KV 数据库

• workflow_project_kv_view：包含 workflow / conversation scope，可接 NocoDB 做表格筛选视图。
• workflow_global_kv_view：只包含 global scope，可接 Metabase / Grafana 做统计面板。

​

知识库

• 新建文档：打开对话框输入标题和 markdown，调用 POST /api/workflows/{name}/knowledge-documents?response=summary，成功后刷新列表并选中新文档。response=summary 只回传摘要，避免大 markdown 写入后再把完整正文传回管理端。
• 列出文档：左侧列表调用 GET /api/workflows/{name}/knowledge-documents?pageSize=20，只加载标题、摘要和时间等摘要数据；继续浏览时用返回的 nextCursor 加载下一页。列表项保持紧凑，只显示标题和更新时间，正文按需读取。
• 编辑文档：在主区域编辑模式修改标题或 markdown，调用 PUT /api/workflows/{name}/knowledge-documents/{documentId}?response=summary，成功后刷新摘要和预览。预览/编辑使用同一个模式切换按钮，保存、删除与新建入口都位于文档区域标题栏，避免文档操作挤占正文阅读高度。
• 删除文档：确认后调用 DELETE /api/workflows/{name}/knowledge-documents/{documentId}。由于 KV/PersistentValue 暂无 delete primitive，server 会从索引移除文档，并把单篇文档 key 写成 tombstone 标记用于审计。
• 查找内容：左侧搜索框按 Enter 调用 GET /api/workflows/{name}/knowledge-documents/search 并查找全部文档。q 是搜索词，beforeLines / afterLines 控制每条匹配向上、向下返回多少行上下文，pageSize / cursor 控制服务端分页；旧 maxMatches 仍兼容为本页大小。管理端默认每页展示 200 条，通过 totalMatches / hasMore / nextCursor 提示和加载更多；结果显示在左侧列表下方，不再展示独立右侧查找面板。需要指定文件 n~m 行时调用 GET /api/workflows/{name}/knowledge-documents/{documentId}/lines?startLine=n&endLine=m。

​

环境变量

• systemVars：由 workflow 结构或平台推导出的系统变量。
• customVars：用户添加的自定义变量。

​

执行日志

​

审计日志

• 事件类型、结果、principal 类型、actor userId / displayName。
• 资源类型、资源 ID。
• request IP、User-Agent。
• 结构化 context，以及可选的 workflow / project / run 关联字段。
• 事件创建时间和分页 cursor。

• token、access token、refresh token、API key、admin key。
• secret、Webhook secret、Authorization、cookie、session 标识。
• 环境变量原值和其它凭据类字段。

​

Embed 工作流入口

• enabled：是否启用公开入口。
• title / description：入口配置元信息；公开嵌入页不再把它们作为首屏大标题展示。
• target：latest 或在线的具体版本号。
• token：公开入口 token，可重置。重置后旧链接失效。

​

Webhook

• 是否启用。
• 目标版本。
• X-Workflow-Webhook-Secret 签名头。
• body 到 workflow input 的映射，例如 event.text -> message。
• 请求体过滤规则。Webhook 配置页会展示当前 body filters 的分组数量、条件数量、路径、操作符和值；未配置时会明确显示“未配置”。默认不配置时所有通过签名校验的请求都会触发；配置后只有请求体字段命中过滤条件才会创建 run。过滤规则按“任意分组命中即可”判断，分组内所有条件都必须命中。被过滤的请求返回成功响应但不会出现在执行日志表格。（issue #72, issue #73）

{
  "enabled": true,
  "target": "latest",
  "mapping": [{ "bodyPath": "$", "inputName": "payload" }],
  "filters": [
    {
      "conditions": [
        { "bodyPath": "object_kind", "operator": "equals", "value": "push" }
      ]
    },
    {
      "conditions": [
        { "bodyPath": "object_kind", "operator": "equals", "value": "note" },
        { "bodyPath": "object_attributes.note", "operator": "matches", "value": "^\\\\s*@workflow-(review|build)\\\\b" }
      ]
    }
  ]
}

​

移动端与深色模式

​

追踪