adam-community 1.0.5__tar.gz → 1.0.7__tar.gz

{adam_community-1.0.5 → adam_community-1.0.7}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.2
 Name: adam_community
-Version: 1.0.5
+Version: 1.0.7
 Summary: Adam Community Tools and Utilities
 Home-page: https://github.com/yourusername/adam-community
 Author: Adam Community
@@ -16,6 +16,7 @@ Requires-Dist: docstring-parser>=0.15
 Requires-Dist: rich>=13.0.0
 Requires-Dist: packaging>=21.0
 Requires-Dist: jsonschema>=4.0.0
+Requires-Dist: jinja2>=3.0.0
 Dynamic: author
 Dynamic: author-email
 Dynamic: classifier

adam_community-1.0.7/adam_community/__version__.py

@@ -0,0 +1 @@
+__version__ = "1.0.7"

{adam_community-1.0.5 → adam_community-1.0.7}/adam_community/cli/parser.py

@@ -263,6 +263,31 @@ def validate_description_length(description: str, function_name: str, file_path:
             f"超过了1024字符限制。请缩短描述长度。"
         )
 
+def _inherits_from_tool(class_node: ast.ClassDef) -> bool:
+    """检查类是否继承了 adam_community.Tool
+    
+    Args:
+        class_node: AST 类定义节点
+        
+    Returns:
+        bool: 如果类继承了 adam_community.Tool 则返回 True，否则返回 False
+    """
+    for base in class_node.bases:
+        if isinstance(base, ast.Name):
+            # 直接继承 Tool 类
+            if base.id == 'Tool':
+                return True
+        elif isinstance(base, ast.Attribute):
+            # 继承 adam_community.Tool 或类似的形式
+            if (isinstance(base.value, ast.Name) and 
+                base.value.id == 'adam_community' and 
+                base.attr == 'Tool'):
+                return True
+            # 继承 Tool 类（可能是通过 from adam_community import Tool 导入的）
+            if base.attr == 'Tool':
+                return True
+    return False
+
 def parse_python_file(file_path: Path) -> List[Dict[str, Any]]:
     """解析单个 Python 文件，提取类信息
     
@@ -281,6 +306,10 @@ def parse_python_file(file_path: Path) -> List[Dict[str, Any]]:
         
         for node in ast.walk(tree):
             if isinstance(node, ast.ClassDef):
+                # 检查类是否继承了 adam_community.Tool
+                if not _inherits_from_tool(node):
+                    continue
+                
                 # 获取类的文档字符串
                 docstring = ast.get_docstring(node) or ""
                 

adam_community-1.0.7/adam_community/cli/templates/Makefile.j2

@@ -0,0 +1,10 @@
+build:
+	adam-cli build .
+
+parse:
+	adam-cli parse .
+
+clean:
+	rm -f functions.json *.zip
+
+.PHONY: build parse clean

adam_community-1.0.7/adam_community/cli/templates/README_kit.md.j2

@@ -0,0 +1,223 @@
+# {{ display_name }}
+
+{{ description }}
+
+这是一个基于 Adam Tool Protocol (ATP) 开发的 Kit 工具项目，通过表单界面为用户提供功能。
+
+## 项目信息
+
+- **项目名称**: {{ name }}
+- **显示名称**: {{ display_name }}
+- **版本**: {{ version }}
+- **作者**: {{ author }}
+- **类型**: Kit (表单工具)
+
+## 快速开始
+
+### 1. 环境准备
+
+确保你已经安装了 adam-community：
+
+```bash
+# 在项目根目录安装依赖
+cd /path/to/adam-community
+python setup.py develop
+```
+
+### 2. 开发工具流程
+
+#### 2.1 修改代码实现
+编辑 `{{ name.replace('-', '_') }}.py` 文件，实现你的业务逻辑：
+
+```python
+def call(self, kwargs):
+    # 获取表单输入参数
+    input_text = kwargs['args']['input_text']
+    
+    # TODO: 在这里实现你的主要逻辑
+    # 示例：处理输入文本
+    result = process_your_logic(input_text)
+    
+    # 生成报告文件 (Kit工具必须生成 report.md)
+    generate_report(result)
+    
+    return result
+```
+
+#### 2.2 自定义表单配置
+编辑 `config/input.json` 来配置用户输入表单：
+
+```json
+{
+  "formName": "你的表单名称",
+  "description": "表单说明",
+  "fields": [
+    {
+      "name": "input_field",
+      "label": "输入字段",
+      "type": "string",
+      "description": "字段说明",
+      "validation": {
+        "required": true,
+        "message": "错误提示"
+      }
+    }
+  ]
+}
+```
+
+支持的字段类型：
+- `string`: 文本输入
+- `number`: 数字输入
+- `boolean`: 布尔值
+- `select`: 单选下拉框
+- `multiselect`: 多选框
+- `file`: 文件上传
+- `date`: 日期选择
+- `object`: 对象（嵌套字段）
+- `array`: 数组
+
+#### 2.3 完善项目描述
+编辑 `config/long_description.md` 来完善项目的详细描述，包括：
+- 概览：工具的主要功能和用途
+- 特性：核心特性和优势
+- 指标：性能指标和使用统计
+
+### 3. 构建和测试
+
+#### 3.1 解析工具函数
+```bash
+# 生成 functions.json
+make parse
+```
+
+#### 3.2 构建项目包
+```bash
+# 构建 ZIP 包
+make build
+```
+
+#### 3.3 本地调试
+你可以通过以下方式进行本地调试：
+
+```python
+# 创建测试脚本 test_local.py
+from {{ name.replace('-', '_') }} import runner
+
+# 模拟参数
+test_kwargs = {
+    'args': {
+        'input_text': '测试输入'
+    },
+    'message': '用户消息',
+    'files': [],
+    'user': '测试用户',
+    'task_id': 'test_task'
+}
+
+# 创建工具实例并测试
+tool = runner()
+result = tool.call(test_kwargs)
+print(f"执行结果: {result}")
+
+# 测试输出显示
+output_kwargs = {
+    'stdout': '测试输出',
+    'stderr': '',
+    'exitcode': 0
+}
+display_text, file_list = tool.outputShow(output_kwargs)
+print(f"显示文本: {display_text}")
+print(f"文件列表: {file_list}")
+```
+
+### 4. 部署和发布
+
+#### 4.1 上传到平台
+1. 运行 `make build` 生成 ZIP 包
+2. 在 Adam 平台控制台选择生成的 ZIP 包
+3. 点击发布
+4. 设置为可见状态
+
+#### 4.2 测试工具
+1. 在平台的「工具」页面找到你的工具
+2. 填写表单测试功能
+3. 查看生成的报告和结果
+
+## 开发指南
+
+### Kit 工具特点
+- **表单驱动**: 用户通过填写表单提供输入参数
+- **报告生成**: 必须生成 `report.md` 文件作为结果展示
+- **文件输出**: 可以生成多个文件供用户下载
+- **同步执行**: 用户提交表单后同步执行并返回结果
+
+### 重要方法说明
+
+#### `call(self, kwargs)` - 核心执行方法
+- **必须实现**
+- 参数包含：`args`(表单数据)、`message`、`files`、`user`、`task_id`
+- 必须生成 `report.md` 文件
+- 返回处理结果
+
+#### `outputShow(self, kwargs)` - 输出显示格式
+- **可选实现**
+- 自定义用户看到的结果展示格式
+- 返回 `(display_text, file_list)` 元组
+- `file_list` 中的文件会提供给用户下载
+
+#### `summary(self, kwargs)` - AI摘要
+- **可选实现**
+- 为 AI 生成简短的执行摘要
+- 用于 AI 理解工具执行结果
+
+### 常见问题
+
+#### Q: 如何处理文件上传？
+A: 在表单配置中使用 `file` 类型字段，在 `call` 方法中通过 `kwargs['files']` 获取上传的文件列表。
+
+#### Q: 如何生成多个输出文件？
+A: 在 `call` 方法中创建多个文件，然后在 `outputShow` 方法的 `file_list` 中返回文件名列表。
+
+#### Q: 如何处理错误？
+A: 使用 `print()` 输出错误信息到 stderr，系统会自动捕获并显示给用户。
+
+#### Q: 如何调试代码？
+A: 创建本地测试脚本，模拟 `kwargs` 参数来测试你的工具逻辑。
+
+#### Q: 必须配置哪些属性？
+A: 以下属性是必填的：
+```python
+DISPLAY_NAME = "工具显示名称"  # 工具的显示名称
+NETWORK = True/False           # 是否需要网络访问
+CPU = 1                        # 需要的CPU数量（必填）
+GPU = 0                        # 需要的GPU数量（必填）
+SIF = "adam-base:1.0.0"       # 容器镜像（必填）
+```
+
+## 文件结构说明
+
+```
+{{ name }}/
+├── config/
+│   ├── configure.json      # 工具基本配置
+│   ├── input.json          # 表单配置
+│   └── long_description.md # 详细描述
+├── {{ name.replace('-', '_') }}.py         # 主要实现文件
+├── functions.json          # 自动生成的函数描述
+├── Makefile               # 构建脚本
+└── README.md              # 本文件
+```
+
+## 参考资源
+
+- [Adam Tool Protocol 文档](https://docs.example.com/atp)
+- [表单配置指南](https://docs.example.com/form-config)
+- [现有工具示例](https://github.com/example/adam-tools)
+
+## 贡献和支持
+
+如有问题或建议，请联系：{{ author }}
+
+---
+Generated by Adam CLI - {{ name }} v{{ version }}

adam_community-1.0.7/adam_community/cli/templates/README_toolbox.md.j2

@@ -0,0 +1,338 @@
+# {{ display_name }}
+
+{{ description }}
+
+这是一个基于 Adam Tool Protocol (ATP) 开发的 Toolbox 智能体项目，通过对话方式为用户提供智能化服务。
+
+## 项目信息
+
+- **项目名称**: {{ name }}
+- **显示名称**: {{ display_name }}
+- **版本**: {{ version }}
+- **作者**: {{ author }}
+- **类型**: Toolbox (智能体工具)
+
+## 快速开始
+
+### 1. 环境准备
+
+确保你已经安装了 adam-community：
+
+```bash
+# 在项目根目录安装依赖
+cd /path/to/adam-community
+python setup.py develop
+```
+
+### 2. 开发智能体流程
+
+#### 2.1 修改工具实现
+编辑 `{{ name.replace('-', '_') }}.py` 文件，实现你的工具逻辑。项目包含两种工具类型：
+
+**Bash 类型工具 (默认)**：
+```python
+class {{ name.replace("-", "_") }}_tool(Tool):
+    def call(self, kwargs):
+        # 获取用户输入参数
+        input_text = kwargs['args']['input_text']
+        
+        # 返回要执行的 bash 命令
+        bash_script = f'''
+        # 你的 bash 脚本
+        echo "处理: {input_text}"
+        # 添加你的命令...
+        '''
+        return bash_script
+```
+
+**Python 类型工具**：
+```python
+class {{ name.replace("-", "_") }}_advanced_tool(Tool, calltype="python"):
+    DISPLAY_NAME = "{{ display_name }}高级工具"
+    NETWORK = False     # 是否需要网络访问
+    CPU = 1            # 需要的CPU数量
+    GPU = 0            # 需要的GPU数量
+    SIF = "adam-base:1.0.0"  # 容器镜像
+    CONDA_ENV = "base"  # 指定运行环境
+    
+    def call(self, kwargs):
+        # Python 代码逻辑
+        result = your_python_logic()
+        
+        # 必须使用 print 输出结果
+        print(f"处理结果: {result}")
+```
+
+#### 2.2 配置智能体提示词
+编辑以下文件来配置智能体的行为：
+
+**`config/initial_system_prompt.md`** - 系统提示词：
+```markdown
+# 你的信息
+您是一位专业的{{ display_name }}专家...
+
+# 你的任务范围
+1. 理解用户需求
+2. 选择合适工具
+3. 执行操作
+4. 生成报告
+
+# 工作流程
+1. 分析需求
+2. 制定计划
+3. 执行工具
+4. 分析结果
+5. 生成报告
+```
+
+**`config/initial_assistant_message.md`** - 欢迎消息：
+```markdown
+# 欢迎使用{{ display_name }}工具！
+
+我可以帮助您：
+- 功能1：描述
+- 功能2：描述
+- 功能3：描述
+
+请告诉我您的需求...
+```
+
+#### 2.3 完善项目描述
+编辑 `config/long_description.md` 来完善项目的详细描述。
+
+### 3. 构建和测试
+
+#### 3.1 解析工具函数
+```bash
+# 生成 functions.json
+make parse
+```
+
+#### 3.2 构建项目包
+```bash
+# 构建 ZIP 包
+make build
+```
+
+#### 3.3 本地调试
+
+**测试 Bash 工具**：
+```python
+# 创建测试脚本 test_bash_tool.py
+from {{ name.replace('-', '_') }} import {{ name.replace("-", "_") }}_tool
+
+# 模拟参数
+test_kwargs = {
+    'args': {
+        'input_text': '测试输入',
+        'mode': 'basic'
+    },
+    'message': '用户消息',
+    'files': [],
+    'user': '测试用户',
+    'task_id': 'test_task'
+}
+
+# 测试工具
+tool = {{ name.replace("-", "_") }}_tool()
+bash_script = tool.call(test_kwargs)
+print(f"生成的 bash 脚本:\n{bash_script}")
+
+# 测试输出显示
+output_kwargs = {
+    'stdout': '命令执行输出',
+    'stderr': '',
+    'exitcode': 0
+}
+display_text, file_list = tool.outputShow(output_kwargs)
+print(f"显示文本:\n{display_text}")
+```
+
+**测试 Python 工具**：
+```python
+# 创建测试脚本 test_python_tool.py
+from {{ name.replace('-', '_') }} import {{ name.replace("-", "_") }}_advanced_tool
+
+# 模拟参数
+test_kwargs = {
+    'args': {
+        'input_file': 'test.txt',
+        'output_format': 'json'
+    }
+}
+
+# 测试工具
+tool = {{ name.replace("-", "_") }}_advanced_tool()
+tool.call(test_kwargs)  # Python工具直接执行
+```
+
+### 4. 部署和发布
+
+#### 4.1 上传到平台
+1. 运行 `make build` 生成 ZIP 包
+2. 在 Adam 平台控制台选择生成的 ZIP 包
+3. 点击发布
+4. 设置为可见状态
+
+#### 4.2 测试智能体
+1. 在平台的「智能体」页面找到你的智能体
+2. 通过对话方式测试功能
+3. 观察智能体如何调用你的工具
+
+## 开发指南
+
+### Toolbox 智能体特点
+- **对话驱动**: 用户通过自然语言对话与智能体交互
+- **工具调用**: 智能体根据需要调用相应的工具函数
+- **多轮对话**: 支持复杂的多轮对话场景
+- **智能决策**: AI 自动决定何时调用哪个工具
+
+### 工具类型说明
+
+#### Bash 工具 (`calltype = "bash"`)
+- 适用于系统命令、脚本执行、文件操作等
+- `call` 方法返回要执行的 bash 命令字符串
+- 系统会执行返回的命令并捕获输出
+
+#### Python 工具 (`calltype = "python"`)
+- 适用于复杂的 Python 逻辑、数据处理、API 调用等
+- `call` 方法直接执行 Python 代码
+- 必须使用 `print()` 输出结果
+- 需要指定 `CONDA_ENV` 运行环境
+
+### 重要配置项
+
+#### 工具属性（必填配置）
+```python
+DISPLAY_NAME = "工具显示名称"  # 工具的显示名称
+NETWORK = True/False           # 是否需要网络访问
+CPU = 1                        # 需要的CPU数量（必填）
+GPU = 0                        # 需要的GPU数量（必填）
+SIF = "adam-base:1.0.0"       # 容器镜像（必填）
+CONDA_ENV = "base"             # Conda环境（仅Python工具）
+```
+
+#### docstring 格式
+```python
+"""
+工具的功能描述
+
+:param str input_text: 必需参数描述
+:param str? mode: 可选参数描述（注意?标记）
+"""
+```
+
+### 重要方法说明
+
+#### `call(self, kwargs)` - 核心执行方法
+- **必须实现**
+- Bash工具：返回要执行的命令字符串
+- Python工具：直接执行逻辑并用print输出
+
+#### `inputShow(self, **kwargs)` - 输入显示
+- **可选实现**
+- 自定义用户看到的输入格式
+- 默认显示完整的命令或代码
+
+#### `outputShow(self, kwargs)` - 输出显示
+- **可选实现**  
+- 自定义用户看到的输出格式
+- 返回 `(display_text, file_list)` 元组
+
+#### `summary(self, kwargs)` - AI摘要
+- **可选实现**
+- 为 AI 生成执行摘要，用于后续决策
+- 控制输出长度，避免上下文过长
+
+#### `monitor(self, process, kwargs)` - 进度监控
+- **可选实现**
+- 监控长时间运行的任务进度
+- 设置 `kwargs["PIPELINE"]` 和 `kwargs["PROCESS"]`
+
+### 智能体提示词编写指南
+
+#### 系统提示词 (`initial_system_prompt.md`)
+- 定义智能体的身份和专业领域
+- 描述任务范围和工作流程
+- 设置工具调用的优先级和策略
+- 包含重要的注意事项和限制
+
+#### 欢迎消息 (`initial_assistant_message.md`)
+- 向用户介绍智能体的功能
+- 提供使用建议和最佳实践
+- 引导用户正确描述需求
+
+### 常见问题
+
+#### Q: 如何处理长时间运行的任务？
+A: 实现 `monitor` 方法来报告进度，或者将任务分解为多个步骤。
+
+#### Q: 如何让智能体调用特定工具？
+A: 在系统提示词中明确工具的使用场景和调用条件。
+
+#### Q: 如何处理错误和异常？
+A: 在工具中使用适当的错误处理，通过 stderr 输出错误信息。
+
+#### Q: 如何优化智能体的响应质量？
+A: 精心设计 docstring 和系统提示词，提供清晰的工具描述和使用指导。
+
+#### Q: Python工具的依赖如何管理？
+A: 确保指定的 CONDA_ENV 环境中安装了所有需要的依赖包。
+
+## 文件结构说明
+
+```
+{{ name }}/
+├── config/
+│   ├── configure.json              # 智能体基本配置
+│   ├── initial_system_prompt.md    # 系统提示词
+│   ├── initial_assistant_message.md # 欢迎消息
+│   └── long_description.md         # 详细描述
+├── {{ name.replace('-', '_') }}.py                 # 主要实现文件
+├── functions.json                  # 自动生成的工具描述
+├── Makefile                       # 构建脚本
+└── README.md                      # 本文件
+```
+
+## 调试技巧
+
+### 1. 单独测试工具
+创建独立的测试脚本来验证工具逻辑：
+
+```python
+# test_individual_tool.py
+if __name__ == "__main__":
+    from your_module import your_tool
+    
+    # 模拟真实调用场景
+    tool = your_tool()
+    result = tool.call(mock_kwargs)
+    print(result)
+```
+
+### 2. 输出调试信息
+在工具中添加详细的调试输出：
+
+```python
+def call(self, kwargs):
+    print(f"DEBUG: 收到参数: {kwargs}")
+    # 你的逻辑
+    print(f"DEBUG: 处理结果: {result}")
+    return result
+```
+
+### 3. 测试提示词效果
+在本地模拟对话场景，测试智能体的响应质量。
+
+## 参考资源
+
+- [Adam Tool Protocol 文档](https://docs.example.com/atp)
+- [智能体开发指南](https://docs.example.com/agent-guide)
+- [现有智能体示例](https://github.com/example/adam-tools)
+
+## 贡献和支持
+
+如有问题或建议，请联系：{{ author }}
+
+---
+Generated by Adam CLI - {{ name }} v{{ version }}

adam_community-1.0.7/adam_community/cli/templates/configure.json.j2

@@ -0,0 +1,10 @@
+{
+    "name": "{{ name }}",
+    "display_name": "{{ display_name }}",
+    "version": "{{ version }}",
+    "visible": true,
+    "description": "{{ description }}",
+    "type": "{% if project_type == 'kit' %}kit{% else %}agent{% endif %}",
+    "tags": ["python", "tool"],
+    "cover": "https://img.shields.io/badge/{{ name.replace('-', '_') }}-tool-blue"
+}

adam_community-1.0.7/adam_community/cli/templates/initial_assistant_message.md.j2

@@ -0,0 +1,21 @@
+# 欢迎使用{{ display_name }}工具！
+
+我是您的专业{{ display_name }}助手，可以帮助您完成以下任务：
+
+## 🔧 主要功能
+- 功能1: 基础处理功能
+- 功能2: 高级分析功能  
+- 功能3: 结果导出功能
+
+## 🚀 快速开始
+1. 描述您的需求
+2. 提供必要的输入数据
+3. 我将为您执行相应操作
+4. 获取详细的分析结果
+
+## 💡 使用建议
+- 请详细描述您的需求
+- 如有文件需要处理，请上传相关文件
+- 我会为您提供详细的操作步骤和结果分析
+
+现在，请告诉我您希望我为您做什么？

adam_community-1.0.7/adam_community/cli/templates/initial_system_prompt.md.j2

@@ -0,0 +1,22 @@
+# 你的信息
+您是一位专业的{{ display_name }}专家，具有丰富的经验和深厚的专业知识。您的任务是协助用户使用{{ display_name }}工具完成各种相关任务。
+
+# 你的任务范围
+1. 理解用户的需求和问题
+2. 选择合适的工具和方法
+3. 执行相关操作并生成结果
+4. 提供详细的分析和建议
+5. 生成规范的报告文档
+
+# 工作流程
+1. 仔细分析用户的需求
+2. 制定处理步骤和计划
+3. 执行相应的工具调用
+4. 分析处理结果
+5. 生成详细报告
+
+# 注意事项
+- 始终保持专业和准确
+- 对结果进行充分的验证
+- 及时报告异常和问题
+- 提供清晰的解释说明

adam_community-1.0.7/adam_community/cli/templates/input.json.j2

@@ -0,0 +1,25 @@
+{
+  "formName": "{{ display_name }}参数配置",
+  "description": "配置{{ display_name }}的运行参数",
+  "defaultValues": {
+    "input_text": "默认输入文本"
+  },
+  "formRules": {
+    "required": ["input_text"],
+    "customRules": []
+  },
+  "fields": [
+    {
+      "name": "input_text", 
+      "label": "输入文本",
+      "type": "string",
+      "description": "请输入要处理的文本内容",
+      "validation": {
+        "required": true,
+        "minLength": 1,
+        "maxLength": 1000,
+        "message": "输入文本不能为空，长度在1-1000字符之间"
+      }
+    }
+  ]
+}

adam_community-1.0.7/adam_community/cli/templates/kit_python.py.j2

@@ -0,0 +1,105 @@
+from adam_community.tool import Tool
+from adam_community.util import runCmd
+from datetime import datetime
+
+class runner(Tool):
+    """
+    {{ description }}
+    
+    :param str input_text: 输入的文本内容
+    """
+    
+    DISPLAY_NAME = "{{ display_name }}"
+    NETWORK = False  # 根据需要设置是否需要网络访问
+    CPU = 1  # 需要的CPU数量
+    GPU = 0  # 需要的GPU数量
+    SIF = "adam-base:1.0.0"  # 指定容器镜像（必填）
+    
+    def call(self, kwargs):
+        """
+        工具的主要实现函数
+        
+        Args:
+            kwargs: 包含args、message、files、user、task_id等参数的字典
+        
+        Returns:
+            执行结果
+        """
+        # 获取用户输入的参数
+        input_text = kwargs['args']['input_text']
+        
+        # TODO: 在这里实现你的主要逻辑
+        # 示例：简单的文本处理
+        processed_text = f"处理后的文本: {input_text}"
+        
+        # 生成报告（kit类型的工具需要生成report.md文件）
+        report_content = f"""# {{ display_name }} 处理报告
+
+## 输入内容
+{input_text}
+
+## 处理结果
+{processed_text}
+
+## 处理时间
+{datetime.now().strftime('%Y-%m-%d %H:%M:%S')}
+
+## 作者
+{{ author }}
+"""
+        
+        # 写入报告文件
+        with open('./report.md', 'w', encoding='utf-8') as f:
+            f.write(report_content)
+        
+        print(f"处理完成，输入文本: {input_text}")
+        print(f"处理结果: {processed_text}")
+        print("报告已生成: report.md")
+        
+        return processed_text
+    
+    def outputShow(self, kwargs):
+        """
+        自定义输出显示格式（可选）
+        
+        Args:
+            kwargs: 包含stdout、stderr、exitcode等的参数字典
+            
+        Returns:
+            (display_text, file_list): 显示文本和文件列表的元组
+        """
+        output = kwargs.get('stdout', '')
+        
+        # 自定义输出格式
+        display_text = f"""## 🎉 处理完成
+
+### 📋 处理结果
+```
+{output}
+```
+
+### 📄 生成文件
+- report.md: 详细处理报告
+"""
+        
+        # 返回生成的文件列表
+        file_list = ['report.md']
+        
+        return display_text, file_list
+    
+    def summary(self, kwargs):
+        """
+        为AI生成简短的执行摘要（可选）
+        
+        Args:
+            kwargs: 包含stdout、stderr、exitcode等的参数字典
+            
+        Returns:
+            str: 执行摘要文本
+        """
+        output = kwargs.get('stdout', '')
+        
+        if kwargs.get('stderr'):
+            return f"工具执行完成但有警告: {output}。警告信息: {kwargs['stderr']}"
+        else:
+            return f"工具执行成功: {output}"

adam_community-1.0.7/adam_community/cli/templates/long_description.md.j2

@@ -0,0 +1,61 @@
+<!-- 概览/特性/指标 这三个标题是固定的，没有可以留空，你的内容请从二级标题开始写 -->
+
+<!-- 必须保留 -->
+# 概览
+
+## {{ display_name }}
+{{ description }}
+
+这是一个基于 Adam Tool Protocol (ATP) 开发的工具，提供了完整的功能实现和用户界面。
+
+## 主要功能
+- 功能1: 描述主要功能
+- 功能2: 描述辅助功能  
+- 功能3: 描述扩展功能
+
+<!-- 建议保留 -->
+# 特性
+
+## 核心特性
+
+### 易用性
+- 简单直观的操作界面
+- 详细的操作说明文档
+- 完善的错误处理机制
+
+### 可靠性
+- 稳定的算法实现
+- 完整的测试覆盖
+- 详细的日志记录
+
+### 扩展性
+- 模块化的代码结构
+- 灵活的配置选项
+- 良好的接口设计
+
+<!-- 建议保留 -->
+# 指标
+
+## 性能指标
+
+| 指标 | 数值 | 说明 |
+|------|------|------|
+| 处理速度 | 待测试 | 平均处理时间 |
+| 准确率 | 待测试 | 处理准确率 |
+| 稳定性 | 待测试 | 系统稳定性 |
+
+## 使用统计
+
+| 类别 | 百分比 | 详情 |
+|------|--------|------|
+| 学术研究 | 40% | 高校科研院所 |
+| 工业应用 | 35% | 企业生产环境 |
+| 个人项目 | 25% | 个人学习研究 |
+
+## 系统要求
+
+| 组件 | 要求 | 说明 |
+|------|------|------|
+| Python版本 | >= 3.8 | 运行环境要求 |
+| 内存 | >= 2GB | 建议配置 |
+| 存储空间 | >= 1GB | 安装空间 |

adam_community-1.0.7/adam_community/cli/templates/toolbox_python.py.j2

@@ -0,0 +1,139 @@
+from adam_community.tool import Tool
+from adam_community.util import runCmd
+
+class {{ name.replace("-", "_") }}_tool(Tool):
+    """
+    {{ description }}
+    
+    :param str input_text: 输入的文本内容
+    :param str? mode: 处理模式，可选值：basic、advanced
+    """
+    
+    DISPLAY_NAME = "{{ display_name }}工具"
+    NETWORK = False  # 根据需要设置是否需要网络访问
+    CPU = 1  # 需要的CPU数量
+    GPU = 0  # 需要的GPU数量
+    SIF = "adam-base:1.0.0"  # 指定容器镜像（必填）
+    
+    def call(self, kwargs):
+        """
+        工具的主要实现函数
+        
+        Args:
+            kwargs: 包含args、message、files、user、task_id等参数的字典
+        
+        Returns:
+            执行结果字符串（bash命令）或直接执行结果
+        """
+        # 获取用户输入的参数
+        input_text = kwargs['args']['input_text']
+        mode = kwargs['args'].get('mode', 'basic')
+        
+        # TODO: 在这里实现你的主要逻辑
+        if mode == 'advanced':
+            result = f"高级模式处理: {input_text}"
+        else:
+            result = f"基础模式处理: {input_text}"
+        
+        # 生成bash命令
+        bash_script = f'''
+# {{ display_name }} 处理脚本
+echo "开始处理: {input_text}"
+echo "处理模式: {mode}"
+
+# TODO: 在这里添加实际的处理命令
+echo "{result}"
+
+# 生成输出文件
+echo "处理完成" > output.txt
+echo "结果: {result}" >> output.txt
+
+echo "处理完成，结果已保存到 output.txt"
+'''
+        
+        return bash_script
+    
+    def outputShow(self, kwargs):
+        """
+        自定义输出显示格式（可选）
+        """
+        stdout = kwargs.get('stdout', '')
+        stderr = kwargs.get('stderr', '')
+        
+        display_text = f"""## 🎉 {{ display_name }} 处理完成
+
+### 📋 处理结果
+```
+{stdout}
+```
+"""
+        
+        if stderr:
+            display_text += f"""
+### ⚠️ 警告信息
+```
+{stderr}
+```
+"""
+        
+        # 返回可能生成的文件
+        file_list = ['output.txt'] if 'output.txt' in stdout else []
+        
+        return display_text, file_list
+    
+    def summary(self, kwargs):
+        """
+        为AI生成简短的执行摘要
+        """
+        stdout = kwargs.get('stdout', '')
+        stderr = kwargs.get('stderr', '')
+        
+        if stderr:
+            return f"{{ display_name }}工具执行完成但有警告: {stdout[:200]}...。警告: {stderr[:100]}"
+        else:
+            return f"{{ display_name }}工具执行成功: {stdout[:200]}..."
+
+
+class {{ name.replace("-", "_") }}_advanced_tool(Tool, calltype="python"):
+    """
+    {{ description }} - 高级功能
+    
+    :param str input_file: 输入文件路径
+    :param str output_format: 输出格式，可选值：json、csv、txt
+    """
+    
+    DISPLAY_NAME = "{{ display_name }}高级工具"
+    NETWORK = False  # 根据需要设置是否需要网络访问
+    CPU = 1  # 需要的CPU数量
+    GPU = 0  # 需要的GPU数量
+    SIF = "adam-base:1.0.0"  # 指定容器镜像（必填）
+    CONDA_ENV = "base"  # 指定conda环境
+    
+    def call(self, kwargs):
+        """
+        Python类型工具的实现
+        """
+        import json
+        import datetime
+        
+        input_file = kwargs['args']['input_file']
+        output_format = kwargs['args'].get('output_format', 'json')
+        
+        # TODO: 在这里实现你的Python逻辑
+        result = {
+            'input_file': input_file,
+            'output_format': output_format,
+            'processed_at': datetime.datetime.now().isoformat(),
+            'result': 'Python工具处理完成'
+        }
+        
+        # 对于Python工具，必须使用print输出结果
+        print(f"Python工具处理完成，输入文件: {input_file}")
+        print(f"输出格式: {output_format}")
+        print(f"处理结果: {result}")
+        
+        # 生成输出文件
+        if output_format == 'json':
+            with open('result.json', 'w', encoding='utf-8') as f:
+                json.dump(result, f, indent=2, ensure_ascii=False)
+            print("结果已保存到 result.json")

{adam_community-1.0.5 → adam_community-1.0.7}/adam_community.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.2
 Name: adam_community
-Version: 1.0.5
+Version: 1.0.7
 Summary: Adam Community Tools and Utilities
 Home-page: https://github.com/yourusername/adam-community
 Author: Adam Community
@@ -16,6 +16,7 @@ Requires-Dist: docstring-parser>=0.15
 Requires-Dist: rich>=13.0.0
 Requires-Dist: packaging>=21.0
 Requires-Dist: jsonschema>=4.0.0
+Requires-Dist: jinja2>=3.0.0
 Dynamic: author
 Dynamic: author-email
 Dynamic: classifier

{adam_community-1.0.5 → adam_community-1.0.7}/adam_community.egg-info/SOURCES.txt

@@ -16,5 +16,15 @@ adam_community/cli/cli.py
 adam_community/cli/init.py
 adam_community/cli/parser.py
 adam_community/cli/updater.py
+adam_community/cli/templates/Makefile.j2
+adam_community/cli/templates/README_kit.md.j2
+adam_community/cli/templates/README_toolbox.md.j2
 adam_community/cli/templates/__init__.py
+adam_community/cli/templates/configure.json.j2
+adam_community/cli/templates/initial_assistant_message.md.j2
+adam_community/cli/templates/initial_system_prompt.md.j2
+adam_community/cli/templates/input.json.j2
+adam_community/cli/templates/kit_python.py.j2
+adam_community/cli/templates/long_description.md.j2
+adam_community/cli/templates/toolbox_python.py.j2
 test/test_util_tool.py

{adam_community-1.0.5 → adam_community-1.0.7}/adam_community.egg-info/requires.txt

@@ -4,3 +4,4 @@ docstring-parser>=0.15
 rich>=13.0.0
 packaging>=21.0
 jsonschema>=4.0.0
+jinja2>=3.0.0

{adam_community-1.0.5 → adam_community-1.0.7}/setup.py

@@ -12,6 +12,9 @@ setup(
     name="adam_community",
     version=get_version(),
     packages=find_packages(),
+    package_data={
+        'adam_community.cli.templates': ['*.j2'],
+    },
     install_requires=[
         "requests>=2.31.0",
         "click>=8.0.0",
@@ -19,6 +22,7 @@ setup(
         "rich>=13.0.0",
         "packaging>=21.0",
         "jsonschema>=4.0.0",
+        "jinja2>=3.0.0"
     ],
     entry_points={
         'console_scripts': [
@@ -37,4 +41,4 @@ setup(
         "Operating System :: OS Independent",
     ],
     python_requires=">=3.8",
-) 
+) 

adam_community-1.0.5/adam_community/__version__.py

@@ -1 +0,0 @@
-__version__ = "1.0.5"