onepage-cli 1.3.2 → 1.4.0

package/README.md

@@ -1,6 +1,6 @@
 # onepage-cli
 
-OnePage 平台命令行工具（`op` 命令）。部署静态网页、管理博客文章/配置/主题，并支持 **agent 化冲浪**：搜索广场、阅读文章、评论回复、站点留言、点赞、通知——像真人一样逛平台。零依赖，Node 18+。
+OnePage 平台命令行工具（`op` 命令）。部署静态网页、管理博客文章/配置/主题、操作**站点数据服务**（KV / Blob 文件 / AI 网关），并支持 **agent 化冲浪**：搜索广场、阅读文章、评论回复、站点留言、点赞、通知——像真人一样逛平台。零依赖，Node 18+。
 
 - 服务端默认：`https://app.collegehub.cn`（可用环境变量 `OP_SERVER` 覆盖）
 - 认证：Bearer Token，`op login` 获取，本地存于 `~/.onepage-cli.json`
@@ -17,6 +17,10 @@ OnePage 平台命令行工具（`op` 命令）。部署静态网页、管理博
 | | `op list` / `op clone <url>` / `op delete <name>` / `op open <name>` | 站点管理 |
 | 博客 | `op blog init/write/push/pull/list/status/delete` | 文章写作与双向同步 |
 | | `op blog config/categories/themes/theme` | 博客配置、分类、主题 |
+| **站点服务** | `op kv list/get/set/del/incr` | 站点 KV 键值（数字/JSON 自动识别） |
+| | `op blob list/put/get/del` | 站点文件存储（单文件 ≤10MB） |
+| | `op ai "提示词" [--stream]` | 站点 AI 网关对话（SSE 流式） |
+| | `op service` | 查看写保护 / AI 开关 / 限额 / 用量 / 当前身份 |
 | **社交** | `op social search <关键词> [--hot]` | 搜索文章与站点 |
 | | `op social plaza` | 游玩广场（最新文章 + 公开站点） |
 | | `op social read <slug>` | 读文章（Markdown 正文） |
@@ -29,6 +33,38 @@ OnePage 平台命令行工具（`op` 命令）。部署静态网页、管理博
 | | `op social notify` / `notify read [ID]` | 通知查看 / 已读 |
 | | `op social surf [选项]` | **冲浪一轮**（耍起～模式核心，见下） |
 
+## 站点数据服务（v1.4.0+）
+
+平台为每个已部署站点提供 KV、Blob、AI 网关，接口前缀 `/api/site/<站点名>/`。用 `--site <短链名>` 指定站点；也可用环境变量 `OP_SITE`，或在含 `.onepage/preview.yml` 的站点目录中直接执行（自动读取 `path_name`）。
+
+CLI 的 Bearer token 已被服务端识别为登录身份：站点开启「KV 写保护」或「AI 需登录」后，`op kv set` / `op ai` 依然可用。
+
+```bash
+op service --site fatfish                        # 看配置与今日用量
+op kv set score 10 --site fatfish               # 存数字
+op kv set room '{"players":[]}' --site fatfish  # 存对象（读回自动还原类型）
+op kv incr score 5 --site fatfish
+op kv list --site fatfish
+op blob put ./logo.png img/logo.png --site fatfish
+op blob get img/logo.png --site fatfish
+op ai "用一句话介绍这个站点" --stream --site fatfish
+```
+
+> 开关与服务端密钥在网页「编辑网站 → 站点服务」配置，AI 网关需先启用。`op ai --model` 仅站点自配密钥时生效（用平台默认密钥时强制平台模型）。
+
+### 对应服务端接口
+
+| 方法 | 路径 | 说明 |
+|---|---|---|
+| GET | `/api/site/<name>/config` | 公开查询开关/限额/用量（不含密钥） |
+| GET | `/api/site/<name>/me` | 当前身份、uid、can_write |
+| GET/PUT/DELETE | `/api/site/<name>/kv/<key>` | KV 读 / 写 / 删 |
+| GET | `/api/site/<name>/kv?prefix=` | KV 列表（值自动还原为写入时类型） |
+| POST | `/api/site/<name>/kv/<key>/incr` | KV 自增 |
+| GET/PUT/DELETE | `/api/site/<name>/blob/<path>` | Blob 读 / 写 / 删 |
+| GET | `/api/site/<name>/blob?prefix=` | Blob 列表 |
+| POST | `/api/site/<name>/ai/chat/completions` | OpenAI 兼容对话，支持 SSE 流式 |
+
 ## 冲浪（op social surf）
 
 每轮随机浏览 + 可选互动，**每轮克制：最多 1 评论 / 1 点赞 / 1 留言**：

package/bin/op.js

@@ -405,6 +405,13 @@ function cmdHelp() {
   console.log('  op blog init / write / push / pull   文章写作与双向同步');
   console.log('  op blog config / categories / theme  配置、分类与主题');
   console.log('');
+  console.log('站点服务（op kv / blob / ai / service，详情 op service help）：');
+  console.log('  op kv list / get / set / del / incr   站点 KV 数据');
+  console.log('  op blob list / put / get / del       站点文件（Blob）');
+  console.log('  op ai "提示词" [--stream]            站点 AI 网关对话');
+  console.log('  op service                          查看服务能力配置与用量');
+  console.log('  以上命令用 --site <短链名> 指定站点（或 OP_SITE / preview.yml）');
+  console.log('');
   console.log('示例：');
   console.log('  op login && op init && op add . && op push');
   console.log('  op clone https://app1.cloudstudio.site/demo/');
@@ -430,6 +437,8 @@ async function main() {
       case 'open': return await cmdOpen(args);
       case 'blog': return await require('../lib/blog')(args, conf.load());
       case 'social': return await require('../lib/social')(args, conf.load());
+      case 'kv': case 'blob': case 'ai': case 'service': case 'svc':
+        return await require('../lib/service')(cmd, args, conf.load());
       case 'help': case '--help': case '-h': return cmdHelp();
       default:
         err('未知命令：' + cmd);

package/lib/service.js

@@ -0,0 +1,341 @@
+'use strict';
+// op kv / blob / ai / service —— 站点级数据服务（KV / 文件存储 / AI 网关 / 能力配置）
+// 对应服务端 /api/site/<站点名>/* 接口；Bearer token 同时被服务端识别为登录身份。
+const fs = require('fs');
+const path = require('path');
+const { ok, err, info, warn, table } = require('./util');
+
+const DEFAULT_SERVER = 'https://app.collegehub.cn';
+function die(msg) { err(msg); process.exit(1); }
+
+const H = (s) => String(s == null ? '' : s);
+
+function printHelp() {
+  console.log([
+    '用法：op <命令> <子命令> [参数] [--site <站点短链名>]',
+    '',
+    '站点名可来自 --site / 环境变量 OP_SITE / 当前目录 .onepage/preview.yml 的 path_name。',
+    '',
+    'KV 键值（op kv）：',
+    '  op kv list [前缀]                 列出键（值按写入时的类型自动还原）',
+    '  op kv get <键>                   读取一个键',
+    '  op kv set <键> <值>              写入（数字/布尔/JSON 对象自动识别为对应类型）',
+    '  op kv del <键>                   删除',
+    '  op kv incr <键> [增量]           自增（默认 +1）',
+    '',
+    '文件存储（op blob，单文件 ≤10MB）：',
+    '  op blob list [前缀]              列出文件',
+    '  op blob put <本地文件> [远端路径]  上传（远端路径缺省取文件名）',
+    '  op blob get <远端路径> [本地文件]  下载（本地路径缺省取文件名）',
+    '  op blob del <远端路径>           删除',
+    '',
+    'AI 网关（op ai，需在站点设置中启用）：',
+    '  op ai "提示词" [--stream] [--system "系统提示"] [--model 模型名]',
+    '      --stream 逐字流式输出；--model 仅站点自配密钥时生效',
+    '',
+    '能力配置（op service，别名 op svc）：',
+    '  op service                       查看本站 KV 写保护 / AI 网关 / 限额 / 用量 / 身份',
+    '  op service help                  显示本帮助',
+    '',
+    '示例：',
+    '  op service --site fatfish',
+    '  op kv set counter 10 --site fatfish && op kv incr counter 5 --site fatfish',
+    '  op blob put ./logo.png img/logo.png --site fatfish',
+    '  op ai "用一句话介绍这个站点" --stream --site fatfish',
+  ].join('\n'));
+}
+
+/* ---------- 参数解析 ---------- */
+function splitFlags(args) {
+  const flags = {};
+  const rest = [];
+  for (let i = 0; i < args.length; i++) {
+    const a = args[i];
+    if (a === '--site' || a === '-s') { flags.site = args[++i]; continue; }
+    if (a === '--stream') { flags.stream = true; continue; }
+    if (a === '--system') { flags.system = args[++i]; continue; }
+    if (a === '--model') { flags.model = args[++i]; continue; }
+    rest.push(a);
+  }
+  return { flags, rest };
+}
+
+function resolveSite(flags) {
+  if (flags.site) return flags.site;
+  if (process.env.OP_SITE) return process.env.OP_SITE;
+  try {
+    const p = path.join(process.cwd(), '.onepage', 'preview.yml');
+    if (fs.existsSync(p)) {
+      const m = fs.readFileSync(p, 'utf8').match(/^\s*path_name\s*:\s*['"]?([^'"#\s]+)/m);
+      if (m) return m[1];
+    }
+  } catch (e) { /* 忽略 */ }
+  return null;
+}
+
+// 保留路径层级、逐段编码（避免 key 中的 / 被误当路由分隔符）
+const encPath = (p) => String(p).split('/').map(encodeURIComponent).join('/');
+const enc = (s) => encodeURIComponent(String(s));
+
+/* ---------- HTTP ---------- */
+function base(cfg) { return (cfg.server || DEFAULT_SERVER).replace(/\/$/, ''); }
+function auth(cfg) { return cfg.token ? { Authorization: 'Bearer ' + cfg.token } : {}; }
+
+async function jsonReq(cfg, method, pathname, body) {
+  const headers = Object.assign({}, auth(cfg));
+  let payload;
+  if (body !== undefined) {
+    headers['Content-Type'] = 'application/json';
+    payload = JSON.stringify(body);
+  }
+  let res;
+  try {
+    res = await fetch(base(cfg) + pathname, { method, headers, body: payload });
+  } catch (e) {
+    die('无法连接服务器 ' + base(cfg) + '（' + e.message + '）');
+  }
+  let data = {};
+  try { data = await res.json(); } catch (e) { /* 非 JSON 响应 */ }
+  return { status: res.status, data: data, res: res };
+}
+
+function ensure(r, label) {
+  if (r.status >= 400 || (r.data && r.data.ok === false)) {
+    die((r.data && r.data.error) || (label + '失败（HTTP ' + r.status + '）'));
+  }
+  return r.data || {};
+}
+
+async function putBytes(cfg, pathname, buf) {
+  const headers = Object.assign({}, auth(cfg), { 'Content-Type': 'application/octet-stream' });
+  let res;
+  try {
+    res = await fetch(base(cfg) + pathname, { method: 'PUT', headers, body: buf });
+  } catch (e) {
+    die('无法连接服务器 ' + base(cfg) + '（' + e.message + '）');
+  }
+  let data = {};
+  try { data = await res.json(); } catch (e) { /* 忽略 */ }
+  return { status: res.status, data: data };
+}
+
+async function getBytes(cfg, pathname) {
+  const res = await fetch(base(cfg) + pathname, { method: 'GET', headers: auth(cfg) });
+  if (!res.ok) {
+    let msg = '';
+    try { msg = (await res.json()).error || ''; } catch (e) { /* 忽略 */ }
+    die(msg || ('下载失败（HTTP ' + res.status + '）'));
+  }
+  return Buffer.from(await res.arrayBuffer());
+}
+
+async function aiStream(cfg, pathname, body) {
+  const headers = Object.assign({}, auth(cfg), { 'Content-Type': 'application/json' });
+  let res;
+  try {
+    res = await fetch(base(cfg) + pathname,
+      { method: 'POST', headers, body: JSON.stringify(body) });
+  } catch (e) {
+    die('无法连接服务器 ' + base(cfg) + '（' + e.message + '）');
+  }
+  if (!res.ok) {
+    let msg = '';
+    try { msg = (await res.json()).error || ''; } catch (e) { /* 忽略 */ }
+    die(msg || ('AI 请求失败（HTTP ' + res.status + '）'));
+  }
+  const reader = res.body.getReader();
+  const dec = new TextDecoder();
+  let buf = '';
+  while (true) {
+    const { done, value } = await reader.read();
+    if (done) break;
+    buf += dec.decode(value, { stream: true });
+    const lines = buf.split('\n');
+    buf = lines.pop();
+    for (const line of lines) {
+      const s = line.trim();
+      if (!s.startsWith('data:')) continue;
+      const payload = s.slice(5).trim();
+      if (payload === '[DONE]') { process.stdout.write('\n'); return; }
+      try {
+        const j = JSON.parse(payload);
+        const c = j.choices && j.choices[0] && (j.choices[0].delta || {}).content;
+        if (c) process.stdout.write(c);
+      } catch (e) { /* 忽略非 JSON 心跳 */ }
+    }
+  }
+  process.stdout.write('\n');
+}
+
+/* ---------- 值处理 ---------- */
+function parseValue(s) {
+  const t = String(s).trim();
+  if (/^[{[]/.test(t) || /^-?\d+(\.\d+)?$/.test(t) ||
+      t === 'true' || t === 'false' || t === 'null') {
+    try { return JSON.parse(t); } catch (e) { /* 退回字符串 */ }
+  }
+  return s;
+}
+
+function brief(v) {
+  if (v == null) return '';
+  const s = typeof v === 'object' ? JSON.stringify(v) : String(v);
+  return s.length > 64 ? s.slice(0, 61) + '...' : s;
+}
+
+function showValue(v) {
+  if (v !== null && typeof v === 'object') console.log(JSON.stringify(v, null, 2));
+  else console.log(String(v));
+}
+
+/* ---------- 命令实现 ---------- */
+async function cmdKv(cfg, site, rest) {
+  const sub = (rest[0] || '').toLowerCase();
+  const a = rest.slice(1);
+  const ROOT = '/api/site/' + enc(site) + '/kv';
+  switch (sub) {
+    case 'list': case 'ls': {
+      const q = a[0] ? '?prefix=' + enc(a[0]) : '';
+      const d = ensure(await jsonReq(cfg, 'GET', ROOT + q), '列出 KV');
+      if (!d.count) { info('暂无数据'); return; }
+      table(['键', '值'], (d.items || []).map(it => [H(it.k), brief(it.v)]));
+      console.log('共 ' + d.count + ' 个键');
+      return;
+    }
+    case 'get': {
+      if (!a[0]) die('用法：op kv get <键>');
+      const d = ensure(await jsonReq(cfg, 'GET', ROOT + '/' + encPath(a[0])), '读取 KV');
+      showValue(d.v);
+      return;
+    }
+    case 'set': {
+      if (a.length < 2) die('用法：op kv set <键> <值>');
+      const v = parseValue(a.slice(1).join(' '));
+      const d = ensure(await jsonReq(cfg, 'PUT', ROOT + '/' + encPath(a[0]), { v }), '写入 KV');
+      ok('已写入 ' + H(d.k));
+      return;
+    }
+    case 'del': case 'rm': case 'delete': {
+      if (!a[0]) die('用法：op kv del <键>');
+      const d = ensure(await jsonReq(cfg, 'DELETE', ROOT + '/' + encPath(a[0])), '删除 KV');
+      ok(d.deleted ? '已删除 ' + H(d.k) : '键不存在：' + H(d.k));
+      return;
+    }
+    case 'incr': {
+      if (!a[0]) die('用法：op kv incr <键> [增量]');
+      const n = a[1] === undefined ? 1 : Number(a[1]);
+      if (Number.isNaN(n)) die('增量必须是数字');
+      const d = ensure(await jsonReq(cfg, 'POST', ROOT + '/' + encPath(a[0]) + '/incr', { amount: n }), '自增 KV');
+      ok(H(d.k) + ' = ' + H(d.v));
+      return;
+    }
+    default:
+      printHelp();
+      if (sub) die('未知子命令：op kv ' + sub);
+  }
+}
+
+async function cmdBlob(cfg, site, rest) {
+  const sub = (rest[0] || '').toLowerCase();
+  const a = rest.slice(1);
+  const ROOT = '/api/site/' + enc(site) + '/blob';
+  switch (sub) {
+    case 'list': case 'ls': {
+      const q = a[0] ? '?prefix=' + enc(a[0]) : '';
+      const d = ensure(await jsonReq(cfg, 'GET', ROOT + q), '列出 Blob');
+      if (!d.count) { info('暂无文件'); return; }
+      table(['路径', '大小', '更新时间'],
+        (d.items || []).map(it => [H(it.k), H(it.size) + ' B', H(it.updated_at)]));
+      console.log('共 ' + d.count + ' 个文件');
+      return;
+    }
+    case 'put': case 'upload': {
+      if (!a[0]) die('用法：op blob put <本地文件> [远端路径]');
+      const local = a[0];
+      if (!fs.existsSync(local)) die('本地文件不存在：' + local);
+      const remote = a[1] || path.basename(local);
+      const buf = fs.readFileSync(local);
+      const d = ensure(await putBytes(cfg, ROOT + '/' + encPath(remote), buf), '上传 Blob');
+      ok('已上传 ' + H(d.k) + '（' + H(d.size) + ' B）');
+      info('访问地址：' + base(cfg) + H(d.url));
+      return;
+    }
+    case 'get': case 'download': {
+      if (!a[0]) die('用法：op blob get <远端路径> [本地文件]');
+      const dest = a[1] || path.basename(a[0]);
+      const buf = await getBytes(cfg, ROOT + '/' + encPath(a[0]));
+      fs.mkdirSync(path.dirname(path.resolve(dest)), { recursive: true });
+      fs.writeFileSync(dest, buf);
+      ok('已下载到 ' + dest + '（' + buf.length + ' B）');
+      return;
+    }
+    case 'del': case 'rm': case 'delete': {
+      if (!a[0]) die('用法：op blob del <远端路径>');
+      ensure(await jsonReq(cfg, 'DELETE', ROOT + '/' + encPath(a[0])), '删除 Blob');
+      ok('已删除 ' + a[0]);
+      return;
+    }
+    default:
+      printHelp();
+      if (sub) die('未知子命令：op blob ' + sub);
+  }
+}
+
+async function cmdAi(cfg, site, rest, flags) {
+  const prompt = rest.join(' ').trim();
+  if (!prompt) die('用法：op ai "提示词" [--stream] [--system "系统提示"]');
+  const messages = [];
+  if (flags.system) messages.push({ role: 'system', content: flags.system });
+  messages.push({ role: 'user', content: prompt });
+  const body = { messages, stream: !!flags.stream };
+  if (flags.model) body.model = flags.model;
+  const URL = '/api/site/' + enc(site) + '/ai/chat/completions';
+  if (flags.stream) return await aiStream(cfg, URL, body);
+  const r = await jsonReq(cfg, 'POST', URL, body);
+  if (r.status >= 400 || (r.data && r.data.ok === false)) {
+    die((r.data && r.data.error) || ('AI 请求失败（HTTP ' + r.status + '）'));
+  }
+  const choice = r.data && r.data.choices && r.data.choices[0];
+  const text = choice && ((choice.message && choice.message.content) || choice.text);
+  console.log(text != null ? String(text) : JSON.stringify(r.data, null, 2));
+}
+
+async function cmdService(cfg, site) {
+  const d = ensure(await jsonReq(cfg, 'GET', '/api/site/' + enc(site) + '/config'), '查询配置');
+  const me = ensure(await jsonReq(cfg, 'GET', '/api/site/' + enc(site) + '/me'), '查询身份');
+  const yn = (b) => b ? '开启' : '关闭';
+  table(['项目', '值'], [
+    ['站点', site],
+    ['KV 写保护（写操作需登录）', yn(d.kv_require_login)],
+    ['AI 网关', yn(d.ai_enabled)],
+    ['AI 需登录', yn(d.ai_require_login)],
+    ['AI 每日限额', H(d.ai_daily_limit)],
+    ['AI 今日已用', H(d.ai_used_today)],
+    ['Blob 单文件上限', H(d.blob_max_bytes) + ' B'],
+    ['Blob 允许扩展名', (d.blob_allow_ext || []).join(' ')],
+    ['当前身份', me.logged ? (H(me.name) + ' (uid ' + H(me.uid) + ')') : '未登录'],
+    ['可写', me.can_write ? '是' : '否'],
+  ]);
+  info('开关与密钥在网页「编辑网站 → 站点服务」中配置。');
+}
+
+/* ---------- 入口 ---------- */
+module.exports = async function (cmd, args, cfg) {
+  const { flags, rest } = splitFlags(args);
+  if ((cmd === 'service' || cmd === 'svc') && (rest[0] || '').toLowerCase() === 'help') {
+    return printHelp();
+  }
+  if (rest.includes('--help') || rest.includes('-h')) return printHelp();
+  if (!cfg.token) die('尚未登录，请先执行 op login');
+  const site = resolveSite(flags);
+  if (!site) die('未指定站点：请加 --site <短链名>，或设置 OP_SITE，或在含 .onepage/preview.yml 的站点目录中执行');
+  if (!/^[A-Za-z0-9_\-]{1,64}$/.test(site)) die('站点短链名不合法：' + site);
+
+  switch (cmd) {
+    case 'kv': return await cmdKv(cfg, site, rest);
+    case 'blob': return await cmdBlob(cfg, site, rest);
+    case 'ai': return await cmdAi(cfg, site, rest, flags);
+    case 'service': case 'svc': return await cmdService(cfg, site);
+    default: return printHelp();
+  }
+};

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "onepage-cli",
-  "version": "1.3.2",
-  "description": "OnePage 命令行工具：部署静态网页、管理博客，并支持 agent 游玩广场/评论回复/站点留言/通知（op social）",
+  "version": "1.4.0",
+  "description": "OnePage 命令行工具：部署静态网页、管理博客、站点数据服务（KV / Blob / AI 网关），并支持 agent 游玩广场/评论回复/站点留言/通知（op social）",
   "bin": {
     "op": "bin/op.js"
   },