全功能 Confluence Cloud REST API v2 集成工具，支持页面、空间、数据库等全资源管理，具备企业级双认证与分页能力。
说明：
## 核心用法
`confluence-v2` 是一个针对 Confluence Cloud REST API v2 的完整技能封装，提供对 Pages、Spaces、Folders、Databases、Whiteboards、Comments、Labels、Tasks、Properties 等全部资源组的原生访问能力。用户通过环境变量配置 Basic（邮箱+API Token）或 OAuth 2.0 认证后，即可使用 `scripts/` 目录下的模块化脚本执行 CRUD 操作。
### 主要功能模块
– **pages.js**: 页面创建、查询、更新、删除
– **spaces.js**: 空间管理与列表遍历
– **folders.js**: 层级目录操作（含直接子项查询）
– **databases.js / whiteboards.js**: 新型数据结构支持
– **comments.js / labels.js / tasks.js**: 协作功能完整覆盖
– **call.js**: 透传任意 API 端点，支持 ad-hoc 调试
### 显著优点
1. **API v2 完整覆盖**: 相比 legacy CLI，全面支持 Atlassian 主推的 v2 端点（数据库、白板等新资源类型）
2. **双认证体系**: Basic Auth 适合自动化脚本，OAuth 适合用户态集成，均通过标准 HTTP 头实现
3. **分页内建**: `client.js` 自动处理 Confluence 的分页 cursor，简化大数据集遍历
4. **平滑迁移**: 自动识别 `~/.confluence-cli/config.json` 配置格式，降低存量用户切换成本
### 潜在局限与风险
– **权限依赖严格**: 所有操作受限于 Confluence 站点权限模型，API Token 需具备对应空间的管理权限
– **Premium/Enterprise 功能限制**: Admin Key Header 仅高级版可用，免费/标准版用户无法使用组织级管理接口
– **OAuth Token 生命周期**: 需自行处理刷新逻辑，技能本身不提供 token 自动续期
– **Base URL 硬编码模式**: 强制要求 `atlassian.net/wiki` 域名结构，私有化部署（Data Center）不支持
### 适合人群
– DevOps/SRE 团队：批量页面生成、空间结构自动化管理
– 知识库管理员：跨空间内容迁移、标签体系规范化
– 集成开发者：构建与 Confluence 数据双向同步的第三方应用
### 常规风险提示
?? **生产数据操作不可逆**: DELETE 操作直接作用于云端，建议先在沙箱空间验证脚本
?? **Token 安全存储**: API Token 等效于账户密码，禁止使用明文提交至版本控制
?? **速率限制**: Atlassian 实施严格的 API 配额（通常 1000 req/5min），批量任务需内置退避重试
