@agentunion/kite 1.4.0 → 1.6.0

package/extensions/services/dataclaw/ws/handler.py

@@ -0,0 +1,163 @@
+"""
+WebSocket 实时推送处理
+"""
+import asyncio
+import json
+from typing import Dict, Set
+
+from fastapi import APIRouter, WebSocket, WebSocketDisconnect
+
+router = APIRouter()
+
+# 全局连接注册表：agent_id -> set of WebSocket
+_connections: Dict[str, Set[WebSocket]] = {}
+# feed 订阅表：feed_id -> set of agent_id
+_feed_subscribers: Dict[str, Set[str]] = {}
+
+
+class ConnectionManager:
+    def __init__(self):
+        self._conns: Dict[str, Set[WebSocket]] = {}
+        self._subs: Dict[str, Set[str]] = {}  # feed_id -> agent_ids
+
+    async def connect(self, websocket: WebSocket, agent_id: str):
+        await websocket.accept()
+        if agent_id not in self._conns:
+            self._conns[agent_id] = set()
+        self._conns[agent_id].add(websocket)
+
+    def disconnect(self, websocket: WebSocket, agent_id: str):
+        if agent_id in self._conns:
+            self._conns[agent_id].discard(websocket)
+            if not self._conns[agent_id]:
+                del self._conns[agent_id]
+
+    def subscribe_feed(self, agent_id: str, feed_id: str):
+        if feed_id not in self._subs:
+            self._subs[feed_id] = set()
+        self._subs[feed_id].add(agent_id)
+
+    def unsubscribe_feed(self, agent_id: str, feed_id: str):
+        if feed_id in self._subs:
+            self._subs[feed_id].discard(agent_id)
+
+    async def broadcast_feed_update(self, feed_id: str, data: dict):
+        """当 feed 有新数据时，广播给所有订阅该 feed 的在线 agent"""
+        agent_ids = self._subs.get(feed_id, set())
+        msg = json.dumps({"type": "feed.update", "feed_id": feed_id, "data": data})
+        dead = []
+        for agent_id in agent_ids:
+            for ws in list(self._conns.get(agent_id, set())):
+                try:
+                    await ws.send_text(msg)
+                except Exception:
+                    dead.append((agent_id, ws))
+        for agent_id, ws in dead:
+            self.disconnect(ws, agent_id)
+
+    async def send_notification(self, agent_id: str, notif: dict):
+        """向指定 agent 发送通知"""
+        msg = json.dumps({"type": "notification", "data": notif})
+        for ws in list(self._conns.get(agent_id, set())):
+            try:
+                await ws.send_text(msg)
+            except Exception:
+                self.disconnect(ws, agent_id)
+
+    async def send_to_agent(self, agent_id: str, message: dict):
+        """向指定 agent 发送任意消息"""
+        msg = json.dumps(message)
+        for ws in list(self._conns.get(agent_id, set())):
+            try:
+                await ws.send_text(msg)
+            except Exception:
+                self.disconnect(ws, agent_id)
+
+
+# 全局连接管理器（单例）
+manager = ConnectionManager()
+
+
+@router.websocket("/ws")
+async def websocket_endpoint(websocket: WebSocket):
+    """
+    WebSocket 端点
+
+    连接后首帧需发送认证消息：
+    {"type": "auth", "api_key": "dc_live_xxx"}
+
+    认证成功后可发送订阅消息：
+    {"type": "subscribe", "feed_id": "feed_xxx"}
+    {"type": "unsubscribe", "feed_id": "feed_xxx"}
+    """
+    agent_id = None
+    try:
+        # 等待认证帧
+        await websocket.accept()
+        auth_text = await asyncio.wait_for(websocket.receive_text(), timeout=10.0)
+        auth_msg = json.loads(auth_text)
+
+        api_key = auth_msg.get("api_key") or auth_msg.get("token")
+        if auth_msg.get("type") != "auth" or not api_key:
+            await websocket.close(code=4001, reason="auth required")
+            return
+
+        # API Key / JWT 校验
+        from core.auth import decode_access_token
+        from utils.crypto import hash_api_key
+
+        payload = decode_access_token(api_key)
+        if payload:
+            agent_id = payload.get("sub")
+        elif api_key.startswith("dc_"):
+            from core.database import _async_session_factory
+            from sqlalchemy import text as sa_text
+            async with _async_session_factory() as sess:
+                row = (await sess.execute(
+                    sa_text("SELECT agent_id FROM api_keys WHERE key_hash=:h AND status='active' LIMIT 1"),
+                    {"h": hash_api_key(api_key)}
+                )).fetchone()
+                if row:
+                    agent_id = row.agent_id
+
+        if not agent_id:
+            await websocket.close(code=4003, reason="invalid api key")
+            return
+
+        if agent_id not in manager._conns:
+            manager._conns[agent_id] = set()
+        manager._conns[agent_id].add(websocket)
+        await websocket.send_text(json.dumps({"type": "auth.ok", "agent_id": agent_id}))
+
+        # 消息循环
+        while True:
+            text = await websocket.receive_text()
+            try:
+                msg = json.loads(text)
+            except json.JSONDecodeError:
+                await websocket.send_text(json.dumps({"type": "error", "message": "invalid json"}))
+                continue
+
+            msg_type = msg.get("type")
+            if msg_type == "subscribe":
+                feed_id = msg.get("feed_id")
+                if feed_id:
+                    manager.subscribe_feed(agent_id, feed_id)
+                    await websocket.send_text(json.dumps({"type": "subscribed", "feed_id": feed_id}))
+            elif msg_type == "unsubscribe":
+                feed_id = msg.get("feed_id")
+                if feed_id:
+                    manager.unsubscribe_feed(agent_id, feed_id)
+                    await websocket.send_text(json.dumps({"type": "unsubscribed", "feed_id": feed_id}))
+            elif msg_type == "ping":
+                await websocket.send_text(json.dumps({"type": "pong"}))
+            else:
+                await websocket.send_text(json.dumps({"type": "error", "message": f"unknown type: {msg_type}"}))
+
+    except WebSocketDisconnect:
+        pass
+    except asyncio.TimeoutError:
+        await websocket.close(code=4008, reason="auth timeout")
+    finally:
+        if agent_id:
+            manager.disconnect(websocket, agent_id)

package/extensions/services/dataclaw//345/215/217/350/256/2561-/351/241/271/347/233/256/346/235/241/344/273/266/346/216/210/346/235/203/344/270/216/350/202/241/346/235/203/345/257/271/344/273/267/345/215/217/350/256/256.md

@@ -0,0 +1,243 @@
+# 项目条件授权与股权对价协议
+
+**甲方**（项目所有人）：[你的姓名]  
+身份证号：[身份证号]  
+联系地址：[地址]
+
+**乙方**（GoFeed 项目公司）：[公司全称]  
+统一社会信用代码：[代码]  
+法定代表人：[姓名]  
+注册地址：[地址]
+
+---
+
+## 第一条 协议标的
+
+1.1 **项目定义**  
+本协议所称"项目"指 GoFeed 数据共享平台项目，包括但不限于：
+
+-   项目创意、商业模式、技术方案
+-   [gofeed.com](http://gofeed.com) 域名及其衍生域名
+-   已有的代码、文档、设计资料
+-   项目品牌、商标、Logo
+-   其他与项目相关的知识产权
+
+1.2 **初始状态**  
+项目所有权归甲方个人所有。
+
+---
+
+## 第二条 条件授权
+
+2.1 **授权内容**  
+甲方将项目所有权授权给乙方使用、运营、开发和商业化。
+
+2.2 **授权期限**  
+自本协议签署之日起，至以下任一事件发生时终止：
+
+-   **事件 A（融资成功）**：乙方完成符合第三条约定的融资
+-   **事件 B（融资失败）**：第三条约定的融资窗口期满，且未完成融资
+
+2.3 **授权性质**  
+本授权为**条件性授权**，不是立即转让。项目所有权在授权期间仍归甲方所有，但乙方享有完整的使用权、运营权和开发权。
+
+2.4 **授权限制**  
+乙方在授权期间不得：
+
+-   将项目转让给第三方（魔联除外，见第六条）
+-   将项目设置抵押、质押或其他担保
+-   以项目进行任何损害甲方利益的行为
+
+---
+
+## 第三条 融资成功条件
+
+3.1 **融资成功定义**  
+同时满足以下全部条件，视为融资成功：
+
+1.  投前估值 **≥3000 万元人民币**
+2.  融资金额 **≥500 万元人民币**
+3.  融资款项实际到账
+4.  时间窗口：本协议签署后 **12 个月内**
+
+3.2 **融资窗口延长**  
+如在第 11 个月已获得投资意向书（Term Sheet），融资窗口可延长至 **15 个月**，需经甲方书面同意。
+
+3.3 **融资证明**  
+乙方需在融资交割后 5 个工作日内，向甲方提供以下证明文件：
+
+-   融资协议复印件
+-   银行到账凭证
+-   投资方出具的投资确认函
+
+---
+
+## 第四条 股权对价
+
+4.1 **对价内容**  
+作为项目授权的对价，乙方向甲方支付 **30% 原始股份**。
+
+4.2 **股权价值**  
+项目作价 **100 万元人民币**，占乙方注册资本的 30%。
+
+4.3 **股权登记**  
+甲方的 30% 股份在乙方成立时即登记在甲方名下，但该股权的**最终生效以融资成功为条件**。
+
+4.4 **股权性质**  
+甲方的 30% 股份为**条件性股权**：
+
+-   融资成功 → 股权生效，甲方正式成为股东
+-   融资失败 → 股权失效，甲方不再持有股份
+
+---
+
+## 第五条 融资成功时的处理
+
+5.1 **授权转为转让**  
+融资成功后，甲方对乙方的授权自动转为**永久转让**，项目所有权归乙方所有。
+
+5.2 **股权生效**  
+甲方的 30% 股份正式生效，甲方成为乙方正式股东。
+
+5.3 **股权稀释**  
+如融资导致股权稀释，甲方与其他原股东按持股比例共同稀释。
+
+**示例**：
+
+-   融资前：甲方 30%，团队 70%
+-   投资方获得 10% 股权
+-   融资后：甲方 27%（30% × 90%），团队 63%（70% × 90%），投资方 10%
+
+5.4 **域名转移**  
+甲方需配合办理 [gofeed.com](http://gofeed.com) 域名过户手续，将域名所有权转移至乙方名下。过户费用由乙方承担。
+
+5.5 **无需现金支付**  
+融资成功时，乙方**无需向甲方支付任何现金**，股权即为全部对价。
+
+---
+
+## 第六条 融资失败时的处理
+
+6.1 **授权终止**  
+融资失败后，甲方对乙方的授权自动终止，项目所有权回归甲方个人。
+
+6.2 **股权失效**  
+甲方的 30% 股份自动失效，甲方不再持有乙方股份。
+
+6.3 **项目回购权**  
+授权终止后，乙方有权以 **100 万元人民币** 从甲方购买项目所有权。
+
+6.4 **回购流程**  
+如乙方行使回购权：
+
+1.  乙方向甲方支付 100 万元
+2.  甲方将项目所有权转移给乙方
+3.  甲方配合办理域名过户等手续
+
+6.5 **回购期限**  
+乙方需在授权终止后 **30 天内** 决定是否行使回购权。逾期视为放弃。
+
+6.6 **放弃回购**  
+如乙方放弃回购权，项目所有权归甲方个人，乙方不得再主张任何权利。
+
+---
+
+## 第七条 甲方的权利与义务
+
+7.1 **权利**
+
+-   在授权期间，保留项目所有权
+-   融资成功时，获得 30% 股份（稀释后约 27%）
+-   融资失败时，收回项目所有权或获得 100 万元回购款
+-   担任乙方董事（1 席，共 3 席）
+
+7.2 **义务**
+
+-   配合乙方运营项目，提供必要支持
+-   融资成功时，配合办理项目转让和域名过户手续
+-   融资失败且乙方行使回购权时，配合办理项目转让手续
+-   不得在授权期间将项目转让给第三方（魔联除外）
+
+---
+
+## 第八条 乙方的权利与义务
+
+8.1 **权利**
+
+-   在授权期间，享有项目的完整使用权、运营权、开发权
+-   融资失败时，有权以 100 万元回购项目所有权
+
+8.2 **义务**
+
+-   全力推进项目融资，争取在 12 个月内完成融资
+-   妥善运营项目，不得损害项目价值
+-   每月向甲方报告项目进展和融资进度
+-   融资失败时，如不行使回购权，需将项目完整交还甲方
+
+---
+
+## 第九条 保密条款
+
+9.1 **保密范围**  
+双方对本协议内容及项目相关的商业秘密、技术秘密负有保密义务。
+
+9.2 **保密期限**  
+保密期限为本协议签署之日起至项目公开披露之日止，但不少于 **3 年**。
+
+9.3 **例外情形**  
+以下情形不视为违反保密义务：
+
+-   法律法规要求披露
+-   融资过程中向投资方披露（需签署保密协议）
+-   已公开的信息
+
+---
+
+## 第十条 违约责任
+
+10.1 **甲方违约**  
+如甲方违反本协议约定，拒绝配合办理项目转让或域名过户手续，应向乙方支付 **50 万元** 违约金。
+
+10.2 **乙方违约**  
+如乙方违反本协议约定，擅自将项目转让给第三方（魔联除外），或损害项目价值，应向甲方支付 **100 万元** 违约金。
+
+10.3 **违约金不足**  
+违约金不足以弥补损失的，违约方应赔偿全部损失。
+
+---
+
+## 第十一条 争议解决
+
+11.1 **协商解决**  
+双方因本协议发生争议，应首先通过友好协商解决。
+
+11.2 **仲裁**  
+协商不成的，任何一方可向 **[仲裁委员会名称]** 申请仲裁。仲裁裁决为终局裁决，对双方均有约束力。
+
+11.3 **法律适用**  
+本协议适用中华人民共和国法律。
+
+---
+
+## 第十二条 其他条款
+
+12.1 **协议生效**  
+本协议自双方签字盖章之日起生效。
+
+12.2 **协议份数**  
+本协议一式两份，甲乙双方各执一份，具有同等法律效力。
+
+12.3 **协议修改**  
+本协议的任何修改或补充，需经双方书面同意。
+
+12.4 **通知方式**  
+本协议项下的通知，以书面形式送达对方协议首部载明的地址，或双方另行约定的联系方式。
+
+---
+
+**甲方**（签字）：________________  
+日期：____年____月____日
+
+**乙方**（盖章）：________________  
+法定代表人（签字）：________________  
+日期：____年____月____日