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

中文说明 / 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:

模式 / Mode	自动匹配关键词 / Auto-match Keywords	研究框架 / Framework
------------	-------------------------------------	---------------------
短线交易 / Trader	龙虎榜、涨停、游资、资金流向、换手率	市场微观结构与资金流向分析（Timeline Reconstruction）
基金经理 / Fund Manager	财报、估值、业绩、年报、ROE、PE	基本面分析与估值模型框架
研究员 / Researcher	产业链、竞争格局、技术路线、供应链	产业链拆解与竞争力评估（Peer Benchmarking）
理财顾问 / Advisor	投资建议、资产配置、风险控制、定投	资产配置与风险收益评估框架

提示词格式 / 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

命令 / Command	功能 / Function	耗时 / Duration
---------------	----------------	----------------
`/cue <主题>`	智能调研（自动匹配研究视角）/ Smart research (auto-matches perspective)	40-60 分钟 / mins
`/cue --mode <模式> <主题>`	指定视角深度研究 / Deep research with specific perspective	40-60 分钟 / mins
`/ct`	查看所有研究任务状态 / View all research task statuses	即时 / Instant
`/cm`	查看监控项列表 / View all monitors	即时 / Instant
`/cn [天数]`	查看监控触发通知（默认3日）/ View monitor notifications	即时 / Instant
`/cs <任务ID>`	查看特定任务详情 / View specific task details	即时 / Instant
`/ch`	显示帮助 / Show help	即时 / Instant
`/config`	配置 API Key / Configure API keys	即时 / Instant

使用示例 / 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:

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

# 配置环境变量
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:

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

调度配置 / 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

变量名	说明	获取方式
--------	------	---------
`CUECUE_API_KEY`	CueCue 深度研究 API 密钥	https://cuecue.cn

可选环境变量 / Optional

变量名	说明	用途
--------	------	------
`TAVILY_API_KEY`	Tavily 搜索 API 密钥	监控功能的新闻搜索
`FEISHU_APP_ID`	飞书应用 ID	飞书渠道通知
`FEISHU_APP_SECRET`	飞书应用密钥	飞书渠道通知
`OPENCLAW_CHANNEL`	OpenClaw 渠道标识	消息发送渠道选择
`CHAT_ID`	当前对话 ID	用户识别和数据隔离

权限说明 / Permissions

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

文件系统权限 / Filesystem

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

网络权限 / Network

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

定时任务权限 / Cron

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

环境变量访问 / 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)

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

Cue

概述