@fragments_awe/ops-mcp 0.0.0-stage → 0.15.0

package/README.md

@@ -1,3 +1,67 @@
-# Temporary Holding Version
+# Ops MCP
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+需要 Node.js 18+。支持 macOS Apple/Intel、Windows x64、Linux x64。
+
+```sh
+npm install -g @fragments_awe/ops-mcp
+ops-mcp login us_east
+```
+
+国内登录用 `ops-mcp login cn`，新加坡用 `ops-mcp login singapore`。在浏览器完成飞书授权。
+
+AI 客户端的 MCP 配置：
+
+```json
+{
+  "mcpServers": {
+    "wgops": {
+      "command": "ops-mcp",
+      "args": []
+    }
+  }
+}
+```
+
+Claude Code 可执行 `claude mcp add --transport stdio --scope user wgops -- ops-mcp`。
+如果图形客户端找不到命令，使用 `which ops-mcp`（Windows 用 `where ops-mcp`）输出的完整路径。
+
+对 AI 说“先绑定美东路演，再列出测试集合”。区域分别是 `cn_dev`、`singapore_dev`、`us_east_exhibition`。
+
+MCP 启动后后台查询 npm latest，检查结果缓存 24 小时，长驻进程每 24 小时再次检查。
+发现新版会在绑定区域后的一次成功工具调用中附带更新提醒，由 AI 转述；不保证客户端弹出通知。
+
+```sh
+npm install -g @fragments_awe/ops-mcp@latest
+```
+
+更新后重启客户端里的 MCP。登录凭据仍保存在 `~/.wgops-mcp/session.json`，不包含在 npm 包中。
+
+维护者从仓库 backend 目录构建，再进入 npm/ops-mcp 发布：
+
+```sh
+GOTOOLCHAIN=auto go run ./cmd/package-ops-mcp --npm-output ../npm/ops-mcp
+cd ../npm/ops-mcp
+npm test
+npm pack
+npm publish --access public
+```
+
+发布前同步修改 `backend/internal/opsmcp/version.go` 与 `package.json` 的版本，构建及 prepack 都会验证版本一致。
+
+## 直接调用 ModelHub
+
+更新到 0.15.0 后增加一个 `modelhub` 工具，独立于 Ops 登录和区域绑定。
+先让 Agent 用 configure 保存 ModelHub 公网地址和用户提供的 Key，再用 models 查 text/image/video 模型。
+generate 只需 model、prompt，可选 images（本机绝对路径或 URL）、图片尺寸或视频时长；不需要填写 protobuf。
+result 用同一 task_id 取结果，支持 wait_seconds=0–60，完成提前返回。
+
+Key 位于 `~/.wgops-mcp/modelhub.json`，仅当前用户可读写；生成文件在 `~/.wgops-mcp/modelhub/jobs/`。
+等待时保持 MCP 连接，失败不自动重提。语音暂不接入。
+
+## 自动发版
+
+相关代码合入 dev 后，`Publish Ops MCP to npm` 自动运行：检查两处版本一致且高于 npm latest，
+跑测试、编译四平台、验证 npm 包，再使用仓库 Actions Secret NPM_TOKEN 发布并回查 latest 与 gitHead。
+同一源码提交重跑会跳过已发布版本，其他提交复用已发布版本会失败，要求先提升版本。
+Token 仅在发布步骤注入 NODE_AUTH_TOKEN，不进入安装包；到期后更新仓库 Secret。
+Secret 只需包级发布权限，无需组织管理权限。

package/index.cjs

@@ -0,0 +1,29 @@
+#!/usr/bin/env node
+const { spawn } = require('node:child_process')
+const { existsSync } = require('node:fs')
+const { join } = require('node:path')
+
+const platform = `${process.platform}-${process.arch}`
+const binary = join(__dirname, 'bin', platform, process.platform === 'win32' ? 'ops-mcp.exe' : 'ops-mcp')
+if (!existsSync(binary)) {
+  console.error(`Ops MCP 暂不支持 ${platform}。支持 macOS arm64/x64、Windows x64 和 Linux x64。`)
+  process.exit(1)
+}
+
+// stdin/stdout 原样交给 Go MCP；启动器日志只能写 stderr，避免破坏 JSON-RPC。
+const child = spawn(binary, process.argv.slice(2), { stdio: 'inherit' })
+for (const signal of ['SIGINT', 'SIGTERM']) {
+  process.on(signal, () => child.kill(signal))
+}
+child.on('error', error => {
+  console.error(`Ops MCP 启动失败：${error.message}`)
+  process.exitCode = 1
+})
+child.on('exit', (code, signal) => {
+  if (signal) {
+    process.removeAllListeners(signal)
+    process.kill(process.pid, signal)
+  } else {
+    process.exitCode = code ?? 1
+  }
+})

package/package.json

@@ -1,6 +1,26 @@
 {
   "name": "@fragments_awe/ops-mcp",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.15.0",
+  "description": "WG Ops MCP tools for local AI clients",
+  "license": "UNLICENSED",
+  "bin": {
+    "ops-mcp": "index.cjs"
+  },
+  "files": [
+    "index.cjs",
+    "bin/",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "scripts": {
+    "test": "node --test launcher.test.cjs",
+    "prepack": "node verify-package.cjs"
+  },
+  "gitHead": "abdb6870b946b6b1f47f48d4e9b3cf2b6fd0f196"
+}