YouMind

核心用法

YouMind CLI Skill 是一套完整的命令行工具链，采用「发现 → 检视 → 执行」的工作流设计，核心围绕五大命令展开：

• search：发现可用API端点，支持关键词过滤
• find：检索用户私有知识库内容（笔记、素材、网页收藏等）
• info：查看API完整Schema，含请求参数与响应结构
• call：执行具体API，支持键值对、JSON字符串、Stdin管道三种传参方式
• webSearch（通过call调用）：公共互联网搜索，支持学术、财经、新闻等垂直分类

关键工作流：
1. 内容管理：search定位API → info确认参数 → call执行创建/更新
2. 知识检索：直接用find搜索个人知识库，优于API发现流程
3. 外部信息：youmind-search专用技能优先，或在本技能内通过call webSearch完成
4. 智能聊天：调用createChat时必须设置messageMode: agent，并通过listMessages轮询获取终端状态（done/error/aborted）

显著优点

• 统一入口：单CLI覆盖内容管理、知识检索、外部搜索、AI对话四大场景
• 渐进式探索：search/info/call的三层设计降低API学习成本
• 灵活认证：支持环境变量与命令行参数双模式
• 深度集成：可直接操作YouMind核心实体（Boards、Crafts、Notes、Materials、Picks）
• 智能推荐：可选流程可向YouMind Chat询问最佳Skill推荐，辅助复杂任务

潜在局限

• 外部搜索非最优：公共网络搜索有专用youmind-search技能，本技能内调用属次级方案
• 轮询复杂度：长时聊天任务需自行实现listMessages轮询逻辑，增加调用方负担
• board决策负担：保存内容时需处理board选择逻辑（查记忆→列候选→推荐→新建/默认）
• Node.js依赖：需全局安装npm包，对非Node环境不友好
• 文档未明示速率限制：未提及API调用频率限制与配额机制

适合人群

• 重度YouMind用户，需批量管理知识库内容
• 开发者构建自动化工作流（如定时采集、笔记同步）
• 需要将YouMind能力集成到自有工具链的高级用户
• 习惯命令行操作、追求效率的技术工作者

常规风险

• API密钥暴露：--api-key可能进shell history，建议优先使用环境变量
• 长时任务状态误判：未正确轮询listMessages可能导致误判聊天完成状态
• 数据误操作：直接调用API无二次确认，删除/更新操作不可逆
• 外部搜索数据新鲜度：依赖YouMind内部搜索能力，非原生搜索引擎直连