sycommon-python-lib 0.2.7a5__tar.gz → 0.2.7a6__tar.gz

{sycommon_python_lib-0.2.7a5 → sycommon_python_lib-0.2.7a6}/PKG-INFO

@@ -1,13 +1,13 @@
 Metadata-Version: 2.4
 Name: sycommon-python-lib
-Version: 0.2.7a5
+Version: 0.2.7a6
 Summary: Add your description here
 Requires-Python: >=3.11
 Description-Content-Type: text/markdown
 Requires-Dist: aio-pika==9.6.2
 Requires-Dist: aiohttp==3.14.1
 Requires-Dist: aiomysql==0.3.2
-Requires-Dist: anyio==4.14.0
+Requires-Dist: anyio==4.14.1
 Requires-Dist: decorator==5.3.1
 Requires-Dist: deepagents==0.6.11
 Requires-Dist: elasticsearch==9.4.1

{sycommon_python_lib-0.2.7a5 → sycommon_python_lib-0.2.7a6}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "sycommon-python-lib"
-version = "0.2.7a5"
+version = "0.2.7a6"
 description = "Add your description here"
 readme = "README.md"
 requires-python = ">=3.11"
@@ -8,7 +8,7 @@ dependencies = [
     "aio-pika==9.6.2",
     "aiohttp==3.14.1",
     "aiomysql==0.3.2",
-    "anyio==4.14.0",
+    "anyio==4.14.1",
     "decorator==5.3.1",
     "deepagents==0.6.11",
     "elasticsearch==9.4.1",

{sycommon_python_lib-0.2.7a5 → sycommon_python_lib-0.2.7a6}/src/sycommon/agent/middleware/skill_api_whitelist.py

@@ -2,11 +2,11 @@
 
 拦截 `execute` 工具（FilesystemMiddleware 注册的 shell 执行工具），做两件事：
 
-1. 从命令路径推断子技能名（skills/<域>/<子技能>/scripts/ → <子技能>），
-   查 SkillApiWhitelist 配置得到该子技能的白名单，把占位符 ${VAR} 在主进程
+1. 从命令路径推断顶级技能名（skills/<顶级技能>/ → <顶级技能>，如 sy-oa-skill），
+   查 SkillApiWhitelist 配置得到该顶级技能的白名单，把占位符 ${VAR} 在主进程
    解析成完整 URL，序列化成 JSON 后以 `export SKILL_API_WHITELIST='<json>'`
    前缀注入命令——供沙箱内 sitecustomize.py 读取并 monkeypatch urllib/
-   httpx/requests/aiohttp。
+   httpx/requests/aiohttp。每个顶级技能的 allowlist 是其下所有子技能出网地址的并集。
 
 2. 命令前缀内联 curl/wget 的 shell 函数包装：纯 shell 命令（不走 Python）
    不会触发 sitecustomize，故用 shell 函数在执行 curl/wget 前调
@@ -33,10 +33,12 @@ from sycommon.logging.kafka_log import SYLogger
 # 命令路径形如  skills/sy-oa-skill/workflow-todo/scripts/x.py
 #               skills/sy-syt-skill/shengye-platform-zhongdeng/SKILL.md
 #               skills/sy-syt-skill/generate-plan/...     （有/无 scripts/ 都识别）
-# 取「skills/<域>/<子技能>/」的第二段作子技能名，不限 scripts/，覆盖文档目录型子技能。
-# 用 (?:/|$) 锚定第二段结尾，避免误吞后续路径段。
-_SKILL_NESTED_RE = re.compile(r'skills/[A-Za-z0-9_\-]+/([A-Za-z0-9_\-]+)(?:/|$)')
-_SKILL_FLAT_RE = re.compile(r'/skills/([A-Za-z0-9_\-]+)(?:/|$)')
+# 取「skills/<顶级技能>/」的【第一段】作顶级技能名（如 sy-oa-skill），
+# 配合 SkillApiWhitelist 按顶级技能（5 个域）配置——每个域的 allowlist 是其下
+# 所有子技能出网地址的并集。用 (?:/|$) 锚定段尾，避免误吞后续路径段。
+# (?<![\w]) 否定左查找：要求 skills 前不是单词字符，避免误匹配 myskills/、
+# theskills/ 等含 skills 子串的路径（行首、空格、引号、/ 后均成立）。
+_SKILL_TOP_RE = re.compile(r'(?<![\w])skills/([A-Za-z0-9_\-]+)(?:/|$)')
 
 # BASE_URL 占位符 ${VAR}
 _PLACEHOLDER_RE = re.compile(r'\$\{([A-Z_][A-Z0-9_]*)\}')
@@ -181,12 +183,9 @@ class SkillApiWhitelistMiddleware(AgentMiddleware):
             SYLogger.error("[Whitelist] 推送 sitecustomize 失败(fail-open): %s", e)
             return False
 
-    # ---- 子技能名提取 ----
+    # ---- 顶级技能名提取 ----
     def _extract_skill_name(self, command: str) -> Optional[str]:
-        m = _SKILL_NESTED_RE.search(command)
-        if m:
-            return m.group(1)
-        m = _SKILL_FLAT_RE.search(command)
+        m = _SKILL_TOP_RE.search(command)
         if m:
             return m.group(1)
         return None
@@ -208,7 +207,7 @@ class SkillApiWhitelistMiddleware(AgentMiddleware):
 
         skill_name = self._extract_skill_name(command)
         if skill_name is None:
-            # 非技能命令（无 skills/.../scripts/）→ 不管控
+            # 非技能命令（无 skills/<顶级技能>/）→ 不管控
             return await handler(request)
 
         # 延迟导入避免模块加载期循环依赖

{sycommon_python_lib-0.2.7a5 → sycommon_python_lib-0.2.7a6}/src/sycommon/config/SkillApiWhitelistConfig.py

@@ -1,10 +1,14 @@
 """技能接口白名单配置模型。
 
-定义「单个子技能被允许访问的外部接口白名单」，配置来源是 Nacos 的
-`shengye-platform-digital-work` dataId 下的 `SkillApiWhitelist` 列表：
+定义「单个顶级技能被允许访问的外部接口白名单」，配置来源是 Nacos 的
+`shengye-platform-digital-work` dataId 下的 `SkillApiWhitelist` 列表。
+
+配置粒度按顶级技能（5 个域：sy-oa-skill / sy-syt-skill / sy-eas-skill /
+sy-metting-skill / skill-creator），每个域的 allowlist 是其下所有子技能
+出网地址的并集。skill 字段取自 `skills/<顶级技能>/` 的第一段目录名：
 
     SkillApiWhitelist:
-      - skill: workflow-todo            # 子技能名（skills/<域>/<子技能>/scripts/ 里的 <子技能>）
+      - skill: sy-oa-skill              # 顶级技能名（skills/<顶级技能>/ 里的 <顶级技能>）
         enabled: true
         allowlist:
           - "${OA_WORKFLOW_URL}"                    # BASE_URL 占位符，主进程解析成完整 URL
@@ -13,9 +17,9 @@
           - "/wf"                                   # 纯 path 前缀（匹配任意 host，谨慎用）
 
 语义约定（务必在 Nacos 配置注释里写明）：
-  - 子技能【未出现】在配置里 → 不管控，全放行（向后兼容）
+  - 顶级技能【未出现】在配置里 → 不管控，全放行（向后兼容）
   - enabled: false            → 全放行
-  - allowlist: []（空数组）   → 明确禁止该子技能任何外网请求（全拦截）
+  - allowlist: []（空数组）   → 明确禁止该顶级技能任何外网请求（全拦截）
 
 代码侧用 `SkillApiWhitelistConfig.from_config(skill)` 按 skill 取单条，
 或 `list_from_config()` 取全部。
@@ -30,8 +34,9 @@ class SkillApiWhitelistConfig(BaseModel):
     """单个子技能的接口白名单配置。"""
 
     skill: str = Field(
-        description="子技能名，对应命令路径 skills/<域>/<子技能>/scripts/x.py 里的 <子技能>，"
-                    "如 'workflow-todo'、'oa-workorder'、'wecomcli-wrapper'")
+        description="顶级技能名，对应 skills/<顶级技能>/ 目录，"
+                    "如 'sy-oa-skill'、'sy-syt-skill'、'sy-eas-skill'、"
+                    "'sy-metting-skill'、'skill-creator'")
     enabled: bool = Field(default=True, description="是否启用白名单管控；False 则全放行")
     allowlist: list[str] = Field(
         default_factory=list,
@@ -39,7 +44,7 @@ class SkillApiWhitelistConfig(BaseModel):
             "白名单条目（字符串数组）。每条可以是：完整 URL（https://...）、"
             "BASE_URL 占位符（${ENV_VAR} 或 ${ENV_VAR}/path）、纯 path 前缀（/wf）。"
             "主进程加载时把 ${ENV_VAR} 解析成完整 URL，运行期做 path 级前缀匹配。"
-            "空数组 [] = 明确禁止该子技能任何外网请求。"
+            "空数组 [] = 明确禁止该顶级技能任何外网请求。"
         ))
 
     @classmethod
@@ -52,7 +57,7 @@ class SkillApiWhitelistConfig(BaseModel):
 
     @classmethod
     def list_from_config(cls) -> list["SkillApiWhitelistConfig"]:
-        """从 Nacos 配置取全部已配置的子技能白名单。
+        """从 Nacos 配置取全部已配置的顶级技能白名单。
 
         配置读 `Config().config.get("SkillApiWhitelist", [])`——即
         `shengye-platform-digital-work` dataId 下的 SkillApiWhitelist 列表

{sycommon_python_lib-0.2.7a5 → sycommon_python_lib-0.2.7a6}/src/sycommon_python_lib.egg-info/PKG-INFO

@@ -1,13 +1,13 @@
 Metadata-Version: 2.4
 Name: sycommon-python-lib
-Version: 0.2.7a5
+Version: 0.2.7a6
 Summary: Add your description here
 Requires-Python: >=3.11
 Description-Content-Type: text/markdown
 Requires-Dist: aio-pika==9.6.2
 Requires-Dist: aiohttp==3.14.1
 Requires-Dist: aiomysql==0.3.2
-Requires-Dist: anyio==4.14.0
+Requires-Dist: anyio==4.14.1
 Requires-Dist: decorator==5.3.1
 Requires-Dist: deepagents==0.6.11
 Requires-Dist: elasticsearch==9.4.1

{sycommon_python_lib-0.2.7a5 → sycommon_python_lib-0.2.7a6}/src/sycommon_python_lib.egg-info/requires.txt

@@ -1,7 +1,7 @@
 aio-pika==9.6.2
 aiohttp==3.14.1
 aiomysql==0.3.2
-anyio==4.14.0
+anyio==4.14.1
 decorator==5.3.1
 deepagents==0.6.11
 elasticsearch==9.4.1