【科普】灵犀Claw内置与金山文档官方的kdocs SKILL的区别
一、基本信息
维度 | wps-docs（kdocs） | 金山文档（kdocs） |
来源 | WPS灵犀Claw内置 | 从kdocs.cn网站下载 |
SKILL.md 大小 | 2,070 字符 | 15,356 字符 |
总文件大小 | ~80 KB（3 个脚本） | ~197 KB（SKILL + 7 个 reference） |
定位描述 | WPS 云文档与多维表能力 | 金山文档官方 Skill，完整在线文档操作平台 |
二、技术架构
维度 | wps-docs | 金山文档 |
运行机制 | 本地 Python 脚本直接调用 REST API | MCP（Model Context Protocol）通过 mcporter 中转调用 |
认证方式 | 内嵌 Token（脚本内部处理） | mcporter 配置管理，支持 get-token.sh/get-token.ps1 脚本 + 手动获取兜底 |
依赖环境 | Python 环境，import kdocs / import dbsheet | mcporter CLI 工具 + MCP 服务端 |
目标平台 | WPS 灵犀桌面端（内置 Agent） | OpenClaw / Cursor / Claude Code 等通用 MCP 客户端 |
参考文档 | 1 个子文档（SKILL_dbsheet.md） | 7 个 reference 文档，按文档类型分册 |
关键区别：wps-docs 是为 WPS 灵犀桌面端量身定制的 Python SDK 封装；金山文档是基于 MCP 协议的通用技能，面向多种 AI 客户端。
三、功能覆盖范围
3.1 通用文件操作
功能 | wps-docs | 金山文档 |
获取文件信息 | get_file_info | get_file_info |
下载文件到本地 | download_file | download_file |
上传本地文件 | upload_file | upload_file |
最近文件列表 | list_latest_items | list_latest_items |
搜索文件 | -- | search_files（支持文件名/全文） |
列出目录文件 | -- | list_files |
创建文件/文件夹 | -- | create_file |
重命名文件 | -- | rename_file |
移动文件 | -- | move_file（批量） |
复制文件 | -- | copy_file（跨盘） |
删除/回收站 | -- | list_deleted_files + restore_deleted_file |
读取文档内容 | -- | read_file_content（自动转 Markdown） |
获取在线链接 | -- | get_file_link |
检查文件名 | -- | check_file_name |
网页剪藏 | -- | scrape_url + scrape_progress |
3.2 分享与协作
功能 | wps-docs | 金山文档 |
开启分享 | -- | share_file |
修改分享权限 | -- | set_share_permission |
取消分享 | -- | cancel_share |
获取分享信息 | -- | get_share_info |
3.3 标签与收藏
功能 | wps-docs | 金山文档 |
标签管理（6 个工具） | -- | 完整支持 |
收藏/星标（3 个工具） | -- | 完整支持 |
3.4 多维表（DbSheet）
功能 | wps-docs | 金山文档 |
Schema 查询 | get_schema | dbsheet.get_schema |
创建文件 | create_file | create_file + dbsheet.create_sheet |
字段管理 | create/update/delete_fields | dbsheet.create/update/delete_fields |
记录 CRUD | list/get/search/create/update/delete_records | 同左 + delete_empty_records |
数据表管理 | create/update/delete_sheet | 同左 |
视图管理 | create/delete/update_view | 同左 |
表单元数据 | get/update_form_meta | -- |
3.5 其他文档类型操作
文档类型 | wps-docs | 金山文档 |
智能文档（.otl） | -- | otl.*（insert/block 操作，5 个工具） |
表格（.xlsx/.ksheet） | -- | sheet.*（工作表管理、范围数据，4 个工具） |
文字文档（.docx） | -- | wps.*（导出，3 个工具） |
PDF（.pdf） | -- | pdf.*（页数查询、页面提取，2 个工具） |
演示文稿（.pptx） | -- | wpp.*（幻灯片操作、导出，7 个工具） |
四、功能数量统计
维度 | wps-docs | 金山文档 |
云文档基础操作 | 4 个 | 32 个 |
多维表操作 | 19 个 | 15 个（+ 19 个 dbsheet.*） |
智能文档操作 | 0 | 5 个（otl.*） |
表格操作 | 0 | 4 个（sheet.*） |
Word 操作 | 0 | 3 个（wps.*） |
PDF 操作 | 0 | 2 个（pdf.*） |
PPT 操作 | 0 | 7 个（wpp.*） |
合计可用工具 | ~23 个 | ~93 个 |
五、设计理念与质量
维度 | wps-docs | 金山文档 |
文档成熟度 | 轻量，快速参考风格 | 企业级，含完整的操作指南、风险控制、错误处理 |
错误处理规范 | 简单错误表 | 完整错误速查表 + 重试策略 + 幂等性分析 |
安全约束 | 无显式安全规则 | 完整安全体系（Token 保护、操作风险分级、前置检查/后置验证） |
交付验证 | 无 | 每个写操作都有独立验证步骤 |
版本管理 | 无 | 语义化版本 + 远端版本自检 + 升级指引 |
决策树 | 无 | 文件创建/读取/写入均有完整决策树 |
工具组合指南 | 无 | 提供 12 种常见场景的工具组合速查 |
参考文档组织 | 单文件 | 按文档类型分 7 册，职责清晰 |
六、适用场景分析
场景 | 推荐技能 | 原因 |
在灵犀桌面端快速上传/下载云文档 | wps-docs | 零配置，import kdocs 即用 |
操作多维表（DbSheet） | wps-docs | 接口更丰富（含 get/update_form_meta、delete_empty_records） |
完整在线文档管理 | 金山文档 | 覆盖搜索、分类、标签、收藏、回收站等全生命周期 |
在线创建/编辑多种文档类型 | 金山文档 | 支持智能文档、表格、Word、PDF、PPT 五种类型 |
网页剪藏到云文档 | 金山文档 | 内置 scrape_url 能力 |
文档分享与权限管理 | 金山文档 | 完整的分享/权限/取消分享流程 |
非灵犀客户端使用 | 金山文档 | MCP 协议，适配 OpenClaw/Cursor/Claude Code |
七、总结
维度 | wps-docs | 金山文档 |
一句话定位 | 灵犀内置的轻量云文档 Python SDK | 金山文档官方全功能 MCP 技能 |
核心优势 | 即开即用、多维表接口更底层 | 功能全面（4 倍工具量）、文档规范、跨平台 |
核心劣势 | 功能狭窄、文档简陋、仅限灵犀 | 需要配置 mcporter + Token，上手成本高 |
成熟度 | 早期/内部工具级别 | 生产/官方发布级别 |
两者不是替代关系，而是互补关系：wps-docs 是灵犀桌面端的原生内置能力，适合轻量快速的云文档与多维表操作；金山文档是官方出品的通用型全功能技能，适合需要完整文档管理能力的复杂场景。如果你需要在灵犀之外的环境（如 Cursor、Claude Code）操作金山文档，只能使用金山文档技能。
