prism-agent 0.2.1__tar.gz

prism_agent-0.2.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 PRISM Agent
+
+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.

prism_agent-0.2.1/PKG-INFO

@@ -0,0 +1,223 @@
+Metadata-Version: 2.4
+Name: prism-agent
+Version: 0.2.1
+Summary: 统一 AI Agent CLI：整合 Hermes/Codex/OpenClaw 能力
+Author-email: PRISM Agent <prism@example.com>
+License: MIT License
+        
+        Copyright (c) 2026 PRISM Agent
+        
+        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.
+        
+Project-URL: Homepage, https://github.com/jz616059669/prism-agent
+Project-URL: Documentation, https://github.com/jz616059669/prism-agent#readme
+Project-URL: Repository, https://github.com/jz616059669/prism-agent.git
+Project-URL: Issues, https://github.com/jz616059669/prism-agent/issues
+Project-URL: Changelog, https://github.com/jz616059669/prism-agent/blob/master/CHANGELOG.md
+Keywords: ai,agent,cli,llm,openai,playwright,mcp,gateway
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Environment :: X11 Applications :: Qt
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: System :: Distributed Computing
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: rich>=13.0
+Requires-Dist: pyyaml>=6.0
+Requires-Dist: python-dotenv>=1.0
+Requires-Dist: openai>=1.0
+Requires-Dist: httpx>=0.27
+Requires-Dist: click>=8.1
+Requires-Dist: prompt-toolkit>=3.0
+Provides-Extra: browser
+Requires-Dist: playwright>=1.60.0; extra == "browser"
+Requires-Dist: nest-asyncio>=1.6.0; extra == "browser"
+Provides-Extra: desktop
+Requires-Dist: flet>=0.24.0; extra == "desktop"
+Provides-Extra: dev
+Requires-Dist: pytest>=9.1.1; extra == "dev"
+Requires-Dist: playwright>=1.60.0; extra == "dev"
+Requires-Dist: nest-asyncio>=1.6.0; extra == "dev"
+Provides-Extra: all
+Requires-Dist: prism-agent[browser,desktop]; extra == "all"
+Dynamic: license-file
+
+# PRISM Agent
+
+**统一 AI Agent CLI + 桌面客户端 — 整合 Hermes + Codex + OpenClaw 能力**
+
+## 一键安装
+
+**Windows：**
+```powershell
+git clone https://github.com/jz616059669/prism-agent.git
+cd prism-agent
+.\scripts\install.ps1
+```
+
+Windows 额外支持：
+```powershell
+# 打包桌面客户端
+.\scripts\build-windows.ps1
+
+# 后台运行 Gateway（NSSM）
+nssm install PrismGateway "C:\path\to\prism.exe" "gateway start"
+nssm start PrismGateway
+```
+
+**macOS：**
+```bash
+git clone https://github.com/jz616059669/prism-agent.git
+cd prism-agent
+bash scripts/install.sh
+```
+
+macOS 额外支持：
+```bash
+# 打包桌面客户端
+bash scripts/build-macos.sh
+
+# 安装 launchd 服务（后台运行 Gateway）
+cp scripts/com.prism.gateway.plist ~/Library/LaunchAgents/
+launchctl load ~/Library/LaunchAgents/com.prism.gateway.plist
+launchctl list | grep prism
+```
+
+**Linux（Ubuntu/Debian/Fedora/Arch）：**
+```bash
+git clone https://github.com/jz616059669/prism-agent.git
+cd prism-agent
+bash scripts/install.sh
+```
+
+Linux 额外支持：
+```bash
+# 打包桌面客户端
+bash scripts/build-linux.sh
+
+# 安装 systemd 服务（后台运行 Gateway）
+sudo cp scripts/prism-gateway.service /etc/systemd/system/
+sudo systemctl enable prism-gateway
+sudo systemctl start prism-gateway
+```
+
+安装完成后：
+```bash
+prism --help           # CLI
+prism-desktop          # 桌面客户端
+```
+
+## 手动安装
+
+见 [INSTALL.md](INSTALL.md)
+
+## 当前能力
+
+| 能力 | 状态 | 说明 |
+|---|---|---|
+| 统一模型接口 | ✅ | 一个命令切换任意模型，自动降级 |
+| 多 Key 轮转 | ✅ | 凭证池自动轮转，不怕单 Key 失效 |
+| 文件/终端工具 | ✅ | 读写、补丁、shell、后台任务 |
+| 浏览器控制 | ✅ | Playwright 驱动，支持导航、快照、点击、输入、截图 |
+| 代码执行沙箱 | ✅ | Python 代码执行，支持超时和输出捕获 |
+| MCP 客户端 | ✅ | stdio / HTTP 双模式 |
+| Skills 系统 | ✅ | 6 个内置 skill，支持安装/移除 |
+| Gateway | ✅ | 飞书 / Telegram / Discord 适配器 |
+| CLI 子命令 | ✅ | gateway / skill / browser / config / chat / ask / tools |
+
+## 快速开始
+
+```bash
+# 查看版本
+prism version
+
+# 列出工具
+prism tools
+
+# 列出 skills
+prism skill list
+
+# 打开网页
+prism browser open https://example.com
+
+# 单次提问
+prism ask "用 Python 写一个快速排序"
+
+# 交互聊天
+prism chat
+
+# 启动桌面客户端
+prism-desktop
+```
+
+## Gateway
+
+```bash
+# 查看状态
+prism gateway status
+
+# 前台运行
+prism gateway start --platform telegram --token <TOKEN>
+prism gateway start --platform feishu --app-id <ID> --app-secret <SECRET>
+
+# Linux 后台运行（systemd）
+sudo cp scripts/prism-gateway.service /etc/systemd/system/
+sudo systemctl enable prism-gateway
+sudo systemctl start prism-gateway
+sudo systemctl status prism-gateway
+
+# macOS 后台运行（launchd）
+cp scripts/com.prism.gateway.plist ~/Library/LaunchAgents/
+launchctl load ~/Library/LaunchAgents/com.prism.gateway.plist
+launchctl list | grep prism
+```
+
+## 配置
+
+```bash
+prism config set model.default step-3.7-flash
+prism config get model.default
+prism config get
+```
+
+## 开发
+
+```bash
+git clone https://github.com/jz616059669/prism-agent.git
+cd prism-agent
+pip install -e .
+pytest
+```
+
+## 路线图
+
+- 飞书 / Telegram / Discord 真实连接验证
+- MCP 服务器连接测试
+- Skills 市场 / 一键安装
+- 浏览器测试套件完善
+- ACP 协议支持

prism_agent-0.2.1/README.md

@@ -0,0 +1,154 @@
+# PRISM Agent
+
+**统一 AI Agent CLI + 桌面客户端 — 整合 Hermes + Codex + OpenClaw 能力**
+
+## 一键安装
+
+**Windows：**
+```powershell
+git clone https://github.com/jz616059669/prism-agent.git
+cd prism-agent
+.\scripts\install.ps1
+```
+
+Windows 额外支持：
+```powershell
+# 打包桌面客户端
+.\scripts\build-windows.ps1
+
+# 后台运行 Gateway（NSSM）
+nssm install PrismGateway "C:\path\to\prism.exe" "gateway start"
+nssm start PrismGateway
+```
+
+**macOS：**
+```bash
+git clone https://github.com/jz616059669/prism-agent.git
+cd prism-agent
+bash scripts/install.sh
+```
+
+macOS 额外支持：
+```bash
+# 打包桌面客户端
+bash scripts/build-macos.sh
+
+# 安装 launchd 服务（后台运行 Gateway）
+cp scripts/com.prism.gateway.plist ~/Library/LaunchAgents/
+launchctl load ~/Library/LaunchAgents/com.prism.gateway.plist
+launchctl list | grep prism
+```
+
+**Linux（Ubuntu/Debian/Fedora/Arch）：**
+```bash
+git clone https://github.com/jz616059669/prism-agent.git
+cd prism-agent
+bash scripts/install.sh
+```
+
+Linux 额外支持：
+```bash
+# 打包桌面客户端
+bash scripts/build-linux.sh
+
+# 安装 systemd 服务（后台运行 Gateway）
+sudo cp scripts/prism-gateway.service /etc/systemd/system/
+sudo systemctl enable prism-gateway
+sudo systemctl start prism-gateway
+```
+
+安装完成后：
+```bash
+prism --help           # CLI
+prism-desktop          # 桌面客户端
+```
+
+## 手动安装
+
+见 [INSTALL.md](INSTALL.md)
+
+## 当前能力
+
+| 能力 | 状态 | 说明 |
+|---|---|---|
+| 统一模型接口 | ✅ | 一个命令切换任意模型，自动降级 |
+| 多 Key 轮转 | ✅ | 凭证池自动轮转，不怕单 Key 失效 |
+| 文件/终端工具 | ✅ | 读写、补丁、shell、后台任务 |
+| 浏览器控制 | ✅ | Playwright 驱动，支持导航、快照、点击、输入、截图 |
+| 代码执行沙箱 | ✅ | Python 代码执行，支持超时和输出捕获 |
+| MCP 客户端 | ✅ | stdio / HTTP 双模式 |
+| Skills 系统 | ✅ | 6 个内置 skill，支持安装/移除 |
+| Gateway | ✅ | 飞书 / Telegram / Discord 适配器 |
+| CLI 子命令 | ✅ | gateway / skill / browser / config / chat / ask / tools |
+
+## 快速开始
+
+```bash
+# 查看版本
+prism version
+
+# 列出工具
+prism tools
+
+# 列出 skills
+prism skill list
+
+# 打开网页
+prism browser open https://example.com
+
+# 单次提问
+prism ask "用 Python 写一个快速排序"
+
+# 交互聊天
+prism chat
+
+# 启动桌面客户端
+prism-desktop
+```
+
+## Gateway
+
+```bash
+# 查看状态
+prism gateway status
+
+# 前台运行
+prism gateway start --platform telegram --token <TOKEN>
+prism gateway start --platform feishu --app-id <ID> --app-secret <SECRET>
+
+# Linux 后台运行（systemd）
+sudo cp scripts/prism-gateway.service /etc/systemd/system/
+sudo systemctl enable prism-gateway
+sudo systemctl start prism-gateway
+sudo systemctl status prism-gateway
+
+# macOS 后台运行（launchd）
+cp scripts/com.prism.gateway.plist ~/Library/LaunchAgents/
+launchctl load ~/Library/LaunchAgents/com.prism.gateway.plist
+launchctl list | grep prism
+```
+
+## 配置
+
+```bash
+prism config set model.default step-3.7-flash
+prism config get model.default
+prism config get
+```
+
+## 开发
+
+```bash
+git clone https://github.com/jz616059669/prism-agent.git
+cd prism-agent
+pip install -e .
+pytest
+```
+
+## 路线图
+
+- 飞书 / Telegram / Discord 真实连接验证
+- MCP 服务器连接测试
+- Skills 市场 / 一键安装
+- 浏览器测试套件完善
+- ACP 协议支持

prism_agent-0.2.1/prism/__init__.py

@@ -0,0 +1,5 @@
+"""
+PRISM Agent - 统一 AI Agent CLI
+"""
+
+__version__ = "0.1.0"

prism_agent-0.2.1/prism/acp/__init__.py

@@ -0,0 +1,5 @@
+"""PRISM ACP"""
+
+from prism.acp.client import ACPClient
+
+__all__ = ['ACPClient']

prism_agent-0.2.1/prism/acp/client.py

@@ -0,0 +1,63 @@
+"""
+PRISM Agent - ACP (Agent Communication Protocol) 客户端
+提供与 ACP 兼容 agent 通信的能力
+"""
+
+import json
+import subprocess
+from typing import Any, Dict, Optional
+
+
+class ACPClient:
+    """
+    ACP 客户端
+    通过 stdio 与 ACP 兼容 agent 通信
+    """
+    
+    def __init__(self, command: str, args: Optional[list] = None):
+        self.command = command
+        self.args = args or []
+        self.process: Optional[subprocess.Popen] = None
+    
+    def start(self) -> Dict[str, Any]:
+        try:
+            self.process = subprocess.Popen(
+                [self.command] + self.args,
+                stdin=subprocess.PIPE,
+                stdout=subprocess.PIPE,
+                stderr=subprocess.PIPE,
+                text=True,
+                bufsize=1,
+            )
+            return {'success': True}
+        except Exception as e:
+            return {'success': False, 'error': str(e)}
+    
+    def send(self, payload: Dict[str, Any]) -> Dict[str, Any]:
+        if not self.process:
+            return {'success': False, 'error': 'ACP client not started'}
+        
+        try:
+            request = json.dumps({'jsonrpc': '2.0', 'id': 1, **payload}) + '\n'
+            self.process.stdin.write(request)
+            self.process.stdin.flush()
+            response_line = self.process.stdout.readline()
+            if not response_line:
+                return {'success': False, 'error': 'No response from ACP agent'}
+            response = json.loads(response_line)
+            if 'result' in response:
+                return {'success': True, 'result': response['result']}
+            if 'error' in response:
+                return {'success': False, 'error': response['error'].get('message', 'Unknown error')}
+            return {'success': False, 'error': 'Invalid ACP response'}
+        except Exception as e:
+            return {'success': False, 'error': str(e)}
+    
+    def close(self):
+        if self.process:
+            try:
+                self.process.terminate()
+                self.process.wait(timeout=5)
+            except Exception:
+                pass
+            self.process = None

prism_agent-0.2.1/prism/agent.py

@@ -0,0 +1,144 @@
+"""
+PRISM Agent - 核心Agent循环
+整合 Hermes 的上下文压缩 + Codex 的工具调用 + OpenClaw 的浏览器控制
+"""
+
+import json
+import os
+import logging
+from typing import List, Dict, Any, Optional, Callable
+from dataclasses import dataclass, field
+from datetime import datetime
+
+from prism.providers.manager import provider_pool
+from prism.tools.registry import registry
+
+logger = logging.getLogger("prism.agent")
+
+
+@dataclass
+class Message:
+    """消息结构"""
+    role: str  # system | user | assistant | tool
+    content: str
+    timestamp: datetime = field(default_factory=datetime.now)
+    metadata: Dict[str, Any] = field(default_factory=dict)
+
+
+@dataclass
+class ToolCall:
+    """工具调用"""
+    id: str
+    name: str
+    arguments: Dict[str, Any]
+    result: Optional[Dict[str, Any]] = None
+
+
+class Agent:
+    """
+    PRISM Agent 核心
+    整合：
+    - Hermes 的 Skills 系统
+    - Codex 的代码执行能力
+    - OpenClaw 的浏览器自动化
+    - 统一的模型调用接口
+    """
+    
+    def __init__(self, system_prompt: Optional[str] = None):
+        self.messages: List[Message] = []
+        self.tool_calls: List[ToolCall] = []
+        self.system_prompt = system_prompt or self._default_system_prompt()
+        self.max_turns = 150
+        self.tools_enabled = True
+        
+        # 初始化系统消息
+        self.messages.append(Message(
+            role="system",
+            content=self.system_prompt,
+        ))
+    
+    def _default_system_prompt(self) -> str:
+        """默认系统提示词"""
+        return """你是 PRISM Agent，一个强大的 AI 助手。
+
+你可以：
+1. 读写文件、执行命令
+2. 搜索网页、控制浏览器
+3. 执行 Python 代码
+4. 管理定时任务
+5. 发送消息到 Telegram/Discord/飞书
+
+原则：
+- 先理解用户需求，再执行
+- 复杂任务拆成步骤
+- 遇到问题主动报告，不要隐瞒
+- 安全第一，危险操作先确认
+"""
+    
+    def chat(self, user_message: str) -> str:
+        """
+        发送消息并获取回复
+        整合了：
+        - Hermes 的上下文管理
+        - Codex 的函数调用
+        - OpenClaw 的工具执行
+        """
+        # 添加用户消息
+        self.messages.append(Message(role="user", content=user_message))
+        
+        # 构建 API 消息格式
+        api_messages = [
+            {"role": m.role, "content": m.content}
+            for m in self.messages
+        ]
+        
+        # 调用模型
+        result = provider_pool.chat(api_messages)
+        
+        if not result.get('success'):
+            logger.warning("chat failed: %s", result.get('error'))
+            return f"Error: {result.get('error', 'Unknown error')}"
+        
+        assistant_content = result.get('content', '')
+        logger.info("chat success model=%s", result.get('model'))
+        
+        # 添加助手回复
+        self.messages.append(Message(role="assistant", content=assistant_content))
+        
+        return assistant_content
+    
+    def execute_tool(self, tool_name: str, **kwargs) -> Dict[str, Any]:
+        """
+        执行工具
+        整合了 Codex 的终端执行 + OpenClaw 的浏览器控制
+        """
+        if not self.tools_enabled:
+            return {'success': False, 'error': 'Tools disabled'}
+        
+        logger.info("execute tool=%s args=%s", tool_name, kwargs)
+        result = registry.execute(tool_name, **kwargs)
+        logger.info("execute tool=%s result=%s", tool_name, result.get('success'))
+        
+        # 记录工具调用
+        self.tool_calls.append(ToolCall(
+            id=f"call_{len(self.tool_calls)}",
+            name=tool_name,
+            arguments=kwargs,
+            result=result,
+        ))
+        
+        return result
+    
+    def list_tools(self) -> List[Dict[str, str]]:
+        """列出可用工具"""
+        return registry.list_tools()
+    
+    def clear_history(self):
+        """清空对话历史"""
+        self.messages = [self.messages[0]]  # 保留系统消息
+        self.tool_calls = []
+
+
+def create_agent(system_prompt: Optional[str] = None) -> Agent:
+    """创建 Agent 实例"""
+    return Agent(system_prompt=system_prompt)