SuperAPI AI 工具集

use-paper-cli

写作与研究

查看项目

更新于 10-15 23:48

技能介绍

用途:在无法直接使用原生 MCP 时,通过 paper Rust CLI 作为通用、schema 驱动的桥接层操作 Paper Desktop 的实时 MCP 服务器。实时工具目录与 schema 是权威依据,不应依赖记忆中的参数结构。

主要能力:提供 inspect、use、html、tree、batch、new、artboard、doctor、status、context、files、open、screenshot、tools、schema、call 等命令;支持截图输出、HTML 写入、批量步骤、原始 MCP 信封与紧凑输出等。

使用方式:先确认 CLI 是否安装(command -v paper),缺失时明确报告,不静默安装;仓库建议安装命令为 cargo install --git https://github.com/lassejlv/paper-cli --locked。需 Paper Desktop 运行且打开文件。默认端点为 http://127.0.0.1:29979/mcp,仅在用户配置其他端点时使用 --url 或 PAPER_MCP_URL。标准流程为:paper inspect 建立文件上下文,必要时 paper use <id>,再执行读取或写入;写入前先读 schema,优先使用便捷命令,复杂输入用 @file JSON 或 --dry-run。

适用场景:需要检查 Paper 文件结构、读取节点信息、写入 HTML、截图、批量操作或调用底层工具时。

限制:每个 paper 进程是新的 MCP 会话,除非写入状态,否则 paper open 不会跨调用保持;只读检查不授权修改;破坏性操作需确认;--force 会覆盖本地文件;不要暴露原始节点 ID;不能仅凭退出码报告完成,需检查最终状态。错误处理包括连接失败、fileOpen: false、NO_FILE_OPEN、多文件歧义、未知工具、参数无效、批量步骤失败等。更新仅在用户明确要求时运行 paper upgrade。