SuperAPI AI 工具集

cli-anything-siyuan

办公与效率

查看项目

更新于 10-15 22:13

技能介绍

用途:cli-anything-siyuan 是思源笔记(SiYuan)的 CLI 封装,面向本地优先的知识管理与笔记场景,通过思源内核的 HTTP API(默认 http://127.0.0.1:6806)提供结构化访问。

主要能力:notebook 组支持列出、创建、重命名、删除、打开笔记本;doc 组支持创建文档(可带 --md 内容)、列出文档、查看文档树、按 ID 获取路径、重命名与删除;block 组支持插入、更新、删除块,获取块 kramdown 源码与子块;另有 sql 执行块数据库 SQL、search 全文搜索、export md 导出文档为 Markdown、tag list 列出标签、version 查看内核版本、status 查看连接与会话状态、repl 进入交互模式。

使用方式:需先运行思源(在 设置 → 关于 中查看 API token),并安装 Python 3.10+。安装命令:pip install cli-anything-siyuan,或在 agent-harness/ 下执行 pip install -e .。建议加 --json 获取机器可读输出。示例:cli-anything-siyuan --json notebook list;cli-anything-siyuan doc create nb1 /projects/new --md "## Title\n\nContent";也可用 stdin 管道传入 Markdown(--md -)避免 shell 转义;SQL 示例:cli-anything-siyuan sql "SELECT id, content FROM blocks WHERE content LIKE '%meeting%' LIMIT 5";导出:cli-anything-siyuan export md doc123。

限制与错误处理:连接失败需检查思源是否运行及 token 是否正确;API 错误以 {"code": N, "msg": "..."} 返回,需查看 msg 字段;认证错误需核对 ~/.siyuan-cli.json 或 SIYUAN_TOKEN 环境变量。文档 ID 形如 20210817205410-2kvfpfn(基于时间戳)。其余未在资料中说明的功能、收费与平台信息暂未提供。