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-validation
• 🔗 可溯源 / Traceable - 每个结论都有来源和证据链 / Every conclusion has sources and evidence chains
• 🤖 Multi-Agent - 自动搜集、验证、分析 / Automatic collection, verification, and analysis
• 💾 可复用 / Reusable - 优秀调研路径能沉淀为模板 / Excellent research paths can be templated

核心功能 / Core Functions

1. 深度研究（Deep Research）

直接输入研究主题，AI 自动进行多 Agent 并行深度研究，40-60 分钟生成专业分析报告。

Enter a research topic directly, and AI will automatically conduct multi-agent parallel deep research, generating professional analysis reports in 40-60 minutes.

示例 / Examples:

分析宁德时代竞争优势
新能源汽车行业前景如何？

2. 研究视角模式 / Research Perspective Modes

系统根据主题自动匹配最适合的研究视角，生成结构化的调研指令（rewritten_mandate 格式）：

System automatically matches the best research perspective and generates structured research mandate:

提示词格式 / Prompt Format: 系统自动生成包含以下字段的深度调研指令：

• 【调研目标】 - 明确专家角色与研究目的
• 【信息搜集与整合框架】 - 指定搜索方法论（Timeline/Triangulation/Benchmarking/Evidence Chaining）
• 【信源与边界】 - 白名单/黑名单信源、时间窗口
• 【核心关注】 - 该视角下的重点分析维度

使用方式 / Usage:

/cue 今日龙虎榜分析           # 自动识别为短线交易视角
/cue --mode trader 涨停分析   # 手动指定短线交易视角
/cue 宁德时代2024财报          # 自动识别为基金经理视角

示例输出 / Example Output:

**【调研目标】**
以短线交易分析师的专业视角，针对"今日龙虎榜分析"进行全网深度信息搜集与分析...

**【信息搜集与整合框架】**
1. **市场微观结构与资金流向分析框架（Timeline Reconstruction）**：追踪龙虎榜席位动向...
2. **关键证据锚定**：针对核心争议点，查找并引用权威信源...
3. **多维视角交叉**：汇总不同利益相关方的观点差异...

**【信源与边界】**
- 优先信源：交易所龙虎榜、Level-2行情数据...
- 时间窗口：优先近6个月内的最新动态

3. 智能路由 / Intelligent Routing

直接输入自然语言，系统自动判断最佳方案：

Enter natural language directly, and the system automatically determines the best approach:

• 投资/产业关键词 → 深度研究 / Investment/industry keywords → Deep research
• 简单查询 → 快速搜索 / Simple queries → Quick search
• 估值关键词 → 基金经理模式 / Valuation keywords → Fund manager mode

可用命令 / Available Commands

使用示例 / Usage Examples

自然语言（推荐）/ Natural Language (Recommended):

分析一下新能源行业竞争格局
基金经理视角分析茅台投资价值

显式命令 / Explicit Commands:

/cue 特斯拉 2024 财务分析
/cue --mode researcher 锂电池产业链

工作流程 / Workflow

用户输入 / User Input
    ↓
[Cue 智能路由 / Intelligent Routing]
    ↓
深度研究启动 / Research Started
    ↓
├─ 立即返回：任务ID + 进度链接 / Return: Task ID + Progress Link
├─ 每5分钟推送进度更新 / Progress update every 5 minutes
└─ 60分钟超时保护 / 60-minute timeout protection
    ↓
研究完成 / Research Completed
    ↓
自动推送结果 / Auto-push results
├─ 分享链接（分享对话/转发报告）/ Share links
├─ 核心结论摘要 / Core conclusion summary
└─ 监控项建议（回复 Y/N 创建）/ Monitor suggestions (Reply Y/N to create)

用户体验特性 / User Experience Features

首次使用引导 / First-time User Guide:

• 自动识别新用户并发送欢迎消息 / Auto-detects new users and sends welcome message
• 检测 API Key 配置状态，引导注册流程 / Detects API Key status and guides registration

异步体验 / Asynchronous Experience:

• 研究启动后立即返回进度链接 / Returns progress link immediately after starting
• 每 5 分钟推送进度更新 / Progress updates every 5 minutes
• 无需等待，可继续其他工作 / No need to wait, can continue other work
• 完成后自动推送结果到对话 / Auto-pushes results to conversation when completed

详细进度追踪 / Detailed Progress Tracking:

🔬 正在深度研究：[主题]

研究阶段：
• 0-10分钟：全网信息搜集与初步筛选
• 10-30分钟：多源交叉验证与事实核查
• 30-50分钟：深度分析与逻辑推理
• 50-60分钟：报告生成与质量检查

预计剩余时间：XX 分钟

完成通知 / Completion Notification: 研究完成后自动发送简洁通知：

Auto-sends concise notification when research completes:

✅ 研究完成：[主题]

⏱️ 耗时：XX 分钟
📝 任务ID：xxx

🔗 https://cuecue.cn/c/xxx

🔔 建议监控：XX 等 N 项
💡 回复 Y 创建，N 跳过

部署方式 / Deployment Methods

方式一：使用公共机器人服务 / Method 1: Use Public Bot Service

使用他人部署的 Cue 机器人（如飞书群里的公共机器人），直接开始对话即可。

Use Cue bot deployed by others (e.g., in Feishu groups), just start chatting.

方式二：自建 OpenClaw + Cue Skill / Method 2: Self-host OpenClaw + Cue Skill

在自己的 OpenClaw 实例中安装 Cue skill：

Install Cue skill in your own OpenClaw instance:

clawhub install cue

首次使用流程 / First-time Setup:

1. 发送任意消息 → 触发欢迎消息
2. 获取 API Key → 按提示访问 cuecue.cn 注册
3. 配置环境变量 → 设置 CUECUE_API_KEY
4. 开始研究 → 发送研究主题

# 配置环境变量
export CUECUE_API_KEY="your-api-key"

推荐 / Recommended：自建部署获得完整功能和最佳体验。

Self-hosting for full functionality and best experience.

超时设置 / Timeout Settings

• 研究超时 / Research Timeout：60 分钟 / minutes
• 进度推送间隔 / Progress Push Interval：5 分钟 / minutes
• 超时后自动标记失败，支持重试 / Auto-marked as failed after timeout, supports retry

环境变量 / Environment Variables

CUECUE_API_KEY      # CueCue API 密钥（必需）/ API Key (Required)

智能监控 / Smart Monitoring

监控建议生成 / Monitor Suggestion Generation:

• 🤖 AI 分析：从报告中提取关键监控信号
• 📊 量化指标：提取可量化的监控维度
• 🔔 自动创建：回复 Y 自动创建监控项

监控执行与触发 / Monitor Execution & Trigger:

监控创建 → 监控执行 → 条件评估 → 触发通知
    ↓           ↓           ↓           ↓
 create    monitor    condition   notify
-monitor   -daemon    -evaluator  -trigger

执行层级 / Execution Layers:

1. Search 层：通过搜索获取信息（快速）
2. Browser 层：通过浏览器获取信息（深度）
3. 触发评估：判断是否满足触发条件
4. 通知推送：自动发送触发通知

调度配置 / Scheduling:

• 监控守护进程每30分钟执行一次
• 支持 Cron 表达式自定义频率
• 自动清理7天前的旧日志

代码结构 / Code Structure

v1.0.4 Node.js 架构 / Node.js Architecture:

src/
├── index.js              # 主入口（模块导出）/ Main entry (module exports)
├── cli.js                # CLI 入口（Commander）/ CLI entry (Commander)
├── core/                 # 核心业务逻辑 / Core business logic
│   ├── logger.js         # 统一日志系统 / Unified logging
│   ├── userState.js      # 用户状态管理 / User state management
│   ├── taskManager.js    # 任务管理 / Task management
│   └── monitorManager.js # 监控管理 / Monitor management
├── api/
│   └── cuecueClient.js   # API 客户端 / API client
├── commands/             # 命令处理器 / Command handlers
├── utils/                # 工具函数 / Utilities
│   ├── fileUtils.js      # 文件操作 / File operations
│   ├── envUtils.js       # 环境变量（安全存储）/ Environment (secure storage)
│   └── validators.js     # 验证工具 / Validators
└── executors/            # 执行引擎 / Execution engines

旧版备份 / Legacy Backup:

• backups/scripts-v1.0.3/ - v1.0.3 Bash 脚本备份 / v1.0.3 Bash scripts backup

环境变量与权限 / Environment Variables & Permissions

必需环境变量 / Required

可选环境变量 / Optional

权限说明 / Permissions

本 Skill 需要以下权限 / This Skill requires:

1. 文件系统权限 / Filesystem

   • 读写 $HOME/.cuecue 目录及其子目录
   • 创建用户数据、任务、监控配置和日志文件

2. 网络权限 / Network

   • 出站访问 https://cuecue.cn (深度研究 API)
   • 出站访问 https://api.tavily.com (可选，监控搜索)

3. 定时任务权限 / Cron

   • 安装 cron 作业（每30分钟执行监控检查）
   • 运行后台研究进程（60分钟超时）

4. 环境变量访问 / Environment

   • 读取 OpenClaw 环境变量（如 FEISHU_APP_ID, CHAT_ID）
   • 读取用户配置的 API Key

安装建议 / Installation Recommendation:

• 初次安装请在测试环境验证
• 检查并批准 cron 作业和文件系统写入权限
• 确认 API Key 和网络访问策略
• 了解监控功能会定期产生外部 API 调用

Cue - 让 AI 成为你的调研助理 / Let AI be your research assistant (Powered by CueCue)

数据隔离 / Data Isolation

多用户数据安全隔离

每个用户的数据存储在独立目录：

~/.cuecue/users/${chat_id}/
├── .initialized     # 用户初始化标记
├── tasks/           # 用户专属研究任务
└── monitors/        # 用户专属监控配置

安全特性：

• ✅ 用户数据完全隔离
• ✅ 多用户共享实例时互不干扰
• ✅ 通过 chat_id 识别用户身份

版本历史 / Version History

v1.0.4 (2026-02-25)

• 🔧 全面 Node.js 重构 - 基于 ES Module 的现代架构
• 🔧 模块化设计 - core/api/commands/utils 清晰分层
• 🔧 统一日志系统 - 支持多级别日志和文件持久化
• 🔧 改进错误处理 - 详细的错误信息和日志记录
• 🔧 Type hints - JSDoc 类型注解提升可维护性
• 🔧 依赖管理 - 使用 npm 管理 Node.js 依赖

v1.0.3 (2026-02-25)

• ✨ 新增：自动角色匹配 - 根据主题关键词智能选择研究视角（trader/fund-manager/researcher/advisor）
• ✨ 新增：rewritten_mandate 提示词格式 - 结构化调研指令（目标/框架/信源/关注）
• ✨ 新增：/cn 命令 - 查看监控触发通知（默认最近3日）
• ✨ 新增：/key 命令 - 交互式 API Key 配置，自动识别服务类型
• ✨ 新增：智能状态检测 - 首次使用/版本更新/正常使用三种状态
• 🔧 修复：监控触发通知自动保存到用户目录
• 🔧 优化：trader 模式支持龙虎榜、资金流向等短线交易分析
• 📚 更新：SKILL.md 文档，添加新功能说明

v1.0.2 (2026-02-24)

• 🔧 修复：API 调用错误（使用内置 cuecue-client.js）
• 🔧 修复：PID 获取污染问题
• 🔧 修复：输出文件分离导致的 notifier 错误
• 🔧 修复：退出码标记格式不一致
• ✨ 新增：内置 Node.js API 客户端（无额外依赖）

v1.0.1 (2026-02-24)

• ✨ 产品定位："投研搭子" → "调研助理"
• 🏷️ 新增 7 个 Tags
• ⏱️ 优化：超时 30min → 60min
• 🔔 增强：5分钟进度推送
• 🔗 新增：自动提取分享链接
• 🤖 智能：回复 Y 自动创建监控
• 🌐 新增：多 Channel 支持
• 📝 新增：详细日志系统

v1.0.0 (2026-02-23)

• 🎉 初始发布
• 深度研究功能
• 监控管理功能