SuperAPI AI 工具集

wps-note

通用与其它

查看项目

更新于 10-16 03:12

技能介绍

用途:在支持 MCP 的客户端中操作 WPS 笔记,涵盖读取、编辑、搜索、总结、翻译笔记内容,以及创建笔记、管理标签、整理笔记库,也可用于排查 MCP 工具调用错误(如 BLOCK_NOT_FOUND、EDITOR_NOT_READY)。不适用于本地 Markdown 文件、WPS 文档/表格/演示等其他产品及纯概念讨论。

主要能力:核心操作模式为先定位(outline/search)、再读取(read)、最后编辑(write)。笔记由 block 组成,每个 block 有唯一 block_id(10 位字母数字);支持 paragraph、heading、blockquote、code_block、list、table、image、horizontal_rule、highlight_block、columns、embed、note_audio_card 等类型。embed 与 note_audio_card 为只读,后者可用 get_audio_transcript 获取转写。表格必须整表替换,单元格仅支持简单块;容器嵌套有明确限制。提供读取类工具(get_note_outline、read_note、read_section、read_blocks、search_note_content、read_image、get_cursor_block、get_xml_reference)、写入类工具(edit_block、batch_edit、insert_image、generate_image)、管理类工具(list_notes、create_note、get_note_info、get_current_note、search_notes、find_tags、manage_note_tags、sync_note、delete_note、get_note_stats、get_mcp_logs),以及隐藏写入工具 replace_block、insert_block、delete_blocks、update_block_attrs。

使用方式:先用 get_current_note 获取 note_id 与 size_category,再按文档大小选择策略——small 直接 read_note,medium 用 outline + read_section,large/very_large 用 search_note_content 精准定位后 read_blocks。写入时 content 必须是完整 XML 字符串(不能是纯文本、Markdown 或自然语言指令),replace 需 block_id,insert 需 anchor_id、position、content;连续插入优先一次拼完整 XML,或用上次返回的 last_block_id 作锚点。多操作可用 batch_edit 合并为原子事务,执行顺序固定为 delete → replace → update_attrs → move → insert。示例:edit_block({ note_id: "abc123", op: "replace", block_id: "xY7nPq2wRt", content: "<p>更新后的段落文本</p>" })。

只读与限制:部分笔记 token 为只读,写入返回 DOCUMENT_READ_ONLY,retryable 为 false,不要重试。写入前须用 outline 刷新 block_id,否则可能 BLOCK_NOT_FOUND。图片不可通过 XML 创建,须用 insert_image;generate_image 每用户每分钟限 1 次,耗时 30–120 秒;import_web_page 仅支持白名单域名,耗时 5–30 秒;delete_note 不可恢复,须先与用户确认。颜色受预设色板约束,任意 hex 值会被静默丢弃。工具返回统一信封结构(ok、code、message、retryable、data、hints)。文档超过 200 blocks 时 read_note 和 get_note_outline 自动分页,可用 offset 与 block_limit 控制。

资料未覆盖:收费方式、价格、支持的操作系统与客户端版本、安装步骤等暂未提供。