wovo

Name: wovo
Author: theshajha

本地服务

github.com/theshajha云与基础设施017 周前更新

代码仓库

关于 wovo

wovo 是用于将 HTML 发布到 wovo.dev 版本化共享库的命令行工具和 MCP 服务。它支持从 AI 工具或终端部署，并可管理页面及回滚到已保存的版本。

主要功能

01从文件或内联内容部署 HTML
02将每次部署保存为新版本
03列出并管理工作区页面
04归档、移动和重命名页面
05管理工作区域名

适用场景

01发布 AI 生成的 HTML 报告
02从文件夹部署多个 HTML 文件
03恢复页面的较早版本
04管理工作区页面和域名

MCP 相关

MCP 服务提供部署和列出页面、管理页面状态与名称，以及处理工作区域名的工具。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "theshajha-wovo": {
      "command": "npx",
      "args": [
        "-y",
        "@gowovo/wovo"
      ],
      "env": {
        "WOVO_TOKEN": "<WOVO_TOKEN>",
        "WOVO_WORKSPACE": "<WOVO_WORKSPACE>"
      }
    }
  }
}

启动命令npx -y @gowovo/wovo

需要配置的环境变量

WOVO_TOKEN密钥Workspace deploy token (wv_…) from wovo.dev settings.

WOVO_WORKSPACETarget workspace slug (optional; the token resolves a default).

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npm@gowovo/wovo0.2.2stdio

工具

收录的工具列表 · 更新于 2 周前

参数	类型	必填	说明
html	string	否	要部署的内联 HTML 内容。
path	string	否	要读取并部署的 .html 文件路径。
slug	string	否	页面的固定 slug（否则根据标题生成）。
tool	string	否	来源工具标签（默认值为 'claude-code'）。
space	string	否	归档页面的群组/空间，例如 'reports'。
title	string	否	面向用户的标题（否则从 <title> 中获取）。
access	enum	否	页面可见性。Agent 部署时默认为 'private'，只有工作区所有者可以查看。仅当用户明确要求可分享链接时才使用 'public'。private \| team \| public \| password
workspace	string	否	工作区（默认使用 WOVO_WORKSPACE）。

详细介绍

wovo

将任意 HTML 部署到可版本管理、可分享的库中，无论它来自 AI 工具还是终端。wovo 是 wovo.dev 的 CLI 和 MCP 服务。

每次部署都会创建一个新版本快照、返回一个可访问的 URL，并将页面存入你的工作区库。重新部署相同的 slug 不会覆盖原有内容，而是追加一个可供回滚的版本。

安装

使用 npx 临时运行：

npx @gowovo/wovo deploy ./report.html

也可以全局安装并使用 wovo 命令：

npm i -g @gowovo/wovo
wovo deploy ./report.html

连接（推荐）

只需一条命令——它会打开浏览器供你登录，然后为你的 AI 工具完成配置。无需复制令牌。

npx @gowovo/wovo setup

之后，只需告诉你的 Agent“将这个部署到 Wovo”，页面就会存入你的库中。

手动身份验证（CI / 无头环境）

无法使用浏览器时（CI、服务器），请从 wovo.dev 的工作区设置中获取部署令牌，并通过环境变量、配置文件或 --token 提供：

export WOVO_TOKEN="wv_…"
export WOVO_WORKSPACE="my-workspace"

CLI

wovo setup               # connect your AI tool: browser sign-in + skill + MCP + test deploy
                         #   --scope project|user        this project, or every project on this machine
                         #   --behavior auto|ask|manual  publish automatically, offer first, or only on request
wovo deploy <file|dir>   # deploy one .html, or every .html under a folder
wovo list                # list pages in the workspace
wovo pages archive <slug>          # hide a page from the library (link still works)
wovo pages unarchive <slug>        # restore an archived page
wovo pages move <slug> --space S   # change a page's space
wovo pages rename <slug> <new>     # change a page's path; old links redirect
wovo domains list                  # custom domains
wovo domains add <d> --page <slug> # link a domain (prints DNS records)
wovo domains status <d>            # re-check DNS / verification
wovo domains remove <d>            # unlink a domain

标志	默认值	作用
`--workspace W`	环境变量 `WOVO_WORKSPACE`，否则从令牌解析	目标工作区
`--space S`	顶层文件夹名称	将页面按空间分组
`--tool T`	`cli`	来源工具标签
`--slug S`	根据路径生成	指定 slug（部署单个文件时）
`--url U`	环境变量 `WOVO_URL`，或 `https://wovo.dev`	Wovo 基础 URL
`--token T`	环境变量 `WOVO_TOKEN`	部署令牌

配置解析顺序： CLI 标志 → ./wovo.json → 环境变量（WOVO_URL、WOVO_TOKEN、WOVO_WORKSPACE）。

// wovo.json
{ "workspace": "my-workspace", "token": "wv_…", "space": "reports" }

示例

WOVO_TOKEN=… wovo deploy ./report.html --workspace acme
wovo deploy ./site --workspace acme --tool claude-code
wovo list --workspace acme

MCP 服务

wovo 还附带一个 MCP 服务（wovo-mcp），让 AI Agent 可以将页面部署为工具并列出页面。使用 Claude Code 注册：

claude mcp add wovo \
  --env WOVO_TOKEN=wv_… \
  --env WOVO_WORKSPACE=my-workspace \
  -- npx -y -p @gowovo/wovo wovo-mcp

工具：wovo_deploy（内联 html 或文件 path）、wovo_list、wovo_pages_archive、wovo_pages_unarchive、wovo_pages_move、wovo_pages_rename、wovo_domains_list、wovo_domains_add、wovo_domains_remove、wovo_domains_status。