cchenbin042/yuque-notes-plugin

README excerpt

yuque-notes-plugin dsh 工具插件：把零散的笔记（文本 + 图片）保存到语雀知识库，由模型根据笔记内容自动分类。 功能 插件向 agent 暴露三个工具： 工具 作用 yuque list toc 列出笔记知识库的目录树（含文档），模型据此决定新笔记归到哪个分类 yuque create dir 在知识库中创建目录（分类）节点；同名同父已存在时直接返回既有节点，不重复创建 yuque create doc 把一条笔记保存为语雀文档：Markdown 正文，图片引用自动读取、上传并替换，返回文档 URL 保存链路： 每次保存只需 2–3 次工具调用；图片上传在 yuque create doc 内部完成，模型只需在正文里写图片引用。 其他行为： - 知识库不存在时自动创建（使用配置的 bookName ） - 错误归一化并 fail-loud：401/403 为鉴权错误、404 为资源缺失；429/5xx 自动退避重试（最多 3 次） - 请求可取消：所有网络请求都随 agent 的 signal 中止 安装 四种方式： 1. 从 npm 安装（推荐，最简单） 2. 安装到 profile（本地开发，持久生效） （在插件仓库根目录执行）插件包的 dsh.bundle.patch 声明会让 profile 自动把本插件的 cordis.patch.yml 加入 bundle 层。 注意：本地目录安装（ dsh plugin add . ）不触发 prepare ，需先构建： pnpm build 。 3. 从 GitHub 安装（社区用户） git 安装拉取的是源码而非构建产物，pnpm 会在安装时自动运行本插件的 prepare 脚本（ tsc 构建出 lib/ ，故 prepare 脚本不可删）。pnpm ≥ 10 默认拒绝执行 git 依赖的构建脚本：首次 add 失败时，把 pnpm 打印的包键加入该 profile 的 pnpm-workspace.yaml 的 allowBuilds ，再重新执行 add 。该授权允许包代码在安装时于本机执行，建议锁定 commit（ github:cchenbin042/yuque-notes-plugin ）后再授权。 或 pnpm pack 后 dsh plugin --profile add ./yuque-notes-plugin-0.1.0.tgz 。 4. 临时 overlay（仓库内调试，不安装） 配置 插件随附的 cordis.patch.yml 已默认接入配置： 配置项 默认值 说明 token （或环境变量 YUQUE TOKEN ） 无（必填） 语雀 API token；只注入请求头，绝不写入工具参数、返回或日志 bookName 我的笔记 目标知识库名，不存在时自动创建；…

Category