---
name: gitlink-wiki
version: 1.0.0
description: "Wiki 管理：基于 Git 仓库操作，支持 Wiki 页面的列出、查看、创建、更新、删除。当用户需要管理 GitLink 项目 Wiki 时触发。"
metadata:
  requires:
    bins: ["gitlink-cli"]
  cliHelp: "gitlink-cli wiki --help"
---

# gitlink-wiki（Wiki 管理）

**CRITICAL — 开始前必须先阅读 [`../gitlink-shared/SKILL.md`](../gitlink-shared/SKILL.md)，其中包含认证、权限处理和 API 注意事项。**
**CRITICAL — 所有 Shortcuts 在执行写入/删除操作前，务必先确认用户意图。**
**CRITICAL — GitLink 操作只能用 `gitlink-cli`。禁止用 `gh`（GitHub CLI）操作 GitLink 资源。`gh` 仅适用于 GitHub 平台。**

> **前置条件：** 先阅读 [`../gitlink-shared/SKILL.md`](../gitlink-shared/SKILL.md) 了解认证和全局参数。

## 说明

GitLink 的 Wiki 是一个独立的 Git 仓库（`{owner}/{repo}.wiki.git`），每个 Wiki 页面是一个 `.md` 文件。
读操作（list/view）无需认证，写操作（create/update/delete）需要 Personal Access Token。

## Shortcuts

| Shortcut | 说明 | 需要认证 |
|----------|------|----------|
| `wiki +list` | 列出 Wiki 页面 | 否（公开项目） |
| `wiki +view` | 查看 Wiki 页面内容 | 否（公开项目） |
| `wiki +create` | 创建 Wiki 页面 | 是 |
| `wiki +update` | 更新 Wiki 页面 | 是 |
| `wiki +delete` | 删除 Wiki 页面 | 是 |

## 使用示例

```bash
# 列出 Wiki 页面
gitlink-cli wiki +list --owner myuser --repo myrepo

# 查看 Wiki 页面内容
gitlink-cli wiki +view --owner myuser --repo myrepo --page-name "Home"

# 创建 Wiki 页面（需要认证）
gitlink-cli wiki +create --owner myuser --repo myrepo --page-name "guide" --title "使用指南" --content "这是使用指南" --message "创建新页面"

# 更新 Wiki 页面
gitlink-cli wiki +update --owner myuser --repo myrepo --page-name "guide" --title "更新标题"

# 删除 Wiki 页面（确认后再执行）
gitlink-cli wiki +delete --owner myuser --repo myrepo --page-name "guide"
```

## 注意事项

- 更改页面名或删除页面后，自动生成的 _Sidebar.md 不会立即更新，等待 GitLink 网页端重建。
- 中文页面名会进行 URL 编码（如 `Wiki测试` → `Wiki%E6%B5%8B%E8%AF%95.md`）。
- `--content` 和 `--file` 不能同时使用。
- 如果不在仓库目录内运行，需要 `--owner` 和 `--repo` 参数。
