API 参考

Workflow OpenAPI 3.1 合同的网页版参考：285 个端点，按资源分组，含鉴权要求、路径与查询参数、请求体与响应示例。

合同真值：OpenAPI 3.1（0.1.0）。鉴权见 Agent 接入。

auth

注册、登录、邮箱验证、找回/重置密码（公开端点）

• POST /auth/login：邮箱+密码登录（公开端点，无需鉴权）
• POST /auth/logout：退出登录（公开端点，无需鉴权）
• POST /auth/password/forgot：发起找回密码（公开端点，无需鉴权）
• POST /auth/password/reset：重置密码（公开端点，无需鉴权）
• POST /auth/register：邮箱+密码注册（公开端点，无需鉴权）
• POST /auth/verification/resend：重新发送邮箱验证邮件（公开端点，无需鉴权）
• POST /auth/verification/resend-code：重新发送 6 位邮箱验证码（公开端点，无需鉴权）
• POST /auth/verify-email：校验邮箱验证 token（公开端点，无需鉴权）
• POST /auth/verify-email-code：用 6 位验证码校验邮箱（公开端点，无需鉴权）

me

当前用户上下文、待接受邀请、活跃组织

• GET /me：当前用户上下文
• PUT /me/active-org：切换当前活跃组织
• GET /me/feishu-identities：我的飞书绑定（按项目）
• POST /me/feishu-profile-sync：用飞书资料填充我的个人资料
• GET /me/notifications：我的通知（跨项目聚合）
• POST /me/notifications/read：我的通知标记已读（跨项目：全部或指定若干条）
• GET /me/pending-invitations：我的待接受邀请
• PATCH /me/profile：更新我的个人资料
• GET /me/projects：我所属的项目
• GET /me/workbench：我的工作台（跨项目个人待办）

orgs

组织与组织成员

• GET /orgs：我所属的组织
• POST /orgs：创建组织
• GET /orgs/{orgId}/members：组织成员列表
• DELETE /orgs/{orgId}/members/{userId}：移出组织成员
• PUT /orgs/{orgId}/members/{userId}/role：修改组织成员角色

projects

项目壳、子域开通、接管

• GET /orgs/{orgId}/project-summaries：组织项目摘要卡片墙（只读聚合）
• GET /orgs/{orgId}/projects：组织下项目列表
• POST /orgs/{orgId}/projects：创建项目（线性开通）
• PATCH /projects/{projectId}：更新项目基本信息
• GET /projects/{projectId}/blueprint-analysis：项目立项分析历史
• POST /projects/{projectId}/blueprint-analysis/preflight：项目重分析前检查公开市场证据覆盖
• POST /projects/{projectId}/blueprint-analysis/reanalyze：项目内重新运行立项分析
• GET /projects/{projectId}/blueprint-analysis/reanalyze/pending：查询项目内尚待处理的重分析 Run
• POST /projects/{projectId}/blueprint-analysis/reanalyze/review：恢复等待人工确认的项目重分析
• POST /projects/{projectId}/freeze：冻结项目
• GET /projects/{projectId}/provisioning/{provisioningId}：查询开通进度
• POST /projects/{projectId}/provisioning/{provisioningId}/retry：重试开通
• POST /projects/{projectId}/takeover：接管项目
• POST /projects/{projectId}/unfreeze：解冻项目
• GET /projects/current：当前项目壳（Host 解析）
• GET /projects/domain-prefixes/{prefix}：检查子域前缀可用性（公开端点，无需鉴权）

project-members

项目成员与项目角色

• GET /projects/{projectId}/members：项目成员列表
• DELETE /projects/{projectId}/members/{userId}：移出项目成员
• PUT /projects/{projectId}/members/{userId}/department：修改项目成员部门
• PUT /projects/{projectId}/members/{userId}/role：修改项目成员角色
• GET /projects/{projectId}/public-members：项目成员的脱敏投影（供公开演示环境显示人名）
• GET /projects/{projectId}/roles：项目角色列表
• POST /projects/{projectId}/roles：新增项目角色
• PUT /projects/{projectId}/roles/{roleId}：修改项目角色
• POST /projects/{projectId}/roles/{roleId}/disable：停用项目角色
• POST /projects/{projectId}/roles/{roleId}/enable：恢复已停用的项目角色

project-versions

项目设置·版本管理（Schedule Kernel ReleaseWindow 的项目面读写入口，含设为当前互斥命令）

• GET /projects/{projectId}/versions：项目版本列表
• POST /projects/{projectId}/versions：新增项目版本
• DELETE /projects/{projectId}/versions/{versionId}：删除项目版本
• PUT /projects/{projectId}/versions/{versionId}：更新项目版本
• POST /projects/{projectId}/versions/{versionId}/set-current：设为当前版本

api-tokens

项目面 API Token（Workflow CLI / Agent PAT）生命周期；仅 cookie session 可管理，PAT 不可自管理

• GET /projects/{projectId}/api-tokens：项目 API Token 列表
• POST /projects/{projectId}/api-tokens：创建项目 API Token
• DELETE /projects/{projectId}/api-tokens/{apiTokenId}：撤销项目 API Token

feishu-integrations

项目级飞书入站机器人配置与事件回调；配置经项目设置维护，事件入口走飞书签名校验

• POST /integrations/feishu/{integrationId}/events：飞书事件回调入口（公开端点，无需鉴权）
• GET /integrations/feishu/identity/callback：飞书 OAuth 身份绑定回调（公开端点，无需鉴权）
• GET /projects/{projectId}/integrations/feishu：读取项目飞书入站机器人配置
• PUT /projects/{projectId}/integrations/feishu：更新项目飞书入站机器人配置
• DELETE /projects/{projectId}/integrations/feishu/identity：解绑本人飞书身份
• GET /projects/{projectId}/integrations/feishu/identity：查询本人飞书身份绑定状态
• POST /projects/{projectId}/integrations/feishu/identity/auth-url：签发飞书 OAuth 授权 URL
• POST /projects/{projectId}/integrations/feishu/regenerate-callback-secret：重新生成飞书入站回调 secret

invitations

项目邀请、落地与接受

• GET /invitations/{token}：邀请落地信息（公开）（公开端点，无需鉴权）
• POST /invitations/{token}/accept：接受邀请
• POST /invitations/{token}/decline：拒绝邀请
• GET /projects/{projectId}/invitations：项目邀请列表
• POST /projects/{projectId}/invitations：邀请项目成员
• POST /projects/{projectId}/invitations/{invitationId}/revoke：撤销邀请

join-requests

主动申请加入项目（邀请的反方向）。申请端点恒返回 202、绝不透露子域上有没有项目， 以免捅穿项目壳可见性边界；反滥用阈值落 platform_settings 运行时可调。

• POST /join-requests：申请加入项目
• GET /me/join-requests：我发起的加入申请
• POST /me/join-requests/{joinRequestId}/cancel：撤回我的加入申请
• GET /projects/{projectId}/join-requests：项目加入申请列表（管理员审批用）
• POST /projects/{projectId}/join-requests/{joinRequestId}/approve：批准加入申请
• POST /projects/{projectId}/join-requests/{joinRequestId}/reject：驳回加入申请

onboarding

项目四步初始化引导（项目面，Host 解析）

• POST /onboarding/acceptance/confirm：Step 3 确认验收配置
• POST /onboarding/complete：Step 4 完成初始化
• POST /onboarding/invitations：Step 2 邀请成员（可暂不邀请）
• POST /onboarding/roles/confirm：Step 1 确认项目角色
• GET /onboarding/state：初始化引导状态（Host 解析项目）

acceptance

验收类型与状态配置

• PUT /projects/{projectId}/acceptance/statuses/{statusId}：修改验收状态
• GET /projects/{projectId}/acceptance/types：验收类型列表（含状态）
• PUT /projects/{projectId}/acceptance/types/{typeId}：修改验收类型

audit

审计日志

• GET /projects/{projectId}/audit-logs：审计日志（cursor 分页）· **未上线**（即将上线）

changes

项目面 ChangeSet/Event 增量读面与对象 activity

• GET /changes：ChangeSet 增量列表
• GET /projects/{projectId}/activity：项目级动态流（G8）
• GET /requirements/{requirementId}/activity：需求 activity
• GET /work-items/{workItemId}/activity：工作项 / 缺陷 activity

object-links

项目面通用 typed object links 只读关联

• GET /object-links：对象关联列表

requirement-graph

需求引用关系与里程碑→需求室→需求→WorkItem 四层图谱

• GET /requirement-graph：读取需求四层关系图谱
• DELETE /requirements/{requirementId}/references/{targetRequirementId}：解除两个需求的引用关系
• PUT /requirements/{requirementId}/references/{targetRequirementId}：绑定两个需求的引用关系

ai

项目面只读 AI 摘要、建议与风险解释

• GET /ai/requirements/{requirementId}/summary：需求 AI 只读解释
• POST /ai/schedule/explanation：排期传播 AI 只读解释

requirements

项目面需求对象与排期字段

• GET /requirements：需求列表
• POST /requirements：创建需求
• GET /requirements/{requirementId}：需求详情
• PATCH /requirements/{requirementId}：更新需求基础字段
• GET /requirements/{requirementId}/acceptance-items：需求验收项列表
• POST /requirements/{requirementId}/acceptance-items：创建需求验收项
• PATCH /requirements/{requirementId}/acceptance-items/{acceptanceItemId}：更新需求验收项
• PATCH /requirements/{requirementId}/acceptance-items/sort：排序需求验收项
• PATCH /requirements/{requirementId}/schedule：更新需求排期字段
• POST /requirements/{requirementId}/transition：执行需求状态转移
• GET /requirements/{requirementId}/transitions：列出需求可用转移
• GET /requirements/{requirementId}/workflow：需求的完整状态机与当前可走的边

requirement-rooms

项目面需求室——按模块/功能聚合需求与缺陷的功能容器；室 CRUD 与对象收纳/移出

• GET /rooms：需求室列表
• POST /rooms：创建需求室
• DELETE /rooms/{roomId}：删除需求室
• GET /rooms/{roomId}：需求室详情
• PATCH /rooms/{roomId}：更新需求室
• DELETE /rooms/{roomId}/feishu-chat：解除需求室的飞书群绑定
• POST /rooms/{roomId}/feishu-chat：为需求室新建或绑定飞书群
• GET /rooms/{roomId}/objects：列出需求室成员
• POST /rooms/{roomId}/objects：批量收纳对象
• DELETE /rooms/{roomId}/objects/{objectId}：移出单个对象
• GET /rooms/{roomId}/overview：需求室规则概览

work-items

项目面工作项对象、树与排期字段

• GET /work-items：工作项列表
• POST /work-items：创建工作项
• GET /work-items/{workItemId}：工作项详情
• PATCH /work-items/{workItemId}：更新工作项基础字段
• PATCH /work-items/{workItemId}/schedule：更新工作项排期字段
• PUT /work-items/{workItemId}/slots：更新工作项槽位值
• POST /work-items/{workItemId}/slots/{slotKey}/claim：认领角色位（把自己设为该槽当前经手人）
• POST /work-items/{workItemId}/transition：执行工作项状态转移
• GET /work-items/{workItemId}/transitions：列出工作项可用转移
• GET /work-items/{workItemId}/workflow：工作项的完整状态机与当前可走的边
• GET /work-items/tree：工作项树

documents

项目面文档对象、正文版本与需求上下文

• GET /documents：文档列表
• POST /documents：创建文档
• GET /documents/{documentId}：文档详情
• PATCH /documents/{documentId}：更新文档正文与状态

comments

宿主对象上的评论讨论（记录“为什么变”的人类讨论）

• GET /comments：评论列表
• POST /comments：发表评论
• DELETE /comments/{commentId}：软删除评论
• PATCH /comments/{commentId}：编辑评论

handoffs

交接纪要（Agent 完成一张单据后留下的 TL;DR 摘要；需求室维度倒序读面）

• GET /handoffs：某张单据上的交接纪要（最近在前）
• POST /handoffs：写一条交接纪要
• GET /rooms/{roomId}/handoffs：需求室交接纪要（最近在前）

notifications

站内通知（事件流 × 相关人的 per-user 物化投影；读取自己的通知并标记已读）

• GET /notifications：我的通知列表
• POST /notifications/read：标记通知已读

schedule

排期快照、依赖关系、里程碑与传播命令

• POST /schedule/milestones：创建里程碑
• DELETE /schedule/milestones/{milestoneId}：删除里程碑
• PUT /schedule/milestones/{milestoneId}：更新里程碑
• POST /schedule/propagation/apply：应用延期传播
• POST /schedule/propagation/preview：预览延期传播（dry-run，只算不写）
• POST /schedule/relations：创建排期依赖关系
• DELETE /schedule/relations/{relationId}：移除排期依赖关系
• PUT /schedule/requirements/{requirementId}/milestone：设置需求所属里程碑
• GET /schedule/snapshot：当前项目排期快照

sync

项目级增量变更流——需求 / 子任务 / 缺陷按 updatedAt 时间水位合成一条流（含软删墓碑）， 供 Agent 插件把线上单据刷成本地索引；服务器不记任何客户端状态。

• GET /sync/changes：项目级增量变更流（需求 / 子任务 / 缺陷）

admin

平台运营面（Operator Face）超管后台。全部要求 SessionCookie + 平台超管（users.platform_role=superadmin）； 非超管一律 403，未登录 401。只读写控制面库，与项目 RBAC 完全正交。T2 覆盖用户管理（列表 / 详情 / 五动作 / 任免超管）；T3 补总览 / 组织与项目 / 审计 / 平台配置。

• GET /admin/audit-logs：跨组织审计查询（平台超管）
• GET /admin/llm-generation-runs/{jobId}：读一次 LLM 生成的审计（平台超管）
• GET /admin/orgs：组织列表（平台超管）
• GET /admin/orgs/{orgId}：组织详情（平台超管）
• GET /admin/overview：平台总览计数与系统状态（平台超管）
• GET /admin/projects：跨组织项目列表（平台超管）
• GET /admin/quota-reconciliations：待人工结案的配额预占（平台超管）
• POST /admin/quota-reconciliations/{ledgerEntryId}/resolve：人工结案一笔悬空配额预占（平台超管）
• GET /admin/search/metrics：搜索服务运行指标（平台超管）（即将上线）
• GET /admin/settings：读平台配置（平台超管）
• PUT /admin/settings：写平台配置（平台超管）
• PUT /admin/settings/attachment-storage：写附件对象存储配置（平台超管）
• POST /admin/settings/attachment-storage/test：测试附件对象存储连通性（平台超管）
• GET /admin/settings/llm：读 LLM 配置（平台超管）
• PUT /admin/settings/llm：写 LLM 配置（平台超管）
• POST /admin/settings/llm/test：测试 LLM 连通性（平台超管）
• PUT /admin/settings/login-throttle：写登录失败限速阈值（平台超管）
• PUT /admin/settings/public-demo：写公开演示环境配置（平台超管）
• PUT /admin/settings/sentry：写 Sentry 错误上报配置（平台超管）
• PUT /admin/settings/site-credits：写官网鸣谢名单（平台超管）
• PUT /admin/settings/site-home：写官网首页配置（平台超管）
• PUT /admin/settings/site-roadmap：写官网路线图内容（平台超管）
• PUT /admin/settings/smtp：写 SMTP 邮件配置（平台超管）
• POST /admin/settings/smtp/send-test：发送测试邮件（平台超管）
• POST /admin/settings/smtp/test-connection：测试 SMTP 连接（平台超管）
• PUT /admin/settings/support：写客服气泡收件配置（平台超管）
• GET /admin/support/intake：列客服气泡收件箱（平台超管）
• GET /admin/support/intake/{intakeId}/attachments/{attachmentId}：下载一条收件的附件本体（平台超管）
• POST /admin/support/intake/{intakeId}/convert：把收件转成正式需求 / 缺陷（平台超管）
• POST /admin/support/intake/{intakeId}/reject：驳回一条收件（平台超管）
• GET /admin/users：用户列表（平台超管）
• GET /admin/users/{userId}：用户详情（平台超管）
• PUT /admin/users/{userId}/platform-role：任免平台超管（平台超管）
• POST /admin/users/{userId}/resend-verification：重发验证邮件（平台超管）
• POST /admin/users/{userId}/restore：恢复用户（平台超管）
• POST /admin/users/{userId}/revoke-sessions：强制登出用户（平台超管）
• POST /admin/users/{userId}/send-password-reset：发送重置密码邮件（平台超管）
• POST /admin/users/{userId}/suspend：禁用用户（平台超管）

public

公开只读端点，无鉴权。落地页 / 注册页 / 公告条消费的最小平台状态（注册开关 + 公告）， 绝不暴露运维外链等其余平台配置。

• GET /platform/status：公开平台状态（无鉴权）（公开端点，无需鉴权）
• GET /site/content：官网首页公开内容（无鉴权）（公开端点，无需鉴权）
• GET /site/roadmap：官网路线图公开内容（无鉴权）（公开端点，无需鉴权）

support

全站客服气泡：公开运行时配置与 Bug/需求收件。收件端点无鉴权（security: []）， 提交落进平台配置指定的「支持项目」（仿飞书入站的代填 actor 范式），带 IP 限流。

• GET /support/config：客服气泡公开运行时配置（无鉴权）（公开端点，无需鉴权）
• POST /support/tickets：客服气泡收件：提交 Bug 反馈或产品需求（无鉴权）（公开端点，无需鉴权）

dev

dev-only 工具端点

• GET /dev/outbox：dev-only 邮件 outbox（公开端点，无需鉴权）
• GET /health：Liveness probe（公开端点，无需鉴权）

workflow-config

工作流配置（模板 / 版本草稿发布 / 类型绑定 / 在途单重绑）。 读端点需 view_project，写端点需 manage_workflows。 旧 all-scope PAT 不含 manage_workflows——凡需写操作请重建令牌（在项目设置 → API Tokens 重新生成）。

• GET /projects/{projectId}/workflow-bindings：列出类型→版本绑定
• DELETE /projects/{projectId}/workflow-bindings/{workItemType}：清除类型绑定（回落默认流程）
• PUT /projects/{projectId}/workflow-bindings/{workItemType}：更新类型→版本绑定（不迁移在途单）
• GET /projects/{projectId}/workflows：列出工作流模板
• POST /projects/{projectId}/workflows：创建工作流模板
• DELETE /projects/{projectId}/workflows/{templateId}：删除工作流模板（软删）
• GET /projects/{projectId}/workflows/{templateId}：读取工作流模板摘要
• PATCH /projects/{projectId}/workflows/{templateId}：重命名工作流模板
• POST /projects/{projectId}/workflows/{templateId}/archive：归档工作流模板
• POST /projects/{projectId}/workflows/{templateId}/copy：复制工作流模板为新草稿
• GET /projects/{projectId}/workflows/{templateId}/draft：获取（或初始化）草稿
• PUT /projects/{projectId}/workflows/{templateId}/draft：整图替换草稿定义
• POST /projects/{projectId}/workflows/{templateId}/draft/publish：发布草稿为不可变版本
• POST /projects/{projectId}/workflows/{templateId}/draft/validate：验证草稿（不发布）
• POST /projects/{projectId}/workflows/{templateId}/unarchive：取消归档工作流模板
• GET /projects/{projectId}/workflows/{templateId}/versions/{versionId}：读取工作流版本（含图）
• GET /projects/{projectId}/workflows/{templateId}/versions/{versionId}/migration-preview：迁移影响预览（每旧状态在途单计数）
• POST /projects/{projectId}/workflows/{templateId}/versions/{versionId}/rebind：迁移在途工作项到目标版本（含状态映射）

research

research 数据后台（research face = research.workflow.games，独立 Host 外壳）。 Host 不解析项目租户；应用层全部端点要求有效会话 + platform_role=superadmin （researchActor guard），与项目 RBAC 完全正交——非超管一律 403、未登录 401。 另有部署层 Zero Trust / IP / VPN 访问控制（CIDR）作为第二重门禁；部署层缺失时生产上线 检查明确失败。公开健康检查只回存活状态，绝不暴露连接器、来源、内部版本或凭据状态； 敏感配置只回 configured / masked 布尔，写入加密且不进日志、Prompt 或事件明文。

• GET /research/capabilities：平台与采集能力覆盖矩阵（平台超管）
• PATCH /research/capabilities：调整采集能力运行配置（平台超管）
• GET /research/evidence：research Evidence 审核队列（平台超管）
• POST /research/evidence：审核 Evidence（平台超管）
• GET /research/health：research 数据后台存活探针（公开）（公开端点，无需鉴权）
• GET /research/ingest-batches：research 采集批次列表（平台超管）
• POST /research/ingest-batches/{batchId}/cancel：取消采集批次（平台超管）
• POST /research/ingest-batches/{batchId}/rerun：手动重跑采集批次（平台超管）
• GET /research/lineage/evidence/{evidenceId}：按 Evidence 查询真实数据血缘（平台超管）
• GET /research/metrics：research 指标字典列表（平台超管）
• POST /research/normalize/preview：标准化预览 / 回放（平台超管）
• GET /research/ontology/{kind}：research 本体节点列表（平台超管）
• GET /research/reports/latest：最新一周周报（平台超管）
• GET /research/settings：research 后台运行参数（平台超管）
• GET /research/snapshots：research 市场快照列表（平台超管）
• POST /research/snapshots：创建本周市场快照候选（平台超管）
• GET /research/snapshots/current：当前已发布市场快照（平台超管）
• POST /research/snapshots/publish：发布市场快照（平台超管）
• POST /research/snapshots/rollback：回滚市场快照指针（平台超管 · 高危确认）
• GET /research/sources：research 数据源兼容投影（平台超管）

market-snapshots

主产品只读市场快照接口（跨面契约，e4）。research 链产出的不可变 marketSnapshotId 是 用户侧方向生成与 OnePage 证据引用的唯一数据源。只暴露 approved Evidence 与当前/指定快照， 不暴露原始抓取凭据、未审核数据或 research 管理动作。会话或 Bearer 均可访问（只读）。

• GET /market-games：搜索公开市场游戏库
• GET /market-snapshots/{snapshotId}/evidence：市场快照证据只读（主产品引用）

blueprints

组织级立项分析草案（Project Blueprint Draft）。正式 Project 创建前的组织级控制面对象： 仅 Org Admin 可见 / 可创建 / 可编辑 / 可生成 / 可确认 / 可归档；普通组织成员对列表与详情均 不可见，且任何访问都返回通用 404（零感知，不暴露存在性）。草案不进业务库、不带 project_id、 不创建子域或 onboarding 状态。删除采用可恢复归档（archived），不删除已关联正式项目的历史。 本期只交付草案领域骨架（CRUD + 状态机 + CAS 并发 + 审计 + 边界）；问卷 / 方向 / OnePage / 配额 / 生成是后续需求（R-00057~62），草案的状态与版本字段为它们预留。

• GET /orgs/{orgId}/blueprint-drafts：组织立项分析草案列表
• POST /orgs/{orgId}/blueprint-drafts：创建立项分析草案
• DELETE /orgs/{orgId}/blueprint-drafts/{draftId}：归档立项分析草案（可恢复）
• GET /orgs/{orgId}/blueprint-drafts/{draftId}：读取立项分析草案详情
• PATCH /orgs/{orgId}/blueprint-drafts/{draftId}：更新立项分析草案（CAS 并发）
• GET /orgs/{orgId}/blueprint-drafts/{draftId}/directions：读取当前方向集（三方向对比 2j）
• POST /orgs/{orgId}/blueprint-drafts/{draftId}/directions/{directionId}/exclude：排除一个方向（6b，可撤销）
• POST /orgs/{orgId}/blueprint-drafts/{draftId}/directions/{directionId}/select：选择一个方向（人工确认门②）
• POST /orgs/{orgId}/blueprint-drafts/{draftId}/directions/regenerate：调整问卷重新生成方向集（新 version v{k+1}，d2c）
• POST /orgs/{orgId}/blueprint-drafts/{draftId}/generate：提交生成任务（带配额确认 + 原子预占 + 幂等键）
• POST /orgs/{orgId}/blueprint-drafts/{draftId}/generation-preflight：生成前检查公开市场证据覆盖
• GET /orgs/{orgId}/blueprint-drafts/{draftId}/jobs：列出草案下的生成任务
• POST /orgs/{orgId}/blueprint-drafts/{draftId}/materialize：确认建项并物化正式项目（门④）
• GET /orgs/{orgId}/blueprint-drafts/{draftId}/onepage：读取当前 OnePage 版本（编辑器入口）
• PATCH /orgs/{orgId}/blueprint-drafts/{draftId}/onepage/blocks/{blockId}：编辑块（CAS 并发）
• POST /orgs/{orgId}/blueprint-drafts/{draftId}/onepage/blocks/{blockId}/lock：锁定 / 解锁块（CAS 并发）
• POST /orgs/{orgId}/blueprint-drafts/{draftId}/onepage/blocks/{blockId}/regenerate：局部重生成（暂不可用）
• POST /orgs/{orgId}/blueprint-drafts/{draftId}/onepage/confirm：确认 OnePage（门③，永久只读）
• POST /orgs/{orgId}/blueprint-drafts/{draftId}/onepage/generate：选定方向生成 OnePage 初版（14 块）
• GET /orgs/{orgId}/blueprint-drafts/{draftId}/onepage/regen-jobs/{regenJobId}：读取局部重生成任务（状态恢复）
• GET /orgs/{orgId}/blueprint-drafts/{draftId}/onepage/versions：版本历史（版本列表）
• GET /orgs/{orgId}/blueprint-drafts/{draftId}/onepage/versions/{beforeId}/diff/{afterId}：逐区块 diff（版本历史）
• GET /orgs/{orgId}/blueprint-drafts/{draftId}/survey：读取当前生效问卷版本
• PUT /orgs/{orgId}/blueprint-drafts/{draftId}/survey：保存问卷草稿（免费，带 CAS 版本）
• POST /orgs/{orgId}/blueprint-drafts/{draftId}/survey/confirm：确认当前问卷版本并进入生成预检
• POST /orgs/{orgId}/blueprint-drafts/{draftId}/survey/intent：生成 Project Intent（确定性归一产物）
• POST /orgs/{orgId}/blueprint-drafts/{draftId}/survey/validate：提交前校验问卷（完整性 + 矛盾检查）
• GET /orgs/{orgId}/jobs/{jobId}：读取单份生成任务（状态恢复）
• POST /orgs/{orgId}/jobs/{jobId}/review：处理需要人工复核的生成任务
• GET /orgs/{orgId}/quota：读取组织配额余额与下次生成预览

attachments

• GET /attachments：按目标对象列附件
• POST /attachments：上传附件（multipart）
• DELETE /attachments/{attachmentId}：删除附件
• GET /attachments/{attachmentId}：附件元数据详情
• GET /attachments/{attachmentId}/content：下载附件文件本体

labels

• GET /labels：列出项目标签
• POST /labels：新建标签
• DELETE /labels/{labelId}：删除标签
• PATCH /labels/{labelId}：改标签名 / 颜色
• GET /objects/{objectType}/{objectId}/labels：读对象身上的标签
• PUT /objects/{objectType}/{objectId}/labels：整组替换对象的标签

custom-fields

• GET /projects/{projectId}/bug-fields：缺陷自定义字段定义列表
• POST /projects/{projectId}/bug-fields：新增缺陷自定义字段定义

project-config

• GET /projects/{projectId}/config：读取项目配置
• PUT /projects/{projectId}/config：更新项目配置

search

• GET /search：项目级全局搜索