Cue

# Cue - 你的专属调研助理 / Your AI Research Assistant

统一入口和智能路由中心，自动识别用户意图并路由到相应技能。基于 Cue 产品设计，提供专业化的深度研究体验。

> A unified entry and intelligent routing center that automatically recognizes user intent and routes to appropriate skills. Based on Cue product design, providing professional deep research experience.

## ⚠️ 安全声明 / Security Notice

**安装前请仔细阅读 / Please read before installing:**

本 Skill 是一个具有持久化状态和后台行为的金融研究+监控工具：
- 🔐 **本地存储 / Local Storage**: 会在 `$HOME/.cuecue` 创建持久化数据目录（用户数据、任务、监控配置、日志）
- ⏰ **后台任务 / Background Jobs**: 安装后会添加 cron 定时任务（每30分钟运行监控守护进程）
- 🌐 **外部 API / External APIs**: 需要访问 https://cuecue.cn 和可选的 https://api.tavily.com
- 🔑 **环境变量 / Environment Variables**: 需要 CUECUE_API_KEY（必需），可选 TAVILY_API_KEY
- 📢 **通知权限 / Notification**: 可能复用 OpenClaw 渠道令牌（如 FEISHU_*）发送通知

**This Skill is a financial research + monitoring tool with persistent state and background behavior:**
- Creates persistent local storage at `$HOME/.cuecue` (user data, tasks, monitors, logs)
- Installs cron job running every 30 minutes for monitoring
- Requires external API access to https://cuecue.cn
- Requires CUECUE_API_KEY (required), optional TAVILY_API_KEY
- May reuse OpenClaw channel tokens (e.g., FEISHU_*) for notifications

## Tags

deep-research, finance, business, industry, company-analysis, multi-agent, monitoring

---

## 中文说明 / Description

### 核心定位 / Core Positioning

**Cue** 是一款面向专业场景的 AI 调研助理，不只是给答案，还提供完整的证据链和可溯源的研究过程。

> **Cue** is an AI research assistant for professional scenarios. It doesn't just provide answers, but also offers complete evidence chains and traceable research processes.

### 核心价值 / Core Values

- 🔍 **低幻觉 / Low Hallucination** - 全局事实校验，多源交叉验证 / Global fact-checking with multi-source cross-val...

# Cue v1.0.4 - Node.js 重构版

## 📦 架构概述

Cue v1.0.4 是基于 **Node.js + ES Module** 重构的深度研究工具，采用模块化设计，提供更好的可维护性和跨平台支持。

### 技术栈
- **Runtime**: Node.js >= 18.0.0
- **Module**: ES Module (type: "module")
- **CLI**: Commander.js
- **Dependencies**: 10+ npm 包 (chalk, ora, inquirer, node-cron, fs-extra 等)

## 📂 文件结构

```
cue/
├── manifest.json              # 技能清单
├── SKILL.md                   # 技能描述（双语）
├── SECURITY.md                # 安全说明
├── README.md                  # 本文件
├── package.json               # npm 配置
├── src/                       # 源代码目录
│   ├── index.js              # 主入口（模块导出）
│   ├── cli.js                # CLI 入口（Commander）
│   ├── core/                 # 核心业务逻辑
│   │   ├── logger.js         # 统一日志系统
│   │   ├── userState.js      # 用户状态管理
│   │   ├── taskManager.js    # 任务管理
│   │   └── monitorManager.js # 监控管理
│   ├── api/
│   │   └── cuecueClient.js   # API 客户端
│   ├── commands/             # 命令处理器
│   ├── utils/                # 工具函数
│   │   ├── fileUtils.js      # 文件操作
│   │   ├── envUtils.js       # 环境变量（安全存储）
│   │   └── validators.js     # 验证工具
│   └── executors/            # 执行引擎
├── tests/                    # 测试文件
└── backups/                  # 旧版本备份
    └── scripts-v1.0.3/       # v1.0.3 Bash 脚本备份
```

## 🚀 部署步骤

### 步骤 1：环境要求

**必需**: Node.js >= 18.0.0

```bash
# 检查 Node.js 版本
node --version  # 应 >= v18.0.0

# 如未安装，请访问 https://nodejs.org/
```

### 步骤 2：安装依赖

```bash
cd cue
npm install
```

**依赖列表**:
- `commander` - CLI 框架
- `chalk` - 终端颜色
- `ora` - 加载动画
- `inquirer` - 交互提示
- `node-cron` - 定时任务（不修改系统 crontab）
- `fs-extra` - 增强文件操作

### 步骤 3：配置环境变量

**必需**:
```bash
export CUECUE_API_KEY="your-cuecue-api-key"
```

**可选**:
```bash
export TAVILY_API_KEY="your-tavily-api-key"  # 用于监控功能
export CHAT_...