{"skill":{"slug":"cue","displayName":"Cue","summary":"AI-powered financial research assistant with \"White-Box\" evidence engineering. Multi-Agent architecture for automated information collection, verification, a...","description":"# Cue - 你的专属调研助理 / Your AI Research Assistant\n\n统一入口和智能路由中心，自动识别用户意图并路由到相应技能。基于 Cue 产品设计，提供专业化的深度研究体验。\n\n> 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.\n\n## ⚠️ 安全声明 / Security Notice\n\n**安装前请仔细阅读 / Please read before installing:**\n\n本 Skill 是一个具有持久化状态和后台行为的金融研究+监控工具：\n- 🔐 **本地存储 / Local Storage**: 会在 `$HOME/.cuecue` 创建持久化数据目录（用户数据、任务、监控配置、日志）\n- ⏰ **后台任务 / Background Jobs**: 安装后会添加 cron 定时任务（每30分钟运行监控守护进程）\n- 🌐 **外部 API / External APIs**: 需要访问 https://cuecue.cn 和可选的 https://api.tavily.com\n- 🔑 **环境变量 / Environment Variables**: 需要 CUECUE_API_KEY（必需），可选 TAVILY_API_KEY\n- 📢 **通知权限 / Notification**: 可能复用 OpenClaw 渠道令牌（如 FEISHU_*）发送通知\n\n**This Skill is a financial research + monitoring tool with persistent state and background behavior:**\n- Creates persistent local storage at `$HOME/.cuecue` (user data, tasks, monitors, logs)\n- Installs cron job running every 30 minutes for monitoring\n- Requires external API access to https://cuecue.cn\n- Requires CUECUE_API_KEY (required), optional TAVILY_API_KEY\n- May reuse OpenClaw channel tokens (e.g., FEISHU_*) for notifications\n\n## Tags\n\ndeep-research, finance, business, industry, company-analysis, multi-agent, monitoring\n\n---\n\n## 中文说明 / Description\n\n### 核心定位 / Core Positioning\n\n**Cue** 是一款面向专业场景的 AI 调研助理，不只是给答案，还提供完整的证据链和可溯源的研究过程。\n\n> **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.\n\n### 核心价值 / Core Values\n\n- 🔍 **低幻觉 / Low Hallucination** - 全局事实校验，多源交叉验证 / Global fact-checking with multi-source cross-validation\n- 🔗 **可溯源 / Traceable** - 每个结论都有来源和证据链 / Every conclusion has sources and evidence chains\n- 🤖 **Multi-Agent** - 自动搜集、验证、分析 / Automatic collection, verification, and analysis\n- 💾 **可复用 / Reusable** - 优秀调研路径能沉淀为模板 / Excellent research paths can be templated\n\n### 核心功能 / Core Functions\n\n#### 1. 深度研究（Deep Research）\n\n直接输入研究主题，AI 自动进行多 Agent 并行深度研究，40-60 分钟生成专业分析报告。\n\n> Enter a research topic directly, and AI will automatically conduct multi-agent parallel deep research, generating professional analysis reports in 40-60 minutes.\n\n**示例 / Examples:**\n```\n分析宁德时代竞争优势\n新能源汽车行业前景如何？\n```\n\n#### 2. 研究视角模式 / Research Perspective Modes\n\n系统根据主题自动匹配最适合的研究视角，生成结构化的调研指令（rewritten_mandate 格式）：\n\n> System automatically matches the best research perspective and generates structured research mandate:\n\n| 模式 / Mode | 自动匹配关键词 / Auto-match Keywords | 研究框架 / Framework |\n|------------|-------------------------------------|---------------------|\n| 短线交易 / Trader | 龙虎榜、涨停、游资、资金流向、换手率 | 市场微观结构与资金流向分析（Timeline Reconstruction） |\n| 基金经理 / Fund Manager | 财报、估值、业绩、年报、ROE、PE | 基本面分析与估值模型框架 |\n| 研究员 / Researcher | 产业链、竞争格局、技术路线、供应链 | 产业链拆解与竞争力评估（Peer Benchmarking） |\n| 理财顾问 / Advisor | 投资建议、资产配置、风险控制、定投 | 资产配置与风险收益评估框架 |\n\n**提示词格式 / Prompt Format:**\n系统自动生成包含以下字段的深度调研指令：\n- **【调研目标】** - 明确专家角色与研究目的\n- **【信息搜集与整合框架】** - 指定搜索方法论（Timeline/Triangulation/Benchmarking/Evidence Chaining）\n- **【信源与边界】** - 白名单/黑名单信源、时间窗口\n- **【核心关注】** - 该视角下的重点分析维度\n\n**使用方式 / Usage:**\n```\n/cue 今日龙虎榜分析           # 自动识别为短线交易视角\n/cue --mode trader 涨停分析   # 手动指定短线交易视角\n/cue 宁德时代2024财报          # 自动识别为基金经理视角\n```\n\n**示例输出 / Example Output:**\n```\n**【调研目标】**\n以短线交易分析师的专业视角，针对\"今日龙虎榜分析\"进行全网深度信息搜集与分析...\n\n**【信息搜集与整合框架】**\n1. **市场微观结构与资金流向分析框架（Timeline Reconstruction）**：追踪龙虎榜席位动向...\n2. **关键证据锚定**：针对核心争议点，查找并引用权威信源...\n3. **多维视角交叉**：汇总不同利益相关方的观点差异...\n\n**【信源与边界】**\n- 优先信源：交易所龙虎榜、Level-2行情数据...\n- 时间窗口：优先近6个月内的最新动态\n```\n\n#### 3. 智能路由 / Intelligent Routing\n\n直接输入自然语言，系统自动判断最佳方案：\n\n> Enter natural language directly, and the system automatically determines the best approach:\n\n- 投资/产业关键词 → 深度研究 / Investment/industry keywords → Deep research\n- 简单查询 → 快速搜索 / Simple queries → Quick search\n- 估值关键词 → 基金经理模式 / Valuation keywords → Fund manager mode\n\n### 可用命令 / Available Commands\n\n| 命令 / Command | 功能 / Function | 耗时 / Duration |\n|---------------|----------------|----------------|\n| `/cue <主题>` | 智能调研（自动匹配研究视角）/ Smart research (auto-matches perspective) | 40-60 分钟 / mins |\n| `/cue --mode <模式> <主题>` | 指定视角深度研究 / Deep research with specific perspective | 40-60 分钟 / mins |\n| `/ct` | 查看所有研究任务状态 / View all research task statuses | 即时 / Instant |\n| `/cm` | 查看监控项列表 / View all monitors | 即时 / Instant |\n| `/cn [天数]` | 查看监控触发通知（默认3日）/ View monitor notifications | 即时 / Instant |\n| `/cs <任务ID>` | 查看特定任务详情 / View specific task details | 即时 / Instant |\n| `/ch` | 显示帮助 / Show help | 即时 / Instant |\n| `/config` | 配置 API Key / Configure API keys | 即时 / Instant |\n\n### 使用示例 / Usage Examples\n\n**自然语言（推荐）/ Natural Language (Recommended):**\n```\n分析一下新能源行业竞争格局\n基金经理视角分析茅台投资价值\n```\n\n**显式命令 / Explicit Commands:**\n```\n/cue 特斯拉 2024 财务分析\n/cue --mode researcher 锂电池产业链\n```\n\n### 工作流程 / Workflow\n\n```\n用户输入 / User Input\n    ↓\n[Cue 智能路由 / Intelligent Routing]\n    ↓\n深度研究启动 / Research Started\n    ↓\n├─ 立即返回：任务ID + 进度链接 / Return: Task ID + Progress Link\n├─ 每5分钟推送进度更新 / Progress update every 5 minutes\n└─ 60分钟超时保护 / 60-minute timeout protection\n    ↓\n研究完成 / Research Completed\n    ↓\n自动推送结果 / Auto-push results\n├─ 分享链接（分享对话/转发报告）/ Share links\n├─ 核心结论摘要 / Core conclusion summary\n└─ 监控项建议（回复 Y/N 创建）/ Monitor suggestions (Reply Y/N to create)\n```\n\n### 用户体验特性 / User Experience Features\n\n**首次使用引导 / First-time User Guide:**\n- 自动识别新用户并发送欢迎消息 / Auto-detects new users and sends welcome message\n- 检测 API Key 配置状态，引导注册流程 / Detects API Key status and guides registration\n\n**异步体验 / Asynchronous Experience:**\n- 研究启动后立即返回进度链接 / Returns progress link immediately after starting\n- 每 5 分钟推送进度更新 / Progress updates every 5 minutes\n- 无需等待，可继续其他工作 / No need to wait, can continue other work\n- 完成后自动推送结果到对话 / Auto-pushes results to conversation when completed\n\n**详细进度追踪 / Detailed Progress Tracking:**\n```\n🔬 正在深度研究：[主题]\n\n研究阶段：\n• 0-10分钟：全网信息搜集与初步筛选\n• 10-30分钟：多源交叉验证与事实核查\n• 30-50分钟：深度分析与逻辑推理\n• 50-60分钟：报告生成与质量检查\n\n预计剩余时间：XX 分钟\n```\n\n**完成通知 / Completion Notification:**\n研究完成后自动发送简洁通知：\n> Auto-sends concise notification when research completes:\n```\n✅ 研究完成：[主题]\n\n⏱️ 耗时：XX 分钟\n📝 任务ID：xxx\n\n🔗 https://cuecue.cn/c/xxx\n\n🔔 建议监控：XX 等 N 项\n💡 回复 Y 创建，N 跳过\n```\n\n### 部署方式 / Deployment Methods\n\n**方式一：使用公共机器人服务 / Method 1: Use Public Bot Service**\n\n使用他人部署的 Cue 机器人（如飞书群里的公共机器人），直接开始对话即可。\n\n> Use Cue bot deployed by others (e.g., in Feishu groups), just start chatting.\n\n**方式二：自建 OpenClaw + Cue Skill / Method 2: Self-host OpenClaw + Cue Skill**\n\n在自己的 OpenClaw 实例中安装 Cue skill：\n\n> Install Cue skill in your own OpenClaw instance:\n\n```bash\nclawhub install cue\n```\n\n**首次使用流程 / First-time Setup:**\n\n1. **发送任意消息** → 触发欢迎消息\n2. **获取 API Key** → 按提示访问 cuecue.cn 注册\n3. **配置环境变量** → 设置 `CUECUE_API_KEY`\n4. **开始研究** → 发送研究主题\n\n```bash\n# 配置环境变量\nexport CUECUE_API_KEY=\"your-api-key\"\n```\n\n**推荐 / Recommended**：自建部署获得完整功能和最佳体验。\n> Self-hosting for full functionality and best experience.\n\n### 超时设置 / Timeout Settings\n\n- **研究超时 / Research Timeout**：60 分钟 / minutes\n- **进度推送间隔 / Progress Push Interval**：5 分钟 / minutes\n- 超时后自动标记失败，支持重试 / Auto-marked as failed after timeout, supports retry\n\n### 环境变量 / Environment Variables\n\n```bash\nCUECUE_API_KEY      # CueCue API 密钥（必需）/ API Key (Required)\n```\n\n### 智能监控 / Smart Monitoring\n\n**监控建议生成 / Monitor Suggestion Generation:**\n- 🤖 **AI 分析**：从报告中提取关键监控信号\n- 📊 **量化指标**：提取可量化的监控维度\n- 🔔 **自动创建**：回复 Y 自动创建监控项\n\n**监控执行与触发 / Monitor Execution & Trigger:**\n```\n监控创建 → 监控执行 → 条件评估 → 触发通知\n    ↓           ↓           ↓           ↓\n create    monitor    condition   notify\n-monitor   -daemon    -evaluator  -trigger\n```\n\n**执行层级 / Execution Layers:**\n1. **Search 层**：通过搜索获取信息（快速）\n2. **Browser 层**：通过浏览器获取信息（深度）\n3. **触发评估**：判断是否满足触发条件\n4. **通知推送**：自动发送触发通知\n\n**调度配置 / Scheduling:**\n- 监控守护进程每30分钟执行一次\n- 支持 Cron 表达式自定义频率\n- 自动清理7天前的旧日志\n\n### 代码结构 / Code Structure\n\n**v1.0.4 Node.js 架构 / Node.js Architecture:**\n\n```\nsrc/\n├── index.js              # 主入口（模块导出）/ Main entry (module exports)\n├── cli.js                # CLI 入口（Commander）/ CLI entry (Commander)\n├── core/                 # 核心业务逻辑 / Core business logic\n│   ├── logger.js         # 统一日志系统 / Unified logging\n│   ├── userState.js      # 用户状态管理 / User state management\n│   ├── taskManager.js    # 任务管理 / Task management\n│   └── monitorManager.js # 监控管理 / Monitor management\n├── api/\n│   └── cuecueClient.js   # API 客户端 / API client\n├── commands/             # 命令处理器 / Command handlers\n├── utils/                # 工具函数 / Utilities\n│   ├── fileUtils.js      # 文件操作 / File operations\n│   ├── envUtils.js       # 环境变量（安全存储）/ Environment (secure storage)\n│   └── validators.js     # 验证工具 / Validators\n└── executors/            # 执行引擎 / Execution engines\n```\n\n**旧版备份 / Legacy Backup:**\n- `backups/scripts-v1.0.3/` - v1.0.3 Bash 脚本备份 / v1.0.3 Bash scripts backup\n\n---\n\n## 环境变量与权限 / Environment Variables & Permissions\n\n### 必需环境变量 / Required\n\n| 变量名 | 说明 | 获取方式 |\n|--------|------|---------|\n| `CUECUE_API_KEY` | CueCue 深度研究 API 密钥 | https://cuecue.cn |\n\n### 可选环境变量 / Optional\n\n| 变量名 | 说明 | 用途 |\n|--------|------|------|\n| `TAVILY_API_KEY` | Tavily 搜索 API 密钥 | 监控功能的新闻搜索 |\n| `FEISHU_APP_ID` | 飞书应用 ID | 飞书渠道通知 |\n| `FEISHU_APP_SECRET` | 飞书应用密钥 | 飞书渠道通知 |\n| `OPENCLAW_CHANNEL` | OpenClaw 渠道标识 | 消息发送渠道选择 |\n| `CHAT_ID` | 当前对话 ID | 用户识别和数据隔离 |\n\n### 权限说明 / Permissions\n\n**本 Skill 需要以下权限 / This Skill requires:**\n\n1. **文件系统权限 / Filesystem**\n   - 读写 `$HOME/.cuecue` 目录及其子目录\n   - 创建用户数据、任务、监控配置和日志文件\n\n2. **网络权限 / Network**\n   - 出站访问 https://cuecue.cn (深度研究 API)\n   - 出站访问 https://api.tavily.com (可选，监控搜索)\n\n3. **定时任务权限 / Cron**\n   - 安装 cron 作业（每30分钟执行监控检查）\n   - 运行后台研究进程（60分钟超时）\n\n4. **环境变量访问 / Environment**\n   - 读取 OpenClaw 环境变量（如 FEISHU_APP_ID, CHAT_ID）\n   - 读取用户配置的 API Key\n\n**安装建议 / Installation Recommendation:**\n- 初次安装请在测试环境验证\n- 检查并批准 cron 作业和文件系统写入权限\n- 确认 API Key 和网络访问策略\n- 了解监控功能会定期产生外部 API 调用\n\n---\n\n*Cue - 让 AI 成为你的调研助理 / Let AI be your research assistant (Powered by CueCue)*\n\n### 数据隔离 / Data Isolation\n\n**多用户数据安全隔离**\n\n每个用户的数据存储在独立目录：\n```\n~/.cuecue/users/${chat_id}/\n├── .initialized     # 用户初始化标记\n├── tasks/           # 用户专属研究任务\n└── monitors/        # 用户专属监控配置\n```\n\n**安全特性**：\n- ✅ 用户数据完全隔离\n- ✅ 多用户共享实例时互不干扰\n- ✅ 通过 chat_id 识别用户身份\n\n---\n\n## 版本历史 / Version History\n\n### v1.0.4 (2026-02-25)\n- 🔧 全面 Node.js 重构 - 基于 ES Module 的现代架构\n- 🔧 模块化设计 - core/api/commands/utils 清晰分层\n- 🔧 统一日志系统 - 支持多级别日志和文件持久化\n- 🔧 改进错误处理 - 详细的错误信息和日志记录\n- 🔧 Type hints - JSDoc 类型注解提升可维护性\n- 🔧 依赖管理 - 使用 npm 管理 Node.js 依赖\n\n### v1.0.3 (2026-02-25)\n- ✨ 新增：自动角色匹配 - 根据主题关键词智能选择研究视角（trader/fund-manager/researcher/advisor）\n- ✨ 新增：rewritten_mandate 提示词格式 - 结构化调研指令（目标/框架/信源/关注）\n- ✨ 新增：/cn 命令 - 查看监控触发通知（默认最近3日）\n- ✨ 新增：/key 命令 - 交互式 API Key 配置，自动识别服务类型\n- ✨ 新增：智能状态检测 - 首次使用/版本更新/正常使用三种状态\n- 🔧 修复：监控触发通知自动保存到用户目录\n- 🔧 优化：trader 模式支持龙虎榜、资金流向等短线交易分析\n- 📚 更新：SKILL.md 文档，添加新功能说明\n\n### v1.0.2 (2026-02-24)\n- 🔧 修复：API 调用错误（使用内置 cuecue-client.js）\n- 🔧 修复：PID 获取污染问题\n- 🔧 修复：输出文件分离导致的 notifier 错误\n- 🔧 修复：退出码标记格式不一致\n- ✨ 新增：内置 Node.js API 客户端（无额外依赖）\n\n### v1.0.1 (2026-02-24)\n- ✨ 产品定位：\"投研搭子\" → \"调研助理\"\n- 🏷️ 新增 7 个 Tags\n- ⏱️ 优化：超时 30min → 60min\n- 🔔 增强：5分钟进度推送\n- 🔗 新增：自动提取分享链接\n- 🤖 智能：回复 Y 自动创建监控\n- 🌐 新增：多 Channel 支持\n- 📝 新增：详细日志系统\n\n### v1.0.0 (2026-02-23)\n- 🎉 初始发布\n- 深度研究功能\n- 监控管理功能\n\n","topics":["研究","调研"],"tags":{"latest":"1.0.4","ai":"1.0.0","finance":"1.0.0","financial-analysis":"1.0.0","investment":"1.0.0","monitoring":"1.0.0","research":"1.0.0"},"stats":{"comments":0,"downloads":949,"installsAllTime":36,"installsCurrent":2,"stars":0,"versions":5},"createdAt":1771857974803,"updatedAt":1778491620713},"latestVersion":{"version":"1.0.4","createdAt":1772077396247,"changelog":"Cue v1.0.4 introduces a major codebase migration and architectural redesign.\n\n- Entire core codebase migrated from Bash scripts to Node.js for improved maintainability and scalability.\n- New `src/` directory established, implementing main logic in JavaScript (e.g., `cli.js`, `core/`, `api/`).\n- All operational Bash scripts moved to `backups/` for legacy reference; original `scripts/` directory removed.\n- Extensive new documentation and test plans added (integration, migration, release, comparison docs).\n- Manifest and package files updated for new structure and Node.js dependencies.\n- No changes to user-facing commands or workflows; functionality remains consistent.","license":null},"metadata":null,"owner":{"handle":"huhoo","userId":"s17at6ehwns0yxkvp9hrc8dkvs83zr6k","displayName":"cue","image":"https://avatars.githubusercontent.com/u/4213650?v=4"},"moderation":{"isSuspicious":false,"isMalwareBlocked":false,"verdict":"clean","reasonCodes":["review.llm_review"],"summary":"Review: review.llm_review","engineVersion":"v2.4.24","updatedAt":1780089732162}}