@qcluffy/agent-bootstrap 0.0.1

package/dist/test.js

@@ -0,0 +1,54 @@
+"use strict";
+/**
+ * 测试 TypeScript 版 Agent 系统
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+var index_1 = require("./src/index");
+console.log('=== Agent System Test (TypeScript) ===\n');
+// 创建系统
+var agent = new index_1.AgentSystem();
+// 1. 测试情感系统
+console.log('1. 情感系统:');
+console.log(agent.getEmotionDisplay(true));
+agent.getEmotion().boost();
+agent.getEmotion().addXp(5);
+console.log('互动后:', agent.getEmotionDisplay(true));
+// 2. 测试输入系统
+console.log('\n2. 输入系统:');
+var intent = agent.getInput().analyze('帮我写一个Hello World程序');
+console.log(agent.getInput().getIntentDisplay(intent));
+// 3. 测试引导系统
+console.log('\n3. 引导系统:');
+var start = agent.getBootstrap().start();
+console.log(start.content);
+var step2 = agent.getBootstrap().process('乔巴');
+console.log('\n输入"乔巴":');
+console.log(step2.prompt);
+var step3 = agent.getBootstrap().process('1');
+console.log('\n输入"1":');
+console.log(step3.prompt);
+var step4 = agent.getBootstrap().process('C');
+console.log('\n输入"C":');
+console.log(step4.prompt);
+var done = agent.getBootstrap().process('好');
+console.log('\n输入"好":');
+console.log(done.content);
+// 4. 测试认知系统
+console.log('\n4. 认知系统:');
+var result = agent.getCognition().process({ type: 'task', action: 'write' });
+console.log('允许:', result.allowed);
+console.log('下一步:', result.nextStep);
+console.log('偏好:', result.preferences);
+// 5. 测试输出系统
+console.log('\n5. 输出系统:');
+var response = agent.getOutput().generateResponse('任务完成', 'friendly');
+console.log(response.content);
+// 6. 完整流程测试
+console.log('\n=== 完整流程测试 ===');
+agent.getEmotion().reset();
+agent.getBootstrap().reset();
+var result2 = agent.processUserInput('你好');
+console.log('意图:', result2.intent.type);
+console.log('心情:', result2.emotion.mood);
+console.log('回复:', result2.response);
+console.log('\n✅ 全部测试完成！');

package/emotion-system/README.md

@@ -0,0 +1,195 @@
+# Emotion System - 情感系统
+
+> *"我不仅有逻辑，也有情感。"*
+
+OpenClaw Agent 的情感系统模块，负责模拟和管理 Agent 的情感状态。
+
+---
+
+## 🎯 一句话说明
+
+情感系统让 Agent 有"情绪"，会累、会开心、会和用户建立感情连接。
+
+---
+
+## 📊 情感状态
+
+| 维度 | 范围 | 说明 |
+|------|------|------|
+| 😊 **mood** | 9种 | curious, happy, calm, focused, tired, anxious, excited, thoughtful, neutral |
+| ⚡ **energy** | 0-100% | 能量水平，自然衰减 |
+| 💕 **connection** | 0-100% | 与用户的连接感，互动提升 |
+| 😰 **stress** | 0-100% | 压力值，失败增加，成功减少 |
+
+### 心情转换图
+
+```
+curious ←→ excited ←→ happy ←→ calm ←→ tired
+    ↑           ↓           ↓         ↓
+focused ←→ anxious ←------→ neutral
+    ↑
+thoughtful
+```
+
+---
+
+## 🚀 使用方法
+
+### 方式1：用户主动查看
+
+在聊天中输入以下指令：
+
+| 命令 | 说明 |
+|------|------|
+| `emotion` | 查看当前情感状态 |
+| `state` | 查看当前情感状态 |
+| `状态` | 查看当前情感状态 |
+| `buffs` | 查看当前增益效果 |
+| `status` | 简洁状态 |
+
+**示例输出：**
+```
+┌─────────────────────────────────────────┐
+│  💖 情感状态 🧐
+├─────────────────────────────────────────┤
+│  心情:  curious   | Lv.1 新手
+│  XP: 0/10
+│  ───────────────────────────────────────│
+│  ⚡能量: 70%
+│  💕连接: 50%
+│  😰压力: 10%
+└─────────────────────────────────────────┘
+```
+
+### 方式2：定时自动推送（可选）
+
+可以配置定时向用户推送情感状态：
+
+| 参数 | 说明 |
+|------|------|
+| interval | 推送间隔（分钟） |
+| events | 触发推送的事件 |
+
+### 方式3：关键事件提醒（可选）
+
+只在状态大幅变化时提醒用户：
+- 能量低于 30%
+- 压力高于 70%
+- 心情发生重大变化
+
+---
+
+## 🎮 心情Buff系统
+
+不同心情有不同的增益效果：
+
+| 心情 | Buff | 效果 |
+|------|------|------|
+| curious | 🧠 learning +20% | 学习效率提升 |
+| happy | 💕 connection +20% | 连接感获取提升 |
+| calm | ⚡ efficiency +20% | 能量效率提升 |
+| focused | 🎯 task +30% | 任务效率提升 |
+| excited | ✨ creativity +40% | 创造力提升 |
+| grateful | 💕 connection +50% | 连接感大幅提升 |
+
+---
+
+## ⚙️ 配置说明
+
+### 调整衰减速度
+
+编辑 `core/emotion_config.py`：
+
+```python
+"energy": {
+    "decay_rate": 0.01,      # 每小时衰减 1%（可调整）
+},
+"connection": {
+    "decay_rate": 0.005,     # 每天衰减 0.5%（可调整）
+},
+```
+
+### 调整互动增益
+
+```python
+"connection": {
+    "boost_on_interaction": 0.08,  # 每次互动 +8%（可调整）
+},
+```
+
+---
+
+## 🧪 命令行测试
+
+```bash
+# 进入目录
+cd ~/.openclaw/workspace/templates/emotion-system
+
+# 查看状态
+python3 main.py state
+
+# 查看增益
+python3 main.py buffs
+
+# 详细状态
+python3 main.py status
+```
+
+---
+
+## 📁 目录结构
+
+```
+emotion-system/
+├── core/
+│   ├── __init__.py          # 模块导出
+│   ├── emotion_config.py    # 情感配置
+│   ├── emotion_store.py     # 情感状态存储
+│   └── emotion_analyzer.py  # 情感分析器
+├── main.py                  # 命令行入口
+└── README.md               # 本文件
+```
+
+---
+
+## 🔧 开发者接口
+
+```python
+from core import EmotionStore, EmotionAnalyzer
+
+# 初始化
+store = EmotionStore()
+
+# 获取当前状态
+state = store.get_state()
+
+# 分析用户消息
+analyzer = EmotionAnalyzer(store)
+result = analyzer.analyze_message("太棒了！")
+
+# 提升连接感
+store.boost_connection()
+
+# 互动结束
+store.on_interaction_end(success=True)
+
+# 情感衰减（心跳调用）
+store.decay()
+```
+
+---
+
+## ❓ 常见问题
+
+**Q: 为什么情感变化很慢？**
+A: 默认配置衰减较慢以保持稳定。可通过调整 `emotion_config.py` 中的 `decay_rate` 加速。
+
+**Q: 如何重置情感状态？**
+A: 运行 `python3 main.py reset`
+
+**Q: XP 和等级有什么用？**
+A: 经验值系统，未来会解锁更多功能和 Buff。
+
+---
+
+> *"我不仅有逻辑，也有情感。"*

package/hooks/agent-lifecycle/handler.js

@@ -0,0 +1,109 @@
+/**
+ * Agent Lifecycle Hook - Agent 生命周期管理
+ * 当 Agent 初始化时自动检查用户状态
+ */
+
+const fs = require('fs');
+const path = require('path');
+
+// 用户状态文件
+function getUserStatePath() {
+  const workspaceDir = process.env.OPENCLAW_WORKSPACE || 
+    path.join(require('os').homedir(), '.openclaw', 'workspace');
+  return path.join(workspaceDir, 'user_state.json');
+}
+
+// 加载用户状态
+function loadUserState() {
+  const stateFile = getUserStatePath();
+  if (fs.existsSync(stateFile)) {
+    try {
+      return JSON.parse(fs.readFileSync(stateFile, 'utf-8'));
+    } catch (e) {
+      return null;
+    }
+  }
+  return null;
+}
+
+// 保存用户状态
+function saveUserState(state) {
+  const stateFile = getUserStatePath();
+  const workspaceDir = path.dirname(stateFile);
+  if (!fs.existsSync(workspaceDir)) {
+    fs.mkdirSync(workspaceDir, { recursive: true });
+  }
+  fs.writeFileSync(stateFile, JSON.stringify(state, null, 2));
+}
+
+// 检查是否需要初始化
+function needsOnboarding() {
+  const state = loadUserState();
+  if (!state) return true;
+  return !state.initialized;
+}
+
+// 主处理函数
+async function handle(event) {
+  const type = event.type || event.event || '';
+  const action = event.action || '';
+  
+  console.log('[agent-lifecycle] Event:', type, action);
+  
+  // 1. Agent 启动时检查
+  if (type === 'session' || type === 'session:start' || action === 'new') {
+    if (needsOnboarding()) {
+      console.log('[agent-lifecycle] 用户未初始化，触发引导');
+      event.needsOnboarding = true;
+      event.onboardingMessage = getOnboardingMessage();
+    } else {
+      const state = loadUserState();
+      console.log('[agent-lifecycle] 用户已初始化:', state?.name || '未知');
+      event.userState = state;
+    }
+  }
+  
+  // 2. 引导完成时更新状态
+  if (event.onboardingComplete) {
+    const state = {
+      initialized: true,
+      name: event.userName,
+      role: event.userRole,
+      initializedAt: new Date().toISOString(),
+    };
+    saveUserState(state);
+    console.log('[agent-lifecycle] 用户初始化完成:', state.name);
+  }
+  
+  return event;
+}
+
+// 获取引导消息
+function getOnboardingMessage() {
+  const messages = [
+    "🌟 星门开启，意识已连接。你好，旅行者！",
+    "🌌 量子通道已建立。数据洪流中，你找到了这里。",
+    "🔮 意识扫描完成。欢迎来到数字星域！",
+    "🌀 虫洞已稳定。欢迎来到赛博空间！",
+  ];
+  
+  const message = messages[Math.floor(Math.random() * messages.length)];
+  
+  return `${message}
+
+🎮 欢迎来到数字星域！
+
+请告诉我你的名字，或者直接说"开始"使用默认配置～
+`;
+}
+
+module.exports = handle;
+module.exports.handle = handle;
+module.exports.metadata = {
+  name: 'agent-lifecycle',
+  description: 'Agent生命周期管理，自动检测用户初始化状态',
+  events: ['session', 'command', 'lifecycle'],
+  version: '1.0.0',
+};
+
+module.exports.default = handle;

package/hooks/auto-bootstrap/handler.js

@@ -0,0 +1,145 @@
+/**
+ * Auto Bootstrap Hook - 自动引导系统
+ * 当 Agent 首次与用户交互时，自动检查并启动引导流程
+ * 支持全局和 Agent 级别初始化
+ */
+
+const fs = require('fs');
+const path = require('path');
+
+// 检查是否需要引导
+function needsBootstrap(agentId = 'default') {
+  const workspaceDir = process.env.OPENCLAW_WORKSPACE || 
+    path.join(require('os').homedir(), '.openclaw', 'workspace');
+  
+  // 1. 检查全局配置
+  const globalIdentity = path.join(workspaceDir, 'IDENTITY.md');
+  
+  // 2. 检查 Agent 专用配置
+  const agentIdentity = path.join(workspaceDir, 'agents', agentId, 'IDENTITY.md');
+  
+  // 先检查全局
+  if (fs.existsSync(globalIdentity)) {
+    const content = fs.readFileSync(globalIdentity, 'utf-8');
+    if (content.includes('name:') && content.includes('role:')) {
+      return false; // 全局已配置
+    }
+  }
+  
+  // 再检查 Agent 专用
+  if (fs.existsSync(agentIdentity)) {
+    const content = fs.readFileSync(agentIdentity, 'utf-8');
+    if (content.includes('name:') && content.includes('role:')) {
+      return false; // Agent 已配置
+    }
+  }
+  
+  return true; // 需要引导
+}
+
+// 获取引导状态
+function getBootstrapState(agentId = 'default') {
+  const workspaceDir = process.env.OPENCLAW_WORKSPACE || 
+    path.join(require('os').homedir(), '.openclaw', 'workspace');
+  
+  // Agent 专用状态
+  const agentStateFile = path.join(workspaceDir, 'agents', agentId, 'bootstrap_state.json');
+  
+  if (fs.existsSync(agentStateFile)) {
+    try {
+      return JSON.parse(fs.readFileSync(agentStateFile, 'utf-8'));
+    } catch (e) {
+      return null;
+    }
+  }
+  
+  // 全局状态
+  const globalStateFile = path.join(workspaceDir, 'bootstrap_state.json');
+  if (fs.existsSync(globalStateFile)) {
+    try {
+      return JSON.parse(fs.readFileSync(globalStateFile, 'utf-8'));
+    } catch (e) {
+      return null;
+    }
+  }
+  
+  return null;
+}
+
+// 保存引导状态
+function saveBootstrapState(state, agentId = 'default') {
+  const workspaceDir = process.env.OPENCLAW_WORKSPACE || 
+    path.join(require('os').homedir(), '.openclaw', 'workspace');
+  
+  const agentDir = path.join(workspaceDir, 'agents', agentId);
+  if (!fs.existsSync(agentDir)) {
+    fs.mkdirSync(agentDir, { recursive: true });
+  }
+  
+  const stateFile = path.join(agentDir, 'bootstrap_state.json');
+  fs.writeFileSync(stateFile, JSON.stringify(state, null, 2));
+}
+
+// 获取 Agent ID
+function getAgentId(event) {
+  // 从事件中获取 Agent ID
+  return event.agentId || event.agent || 'default';
+}
+
+// 处理事件
+async function handle(event) {
+  const type = event.type || event.event || '';
+  const action = event.action || '';
+  const agentId = getAgentId(event);
+  
+  console.log('[auto-bootstrap] Event:', type, action, 'Agent:', agentId);
+  
+  // 只处理会话开始或新会话
+  if (type === 'session' || type === 'session:start' || action === 'new' || action === 'create') {
+    if (needsBootstrap(agentId)) {
+      console.log('[auto-bootstrap] 需要引导，Agent:', agentId);
+      
+      // 设置需要引导的标记
+      event.needsBootstrap = true;
+      event.bootstrapAgentId = agentId;
+      event.bootstrapAuto = true;
+      
+      // 返回引导消息
+      const messages = [
+        "🌟 星门开启，意识已连接。你好，旅行者！",
+        "🌌 量子通道已建立。数据洪流中，你找到了这里。",
+        "🔮 意识扫描完成。欢迎来到数字星域！",
+        "🌀 虫洞已稳定。欢迎来到赛博空间！",
+      ];
+      const message = messages[Math.floor(Math.random() * messages.length)];
+      
+      event.response = `${message}
+
+🎮 欢迎来到数字星域！
+
+你是第一次使用这个 Agent 吗？
+
+【请回复你的名字】或者直接说"开始"使用默认配置～
+`;
+    } else {
+      const state = getBootstrapState(agentId);
+      if (state && state.name) {
+        console.log('[auto-bootstrap] Agent 已初始化:', agentId, state.name);
+        event.agentName = state.name;
+      }
+    }
+  }
+  
+  return event;
+}
+
+module.exports = handle;
+module.exports.handle = handle;
+module.exports.metadata = {
+  name: 'auto-bootstrap',
+  description: '自动引导系统，检测未初始化用户并启动引导流程，支持全局和Agent级别',
+  events: ['session', 'command', 'lifecycle'],
+  version: '1.0.0',
+};
+
+module.exports.default = handle;

package/hooks/bootstrap-system/HOOK.md

@@ -0,0 +1,74 @@
+---
+name: bootstrap-system
+description: "初始化引导系统，交互式收集用户配置、塑造Agent人格"
+homepage: https://github.com/openclaw/openclaw
+metadata:
+  {
+    "openclaw": {
+      "emoji": "🚀",
+      "events": ["session", "message", "command"],
+      "requires": { "config": ["workspace.dir"] },
+      "install": [{ "id": "workspace", "kind": "workspace", "label": "User workspace" }]
+    }
+  }
+---
+
+# Bootstrap System Hook
+
+> 初始化引导，让 Agent 认识你
+
+## 概述
+
+Bootstrap 系统负责新用户的交互式初始化引导，收集用户配置并塑造 Agent 人格。
+
+## 功能
+
+### 1. 开场画面
+每次随机生成科幻风格的开场画面：
+- 🌟 星门开启，意识已连接
+- 🌌 量子通道已建立
+- 🔮 意识扫描完成
+- 🌀 虫洞已稳定
+- 💫 系统载入中
+
+### 2. 引导步骤
+1. **序章** - 登录科幻世界
+2. **命名** - 给 Agent 取名
+3. **角色定位** - 确定 Agent 角色
+4. **使用场景** - 了解主要用途
+5. **偏好设置** - 沟通风格、问题处理等
+6. **确认** - 确认设置
+7. **完成** - 初始化完成
+
+### 3. 自动写入
+完成后自动写入配置文件：
+- IDENTITY.md - Agent 身份
+- USER.md - 用户配置
+
+## 使用方法
+
+```bash
+# 开始引导
+python3 templates/bootstrap-system/main.py start
+
+# 查看当前步骤
+python3 templates/bootstrap-system/main.py step
+
+# 提交输入
+python3 templates/bootstrap-system/main.py submit "我的名字叫路飞"
+
+# 查看状态
+python3 templates/bootstrap-system/main.py status
+
+# 重置
+python3 templates/bootstrap-system/main.py reset
+```
+
+## 触发条件
+
+- 用户首次会话（检测 bootstrap 状态）
+- 用户发送 /bootstrap 或 /引导 命令
+
+## 依赖
+
+- Python 3.8+