首次使用流程（全自动）

Agent 第一次调用任意 youdaonote 工具时，插件检查 CLI：
- 已存在（PATH 或数据目录）→ 直接用；
- 不存在且平台是 Linux/macOS → 自动执行官方安装脚本装入 ~/.dsh/integrations/dsh-youdaonote/bin（需要 curl 和 bash，阿里云 Linux 默认都有）；
- Windows 不支持自动安装，会报错并附手动安装指引。
接着运行 youdaonote check：若 api-key 未配置且运行环境支持提问（Web UI / TUI 均支持），弹卡片请你粘贴 API Key（从 https://mopen.163.com 获取，手机号登录），拿到后自动执行 config set apiKey 完成配置；环境不支持提问（headless 等）时，报错信息里带手动配置命令。
配置结果按进程记忆，之后不再重复检查；如果中途 Key 失效，下一次调用会自动重新检查并再次询问。

API Key 由 CLI 自己存储（~/.youdaonote.json），插件不落盘、不进日志。

配置

默认值全部内建，patch 行可以不写 config。需要覆盖时在 profile 的 cordis.patch.yml 加：

- insert:
    - id: youdaonote
      name: dsh-youdaonote
      config:
        bin: youdaonote        # CLI 路径覆盖；设为非默认值后插件只认这一处，不再自动找
        statSource: ydn        # CLI -s 统计来源参数
        timeoutMs: 120000      # 单次 CLI 调用超时（clip 剪藏较慢，别低于 60s）
        maxOutputChars: 100000 # 工具输出字符上限
        autoInstall: true      # CLI 缺失时自动安装（Linux/macOS）
        autoAskKey: true       # 缺 Key 时通过提问服务索要
        dataDir: ~/.dsh/integrations/dsh-youdaonote   # 插件数据目录
        binDir: ~/.dsh/integrations/dsh-youdaonote/bin # 自动安装的目标目录
        installUrl: https://artifact.lx.netease.com/download/youdaonote-cli/install.sh

安装

说明文档

首次使用流程（全自动）

配置