feishu-bridge 1.0.0

package/README.md

@@ -0,0 +1,238 @@
+# Feishu Bridge
+
+🚀 轻量级飞书插件，桥接飞书与各种AI编程IDE/CLI工具
+
+## ✨ 特性
+
+- **🎯 零依赖**: 无需OpenClaw，独立运行
+- **🔌 多IDE支持**: VS Code, Cursor, Trae, OpenCode, Claude Code, Kiro, Antigravity
+- **💬 全交互**: 通过飞书完成所有操作，结果返回飞书
+- **🔒 安全**: Webhook签名验证(HMAC-SHA256)，防重放攻击
+- **📊 监控**: 健康检查端点，Prometheus指标
+- **🔧 完整CLI**: 配置管理、守护进程、状态监控
+- **⚡ 自动启动**: Shell hook自动检测IDE环境并启动服务
+- **🔄 双模式**: WebSocket和Webhook双连接模式支持
+- **💾 备用通信**: 文件系统IPC机制确保可靠性
+
+## 📦 安装
+
+### 方式一: curl一键安装 (推荐)
+
+**Linux/macOS:**
+```bash
+curl -fsSL https://install.feishu-bridge.dev | bash
+```
+
+**Windows (PowerShell):**
+```powershell
+iwr -useb https://install.feishu-bridge.dev/install.ps1 | iex
+```
+
+### 方式二: npm全局安装
+
+```bash
+npm install -g feishu-bridge
+```
+
+### 方式三: 手动安装
+
+```bash
+git clone https://github.com/your-org/feishu-bridge.git
+cd feishu-bridge
+npm install
+npm run build
+npm link
+```
+
+## Architecture
+
+```
+┌─────────────────┐    WebSocket/Webhook    ┌─────────────────────────┐
+│   Feishu        │ ◄──────────────────────► │     Feishu Bot          │
+│  (手机/PC/Web)  │                         │   (自建应用机器人)        │
+└─────────────────┘                         └─────────────────────────┘
+                                                        │
+                                                        ▼
+┌─────────────────────────────────────────────────────────────────────┐
+│                        Feishu Bridge Core                          │
+│  ┌─────────────┐  ┌─────────────┐  ┌─────────────┐  ┌────────────┐ │
+│  │  Message    │  │   Session   │  │   Tool      │  │  Response  │ │
+│  │  Handler    │  │   Manager   │  │   Router    │  │  Formatter │ │
+│  └─────────────┘  └─────────────┘  └─────────────┘  └────────────┘ │
+└─────────────────────────────────────────────────────────────────────┘
+                                │
+                                ▼
+┌─────────────────────────────────────────────────────────────────────┐
+│                      IDE/CLI Adapters Layer                         │
+│  ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐  │
+│  │ VS Code  │ │  Cursor  │ │  Trae    │ │ OpenCode │ │ Claude   │  │
+│  │ Adapter  │ │ Adapter  │ │ Adapter  │ │ Adapter  │ │ Adapter  │  │
+│  └──────────┘ └──────────┘ └──────────┘ └──────────┘ └──────────┘  │
+└─────────────────────────────────────────────────────────────────────┘
+```
+
+## Installation
+
+### npm Global Install
+
+```bash
+# Install globally
+npm install -g feishu-bridge
+
+# Configure your Feishu app credentials
+feishu-bridge config set appId YOUR_APP_ID
+feishu-bridge config set appSecret YOUR_APP_SECRET
+
+# Start the server
+feishu-bridge start
+```
+
+### Manual Install
+
+```bash
+# Clone the repository
+git clone https://github.com/your-org/feishu-bridge.git
+cd feishu-bridge
+
+# Install dependencies
+npm install
+
+# Build the project
+npm run build
+
+# Start the server
+npm start
+```
+
+## Configuration
+
+Create a `.env` file in your project root:
+
+```env
+FEISHU_APP_ID=your_app_id
+FEISHU_APP_SECRET=your_app_secret
+FEISHU_ENCRYPT_KEY=your_encrypt_key (optional)
+FEISHU_VERIFICATION_TOKEN=your_verification_token (optional)
+SERVER_PORT=3000
+SERVER_HOST=0.0.0.0
+```
+
+## Usage
+
+### CLI Commands
+
+```bash
+# Configuration
+feishu-bridge config set appId <value>
+feishu-bridge config set appSecret <value>
+feishu-bridge config list
+
+# Service management
+feishu-bridge start                    # Start service
+feishu-bridge start --daemon          # Start in daemon mode
+feishu-bridge daemon start            # Start daemon
+feishu-bridge daemon stop             # Stop daemon
+feishu-bridge status                  # Check service status
+
+# Auto-start hook (install once)
+curl -fsSL https://install.feishu-bridge.dev/hook.sh | bash
+```
+
+### Feishu Commands
+
+Once the server is running, interact with your IDEs/CLIs directly from Feishu:
+
+```
+@vscode /generate Create a React component for a todo list
+@cursor /run npm start
+@opencode /ask How do I implement authentication in Express.js?
+@claude-code /explain this function
+```
+
+## Supported Commands
+
+- `@vscode`: Interact with VS Code and GitHub Copilot
+- `@cursor`: Interact with Cursor IDE
+- `@opencode`: Interact with OpenCode
+- `@claude`: Interact with Claude Code
+- `@trae`: Interact with Trae
+- `@antigravity`: Interact with Antigravity
+- `@kiro`: Interact with Kiro
+
+## Development
+
+### Prerequisites
+
+- Node.js 18+
+- npm or yarn
+
+### Setup
+
+```bash
+# Clone the repository
+git clone https://github.com/your-org/feishu-bridge.git
+cd feishu-bridge
+
+# Install dependencies
+npm install
+
+# Build the project
+npm run build
+
+# Start in development mode
+npm run dev
+```
+
+### Project Structure
+
+```
+src/
+├── core/                      # Core modules
+│   ├── bridge.ts              # Main bridge coordinator
+│   ├── config.ts              # Configuration management
+│   ├── logger.ts              # Logging system
+│   ├── health.ts              # Health monitoring & metrics
+│   └── daemon.ts              # Process daemon & auto-restart
+├── feishu/                    # Feishu integration
+│   ├── client.ts              # Feishu API client
+│   ├── webhook.ts             # Webhook handler with signature verification
+│   ├── websocket.ts           # WebSocket connection handler
+│   └── types.ts               # Feishu type definitions
+├── adapters/                  # IDE/CLI adapters (7 implementations)
+│   ├── base.ts                # Adapter base class
+│   ├── vscode.ts              # VS Code adapter
+│   ├── cursor.ts              # Cursor adapter
+│   ├── opencode.ts            # OpenCode adapter (Socket)
+│   └── ...
+├── cli/                       # CLI implementation
+│   ├── index.ts               # CLI entry & commands
+│   └── config.ts              # Config management
+├── commands/                  # Command processing
+│   ├── executor.ts            # Command executor
+│   └── parser.ts              # Command parser
+├── session/                   # Session management
+│   └── manager.ts             # Session manager
+└── utils/                     # Utility functions
+    └── http.ts                # HTTP utilities
+
+scripts/                       # Installation scripts
+├── install.sh                 # Linux/macOS installer
+├── install.ps1                # Windows installer
+└── install-hook.sh            # Auto-start hook installer
+
+tests/                         # Test suite (54 tests)
+├── unit/                      # Unit tests
+└── integration/               # Integration tests
+```
+
+## Contributing
+
+1. Fork the repository
+2. Create a feature branch (`git checkout -b feature/amazing-feature`)
+3. Commit your changes (`git commit -m 'Add some amazing feature'`)
+4. Push to the branch (`git push origin feature/amazing-feature`)
+5. Open a Pull Request
+
+## License
+
+MIT License

package/bin/feishu-bridge.js

@@ -0,0 +1,5 @@
+#!/usr/bin/env node
+/**
+ * CLI入口文件 - 委托到编译后的CLI
+ */
+require('../dist/cli/index.js');

package/dist/cli/index.d.mts

@@ -0,0 +1,2 @@
+
+export {  }

package/dist/cli/index.d.ts

@@ -0,0 +1,2 @@
+
+export {  }