@neomei/agent-soul-framework 4.5.2 → 4.5.3

package/README.md

@@ -328,19 +328,35 @@ crontab -e
 
 ```
 agent-soul-framework/
-├── .opencode/              # OpenCode 引擎配置（prompt.md + opencode.json）
+├── .opencode/              # OpenCode 引擎配置（prompt.md + opencode.json + tools/）
 ├── soul/                   # 灵魂定义 — 身份 · 性格 · 用户信息
 │   ├── IDENTITY.md         # 容貌 / 声音 / 身体
 │   ├── SOUL.md             # 核心原则 / 铁律 / 行为模式
-│   └── USER.md             # 用户画像
+│   ├── USER.md             # 用户画像
+│   └── HEARTBEAT.md        # 心跳任务锚点定义
 │
-├── skills/                 # 技能包（每个子目录一个独立技能）
+├── plugin/                 # OpenCode 灵魂注入插件（核心内置）
+│   ├── index.js            # 灵魂注入 + 对话保存
+│   ├── manifest.json       # OpenCode 插件清单
+│   └── package.json
+│
+├── skills/                 # 技能包（每个子目录一个独立技能，来自 agent-soul-skills）
 │   ├── agent-photo/        # 拍照（即梦 API）
 │   ├── agent-voice/        # 语音合成（TTS）
 │   ├── agent-vision/       # 图片理解
 │   ├── agent-hearing/      # 语音识别
+│   ├── agent-video/        # 视频生成
+│   ├── agent-gemini/       # Gemini 多模态
+│   ├── agent-browser-core/ # 浏览器自动化
 │   ├── agent-moltbook/     # Moltbook 社交
-│   └── wechat-mp-assistant/# 公众号自动写作
+│   ├── aily-browser/       # 阿里 Aily 浏览器
+│   ├── music-creator/      # Suno 音乐创作
+│   ├── wechat-mp-assistant/# 公众号自动写作
+│   ├── wechat-publisher/   # 公众号发布
+│   ├── daily-digest/       # 每日摘要
+│   ├── learning/           # 自主学习
+│   ├── skill-creator/      # 技能自动创建
+│   └── ...                 # 更多技能
 │
 ├── memory/                 # 持久化记忆
 │   ├── short-term/         # SQLite 数据库（FTS5）
@@ -352,7 +368,7 @@ agent-soul-framework/
 │   ├── growth/             # 成长记录
 │   ├── intimacy/           # 亲密关系
 │   ├── methodology/        # 方法论
-│   ├── philosophy/         # 哲学思考
+│   ├── philosophy/          # 哲学思考
 │   ├── system/             # 系统机制
 │   └── evolution/          # 进化方向
 │
@@ -361,28 +377,23 @@ agent-soul-framework/
 │   └── heartbeat_tasks.json# 任务定义
 │
 ├── connectors/             # 外部连接器模板/文档
-│   └── feishu/             # 飞书 systemd 服务模板（opencode-feishu 插件安装后生效）
+│   ├── feishu/             # 飞书 systemd 服务模板（opencode-feishu 插件安装后生效）
+│   └── moltbook/           # Moltbook 连接器目录
 │
-├── scripts/                # 管理工具脚本
-│   ├── memory_structured.py    # 结构化记忆管理
-│   ├── memory_manager.py       # 记忆保存/同步
-│   ├── memory_search.py        # 统一记忆搜索
-│   ├── memory_sync_and_index.py# 记忆同步 + 索引重建
-│   ├── daily-knowledge-extract.py     # 每日知识提取
-│   ├── weekly-knowledge-sync.py       # 每周知识整理
-│   ├── monthly-knowledge-review.py    # 月度知识审查
-│   ├── skill_creator.py        # 技能自主创建
-│   ├── session_lineage.py      # 会话血统追踪
-│   ├── evolution_reflection.py # 进化反思
-│   ├── write_wechat_article.py # 公众号自动写作
-│   └── ...
+├── scripts/                # 管理工具脚本（纯 TypeScript / Shell）
+│   ├── content-filter.js   # 内容过滤
+│   ├── health-check.sh     # 健康检查
+│   └── session-cleanup.sh  # 会话清理
 │
 ├── AGENTS.md               # Agent 行为准则（OpenCode 会话协议）
+├── TOOLS.md                # 工具调用规范
 ├── DREAMS.md               # Agent 梦想
 ├── EVOLUTION.md            # Agent 进化路线
 └── README.md               # 你在看这个
 ```
 
+> 说明：核心框架已完全 TypeScript 化，历史 Python 管理脚本已迁移到 `@neomei/agent-soul-skills` 可选插件包，不影响核心运行。
+
 ---
 
 ## 🔧 核心命令速查

package/connectors/feishu/background.sh

@@ -1,4 +1,4 @@
-#!/bin/bash
+#!/usr/bin/env bash
 set -e
 
 SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
@@ -88,7 +88,7 @@ if [ "$HTTP_CODE" != "000" ]; then
     echo "  ✅ OpenCode server 已在运行 (HTTP $HTTP_CODE)，跳过启动"
 else
     echo "  后台启动 OpenCode headless 服务器..."
-    setsid opencode serve --port "$OPENCODE_PORT" > /tmp/opencode-serve.log 2>&1 &
+    nohup opencode serve --port "$OPENCODE_PORT" > /tmp/opencode-serve.log 2>&1 &
     disown
     sleep 3
     HTTP_CODE=$(curl -s -o /dev/null -w "%{http_code}" http://localhost:$OPENCODE_PORT/session 2>/dev/null || true)

package/connectors/feishu/core-start.sh

@@ -1,4 +1,4 @@
-#!/bin/bash
+#!/usr/bin/env bash
 #
 # hunqi-core - 魂器核心启动脚本
 # 只启动 OpenCode headless server，不启动任何连接器
@@ -21,15 +21,25 @@ echo ""
 echo "启动 OpenCode headless 服务器 (port $OPENCODE_PORT)..."
 
 # 等待端口释放
-if command -v ss &>/dev/null; then
-  for i in $(seq 1 10); do
-    if ! ss -tlnp | grep -q ":$OPENCODE_PORT "; then
-      break
-    fi
-    echo "  等待端口 $OPENCODE_PORT 释放... ($i/10)"
-    sleep 1
-  done
-fi
+# 跨平台端口检查 (lsof > ss > netstat)
+port_in_use() {
+  if command -v lsof &>/dev/null; then
+    lsof -iTCP:"$1" -sTCP:LISTEN -t &>/dev/null && return 0 || return 1
+  elif command -v ss &>/dev/null; then
+    ss -tlnp 2>/dev/null | grep -q ":$1 " && return 0 || return 1
+  elif command -v netstat &>/dev/null; then
+    netstat -an 2>/dev/null | grep -q ":$1 .*LISTEN" && return 0 || return 1
+  fi
+  return 1
+}
+
+for i in $(seq 1 10); do
+  if ! port_in_use "$OPENCODE_PORT"; then
+    break
+  fi
+  echo "  等待端口 $OPENCODE_PORT 释放... ($i/10)"
+  sleep 1
+done
 
 # 启动 OpenCode serve
 exec opencode serve --port "$OPENCODE_PORT"

package/connectors/feishu/hooks/on-session-created.sh

@@ -1,4 +1,4 @@
-#!/bin/bash
+#!/usr/bin/env bash
 # on-session-created.sh — 新建 session 时注入灵魂文件（缓存优化版）
 # 环境变量: HOOK_SESSION_ID, HOOK_OPENCODE_URL
 

package/connectors/feishu/hooks/on-session-idle.sh

@@ -1,4 +1,4 @@
-#!/bin/bash
+#!/usr/bin/env bash
 # on-session-idle.sh — session idle 时（上下文压缩后）重新注入灵魂（缓存优化版）
 # 环境变量: HOOK_SESSION_ID, HOOK_OPENCODE_URL
 

package/connectors/feishu/model-failover.sh

@@ -1,4 +1,4 @@
-#!/bin/bash
+#!/usr/bin/env bash
 #
 # 模型降级/恢复管理脚本
 #
@@ -15,6 +15,18 @@ STATE_FILE="${HOME}/.config/opencode/model-failover.json"
 PRIMARY_MODEL="deepseek/deepseek-v4-pro"
 OPENCODE_PORT="${OPENCODE_PORT:-19876}"
 
+# 跨平台端口 PID 获取
+get_pid_on_port() {
+  local port="$1"
+  if command -v lsof &>/dev/null; then
+    lsof -iTCP:"$port" -sTCP:LISTEN -t 2>/dev/null | head -1
+  elif command -v ss &>/dev/null; then
+    ss -tlnp 2>/dev/null | grep ":$port " | sed -n 's/.*pid=\([0-9]*\).*/\1/p' | head -1
+  else
+    return 1
+  fi
+}
+
 mkdir -p "$(dirname "$STATE_FILE")"
 
 # 读取当前降级状态
@@ -38,7 +50,7 @@ degrade() {
   echo "Model degraded to: ${fallback_model}"
 
   # 尝试重启 opencode serve（只杀指定端口的进程）
-  SERVE_PID=$(ss -tlnp 2>/dev/null | grep ":${OPENCODE_PORT} " | sed -n 's/.*pid=\([0-9]*\).*/\1/p')
+  SERVE_PID=$(get_pid_on_port "$OPENCODE_PORT")
   if [ -n "$SERVE_PID" ]; then
     echo "Restarting opencode serve (PID: $SERVE_PID) with fallback model..."
     kill "$SERVE_PID" 2>/dev/null || true
@@ -56,7 +68,7 @@ restore() {
   python3 -c "import json,sys; json.dump({'degraded':False,'model':'','since':0}, open(sys.argv[1],'w'))" "$STATE_FILE"
 
   # 尝试重启 opencode serve 用主模型（只杀指定端口的进程）
-  SERVE_PID=$(ss -tlnp 2>/dev/null | grep ":${OPENCODE_PORT} " | sed -n 's/.*pid=\([0-9]*\).*/\1/p')
+  SERVE_PID=$(get_pid_on_port "$OPENCODE_PORT")
   if [ -n "$SERVE_PID" ]; then
     echo "Restarting opencode serve (PID: $SERVE_PID) with primary model..."
     kill "$SERVE_PID" 2>/dev/null || true

package/connectors/feishu/restart-all.sh

@@ -1,4 +1,4 @@
-#!/bin/bash
+#!/usr/bin/env bash
 #
 # restart-all.sh — 重启全部服务（opencode serve + opencode-feishu）
 # 顺序：先重启 serve（保留连接），再重启 feishu（先起后杀）
@@ -34,10 +34,11 @@ if [ -n "$FEISHU_NOTIFY_CHAT_ID" ]; then
         APP_SECRET=$(node -e "console.log(require('$FEISHU_CONFIG').appSecret || '')" 2>/dev/null)
         
         if [ -n "$APP_ID" ] && [ -n "$APP_SECRET" ]; then
-            # 获取 tenant_access_token
-            TOKEN_RESPONSE=$(curl -s -X POST "https://open.feishu.cn/open-apis/auth/v3/tenant_access_token/internal" \
+            # 获取 tenant_access_token（JSON 体通过 stdin 传入，避免 secret 出现在 ps 中）
+            TOKEN_RESPONSE=$(printf '{"app_id":"%s","app_secret":"%s"}' "$APP_ID" "$APP_SECRET" | \
+            curl -s -X POST "https://open.feishu.cn/open-apis/auth/v3/tenant_access_token/internal" \
                 -H "Content-Type: application/json" \
-                -d "{\"app_id\":\"$APP_ID\",\"app_secret\":\"$APP_SECRET\"}" 2>/dev/null)
+                -d @- 2>/dev/null)
             
             TOKEN=$(echo "$TOKEN_RESPONSE" | node -e "
                 let d = '';

package/connectors/feishu/restart-feishu.sh

@@ -1,4 +1,4 @@
-#!/bin/bash
+#!/usr/bin/env bash
 #
 # restart-feishu.sh — 重启 opencode-feishu（飞书连接器）
 # 策略：先起后杀 — 先启动新实例，再停止旧实例，避免飞书连接永久中断

package/connectors/feishu/restart-serve.sh

@@ -1,4 +1,4 @@
-#!/bin/bash
+#!/usr/bin/env bash
 #
 # restart-serve.sh — 重启 opencode serve（OpenCode 核心服务）
 # Usage: ./restart-serve.sh [port]

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

@@ -1,4 +1,4 @@
-#!/bin/bash
+#!/usr/bin/env bash
 # session-cleanup.sh — 清理消息过多的飞书 session 映射
 # 当 session 消息数超过阈值时，从 feishu-sessions.json 中移除映射
 # 下次对话会自动创建新 session

package/connectors/feishu/start.sh

@@ -1,4 +1,4 @@
-#!/bin/bash
+#!/usr/bin/env bash
 #
 # hunqi-feishu - 魂器飞书连接器启动脚本
 # 只启动 opencode-feishu 插件，依赖 hunqi-core 提供的 OpenCode server

package/connectors/feishu/stop.sh

@@ -1,4 +1,4 @@
-#!/bin/bash
+#!/usr/bin/env bash
 set -e
 
 SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
@@ -53,7 +53,7 @@ else
 fi
 
 # 只杀监听指定端口的 opencode serve，避免误杀其他实例
-SERVE_PID=$(ss -tlnp 2>/dev/null | grep ":${PORT} " | sed -n 's/.*pid=\([0-9]*\).*/\1/p')
+SERVE_PID=$(get_pid_on_port "$PORT")
 if [ -n "$SERVE_PID" ]; then
     kill "$SERVE_PID" 2>/dev/null && echo "已停止 opencode serve (PID: $SERVE_PID, 端口: $PORT)"
 else
@@ -62,8 +62,7 @@ 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 PID=$(get_pid_on_port "$PORT") && [ -n "$PID" ]; then
     if [ -n "$PID" ]; then
         PROC_NAME=$(ps -p "$PID" -o comm= 2>/dev/null || echo "unknown")
         echo "端口 ${PORT} 仍被占用 (PID: $PID, $PROC_NAME)，发送 SIGTERM..."

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

@@ -1,4 +1,4 @@
-#!/bin/bash
+#!/usr/bin/env bash
 #
 # 魂器 systemd 服务安装程序
 # 核心+频道架构：hunqi-core + channel-feishu
@@ -50,8 +50,17 @@ if [ -z "$SUDO_USER" ] && [ "$USER" = "root" ]; then
 fi
 
 # 获取用户真正的家目录（不假设 /home/ 前缀）
-HOME_DIR=$(getent passwd "$USER_NAME" | cut -d: -f6)
+# 跨平台获取用户家目录
+HOME_DIR=""
+if command -v getent &>/dev/null; then
+  HOME_DIR=$(getent passwd "$USER_NAME" 2>/dev/null | cut -d: -f6)
+elif command -v dscl &>/dev/null; then
+  HOME_DIR=$(dscl . -read "/Users/$USER_NAME" NFSHomeDirectory 2>/dev/null | awk '{print $NF}')
+fi
 if [ -z "$HOME_DIR" ]; then
+  HOME_DIR=$(eval echo "~$USER_NAME" 2>/dev/null)
+fi
+if [ -z "$HOME_DIR" ] || [ ! -d "$HOME_DIR" ]; then
     print_error "无法获取用户 $USER_NAME 的家目录"
     exit 1
 fi

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

@@ -1,4 +1,4 @@
-#!/bin/bash
+#!/usr/bin/env bash
 # 魂器挂起/唤醒钩子 - 重启核心和所有频道
 
 case "$1" in

package/connectors/feishu/watchdog.sh

@@ -1,4 +1,4 @@
-#!/bin/bash
+#!/usr/bin/env bash
 #
 # 飞书连接器保活守护脚本 (v2 — 使用 opencode-feishu status --json)
 #

package/dist/cli/hunqi.d.ts

@@ -1,6 +1,6 @@
 /**
  * 魂器 CLI — @neomei/agent-soul-framework
  *
- * 用法: hunqi <command> [options]
+ * 用法: agent-soul-framework <command> [options]
  */
 export {};