yuque-notes-plugin

配置

插件随附的 cordis.patch.yml 已默认接入配置：

- insert:
    - id: yuque-notes
      name: yuque-notes-plugin
      config:
        bookName: 我的笔记
        tokenEnv: YUQUE_TOKEN
        imageHosting:
          provider: github
          # 图片图床仓库（建议独立公开仓库）
          repo: '/'
          tokenEnv: GITHUB_TOKEN

配置项	默认值	说明
tokenEnv（凭据引用名）	YUQUE_TOKEN	语雀 API token 的凭据引用名；配置只携带引用名，值由 harness 凭据服务解析。token 只注入请求头，绝不写入工具参数、返回或日志
bookName	我的笔记	目标知识库名，不存在时自动创建；知识库默认私有创建
baseUrl	https://www.yuque.com	语雀 API 基址，为私有化部署预留
imageHosting.provider	无	图片图床类型，目前仅支持 github
imageHosting.repo	无（有图片时必填）	图片仓库，owner/repo 形式
imageHosting.tokenEnv（凭据引用名）	GITHUB_TOKEN	GitHub token（contents API 写权限）的凭据引用名
imageHosting.branch / basePath / cdn	main / images / jsdelivr	目标分支 / 仓库内目录前缀 / 对外 URL 形式（jsdelivr 或 raw）

token 的解析时机与位置：token 在每次工具调用/上传时按操作解析（惰性加载），不再在插件加载时冻结。解析优先走 harness 凭据服务（web 设置页或 $DSH_HOME/.credentials.yaml 可写），其内部按「进程环境 → .credentials.yaml → 调用目录 .env → $DSH_HOME/.env」的优先级取首个非空值；凭据服务缺失时回退到启动环境读取。改完凭据下一次调用立即生效，无需重启 Harness；未配置时插件照常加载，调用语雀工具时才返回带配置指引的错误（fail-loud 移至调用时），不影响启动与其他插件使用。

使用

在 dsh 会话（命令行或 web 界面）里直接说，例如：

把 E:\学习\langchain-02.pdf 整理成笔记存到语雀

模型会加载 skill 并自动执行：

1. 用 pypdf 按页提取文本（保留标题层级、表格、代码块）
2. 提取插图到 images/（跳过封面页与 15KB 以下的装饰小图）
3. 组装 Markdown，在关键论述处插入图片引用
4. 调 yuque_list_toc 看目录 → 目录不存在则 yuque_create_dir 创建 → yuque_create_doc 保存
5. 校验返回的 uploadedImages 等于插入的图片数，缺图会重试而不是静默存纯文本

使用示例

对话指令：

帮我把这段记到语雀：git rebase 时遇到冲突，用 git status 查看冲突文件，解决后 git add 再 git rebase --continue

模型会依次调用 yuque_list_toc（查看现有分类）→ 决定分类（必要时 yuque_create_dir 新建）→ yuque_create_doc，最后输出文档 URL。