Wiki.js命令行工具

技能简介

Wiki.js Skill 是一套完整的命令行工具，通过 GraphQL API 对 Wiki.js 知识库进行全生命周期管理。支持页面读写、标签管理、备份恢复、批量操作、内容分析等日常运维任务。

业务背景

运维团队日常管理Wiki.js知识库时，常面临批量更新、内容迁移、版本回滚等重复性工作。该工具通过命令行实现页面全生命周期管理，将原本需逐页手动操作的任务自动化，显著降低维护成本，确保知识库结构规范与数据安全。

落地案例：某技术团队季度架构文档更新：运维人员使用批量导入功能，将本地50份Markdown文档按目录结构同步至Wiki.js指定空间；随后通过标签管理统一添加

能做什么

• 页面管理：创建、读取、更新、删除、移动页面，支持模板和层级结构
• 搜索查询：全文检索、内容内查找、元数据查看
• 批量操作：从文件夹批量导入/更新页面，本地与远程双向同步
• 版本控制：查看历史记录、回滚指定版本、对比差异
• 质量检查：死链检测、孤立页面查找、重复内容识别、拼写检查
• 资产管理：图片上传、列表查看、删除清理
• 系统维护：健康检查、缓存清理、备份恢复、站点地图生成

使用说明

1. 安装依赖
   npm install && npm link
2. 配置连接
   复制示例配置文件：cp config/wikijs.example.json ~/.config/wikijs.json
   编辑文件填入 Wiki.js 地址和 API Token
3. 验证连接
   wikijs health
4. 常用操作
   列出所有页面：wikijs list
   搜索页面：wikijs search "关键词"
   创建页面：wikijs create "/路径" "标题"
   批量导入：wikijs bulk-create ./pages
   同步到本地：wikijs sync --output ~/wiki-mirror

输入与输出

见下方输入与输出表格。

风险提示

• 删除、覆盖、批量操作不可逆，建议先用 --dry-run 预览变更
• API Token 需妥善保管，避免泄露导致未授权访问
• 高频调用可能触发服务端限流，可使用 --rate-limit 参数控制
• 同步操作注意冲突处理，--watch 模式需保持网络稳定

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/hopyky/wikijs/SKILL.md
来源类型：开源社区技能