sync update from LAN repo (source dhk-1 @ fc974e93)

This commit is contained in:
gozeros committed 2026-11-17 11:28:44 +08:00
1 parent a1fa13a238
commit e2fea6a801
432 files changed
+68707 -2270

No files matched your search

@@ -0,0 +1,86 @@
"""Local image storage and the controlled GoView asset URL."""
from __future__ import annotations
import re
import uuid
from pathlib import Path
from fastapi import APIRouter, UploadFile
from fastapi.responses import FileResponse
from deerflow.config.runtime_paths import runtime_home
router = APIRouter(prefix="/api/goview", tags=["goview-assets"])
MAX_IMAGE_BYTES = 10 * 1024 * 1024
_NAME_RE = re.compile(r"^[a-f0-9]{32}\.(png|jpg|gif|webp)$")
_TYPES = {"png": "image/png", "jpg": "image/jpeg", "gif": "image/gif", "webp": "image/webp"}
class AssetRejected(ValueError):
"""The upload is not a bounded local image."""
def asset_root() -> Path:
root = runtime_home() / "goview-assets"
root.mkdir(parents=True, exist_ok=True)
return root
def sniff_image(data: bytes) -> str | None:
if data.startswith(b"\x89PNG\r\n\x1a\n"):
return "png"
if data.startswith(b"\xff\xd8\xff"):
return "jpg"
if data.startswith((b"GIF87a", b"GIF89a")):
return "gif"
if len(data) >= 12 and data.startswith(b"RIFF") and data[8:12] == b"WEBP":
return "webp"
return None
def save_image_bytes(data: bytes) -> tuple[str, str]:
if len(data) > MAX_IMAGE_BYTES:
raise AssetRejected("图片超过大小限制")
kind = sniff_image(data)
if kind is None:
raise AssetRejected("只接受 PNG、JPEG、GIF 或 WEBP 图片")
name = f"{uuid.uuid4().hex}.{kind}"
if not _NAME_RE.fullmatch(name):
raise AssetRejected("文件名无效")
root = asset_root().resolve()
path = (root / name).resolve()
if not path.is_relative_to(root):
raise AssetRejected("文件名无效")
path.write_bytes(data)
return name, f"/api/goview/assets/{name}"
def resolve_asset(name: str) -> Path:
if not _NAME_RE.fullmatch(name):
raise AssetRejected("文件名无效")
root = asset_root().resolve()
path = (root / name).resolve()
if not path.is_relative_to(root) or not path.is_file():
raise AssetRejected("文件不存在")
return path
async def read_upload(upload: UploadFile) -> bytes:
filename = upload.filename or ""
if "/" in filename or "\\" in filename or ".." in filename:
raise AssetRejected("文件名无效")
return await upload.read(MAX_IMAGE_BYTES + 1)
@router.get("/assets/{name}")
async def read_goview_asset(name: str):
try:
path = resolve_asset(name)
except AssetRejected:
from app.gateway.goview_http import fail
return fail(404, "图片不存在")
media = _TYPES.get(path.suffix.lstrip("."), "application/octet-stream")
return FileResponse(path, media_type=media)
@@ -0,0 +1,55 @@
"""Controlled XYZ tiles for the offline Leaflet background."""
from __future__ import annotations
import os
import re
from pathlib import Path
from fastapi import APIRouter
from fastapi.responses import FileResponse
from app.gateway.goview_http import fail
from deerflow.config.runtime_paths import runtime_home
router = APIRouter(prefix="/api/goview/map-tiles", tags=["goview-map-tiles"])
_STYLE_RE = re.compile(r"^[a-z0-9][a-z0-9-]{0,31}$")
_MAX_ZOOM = 22
class TilePathRejected(ValueError):
"""style, zoom, or the resolved path is outside the mounted tile tree."""
def tile_root() -> Path:
override = os.environ.get("DEERFLOW_GOVIEW_TILE_ROOT", "").strip()
if override:
return Path(override).resolve()
return (runtime_home() / "goview-map-tiles").resolve()
def resolve_tile_file(style: str, z: int, x: int, y: int) -> Path:
if not _STYLE_RE.fullmatch(style) or style == "." or ".." in style:
raise TilePathRejected("底图样式无效")
if z < 0 or z > _MAX_ZOOM:
raise TilePathRejected("缩放层级无效")
max_index = (1 << z) - 1
if x < 0 or y < 0 or x > max_index or y > max_index:
raise TilePathRejected("瓦片坐标无效")
root = tile_root()
path = (root / style / str(z) / str(x) / f"{y}.png").resolve()
if not path.is_relative_to(root):
raise TilePathRejected("瓦片路径无效")
return path
@router.get("/{style}/{z}/{x}/{y}.png")
async def read_map_tile(style: str, z: int, x: int, y: int):
try:
path = resolve_tile_file(style, z, x, y)
except TilePathRejected as exc:
return fail(400, str(exc))
if not path.is_file():
return fail(404, "瓦片不存在")
return FileResponse(path, media_type="image/png")
@@ -0,0 +1,280 @@
"""GoView-compatible project APIs under ``/api/goview/project``."""
from __future__ import annotations
import json
from fastapi import APIRouter, File, Query, Request, UploadFile
from pydantic import BaseModel, ConfigDict
from starlette.formparsers import MultiPartException
from app.gateway import goview_http
from app.gateway.routers.goview_assets import AssetRejected, read_upload, save_image_bytes
from deerflow.persistence.goview import GoviewRejected
router = APIRouter(prefix="/api/goview/project", tags=["goview-projects"])
system_router = APIRouter(prefix="/api/goview/sys", tags=["goview-system"])
@system_router.get("/getOssInfo")
async def get_oss_info():
"""Return the local asset base expected by the upstream GoView editor.
Offline deployments serve uploaded assets from their own backend, so no
external OSS bucket prefix is required. Keeping this compatibility route
prevents the editor bootstrap request from failing with a 404.
"""
return goview_http.ok({"bucketURL": ""}, msg="获取成功")
class CreateBody(BaseModel):
model_config = ConfigDict(extra="ignore")
projectName: str | None = None
remarks: str | None = None
indexImage: str | None = None
class EditBody(BaseModel):
model_config = ConfigDict(extra="ignore")
id: str
projectName: str | None = None
remarks: str | None = None
indexImage: str | None = None
class RenameBody(BaseModel):
model_config = ConfigDict(extra="ignore")
id: str
projectName: str
class PublishBody(BaseModel):
model_config = ConfigDict(extra="ignore")
id: str
state: int
def _store(request: Request):
store = getattr(request.app.state, "goview_project_store", None)
if store is None:
return None
return store
def _invalid(exc: ValueError):
return goview_http.fail(422, str(exc) or "请求无效")
def _parse_content(raw: str) -> str:
if len(raw) > 8_000_000:
raise ValueError("项目内容过大")
try:
parsed = json.loads(raw)
except json.JSONDecodeError as exc:
raise ValueError("项目内容不是合法 JSON") from exc
if not isinstance(parsed, dict):
raise ValueError("项目内容必须是 JSON 对象")
return raw
@router.get("/list")
async def list_projects(request: Request, page: int = Query(default=1), limit: int = Query(default=12)):
store = _store(request)
if store is None:
return goview_http.fail(503, "项目存储未初始化")
owner = goview_http.owner_id_of(await goview_http.load_user(request))
safe_page, safe_limit = goview_http.page_window(page, limit)
rows, total = await store.list_projects(owner, page=safe_page, limit=safe_limit)
return goview_http.ok(
[goview_http.project_view(row) for row in rows],
msg="获取成功",
count=total,
)
@router.post("/create")
async def create_project(body: CreateBody, request: Request):
store = _store(request)
if store is None:
return goview_http.fail(503, "项目存储未初始化")
try:
name = goview_http.clean_text(body.projectName or "", label="项目名称", limit=255)
remarks = goview_http.clean_optional_text(body.remarks, limit=512)
image = goview_http.clean_image_ref(body.indexImage)
except ValueError as exc:
return _invalid(exc)
owner = goview_http.owner_id_of(await goview_http.load_user(request))
created = await store.create_project(project_name=name, remarks=remarks, index_image=image, owner_id=owner)
return goview_http.ok({"id": created["id"]}, msg="创建成功")
@router.get("/getData")
async def get_project_data(request: Request, projectId: str = Query(...)):
store = _store(request)
if store is None:
return goview_http.fail(503, "项目存储未初始化")
owner = goview_http.owner_id_of(await goview_http.load_user(request))
record = await store.get_owned(projectId, owner, with_content=True)
if record is None:
return goview_http.fail(404, "项目不存在")
return goview_http.ok(goview_http.project_view(record, include_content=True), msg="获取成功")
@router.post("/save/data")
async def save_project_data(request: Request):
"""Accept urlencoded or multipart ``projectId`` and ``content``.
Starlette's default form field cap is 1MB, which clips a real canvas.
"""
store = _store(request)
if store is None:
return goview_http.fail(503, "项目存储未初始化")
try:
form = await request.form(max_part_size=16 * 1024 * 1024)
except MultiPartException as exc:
return _invalid(ValueError(str(exc)))
project_id = form.get("projectId")
content = form.get("content")
if not isinstance(project_id, str) or not project_id.strip():
return goview_http.fail(422, "缺少项目 id")
if hasattr(content, "read"):
raw_bytes = await content.read()
content = raw_bytes.decode("utf-8")
if not isinstance(content, str):
return goview_http.fail(422, "项目内容不是合法 JSON")
try:
payload = _parse_content(content)
except ValueError as exc:
return _invalid(exc)
owner = goview_http.owner_id_of(await goview_http.load_user(request))
try:
saved = await store.save_content(project_id, owner, payload)
except GoviewRejected as exc:
return _invalid(exc)
if saved is None:
return goview_http.fail(404, "项目不存在")
return goview_http.ok({"id": project_id}, msg="保存成功")
@router.post("/edit")
async def edit_project(body: EditBody, request: Request):
store = _store(request)
if store is None:
return goview_http.fail(503, "项目存储未初始化")
fields: set[str] = set()
name = None
remarks = None
image = None
try:
if "projectName" in body.model_fields_set:
name = goview_http.clean_text(body.projectName or "", label="项目名称", limit=255)
fields.add("project_name")
if "remarks" in body.model_fields_set:
remarks = goview_http.clean_optional_text(body.remarks, limit=512)
fields.add("remarks")
if "indexImage" in body.model_fields_set:
image = goview_http.clean_image_ref(body.indexImage)
fields.add("index_image")
except ValueError as exc:
return _invalid(exc)
owner = goview_http.owner_id_of(await goview_http.load_user(request))
updated = await store.update_meta(
body.id,
owner,
project_name=name,
remarks=remarks,
index_image=image,
fields=fields,
)
if updated is None:
return goview_http.fail(404, "项目不存在")
return goview_http.ok(goview_http.project_view(updated), msg="保存成功")
@router.post("/rename")
async def rename_project(body: RenameBody, request: Request):
store = _store(request)
if store is None:
return goview_http.fail(503, "项目存储未初始化")
try:
name = goview_http.clean_text(body.projectName, label="项目名称", limit=255)
except ValueError as exc:
return _invalid(exc)
owner = goview_http.owner_id_of(await goview_http.load_user(request))
updated = await store.update_meta(body.id, owner, project_name=name, fields={"project_name"})
if updated is None:
return goview_http.fail(404, "项目不存在")
return goview_http.ok(goview_http.project_view(updated), msg="保存成功")
@router.delete("/delete")
async def delete_projects(request: Request, ids: str = Query(...)):
store = _store(request)
if store is None:
return goview_http.fail(503, "项目存储未初始化")
owner = goview_http.owner_id_of(await goview_http.load_user(request))
deleted = 0
protected = False
for project_id in [item.strip() for item in ids.split(",") if item.strip()][:50]:
if project_id.startswith("demo-material-"):
protected = True
continue
if await store.delete_owned(project_id, owner):
deleted += 1
if deleted == 0 and protected:
return goview_http.fail(403, "演示项目不能删除")
if deleted == 0:
return goview_http.fail(404, "项目不存在")
return goview_http.ok({"deleted": deleted}, msg="删除成功")
@router.put("/publish")
async def publish_project(body: PublishBody, request: Request):
store = _store(request)
if store is None:
return goview_http.fail(503, "项目存储未初始化")
owner = goview_http.owner_id_of(await goview_http.load_user(request))
try:
updated = await store.set_state(body.id, owner, body.state)
except GoviewRejected as exc:
return _invalid(exc)
if updated is None:
return goview_http.fail(404, "项目不存在")
return goview_http.ok(
{
"id": updated["id"],
"state": updated["state"],
"relative_view_url": f"/#/chart/preview/{updated['id']}",
},
msg="操作成功",
)
@router.post("/upload")
async def upload_project_image(request: Request, object: UploadFile = File(...)): # noqa: A002
if _store(request) is None:
return goview_http.fail(503, "项目存储未初始化")
await goview_http.load_user(request)
try:
data = await read_upload(object)
file_name, file_url = save_image_bytes(data)
except AssetRejected as exc:
return _invalid(exc)
return goview_http.ok({"fileName": file_name, "fileurl": file_url}, msg="上传成功")
@router.get("/published/{project_id}")
async def read_published_project(project_id: str, request: Request):
store = _store(request)
if store is None:
return goview_http.fail(503, "项目存储未初始化")
record = await store.get_published(project_id)
if record is None:
return goview_http.fail(404, "项目未发布或不存在")
return goview_http.ok(goview_http.project_view(record, include_content=True), msg="获取成功")
@@ -0,0 +1,229 @@
"""Personal templates and the builtin template market."""
from __future__ import annotations
from fastapi import APIRouter, Query, Request
from pydantic import BaseModel, ConfigDict
from app.gateway import goview_http
from app.gateway.goview_builtin_templates import ensure_builtin_templates
from app.gateway.goview_demo_projects import COVER_URL
from deerflow.persistence.goview import GoviewRejected
from deerflow.persistence.goview.template_store import MARKET, PERSONAL
router = APIRouter(prefix="/api/goview/templates", tags=["goview-templates"])
class FromProjectBody(BaseModel):
model_config = ConfigDict(extra="ignore")
projectId: str
name: str | None = None
description: str | None = None
coverImage: str | None = None
class TemplateEditBody(BaseModel):
model_config = ConfigDict(extra="ignore")
name: str | None = None
description: str | None = None
coverImage: str | None = None
class CreateProjectBody(BaseModel):
model_config = ConfigDict(extra="ignore")
projectName: str | None = None
remarks: str | None = None
def _templates(request: Request):
return getattr(request.app.state, "goview_template_store", None)
def _projects(request: Request):
return getattr(request.app.state, "goview_project_store", None)
def _invalid(exc: ValueError):
return goview_http.fail(422, str(exc) or "请求无效")
def _can_read(record: dict, owner: str) -> bool:
if record["scope"] == MARKET:
return True
return record.get("owner_id") == owner and record["scope"] == PERSONAL
@router.get("/mine")
async def list_my_templates(request: Request, page: int = Query(default=1), limit: int = Query(default=12)):
store = _templates(request)
if store is None:
return goview_http.fail(503, "模板存储未初始化")
owner = goview_http.owner_id_of(await goview_http.load_user(request))
safe_page, safe_limit = goview_http.page_window(page, limit)
rows, total = await store.list_personal(owner, page=safe_page, limit=safe_limit)
return goview_http.ok([goview_http.template_view(row) for row in rows], msg="获取成功", count=total)
@router.get("/market")
async def list_market_templates(request: Request, page: int = Query(default=1), limit: int = Query(default=12)):
store = _templates(request)
if store is None:
return goview_http.fail(503, "模板存储未初始化")
await goview_http.load_user(request)
safe_page, safe_limit = goview_http.page_window(page, limit)
rows, total = await store.list_market(page=safe_page, limit=safe_limit)
return goview_http.ok([goview_http.template_view(row) for row in rows], msg="获取成功", count=total)
@router.post("/from-project")
async def create_template_from_project(body: FromProjectBody, request: Request):
templates = _templates(request)
projects = _projects(request)
if templates is None or projects is None:
return goview_http.fail(503, "模板存储未初始化")
owner = goview_http.owner_id_of(await goview_http.load_user(request))
project = await projects.get_owned(body.projectId, owner, with_content=True)
if project is None:
return goview_http.fail(404, "项目不存在")
try:
name = goview_http.clean_text(body.name or project["project_name"], label="模板名称", limit=255)
description = goview_http.clean_optional_text(body.description if body.description is not None else project.get("remarks"), limit=512)
cover = goview_http.clean_image_ref(body.coverImage if body.coverImage is not None else project.get("index_image"))
content = goview_http.retitle_canvas(project.get("content") or "{}", name)
except ValueError as exc:
return _invalid(exc)
try:
created = await templates.create_personal(
name=name,
description=description,
cover_image=cover,
content=content,
owner_id=owner,
)
except GoviewRejected as exc:
return _invalid(exc)
return goview_http.ok(goview_http.template_view(created), msg="创建成功")
@router.post("/admin/seed")
async def seed_builtin_templates(request: Request):
store = _templates(request)
if store is None:
return goview_http.fail(503, "模板存储未初始化")
user = await goview_http.load_user(request)
if not goview_http.user_is_admin(user):
return goview_http.fail(403, "仅管理员可维护市场模板")
inserted = await ensure_builtin_templates(store)
return goview_http.ok({"inserted": inserted}, msg="操作成功")
@router.get("/{template_id}")
async def get_template(template_id: str, request: Request):
store = _templates(request)
if store is None:
return goview_http.fail(503, "模板存储未初始化")
owner = goview_http.owner_id_of(await goview_http.load_user(request))
record = await store.get(template_id)
if record is None or not _can_read(record, owner):
return goview_http.fail(404, "模板不存在")
return goview_http.ok(goview_http.template_view(record, include_content=True), msg="获取成功")
@router.put("/{template_id}")
async def edit_template(template_id: str, body: TemplateEditBody, request: Request):
store = _templates(request)
if store is None:
return goview_http.fail(503, "模板存储未初始化")
user = await goview_http.load_user(request)
owner = goview_http.owner_id_of(user)
record = await store.get(template_id)
if record is None:
return goview_http.fail(404, "模板不存在")
if record["scope"] == MARKET:
if not goview_http.user_is_admin(user):
return goview_http.fail(403, "市场模板不能直接编辑")
elif record.get("owner_id") != owner:
return goview_http.fail(404, "模板不存在")
fields: set[str] = set()
name = None
description = None
cover = None
try:
if "name" in body.model_fields_set:
name = goview_http.clean_text(body.name or "", label="模板名称", limit=255)
fields.add("name")
if "description" in body.model_fields_set:
description = goview_http.clean_optional_text(body.description, limit=512)
fields.add("description")
if "coverImage" in body.model_fields_set:
cover = goview_http.clean_image_ref(body.coverImage)
fields.add("cover_image")
except ValueError as exc:
return _invalid(exc)
updated = await store.update_meta(
template_id,
name=name,
description=description,
cover_image=cover,
fields=fields,
)
if updated is None:
return goview_http.fail(404, "模板不存在")
return goview_http.ok(goview_http.template_view(updated), msg="保存成功")
@router.delete("/{template_id}")
async def delete_template(template_id: str, request: Request):
store = _templates(request)
if store is None:
return goview_http.fail(503, "模板存储未初始化")
user = await goview_http.load_user(request)
owner = goview_http.owner_id_of(user)
record = await store.get(template_id)
if record is None:
return goview_http.fail(404, "模板不存在")
if record.get("is_builtin"):
return goview_http.fail(403, "内置模板不可删除")
if record["scope"] == MARKET:
if not goview_http.user_is_admin(user):
return goview_http.fail(403, "市场模板不能直接编辑")
elif record.get("owner_id") != owner:
return goview_http.fail(404, "模板不存在")
await store.delete(template_id)
return goview_http.ok({"id": template_id}, msg="删除成功")
@router.post("/{template_id}/create-project")
async def create_project_from_template(template_id: str, request: Request, body: CreateProjectBody | None = None):
templates = _templates(request)
projects = _projects(request)
if templates is None or projects is None:
return goview_http.fail(503, "模板存储未初始化")
owner = goview_http.owner_id_of(await goview_http.load_user(request))
record = await templates.get(template_id)
if record is None or not _can_read(record, owner):
return goview_http.fail(404, "模板不存在")
requested = body.projectName if body is not None and body.projectName else record["name"]
remarks = body.remarks if body is not None else record.get("description")
try:
name = goview_http.clean_text(requested, label="项目名称", limit=255)
remarks = goview_http.clean_optional_text(remarks, limit=512)
content = goview_http.retitle_canvas(record.get("content") or "{}", name)
except ValueError as exc:
return _invalid(exc)
try:
created = await projects.create_project(
project_name=name,
remarks=remarks,
# Let the project gallery show the template's real dashboard
# preview before the first canvas save generates its own thumbnail.
index_image=record.get("cover_image") or COVER_URL,
owner_id=owner,
content=content,
)
except GoviewRejected as exc:
return _invalid(exc)
return goview_http.ok({"id": created["id"]}, msg="创建成功")
@@ -74,6 +74,21 @@ class CustomModuleListUpdateRequest(BaseModel):
modules: list[dict[str, Any]] = Field(..., description="自定义模块全量列表(整体替换)")
class PagesUpdateRequest(BaseModel):
pages: list[dict[str, Any]] = Field(..., description="页面清单(编号集合不可增删;可改名称/隐藏)")
class FieldAddRequest(BaseModel):
label: str = Field(..., min_length=1, description="字段显示名(同名拒绝)")
branch: str = Field(..., description="所属数据分支(分类对应的 DATA 顶层键)")
description: str = Field(default="", description="字段说明(可选)")
default_value: str = Field(default="待补充", description="写入各条目的初始值")
class FieldRemoveRequest(BaseModel):
label: str = Field(..., min_length=1, description="要删除的自定义字段显示名")
class CustomModuleGenerateRequest(BaseModel):
page: str = Field(..., description="挂载的页面编号(manifest.页面 的 编号)")
title: str = Field(default="", description="模块标题(留空由模型起名)")
@@ -195,11 +210,16 @@ async def get_html_template_fields(template_id: str, request: Request) -> dict[s
# 是否接受定时任务抽取数据更新(默认 True);布局分区无独立数据键,恒为 True 且前端禁用开关。
"extract": locks.get(str(f.get("label"))) is not True,
"has_key": bool(f.get("keys")),
"custom": bool(f.get("custom")),
}
for f in catalog
]
pages = [
{"key": str(p.get("编号") or ""), "label": str(p.get("名称") or p.get("编号") or "")}
{
"key": str(p.get("编号") or ""),
"label": str(p.get("名称") or p.get("编号") or ""),
"hidden": p.get("隐藏") is True,
}
for p in manifest.get("页面") or []
if isinstance(p, dict)
]
@@ -231,6 +251,57 @@ async def update_html_template_fields(
return meta
@router.post("/{template_id}/fields/add")
async def add_html_template_field(
template_id: str, body: FieldAddRequest, request: Request
) -> dict[str, Any]:
"""向分类(数据分支)添加自定义字段:fields.json 目录 + data.json 各条目同步补键(仅管理员)。"""
await _require_admin(request)
try:
meta = template_store.add_template_field(
template_id,
label=body.label,
branch=body.branch,
description=body.description,
default_value=body.default_value,
)
except template_store.TemplateStoreError as exc:
status = 404 if "不存在" in str(exc) else 400
raise HTTPException(status_code=status, detail=str(exc))
await invalidate_catalog(request, "html_templates")
return meta
@router.post("/{template_id}/fields/remove")
async def remove_html_template_field(
template_id: str, body: FieldRemoveRequest, request: Request
) -> dict[str, Any]:
"""删除自定义字段:目录项与 data.json 各条目的键一并移除(仅管理员;内置字段拒绝)。"""
await _require_admin(request)
try:
meta = template_store.remove_template_field(template_id, body.label)
except template_store.TemplateStoreError as exc:
status = 404 if "不存在" in str(exc) else 400
raise HTTPException(status_code=status, detail=str(exc))
await invalidate_catalog(request, "html_templates")
return meta
@router.put("/{template_id}/pages")
async def update_html_template_pages(
template_id: str, body: PagesUpdateRequest, request: Request
) -> dict[str, Any]:
"""更新页面清单(名称/隐藏标记;编号集合不可增删;仅管理员)。隐藏页面在产物导航整体下线。"""
await _require_admin(request)
try:
meta = template_store.write_template_pages(template_id, body.pages)
except template_store.TemplateStoreError as exc:
status = 404 if "不存在" in str(exc) else 400
raise HTTPException(status_code=status, detail=str(exc))
await invalidate_catalog(request, "html_templates")
return meta
@router.put("/{template_id}/custom-modules")
async def update_html_template_custom_modules(
template_id: str, body: CustomModuleListUpdateRequest, request: Request
@@ -77,7 +77,11 @@ from app.gateway.wiki_generation_config import (
from deerflow.assistant_knowledge.package_io import looks_like_knowledge_package
from deerflow.config.agents_config import load_agent_config
from deerflow.config.llmwiki_config import LlmWikiRuntimeOverride, normalize_service_url
from deerflow.config.system_settings import load_system_settings, save_system_settings
from deerflow.config.system_settings import (
LocalWikiAutoSyncSettings,
load_system_settings,
save_system_settings,
)
from deerflow.integrations.weknora.client import WeKnoraClient, WeKnoraError
from deerflow.integrations.weknora.knowledge_profile import (
DEFAULT_RETRIEVAL_SETTINGS,
@@ -252,6 +256,12 @@ class LlmWikiConnectionTest(BaseModel):
api_base_url: str | None = None
class LocalWikiAutoSyncSettingsUpdate(BaseModel):
enabled: bool
schedule: Literal["hourly", "daily"] = "hourly"
hour: int = Field(default=2, ge=0, le=23)
class WikiGenerationInstructions(BaseModel):
"""User-owned guidance for WeKnora's stable Wiki ingest prompts."""
@@ -3097,6 +3107,41 @@ async def get_llmwiki_settings(request: Request) -> dict[str, Any]:
}
@router.get(
"/api/system-settings/llmwiki/auto-sync",
response_model=LocalWikiAutoSyncSettings,
)
async def get_local_wiki_auto_sync_settings(
request: Request,
) -> LocalWikiAutoSyncSettings:
await _require_admin(request)
return load_system_settings().local_wiki_auto_sync
@router.put(
"/api/system-settings/llmwiki/auto-sync",
response_model=LocalWikiAutoSyncSettings,
)
async def update_local_wiki_auto_sync_settings(
request: Request,
body: LocalWikiAutoSyncSettingsUpdate,
) -> LocalWikiAutoSyncSettings:
await _require_admin(request)
updated = LocalWikiAutoSyncSettings(
enabled=body.enabled,
schedule=body.schedule,
hour=body.hour,
)
current = load_system_settings()
saved = save_system_settings(
current.model_copy(update={"local_wiki_auto_sync": updated})
)
from app.gateway.llmwiki_index_runtime import rebuild_local_wiki_index_runtime
await rebuild_local_wiki_index_runtime(request.app, force=True)
return saved.local_wiki_auto_sync
@router.put("/api/system-settings/llmwiki")
async def update_llmwiki_settings(request: Request, body: LlmWikiSettingsUpdate) -> dict[str, Any]:
await _require_admin(request)
@@ -1413,6 +1413,8 @@ class AppearanceResponse(BaseModel):
default_theme: str = Field(..., description="System default theme — built-in id or enabled custom-theme-* id")
default_skill_view: Literal["card", "list"] = Field(..., description="System default skill list display mode — card or list")
default_agent_view: Literal["card", "list"] = Field(..., description="System default agent list display mode — card or list")
default_agent_grid_adaptive: bool = Field(default=True, description="System default agent-card grid strategy — adaptive width-based columns (true) or fixed count (false)")
default_agent_grid_columns: int = Field(default=4, description="System default fixed column count for the agent-card grid (1-8)")
default_layout_mode: Literal["full", "compact"] = Field(..., description="System default interface layout — full (sidebar + header) or compact (hidden)")
default_composer_width_full: int = Field(..., description="System default composer width percent for full layout. 100 keeps the built-in width.")
default_composer_width_compact: int = Field(..., description="System default composer width percent for compact layout. 100 keeps the built-in width.")
@@ -1428,6 +1430,8 @@ class AppearanceUpdateRequest(BaseModel):
default_theme: str | None = Field(default=None)
default_skill_view: Literal["card", "list"] | None = Field(default=None)
default_agent_view: Literal["card", "list"] | None = Field(default=None)
default_agent_grid_adaptive: bool | None = Field(default=None)
default_agent_grid_columns: int | None = Field(default=None)
default_layout_mode: Literal["full", "compact"] | None = Field(default=None)
default_composer_width_full: int | None = Field(default=None)
default_composer_width_compact: int | None = Field(default=None)
@@ -1507,6 +1511,8 @@ def _appearance_response(appearance) -> AppearanceResponse:
default_theme=appearance.default_theme,
default_skill_view=appearance.default_skill_view,
default_agent_view=appearance.default_agent_view,
default_agent_grid_adaptive=appearance.default_agent_grid_adaptive,
default_agent_grid_columns=appearance.default_agent_grid_columns,
default_layout_mode=appearance.default_layout_mode,
default_composer_width_full=appearance.default_composer_width_full,
default_composer_width_compact=appearance.default_composer_width_compact,
@@ -1575,6 +1581,8 @@ async def update_appearance_settings(body: AppearanceUpdateRequest, request: Req
for key in (
"default_skill_view",
"default_agent_view",
"default_agent_grid_adaptive",
"default_agent_grid_columns",
"default_layout_mode",
"default_composer_width_full",
"default_composer_width_compact",