Skip to content
Back to search

wpsnote-skills

MarketplaceWorks with Claude CodeGitHubIncomplete

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/wpsnote--wpsnote-skills/badge.svg)](/listings/wpsnote--wpsnote-skills)

HTML

<a href="/listings/wpsnote--wpsnote-skills"><img src="/api/listings/wpsnote--wpsnote-skills/badge.svg" alt="findsafeskills safety rating" /></a>

Install

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 65 lines
  1. {
  2. "name": "wpsnote-skills",
  3. "owner": {
  4. "name": "WPS Note Team"
  5. },
  6. "metadata": {
  7. "description": "WPS 笔记 Agent Skills:让 AI Agent 直接驱动笔记读写、创作、搜索、学习等全场景",
  8. "version": "0.2.0"
  9. },
  10. "plugins": [
  11. {
  12. "name": "core-skills",
  13. "description": "WPS 笔记基础能力:通过云端 MCP(wpsnote)与云端 CLI(wpsnote-cli)进行读写、搜索、XML 编辑与标签管理",
  14. "source": "./",
  15. "strict": false,
  16. "skills": [
  17. "./skills/wpsnote"
  18. ]
  19. },
  20. {
  21. "name": "note-ops-skills",
  22. "description": "笔记整理与美化:智能排版美化、标签体系整理",
  23. "source": "./",
  24. "strict": false,
  25. "skills": [
  26. "./skills/wpsnote-beautifier",
  27. "./skills/tag-organize"
  28. ]
  29. },
  30. {
  31. "name": "content-skills",
  32. "description": "内容创作与搜索阅读:从写作、排版、发布到内容提炼、新闻解读、论文研究",
  33. "source": "./",
  34. "strict": false,
  35. "skills": [
  36. "./skills/content-creator",
  37. "./skills/wechat-publisher",
  38. "./skills/xiaohongshu-note-creator",
  39. "./skills/content-digest",
  40. "./skills/news-to-note",
  41. "./skills/paper-researcher"
  42. ]
  43. },
  44. {
  45. "name": "capture-skills",
  46. "description": "信息捕获与记录:本地文档批量导入、网页无损导入",
  47. "source": "./",
  48. "strict": false,
  49. "skills": [
  50. "./skills/doc-importer",
  51. "./skills/web-importer"
  52. ]
  53. },
  54. {
  55. "name": "learning-skills",
  56. "description": "学习场景:课堂笔记整理、重点提炼与闪卡、误区与前置补缺、知识串联、互动自测批改",
  57. "source": "./",
  58. "strict": false,
  59. "skills": [
  60. "./skills/study-assistant",
  61. "./skills/note-review-coach"
  62. ]
  63. }
  64. ]
  65. }
README.md · README · 208 lines
  1. # WPS 笔记 Skills
  2. [![WPS 笔记首页](https://img.shields.io/badge/WPS笔记-首页-blue?style=flat-square)](https://ainote.kdocs.cn/)
  3. [![下载 WPS 笔记](https://img.shields.io/badge/WPS笔记-下载-green?style=flat-square)](https://ainote.kdocs.cn/wps-notes-hub/)
  4. [![WPS 社区](https://img.shields.io/badge/WPS社区-交流反馈-FF6B35?style=flat-square)](https://bbs.wps.cn/topics/node/28)
  5. 笔记,是思想落地的地方。
  6. 本仓库以 `wpsnote` 为基础能力,让灵犀、WorkBuddy、豆包办公、千问办公、Grok Bot 等主流 AI Agent 通过**云端 MCP** 或**云端 CLI** 直接读写、搜索、整理和管理 WPS 笔记——不依赖桌面端运行。
  7. ---
  8. ## 快速接入:云端 MCP 与云端 CLI
  9. 云端 MCP 与云端 CLI 对接同一个云端服务端,工具能力完全一致,按客户端形态任选其一即可:
  10. ### 方式一:配置云端 MCP(推荐用于办公 AI / 桌面 Agent)
  11. 适用于灵犀、WorkBuddy、豆包办公、千问办公、Grok Bot、Cherry Studio 等支持 Streamable HTTP MCP 的客户端:
  12. 1. 前往 [https://ainote.kdocs.cn/mcp-svc/keys/page](https://ainote.kdocs.cn/mcp-svc/keys/page) 登录 WPS 账号并生成 API Key(按需勾选 `read` / `write` / `destructive` 权限)。
  13. 2. 在客户端 MCP 配置文件中加入 `wpsnote`:
  14. ```json
  15. {
  16. "mcpServers": {
  17. "wpsnote": {
  18. "url": "https://ainote.kdocs.cn/mcp-svc/mcp",
  19. "headers": {
  20. "X-API-Key": "<your-api-key>"
  21. }
  22. }
  23. }
  24. }
  25. ```
  26. ### 方式二:安装云端 CLI(推荐用于终端型 Agent / 脚本自动化)
  27. 适用于终端型 Agent、自动化 Bot 及批量导入导出脚本(需 Node.js ≥ 20.12):
  28. ```bash
  29. # 1. 全局安装云端 CLI
  30. npm install -g wpsnote-cli
  31. # 2. 登录授权(浏览器 OAuth,无浏览器环境可加 --no-browser)
  32. wpsnote-cli auth login
  33. # 或直接从 MCP JSON 导入 / 通过环境变量鉴权
  34. wpsnote-cli auth import <mcp.json>
  35. # export WPS_NOTE_API_KEY="<your-api-key>"
  36. # 3. 验证连接、权限与到期时间
  37. wpsnote-cli auth status --json
  38. # 4. 常用命令测试
  39. wpsnote-cli list --limit 10
  40. wpsnote-cli read --help
  41. ```
  42. > 若此前安装过旧桌面端附带的 `~/.wpsnote-cli`,按安装提示在桌面端「AI 实验室 → 命令行工具 → 卸载」清理后再使用云端 `wpsnote-cli`。
  43. > 在脚本或管道中解析 `--json` 输出时,建议固定追加 `--no-update-notice` 参数避免升级提示混入标准输出。详细文档见 [CLI_REFERENCE.md](./skills/wpsnote/references/CLI_REFERENCE.md) 与 [API_REFERENCE.md](./skills/wpsnote/references/API_REFERENCE.md)。
  44. ### 方式三:安装 Skills 插件(支持插件市场的客户端)
  45. 在支持插件市场的 AI 客户端中注册本仓库并按需安装 Skill 组:
  46. ```text
  47. /plugin marketplace add wpsnote/wpsnote-skills
  48. ```
  49. 建议优先安装 `core-skills`(包含基础 skill `wpsnote`),再按需安装各场景组:
  50. ```text
  51. /plugin install core-skills@wpsnote-skills
  52. /plugin install note-ops-skills@wpsnote-skills
  53. /plugin install content-skills@wpsnote-skills
  54. /plugin install capture-skills@wpsnote-skills
  55. /plugin install learning-skills@wpsnote-skills
  56. ```
  57. ---
  58. ## Skill 分类(共 13 个)
  59. - [./skills](./skills):全部 Skill(每个文件夹内含独立 `SKILL.md`)
  60. - [./comm_script](./comm_script):跨 Skill 复用的公共脚本([wps_cli.py](./comm_script/wps_cli.py)、[image_gen.py](./comm_script/image_gen.py))
  61. ### 核心能力(`core-skills`)
  62. | Skill | 说明 |
  63. |-------|------|
  64. | [wpsnote](./skills/wpsnote) | 通过云端 MCP(`wpsnote`)和云端 CLI(`wpsnote-cli`)读取、编辑、搜索和管理 WPS 笔记 |
  65. ### 笔记整理与辅助(`note-ops-skills`)
  66. | Skill | 说明 |
  67. |-------|------|
  68. | [wpsnote-beautifier](./skills/wpsnote-beautifier) | 智能美化笔记,优化标题层级、高亮块与分栏排版,严格使用 WPS 预设色板 |
  69. | [tag-organize](./skills/tag-organize) | 清理混乱标签、重构多级标签体系、优化分类结构 |
  70. ### 内容创作(`content-skills`)
  71. | Skill | 说明 |
  72. |-------|------|
  73. | [content-creator](./skills/content-creator) | 完整创作工作流:风格画像 → 需求确认 → 大纲 → 深度研究 → 文章 → 定稿 |
  74. | [wechat-publisher](./skills/wechat-publisher) | 将 WPS 笔记排版导出为微信公众号 HTML,支持多种模板风格 |
  75. | [xiaohongshu-note-creator](./skills/xiaohongshu-note-creator) | 将笔记 / 文章转化为小红书图文方案,含每页文案、配图和话题标签 |
  76. ### 搜索与阅读(`content-skills`)
  77. | Skill | 说明 |
  78. |-------|------|
  79. | [content-digest](./skills/content-digest) | 万能内容提炼:URL / 图片 / PDF / 粘贴文本 → 结构化知识笔记,支持图片视觉解读 |
  80. | [news-to-note](./skills/news-to-note) | 新闻智能解读,结合已有笔记库输出个性化 insight,支持新闻简报 |
  81. | [paper-researcher](./skills/paper-researcher) | 学术论文全流程:arXiv / OpenAlex 搜索 → 下载 PDF → 精读分析 → 存入笔记 |
  82. ### 信息捕获(`capture-skills`)
  83. | Skill | 说明 |
  84. |-------|------|
  85. | [doc-importer](./skills/doc-importer) | 批量导入本地文档(Obsidian / 思源 / PDF / Word / HTML 等)到 WPS 笔记 |
  86. | [web-importer](./skills/web-importer) | 网页无损导入:公众号 / X(Twitter) / 通用网页 → WPS 笔记,保留样式与按位插图 |
  87. ### 学习场景(`learning-skills`)
  88. | Skill | 说明 |
  89. |-------|------|
  90. | [study-assistant](./skills/study-assistant) | 课堂逐字稿整理为主笔记、重点提炼与闪卡、误区与前置补缺、费曼提纲及旧知关联 |
  91. | [note-review-coach](./skills/note-review-coach) | 基于已有笔记生成不提前泄题的自测题,作答后按原文证据批改并输出复习建议 |
  92. ---
  93. ## 命令速查
  94. **核心操作模式**:先定位(`outline` / `find` / `search`)→ 再读取(`read` / `section` / `read-blocks`)→ 最后编辑(`edit` / `batch-edit`)
  95. 正文以语义 XML 格式交换,块定位基于顶层 `block_id`(10 位字母数字);文件级标签与回收站使用专用命令/工具管理。
  96. | 分类 | CLI 命令 | MCP 工具 | 说明 |
  97. |------|----------|----------|------|
  98. | 读取 | `wpsnote-cli outline` | `get_note_outline` | 获取结构大纲与 `block_id`,支持分页 |
  99. | 读取 | `wpsnote-cli read` | `read_note` | 读取笔记全文 XML |
  100. | 读取 | `wpsnote-cli section` | `read_section` | 按标题读取章节,支持 `block_offset` 续读 |
  101. | 读取 | `wpsnote-cli read-blocks` | `read_blocks` | 按 ID 批量读取 block |
  102. | 读取 | `wpsnote-cli search` | `search_note_content` | 笔记内搜索,编辑前精确定位 |
  103. | 读取 | `wpsnote-cli read-image` | `read_image` | 读取已持久化图片内容(base64) |
  104. | 读取 | `wpsnote-cli audio` | `get_audio_transcript` | 获取语音录音转写内容 |
  105. | 读取 | `wpsnote-cli xml-ref` | `get_xml_reference` | 获取 XML 标签、预设色板与写入示例 |
  106. | 写入 | `wpsnote-cli edit` | `edit_block` | 单个编辑操作 |
  107. | 写入 | `wpsnote-cli batch-edit` | `batch_edit` | 多个操作原子事务(`delete → replace → update_attrs → insert`) |
  108. | 写入 | `wpsnote-cli insert-image` | `insert_image` | 插入图片(CLI 支持 `--file` 传本地图片) |
  109. | 写入 | `wpsnote-cli gen-image` | `generate_image` | AI 文生图 |
  110. | 管理 | `wpsnote-cli find` | `search_notes` | 全文搜索笔记 |
  111. | 管理 | `wpsnote-cli list` | `list_notes` | 列出笔记(支持 `order_by`、`starred`、`has_todo`、`cursor`) |
  112. | 管理 | `wpsnote-cli create` | `create_note` | 创建空白笔记(返回 `note_id`) |
  113. | 管理 | `wpsnote-cli info` | `get_note_info` | 获取单篇笔记元数据与标签 |
  114. | 管理 | `wpsnote-cli update-info` | `update_note_info` | 修改笔记标题或星标状态 |
  115. | 标签 | `wpsnote-cli tags` | `list_tags` | 分页获取全部标签 |
  116. | 标签 | `wpsnote-cli find-tags` | `find_tags` | 搜索或列出标签(含 `tag_id` 与 `path`) |
  117. | 标签 | `wpsnote-cli get-notes-by-tag` | `get_notes_by_tag` | 查看某个标签下的笔记 |
  118. | 标签 | `wpsnote-cli manage-tags` | `manage_note_tags` | 单篇或批量管理笔记文件级标签 |
  119. | 标签 | `wpsnote-cli add-note-tags` / `remove-note-tags` | `add_note_tags` / `remove_note_tags` | 向笔记增量追加/移除标签 |
  120. | 标签 | `wpsnote-cli rename-tag` / `delete-tag` | `rename_tag` / `delete_tag` | 全局重命名或删除标签(删除需 `--yes`) |
  121. | 导入 | `wpsnote-cli import-web` | `import_web_page` | 导入支持域名的网页内容 |
  122. | 回收站 | `wpsnote-cli trash-list` | `list_trash` | 查看回收站笔记 |
  123. | 回收站 | `wpsnote-cli trash` / `restore` | `trash_note` / `restore_note` | 移入回收站(`--yes`)/ 从回收站恢复 |
  124. | 回收站 | `wpsnote-cli purge` | `permanently_delete_note` | 永久删除回收站中的笔记(不可恢复,需 `--yes`) |
  125. ---
  126. ## 创建与贡献 Skill
  127. 在 `skills/<your-skill-name>/SKILL.md` 下新建文件,保持结构聚焦于具体业务场景:
  128. ```markdown
  129. ---
  130. name: my-skill-name
  131. description: 一句话说明 Skill 的能力范围与触发条件
  132. ---
  133. # Skill 名称
  134. > WPS 笔记接口、XML 与通用错误码规范见 [wpsnote](../wpsnote/SKILL.md)。
  135. [在此编写业务场景的工作流、输入输出格式与质量要求]
  136. ```
  137. 编写规范详见 [claude-skills-complete-guide.md](./claude-skills-complete-guide.md)。
  138. ### 贡献步骤
  139. 1. **独立场景边界**:编写 `SKILL.md` 时明确 `name` 与带清晰触发边界的 `description`,避免与现有 Skill 重叠。
  140. 2. **复用基础能力**:笔记读写、标签管理、XML 格式与错误处理均直接引用 [wpsnote](./skills/wpsnote/SKILL.md)(Python 批量脚本统一复用 [comm_script/wps_cli.py](./comm_script/wps_cli.py)),不在场景 Skill 中重复抄写接口细节。
  141. 3. **更新索引并提交 PR**:同步更新 `.claude-plugin/marketplace.json` 与 `README.md` 中的 Skill 列表,或通过 [Issue](https://github.com/wpsnote/wpsnote-skills/issues) / [WPS 社区](https://bbs.wps.cn/topics/node/28) 交流反馈。
  142. [![加入 WPS 社区](https://img.shields.io/badge/WPS笔记-加入WPS社区-FF6B35?style=flat-square)](https://bbs.wps.cn/topics/node/28)
  143. ## 贡献者
  144. 每一个 Skill,都是有人把自己摸索出来的工作方式,提炼成了别人也能用的技巧。
  145. <!-- 如果你贡献了 Skill,欢迎通过 PR 把自己加到这里 -->
  146. <a href="https://github.com/itshen" title="itshen"><img src="https://github.com/itshen.png?size=64" width="48" height="48" hspace="4" alt="@itshen"/></a><a href="https://github.com/wps-x" title="wps-x"><img src="https://github.com/wps-x.png?size=64" width="48" height="48" hspace="4" alt="@wps-x"/></a><a href="https://github.com/loki2046-mao" title="loki2046-mao"><img src="https://github.com/loki2046-mao.png?size=64" width="48" height="48" hspace="4" alt="@loki2046-mao"/></a><a href="https://github.com/KevinYoung-Kw" title="KevinYoung-Kw"><img src="https://github.com/KevinYoung-Kw.png?size=64" width="48" height="48" hspace="4" alt="@KevinYoung-Kw"/></a><a href="https://github.com/chadyi" title="chadyi"><img src="https://github.com/chadyi.png?size=64" width="48" height="48" hspace="4" alt="@chadyi"/></a><a href="https://github.com/dengchunlan" title="dengchunlan"><img src="https://github.com/dengchunlan.png?size=64" width="48" height="48" hspace="4" alt="@dengchunlan"/></a><a href="https://github.com/liminwanqing" title="liminwanqing"><img src="https://github.com/liminwanqing.png?size=64" width="48" height="48" hspace="4" alt="@liminwanqing"/></a><a href="https://github.com/oaeen" title="oaeen"><img src="https://github.com/oaeen.png?size=64" width="48" height="48" hspace="4" alt="@oaeen"/></a><a href="https://github.com/Naruto-mitsubishi" title="Naruto-mitsubishi"><img src="https://github.com/Naruto-mitsubishi.png?size=64" width="48" height="48" hspace="4" alt="@Naruto-mitsubishi"/></a>
  147. ---
  148. > 所有内容,都值得等到被用到的那天。

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.