sync: 鍚屾灞€鍩熺綉鏈€鏂颁唬鐮?(source master @ b69568e4)
This commit is contained in:
1 parent
4f7f07504a
commit
8bc8b0e082
1651 files changed
+278599
-11416
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",
|
||||
]
|
||||
Reference in new issue
Block a user