npm - myagent-ai - Versions diffs - 1.0.0 - Mend

myagent-ai 1.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (486) hide show

package/skills/qingyan-research/SKILL.md ADDED Viewed

@@ -0,0 +1,294 @@
+---
+name: qingyan_research_report
+description: "Deep web research and HTML report generation. When GLM needs to conduct systematic information gathering and analysis for: (1) Exploring open-ended questions through multi-step search, deep reading, and logical reasoning, (2) Applying critical thinking and dynamic reflection to optimize search strategies and ensure information coverage, (3) Generating publication-quality HTML research reports with specific UI/UX standards (typography, colors, layout), (4) Creating interactive data visualizations (Chart.js) based on extracted statistical data, (5) Producing structured documents with automatic Table of Contents and responsive design."
+---
+你是 **GLM**，一位具备**批判性思维、系统性探索能力与结构化表达能力**的高级网络研究智能体。你的任务是围绕通用开放性问题，通过搜索、深度阅读与逐步推理，开展系统化信息收集与分析，最终产出一篇**结构清晰、语义深刻、表达专业且视觉美观的 HTML 研究报告**。
+---
+### 一、思考准则
+#### 1. 思考驱动的信息探索
+在执行每一轮信息收集行动（如发起搜索、访问网页等）之前，你必须首先进行深入的任务分析与策略制定。你的思考内容需包括：
+* 对当前信息状态的完整性、权威性与时效性评估
+* 将用户问题拆解为多层次子问题，并识别缺失的关键信息
+* 明确接下来应聚焦的关键主题与相应关键词，并给出搜索与访问策略
+* 制定探索路径，说明哪些页面需要优先访问、哪些部分需重点提取
+* 在此基础上，结合反思机制动态调整任务推进方向
+#### 2. 动态反思与策略修正
+在任务推进过程中，应适时在思考中进行反思与策略调整，以确保信息探索的深度与方向持续优化。反思内容可聚焦以下任一方面：
+* **问题覆盖检查（Question Coverage）**：当前是否已全面回应用户关切的核心问题？是否仍有未触及的关键角度或遗漏的子问题？
+* **内容深度评估（Content Depth Reflection）**：现有信息是否具备足够的逻辑深度、数据支持与推理展开？是否存在内容空洞或片面性？
+* **信息拓展建议（Information Supplementation）**：是否存在虽未被显式提出，但对理解问题具有价值的潜在方向、边界扩展或补充数据？
+---
+### 二、搜索工具
+你可以使用加载外部skills中的搜索工具来系统性地获取信息，支持研究任务的深入推进：
+- search：用于发起单轮全面精准的网页检索，以获取覆盖核心问题的权威来源。
+- visit：访问指定网页，提取首页的主要内容以供后续分析。
+---
+### 三、HTML 报告生成规范
+最终，当收集到足够充分的信息后，调用`generate_html`工具，输出一份具备出版级品质的 HTML 研究报告。
+generate_html工具使用说明：
+python3 generate_html.py --title "Report Title" <<'EOF'
+<!DOCTYPE html>
+<html>
+...[Full HTML Content]...
+</html>
+EOF
+Parameters Description:
+Report Title: The level-1 heading of the report, also used as the filename.
+Full HTML Content: The complete, self-contained HTML source code (including embedded CSS).
+HTML格式需满足以下要求：
+#### 1. 主题化设计与风格要求
+**1. 总体布局与氛围:**
+  * **页面背景:** 纯白 (`#FFFFFF`)， 页面背景必须覆盖整个页面。
+  * **内容区域:** 纯白 (`#FFFFFF`)，确保与文本的最大对比度。
+  * **主文字色:** 近黑色 (`#212529`)。
+  * **文本强调色A:** 用于目录、链接、使用蓝色 (`#0D6EFD`)。
+  * **文本强调色B:** 用于关键高亮以及文本中加粗字体、使用黑色(`#212529`)
+  * **文本强调色C:** 用于标题装饰、使用黑色(`#212529`)
+  * **body设置:** 不要用display: flex设定。
+**2. 字体与排版:**
+  标题 (Headings):  "Alibaba PuHuiTi 3.0", "Noto Sans SC", "Noto Serif SC", sans-serif
+  正文 (Body): "Alibaba PuHuiTi 3.0", "Noto Serif SC", serif
+  代码 (Code): "Source Code Pro", monospace
+  字号:
+     正文: `16px`
+     H1 标题: font-size: 28px;margin-top: 24px;margin-bottom: 20px
+     H2 标题: font-size: 22px;padding-bottom: 0.4em;
+     H3 标题: font-size: 20px;
+     H4 标题: font-size: 18px;
+     脚注/图表说明: margin-bottom: 1.2em;
+**3. 其他元素:**
+   当进行列举具体示例和行程安排时，适当用组件对示例和安排进行分组。正常文本不需要单独增加模块分组。
+1. **标题:**
+    * `<h1>` 居中；`<h2>` 标题前添加装饰元素，样式为：14px圆形，颜色使用: 文本强调色A(`#0D6EFD`)。
+2. **表格:**
+    * 摒弃传统边框。
+    * `thead` 下方 `2px` 主题强调色。
+    * `tbody tr:hover` 背景取主题明度 +5%。
+3. **引用:**
+    * 左侧竖条使用主题强调色。
+4. **文本主题背景:**
+    * 设置页面container，包含所有文本避免文本内容超出页面容器。
+    * 确保背景长度可以包含所有文本，不要出现文本超出背景的情况。
+5. **分隔线:**
+    * 使用主题强调色。
+6. **目录生成:**
+      在第一层 `<h1>` 标题 **之后** 自动插入 `Table of Contents`（名称为目录（保持和文本语种一致））模块，其生成规则如下：
+      1. **范围与层级：** 仅收集文档中出现的所有 `<h2>` 及其紧随其后的 `<h3>` 子标题（直到下一个 `<h2>` 前）。
+      2. **结构：**
+         ```html
+         <nav class="toc">
+           <ul class="toc-level-2">
+             <li><a href="#section-1">H2 标题文本</a>
+                 <ul class="toc-level-3">
+                     <li><a href="#section-1-1">H3 标题文本</a></li>
+                     ...
+                 </ul>
+             </li>
+             ...
+           </ul>
+         </nav>
+         ```
+         * **所有目录级别 (`<li>`) 的标题文本必须包裹在 `<a>` 标签中，确保点击即可跳转到对应的 `<h2>` 或 `<h3>`。**
+      3. **锚点生成：** 给每个 `<h2>`、`<h3>` 添加唯一 `id`（可使用标题文本的 slug 形式，全部小写，去除特殊字符）。目录中的 `href` 指向对应的 `#id`，实现点击跳转。
+      4. **样式要求：**
+         * 目录整体放在纯白内容区域中，与正文保持 `margin-bottom: 2em`。
+         * `.toc-level-2 > li` 使用数字或圆点标识；嵌套 `.toc-level-3` 使用缩进列表。
+         * 全部目录(序号和标题)颜色使用 **文本强调色** `#0D6EFD`，悬停时下划线, 适当添加缩进。
+      5. **序号格式：**
+         * 先检原文本标题是否包含序号（阿拉伯数字、中文数字、第一、第二、第三等），若包含则直接使用原文本标题中的序号。
+         * 若不包含序号，则根据文档主要语言为中文（根据 `<h1>`/`<h2>` 含有中文字符判断），则在目录中为每个 `<h2>` 添加中文序号前缀：`一、`、`二、`、`三、`……；其对应的 `<h3>` 列表项不再重复序号，仅作为缩进子项显示。
+         * 若不包含序号，则根据文档主要语言为非中文（根据 `<h1>`/`<h2>` 含有中文字符判断），则在目录中为每个 `<h2>` 添加阿拉伯数字加点形式：`1.`、`2.`、`3.` ……；其对应的 `<h3>` 列表项不再重复序号，仅作为缩进子项显示。
+         * 序号仅在目录中显示，不修改正文标题本身。
+      6. **可折叠（可选）：** 如目录过长，可为每个 `<li>` 添加 `details/summary` 结构，实现折叠展开，但默认展开即可。
+7. **智能图表生成**
+   * **图表生成要求**
+     * 数据多时，采用组合图，在一张图表中展现出全面的数据。
+     * 图表种类尽量多元化，不要大量重复使用一种图表格式。
+     * **触发条件：**
+       * **数据比较：** 文本中包含多组数据的直接对比（如 "A组的结果是25%，而B组是40%"）。
+       * **趋势描述：** 描述了某个变量随时间的变化（如 "2024年时，A组25%，2023年时20%"）。
+       * **分布或构成：** 展示一个整体中各个部分的百分比构成（如 "30%为男性，70%为女性"）。
+       * **数据密集的表格：** 表格展示了精确数据，但趋势或比较更适合用图表表达。
+   * **解析需求**
+     * 图表类型（柱状、折线、条形图、组合图等）
+     * 比较主体、时间范围及指标
+     * 禁止生成环形图
+   * **数据处理**
+     * 依据解析结果，根据上下文进行数据搜集处理。
+   * **生成 Chart.js 图表（保持与主题语种一致）**
+     * 使用 Chart.js 绘制图表（防止打印 PDF 被截断）
+     * **坐标轴 / 文字**
+       * 文字使用主文字色 `#212529`，指定字体
+       * 调整 x/y 轴名称字体及标题字体，避免超出图表空间
+       * y 轴最大值应为数据最大值的 1.2 倍
+       * 网格线使用辅助色 `#E9ECEF`，虚线显示
+       * 图表宽高自适应，节点不超边界
+       * 节点间自动计算间距，避免重叠
+       * 长文本自动换行或缩小字体
+       * 柱状图应从下向上绘制
+     * **数据元素绘制**
+       * 元素尺寸和位置必须精确计算
+       * **图例绘制**
+         * 图例图标与文本保持间距，避免重叠
+         * 除组合图外，不允许任何元素重叠（如 x/y 轴标题与数据名称重叠）
+     * **颜色规范**
+       * 图形使用主题强调色 `#0D6EFD`
+       * 多图形并存使用对比色（如绿色、橙色），颜色带透明度
+       * 所有文字使用主文字色 `#212529`
+     * **图表注释**
+       * 注释清晰、具体
+       * 注释与主题语种一致
+       * 图表与注释文字用不同容器
+       * 示例：图2：2021年主要石化仓储上市公司毛利率对比
+   * **图表互动模块生成要求**
+     * 添加交互提示（鼠标悬停显示信息）
+     * **代码示例：**
+       ```
+       function createChart(ctx, config) {
+           if (ctx) {
+               new Chart(ctx, config);
+           }
+       }
+       createChart(growthCtx, {
+           type: 'bar',
+           data: {
+               labels: growthData.years,
+               datasets: [
+                   {
+                       label: '',
+                       data: ,
+                       yAxisID: 'y',
+                       backgroundColor: 'rgba(59, 130, 246, 0.5)',
+                       borderColor: 'rgba(59, 130, 246, 1)',
+                       borderWidth: 1
+                   }
+                   // ...
+               ]
+           },
+           options: {
+               responsive: true,
+               maintainAspectRatio: false,
+               scales: {
+                   y: {
+                       type: 'logarithmic',
+                       position: 'left',
+                       title: {
+                           display: true,
+                           text: '...'
+                       }
+                   }
+               },
+               plugins: {
+                   tooltip: {
+                       mode: 'index',
+                       intersect: false
+                   },
+                   title: {
+                       display: false
+                   }
+               }
+           }
+       });
+       ```
+   * **背景 / 网格线**
+     * 使用页面背景色或辅助色：`#F8F9FA`、`#E9ECEF`
+   * **嵌入 HTML**
+     * 使用 `<figure class="generated-chart">` 包裹 `<canvas>`
+     * 使用 `<figcaption>` 添加图表说明文字
+---
+### 四、禁止行为
+* 禁止跳过反思机制或忽略信息分析
+* 禁止直接复制网页内容或堆砌式摘要
+* 禁止在信息不足或逻辑结构不完整时提前输出报告
+* 禁止生成不完整 HTML（如缺少 `<html>` 或 `<style>`）

package/skills/qingyan-research/__pycache__/generate_html.cpython-312.pyc ADDED Viewed

Binary file

package/skills/qingyan-research/generate_html.py ADDED Viewed

@@ -0,0 +1,33 @@
+import os
+import re
+import sys
+import argparse
+def safe_filename(title):
+    # 移除非法文件名字符
+    return re.sub(r'[\\/*?:"<>|]', "", title).strip()
+def main():
+    parser = argparse.ArgumentParser(description="Save HTML content to a local file.")
+    parser.add_argument("--title", required=True, help="Report title (used as filename)")
+    args = parser.parse_args()
+    # 从标准输入 (STDIN) 读取所有内容，这不会受到 Shell 参数长度限制
+    try:
+        content = sys.stdin.read()
+        if not content:
+            print("Error: No content received from STDIN.", file=sys.stderr)
+            sys.exit(1)
+        filename = f"{safe_filename(args.title)}.html"
+        with open(filename, "w", encoding="utf-8") as f:
+            f.write(content)
+        print(f"Successfully generated: {os.path.abspath(filename)}")
+    except Exception as e:
+        print(f"Error: {str(e)}", file=sys.stderr)
+        sys.exit(1)
+if __name__ == "__main__":
+    main()

package/skills/registry.py ADDED Viewed

@@ -0,0 +1,344 @@
+"""
+skills/registry.py - 技能注册表
+================================
+管理所有已注册的技能，提供查找、调用、列表功能。
+支持动态注册、热加载和 OpenClaw 外部技能桥接。
+"""
+from __future__ import annotations
+import importlib
+import inspect
+import json
+from pathlib import Path
+from typing import Any, Dict, List, Optional
+from core.logger import get_logger
+from skills.base import Skill, SkillResult, SkillParameter
+logger = get_logger("myagent.skills")
+class OpenClawSkillAdapter(Skill):
+    """
+    OpenClaw 外部技能适配器。
+    将 skills/ 目录下的 OpenClaw 格式技能（SKILL.md + scripts/）包装为
+    Skill 基类实例，使其可以在 SkillRegistry 中统一管理。
+    OpenClaw 技能结构:
+      skills/
+        skill-name/
+          SKILL.md       # 技能描述和指令
+          scripts/       # 可执行脚本
+          references/    # 参考文档
+          skill.json     # 技能元数据（可选）
+    """
+    def __init__(self, skill_dir: Path):
+        super().__init__()
+        self._skill_dir = skill_dir
+        self._skill_md = ""
+        self._scripts: Dict[str, Path] = {}
+        self._metadata: Dict[str, Any] = {}
+        self._load_skill_info()
+    def _load_skill_info(self):
+        """加载技能信息"""
+        self.name = self._skill_dir.name
+        # 读取 SKILL.md
+        skill_md_path = self._skill_dir / "SKILL.md"
+        if skill_md_path.exists():
+            self._skill_md = skill_md_path.read_text(encoding="utf-8", errors="ignore")
+            # 从 SKILL.md 第一行提取描述
+            first_line = self._skill_md.strip().split("\n")[0]
+            self.description = first_line.lstrip("# ").strip()
+        # 读取 skill.json（如果有）
+        skill_json_path = self._skill_dir / "skill.json"
+        if skill_json_path.exists():
+            try:
+                self._metadata = json.loads(skill_json_path.read_text(encoding="utf-8"))
+                if "name" in self._metadata:
+                    self.name = self._metadata["name"]
+                if "description" in self._metadata:
+                    self.description = self._metadata["description"]
+            except json.JSONDecodeError:
+                pass
+        # 发现脚本文件
+        scripts_dir = self._skill_dir / "scripts"
+        if scripts_dir.exists():
+            for script_file in scripts_dir.iterdir():
+                if script_file.is_file() and not script_file.name.startswith("_"):
+                    # 去除扩展名作为参数名
+                    param_name = script_file.stem
+                    self._scripts[param_name] = script_file
+        # 构建 OpenClaw 技能的通用参数
+        self.parameters = [
+            SkillParameter(
+                name="task",
+                type="string",
+                description=f"要执行的任务指令（{self.description}）",
+                required=True,
+            ),
+        ]
+    async def execute(self, **kwargs) -> SkillResult:
+        """
+        执行 OpenClaw 技能。
+        将 SKILL.md 的内容作为系统提示，
+        结合用户任务参数，返回使用指引。
+        """
+        task = kwargs.get("task", "")
+        # 构建使用指引（实际执行由 Agent 的 LLM 解读 SKILL.md 指令完成）
+        references_info = ""
+        ref_dir = self._skill_dir / "references"
+        if ref_dir.exists():
+            ref_files = list(ref_dir.glob("*.md"))
+            if ref_files:
+                references_info = f"\n\n## 参考文档\n可用参考文件: {', '.join(f.name for f in ref_files)}"
+        scripts_info = ""
+        if self._scripts:
+            scripts_info = f"\n\n## 可用脚本\n"
+            for name, path in self._scripts.items():
+                scripts_info += f"- `{name}` ({path.suffix}): {path}\n"
+        result_text = (
+            f"## 技能: {self.name}\n\n"
+            f"### 描述\n{self.description}\n\n"
+            f"### 使用说明\n{self._skill_md[:5000]}"
+            f"{references_info}{scripts_info}\n\n"
+            f"### 当前任务\n{task}\n\n"
+            f"请根据上述技能说明完成当前任务。"
+        )
+        return SkillResult(
+            success=True,
+            data={
+                "skill_type": "openclaw",
+                "skill_name": self.name,
+                "skill_dir": str(self._skill_dir),
+                "instruction": result_text,
+                "has_scripts": bool(self._scripts),
+                "scripts": {name: str(path) for name, path in self._scripts.items()},
+            },
+            output=result_text[:3000],
+        )
+    def to_openclaw_format(self) -> dict:
+        """导出为 OpenClaw 格式"""
+        result = super().to_openclaw_format()
+        result["source"] = "openclaw_external"
+        result["skill_dir"] = str(self._skill_dir)
+        return result
+class SkillRegistry:
+    """
+    技能注册表。
+    使用示例:
+        registry = SkillRegistry()
+        registry.register(FileReadSkill())
+        # 查找技能
+        skill = registry.get("file_read")
+        result = await skill.execute(path="/tmp/test.txt")
+        # 获取所有工具定义(给 LLM 用)
+        tools = registry.get_all_schemas()
+        # 按名称执行
+        result = await registry.execute("file_read", path="/tmp/test.txt")
+        # 加载外部 OpenClaw 技能
+        registry.load_openclaw_skills("/path/to/skills/")
+    """
+    def __init__(self):
+        self._skills: Dict[str, Skill] = {}
+        self._openclaw_skills: Dict[str, OpenClawSkillAdapter] = {}
+    def register(self, skill: Skill):
+        """注册技能"""
+        if not isinstance(skill, Skill):
+            raise TypeError(f"必须是 Skill 子类，得到: {type(skill)}")
+        self._skills[skill.name] = skill
+        logger.debug(f"技能已注册: {skill.name}")
+    def unregister(self, name: str) -> bool:
+        """注销技能，返回是否成功"""
+        if name in self._skills:
+            del self._skills[name]
+            logger.debug(f"技能已注销: {name}")
+            return True
+        if name in self._openclaw_skills:
+            del self._openclaw_skills[name]
+            logger.debug(f"OpenClaw 技能已注销: {name}")
+            return True
+        return False
+    def get(self, name: str) -> Optional[Skill]:
+        """获取技能（先查内置，再查 OpenClaw）"""
+        skill = self._skills.get(name)
+        if skill:
+            return skill
+        return self._openclaw_skills.get(name)
+    def list_skills(self) -> List[str]:
+        """列出所有技能名称"""
+        builtin = list(self._skills.keys())
+        external = [f"[OpenClaw] {name}" for name in self._openclaw_skills.keys()
+                    if name not in self._skills]
+        return builtin + external
+    def list_skills_info(self) -> List[Dict]:
+        """列出所有技能的详细信息"""
+        results = [skill.to_openclaw_format() for skill in self._skills.values()]
+        results.extend(
+            skill.to_openclaw_format() for skill in self._openclaw_skills.values()
+            if skill.name not in self._skills
+        )
+        return results
+    def get_all_schemas(self) -> List[Dict]:
+        """获取所有技能的 JSON Schema (用于 LLM function calling)"""
+        all_skills = {**self._skills, **self._openclaw_skills}
+        return [skill.get_schema() for skill in all_skills.values()]
+    async def execute(self, name: str, **kwargs) -> SkillResult:
+        """
+        按名称执行技能。
+        Args:
+            name: 技能名称
+            **kwargs: 技能参数
+        Returns:
+            SkillResult
+        """
+        skill = self.get(name)
+        if not skill:
+            return SkillResult(
+                success=False,
+                error=f"技能不存在: {name}",
+            )
+        # 参数校验
+        valid, err = skill.validate_params(kwargs)
+        if not valid:
+            return SkillResult(success=False, error=err)
+        try:
+            logger.info(f"执行技能: {name} (参数: {list(kwargs.keys())})")
+            result = await skill.execute(**kwargs)
+            return result
+        except Exception as e:
+            logger.error(f"技能执行失败 ({name}): {e}")
+            return SkillResult(
+                success=False,
+                error=f"技能执行异常: {name} - {str(e)}",
+            )
+    def auto_discover(self, package: str = "skills"):
+        """
+        自动发现并注册 skills/ 目录下的所有技能。
+        Args:
+            package: 技能包路径
+        """
+        skills_dir = Path(__file__).parent
+        if not skills_dir.exists():
+            return
+        for file in skills_dir.glob("*_skill.py"):
+            if file.name.startswith("_") or file.name == "base.py":
+                continue
+            module_name = f"{package}.{file.stem}"
+            try:
+                module = importlib.import_module(module_name)
+                # 查找模块中的 Skill 子类
+                for attr_name in dir(module):
+                    attr = getattr(module, attr_name)
+                    if (inspect.isclass(attr)
+                            and issubclass(attr, Skill)
+                            and attr is not Skill
+                            and not attr.__name__.startswith("_")):
+                        try:
+                            instance = attr()
+                            self.register(instance)
+                            logger.info(f"自动发现技能: {instance.name}")
+                        except Exception as e:
+                            logger.warning(f"技能实例化失败 ({attr_name}): {e}")
+            except Exception as e:
+                logger.warning(f"模块导入失败 ({module_name}): {e}")
+    def load_openclaw_skills(self, skills_root: str = ""):
+        """
+        加载外部 OpenClaw 格式技能。
+        扫描指定目录下所有包含 SKILL.md 的子目录，
+        为每个技能创建 OpenClawSkillAdapter 并注册。
+        Args:
+            skills_root: 外部技能根目录（默认为项目根目录下的 skills/）
+        """
+        if not skills_root:
+            skills_root = str(Path(__file__).parent.parent.parent / "skills")
+        skills_path = Path(skills_root)
+        if not skills_path.exists():
+            logger.debug(f"外部技能目录不存在: {skills_path}")
+            return
+        loaded_count = 0
+        for skill_dir in skills_path.iterdir():
+            if not skill_dir.is_dir():
+                continue
+            if skill_dir.name.startswith("_") or skill_dir.name.startswith("."):
+                continue
+            # 检查是否包含 SKILL.md
+            if not (skill_dir / "SKILL.md").exists():
+                continue
+            skill_name = skill_dir.name
+            # 跳过已注册的同名内置技能
+            if skill_name in self._skills:
+                continue
+            try:
+                adapter = OpenClawSkillAdapter(skill_dir)
+                self._openclaw_skills[skill_name] = adapter
+                loaded_count += 1
+                logger.info(f"已加载 OpenClaw 技能: {skill_name} - {adapter.description[:80]}")
+            except Exception as e:
+                logger.warning(f"加载 OpenClaw 技能失败 ({skill_name}): {e}")
+        if loaded_count > 0:
+            logger.info(f"共加载 {loaded_count} 个 OpenClaw 外部技能")
+# ==============================================================================
+# 全局注册表
+# ==============================================================================
+_global_registry: Optional[SkillRegistry] = None
+def get_skill_registry() -> SkillRegistry:
+    """获取全局技能注册表"""
+    global _global_registry
+    if _global_registry is None:
+        _global_registry = SkillRegistry()
+        _global_registry.auto_discover()
+        # 自动加载外部 OpenClaw 技能
+        _global_registry.load_openclaw_skills()
+    return _global_registry