@wwkit/opm 1.0.3 → 1.0.4

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wwkit/opm",
-  "version": "1.0.3",
+  "version": "1.0.4",
   "author": "bluesliu <langcai163@163.com>",
   "description": "Unified CLI — package management (npm/pip/dnf/apt) + config view + opencode maintenance",
   "type": "module",
@@ -35,7 +35,7 @@
     "basic-ftp": "^6.2.1",
     "extract-zip": "^2.0.1",
     "systeminformation": "^5.23.0",
-    "@wwkit/shared": "1.0.6"
+    "@wwkit/shared": "1.0.7"
   },
   "publishConfig": {
     "registry": "https://registry.npmjs.org/",

package/src/cli/index.js

@@ -22,6 +22,8 @@ import { PingGroup } from './groups/ping.js'
 import { ProcGroup } from './groups/proc.js'
 import { FtpGroup } from '../tools/ftp/index.js'
 import { GitGroup } from '../tools/git/index.js'
+import { ShareGroup } from '../tools/share/index.js'
+import { WebworkGroup } from '../tools/webwork/index.js'
 import { HarnessGroup } from '../harnesses/base.js'
 import { opencodeHarness } from '../harnesses/opencode/index.js'
 import { CftGroup } from '../binaries/cft/index.js'
@@ -43,6 +45,8 @@ const GROUPS = {
   docker: new DockerGroup(),
   ftp: new FtpGroup(),
   git: new GitGroup(),
+  share: new ShareGroup(),
+  webwork: new WebworkGroup(),
   composer: new PackageGroup('composer'),
   bun: new PackageGroup('bun'),
   winget: new PackageGroup('winget'),

package/src/config.json5

@@ -229,4 +229,22 @@
       OPENCODE_CONFIG_CONTENT: "",
     },
   },
+
+  // share 文本分享服务
+  // server.active 指向预设 key（official/local）或完整 URL
+  // serve 为本地服务参数（opm share serve 使用）
+  // password 为分享默认密码（opm share upload/get/open 使用，-p/--password 可覆盖）
+  share: {
+    password: "0000",
+    server: {
+      official: "http://deepbluenet.com",
+      local: "http://127.0.0.1:8787",
+      active: "local",
+    },
+    serve: {
+      host: "0.0.0.0",
+      port: 8787,
+      dataDir: "~/.config/opm/share/data",
+    },
+  },
 }

package/src/index.js

@@ -23,6 +23,8 @@ export { PingGroup } from './cli/groups/ping.js'
 export { ProcGroup } from './cli/groups/proc.js'
 export { FtpGroup } from './tools/ftp/index.js'
 export { GitGroup } from './tools/git/index.js'
+export { ShareGroup } from './tools/share/index.js'
+export { WebworkGroup } from './tools/webwork/index.js'
 export { ToolManagerGroup } from './cli/groups/version-manager.js'
 export { parseFlags } from './cli/helpers/args.js'
 

package/src/tools/share/.htaccess

@@ -0,0 +1,20 @@
+# opm share server — Apache URL rewrite
+# 将所有 /share/* 请求路由到 server.php
+
+<IfModule mod_rewrite.c>
+  RewriteEngine On
+
+  # 如果请求的是已存在的文件，直接返回
+  RewriteCond %{REQUEST_FILENAME} -f [OR]
+  RewriteCond %{REQUEST_FILENAME} -d
+  RewriteRule ^ - [L]
+
+  # /share/* 路由到 server.php
+  RewriteRule ^share/?$ server.php [L,QSA]
+  RewriteRule ^share/(.+)$ server.php [L,QSA]
+</IfModule>
+
+# 保护 data 目录，禁止直接访问
+<IfModule mod_rewrite.c>
+  RewriteRule ^data/ - [F]
+</IfModule>

package/src/tools/share/client.js

@@ -0,0 +1,172 @@
+/**
+ * share HTTP 客户端 — 上传/取回/列表
+ *
+ * 通过 fetch 调用 share server API。
+ * 服务地址由 config.share.server.active 解析（key → URL，URL 原样返回）。
+ */
+
+/**
+ * 解析 active server URL
+ * @param {object} shareConfig - config.share 段
+ * @returns {string} base URL（无尾斜杠）
+ */
+export function getShareServer(shareConfig) {
+  const server = shareConfig?.server ?? {}
+  const active = server.active
+  if (!active) return server.official || ''
+  return server[active] || active
+}
+
+/**
+ * ping 检测 server 可达性
+ * @param {string} baseUrl
+ * @returns {Promise<{reachable: boolean, status: number, message: string}>}
+ */
+export async function pingServer(baseUrl) {
+  try {
+    const res = await fetch(`${baseUrl}/share/list?n=1`, {
+      signal: AbortSignal.timeout(5000),
+    })
+    if (res.ok) {
+      return { reachable: true, status: res.status, message: 'OK' }
+    }
+    if (res.status === 404) {
+      return { reachable: true, status: res.status, message: 'OK (404 on list endpoint is acceptable)' }
+    }
+    return { reachable: false, status: res.status, message: `HTTP ${res.status}` }
+  } catch (err) {
+    return { reachable: false, status: 0, message: err.message }
+  }
+}
+
+/**
+ * 上传分享内容
+ * @param {string} baseUrl
+ * @param {{title?: string, content: string, password?: string, id?: string, type?: string, filename?: string}} data
+ * @returns {Promise<{id: string, url: string, htmlUrl: string}>}
+ */
+export async function uploadShare(baseUrl, data) {
+  const res = await fetch(`${baseUrl}/share`, {
+    method: 'POST',
+    headers: { 'Content-Type': 'application/json' },
+    body: JSON.stringify(data),
+    signal: AbortSignal.timeout(30000),
+  })
+  if (!res.ok) {
+    const body = await res.text()
+    throw new Error(`Upload failed: HTTP ${res.status} ${body}`)
+  }
+  return res.json()
+}
+
+/**
+ * 取回分享内容
+ * @param {string} baseUrl
+ * @param {string} id
+ * @param {string} [password]
+ * @returns {Promise<{id: string, title: string, content: string, created: string}>}
+ */
+export async function getShare(baseUrl, id, password) {
+  const url = password
+    ? `${baseUrl}/share/${id}/${password}`
+    : `${baseUrl}/share/${id}`
+  const res = await fetch(url, {
+    headers: { 'Accept': 'application/json' },
+    signal: AbortSignal.timeout(10000),
+  })
+  if (!res.ok) {
+    const body = await res.text()
+    throw new Error(`Get failed: HTTP ${res.status} ${body}`)
+  }
+  return res.json()
+}
+
+/**
+ * 取回最近一条分享内容
+ * @param {string} baseUrl
+ * @param {string} [password]
+ * @returns {Promise<{id: string, title: string, content: string, created: string}>}
+ */
+export async function getLatestShare(baseUrl, password) {
+  const url = password
+    ? `${baseUrl}/share/latest/${password}`
+    : `${baseUrl}/share/latest`
+  const res = await fetch(url, {
+    headers: { 'Accept': 'application/json' },
+    signal: AbortSignal.timeout(10000),
+  })
+  if (!res.ok) {
+    const body = await res.text()
+    throw new Error(`Get latest failed: HTTP ${res.status} ${body}`)
+  }
+  return res.json()
+}
+
+/**
+ * 获取 HTML 页面 URL
+ * @param {string} baseUrl
+ * @param {string} id
+ * @param {string} [password]
+ * @returns {string}
+ */
+export function getHtmlUrl(baseUrl, id, password) {
+  return password
+    ? `${baseUrl}/share/html/${id}/${password}`
+    : `${baseUrl}/share/html/${id}`
+}
+
+/**
+ * 列出最近分享
+ * @param {string} baseUrl
+ * @param {number} n
+ * @returns {Promise<{count: number, items: Array<{id: string, title: string, created: string}>}>}
+ */
+export async function listShares(baseUrl, n) {
+  const res = await fetch(`${baseUrl}/share/list?n=${n}`, {
+    signal: AbortSignal.timeout(10000),
+  })
+  if (!res.ok) {
+    const body = await res.text()
+    throw new Error(`List failed: HTTP ${res.status} ${body}`)
+  }
+  return res.json()
+}
+
+/**
+ * 删除指定分享
+ * @param {string} baseUrl
+ * @param {string} id
+ * @returns {Promise<{deleted: boolean, id: string}>}
+ */
+export async function deleteShare(baseUrl, id) {
+  const res = await fetch(`${baseUrl}/share/delete/${id}`, {
+    method: 'POST',
+    signal: AbortSignal.timeout(10000),
+  })
+  if (!res.ok) {
+    const body = await res.text()
+    throw new Error(`Delete failed: HTTP ${res.status} ${body}`)
+  }
+  return res.json()
+}
+
+/**
+ * 清理过期/超额分享
+ * @param {string} baseUrl
+ * @param {{days?: number, keep?: number}} opts
+ * @returns {Promise<{deleted: number, ids: string[]}>}
+ */
+export async function clearShares(baseUrl, opts) {
+  const params = new URLSearchParams()
+  if (opts.days) params.set('days', String(opts.days))
+  if (opts.keep) params.set('keep', String(opts.keep))
+  const res = await fetch(`${baseUrl}/share/clear?${params}`, {
+    method: 'POST',
+    signal: AbortSignal.timeout(30000),
+  })
+  if (!res.ok) {
+    const body = await res.text()
+    throw new Error(`Clear failed: HTTP ${res.status} ${body}`)
+  }
+  return res.json()
+}