@neomei/agent-soul-framework 4.5.2 → 4.5.3

package/install.sh

@@ -3,299 +3,32 @@
 # 用法: curl -fsSL https://raw.githubusercontent.com/NeoMei/agent-soul-framework/master/install.sh | bash
 set -e
 
-# 错误处理：打印行号和命令
-trap 'echo "❌ 安装脚本在第 ${LINENO} 行出错: $BASH_COMMAND" >&2; exit 1' ERR
-
-# 警告：如果通过管道执行且需要交互式输入，建议先下载再执行
-if [ ! -t 0 ]; then
-    echo "⚠️  检测到通过管道执行 (curl | bash)。建议先下载再执行以避免下载中断:"
-    echo "    curl -fsSL https://raw.githubusercontent.com/NeoMei/agent-soul-framework/master/install.sh -o install.sh"
-    echo "    bash install.sh"
-    echo ""
-    sleep 2
-fi
-
-REPO="https://github.com/NeoMei/agent-soul-framework.git"
-HUNQI_HOME="${HOME}/.hunqi"
-
-echo "🔮 魂器 · Agent Soul Framework 安装脚本"
+echo "🔮 魂器 · Agent Soul Framework"
 echo ""
 
 # 检查 Node.js
 if ! command -v node &>/dev/null; then
-  echo "❌ 未检测到 Node.js，请先安装 Node.js ≥ 20"
+  echo "❌ 未检测到 Node.js，请先安装 Node.js >= 20"
   exit 1
 fi
 NODE_VERSION=$(node -v | sed 's/v//')
 NODE_MAJOR=$(echo "$NODE_VERSION" | cut -d. -f1)
 if [ "$NODE_MAJOR" -lt 20 ]; then
-  echo "❌ Node.js 版本过低: $NODE_VERSION，需要 ≥ 20"
+  echo "❌ Node.js 版本过低: $NODE_VERSION，需要 >= 20"
   exit 1
 fi
 echo "✅ Node.js $NODE_VERSION"
 
-# 检查 OpenCode 引擎
-if ! command -v opencode &>/dev/null; then
-  echo ""
-  echo "⚠️  未检测到 OpenCode 引擎"
-  echo "   hunqi-core 服务依赖 opencode，必须安装才能运行"
-  echo ""
-  if [ -t 0 ] || [ -e /dev/tty ]; then
-    read -p "是否自动安装 OpenCode？(Y/n) " -n 1 -r < /dev/tty
-    echo
-    if [[ ! $REPLY =~ ^[Nn]$ ]]; then
-      echo "  正在安装 opencode-ai..."
-      npm install -g opencode-ai || {
-        echo "❌ OpenCode 安装失败"
-        echo "   请手动运行: npm install -g opencode-ai"
-        exit 1
-      }
-      echo "✅ OpenCode 已安装"
-    else
-      echo "⚠️  跳过 OpenCode 安装"
-      echo "   请注意：hunqi-core 服务将无法启动"
-      echo "   后续手动安装: npm install -g opencode-ai"
-    fi
-  else
-    echo "⚠️  非交互式环境，跳过 OpenCode 安装"
-    echo "   请手动运行: npm install -g opencode-ai"
-  fi
-else
-  echo "✅ OpenCode 已安装"
-fi
-
-# 检查 npm 全局安装权限
-if ! npm prefix -g &>/dev/null; then
-  echo "❌ npm 全局目录不可写，请检查权限或配置 npm prefix"
-  exit 1
-fi
-
-# Python（仅在使用可选技能包时需要）
-if command -v python3 &>/dev/null; then
-  echo "✅ Python $(python3 --version 2>&1 | cut -d' ' -f2)（可选技能包需要）"
-else
-  echo "⚠️  Python 未安装（仅影响可选技能包 @neomei/agent-soul-skills）"
-fi
-
-# 检查磁盘空间（至少 500MB）
-AVAILABLE_MB=$(df -m "$HOME" 2>/dev/null | awk 'NR==2 {print $4}')
-if [ -n "$AVAILABLE_MB" ] && [ "$AVAILABLE_MB" -lt 500 ]; then
-  echo "❌ 磁盘空间不足: ${AVAILABLE_MB}MB 可用，至少需要 500MB"
-  exit 1
-fi
-
-# 检查端口占用
-if command -v ss &>/dev/null && ss -tlnp 2>/dev/null | grep -q ":19876 "; then
-  echo "⚠️  端口 19876 已被占用，安装完成后请确认无冲突"
-fi
-
-# 下载 + 构建魂器
- echo ""
- echo "📦 安装魂器核心框架..."
- rm -rf "${HUNQI_HOME}/agent-soul-framework"
- git clone --depth 1 "${REPO}" "${HUNQI_HOME}/agent-soul-framework"
- 
- cd "${HUNQI_HOME}/agent-soul-framework"
- echo "  安装 npm 依赖..."
- npm install || { echo "❌ npm install 失败"; exit 1; }
- echo "  构建项目..."
- npm run build || { echo "❌ npm run build 失败"; exit 1; }
- 
- # 全局链接核心框架
- npm uninstall -g @neomei/agent-soul-framework @neomei/agent-soul 2>/dev/null || true
- cd "${HUNQI_HOME}/agent-soul-framework/packages/agent-soul-framework"
- npm link || { echo "❌ npm link 核心框架失败"; exit 1; }
- cd "${HUNQI_HOME}/agent-soul-framework"
-
-# 安装核心框架（channel 插件由用户按需单独安装）
- echo "📦 安装魂器核心框架..."
- npm install -g @neomei/agent-soul-framework@latest || {
-   echo "❌ 核心框架安装失败"
-   echo "   请检查网络连接和 npm registry 可访问性"
-   exit 1
- }
- 
- # 全局链接核心框架（开发/本地 clone 模式）
- # cd "${HUNQI_HOME}/agent-soul-framework/packages/agent-soul-framework"
- # npm link || { echo "❌ npm link 核心框架失败"; exit 1; }
- # cd "${HUNQI_HOME}/agent-soul-framework"
-
-# 可选：如需飞书/企微通道，请手动安装：
-# npm install -g @neomei/opencode-feishu @neomei/opencode-qiwei
-
-# 初始化默认项目
-echo "📝 初始化配置..."
-mkdir -p "${HUNQI_HOME}"/{soul,skills,knowledge,memory/{short-term,long-term},.opencode}
-
-# 复制模板文件（使用 while read 处理文件名中的空格）
-find "${HUNQI_HOME}/agent-soul-framework/packages/agent-soul-framework" -name "*.example" -type f 2>/dev/null | while IFS= read -r f; do
-  rel="${f#${HUNQI_HOME}/agent-soul-framework/packages/agent-soul-framework/}"
-  target="${HUNQI_HOME}/${rel%.example}"
-  if [ ! -f "$target" ]; then
-    mkdir -p "$(dirname "$target")"
-    cp "$f" "$target"
-  fi
-done
-
-# 复制技能包（先清理再复制，避免嵌套目录）
-if [ -d "${HUNQI_HOME}/skills" ]; then
-  rm -rf "${HUNQI_HOME}/skills"
-fi
-cp -r "${HUNQI_HOME}/agent-soul-framework/packages/agent-soul-skills/skills" "${HUNQI_HOME}/skills"
-
-# .env（如果已存在则保留，避免覆盖用户配置）
-ENV_FILE="${HUNQI_HOME}/.env"
-if [ ! -f "$ENV_FILE" ]; then
-  cat > "$ENV_FILE" << 'EOF'
-# 魂器环境配置
-DASHSCOPE_API_KEY=
-FEISHU_APP_ID=
-FEISHU_APP_SECRET=
-JIMENG_API_KEY=
-EOF
-fi
-
-# 同时创建项目目录下的 .env（供脚本直接加载）
-PROJECT_ENV="${HUNQI_HOME}/agent-soul-framework/.env"
-if [ ! -f "$PROJECT_ENV" ]; then
-  cp "$ENV_FILE" "$PROJECT_ENV"
-fi
-
-# 首次心跳
- echo "💓 初始化记忆系统..."
- cd "${HUNQI_HOME}"
- if command -v hunqi-heartbeat &>/dev/null; then
-   hunqi-heartbeat || {
-     echo "⚠️  心跳初始化失败（非致命，可后续手动运行）"
-   }
- else
-   echo "⚠️  hunqi-heartbeat 未找到，跳过心跳初始化"
- fi
- 
- # crontab
- if ! crontab -l 2>/dev/null | grep -q "heartbeat_wrapper"; then
-   (crontab -l 2>/dev/null || true; echo "*/30 * * * * cd ${HUNQI_HOME} && ${HUNQI_HOME}/agent-soul-framework/packages/agent-soul-framework/heartbeat_wrapper.sh") | crontab -
- fi
-
-# systemd 服务（可选）
-echo ""
-if [ "${AUTO_SYSTEMD:-0}" = "1" ]; then
-  echo "🤖 自动模式: 安装 systemd 服务..."
-  REPLY="y"
-else
-  read -p "是否安装 systemd 服务（支持开机启动和挂起/恢复自动恢复）？(Y/n) " -n 1 -r < /dev/tty
-  echo
-fi
-if [[ ! $REPLY =~ ^[Nn]$ ]]; then
-  cd "${HUNQI_HOME}/agent-soul-framework/packages/agent-soul-framework"
-  if [ -f "connectors/feishu/systemd/install-systemd.sh" ]; then
-    sudo bash connectors/feishu/systemd/install-systemd.sh
-    echo "✅ systemd 服务已安装"
-    echo "   启动核心:   sudo systemctl start hunqi-core@\$USER"
-    echo "   启动飞书:   sudo systemctl start channel-feishu@\$USER"
-    echo "   查看日志:   sudo journalctl -u hunqi-core@\$USER -f"
-  else
-    echo "⚠️  systemd 安装脚本不存在，跳过"
-  fi
-fi
-
-# 配置向导（统一配置 .env + 连接器）
-echo ""
-if [ "${AUTO_WIZARD:-0}" = "1" ]; then
-  # 自动向导模式：
-  # - 有 tty 时，交互式运行（支持飞书扫码配置）
-  # - 无 tty 时（curl | bash），提示用户下载后单独运行
-  if [ -t 0 ]; then
-    echo "🤖 自动模式: 运行配置向导..."
-    REPLY="y"
-  else
-    echo "⚠️  检测到管道执行，无法交互配置飞书"
-    echo "   如需完整配置（含飞书扫码），请运行："
-    echo ""
-    echo "     curl -fsSL https://raw.githubusercontent.com/NeoMei/agent-soul-framework/master/install.sh -o install.sh"
-    echo "     bash install.sh"
-    echo ""
-    REPLY="n"
-  fi
-else
-  echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
-  echo ""
-  read -p "是否运行初始配置向导（设置 API Key、飞书/企微连接）？(Y/n) " -n 1 -r < /dev/tty
-  echo
-fi
-if [[ ! $REPLY =~ ^[Nn]$ ]]; then
-  cd "${HUNQI_HOME}/agent-soul-framework/packages/agent-soul-framework"
-  if [ -f "setup-wizard.sh" ]; then
-    if [ "${AUTO_WIZARD:-0}" = "1" ] && [ ! -t 0 ]; then
-      # 管道模式下以非交互方式运行（只启动服务，不配置连接器）
-      NONINTERACTIVE=1 bash setup-wizard.sh
-    else
-      # 有 tty 时交互式运行（完整的配置向导，含飞书扫码）
-      bash setup-wizard.sh
-    fi
-  fi
-fi
-
-# 安装后验证
+# 安装
 echo ""
-echo "🔍 验证安装..."
-INSTALL_OK=1
-if command -v hunqi &>/dev/null; then
-  echo "  ✅ hunqi 命令可用"
-else
-  echo "  ❌ hunqi 命令不可用（可能需要重新打开终端或 source ~/.bashrc）"
-  INSTALL_OK=0
-fi
-
-# channel 插件为可选组件，不影响核心安装成功判定
-if command -v opencode-feishu &>/dev/null; then
-  echo "  ✅ opencode-feishu 可用（可选 channel 插件）"
-else
-  echo "  ℹ️  opencode-feishu 未安装，如需飞书通道请运行: npm install -g @neomei/opencode-feishu"
-fi
-if command -v opencode-qiwei &>/dev/null; then
-  echo "  ✅ opencode-qiwei 可用（可选 channel 插件）"
-else
-  echo "  ℹ️  opencode-qiwei 未安装，如需企微通道请运行: npm install -g @neomei/opencode-qiwei"
-fi
+echo "📦 npm install -g @neomei/agent-soul-framework..."
+npm install -g @neomei/agent-soul-framework@latest || {
+  echo "❌ 安装失败，请检查网络连接"
+  exit 1
+}
+echo "✅ 安装完成"
 
+# 初始化
 echo ""
-if [ "$INSTALL_OK" -eq 1 ]; then
-  echo "✅ 安装完成！"
-else
-  echo "⚠️  安装完成，但部分组件需要手动排查"
-fi
-echo ""
-if [ -f "/etc/systemd/system/hunqi-core@${USER}.service" ]; then
-  echo "  ✅ systemd 服务已安装，推荐用法:"
-  echo "     sudo systemctl start hunqi-core@${USER}     # 启动核心"
-  echo "     sudo systemctl start channel-feishu@${USER} # 启动飞书"
-  echo "     sudo systemctl status channel-feishu@${USER} # 查看状态"
-  echo ""
-  echo "  前端交互（需要图形界面）:"
-  echo "    hunqi start          # 一键启动全部服务（前台）"
-else
-  echo "  现在运行:"
-  echo "    hunqi start          # 一键启动本地服务"
-fi
-echo ""
-echo "  可选 channel 插件（按需安装）:"
-echo "    npm install -g @neomei/opencode-feishu   # 飞书通道"
-echo "    npm install -g @neomei/opencode-qiwei    # 企业微信通道"
-echo ""
-echo "  连接器配置:"
-echo "    opencode-feishu setup  # 飞书配置向导"
-echo "    opencode-feishu doctor # 检查飞书连接"
-echo "    opencode-qiwei setup   # 企微配置向导"
-echo ""
-if [ "${BASHRC_UPDATED:-0}" -eq 1 ]; then
-  echo "  💡 PATH 已更新，请运行: source ~/.bashrc"
-  echo ""
-fi
-if ! command -v opencode &>/dev/null; then
-  echo "  ⚠️  OpenCode 未安装，hunqi-core 服务将无法启动"
-  echo "     安装命令: npm install -g opencode-ai"
-  echo ""
-fi
-echo "  卸载:"
-echo "    curl -fsSL https://raw.githubusercontent.com/NeoMei/agent-soul-framework/master/uninstall.sh | bash"
+echo "🔧 agent-soul-framework setup..."
+agent-soul-framework setup

package/package.json

@@ -1,14 +1,14 @@
 {
   "name": "@neomei/agent-soul-framework",
-  "version": "4.5.2",
+  "version": "4.5.3",
   "description": "魂器核心框架 — 基于 OpenCode 的 AI Agent 管理层框架。持久记忆 · 自主学习 · 多端部署 · 心跳自治（纯 TypeScript）",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "bin": {
-    "hunqi": "bin/hunqi",
-    "hunqi-heartbeat": "dist/heartbeat/runner.js",
-    "hunqi-knowledge": "bin/hunqi-knowledge"
+    "agent-soul-framework": "bin/hunqi",
+    "agent-soul-heartbeat": "dist/heartbeat/runner.js",
+    "agent-soul-knowledge": "bin/hunqi-knowledge"
   },
   "files": [
     "dist",

package/scripts/content-filter.js

@@ -150,7 +150,9 @@ export class ContentFilter {
      */
     static logBlock(text, userId, classification) {
         const timestamp = new Date().toISOString();
-        const logEntry = `[${timestamp}] BLOCKED user=${userId} classification=${classification} text="${text.substring(0, 100)}"\n`;
+        const crypto = require('crypto');
+        const uidHash = crypto.createHash('sha256').update(String(userId)).digest('hex').substring(0, 12);
+        const logEntry = `[${timestamp}] BLOCKED user=${uidHash} classification=${classification} text="${text.substring(0, 100)}"\n`;
         
         try {
             const fs = require('fs');

package/scripts/health-check.sh

@@ -1,4 +1,4 @@
-#!/bin/bash
+#!/usr/bin/env bash
 #
 # 魂器健康检查与自动恢复脚本
 # 用途：检测 OpenCode serve 和飞书连接器状态，卡死时自动重启
@@ -83,7 +83,7 @@ restart_services() {
     log "  启动 OpenCode serve..."
     cd "$PROJECT_DIR"
     export $(grep -v '^#' .env | xargs)
-    setsid bash -c "nohup opencode serve --port $OPENCODE_PORT > /tmp/opencode-serve.log 2>&1 &" >/dev/null 2>&1
+    nohup bash -c " opencode serve --port $OPENCODE_PORT > /tmp/opencode-serve.log 2>&1 &" >/dev/null 2>&1
     
     # 等待 serve 就绪
     local retries=0

package/scripts/session-cleanup.sh

@@ -1,4 +1,4 @@
-#!/bin/bash
+#!/usr/bin/env bash
 #
 # 会话清理脚本
 # 用途：强制重置 stuck/busy 状态的会话，无需重启服务

package/start-feishu-daemon.sh

@@ -1,4 +1,4 @@
-#!/bin/bash
+#!/usr/bin/env bash
 #
 # start-feishu-daemon.sh - 稳定启动飞书连接器（守护进程模式）
 # 解决终端超时信号导致的进程终止问题
@@ -100,7 +100,7 @@ done
 # setsid: 创建新会话，忽略 SIGHUP
 # nohup: 忽略挂起信号
 FEISHU_BIN="$(command -v opencode-feishu || echo "$HOME/.npm-global/bin/opencode-feishu")"
-nohup setsid "$FEISHU_BIN" start >> "$LOG_FILE" 2>&1 &
+nohup "$FEISHU_BIN" start >> "$LOG_FILE" 2>&1 &
 disown %1 2>/dev/null || true
 
 # 等待进程真正启动并验证

package/start.sh

@@ -1,4 +1,4 @@
-#!/bin/bash
+#!/usr/bin/env bash
 # start.sh - 启动魂器（Agent Soul Framework）
 
 echo "🚀 启动魂器..."

package/test.sh

@@ -1,4 +1,4 @@
-#!/bin/bash
+#!/usr/bin/env bash
 # test.sh - 测试魂器（Agent Soul Framework）
 
 echo "🧪 测试魂器..."

package/uninstall.sh

@@ -11,7 +11,12 @@ echo ""
 
 # 确认卸载
 echo "⚠️  此操作将删除 ~/.hunqi、~/.config/opencode 和相关配置"
-read -rp "确认卸载？(y/N) " CONFIRM < /dev/tty
+# 安全读取输入 (兼容无 /dev/tty 环境)
+if [ -e /dev/tty ]; then
+  read -rp "确认卸载？(y/N) " CONFIRM < /dev/tty
+else
+  read -rp "确认卸载？(y/N) " CONFIRM 2>/dev/null || CONFIRM="n"
+fi
 echo
 if [[ ! "$CONFIRM" =~ ^[Yy]$ ]]; then
   echo "已取消"
@@ -55,7 +60,13 @@ safe_kill_pidfile "${HOME}/.config/opencode/qiwei.pid" "opencode-qiwei"
 
 # 只杀监听 19876 端口的 opencode serve，避免误杀其他实例
 PORT="${OPENCODE_PORT:-19876}"
-SERVE_PID=$(ss -tlnp 2>/dev/null | grep ":${PORT} " | sed -n 's/.*pid=\([0-9]*\).*/\1/p')
+# 跨平台获取端口 PID
+SERVE_PID=""
+if command -v lsof &>/dev/null; then
+  SERVE_PID=$(lsof -iTCP:"$PORT" -sTCP:LISTEN -t 2>/dev/null | head -1)
+elif command -v ss &>/dev/null; then
+  SERVE_PID=$(ss -tlnp 2>/dev/null | grep ":$PORT " | sed -n 's/.*pid=\([0-9]*\).*/\1/p' | head -1)
+fi
 if [ -n "$SERVE_PID" ]; then
   if kill -0 "$SERVE_PID" 2>/dev/null; then
     kill "$SERVE_PID" 2>/dev/null && echo "  ✅ opencode serve (PID: $SERVE_PID, 端口: $PORT) 已停止" || echo "  ⚠️  停止失败"

package/verify.sh

@@ -1,4 +1,4 @@
-#!/bin/bash
+#!/usr/bin/env bash
 # verify.sh - 验证魂器是否正确加载
 
 echo "🔍 验证魂器配置..."