adam-community 0.0.4__tar.gz

adam_community-0.0.4/PKG-INFO

@@ -0,0 +1,53 @@
+Metadata-Version: 2.2
+Name: adam_community
+Version: 0.0.4
+Summary: Adam Community Tools and Utilities
+Home-page: https://github.com/yourusername/adam-community
+Author: Adam Community
+Author-email: admin@sidereus-ai.com
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+Requires-Dist: requests>=2.31.0
+Requires-Dist: click>=8.0.0
+Requires-Dist: docstring-parser>=0.15
+Requires-Dist: rich>=13.0.0
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+# Adam Community
+
+Adam Community 是一个 Python 工具包，提供了一系列实用工具和功能，用于与 Adam 社区相关的开发工作。
+
+安装依赖：
+```bash
+make install
+```
+
+
+## 使用方法
+
+安装完成后，您可以在 Python 代码中导入并使用该包：
+
+```python
+from adam_community import tool
+from adam_community import util
+
+# 使用相关功能
+```
+
+## 开发
+
+运行测试：
+```bash
+make test
+```

adam_community-0.0.4/README.md

@@ -0,0 +1,27 @@
+# Adam Community
+
+Adam Community 是一个 Python 工具包，提供了一系列实用工具和功能，用于与 Adam 社区相关的开发工作。
+
+安装依赖：
+```bash
+make install
+```
+
+
+## 使用方法
+
+安装完成后，您可以在 Python 代码中导入并使用该包：
+
+```python
+from adam_community import tool
+from adam_community import util
+
+# 使用相关功能
+```
+
+## 开发
+
+运行测试：
+```bash
+make test
+```

adam_community-0.0.4/adam_community/__init__.py

@@ -0,0 +1,4 @@
+from .util import messageSend, knowledgeSearch, completionCreate, runCmd
+from .tool import Tool
+
+__all__ = ['Tool', 'messageSend', 'knowledgeSearch', 'completionCreate', 'runCmd']

adam_community-0.0.4/adam_community/cli/build.py

@@ -0,0 +1,269 @@
+import json
+import zipfile
+from pathlib import Path
+from typing import Tuple, List
+from rich.console import Console
+from rich.panel import Panel
+from rich.tree import Tree
+from .parser import parse_directory
+
+console = Console()
+
+def check_python_files(directory: Path) -> Tuple[bool, List[str]]:
+    """检查所有 Python 文件是否都有参数定义"""
+    tree = Tree("📦 Python 文件检查")
+    errors = []
+    warnings = []
+    functions = parse_directory(directory)
+    
+    tree.add(f"找到 {len(functions)} 个类定义")
+    for func in functions:
+        func_info = func["function"]
+        
+        # 检查描述长度
+        description = func_info.get("description")
+        if description is None or not description:
+            warning_msg = f"⚠️ {func_info['file']}: {func_info['name']} 没有描述"
+            tree.add(warning_msg)
+            warnings.append(warning_msg)
+        elif len(description) > 1024:
+            error_msg = f"❌ {func_info['file']}: {func_info['name']} 描述长度超过1024字符 ({len(description)})"
+            tree.add(error_msg)
+            errors.append(error_msg)
+        else:
+            tree.add(f"✓ {func_info['file']}: {func_info['name']} 描述长度: {len(description)}")
+
+        # 检查参数定义
+        if not func_info["parameters"]["properties"]:
+            warning_msg = f"⚠️ {func_info['file']}: {func_info['name']} 没有参数定义"
+            tree.add(warning_msg)
+            warnings.append(warning_msg)
+        else:
+            # 检查参数类型是否都是有效的JSON Schema类型
+            param_errors = []
+            for param_name, param_info in func_info["parameters"]["properties"].items():
+                if "type" not in param_info:
+                    param_errors.append(f"参数 '{param_name}' 缺少类型定义")
+                elif param_info["type"] not in ["string", "integer", "number", "boolean", "array", "object", "null"]:
+                    param_errors.append(f"参数 '{param_name}' 类型 '{param_info['type']}' 不是有效的JSON Schema类型")
+            
+            if param_errors:
+                for param_error in param_errors:
+                    error_msg = f"❌ {func_info['file']}: {func_info['name']} - {param_error}"
+                    tree.add(error_msg)
+                    errors.append(error_msg)
+            else:
+                tree.add(f"✓ {func_info['file']}: {func_info['name']} 参数类型验证通过")
+    
+    if errors:
+        tree.add("❌ 检查未通过")
+    else:
+        tree.add("✅ 检查通过")
+    
+    # 显示警告信息
+    if warnings:
+        tree.add(f"⚠️ 发现 {len(warnings)} 个警告（不影响构建）")
+    
+    console.print(tree)
+    return len(errors) == 0, errors
+
+def check_configuration(directory: Path) -> Tuple[bool, List[str]]:
+    """检查 configure.json 文件"""
+    tree = Tree("📄 配置文件检查")
+    errors = []
+    config_path = directory / "config" / "configure.json"
+    
+    if not config_path.exists():
+        tree.add("❌ 未找到 configure.json 文件")
+        console.print(tree)
+        return False, ["configure.json 文件不存在"]
+    
+    try:
+        with open(config_path, 'r', encoding='utf-8') as f:
+            config = json.load(f)
+        
+        required_fields = ["name", "version", "display_name"]
+        for field in required_fields:
+            if field not in config:
+                errors.append(f"configure.json 缺少必要字段: {field}")
+                tree.add(f"❌ 缺少字段: {field}")
+            else:
+                tree.add(f"✓ {field}: {config[field]}")
+        
+        if errors:
+            tree.add("❌ 检查未通过")
+        else:
+            tree.add("✅ 检查通过")
+        
+        console.print(tree)
+        return len(errors) == 0, errors
+    except json.JSONDecodeError:
+        tree.add("❌ 配置文件格式错误")
+        console.print(tree)
+        return False, ["configure.json 文件格式错误"]
+
+def check_markdown_files(directory: Path) -> Tuple[bool, List[str]]:
+    """检查必要的 Markdown 文件"""
+    tree = Tree("📑 Markdown 文件检查")
+    errors = []
+    
+    # 先读取配置文件中的 type 字段
+    config_path = directory / "config" / "configure.json"
+    config_type = "agent"  # 默认值
+    
+    if config_path.exists():
+        try:
+            with open(config_path, 'r', encoding='utf-8') as f:
+                config = json.load(f)
+                config_type = config.get("type", "agent")
+        except json.JSONDecodeError:
+            pass  # 配置文件格式错误时使用默认值
+    
+    # 根据 type 设置不同的 required_files
+    if config_type == "kit":
+        required_files = [
+            "configure.json", 
+            "long_description.md",
+            "input.json"
+        ]
+    else:  # type=agent 或空值
+        required_files = [
+            "initial_assistant_message.md",
+            "initial_system_prompt.md", 
+            "long_description.md"
+        ]
+    
+    tree.add(f"检查类型: {config_type}")
+    
+    for file in required_files:
+        file_path = directory / "config" / file
+        if not file_path.exists():
+            errors.append(f"缺少必要文件: {file}")
+            tree.add(f"❌ {file}")
+        else:
+            # 对于 input.json，额外检查 JSON 格式
+            if file == "input.json":
+                try:
+                    with open(file_path, 'r', encoding='utf-8') as f:
+                        json.load(f)
+                    tree.add(f"✓ {file} (JSON 格式正确)")
+                except json.JSONDecodeError:
+                    errors.append(f"{file} JSON 格式错误")
+                    tree.add(f"❌ {file} (JSON 格式错误)")
+            else:
+                tree.add(f"✓ {file}")
+    
+    if errors:
+        tree.add("❌ 检查未通过")
+    else:
+        tree.add("✅ 检查通过")
+    
+    console.print(tree)
+    return len(errors) == 0, errors
+
+def create_zip_package(directory: Path) -> str:
+    """创建 zip 包"""
+    tree = Tree("📦 创建压缩包")
+    with open(directory / "config" / "configure.json", 'r', encoding='utf-8') as f:
+        config = json.load(f)
+    
+    zip_name = f"{config['name']}_{config['version']}.zip"
+    zip_path = directory / zip_name
+    
+    tree.add(f"包名: {zip_name}")
+    
+    # 获取配置类型
+    config_type = config.get("type", "agent")
+    
+    with zipfile.ZipFile(zip_path, 'w', zipfile.ZIP_DEFLATED) as zipf:
+        # 添加所有 Python 文件
+        py_files = list(directory.rglob('*.py'))
+        py_tree = tree.add("Python 文件")
+        for py_file in py_files:
+            if not py_file.name.startswith('_'):
+                zipf.write(py_file, py_file.relative_to(directory))
+                py_tree.add(f"+ {py_file.relative_to(directory)}")
+        
+        # 添加配置文件
+        config_tree = tree.add("配置文件")
+        zipf.write(directory / "config" / "configure.json", "config/configure.json")
+        config_tree.add("+ config/configure.json")
+        
+        # 添加 demos 目录
+        demos_tree = tree.add("Demos 文件")
+        demos_dir = directory / "demos"
+        if demos_dir.exists() and demos_dir.is_dir():
+            for demos_file in demos_dir.rglob('*'):
+                if demos_file.is_file():
+                    zipf.write(demos_file, demos_file.relative_to(directory))
+                    demos_tree.add(f"+ {demos_file.relative_to(directory)}")
+        
+        # 根据类型添加不同的文件
+        md_tree = tree.add("其他文件")
+        if config_type == "kit":
+            # kit 类型需要添加的文件
+            other_files = ["long_description.md", "input.json"]
+        else:
+            # agent 类型需要添加的文件
+            other_files = ["initial_assistant_message.md", "initial_system_prompt.md", "long_description.md"]
+        
+        for file in other_files:
+            file_path = directory / "config" / file
+            if file_path.exists():
+                zipf.write(file_path, f"config/{file}")
+                md_tree.add(f"+ config/{file}")
+    
+    tree.add("✅ 压缩包创建完成")
+    console.print(tree)
+    return zip_name
+
+def build_package(directory: Path) -> Tuple[bool, List[str], str]:
+    """构建项目包
+    
+    Returns:
+        Tuple[bool, List[str], str]: (是否成功, 错误信息列表, zip包名称)
+    """
+    console.print(Panel.fit(
+        "[bold blue]🚀 开始构建项目包[/bold blue]",
+        border_style="blue"
+    ))
+    
+    all_passed = True
+    all_errors = []
+    
+    # 1. 检查 Python 文件
+    py_passed, py_errors = check_python_files(directory)
+    if not py_passed:
+        all_passed = False
+        all_errors.extend(py_errors)
+    
+    # 2. 检查配置文件
+    config_passed, config_errors = check_configuration(directory)
+    if not config_passed:
+        all_passed = False
+        all_errors.extend(config_errors)
+    
+    # 3. 检查 Markdown 文件
+    md_passed, md_errors = check_markdown_files(directory)
+    if not md_passed:
+        all_passed = False
+        all_errors.extend(md_errors)
+    
+    # 如果所有检查都通过，创建 zip 包
+    zip_name = ""
+    if all_passed:
+        zip_name = create_zip_package(directory)
+    
+    if all_passed:
+        console.print(Panel.fit(
+            f"[bold green]✅ 构建成功！[/bold green]\n"
+            f"压缩包: {zip_name}",
+            border_style="green"
+        ))
+    else:
+        console.print(Panel.fit(
+            "[bold red]❌ 构建失败！[/bold red]\n" + "\n".join(all_errors),
+            border_style="red"
+        ))
+    
+    return all_passed, all_errors, zip_name 

adam_community-0.0.4/adam_community/cli/cli.py

@@ -0,0 +1,48 @@
+import click
+import json
+from pathlib import Path
+from .parser import parse_directory
+from .build import build_package
+from .init import init
+
+@click.group()
+def cli():
+    """Adam Community CLI 工具"""
+    pass
+
+@cli.command()
+@click.argument('directory', type=click.Path(exists=True, file_okay=False, dir_okay=True), default='.')
+def parse(directory):
+    """解析指定目录下的所有 Python 文件并生成 functions.json"""
+    directory_path = Path(directory)
+    all_functions = parse_directory(directory_path)
+    
+    # 将结果写入 functions.json
+    output_file = directory_path / 'functions.json'
+    with open(output_file, 'w', encoding='utf-8') as f:
+        json.dump(all_functions, f, indent=2, ensure_ascii=False)
+    
+    click.echo(f"已成功解析 {len(all_functions)} 个类，结果保存在 {output_file}")
+
+@cli.command()
+@click.argument('directory', type=click.Path(exists=True, file_okay=False, dir_okay=True), default='.')
+def build(directory):
+    """构建项目包"""
+    directory_path = Path(directory)
+    
+    # 执行构建
+    success, errors, zip_name = build_package(directory_path)
+    
+    if success:
+        click.echo(f"包创建成功: {zip_name}")
+    else:
+        click.echo("检查未通过，发现以下问题：")
+        for error in errors:
+            click.echo(f"- {error}")
+        raise click.Abort()
+
+# 添加 init 命令
+cli.add_command(init)
+
+if __name__ == '__main__':
+    cli()

adam_community-0.0.4/adam_community/cli/init.py

@@ -0,0 +1,154 @@
+import click
+import re
+from pathlib import Path
+from jinja2 import Environment, FileSystemLoader
+from typing import Dict, Any
+
+@click.command()
+@click.option('--name', prompt='项目名称（仅支持字母、数字、连字符，不能有空格）', help='项目的英文名称（用于文件夹和配置）')
+@click.option('--display-name', prompt='显示名称', help='项目的中文显示名称')  
+@click.option('--description', prompt='项目描述', help='项目的简短描述')
+@click.option('--version', default='1.0.0', prompt='版本号', help='项目版本号')
+@click.option('--author', prompt='作者', help='项目作者')
+@click.option('--type', 
+              type=click.Choice(['kit', 'toolbox']), 
+              prompt='项目类型',
+              help='选择项目类型: kit(表单工具) 或 toolbox(智能体工具)')
+@click.argument('directory', type=click.Path(exists=True, file_okay=False, dir_okay=True), default='.')
+def init(name: str, display_name: str, description: str, version: str, author: str, type: str, directory: str):
+    """初始化一个新的 Adam 工具项目"""
+    
+    # 验证项目名称格式
+    if not validate_project_name(name):
+        click.echo(f"错误: 项目名称 '{name}' 格式不正确")
+        click.echo("项目名称只能包含字母、数字和连字符(-)，不能包含空格或其他特殊字符")
+        click.echo("示例: my-tool, data-processor, image-analyzer")
+        return
+    
+    directory_path = Path(directory)
+    project_path = directory_path / name
+    
+    # 检查目录是否已存在
+    if project_path.exists():
+        click.echo(f"错误: 目录 '{name}' 已存在")
+        return
+    
+    # 创建项目目录
+    project_path.mkdir(parents=True, exist_ok=True)
+    click.echo(f"创建项目目录: {project_path}")
+    
+    # 创建config目录
+    config_path = project_path / "config"
+    config_path.mkdir(parents=True, exist_ok=True)
+    
+    # 设置Jinja2环境
+    template_dir = Path(__file__).parent / "templates"
+    env = Environment(loader=FileSystemLoader(template_dir))
+    
+    # 模板变量
+    template_vars = {
+        'name': name,
+        'display_name': display_name,
+        'description': description,
+        'version': version,
+        'author': author,
+        'project_type': type
+    }
+    
+    # 生成配置文件
+    render_and_save(env, 'configure.json.j2', config_path / "configure.json", template_vars)
+    click.echo(f"生成配置文件: config/configure.json")
+    
+    # 生成描述文件
+    render_and_save(env, 'long_description.md.j2', config_path / "long_description.md", template_vars)
+    click.echo(f"生成描述文件: config/long_description.md")
+    
+    if type == 'kit':
+        generate_kit_files(env, project_path, config_path, template_vars)
+    else:
+        generate_toolbox_files(env, project_path, config_path, template_vars)
+    
+    # 生成 Makefile
+    render_and_save(env, 'Makefile.j2', project_path / "Makefile", template_vars)
+    click.echo(f"生成构建脚本: Makefile")
+    
+    # 生成 README 文件
+    if type == 'kit':
+        render_and_save(env, 'README_kit.md.j2', project_path / "README.md", template_vars)
+    else:
+        render_and_save(env, 'README_toolbox.md.j2', project_path / "README.md", template_vars)
+    click.echo(f"生成项目文档: README.md")
+    
+    click.echo(f"\n✅ 项目 '{name}' 初始化完成!")
+    click.echo(f"📁 项目路径: {project_path}")
+    click.echo("\n📋 后续步骤:")
+    click.echo("1. 📖 阅读 README.md 了解详细的开发指南")
+    click.echo("2. 🔧 根据需要修改 Python 代码实现")
+    if type == 'kit':
+        click.echo("3. 📝 自定义 config/input.json 表单配置")
+    else:
+        click.echo("3. 🤖 自定义 config/initial_system_prompt.md 和 config/initial_assistant_message.md")
+    click.echo("4. 📄 完善 config/long_description.md 描述文档")
+    click.echo("5. ⚙️ 运行 'make parse' 生成 functions.json")
+    click.echo("6. 📦 运行 'make build' 打包项目")
+    click.echo(f"\n💡 详细的开发指南请查看: {project_path}/README.md")
+
+
+def render_and_save(env: Environment, template_name: str, output_path: Path, template_vars: Dict[str, Any]):
+    """渲染模板并保存到文件"""
+    template = env.get_template(template_name)
+    content = template.render(**template_vars)
+    with open(output_path, 'w', encoding='utf-8') as f:
+        f.write(content)
+
+
+def generate_kit_files(env: Environment, project_path: Path, config_path: Path, template_vars: Dict[str, Any]):
+    """生成 kit 项目的特定文件"""
+    
+    # 生成 input.json 表单配置
+    render_and_save(env, 'input.json.j2', config_path / "input.json", template_vars)
+    click.echo(f"生成表单配置: config/input.json")
+    
+    # 生成主要的Python实现文件
+    python_filename = f"{template_vars['name'].replace('-', '_')}.py"
+    render_and_save(env, 'kit_python.py.j2', project_path / python_filename, template_vars)
+    click.echo(f"生成主要实现文件: {python_filename}")
+
+
+def generate_toolbox_files(env: Environment, project_path: Path, config_path: Path, template_vars: Dict[str, Any]):
+    """生成 toolbox 项目的特定文件"""
+    
+    # 生成 initial_system_prompt.md
+    render_and_save(env, 'initial_system_prompt.md.j2', config_path / "initial_system_prompt.md", template_vars)
+    click.echo(f"生成系统提示文件: config/initial_system_prompt.md")
+    
+    # 生成 initial_assistant_message.md
+    render_and_save(env, 'initial_assistant_message.md.j2', config_path / "initial_assistant_message.md", template_vars)
+    click.echo(f"生成助手消息文件: config/initial_assistant_message.md")
+    
+    # 生成主要的Python实现文件
+    python_filename = f"{template_vars['name'].replace('-', '_')}.py"
+    render_and_save(env, 'toolbox_python.py.j2', project_path / python_filename, template_vars)
+    click.echo(f"生成主要实现文件: {python_filename}")
+
+
+def validate_project_name(name: str) -> bool:
+    """验证项目名称格式"""
+    # 项目名称只能包含字母、数字和连字符，不能有空格
+    pattern = r'^[a-zA-Z0-9-]+$'
+    if not re.match(pattern, name):
+        return False
+    
+    # 不能以连字符开始或结束
+    if name.startswith('-') or name.endswith('-'):
+        return False
+    
+    # 不能有连续的连字符
+    if '--' in name:
+        return False
+    
+    # 长度限制
+    if len(name) < 1 or len(name) > 50:
+        return False
+    
+    return True