@neomei/agent-soul-framework 4.5.0

package/connectors/feishu/scripts/session-cleanup.sh

@@ -0,0 +1,72 @@
+#!/bin/bash
+# session-cleanup.sh — 清理消息过多的飞书 session 映射
+# 当 session 消息数超过阈值时，从 feishu-sessions.json 中移除映射
+# 下次对话会自动创建新 session
+
+set -e
+
+SESSIONS_FILE="${HOME}/.config/opencode/feishu-sessions.json"
+DB_FILE="${HOME}/.local/share/opencode/opencode.db"
+MAX_MESSAGES="${MAX_MESSAGES_PER_SESSION:-50}"
+
+if [ ! -f "$SESSIONS_FILE" ]; then
+    echo "[session-cleanup] feishu-sessions.json not found"
+    exit 0
+fi
+
+if [ ! -f "$DB_FILE" ]; then
+    echo "[session-cleanup] opencode.db not found"
+    exit 0
+fi
+
+# 读取当前 sessions
+SESSIONS=$(cat "$SESSIONS_FILE")
+
+# 使用单一 Python 脚本安全处理所有操作，避免注入
+python3 - "$SESSIONS_FILE" "$DB_FILE" "$MAX_MESSAGES" <<'PYEOF'
+import json, sqlite3, sys, os
+
+sessions_file = sys.argv[1]
+db_file = sys.argv[2]
+max_messages = int(sys.argv[3])
+
+with open(sessions_file, "r") as f:
+    data = json.load(f)
+
+sessions = data.get("sessions", [])
+if not sessions:
+    print("[session-cleanup] No sessions found")
+    sys.exit(0)
+
+conn = sqlite3.connect(db_file)
+try:
+    cleaned = 0
+    remaining = []
+    for s in sessions:
+        sid = s.get("sessionId", "")
+        cursor = conn.execute("SELECT COUNT(*) FROM message WHERE session_id = ?", (sid,))
+        msg_count = cursor.fetchone()[0]
+
+        if msg_count > max_messages:
+            print(f"[session-cleanup] {sid} has {msg_count} messages > {max_messages}, removing mapping")
+            cleaned += 1
+        else:
+            print(f"[session-cleanup] {sid} has {msg_count} messages <= {max_messages}, keeping")
+            remaining.append(s)
+
+    if cleaned > 0:
+        data["sessions"] = remaining
+        with open(sessions_file, "w") as f:
+            json.dump(data, f, ensure_ascii=False, indent=2)
+        print(f"[session-cleanup] Cleaned {cleaned} session(s), next message will create new session")
+    else:
+        print(f"[session-cleanup] All sessions are within limit ({max_messages} messages)")
+finally:
+    conn.close()
+PYEOF
+
+if [ "$CLEANED" -gt 0 ]; then
+    echo "[session-cleanup] Cleaned $CLEANED session(s), next message will create new session"
+else
+    echo "[session-cleanup] All sessions are within limit ($MAX_MESSAGES messages)"
+fi

package/connectors/feishu/start.sh

@@ -0,0 +1,91 @@
+#!/bin/bash
+#
+# hunqi-feishu - 魂器飞书连接器启动脚本
+# 只启动 opencode-feishu 插件，依赖 hunqi-core 提供的 OpenCode server
+#
+set -e
+
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+PROJECT_DIR="$(cd "$SCRIPT_DIR/../.." && pwd)"
+
+if [ -f "$PROJECT_DIR/.env" ]; then
+  set -a && source "$PROJECT_DIR/.env" && set +a
+fi
+
+cd "$PROJECT_DIR"
+
+OPENCODE_PORT="${OPENCODE_PORT:-19876}"
+
+# 自动检测 opencode-feishu 启动方式（npm link 在重启后经常断裂）
+resolve_opencode_feishu() {
+    # 1. 全局命令
+    if command -v opencode-feishu &>/dev/null; then
+        echo "opencode-feishu"
+        return 0
+    fi
+
+    # 2. npx
+    if command -v npx &>/dev/null; then
+        echo "npx opencode-feishu"
+        return 0
+    fi
+
+    # 3. npm 全局路径
+    if command -v npm &>/dev/null; then
+        local npm_prefix
+        npm_prefix=$(npm prefix -g 2>/dev/null)
+        if [ -n "$npm_prefix" ] && [ -x "$npm_prefix/bin/opencode-feishu" ]; then
+            echo "$npm_prefix/bin/opencode-feishu"
+            return 0
+        fi
+    fi
+
+    # 4. 源码回退（开发环境）
+    local src_paths=(
+        "/home/$USER/文档/projects/opencode-feishu/bin/opencode-feishu"
+        "$PROJECT_DIR/../opencode-feishu/bin/opencode-feishu"
+    )
+    for p in "${src_paths[@]}"; do
+        if [ -f "$p" ]; then
+            local node_cmd
+            node_cmd=$(command -v node 2>/dev/null || echo "node")
+            echo "$node_cmd $p"
+            return 0
+        fi
+    done
+
+    return 1
+}
+
+echo "🚀 魂器飞书连接器 (hunqi-feishu)"
+echo ""
+
+# 检查 opencode-feishu 是否可用
+FEISHU_CMD=$(resolve_opencode_feishu) || {
+    echo "❌ opencode-feishu 未安装"
+    echo ""
+    echo "请安装:"
+    echo "  npm install -g @neomei/opencode-feishu"
+    exit 1
+}
+
+# 检查 OpenCode server 是否已运行
+echo "检查 OpenCode server (port $OPENCODE_PORT)..."
+if ! curl -s http://localhost:$OPENCODE_PORT/session >/dev/null 2>&1; then
+  echo "❌ OpenCode server 未运行"
+  echo ""
+  echo "hunqi-feishu 依赖 hunqi-core，请先启动核心:"
+  echo "  ./connectors/feishu/core-start.sh"
+  echo ""
+  echo "或使用 systemd 同时启动两者:"
+  echo "  sudo systemctl start hunqi-core@\$USER"
+  echo "  sudo systemctl start channel-feishu@\$USER"
+  exit 1
+fi
+
+echo "✅ OpenCode server 已就绪"
+echo ""
+
+# 启动飞书桥接
+echo "启动飞书桥接（流式卡片 + 工具状态 + 交互提示）..."
+exec $FEISHU_CMD start

package/connectors/feishu/stop.sh

@@ -0,0 +1,78 @@
+#!/bin/bash
+set -e
+
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+PROJECT_DIR="$(cd "$SCRIPT_DIR/../.." && pwd)"
+PORT="${OPENCODE_PORT:-19876}"
+
+if [ -f "$PROJECT_DIR/.env" ]; then
+    set -a && source "$PROJECT_DIR/.env" && set +a
+fi
+
+# 自动检测 opencode-feishu 启动方式
+resolve_opencode_feishu() {
+    if command -v opencode-feishu &>/dev/null; then
+        echo "opencode-feishu"
+        return 0
+    fi
+    if command -v npx &>/dev/null; then
+        echo "npx opencode-feishu"
+        return 0
+    fi
+    if command -v npm &>/dev/null; then
+        local npm_prefix
+        npm_prefix=$(npm prefix -g 2>/dev/null)
+        if [ -n "$npm_prefix" ] && [ -x "$npm_prefix/bin/opencode-feishu" ]; then
+            echo "$npm_prefix/bin/opencode-feishu"
+            return 0
+        fi
+    fi
+    local src_paths=(
+        "/home/$USER/文档/projects/opencode-feishu/bin/opencode-feishu"
+        "$PROJECT_DIR/../opencode-feishu/bin/opencode-feishu"
+    )
+    for p in "${src_paths[@]}"; do
+        if [ -f "$p" ]; then
+            local node_cmd
+            node_cmd=$(command -v node 2>/dev/null || echo "node")
+            echo "$node_cmd $p"
+            return 0
+        fi
+    done
+    return 1
+}
+
+echo "魂器 飞书连接器 — 停止"
+echo ""
+
+FEISHU_CMD=$(resolve_opencode_feishu) || true
+if [ -n "$FEISHU_CMD" ]; then
+    $FEISHU_CMD stop 2>/dev/null && echo "已停止 opencode-feishu" || echo "opencode-feishu 未在运行"
+else
+    echo "opencode-feishu 命令不可用，跳过插件停止"
+fi
+
+# 只杀监听指定端口的 opencode serve，避免误杀其他实例
+SERVE_PID=$(ss -tlnp 2>/dev/null | grep ":${PORT} " | sed -n 's/.*pid=\([0-9]*\).*/\1/p')
+if [ -n "$SERVE_PID" ]; then
+    kill "$SERVE_PID" 2>/dev/null && echo "已停止 opencode serve (PID: $SERVE_PID, 端口: $PORT)"
+else
+    echo "opencode serve 未在运行 (端口: $PORT)"
+fi
+
+sleep 1
+
+if ss -tlnp 2>/dev/null | grep -q ":${PORT} "; then
+    PID=$(ss -tlnp 2>/dev/null | grep ":${PORT} " | sed -n 's/.*pid=\([0-9]*\).*/\1/p')
+    if [ -n "$PID" ]; then
+        PROC_NAME=$(ps -p "$PID" -o comm= 2>/dev/null || echo "unknown")
+        echo "端口 ${PORT} 仍被占用 (PID: $PID, $PROC_NAME)，发送 SIGTERM..."
+        kill "$PID" 2>/dev/null
+        sleep 2
+        if kill -0 "$PID" 2>/dev/null; then
+            echo "进程 $PID 未响应 SIGTERM，跳过"
+        fi
+    fi
+fi
+
+echo "完成"

package/connectors/feishu/systemd/channel-feishu@.service

@@ -0,0 +1,63 @@
+[Unit]
+Description=魂器飞书频道 (Channel Feishu) - Hunqi Core 的飞书接入
+# 注意：install-systemd.sh 安装时会将 %h 替换为实际家目录。
+# 系统级 systemd 中 %h 展开为 /root（而非 User= 指定的用户），不可直接使用。
+Documentation=https://github.com/NeoMei/agent-soul-framework
+After=network-online.target hunqi-core@%i.service
+Wants=network-online.target
+
+# 强依赖核心服务
+Requires=hunqi-core@%i.service
+After=hunqi-core@%i.service
+
+# 挂起后重启
+After=suspend.target hibernate.target hybrid-sleep.target
+
+[Service]
+Type=simple
+User=%I
+Group=%I
+
+# 工作目录
+WorkingDirectory=%h/.hunqi/agent-soul-framework/packages/agent-soul-framework
+
+# 加载环境变量
+Environment="HOME=%h"
+Environment="USER=%I"
+
+# 从 .env 文件加载环境变量
+EnvironmentFile=-%h/.hunqi/.env
+
+# 启动前：清理消息过多的 session 映射（防止上下文无限膨胀）
+ExecStartPre=-/bin/sh -c '%h/.hunqi/agent-soul-framework/packages/agent-soul-framework/connectors/feishu/scripts/session-cleanup.sh'
+
+# 启动前等待核心就绪
+ExecStartPre=/bin/sh -c 'for i in $(seq 1 30); do if curl -s http://localhost:19876/session >/dev/null 2>&1; then exit 0; fi; sleep 1; done; exit 1'
+
+# 启动命令 - 使用 ~/.hunqi/bin 下的 wrapper，避免依赖 nvm 版本
+ExecStart=%h/.hunqi/bin/opencode-feishu start
+
+# 停止命令
+ExecStop=%h/.hunqi/bin/opencode-feishu stop
+
+# 重载配置（修改 feishu.json 后执行 systemctl reload 即可生效）
+ExecReload=/bin/sh -c '%h/.hunqi/bin/opencode-feishu stop && sleep 2 && %h/.hunqi/bin/opencode-feishu start'
+
+# 重启策略
+Restart=always
+RestartSec=5
+StartLimitInterval=60s
+StartLimitBurst=3
+
+# 日志
+StandardOutput=journal
+StandardError=journal
+SyslogIdentifier=channel-feishu
+
+# 进程管理
+KillMode=mixed
+KillSignal=SIGTERM
+TimeoutStopSec=30
+
+[Install]
+WantedBy=multi-user.target

package/connectors/feishu/systemd/hunqi-core@.service

@@ -0,0 +1,50 @@
+[Unit]
+Description=魂器核心 (Hunqi Core) - OpenCode + Soul
+# 注意：install-systemd.sh 安装时会将 %h 替换为实际家目录。
+# 系统级 systemd 中 %h 展开为 /root（而非 User= 指定的用户），不可直接使用。
+Documentation=https://github.com/NeoMei/agent-soul-framework
+After=network-online.target
+Wants=network-online.target
+
+# 挂起后重启
+After=suspend.target hibernate.target hybrid-sleep.target
+
+[Service]
+Type=simple
+User=%I
+Group=%I
+
+# 工作目录
+WorkingDirectory=%h/.hunqi/agent-soul-framework/packages/agent-soul-framework
+
+# 加载环境变量
+Environment="HOME=%h"
+Environment="USER=%I"
+
+# 从 .env 文件加载环境变量
+EnvironmentFile=-%h/.hunqi/.env
+
+# 启动命令 - 使用 wrapper 解析 opencode 位置并启动 serve
+ExecStart=/bin/sh -c 'OPENCODE=$(%h/.hunqi/bin/opencode-feishu --resolve-opencode 2>/dev/null || command -v opencode); exec "$OPENCODE" serve --port 19876'
+
+# 停止命令（精确匹配端口，避免误杀）
+ExecStop=/bin/sh -c 'PID=$(ss -tlnp 2>/dev/null | grep ":19876 " | sed -n "s/.*pid=\\([0-9]*\\).*/\\1/p"); [ -n "$PID" ] && kill "$PID" || true'
+
+# 重启策略
+Restart=always
+RestartSec=5
+StartLimitInterval=60s
+StartLimitBurst=3
+
+# 日志
+StandardOutput=journal
+StandardError=journal
+SyslogIdentifier=hunqi-core
+
+# 进程管理
+KillMode=mixed
+KillSignal=SIGTERM
+TimeoutStopSec=30
+
+[Install]
+WantedBy=multi-user.target

package/connectors/feishu/systemd/install-systemd.sh

@@ -0,0 +1,316 @@
+#!/bin/bash
+#
+# 魂器 systemd 服务安装程序
+# 核心+频道架构：hunqi-core + channel-feishu
+#
+set -e
+
+# 错误处理：打印行号和命令
+trap 'print_error "脚本在第 ${LINENO} 行出错: $BASH_COMMAND"; exit 1' ERR
+
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+PROJECT_DIR="$(cd "$SCRIPT_DIR/../.." && pwd)"
+USER_NAME="${SUDO_USER:-$USER}"
+
+# 颜色
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+BLUE='\033[0;34m'
+NC='\033[0m'
+
+print_status() { echo -e "${BLUE}[魂器]${NC} $1"; }
+print_info() { echo -e "${BLUE}[信息]${NC} $1"; }
+print_success() { echo -e "${GREEN}[成功]${NC} $1"; }
+print_warning() { echo -e "${YELLOW}[警告]${NC} $1"; }
+print_error() { echo -e "${RED}[错误]${NC} $1" >&2; }
+
+if [ "$EUID" -ne 0 ]; then
+    print_error "需要 root 权限"
+    print_status "请使用: sudo $0"
+    exit 1
+fi
+
+# 辅助函数：安全读取用户输入（支持交互式和非交互式环境）
+safe_read() {
+    local prompt="$1"
+    local var_name="$2"
+    if [ -t 0 ] || [ -e /dev/tty ]; then
+        read -rp "$prompt" "$var_name" < /dev/tty
+    else
+        # 非交互式环境：使用默认值或退出
+        print_warning "非交互式环境，无法读取输入"
+        return 1
+    fi
+}
+
+if [ -z "$SUDO_USER" ] && [ "$USER" = "root" ]; then
+    safe_read "请输入运行魂器的用户名: " USER_NAME || { print_error "非交互式环境请设置 SUDO_USER 环境变量"; exit 1; }
+    [ -z "$USER_NAME" ] && { print_error "用户名不能为空"; exit 1; }
+fi
+
+# 获取用户真正的家目录（不假设 /home/ 前缀）
+HOME_DIR=$(getent passwd "$USER_NAME" | cut -d: -f6)
+if [ -z "$HOME_DIR" ]; then
+    print_error "无法获取用户 $USER_NAME 的家目录"
+    exit 1
+fi
+
+# 自动检测项目目录（支持多种安装位置）
+resolve_project_dir() {
+    # 1. 从脚本位置推导（开发环境，直接 clone 源码）
+    # 脚本路径: packages/agent-soul-framework/connectors/feishu/systemd/
+    local script_project="$(cd "$SCRIPT_DIR/../../../../packages/agent-soul-framework" && pwd)"
+    if [ -f "$script_project/package.json" ]; then
+        echo "$script_project"
+        return 0
+    fi
+
+    # 2. ~/.hunqi/agent-soul-framework（install.sh 默认安装位置）
+    if [ -f "$HOME_DIR/.hunqi/agent-soul-framework/packages/agent-soul-framework/package.json" ]; then
+        echo "$HOME_DIR/.hunqi/agent-soul-framework/packages/agent-soul-framework"
+        return 0
+    fi
+
+    # 3. 中文路径 ~/文档/projects/agent-soul-framework
+    if [ -f "$HOME_DIR/文档/projects/agent-soul-framework/packages/agent-soul-framework/package.json" ]; then
+        echo "$HOME_DIR/文档/projects/agent-soul-framework/packages/agent-soul-framework"
+        return 0
+    fi
+
+    # 4. 英文路径 ~/Documents/projects/agent-soul-framework
+    if [ -f "$HOME_DIR/Documents/projects/agent-soul-framework/packages/agent-soul-framework/package.json" ]; then
+        echo "$HOME_DIR/Documents/projects/agent-soul-framework/packages/agent-soul-framework"
+        return 0
+    fi
+
+    return 1
+}
+
+PROJECT_DIR=$(resolve_project_dir) || true
+
+CORE_SERVICE="hunqi-core@${USER_NAME}"
+FEISHU_SERVICE="channel-feishu@${USER_NAME}"
+
+echo ""
+echo "╔═══════════════════════════════════════════════════╗"
+echo "║  魂器 systemd 服务安装程序 (核心+频道架构)        ║"
+echo "╚═══════════════════════════════════════════════════╝"
+echo ""
+print_status "用户: $USER_NAME"
+print_status "核心: hunqi-core (Agent本体)"
+print_status "频道: channel-feishu (飞书接入)"
+echo ""
+
+# 1. 检查系统
+print_status "1/5 检查系统..."
+if ! command -v systemctl &> /dev/null; then
+    print_error "systemctl 未找到"
+    exit 1
+fi
+print_success "systemd 检查通过"
+
+# 2. 检查目录
+print_status "2/5 检查目录..."
+[ ! -d "$HOME_DIR" ] && { print_error "用户目录不存在: $HOME_DIR"; exit 1; }
+
+if [ -z "$PROJECT_DIR" ] || [ ! -d "$PROJECT_DIR" ]; then
+    print_error "未找到魂器核心框架目录"
+    print_status "已搜索的位置:"
+    print_status "  - $(cd "$SCRIPT_DIR/../../../../packages/agent-soul-framework" && pwd)"
+    print_status "  - $HOME_DIR/.hunqi/agent-soul-framework/packages/agent-soul-framework"
+    print_status "  - $HOME_DIR/文档/projects/agent-soul-framework/packages/agent-soul-framework"
+    print_status "  - $HOME_DIR/Documents/projects/agent-soul-framework/packages/agent-soul-framework"
+    echo ""
+
+    if safe_read "请输入魂器核心框架目录的完整路径: " PROJECT_DIR; then
+        [ -z "$PROJECT_DIR" ] && { print_error "目录不能为空"; exit 1; }
+        if [ ! -f "$PROJECT_DIR/package.json" ]; then
+            print_error "该目录不是有效的魂器核心框架（缺少 package.json）"
+            exit 1
+        fi
+    else
+        print_error "非交互式环境无法输入路径，请通过环境变量指定: PROJECT_DIR=/path/to/asf sudo -E $0"
+        exit 1
+    fi
+fi
+
+print_success "项目目录: $PROJECT_DIR"
+
+# 3. 检查依赖
+print_status "3/5 检查依赖..."
+
+# 使用 wrapper 检测 opencode（支持 nvm 等非 PATH 安装）
+# 注意：必须以目标用户的 HOME 运行 wrapper，否则 nvm 路径搜不到
+if [ -x "$HOME_DIR/.hunqi/bin/opencode-feishu" ]; then
+    if ! HOME="$HOME_DIR" "$HOME_DIR/.hunqi/bin/opencode-feishu" --resolve-opencode &> /dev/null; then
+        print_warning "opencode 未找到（hunqi-core 需要它）"
+        print_info "安装命令: npm install -g opencode-ai"
+    else
+        print_success "opencode 已安装"
+    fi
+    if ! HOME="$HOME_DIR" "$HOME_DIR/.hunqi/bin/opencode-feishu" --resolve-feishu &> /dev/null; then
+        print_warning "opencode-feishu 未找到"
+        print_info "安装命令: npm install -g @neomei/opencode-feishu"
+    else
+        print_success "opencode-feishu 已安装"
+    fi
+else
+    # fallback: 直接检查 PATH
+    if ! sudo -u "$USER_NAME" bash -c 'command -v opencode &> /dev/null'; then
+        print_warning "opencode 未找到"
+    fi
+    if ! sudo -u "$USER_NAME" bash -c 'command -v opencode-feishu &> /dev/null'; then
+        print_warning "opencode-feishu 未找到"
+    fi
+fi
+print_success "依赖检查完成"
+
+# 4. 安装服务文件
+print_status "4/5 安装服务文件..."
+
+# 检查源服务文件是否存在
+if [ ! -f "$SCRIPT_DIR/hunqi-core@.service" ]; then
+    print_error "服务文件缺失: $SCRIPT_DIR/hunqi-core@.service"
+    exit 1
+fi
+if [ ! -f "$SCRIPT_DIR/channel-feishu@.service" ]; then
+    print_error "服务文件缺失: $SCRIPT_DIR/channel-feishu@.service"
+    exit 1
+fi
+
+# 清理旧命名
+rm -f "/etc/systemd/system/hunqi-feishu@.service" 2>/dev/null || true
+
+# 安装新服务（将 %h 替换为实际家目录，因为系统级 systemd 中 %h 展开为 /root）
+sed "s|%h|$HOME_DIR|g" "$SCRIPT_DIR/hunqi-core@.service" > "/etc/systemd/system/hunqi-core@.service"
+sed "s|%h|$HOME_DIR|g" "$SCRIPT_DIR/channel-feishu@.service" > "/etc/systemd/system/channel-feishu@.service"
+chmod 644 "/etc/systemd/system/hunqi-core@.service"
+chmod 644 "/etc/systemd/system/channel-feishu@.service"
+
+# 验证替换后的路径是否正确
+if grep -q "WorkingDirectory=$HOME_DIR/.hunqi/agent-soul-framework/packages/agent-soul-framework" "/etc/systemd/system/hunqi-core@.service" 2>/dev/null; then
+    print_success "服务文件已安装"
+else
+    print_error "服务文件路径替换失败"
+    exit 1
+fi
+
+# 5. 配置挂起/唤醒钩子
+print_status "5/5 配置挂起/唤醒恢复..."
+
+HOOK_DIR="$PROJECT_DIR/connectors/feishu/systemd/sleep-hooks"
+mkdir -p "$HOOK_DIR"
+
+cat > "$HOOK_DIR/99-hunqi-resume.sh" << 'EOF'
+#!/bin/bash
+# 魂器挂起/唤醒钩子 - 重启核心和所有频道
+
+case "$1" in
+    pre)
+        logger "[hunqi] 系统即将挂起"
+        ;;
+    post)
+        logger "[hunqi] 系统唤醒，重启服务..."
+        systemctl restart 'hunqi-core@*'
+        sleep 3
+        systemctl restart 'channel-feishu@*'
+        ;;
+esac
+EOF
+chmod +x "$HOOK_DIR/99-hunqi-resume.sh"
+
+if safe_read "安装系统级挂起/唤醒钩子？(y/N) " REPLY; then
+    echo
+    if [[ $REPLY =~ ^[Yy]$ ]]; then
+        if [ -d "/lib/systemd/system-sleep" ]; then
+            cp "$HOOK_DIR/99-hunqi-resume.sh" "/lib/systemd/system-sleep/"
+            chmod +x "/lib/systemd/system-sleep/99-hunqi-resume.sh"
+            print_success "系统级钩子已安装"
+        else
+            print_warning "/lib/systemd/system-sleep 不存在"
+        fi
+    else
+        print_status "跳过系统级钩子"
+    fi
+else
+    print_status "非交互式环境，跳过系统级钩子安装"
+fi
+
+if systemctl daemon-reload; then
+    print_success "systemd 配置已重载"
+else
+    print_error "systemctl daemon-reload 失败（systemd 可能未运行）"
+    exit 1
+fi
+
+if systemctl enable "$CORE_SERVICE" && systemctl enable "$FEISHU_SERVICE"; then
+    print_success "服务已启用"
+else
+    print_error "服务启用失败"
+    exit 1
+fi
+
+echo ""
+echo "╔═══════════════════════════════════════════════════╗"
+echo "║         安装完成！                                ║"
+echo "╚═══════════════════════════════════════════════════╝"
+echo ""
+echo "核心服务:   hunqi-core@${USER_NAME}"
+echo "飞书频道:   channel-feishu@${USER_NAME}"
+echo ""
+echo "管理命令:"
+echo "  启动核心:   sudo systemctl start hunqi-core@${USER_NAME}"
+echo "  启动飞书:   sudo systemctl start channel-feishu@${USER_NAME}"
+echo "  停止飞书:   sudo systemctl stop channel-feishu@${USER_NAME}"
+echo "  停止核心:   sudo systemctl stop hunqi-core@${USER_NAME}"
+echo "  查看状态:   sudo systemctl status channel-feishu@${USER_NAME}"
+echo "  查看日志:   sudo journalctl -u channel-feishu@${USER_NAME} -f"
+echo ""
+echo "架构说明:"
+echo "  hunqi-core      = Agent本体 (OpenCode + 灵魂)"
+echo "  channel-feishu  = 飞书频道 (接入核心)"
+echo "  未来扩展:       channel-wechat, channel-discord..."
+echo ""
+
+if safe_read "立即启动服务？(y/N) " REPLY; then
+    echo
+    if [[ $REPLY =~ ^[Yy]$ ]]; then
+        print_status "停止现有进程..."
+        # 只停止目标用户的进程，避免误杀其他用户
+        sudo -u "$USER_NAME" pkill -f "opencode-feishu" 2>/dev/null || true
+        sudo -u "$USER_NAME" pkill -f "opencode serve" 2>/dev/null || true
+        sleep 2
+
+        print_status "启动核心..."
+        if systemctl start "$CORE_SERVICE"; then
+            print_success "hunqi-core 已启动"
+        else
+            print_error "hunqi-core 启动失败，查看日志:"
+            echo "  sudo journalctl -u $CORE_SERVICE --no-pager -n 20"
+        fi
+        sleep 5
+
+        print_status "启动飞书频道..."
+        if systemctl start "$FEISHU_SERVICE"; then
+            print_success "channel-feishu 已启动"
+        else
+            print_error "channel-feishu 启动失败，查看日志:"
+            echo "  sudo journalctl -u $FEISHU_SERVICE --no-pager -n 20"
+        fi
+        sleep 3
+
+        if systemctl is-active --quiet "$FEISHU_SERVICE"; then
+            print_success "服务运行正常！"
+            systemctl status "$FEISHU_SERVICE" --no-pager
+        else
+            print_error "服务未正常运行，请查看日志排查"
+        fi
+    fi
+else
+    print_status "非交互式环境，跳过自动启动"
+    echo ""
+    echo "手动启动:"
+    echo "  sudo systemctl start $CORE_SERVICE"
+    echo "  sudo systemctl start $FEISHU_SERVICE"
+fi

package/connectors/feishu/systemd/sleep-hooks/99-hunqi-resume.sh

@@ -0,0 +1,14 @@
+#!/bin/bash
+# 魂器挂起/唤醒钩子 - 重启核心和所有频道
+
+case "$1" in
+    pre)
+        logger "[hunqi] 系统即将挂起"
+        ;;
+    post)
+        logger "[hunqi] 系统唤醒，重启服务..."
+        systemctl restart 'hunqi-core@*'
+        sleep 3
+        systemctl restart 'channel-feishu@*'
+        ;;
+esac