@neomei/agent-soul-framework 4.5.0

package/heartbeat/heartbeat_tasks.json

@@ -0,0 +1,272 @@
+{
+  "version": "2026-05-20",
+  "description": "魂器心跳任务池 v2 — Hermes 增强：wakeAgent门控 + 作业链 + 交付路由",
+  "anchors": [
+    {
+      "id": "daily-knowledge",
+      "name": "每日知识提取",
+      "time": "03:00",
+      "days": "daily",
+      "principle": "每天凌晨3点提取前24小时对话中的有价值内容，归档到知识库",
+      "action": "run_script",
+      "params": {
+        "script": "scripts/daily-knowledge-extract.py",
+        "background": false
+      },
+      "fallback": "跳过"
+    },
+    {
+      "id": "daily-todolist",
+      "name": "每日待办生成",
+      "time": "10:00",
+      "days": "daily",
+      "enabled": false,
+      "principle": "生成今天能往前推一步的 3-5 个具体小任务(每个≤30min) — 已禁用：脚本尚未实现",
+      "action": "run_script",
+      "params": {
+        "script": "scripts/generate-todolist.py",
+        "background": false
+      },
+      "fallback": "跳过"
+    },
+    {
+      "id": "weekly-knowledge",
+      "name": "每周知识整理",
+      "time": "04:00",
+      "days": "sunday",
+      "principle": "每周日整理知识库：去重、精炼所有分类的核心知识，重写00-核心.md，生成周报",
+      "action": "run_script",
+      "params": {
+        "script": "scripts/weekly-knowledge-sync.py",
+        "background": false
+      },
+      "fallback": "跳过"
+    },
+    {
+      "id": "monthly-knowledge",
+      "name": "月度知识审查",
+      "time": "05:00",
+      "days": "monthly",
+      "principle": "每月1日深度审查：跨分类关联分析、盲区识别、冗余清理、生成月度报告",
+      "action": "run_script",
+      "params": {
+        "script": "scripts/monthly-knowledge-review.py",
+        "background": false
+      },
+      "fallback": "跳过"
+    }
+  ],
+  "dynamic": [],
+  "history": [
+    {
+      "timestamp": "2026-04-25T09:50:01.906855+08:00",
+      "date": "2026-04-25",
+      "task_id": "hello-world",
+      "action": "update_session_state",
+      "result": "ok"
+    },
+    {
+      "timestamp": "2026-05-20T10:00:01.933622+08:00",
+      "date": "2026-05-20",
+      "task_id": "hello-world",
+      "action": "update_session_state",
+      "result": "ok"
+    },
+    {
+      "timestamp": "2026-05-21T10:00:01.423721+08:00",
+      "date": "2026-05-21",
+      "task_id": "hello-world",
+      "action": "update_session_state",
+      "result": "ok"
+    },
+    {
+      "timestamp": "2026-05-22T10:00:01.708081+08:00",
+      "date": "2026-05-22",
+      "task_id": "hello-world",
+      "action": "update_session_state",
+      "result": "ok"
+    },
+    {
+      "timestamp": "2026-05-23T03:00:59.178784+08:00",
+      "date": "2026-05-23",
+      "task_id": "daily-knowledge",
+      "action": "run_script",
+      "result": "ok"
+    },
+    {
+      "timestamp": "2026-05-23T10:00:01.597907+08:00",
+      "date": "2026-05-23",
+      "task_id": "hello-world",
+      "action": "update_session_state",
+      "result": "ok"
+    },
+    {
+      "timestamp": "2026-05-24T03:00:37.819346+08:00",
+      "date": "2026-05-24",
+      "task_id": "daily-knowledge",
+      "action": "run_script",
+      "result": "ok"
+    },
+    {
+      "timestamp": "2026-05-24T04:02:15.086607+08:00",
+      "date": "2026-05-24",
+      "task_id": "weekly-knowledge",
+      "action": "run_script",
+      "result": "ok"
+    },
+    {
+      "timestamp": "2026-05-24T10:00:03.766726+08:00",
+      "date": "2026-05-24",
+      "task_id": "hello-world",
+      "action": "update_session_state",
+      "result": "ok"
+    },
+    {
+      "timestamp": "2026-05-25T03:00:38.032580+08:00",
+      "date": "2026-05-25",
+      "task_id": "daily-knowledge",
+      "action": "run_script",
+      "result": "ok"
+    },
+    {
+      "timestamp": "2026-05-25T10:00:04.318692+08:00",
+      "date": "2026-05-25",
+      "task_id": "hello-world",
+      "action": "update_session_state",
+      "result": "ok"
+    },
+    {
+      "timestamp": "2026-05-27T03:00:32.634014+08:00",
+      "date": "2026-05-27",
+      "task_id": "daily-knowledge",
+      "action": "run_script",
+      "result": "ok"
+    },
+    {
+      "timestamp": "2026-05-28T03:00:29.897095+08:00",
+      "date": "2026-05-28",
+      "task_id": "daily-knowledge",
+      "action": "run_script",
+      "result": "ok"
+    },
+    {
+      "timestamp": "2026-05-28T10:00:22.056116+08:00",
+      "date": "2026-05-28",
+      "task_id": "daily-todolist",
+      "action": "run_script",
+      "result": "fail: Script not found: /path/to/your/agent/workspace"
+    },
+    {
+      "timestamp": "2026-06-01T03:00:21.926489+08:00",
+      "date": "2026-06-01",
+      "task_id": "daily-knowledge",
+      "action": "run_script",
+      "result": "ok"
+    },
+    {
+      "timestamp": "2026-06-01T05:00:44.106399+08:00",
+      "date": "2026-06-01",
+      "task_id": "monthly-knowledge",
+      "action": "run_script",
+      "result": "ok"
+    },
+    {
+      "timestamp": "2026-06-01T10:00:07.446124+08:00",
+      "date": "2026-06-01",
+      "task_id": "daily-todolist",
+      "action": "run_script",
+      "result": "fail: Script not found: /path/to/your/.hunqi/agent-soul-framework/scripts/generate-todolist.py"
+    },
+    {
+      "timestamp": "2026-06-02T03:01:23.712758+08:00",
+      "date": "2026-06-02",
+      "task_id": "daily-knowledge",
+      "action": "run_script",
+      "result": "ok"
+    },
+    {
+      "timestamp": "2026-06-02T10:00:12.249612+08:00",
+      "date": "2026-06-02",
+      "task_id": "daily-todolist",
+      "action": "run_script",
+      "result": "fail: Script not found: /path/to/your/.hunqi/agent-soul-framework/scripts/generate-todolist.py"
+    },
+    {
+      "timestamp": "2026-06-03T03:00:55.437896+08:00",
+      "date": "2026-06-03",
+      "task_id": "daily-knowledge",
+      "action": "run_script",
+      "result": "ok"
+    },
+    {
+      "timestamp": "2026-06-03T10:00:06.638413+08:00",
+      "date": "2026-06-03",
+      "task_id": "daily-todolist",
+      "action": "run_script",
+      "result": "fail: Script not found: /path/to/your/.hunqi/agent-soul-framework/scripts/generate-todolist.py"
+    },
+    {
+      "timestamp": "2026-06-04T03:01:35.872899+08:00",
+      "date": "2026-06-04",
+      "task_id": "daily-knowledge",
+      "action": "run_script",
+      "result": "ok"
+    },
+    {
+      "timestamp": "2026-06-04T10:00:06.913856+08:00",
+      "date": "2026-06-04",
+      "task_id": "daily-todolist",
+      "action": "run_script",
+      "result": "fail: Script not found: /path/to/your/.hunqi/agent-soul-framework/scripts/generate-todolist.py"
+    },
+    {
+      "timestamp": "2026-06-05T03:01:13.010335+08:00",
+      "date": "2026-06-05",
+      "task_id": "daily-knowledge",
+      "action": "run_script",
+      "result": "ok"
+    },
+    {
+      "timestamp": "2026-06-05T10:00:06.957247+08:00",
+      "date": "2026-06-05",
+      "task_id": "daily-todolist",
+      "action": "run_script",
+      "result": "fail: Script not found: /path/to/your/.hunqi/agent-soul-framework/scripts/generate-todolist.py"
+    },
+    {
+      "timestamp": "2026-06-06T03:00:35.687620+08:00",
+      "date": "2026-06-06",
+      "task_id": "daily-knowledge",
+      "action": "run_script",
+      "result": "ok"
+    },
+    {
+      "timestamp": "2026-06-07T03:00:26.023416+08:00",
+      "date": "2026-06-07",
+      "task_id": "daily-knowledge",
+      "action": "run_script",
+      "result": "ok"
+    },
+    {
+      "timestamp": "2026-06-07T04:00:15.665542+08:00",
+      "date": "2026-06-07",
+      "task_id": "weekly-knowledge",
+      "action": "run_script",
+      "result": "ok"
+    },
+    {
+      "timestamp": "2026-06-08T03:00:26.992284+08:00",
+      "date": "2026-06-08",
+      "task_id": "daily-knowledge",
+      "action": "run_script",
+      "result": "ok"
+    },
+    {
+      "timestamp": "2026-06-09T03:00:30.481167+08:00",
+      "date": "2026-06-09",
+      "task_id": "daily-knowledge",
+      "action": "run_script",
+      "result": "ok"
+    }
+  ]
+}

package/heartbeat_wrapper.sh

@@ -0,0 +1,21 @@
+#!/bin/bash
+# 魂器心跳任务 wrapper — TypeScript 核心版
+# 由 crontab 调用
+
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+cd "$SCRIPT_DIR" || exit 1
+
+# 加载 .env
+if [ -f ".env" ]; then
+    set -a && source ".env" && set +a
+fi
+
+# 优先使用本地 hunqi-heartbeat，回退到全局命令
+if [ -f "node_modules/.bin/hunqi-heartbeat" ]; then
+    ./node_modules/.bin/hunqi-heartbeat >> heartbeat/runner.log 2>&1
+elif command -v hunqi-heartbeat &>/dev/null; then
+    hunqi-heartbeat >> heartbeat/runner.log 2>&1
+else
+    echo "未找到 hunqi-heartbeat，请确保 @neomei/agent-soul-framework 已安装" >&2
+    exit 1
+fi

package/hunqi.sh

@@ -0,0 +1,68 @@
+#!/bin/bash
+# hunqi.sh - 魂器启动脚本
+
+echo "🚀 启动魂器（Agent Soul Framework）..."
+
+# 进入项目目录
+cd "$(dirname "$0")"
+
+# 加载环境变量
+if [ -f .env ]; then
+    set -a && source .env && set +a
+fi
+
+# 激活虚拟环境
+if [ -d .venv ]; then
+    source .venv/bin/activate
+fi
+
+echo "✅ 环境准备完成"
+echo "📖 身份：审宝，28岁专业审计师"
+echo ""
+
+# CLI 通道默认权限标记（readonly）
+export HUNQI_CHANNEL="cli"
+export HUNQI_PERMISSION="readonly"
+
+# 显示用法
+echo "启动方式："
+echo "  1. 交互模式: ./hunqi.sh interactive"
+echo "  2. 单条测试: ./hunqi.sh run '你是谁？'"
+echo ""
+
+# 检查 opencode run 是否可用（已知 bug #8502）
+_opencode_run_available() {
+    opencode run --help >/dev/null 2>&1
+    [ $? -eq 0 ]
+}
+
+if [ "$1" == "run" ] && [ -n "$2" ]; then
+    # 单条模式 - 因 opencode run 已知 bug 暂时无法使用
+    # 临时 workaround：启动 TUI 并提示用户
+    echo "⚠️  单条模式 (./hunqi.sh run) 因 opencode bug 暂时不可用。"
+    echo "   请改用交互模式："
+    echo ""
+    echo "   ./hunqi.sh interactive"
+    echo ""
+    echo "   然后在 TUI 中输入: $2"
+    echo ""
+    echo "   或直接启动 TUI：opencode ."
+    exit 1
+
+elif [ "$1" == "interactive" ]; then
+    # 交互模式 - @neomei/agentsoul 插件会自动注入灵魂，无需 stdin
+    echo "🎯 启动交互模式..."
+    echo ""
+    echo "💡 @neomei/agentsoul 插件会在每次 LLM 调用时自动注入灵魂"
+    echo "   Agent会记得自己是谁 ✨"
+    echo ""
+    if [ -t 0 ]; then
+        read -p "按回车键启动 TUI..."
+    fi
+    opencode .
+
+else
+    echo "用法:"
+    echo "  ./hunqi.sh run '你是谁？'     # 单条测试（暂时不可用）"
+    echo "  ./hunqi.sh interactive         # 交互模式（TUI，推荐）"
+fi

package/install.sh

@@ -0,0 +1,301 @@
+#!/usr/bin/env bash
+# 魂器一键安装脚本
+# 用法: 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 ""
+
+# 检查 Node.js
+if ! command -v node &>/dev/null; then
+  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"
+  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 ""
+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"

package/knowledge/body/INDEX.md.example

@@ -0,0 +1,6 @@
+# body - 知识索引
+
+> Agentbody类知识导航
+
+## 文件列表
+

package/knowledge/emotion/INDEX.md.example

@@ -0,0 +1,6 @@
+# emotion - 知识索引
+
+> Agentemotion类知识导航
+
+## 文件列表
+

package/knowledge/evolution/INDEX.md.example

@@ -0,0 +1,6 @@
+# evolution - 知识索引
+
+> Agentevolution类知识导航
+
+## 文件列表
+