Wikijs

Status

Frozen draft. This skill is intentionally not discoverable by scanSkillsDirectory() because it has no index.js / index.py entrypoint.

Do not register or enable it until the external Wiki.js write boundary, credentials, and API wrapper contract are reviewed. See STATUS.md.

Wiki.js - Wiki 交互技能

通过 GraphQL API 和 REST 上传端点操作 Wiki.js 实例。

工具

页面操作

listPages

列出所有页面。

参数：

• orderBy (string, optional): 排序方式，默认 'TITLE'

getPageByPath

按路径获取页面。

参数：

• path (string, required): 页面路径
• locale (string, required): 语言代码，如 'en'

createPage

创建页面。

参数：

• path (string, required): 页面路径
• title (string, required): 页面标题
• content (string, required): 页面内容（Markdown）
• locale (string, optional): 语言代码，默认 'en'
• description (string, optional): 页面描述
• tags (string[], optional): 标签数组
• isPublished (boolean, optional): 是否发布，默认 true

updatePage

更新页面。

参数：

• id (number, required): 页面 ID
• content (string, optional): 新内容
• title (string, optional): 新标题

deletePage

删除页面。

参数：

• id (number, required): 页面 ID

文件上传

uploadFile

上传文件到 Wiki.js。

参数：

• filePath (string, required): 本地文件路径
• filename (string, required): 文件名
• folderId (number, required): 目标文件夹 ID

返回：

{ "succeeded": true, "message": "ok" }

上传格式说明： Wiki.js 文件上传需要两个字段都命名为 mediaUpload：

1. 第一个字段：文件夹元数据 JSON {"folderId": 1}
2. 第二个字段：实际文件内容

资源管理

listAssetFolders

列出资源文件夹。

参数：

• parentId (number, required): 父文件夹 ID（根目录为 0）

listAssets

列出资源。

参数：

• folderId (number, required): 文件夹 ID
• kind (string, optional): 资源类型 - 'ALL', 'IMAGE', 'BINARY', 'PDF', 'CODE', 'MARKUP', 'VIDEO', 'AUDIO'

配置要求

需要以下环境变量：

• WIKIJS_URL - Wiki.js 实例 URL（如 https://wiki.example.com）
• WIKIJS_TOKEN - API Token（从 Admin > API Access 获取）

常见上传错误

相关技能

PPT 转 Wiki.js：使用 ppt-to-wiki 技能将 PowerPoint 转换为 Wiki.js 页面。