应用平台 FE-6 搭建面:应用编辑器(固定版本、派生、页面树与属性面板、预览、检查、发布时选处置、岗位与授权、钩子、通知、助手面板),人工节点新字段与写入动作说明,发布弹窗与版本页的退役和使用情况,记录页的来源、待办与动作事件、生效记录,发起表单换成表单渲染器并带来源,问数据「做成应用」,look 的界面与 meta.looks,工具页的能力与端点,设置页的身份、通知、审计;检查脚本的更新与新增(含统一复核后的修复)

This commit is contained in:
ThearchyHelios
2026-10-14 20:05:23 +08:00
parent 22021e76c3
commit e341beb1cb
49 changed files with 5918 additions and 694 deletions
+91
View File
@@ -0,0 +1,91 @@
/**
* 应用润色的助手(POST /api/copilot/app-stream,SSE):应用编辑器右侧的助手面板用它。
*
* 和 streamCopilot(画布生成)同一种帧:一帧一行 `data: <JSON>`,空行分隔。操作有三类(§3.11):
* - 应用操作:app_add / app_update / app_remove / app_move / app_page / app_set,形状同服务端 app/apps/ops.py,
* 编辑器按到达顺序落到草稿上(pages/apps/edit/appOps.ts 的 applyAppOp);
* - look(查看了哪些工作流版本、能力)、ask(问回来一句,这一轮到此结束)、thinking、heartbeat、check、reply、error;
* - final:{spec, issues, explanation},服务端落地后的整份 spec(以它为准,替换前面边收边改的草稿)。
*
* 系统先代为查看固定的版本(look 的 by=system),模型可以再查看;岗位绑定只能由人做,助手只留空并提示。
* 请求函数从 ./http 导入,不要从 ./client 导入(循环导入,见 http.ts 开头)。
*/
import type { AppBindings, AppSpec } from '../typesApp'
import { ApiError, BASE, NETWORK_MESSAGE, actorHeader, codeOf, describeDetail, isGatewayFailure, parseBody, report } from './http'
/** 请求体同服务端 api/copilot.AppStreamIn */
export interface AppCopilotRequest {
app_id: string
instruction: string
/** 编辑器里此刻的草稿(可能还没保存):助手在它上面改 */
spec: AppSpec
/** 草稿里的岗位绑定(不进 spec):服务端的应用检查按它判断岗位绑没绑 */
bindings?: AppBindings
/** 应用编辑时的助手对话(conversations.app_id 归属这个应用),带上它这一轮才接得上前面聊过的 */
conversation_id?: string | null
model?: string | null
}
/** 返回取消函数。开流之前就被拒(4xx/5xx)时 onEnd 带服务端那句话、状态码和机读码 */
export function streamAppCopilot(
body: AppCopilotRequest,
onOp: (op: any) => void,
onEnd: (error?: string, info?: { status?: number; code?: string }) => void,
): () => void {
const controller = new AbortController()
const path = '/copilot/app-stream'
void (async () => {
try {
const res = await fetch(`${BASE}${path}`, {
method: 'POST',
headers: { 'Content-Type': 'application/json', Accept: 'text/event-stream', ...actorHeader() },
body: JSON.stringify(body),
signal: controller.signal,
})
if (!res.ok || !res.body) {
const text = await res.text().catch(() => '')
let parsed: any
let isJson = false
try { parsed = JSON.parse(text); isJson = true } catch { /* 响应体不是 JSON */ }
if (isGatewayFailure(res.status, text, isJson)) {
report(false, new ApiError(res.status, NETWORK_MESSAGE, { kind: 'network' }))
onEnd(NETWORK_MESSAGE)
return
}
report(true)
onEnd(isJson ? describeDetail(parsed?.detail ?? parsed, path)
: res.status >= 500 ? `服务端错误(${res.status}),详情请查看服务日志`
: `请求失败(HTTP ${res.status})`, { status: res.status, code: isJson ? codeOf(parsed) : undefined })
return
}
report(true)
const reader = res.body.getReader()
const decoder = new TextDecoder()
let buffer = ''
for (;;) {
const { done, value } = await reader.read()
if (done) break
buffer += decoder.decode(value, { stream: true })
let idx: number
while ((idx = buffer.indexOf('\n\n')) >= 0) {
const frame = buffer.slice(0, idx)
buffer = buffer.slice(idx + 2)
if (!frame.startsWith('data: ')) continue
try {
onOp(parseBody(frame.slice(6)))
} catch { /* 半截帧,忽略 */ }
}
}
onEnd()
} catch (e: any) {
if (e?.name === 'AbortError') { onEnd(); return }
if (e instanceof TypeError) {
report(false, new ApiError(0, NETWORK_MESSAGE, { kind: 'network', raw: String(e) }))
onEnd(NETWORK_MESSAGE)
return
}
onEnd(e?.message ?? '连接中断,请重试')
}
})()
return () => controller.abort()
}
+11 -2
View File
@@ -232,6 +232,10 @@ export const api = {
/** 某个版本的完整快照(含 graph)。正式运行的输入字段要从已发布版本取,不能取画布 */
version: (id: string, v: number) => get<WorkflowVersion>(`/workflows/${id}/versions/${v}`),
restore: (id: string, v: number) => post<Workflow>(`/workflows/${id}/versions/${v}/restore`),
/** 退役一个已发布的版本(A1):当前发布版 409;返回受影响的应用。只有管理员(关登录时所有人) */
retire: (id: string, v: number, note?: string) =>
post<{ retired: boolean; affected_apps: { app_id: string; name: string; app_version: number }[] }>(
`/workflows/${id}/versions/${v}/retire`, { note: note ?? null }),
publish: (id: string, level: 'published' | 'governed', version?: number) =>
post<{ ok: boolean; level?: string; version?: number; issues: any[] }>(
`/workflows/${id}/publish`, { level, version }),
@@ -513,6 +517,8 @@ export const api = {
list: (params?: {
workflow_id?: string; status?: RunStatus | RunStatus[] | string; run_class?: 'formal' | 'exploratory'
q?: string; limit?: number; before?: string
/** 按运行来源筛(X3);none 是来源未记录的老运行 */
origin_kind?: string
}) => get<Run[]>(`/runs${qs(params)}`),
get: (id: string) => get<Run>(`/runs/${id}`),
/** 这次运行实际跑的那张图(运行时的快照),不是工作流现在的样子 */
@@ -522,6 +528,8 @@ export const api = {
workflow_id?: string; graph?: GraphSpec; input?: Record<string, any>
memory_scope?: string; collection?: string
run_class?: 'formal' | 'exploratory'; version?: number
/** 运行来源(X3):客户端只能声明 chat、canvas、launcher、api(不传按 api 记),其余由服务端写 */
origin?: 'chat' | 'canvas' | 'launcher' | 'api'
}) => post<Run>('/runs', body),
artifacts: (id: string) => get<any[]>(`/runs/${id}/artifacts`),
/** 从失败的节点接着跑。graph 只能带改过配置的同一张图,结构必须一致 */
@@ -813,8 +821,9 @@ export const api = {
}>('/copilot/generate', body),
explain: (graph: GraphSpec) => post<{ explanation: string }>('/copilot/explain', { graph }),
layout: (graph: GraphSpec) => post<GraphSpec>('/copilot/layout', { graph }),
fromRun: (runId: string, name?: string) =>
post<any>('/copilot/from-run', { run_id: runId, name }),
/** from:问数据回答上点「做成应用」时带上这次运行出自哪段对话的哪一轮,记进新工作流的来源 */
fromRun: (runId: string, name?: string, from?: { conversation_id?: string | null; turn_id?: string | null }) =>
post<any>('/copilot/from-run', { run_id: runId, name, ...(from ?? {}) }),
getModel: () => get<CopilotModel>('/copilot/model'),
setModel: (body: { provider?: string | null; model?: string | null }) =>
put<CopilotModel>('/copilot/model', body),