opencode-feishu-bot 0.1.0

package/README.md

@@ -0,0 +1,314 @@
+# OpenCode 飞书机器人
+
+一个飞书聊天机器人，用于与 OpenCode AI 编程助手集成，让你可以通过飞书与 OpenCode 进行交互。
+
+## 功能特性
+
+- **会话群模式**：每个会话创建独立群组，群内无需 @机器人 即可对话
+- **自动标题**：首条消息自动设置群组标题，格式 `o{会话ID}-{标题}`
+- **会话隔离**：多个会话群互不干扰，用户退出或解散群时自动清理
+- **开箱即用**：默认所有用户可用，无需配置白名单
+- **菜单系统**：支持飞书应用菜单，快速创建会话、切换项目等
+- **自动启动**：OpenCode 服务器随机器人自动启动，无需手动配置
+- **流式响应**：实时卡片更新，具有打字效果
+- **消息撤回**：用户撤回消息时自动中止任务并撤回 AI 响应
+- **项目切换**：支持预配置项目列表，快速切换
+- **模型切换**：动态切换 AI 模型
+- **可选白名单**：支持启用白名单模式限制访问
+- **命令系统**：内置常用操作命令
+
+## 环境要求
+
+- [Bun](https://bun.sh) v1.2.0 或更高版本
+- 飞书企业应用（详细权限配置见 [飞书应用配置](#飞书应用配置) 章节）
+
+## 安装
+
+### 作为 npm 包安装
+
+```bash
+# 全局安装
+npm install -g opencode-feishu-bot
+
+# 或使用 bun
+bun add -g opencode-feishu-bot
+```
+
+### 从源码安装
+
+```bash
+# 克隆仓库
+git clone <repository-url>
+cd opencode-feishu-bot
+
+# 安装依赖
+bun install
+```
+
+## 配置
+
+基于 `.env.example` 创建 `.env` 文件：
+
+```bash
+cp .env.example .env
+```
+
+配置以下环境变量：
+
+| 变量 | 说明 | 必填 |
+|------|------|------|
+| `FEISHU_APP_ID` | 飞书开放平台的应用 ID | 是 |
+| `FEISHU_APP_SECRET` | 飞书应用密钥 | 是 |
+| `ADMIN_USER_IDS` | 管理员 open_id 列表（逗号分隔） | 否 |
+| `ALLOW_ALL_USERS` | 是否允许所有用户（默认 `true`，设为 `false` 启用白名单模式） | 否 |
+| `PROJECTS` | 预配置项目列表（格式：`路径:名称,路径:名称`） | 否 |
+| `DATABASE_PATH` | SQLite 数据库路径 | 否（默认：`./data/bot.db`） |
+| `LOG_LEVEL` | 日志级别（debug/info/warn/error） | 否（默认：`info`） |
+| `DEFAULT_MODEL` | 默认模型（格式：`provider/model`） | 否 |
+| `AVAILABLE_MODELS` | 可用模型列表（逗号分隔） | 否 |
+
+> **注意**：OpenCode 服务器会随机器人自动启动（随机端口），无需手动配置。
+> 默认项目目录为机器人启动时的**当前工作目录**。
+
+## 使用方法
+
+### 启动机器人
+
+```bash
+# 在你的项目目录中启动
+cd /path/to/your/project
+opencode-feishu-bot
+
+# 从源码运行 - 生产模式
+bun run start
+
+# 从源码运行 - 开发模式（热重载）
+bun run dev
+```
+
+### CLI 参数
+
+| 参数 | 简写 | 说明 |
+|------|------|------|
+| `--model <id>` | `-m` | 设置默认模型（格式：provider/model） |
+| `--project <path>` | `-p` | 设置默认项目目录 |
+| `--log-level <level>` | `-l` | 日志级别（debug/info/warn/error） |
+| `--list-models` | | 列出所有可用模型并退出 |
+| `--help` | `-h` | 显示帮助信息 |
+| `--version` | `-v` | 显示版本号 |
+
+示例：
+
+```bash
+# 使用指定模型启动
+opencode-feishu-bot --model anthropic/claude-sonnet-4-20250514
+
+# 指定项目目录启动
+opencode-feishu-bot -p /path/to/project
+
+# 列出所有可用模型
+opencode-feishu-bot --list-models
+
+# 组合使用
+opencode-feishu-bot -m anthropic/claude-sonnet-4-20250514 -p /path/to/project -l debug
+```
+
+### 可用命令
+
+| 命令 | 说明 | 仅管理员 |
+|------|------|----------|
+| `/help` | 显示可用命令 | 否 |
+| `/new <编号>` | 创建新会话群（私聊）/ 切换项目（会话群内） | 否 |
+| `/model <编号或ID>` | 切换 AI 模型 | 否 |
+| `/compact` | 压缩当前会话上下文 | 否 |
+| `/clear` | 清除历史，创建新会话 | 否 |
+| `/new_session` | 创建新的 OpenCode 会话 | 否 |
+| `/switch_project <路径>` | 切换到不同的项目 | 否 |
+| `/abort` | 中止当前运行的任务 | 否 |
+| `/status` | 显示会话状态 | 否 |
+| `/whitelist_add <用户ID>` | 将用户添加到白名单 | 是 |
+| `/whitelist_remove <用户ID>` | 从白名单移除用户 | 是 |
+| `/whitelist_list` | 列出所有白名单用户 | 是 |
+
+### 与 OpenCode 交互
+
+**会话群模式（推荐）：**
+
+1. 在私聊中向机器人发送 `/new <项目编号>` 创建新会话群
+2. 机器人创建群组并拉你进群
+3. 在群内直接发送消息与 AI 对话，无需 @机器人
+4. 首条消息会自动设置群组标题（如 `o1a2b3c-实现登录功能`）
+5. 退出群组或解散群时自动清理会话数据
+
+**私聊模式：**
+
+直接在私聊中向机器人发送消息，机器人会自动创建或复用会话。
+
+**消息撤回**：如果在 AI 生成响应过程中撤回消息，机器人会自动中止任务并撤回已发送的响应。
+
+## 开发
+
+### 运行测试
+
+```bash
+bun test
+```
+
+### 项目结构
+
+```
+src/
+├── index.ts           # 应用入口
+├── config.ts          # 配置管理
+├── cli.ts             # CLI 参数解析
+├── database/          # SQLite 数据库层
+├── feishu/            # 飞书 SDK 集成
+│   ├── client.ts      # 飞书客户端封装
+│   ├── formatter.ts   # 消息格式化
+│   ├── streamer.ts    # 流式卡片更新
+│   ├── welcome.ts     # 欢迎卡片生成
+│   └── menu.ts        # 菜单交互卡片
+├── events/            # 事件处理
+│   └── handler.ts     # 机器人进群、消息撤回、菜单点击等事件
+├── opencode/          # OpenCode SDK 集成（自动启动服务器）
+├── session/           # 会话管理
+├── commands/          # 命令系统
+├── auth/              # 认证/授权
+├── utils/             # 工具函数（日志、重连）
+└── __tests__/         # 测试文件
+```
+
+## 架构
+
+```
+┌─────────────────┐     ┌─────────────────┐     ┌─────────────────┐
+│   飞书客户端    │────▶│   会话管理器    │────▶│  OpenCode客户端 │
+│  (WebSocket)    │     │                 │     │  (自动启动服务) │
+└─────────────────┘     └─────────────────┘     └─────────────────┘
+        │                       │                       │
+        ▼                       ▼                       ▼
+┌─────────────────┐     ┌─────────────────┐     ┌─────────────────┐
+│   消息处理器    │     │     数据库      │     │    事件流       │
+│                 │     │    (SQLite)     │     │                 │
+└─────────────────┘     └─────────────────┘     └─────────────────┘
+        │                                               │
+        ▼                                               ▼
+┌─────────────────┐                           ┌─────────────────┐
+│   命令处理器    │                           │   卡片流式器    │
+│                 │                           │                 │
+└─────────────────┘                           └─────────────────┘
+```
+
+## 飞书应用配置
+
+1. 访问[飞书开放平台](https://open.feishu.cn/app)
+2. 创建新的企业应用
+
+### 权限配置
+
+进入 **开发配置 > 权限管理**，开通以下权限：
+
+#### 消息权限
+
+| 权限名称 | 权限标识 | 用途 | 必需 |
+|---------|---------|------|------|
+| 获取与发送单聊、群组消息 | `im:message` | 发送消息、更新卡片 | ✅ |
+| 获取用户发给机器人的单聊消息 | `im:message.p2p_msg:readonly` | 接收私聊消息 | ✅ |
+| 获取群组中所有消息 | `im:message.group_msg:readonly` | 接收群聊消息 | ✅ |
+| 获取与上传图片或文件资源 | `im:resource` | 获取用户发送的图片 | ✅ |
+
+#### 群组权限
+
+| 权限名称 | 权限标识 | 用途 | 必需 |
+|---------|---------|------|------|
+| 获取与更新群组信息 | `im:chat` | 创建群聊、更新群名、解散群 | ✅ |
+| 获取群组信息 | `im:chat:readonly` | 获取群信息 | ✅ |
+| 更新群置顶 | `im:chat.top_notice:write` | 置顶状态卡片 | 可选 |
+
+#### 用户权限
+
+| 权限名称 | 权限标识 | 用途 | 必需 |
+|---------|---------|------|------|
+| 通过手机号或邮箱获取用户 ID | `contact:user.id:readonly` | 白名单功能（通过用户 ID 识别） | 可选 |
+
+### 事件订阅
+
+进入 **开发配置 > 事件订阅**：
+
+1. 选择 **长连接** 模式（无需配置服务器地址）
+2. 添加以下事件：
+
+| 事件名称 | 事件标识 | 用途 | 必需 |
+|---------|---------|------|------|
+| 接收消息 | `im.message.receive_v1` | 接收用户消息 | ✅ |
+| 机器人进群 | `im.chat.member.bot.added_v1` | 发送欢迎卡片 | ✅ |
+| 机器人被移出群 | `im.chat.member.bot.deleted_v1` | 清理会话数据 | ✅ |
+| 用户退群 | `im.chat.member.user.deleted_v1` | 会话群自动清理 | ✅ |
+| 群解散 | `im.chat.disbanded_v1` | 会话群自动清理 | ✅ |
+| 消息撤回 | `im.message.recalled_v1` | 自动中止任务、撤回响应 | ✅ |
+| 机器人菜单点击 | `application.bot.menu_v6` | 菜单功能 | 可选 |
+| 卡片回传交互 | `card.action.trigger` | 卡片按钮点击（模型切换等） | ✅ |
+
+### 机器人菜单（可选）
+
+进入 **应用功能 > 机器人 > 机器人菜单**，添加以下菜单项：
+
+| 菜单名称 | event_key |
+|---------|-----------|
+| 新建会话 | `new_session` |
+| 切换模型 | `switch_model` |
+| 压缩上下文 | `compact` |
+| 清除历史 | `clear_history` |
+| 查看状态 | `show_status` |
+
+### 发布应用
+
+完成以上配置后：
+
+1. 进入 **应用发布 > 版本管理与发布**
+2. 创建新版本，提交审核
+3. 审核通过后发布应用
+4. 将机器人添加到你的飞书工作区
+
+## 故障排除
+
+### 机器人收不到消息
+- 确保在飞书应用设置中启用了长连接
+- 检查所有必需权限是否已授予（见 [权限配置](#权限配置)）
+- 验证 `.env` 中的应用凭证
+- 确认已订阅所需的事件（见 [事件订阅](#事件订阅)）
+
+### 无法创建会话群
+- 确认已授予 `im:chat` 权限
+- 确认应用已发布并通过审核
+- 检查机器人是否有创建群聊的能力
+
+### 会话群内消息无响应
+- 确认群组是通过 `/new` 命令创建的会话群
+- 普通群组需要 @机器人 才能触发响应
+- 检查数据库中是否有该群的会话记录
+
+### 权限被拒绝（白名单模式）
+- 确认 `ALLOW_ALL_USERS` 是否设为 `false`
+- 验证用户是管理员或已加入白名单
+- 作为管理员使用 `/whitelist_add <用户ID>` 授予访问权限
+
+### 消息撤回不生效
+- 确认已订阅 `im.message.recalled_v1` 事件
+- 机器人只能撤回 24 小时内发送的消息
+
+### 卡片按钮点击无响应
+- 确认已订阅 `card.action.trigger` 事件
+- 检查日志中是否有卡片交互相关的错误
+
+### 无法获取用户发送的图片
+- 确认已授予 `im:resource` 权限
+- 检查图片是否已过期（飞书图片有有效期）
+
+### 无法置顶消息
+- 确认已授予 `im:chat.top_notice:write` 权限
+- 机器人需要是群管理员才能置顶消息
+
+## 许可证
+
+MIT

package/bin/cli.js

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+
+import('../dist/index.js');

package/dist/auth/whitelist.d.ts

@@ -0,0 +1,25 @@
+/**
+ * 权限管理模块
+ * 管理管理员和白名单用户权限
+ */
+import type { BotDatabase } from '../database';
+export interface AuthConfig {
+    adminUserIds: string[];
+}
+export declare class AuthManager {
+    private db;
+    private config;
+    constructor(db: BotDatabase, config: AuthConfig);
+    isAdmin(userId: string): boolean;
+    isAuthorized(userId: string): boolean;
+    addToWhitelist(userId: string, addedBy: string): boolean;
+    removeFromWhitelist(userId: string, removedBy: string): boolean;
+    getWhitelistedUsers(): Array<{
+        user_id: string;
+        added_by: string;
+        added_at: string;
+    }>;
+    getAdminUserIds(): string[];
+}
+export declare function createAuthManager(db: BotDatabase, config: AuthConfig): AuthManager;
+//# sourceMappingURL=whitelist.d.ts.map

package/dist/auth/whitelist.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"whitelist.d.ts","sourceRoot":"","sources":["../../src/auth/whitelist.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAG/C,MAAM,WAAW,UAAU;IACzB,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAED,qBAAa,WAAW;IACtB,OAAO,CAAC,EAAE,CAAc;IACxB,OAAO,CAAC,MAAM,CAAa;gBAEf,EAAE,EAAE,WAAW,EAAE,MAAM,EAAE,UAAU;IAK/C,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAIhC,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAOrC,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO;IAQxD,mBAAmB,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO;IAQ/D,mBAAmB,IAAI,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;IAIrF,eAAe,IAAI,MAAM,EAAE;CAG5B;AAED,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,WAAW,EAAE,MAAM,EAAE,UAAU,GAAG,WAAW,CAElF"}

package/dist/cli.d.ts

@@ -0,0 +1,27 @@
+/**
+ * CLI 参数解析模块
+ * 支持命令行参数启动时配置默认模型、项目等
+ */
+export interface CliOptions {
+    /** 默认模型 ID (格式: provider/model) */
+    model?: string;
+    /** 默认项目目录 */
+    project?: string;
+    /** 日志级别 */
+    logLevel?: 'debug' | 'info' | 'warn' | 'error';
+    /** 显示帮助信息 */
+    help?: boolean;
+    /** 显示版本 */
+    version?: boolean;
+    /** 列出可用模型 */
+    listModels?: boolean;
+}
+/** 解析 CLI 参数 */
+export declare function parseArgs(args?: string[]): CliOptions;
+/** 格式化帮助信息 */
+export declare function formatHelp(): string;
+/** 获取版本号 */
+export declare function getVersion(): string;
+/** 验证日志级别 */
+export declare function isValidLogLevel(level: string): level is 'debug' | 'info' | 'warn' | 'error';
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,UAAU;IACzB,mCAAmC;IACnC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,aAAa;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW;IACX,QAAQ,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;IAC/C,aAAa;IACb,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,WAAW;IACX,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,aAAa;IACb,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAmDD,gBAAgB;AAChB,wBAAgB,SAAS,CAAC,IAAI,GAAE,MAAM,EAA0B,GAAG,UAAU,CAuD5E;AAoBD,cAAc;AACd,wBAAgB,UAAU,IAAI,MAAM,CAsCnC;AAED,YAAY;AACZ,wBAAgB,UAAU,IAAI,MAAM,CAOnC;AAED,aAAa;AACb,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAE3F"}

package/dist/commands/handler.d.ts

@@ -0,0 +1,51 @@
+/**
+ * 命令处理模块
+ * 处理用户命令并执行相应操作
+ */
+import type { BotDatabase } from '../database';
+import type { FeishuClient } from '../feishu/client';
+import type { SessionManager } from '../session/manager';
+import type { OpencodeWrapper } from '../opencode/client';
+import type { ProjectConfig } from '../config';
+import type { ModelConfig } from '../config';
+export interface CommandContext {
+    chatId: string;
+    userId: string;
+    isAdmin: boolean;
+}
+export interface CommandResult {
+    success: boolean;
+    message: string;
+    handled: boolean;
+}
+export interface CommandHandlerConfig {
+    projects: ProjectConfig[];
+    availableModels: ModelConfig[];
+}
+export declare class CommandHandler {
+    private db;
+    private feishuClient;
+    private sessionManager;
+    private opencodeClient;
+    private projects;
+    private availableModels;
+    private cachedModels;
+    constructor(db: BotDatabase, feishuClient: FeishuClient, sessionManager: SessionManager, opencodeClient: OpencodeWrapper, config: CommandHandlerConfig);
+    private getModels;
+    handleIfCommand(text: string, context: CommandContext): Promise<CommandResult>;
+    private executeCommand;
+    private handleHelp;
+    private handleSwitchProject;
+    private handleNewSession;
+    private handleAbort;
+    private handleStatus;
+    private handleWhitelistAdd;
+    private handleWhitelistRemove;
+    private handleWhitelistList;
+    private handleNew;
+    private handleModel;
+    private handleCompact;
+    private handleClear;
+}
+export declare function createCommandHandler(db: BotDatabase, feishuClient: FeishuClient, sessionManager: SessionManager, opencodeClient: OpencodeWrapper, config: CommandHandlerConfig): CommandHandler;
+//# sourceMappingURL=handler.d.ts.map

package/dist/commands/handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handler.d.ts","sourceRoot":"","sources":["../../src/commands/handler.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC/C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAa7C,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,aAAa,EAAE,CAAC;IAC1B,eAAe,EAAE,WAAW,EAAE,CAAC;CAChC;AAED,qBAAa,cAAc;IACzB,OAAO,CAAC,EAAE,CAAc;IACxB,OAAO,CAAC,YAAY,CAAe;IACnC,OAAO,CAAC,cAAc,CAAiB;IACvC,OAAO,CAAC,cAAc,CAAkB;IACxC,OAAO,CAAC,QAAQ,CAAkB;IAClC,OAAO,CAAC,eAAe,CAAgB;IACvC,OAAO,CAAC,YAAY,CAAwE;gBAG1F,EAAE,EAAE,WAAW,EACf,YAAY,EAAE,YAAY,EAC1B,cAAc,EAAE,cAAc,EAC9B,cAAc,EAAE,eAAe,EAC/B,MAAM,EAAE,oBAAoB;YAUhB,SAAS;IAQjB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC;YAwCtE,cAAc;IA6D5B,OAAO,CAAC,UAAU;YAKJ,mBAAmB;YAkBnB,gBAAgB;YAUhB,WAAW;YAkBX,YAAY;YAwBZ,kBAAkB;YA4BlB,qBAAqB;YA4BrB,mBAAmB;YAmBnB,SAAS;YA0HT,WAAW;YA8DX,aAAa;YA0Bb,WAAW;CAQ1B;AAED,wBAAgB,oBAAoB,CAClC,EAAE,EAAE,WAAW,EACf,YAAY,EAAE,YAAY,EAC1B,cAAc,EAAE,cAAc,EAC9B,cAAc,EAAE,eAAe,EAC/B,MAAM,EAAE,oBAAoB,GAC3B,cAAc,CAEhB"}

package/dist/commands/parser.d.ts

@@ -0,0 +1,24 @@
+/**
+ * 命令解析模块
+ * 定义和解析机器人命令
+ */
+export interface Command {
+    name: string;
+    description: string;
+    usage: string;
+    adminOnly: boolean;
+}
+export interface ParsedCommand {
+    command: string;
+    args: string[];
+    rawArgs: string;
+}
+export declare const COMMANDS: Record<string, Command>;
+export declare function isCommand(text: string): boolean;
+export declare function parseCommand(text: string): ParsedCommand | null;
+export declare function getCommand(name: string): Command | null;
+export declare function getAvailableCommands(isAdmin: boolean): Command[];
+export declare function formatHelpMessage(isAdmin: boolean): string;
+export declare function formatCommandError(message: string): string;
+export declare function formatCommandSuccess(message: string): string;
+//# sourceMappingURL=parser.d.ts.map

package/dist/commands/parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../../src/commands/parser.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;CACjB;AAID,eAAO,MAAM,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAyE5C,CAAC;AAEF,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAE/C;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI,CAsB/D;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,IAAI,CAEvD;AAED,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,EAAE,CAEhE;AAED,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAU1D;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAE1D;AAED,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAE5D"}

package/dist/config.d.ts

@@ -0,0 +1,44 @@
+import { z } from 'zod';
+export interface ProjectConfig {
+    path: string;
+    name: string;
+}
+declare const envSchema: z.ZodObject<{
+    FEISHU_APP_ID: z.ZodString;
+    FEISHU_APP_SECRET: z.ZodString;
+    ADMIN_USER_IDS: z.ZodDefault<z.ZodString>;
+    DATABASE_PATH: z.ZodDefault<z.ZodString>;
+    LOG_LEVEL: z.ZodDefault<z.ZodEnum<{
+        debug: "debug";
+        info: "info";
+        warn: "warn";
+        error: "error";
+    }>>;
+    ALLOW_ALL_USERS: z.ZodDefault<z.ZodPipe<z.ZodTransform<boolean, unknown>, z.ZodBoolean>>;
+    PROJECTS: z.ZodDefault<z.ZodString>;
+    MENU_SERVER_URL: z.ZodOptional<z.ZodString>;
+    AVAILABLE_MODELS: z.ZodDefault<z.ZodString>;
+    DEFAULT_MODEL: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type Config = z.infer<typeof envSchema>;
+export interface CliOverrides {
+    model?: string;
+    project?: string;
+    logLevel?: 'debug' | 'info' | 'warn' | 'error';
+}
+export declare function loadConfig(overrides?: CliOverrides): Config;
+export declare function getAdminUserIds(config: Config): string[];
+export declare function getDefaultProjectPath(override?: string): string;
+export declare function getDefaultModel(config: Config): string | undefined;
+export declare function getProjects(config: Config): ProjectConfig[];
+export interface ModelConfig {
+    id: string;
+    name?: string;
+}
+export declare function getAvailableModels(config: Config): ModelConfig[];
+export declare function filterModels<T extends {
+    id: string;
+    name: string;
+}>(allModels: T[], configuredModels: ModelConfig[]): T[];
+export {};
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED,QAAA,MAAM,SAAS;;;;;;;;;;;;;;;;iBAuBb,CAAC;AAEH,MAAM,MAAM,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,SAAS,CAAC,CAAC;AAE/C,MAAM,WAAW,YAAY;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;CAChD;AAED,wBAAgB,UAAU,CAAC,SAAS,CAAC,EAAE,YAAY,GAAG,MAAM,CAoB3D;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAKxD;AAED,wBAAgB,qBAAqB,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAE/D;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAElE;AAED,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,aAAa,EAAE,CAa3D;AAED,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,WAAW,EAAE,CAwBhE;AAED,wBAAgB,YAAY,CAAC,CAAC,SAAS;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,EACjE,SAAS,EAAE,CAAC,EAAE,EACd,gBAAgB,EAAE,WAAW,EAAE,GAC9B,CAAC,EAAE,CAeL"}

package/dist/database/index.d.ts

@@ -0,0 +1,96 @@
+/** 用户会话记录 */
+export interface UserSession {
+    chat_id: string;
+    session_id: string;
+    project_path: string;
+    created_at: string;
+    updated_at: string;
+}
+/** 白名单用户记录 */
+export interface WhitelistUser {
+    user_id: string;
+    added_by: string;
+    added_at: string;
+}
+/** 项目路径映射 */
+export interface ProjectMapping {
+    chat_id: string;
+    project_path: string;
+    updated_at: string;
+}
+/** 事件去重记录 */
+export interface EventDedup {
+    event_id: string;
+    processed_at: string;
+}
+/** 消息映射记录 */
+export interface MessageMapping {
+    user_message_id: string;
+    bot_message_id: string | null;
+    chat_id: string;
+    created_at: string;
+}
+/** 会话群记录 */
+export interface SessionChat {
+    chat_id: string;
+    session_id: string;
+    owner_id: string;
+    project_path: string;
+    title: string | null;
+    title_set: boolean;
+    created_at: string;
+    updated_at: string;
+}
+/** 机器人数据库操作类 */
+export declare class BotDatabase {
+    private db;
+    private dedupWindowMs;
+    constructor(dbPath: string, dedupWindowMs?: number);
+    /** 初始化数据库表结构 */
+    private initialize;
+    /** 获取用户会话 */
+    getSession(chatId: string): UserSession | null;
+    /** 创建或更新用户会话 */
+    upsertSession(chatId: string, sessionId: string, projectPath: string): void;
+    /** 删除用户会话 */
+    deleteSession(chatId: string): boolean;
+    /** 检查用户是否在白名单中 */
+    isUserWhitelisted(userId: string): boolean;
+    /** 添加用户到白名单 */
+    addToWhitelist(userId: string, addedBy: string): boolean;
+    /** 从白名单移除用户 */
+    removeFromWhitelist(userId: string): boolean;
+    /** 获取所有白名单用户 */
+    getWhitelistedUsers(): WhitelistUser[];
+    /** 获取聊天的项目路径 */
+    getProjectPath(chatId: string): string | null;
+    /** 设置聊天的项目路径 */
+    setProjectPath(chatId: string, projectPath: string): void;
+    /** 检查事件是否已处理（用于去重） */
+    isEventProcessed(eventId: string): boolean;
+    /** 标记事件为已处理 */
+    markEventProcessed(eventId: string): boolean;
+    /** 清理过期的事件记录 */
+    cleanupOldEvents(): number;
+    saveMessageMapping(userMessageId: string, chatId: string): void;
+    updateBotMessageId(userMessageId: string, botMessageId: string): void;
+    getMessageMapping(userMessageId: string): MessageMapping | null;
+    deleteMessageMapping(userMessageId: string): boolean;
+    getMessageMappingsAfter(userMessageId: string, chatId: string): MessageMapping[];
+    deleteMessageMappings(userMessageIds: string[]): number;
+    deleteMessageMappingsByChatId(chatId: string): number;
+    cleanupOldMessageMappings(maxAgeMs?: number): number;
+    createSessionChat(chatId: string, sessionId: string, ownerId: string, projectPath: string): void;
+    getSessionChat(chatId: string): SessionChat | null;
+    getSessionChatsByOwner(ownerId: string): SessionChat[];
+    updateSessionChatTitle(chatId: string, title: string): void;
+    deleteSessionChat(chatId: string): boolean;
+    isSessionChat(chatId: string): boolean;
+    /** 关闭数据库连接 */
+    close(): void;
+}
+/** 初始化数据库 */
+export declare function initializeDatabase(dbPath: string): BotDatabase;
+/** 获取默认数据库实例 */
+export declare function getDatabase(): BotDatabase;
+//# sourceMappingURL=index.d.ts.map

package/dist/database/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/database/index.ts"],"names":[],"mappings":"AAYA,aAAa;AACb,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,cAAc;AACd,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,aAAa;AACb,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,aAAa;AACb,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,aAAa;AACb,MAAM,WAAW,cAAc;IAC7B,eAAe,EAAE,MAAM,CAAC;IACxB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,YAAY;AACZ,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,SAAS,EAAE,OAAO,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,gBAAgB;AAChB,qBAAa,WAAW;IACtB,OAAO,CAAC,EAAE,CAAW;IACrB,OAAO,CAAC,aAAa,CAAS;gBAElB,MAAM,EAAE,MAAM,EAAE,aAAa,SAAgB;IAczD,gBAAgB;IAChB,OAAO,CAAC,UAAU;IAMlB,aAAa;IACb,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI;IAO9C,gBAAgB;IAChB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI;IAY3E,aAAa;IACb,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAMtC,kBAAkB;IAClB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAQ1C,eAAe;IACf,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO;IAcxD,eAAe;IACf,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAM5C,gBAAgB;IAChB,mBAAmB,IAAI,aAAa,EAAE;IAKtC,gBAAgB;IAChB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAQ7C,gBAAgB;IAChB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI;IAWzD,sBAAsB;IACtB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IAQ1C,eAAe;IACf,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IAU5C,gBAAgB;IAChB,gBAAgB,IAAI,MAAM;IAO1B,kBAAkB,CAAC,aAAa,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAQ/D,kBAAkB,CAAC,aAAa,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,IAAI;IAOrE,iBAAiB,CAAC,aAAa,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI;IAO/D,oBAAoB,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO;IAMpD,uBAAuB,CAAC,aAAa,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,cAAc,EAAE;IAchF,qBAAqB,CAAC,cAAc,EAAE,MAAM,EAAE,GAAG,MAAM;IASvD,6BAA6B,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM;IAMrD,yBAAyB,CAAC,QAAQ,GAAE,MAA4B,GAAG,MAAM;IAOzE,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI;IAQhG,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI;IAOlD,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG,WAAW,EAAE;IAOtD,sBAAsB,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAS3D,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAM1C,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAQtC,cAAc;IACd,KAAK,IAAI,IAAI;CAGd;AAID,aAAa;AACb,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,WAAW,CAM9D;AAED,gBAAgB;AAChB,wBAAgB,WAAW,IAAI,WAAW,CAKzC"}

package/dist/database/schema.sql

@@ -0,0 +1,49 @@
+CREATE TABLE IF NOT EXISTS user_sessions (
+  chat_id TEXT PRIMARY KEY,
+  session_id TEXT NOT NULL,
+  project_path TEXT NOT NULL,
+  created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
+  updated_at DATETIME DEFAULT CURRENT_TIMESTAMP
+);
+
+CREATE TABLE IF NOT EXISTS user_whitelist (
+  user_id TEXT PRIMARY KEY,
+  added_by TEXT NOT NULL,
+  added_at DATETIME DEFAULT CURRENT_TIMESTAMP
+);
+
+CREATE TABLE IF NOT EXISTS project_mappings (
+  chat_id TEXT PRIMARY KEY,
+  project_path TEXT NOT NULL,
+  updated_at DATETIME DEFAULT CURRENT_TIMESTAMP
+);
+
+CREATE TABLE IF NOT EXISTS event_dedup (
+  event_id TEXT PRIMARY KEY,
+  processed_at DATETIME DEFAULT CURRENT_TIMESTAMP
+);
+
+CREATE TABLE IF NOT EXISTS message_mappings (
+  user_message_id TEXT PRIMARY KEY,
+  bot_message_id TEXT,
+  chat_id TEXT NOT NULL,
+  created_at DATETIME DEFAULT CURRENT_TIMESTAMP
+);
+
+-- 会话群：每个群对应一个独立的 OpenCode 会话
+CREATE TABLE IF NOT EXISTS session_chats (
+  chat_id TEXT PRIMARY KEY,
+  session_id TEXT NOT NULL,
+  owner_id TEXT NOT NULL,
+  project_path TEXT NOT NULL,
+  title TEXT,
+  title_set BOOLEAN DEFAULT FALSE,
+  created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
+  updated_at DATETIME DEFAULT CURRENT_TIMESTAMP
+);
+
+CREATE INDEX IF NOT EXISTS idx_event_dedup_processed_at ON event_dedup(processed_at);
+CREATE INDEX IF NOT EXISTS idx_message_mappings_chat_id ON message_mappings(chat_id);
+CREATE INDEX IF NOT EXISTS idx_message_mappings_created_at ON message_mappings(created_at);
+CREATE INDEX IF NOT EXISTS idx_session_chats_owner_id ON session_chats(owner_id);
+CREATE INDEX IF NOT EXISTS idx_session_chats_session_id ON session_chats(session_id);