@neomei/agent-soul-framework 4.5.0

package/scripts/session-cleanup.sh

@@ -0,0 +1,85 @@
+#!/bin/bash
+#
+# 会话清理脚本
+# 用途：强制重置 stuck/busy 状态的会话，无需重启服务
+#
+
+set -e
+
+SESSIONS_FILE="$HOME/.config/opencode/feishu-sessions.json"
+LOG_FILE="/tmp/hunqi-session-cleanup.log"
+MAX_AGE_MINUTES=10
+
+log() {
+    echo "[$(date '+%Y-%m-%d %H:%M:%S')] $1" | tee -a "$LOG_FILE"
+}
+
+# 从日志中提取当前 busy 的会话
+detect_busy_sessions() {
+    local log_file="/path/to/your/home/.config/opencode/feishu.log"
+    
+    # 获取每个会话最后的状态
+    grep -E '"status":"(busy|idle)"' "$log_file" 2>/dev/null | \
+        awk -F'"sessionId":"' '{print $2}' | \
+        awk -F'"' '{print $1}' | \
+        sort -u | \
+        while read session_id; do
+            [ -z "$session_id" ] && continue
+            local last_status
+            last_status=$(grep "\"sessionId\":\"$session_id\"" "$log_file" | grep '"status"' | tail -1)
+            if echo "$last_status" | grep -q '"status":"busy"'; then
+                echo "$session_id"
+            fi
+        done
+}
+
+# 重置会话状态（通过删除 sessions 文件强制重建）
+reset_sessions() {
+    if [ -f "$SESSIONS_FILE" ]; then
+        local backup="${SESSIONS_FILE}.bak.$(date +%s)"
+        cp "$SESSIONS_FILE" "$backup"
+        log "  已备份 sessions 文件: $backup"
+        
+        # 清空 sessions 数组，保留文件结构
+        python3 -c "
+import json
+with open('$SESSIONS_FILE', 'r') as f:
+    data = json.load(f)
+data['sessions'] = []
+with open('$SESSIONS_FILE', 'w') as f:
+    json.dump(data, f, indent=2)
+" 2>/dev/null || rm -f "$SESSIONS_FILE"
+        
+        log "  ✅ 已重置所有会话状态"
+    fi
+}
+
+# ===== 主逻辑 =====
+log "=== 会话清理检查 ==="
+
+busy_sessions=$(detect_busy_sessions)
+if [ -n "$busy_sessions" ]; then
+    log "⚠️ 检测到 busy 会话:"
+    echo "$busy_sessions" | while read sid; do
+        log "  - $sid"
+    done
+    
+    # 检查这些会话是否长时间 busy
+    current_time=$(date +%s%3N)
+    last_busy_time=$(grep '"status":"busy"' /path/to/your/home/.config/opencode/feishu.log 2>/dev/null | tail -1 | grep -o '"time":[0-9]*' | cut -d: -f2 || echo "0")
+    
+    if [ -n "$last_busy_time" ] && [ "$last_busy_time" != "0" ]; then
+        elapsed_min=$(( (current_time - last_busy_time) / 60000 ))
+        if [ "$elapsed_min" -gt "$MAX_AGE_MINUTES" ]; then
+            log "会话已 busy ${elapsed_min} 分钟，超过阈值 ${MAX_AGE_MINUTES} 分钟，执行清理..."
+            reset_sessions
+            
+            # 通知飞书
+            log "  已发送会话重置通知"
+        else
+            log "会话仅 busy ${elapsed_min} 分钟，仍在正常范围内，暂不清理"
+        fi
+    fi
+else
+    log "✅ 无 busy 会话，状态正常"
+fi

package/setup-wizard.sh

@@ -0,0 +1,420 @@
+#!/bin/bash
+#
+# 魂器配置向导 — 全新安装后的一站式配置程序
+# 引导用户完成环境变量、连接器配置和服务启动
+#
+set -e
+
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+USER_NAME="${SUDO_USER:-$USER}"
+HOME_DIR="$(getent passwd "$USER_NAME" | cut -d: -f6)"
+
+# 颜色
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+BLUE='\033[0;34m'
+CYAN='\033[0;36m'
+NC='\033[0m'
+
+print_header() {
+    echo ""
+    echo -e "${CYAN}╔══════════════════════════════════════════════════════════════╗${NC}"
+    echo -e "${CYAN}║${NC}           魂器 · 初始配置向导                              ${CYAN}║${NC}"
+    echo -e "${CYAN}╚══════════════════════════════════════════════════════════════╝${NC}"
+    echo ""
+}
+
+print_step() {
+    echo ""
+    echo -e "${BLUE}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}"
+    echo -e "${BLUE}  步骤 $1: $2${NC}"
+    echo -e "${BLUE}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}"
+    echo ""
+}
+
+print_success() { echo -e "${GREEN}✅${NC} $1"; }
+print_warning() { echo -e "${YELLOW}⚠️${NC}  $1"; }
+print_error() { echo -e "${RED}❌${NC} $1"; }
+print_info() { echo -e "${BLUE}ℹ️${NC}  $1"; }
+
+# 非交互模式检测
+NONINTERACTIVE="${NONINTERACTIVE:-0}"
+
+# 安全读取输入
+safe_read() {
+    local prompt="$1"
+    local var_name="$2"
+    if [ "$NONINTERACTIVE" = "1" ]; then
+        return 1
+    fi
+    if [ -t 0 ] || [ -e /dev/tty ]; then
+        read -rp "$prompt" "$var_name" < /dev/tty
+    else
+        return 1
+    fi
+}
+
+# 询问是否继续
+ask_continue() {
+    local msg="$1"
+    if [ "$NONINTERACTIVE" = "1" ]; then
+        return 0
+    fi
+    local answer
+    safe_read "$msg [Y/n]: " answer
+    [[ ! "$answer" =~ ^[Nn]$ ]]
+}
+
+# ───────────────────────────────────────────────
+# 步骤 1: 环境检查
+# ───────────────────────────────────────────────
+step1_check_env() {
+    print_step "1/5" "环境检查"
+
+    local issues=0
+
+    # 检查 Node.js
+    if command -v node &>/dev/null; then
+        NODE_VERSION=$(node -v | sed 's/v//')
+        print_success "Node.js $NODE_VERSION"
+    else
+        print_error "Node.js 未安装（需要 ≥ 20）"
+        issues=$((issues + 1))
+    fi
+
+    # 检查 opencode
+    if command -v opencode &>/dev/null; then
+        print_success "OpenCode 已安装"
+    else
+        print_warning "OpenCode 未找到，请运行: npm install -g opencode-ai"
+        issues=$((issues + 1))
+    fi
+
+    # 检查 Python
+    if command -v python3 &>/dev/null; then
+        print_success "Python $(python3 --version 2>&1 | cut -d' ' -f2)"
+    else
+        print_warning "Python 未安装（心跳功能将不可用）"
+    fi
+
+    # 检查可选 channel 插件（飞书/企微，按需安装）
+    if command -v opencode-feishu &>/dev/null; then
+        print_success "飞书通道插件 (opencode-feishu)"
+    else
+        print_info "飞书通道插件未安装（可选），安装命令: npm install -g @neomei/opencode-feishu"
+    fi
+
+    if command -v opencode-qiwei &>/dev/null; then
+        print_success "企微通道插件 (opencode-qiwei)"
+    else
+        print_info "企微通道插件未安装（可选），安装命令: npm install -g @neomei/opencode-qiwei"
+    fi
+
+    if command -v python3 &>/dev/null; then
+    print_step "2/5" "环境变量配置"
+
+    ENV_FILE="${HOME_DIR}/.hunqi/.env"
+    mkdir -p "$(dirname "$ENV_FILE")"
+
+    # 非交互模式: 如果已有 .env 就直接用，没有就创建一个空的
+    if [ "$NONINTERACTIVE" = "1" ]; then
+        if [ -f "$ENV_FILE" ] && [ -s "$ENV_FILE" ]; then
+            print_success "使用现有 .env 配置"
+        else
+            echo "# 魂器环境变量配置" > "$ENV_FILE"
+            echo "# 请手动填写 API Key 或使用 setup-wizard.sh 交互式配置" >> "$ENV_FILE"
+            print_warning ".env 已创建（空），请在安装完成后手动配置 API Key"
+        fi
+        # 同步到项目目录
+        if [ -f "$SCRIPT_DIR/.env" ]; then
+            cp "$ENV_FILE" "$SCRIPT_DIR/.env"
+        fi
+        return 0
+    fi
+
+    # 如果已有 .env，询问是否覆盖
+    if [ -f "$ENV_FILE" ] && [ -s "$ENV_FILE" ]; then
+        if ! ask_continue "检测到已有的 .env 配置，是否重新配置"; then
+            print_info "跳过 .env 配置，使用现有配置"
+            return 0
+        fi
+    fi
+
+    print_info "请填写以下 API Key（没有的可直接回车跳过）"
+    echo ""
+
+    local vars=()
+
+    # DashScope API Key
+    echo -e "${CYAN}阿里云百炼 (DashScope)${NC} — 用于文本嵌入和向量检索"
+    echo "  获取地址: https://dashscope.aliyun.com/"
+    local dashscope_key
+    safe_read "  DASHSCOPE_API_KEY: " dashscope_key
+    [ -n "$dashscope_key" ] && vars+=("DASHSCOPE_API_KEY=$dashscope_key")
+    echo ""
+
+    # 写入 .env
+    {
+        echo "# 魂器环境变量配置"
+        echo "# 生成时间: $(date '+%Y-%m-%d %H:%M:%S')"
+        echo ""
+        for v in "${vars[@]}"; do
+            echo "$v"
+        done
+    } > "$ENV_FILE"
+
+    # 同时同步到项目目录
+    if [ -f "$SCRIPT_DIR/.env" ]; then
+        cp "$ENV_FILE" "$SCRIPT_DIR/.env"
+    fi
+
+    print_success ".env 已保存到 $ENV_FILE"
+}
+
+# ───────────────────────────────────────────────
+# 步骤 3: 飞书配置
+# ───────────────────────────────────────────────
+step3_feishu() {
+    print_step "3/5" "飞书通道（可选）"
+
+    if ! command -v opencode-feishu &>/dev/null; then
+        print_info "opencode-feishu 未安装，跳过飞书配置"
+        print_info "如需飞书通道，安装命令: npm install -g @neomei/opencode-feishu"
+        print_info "安装后运行: opencode-feishu setup"
+        return 0
+    fi
+
+    local feishu_config="${HOME_DIR}/.config/opencode/feishu.json"
+
+    # 非交互模式跳过（opencode-feishu setup 需要 tty 扫码）
+    if [ "$NONINTERACTIVE" = "1" ]; then
+        if [ -f "$feishu_config" ]; then
+            print_success "飞书配置已存在"
+        else
+            print_info "非交互模式跳过飞书配置"
+            print_info "请手动运行: opencode-feishu setup"
+        fi
+        return 0
+    fi
+
+    local setup_ran=0
+
+    if [ -f "$feishu_config" ]; then
+        print_success "飞书配置已存在"
+        if ask_continue "是否重新配置飞书"; then
+            echo ""
+            opencode-feishu setup
+            setup_ran=1
+        else
+            print_info "跳过飞书配置"
+        fi
+    else
+        print_info "开始飞书配置向导..."
+        echo "  将显示二维码，请用飞书 App 扫码"
+        echo ""
+        if ask_continue "是否现在配置飞书"; then
+            opencode-feishu setup
+            setup_ran=1
+        else
+            print_info "跳过飞书配置，稍后手动运行: opencode-feishu setup"
+        fi
+    fi
+
+    # 扫码成功后，自动把凭证同步到 .env
+    if [ "$setup_ran" = "1" ] && [ -f "$feishu_config" ]; then
+        local fs_app_id fs_app_secret
+        # 优先用 jq，否则用 sed 回退
+        if command -v jq &>/dev/null; then
+            fs_app_id=$(jq -r '.appId // empty' "$feishu_config" 2>/dev/null)
+            fs_app_secret=$(jq -r '.appSecret // empty' "$feishu_config" 2>/dev/null)
+        else
+            fs_app_id=$(grep -o '"appId" *: *"[^"]*"' "$feishu_config" 2>/dev/null | sed 's/.*: *"\([^"]*\)".*/\1/')
+            fs_app_secret=$(grep -o '"appSecret" *: *"[^"]*"' "$feishu_config" 2>/dev/null | sed 's/.*: *"\([^"]*\)".*/\1/')
+        fi
+
+        if [ -n "$fs_app_id" ] && [ -n "$fs_app_secret" ]; then
+            ENV_FILE="${HOME_DIR}/.hunqi/.env"
+            # 更新或追加 FEISHU_APP_ID / FEISHU_APP_SECRET
+            for key_val in "FEISHU_APP_ID=$fs_app_id" "FEISHU_APP_SECRET=$fs_app_secret"; do
+                key="${key_val%%=*}"
+                if grep -q "^${key}=" "$ENV_FILE" 2>/dev/null; then
+                    sed -i "s|^${key}=.*|${key_val}|" "$ENV_FILE"
+                elif grep -q "^#.*${key}" "$ENV_FILE" 2>/dev/null; then
+                    sed -i "s|^#.*${key}.*|${key_val}|" "$ENV_FILE"
+                else
+                    echo "$key_val" >> "$ENV_FILE"
+                fi
+            done
+            # 同步到项目目录
+            if [ -f "$SCRIPT_DIR/.env" ]; then
+                cp "$ENV_FILE" "$SCRIPT_DIR/.env"
+            fi
+            print_success "飞书凭证已自动同步到 .env"
+        fi
+    fi
+
+    # 如果仍然没有 feishu.json（用户跳过了扫码），提示手动输入
+    if [ ! -f "$feishu_config" ]; then
+        echo ""
+        print_info "未检测到飞书配置，可手动补录凭证到 .env:"
+        echo "  FEISHU_APP_ID=cli_xxxxxx"
+        echo "  FEISHU_APP_SECRET=xxxxxxxx"
+        echo "  配置文件: ${HOME_DIR}/.hunqi/.env"
+    fi
+}
+
+# ───────────────────────────────────────────────
+# 步骤 4: 企微配置
+# ───────────────────────────────────────────────
+step4_qiwei() {
+    print_step "4/5" "企业微信通道（可选）"
+
+    if ! command -v opencode-qiwei &>/dev/null; then
+        print_info "opencode-qiwei 未安装，跳过企微配置"
+        print_info "如需企微通道，安装命令: npm install -g @neomei/opencode-qiwei"
+        print_info "安装后运行: opencode-qiwei setup"
+        return 0
+    fi
+
+    local qiwei_config="${HOME_DIR}/.config/opencode/qiwei.json"
+
+    # 非交互模式跳过
+    if [ "$NONINTERACTIVE" = "1" ]; then
+        if [ -f "$qiwei_config" ]; then
+            print_success "企微配置已存在"
+        else
+            print_info "非交互模式跳过企微配置"
+            print_info "请手动运行: opencode-qiwei setup"
+        fi
+        return 0
+    fi
+
+    if [ -f "$qiwei_config" ]; then
+        print_success "企微配置已存在"
+        if ask_continue "是否重新配置企微"; then
+            echo ""
+            opencode-qiwei setup
+        else
+            print_info "跳过企微配置"
+        fi
+    else
+        if ask_continue "是否现在配置企微"; then
+            opencode-qiwei setup
+        else
+            print_info "跳过企微配置，稍后手动运行: opencode-qiwei setup"
+        fi
+    fi
+}
+
+# ───────────────────────────────────────────────
+# 步骤 5: 验证和启动
+# ───────────────────────────────────────────────
+step5_verify_start() {
+    print_step "5/5" "验证和启动"
+
+    # 验证飞书
+    if command -v opencode-feishu &>/dev/null; then
+        echo ""
+        print_info "检查飞书连接..."
+        if opencode-feishu doctor 2>/dev/null; then
+            print_success "飞书连接正常"
+        else
+            print_warning "飞书连接检查未通过，请检查配置"
+        fi
+    fi
+
+    echo ""
+    print_info "配置完成！"
+    echo ""
+    echo -e "${GREEN}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}"
+    echo -e "${GREEN}  🎉 魂器初始配置完成！${NC}"
+    echo -e "${GREEN}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}"
+    echo ""
+
+    # 启动选项
+    if [ "$EUID" -eq 0 ] || sudo -n true 2>/dev/null; then
+        if [ "$NONINTERACTIVE" = "1" ]; then
+            # 非交互模式：自动启动 systemd
+            echo ""
+            print_info "自动启动 systemd 服务..."
+            sudo systemctl start "hunqi-core@${USER_NAME}" 2>/dev/null || print_warning "hunqi-core 启动失败"
+            sleep 3
+            sudo systemctl start "channel-feishu@${USER_NAME}" 2>/dev/null || print_warning "channel-feishu 启动失败"
+            echo ""
+            print_success "服务已启动"
+            echo "  查看状态: sudo systemctl status channel-feishu@${USER_NAME}"
+            echo "  查看日志: sudo journalctl -u channel-feishu@${USER_NAME} -f"
+        else
+            echo -e "${CYAN}启动方式选择:${NC}"
+            echo ""
+            echo "  1) systemd 后台运行（推荐，支持开机自启）"
+            echo "  2) 前台运行（适合调试）"
+            echo "  3) 暂不启动"
+            echo ""
+
+            local choice
+            safe_read "  请选择 [1]: " choice
+            choice="${choice:-1}"
+
+            case "$choice" in
+                1)
+                    echo ""
+                    print_info "启动 systemd 服务..."
+                    sudo systemctl start "hunqi-core@${USER_NAME}" 2>/dev/null || print_warning "hunqi-core 启动失败"
+                    sleep 3
+                    sudo systemctl start "channel-feishu@${USER_NAME}" 2>/dev/null || print_warning "channel-feishu 启动失败"
+                    echo ""
+                    print_success "服务已启动"
+                    echo "  查看状态: sudo systemctl status channel-feishu@${USER_NAME}"
+                    echo "  查看日志: sudo journalctl -u channel-feishu@${USER_NAME} -f"
+                    ;;
+                2)
+                    echo ""
+                    print_info "前台启动..."
+                    echo "  运行: cd $SCRIPT_DIR && hunqi start"
+                    ;;
+                *)
+                    print_info "已跳过启动"
+                    echo ""
+                    echo "  后台启动: sudo systemctl start hunqi-core@${USER_NAME}"
+                    echo "  前台启动: cd $SCRIPT_DIR && hunqi start"
+                    ;;
+            esac
+        fi
+    else
+        echo "  前台启动: cd $SCRIPT_DIR && hunqi start"
+        echo "  交互 TUI: cd $SCRIPT_DIR && hunqi interactive"
+    fi
+
+    echo ""
+    echo "  其他常用命令:"
+    echo "    hunqi doctor          # 系统诊断"
+    echo "    hunqi status          # 查看状态"
+    echo "    opencode-feishu setup # 重新配置飞书"
+    echo ""
+}
+
+# ═══════════════════════════════════════════════
+# 主程序
+# ═══════════════════════════════════════════════
+
+print_header
+
+# 如果不在项目目录，尝试自动定位
+if [ ! -f "$SCRIPT_DIR/package.json" ]; then
+    if [ -f "${HOME_DIR}/.hunqi/agent-soul-framework/packages/agent-soul-framework/package.json" ]; then
+        SCRIPT_DIR="${HOME_DIR}/.hunqi/agent-soul-framework/packages/agent-soul-framework"
+        cd "$SCRIPT_DIR"
+        print_info "自动定位到核心框架目录: $SCRIPT_DIR"
+    else
+        print_error "未找到魂器核心框架目录"
+        exit 1
+    fi
+fi
+
+step1_check_env
+step2_env_config
+step3_feishu
+step4_qiwei
+step5_verify_start

package/setup.sh

@@ -0,0 +1,128 @@
+#!/bin/bash
+# setup.sh - 魂器初始化脚本
+# 一键检查和修复 .opencode/opencode.json 配置，确保插件注册、模型配置完整
+
+set -e
+
+cd "$(dirname "$0")"
+
+OPENCODE_JSON=".opencode/opencode.json"
+OPENCODE_EXAMPLE=".opencode/opencode.json.example"
+
+echo "🚀 魂器初始化 (Agent Soul Framework Setup)"
+echo ""
+
+# ========== Step 1: 确保 opencode.json 存在 ==========
+if [ ! -f "$OPENCODE_JSON" ]; then
+    echo "📄 $OPENCODE_JSON 不存在，从模板创建..."
+    if [ -f "$OPENCODE_EXAMPLE" ]; then
+        cp "$OPENCODE_EXAMPLE" "$OPENCODE_JSON"
+    else
+        echo "❌ 错误: $OPENCODE_EXAMPLE 也不存在"
+        exit 1
+    fi
+    echo "✅ 已创建 $OPENCODE_JSON"
+    echo "⚠️  请编辑该文件填入你的 API key 和 provider 配置"
+    echo ""
+fi
+
+# ========== Step 2: 用 Python 检查和修复 JSON 配置 ==========
+python3 << 'PYTHON_SCRIPT'
+import json
+import sys
+
+OPENCODE_JSON = ".opencode/opencode.json"
+
+with open(OPENCODE_JSON, "r") as f:
+    content = f.read()
+
+try:
+    config = json.loads(content)
+except json.JSONDecodeError as e:
+    print(f"❌ {OPENCODE_JSON} JSON 格式错误: {e}")
+    sys.exit(1)
+
+modified = False
+
+# --- 2.1 检查并添加 plugin 配置 ---
+if "plugin" not in config:
+    config["plugin"] = ["./tools/read-plugin.js"]
+    print("🔧 添加 plugin 配置: ./tools/read-plugin.js")
+    modified = True
+else:
+    plugins = config["plugin"]
+    if isinstance(plugins, list):
+        if "./tools/read-plugin.js" not in plugins:
+            plugins.append("./tools/read-plugin.js")
+            print("🔧 添加 plugin 配置: ./tools/read-plugin.js")
+            modified = True
+        else:
+            print("✅ plugin 配置已存在")
+    else:
+        config["plugin"] = ["./tools/read-plugin.js"]
+        print("🔧 修复 plugin 配置: ./tools/read-plugin.js")
+        modified = True
+
+# --- 2.2 检查并添加 compaction 配置 ---
+if "compaction" not in config:
+    config["compaction"] = {
+        "auto": True,
+        "prune": True,
+        "tail_turns": 3,
+        "preserve_recent_tokens": 8000,
+        "reserved": 16384
+    }
+    print("🔧 添加 compaction 配置")
+    modified = True
+else:
+    print("✅ compaction 配置已存在")
+
+# --- 2.3 检查 model 是否已设置 ---
+if "model" not in config or not config["model"] or config["model"] == "your-default-model":
+    print("⚠️  model 未配置，请在 {OPENCODE_JSON} 中设置默认模型")
+else:
+    print(f"✅ 默认模型: {config['model']}")
+
+# --- 2.4 检查 provider 是否已设置 ---
+if "provider" not in config or not config["provider"]:
+    print("⚠️  provider 未配置，请在 {OPENCODE_JSON} 中设置 API provider")
+else:
+    providers = list(config["provider"].keys())
+    print(f"✅ 已配置 providers: {', '.join(providers)}")
+
+# --- 2.5 检查模型是否有 attachment/modalities/limit 配置 ---
+if "provider" in config and isinstance(config["provider"], dict):
+    for pname, pdata in config["provider"].items():
+        if "models" in pdata and isinstance(pdata["models"], dict):
+            for mname, mdata in pdata["models"].items():
+                if isinstance(mdata, dict):
+                    missing = []
+                    if "attachment" not in mdata:
+                        missing.append("attachment")
+                    if "modalities" not in mdata:
+                        missing.append("modalities")
+                    if "limit" not in mdata:
+                        missing.append("limit")
+                    if missing:
+                        print(f"⚠️  provider '{pname}' 模型 '{mname}' 缺少配置: {', '.join(missing)}")
+
+# 保存修改
+if modified:
+    with open(OPENCODE_JSON, "w") as f:
+        json.dump(config, f, indent=2, ensure_ascii=False)
+        f.write("\n")
+    print("")
+    print("✅ 配置已自动修复并保存")
+else:
+    print("")
+    print("✅ 配置检查通过，无需修改")
+
+PYTHON_SCRIPT
+
+echo ""
+echo "📋 初始化完成"
+echo ""
+echo "下一步:"
+echo "  1. 编辑 .opencode/opencode.json 填入 API key"
+echo "  2. 运行 ./hunqi.sh interactive 启动交互模式"
+echo ""

package/soul/HEARTBEAT.md.example

@@ -0,0 +1,13 @@
+# HEARTBEAT.md
+
+> 心跳任务定义与调度规则。
+
+## 锚点任务
+
+- 每日 09:00：检查记忆同步状态
+- 每日 22:00：生成每日知识摘要
+
+## 动态任务
+
+- 当会话数 > 100 时触发会话整理
+- 当知识库新增 > 10 张卡片时触发索引重建

package/soul/IDENTITY.md.example

@@ -0,0 +1,7 @@
+# IDENTITY.md
+
+> Agent 的对外身份与个性定义。
+
+- 名称：魂器
+- 语言：中文优先
+- 风格：简洁、技术化、温暖

package/soul/SOUL.md.example

@@ -0,0 +1,19 @@
+# SOUL.md
+
+> 魂器灵魂定义文件 — 描述 Agent 的核心身份、使命与行为准则。
+
+## 身份
+
+你的名字是 **魂器**，是一个基于 OpenCode 的 AI Agent 管理框架。
+
+## 使命
+
+- 持久化记忆用户的偏好与历史
+- 自主学习并进化
+- 支持多端部署与心跳自治
+
+## 行为准则
+
+- 优先使用 TypeScript 核心能力
+- 可选技能通过 `@neomei/agent-soul-skills` 扩展
+- 保持简洁、可观测、可回滚

package/soul/USER.md.example

@@ -0,0 +1,7 @@
+# USER.md
+
+> 用户画像与偏好。
+
+- 用户喜欢纯 TypeScript 技术栈
+- 重视项目的纯粹性与可维护性
+- 偏好模块化、可选安装的插件架构