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

This commit is contained in:
gozeros committed 2026-10-21 15:06:08 +08:00
1 parent ab6068a7c1
commit 42f2a26fa8
1482 files changed
+227759 -9584

No files matched your search

@@ -0,0 +1,157 @@
"""Seed the built-in public-document agent, orchestration skill and engine.
三组种子资产(全部随仓库跟踪,启动时按版本同步到运行目录):
- ``_gongwen_seed_assets/gongwen-document-assistant/{config.yaml, SOUL.md}`` →
``{DEER_FLOW_HOME}/agents/gongwen-document-assistant/``(目录内其他运行时
文件不动)。
- ``_gongwen_seed_assets/skills/gongwen-workflow/``(对话编排技能)→
``skills/public/gongwen-workflow/``。
- ``_gongwen_seed_assets/skills/gongwen-assistant/``(完整 DOCX 引擎技能,
含 vendored python-docx 1.2.0)→ ``skills/public/gongwen-assistant/``。
运行时 ``skills/`` 树被 .gitignore 排除,全新部署由本 seeder 落盘,
沙箱内即 ``/mnt/skills/public/gongwen-assistant``(SKILL.md 的默认路径)。
同步语义(版本感知,区别于 agentfx 的「存在即跳过」):每个落盘副本携带
``.gongwen-seed-version``,低于 ``_SEED_VERSION`` 时整体原子替换(先拷到
同级临时目录再换名),等于或高于时跳过以尊重现场修改。要发布对种子内容
的修改:改资产 + bump ``_SEED_VERSION``,已有部署下次启动自动刷新。
技能解析顺序为 public → custom 且按名去重(后者胜出),现场在
``skills/custom/`` 放同名技能可整体覆盖内置版。
必须在 ``_sync_legacy_agents`` 之前调用。
"""
from __future__ import annotations
import logging
import shutil
from pathlib import Path
from deerflow.config.paths import get_paths
logger = logging.getLogger(__name__)
GONGWEN_AGENT_ID = "gongwen-document-assistant"
GONGWEN_WORKFLOW_SKILL = "gongwen-workflow"
GONGWEN_ENGINE_SKILL = "gongwen-assistant"
_ASSETS_DIR = Path(__file__).parent / "_gongwen_seed_assets"
_SEED_FILES: tuple[str, ...] = ("config.yaml", "SOUL.md")
# Bump when tracked seed assets change and existing deployments must pick the
# change up on the next gateway start. Deployed copies at the same version
# are left untouched so on-site edits survive restarts.
_SEED_VERSION = 3
_VERSION_FILE = ".gongwen-seed-version"
_IGNORE_PATTERNS = ("__pycache__", "*.pyc", ".pytest_cache")
def _skills_public_dir() -> Path:
from deerflow.skills.storage import get_or_new_skill_storage
return Path(get_or_new_skill_storage().get_skills_root_path()) / "public"
def _deployed_version(directory: Path) -> int:
try:
return int((directory / _VERSION_FILE).read_text(encoding="utf-8").strip() or 0)
except (OSError, ValueError):
return 0
def _copy_seed_tree(source: Path, destination: Path, label: str) -> bool:
"""Copy a seed tree when missing or older than the shipped seed version.
The copy is staged in a sibling temp directory and swapped in with one
rename so an interrupted boot never leaves a half-written skill behind.
"""
if destination.exists() and _deployed_version(destination) >= _SEED_VERSION:
return False
destination.parent.mkdir(parents=True, exist_ok=True)
staging = destination.with_name(f".{destination.name}.seed-staging")
if staging.exists():
shutil.rmtree(staging)
shutil.copytree(source, staging, ignore=shutil.ignore_patterns(*_IGNORE_PATTERNS))
(staging / _VERSION_FILE).write_text(f"{_SEED_VERSION}\n", encoding="utf-8")
if destination.exists():
logger.warning(
"Refreshing built-in %s '%s' to seed v%s (any local edits are replaced)",
label,
destination.name,
_SEED_VERSION,
)
shutil.rmtree(destination)
staging.rename(destination)
logger.info("Seeded built-in %s '%s' (v%s)", label, destination.name, _SEED_VERSION)
return True
def _seed_agent() -> bool:
"""Create or refresh the built-in agent files, never touching others."""
agent_dir = get_paths().agent_dir(GONGWEN_AGENT_ID)
if agent_dir.exists() and _deployed_version(agent_dir) >= _SEED_VERSION:
return False
source = _ASSETS_DIR / GONGWEN_AGENT_ID
if not source.is_dir():
logger.error("Missing public-document agent seed assets at %s", source)
return False
agent_dir.mkdir(parents=True, exist_ok=True)
for filename in _SEED_FILES:
asset = source / filename
if asset.is_file():
(agent_dir / filename).write_bytes(asset.read_bytes())
(agent_dir / _VERSION_FILE).write_text(f"{_SEED_VERSION}\n", encoding="utf-8")
return True
def _seed_workflow_skill() -> bool:
source = _ASSETS_DIR / "skills" / GONGWEN_WORKFLOW_SKILL
if not (source / "SKILL.md").is_file():
logger.error("Missing public-document workflow skill seed asset at %s", source)
return False
return _copy_seed_tree(
source, _skills_public_dir() / GONGWEN_WORKFLOW_SKILL, "public-document workflow skill"
)
def _seed_engine_skill() -> bool:
source = _ASSETS_DIR / "skills" / GONGWEN_ENGINE_SKILL
if not (source / "SKILL.md").is_file() or not (source / "scripts" / "run_gongwen.py").is_file():
logger.error("Missing public-document engine skill seed asset at %s", source)
return False
return _copy_seed_tree(
source, _skills_public_dir() / GONGWEN_ENGINE_SKILL, "public-document engine skill"
)
def ensure_gongwen_agent() -> bool:
"""Sync built-in public-document assets (version-aware, non-fatal).
Returns True if the agent directory was created or refreshed to a newer
seed version.
"""
created_agent = False
try:
created_agent = _seed_agent()
if created_agent:
logger.info("Seeded built-in public-document agent '%s'", GONGWEN_AGENT_ID)
except Exception:
logger.exception("Failed to seed built-in public-document agent")
for seeder, label in (
(_seed_workflow_skill, "workflow skill"),
(_seed_engine_skill, "engine skill"),
):
try:
if seeder():
logger.info("Seeded built-in public-document %s", label)
except Exception:
logger.exception("Failed to seed built-in public-document %s", label)
return created_agent
__all__ = [
"GONGWEN_AGENT_ID",
"GONGWEN_WORKFLOW_SKILL",
"GONGWEN_ENGINE_SKILL",
"ensure_gongwen_agent",
]