hz-agent-base 0.1.0__tar.gz

hz_agent_base-0.1.0/.env-example

@@ -0,0 +1,59 @@
+# ============================================
+# HZAgentBase 配置文件
+# 复制此文件为 .env 并填入实际值
+# ============================================
+
+# --- 模型配置 ---
+# 默认模型，根据名称自动匹配提供商：
+#   deepseek-*         → DeepSeek
+#   gpt-* / o1-* / o3-* → OpenAI
+#   claude-*           → Anthropic（需 pip install langchain-anthropic）
+#   gemini-*           → Google Gemini（需 pip install langchain-google-genai）
+#   其他               → OpenAI 兼容（Ollama、vLLM 等本地服务）
+DEFAULT_MODEL=deepseek-v4-flash
+
+# API Key（统一配置，所有提供商共用）
+MODEL_API_KEY=sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
+
+# API Base URL（可选，通常不需要设置，各提供商有默认值）
+# 仅对 OpenAI 兼容 API 生效（DeepSeek、OpenAI、Ollama 等）
+# Anthropic 和 Gemini 使用各自的 SDK，不受此配置影响
+# 常用值：
+#   DeepSeek:  https://api.deepseek.com/v1（默认）
+#   OpenAI:    https://api.openai.com/v1（默认）
+#   Ollama:    http://localhost:11434/v1
+#   vLLM:      http://localhost:8000/v1
+# MODEL_BASE_URL=https://api.deepseek.com/v1
+
+# --- 容错配置 ---
+# LLM API 调用超时（秒，可选，默认: 600）
+# MODEL_REQUEST_TIMEOUT=600
+# LLM 调用失败重试次数（可选，默认: 2）
+# MODEL_MAX_RETRIES=2
+# Agent 最大执行步数，防止死循环（可选，默认: 25）
+# RECURSION_LIMIT=25
+
+# --- 权限配置 ---
+# 权限模式: default | plan | full_auto (可选, 默认: default)
+#   default   — 写操作需用户确认
+#   plan      — 阻止所有写操作（只读模式）
+#   full_auto — 允许所有操作（需谨慎使用）
+# PERMISSION_MODE=default
+
+# --- 记忆系统 ---
+# 记忆存储路径 (可选, 默认: .memory)
+# MEMORY_PATH=.memory
+
+# --- 文件审计 ---
+# 审计日志路径 (可选, 默认: .audit/audit.jsonl)
+# 开启方式: create_agent(filesystem=True)
+# AUDIT_LOG_PATH=.audit/audit.jsonl
+
+# --- 知识库 ---
+# 知识库每次检索条数 (可选, 默认: 5)
+# 需配合 retriever 参数使用: create_agent(retriever=your_retriever)
+# KNOWLEDGE_TOP_K=5
+
+# --- 日志 ---
+# 日志级别: DEBUG | INFO | WARNING | ERROR (可选, 默认: INFO)
+# LOG_LEVEL=INFO

hz_agent_base-0.1.0/.gitignore

@@ -0,0 +1,75 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+
+# Virtual environments
+.venv/
+**/.venv/
+venv/
+ENV/
+env/
+
+# IDE
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+.project
+.settings/
+
+# Testing
+.pytest_cache/
+.coverage
+htmlcov/
+.tox/
+.nox/
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Project specific
+.memory/
+.my_agent_memory/
+.audit/
+*.log
+tool_usage.log
+
+# 技术方案文档（不入库）
+*_plan.md
+
+# Secrets and credentials
+**/.env
+**/.env.*
+**/.env.local
+**/.env.production
+**/.env.staging
+*.pem
+*.key
+*.p12
+*.pfx
+credentials.json
+secrets.json
+service-account.json
+
+# Claude Code 会话数据
+.claude/

hz_agent_base-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 hz
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.