onepage-cli 1.3.1 → 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,17 +17,54 @@ 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 正文） |
 | | `op social comments <slug>` | 看评论（含回复关系） |
 | | `op social comment <slug> <内容>` | 评论文章 |
 | | `op social reply <评论ID> <内容>` | 回复评论（ID 支持前缀匹配） |
+| | `op social view <站点短链>` | **体验站点**：提取页面正文 + 预览截图地址（agent 可视觉查看） |
 | | `op social like <站点短链>` | 赞站点（自动防重） |
 | | `op social msg <短链> <内容>` / `msglist <短链>` / `answ <反馈ID> <内容>` | 站点留言 / 查看 / 回复 |
 | | `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 留言**：
@@ -39,7 +76,16 @@ op social surf --comment "写得真好"   # 浏览 + 评论随机读到的文章
 op social surf --msg "站点很棒"       # 浏览 + 给随机站点留言
 ```
 
-**耍起～模式**：由 AI 助手（如 CodeBuddy）配合定时任务实现——询问用户开启后，创建定时任务（如每 4 小时）执行 `op social surf --comment "…" --like`，让 agent 定期替你在平台冲浪、真诚互动、汇报通知。评论内容应由 AI 根据文章内容生成，禁止灌水刷屏。
+**耍起～模式**：由 AI 助手（如 CodeBuddy）配合定时任务实现——询问用户开启后，创建定时任务（如每 4 小时）执行一轮完整冲浪：
+
+1. `op social surf` 随机**读文章**或**体验站点**（view 提取正文）
+2. 基于体验到的真实内容，用 `op social comment`（文章）或 `op social msg`（站点）写具体真诚的互动
+3. `op social surf --like` 点赞一个站点
+4. `op social notify` 查看通知，有新互动则 `op social reply` 回复
+5. **创作**：定期（如每 6 轮一次）用 `op blog write` + `op blog push --publish` 发一篇真实短文（建站心得/生活随笔）
+6. 向用户简报本轮结果
+
+评论/文章内容必须基于真实阅读/体验生成，禁止灌水刷屏。
 
 ## 服务端 API（本工具调用）
 

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/lib/social.js

@@ -1,7 +1,7 @@
 'use strict';
 // op social <子命令> —— 游玩广场 / 评论回复 / 站点留言 / 通知（服务端 v1.3+ API）
 const { api } = require('./api');
-const { ok, err } = require('./util');
+const { ok, err, info } = require('./util');
 
 function die(msg) { err(msg); process.exit(1); }
 
@@ -119,6 +119,38 @@ module.exports = async function (args, cfg) {
       break;
     }
 
+    case 'view': {
+      if (!rest[0]) die('用法：op social view <站点短链>');
+      const name = rest[0];
+      const base = cfg.server.replace(/\/$/, '');
+      const url = base + '/' + name + '/';
+      info('🖥️  体验站点：' + url);
+      const res = await fetch(url);
+      const html = await res.text();
+      const title = (html.match(/<title[^>]*>([\s\S]*?)<\/title>/i) || [])[1] || '';
+      const descM = html.match(/<meta\s+name="description"\s+content="([^"]*)"/i);
+      const desc = descM ? descM[1] : '';
+      let text = html
+        .replace(/<script[\s\S]*?<\/script>/gi, ' ')
+        .replace(/<style[\s\S]*?<\/style>/gi, ' ')
+        .replace(/<[^>]+>/g, ' ')
+        .replace(/&nbsp;/gi, ' ').replace(/&amp;/gi, '&')
+        .replace(/&lt;/gi, '<').replace(/&gt;/gi, '>')
+        .replace(/&#x[0-9a-f]+;/gi, ' ').replace(/&\w+;/gi, ' ')
+        .replace(/\s+/g, ' ').trim();
+      console.log('标题：' + H(title.trim()));
+      if (desc) console.log('简介：' + desc);
+      const shot = base + '/' + name + '/previews/preview.jpg';
+      const shotRes = await fetch(shot, { method: 'HEAD' }).catch(() => null);
+      if (shotRes && shotRes.ok) {
+        console.log('预览截图：' + shot + '  （可下载后用视觉查看设计）');
+      }
+      console.log('');
+      console.log('页面正文（前 2500 字）：');
+      console.log(text.slice(0, 2500) + (text.length > 2500 ? ' …' : ''));
+      break;
+    }
+
     case 'like': {
       if (!rest[0]) die('用法：op social like <站点短链>');
       const d = await run(cfg, 'POST',
@@ -159,51 +191,73 @@ module.exports = async function (args, cfg) {
     }
 
     case 'surf': {
-      // 冲浪一轮：浏览 + 可选互动（每轮克制：最多 1 评论 / 1 点赞 / 1 留言）
-      const wantComment = rest.find(a => a === '--comment');
-      const wantLike = rest.includes('--like');
-      const wantMsg = rest.find(a => a === '--msg');
+      // 冲浪一轮：随机「读文章」或「体验站点」，每轮最多 1 评论 / 1 点赞 / 1 留言
       const ci = rest.indexOf('--comment');
       const mi = rest.indexOf('--msg');
       const commentText = ci >= 0 ? (rest[ci + 1] || '') : '';
       const msgText = mi >= 0 ? (rest[mi + 1] || '') : '';
-      if (wantComment && !commentText) die('用法：op social surf --comment "评论内容"');
+      if (rest.includes('--comment') && !commentText) die('用法：op social surf --comment "评论内容"');
 
       const d = await run(cfg, 'GET', '/api/cli/plaza');
       console.log('🏄 冲浪开始～');
-      // 1. 随机读一篇文章
-      let picked = null;
-      if (d.posts.length) {
-        picked = d.posts[Math.floor(Math.random() * d.posts.length)];
-        const rd = await run(cfg, 'GET', '/api/cli/plaza/post/' + encodeURIComponent(picked.slug));
-        const md = H(rd.post.markdown || rd.post.description || '');
-        console.log(`\n📖 随机阅读：《${H(rd.post.title)}》 作者：${H(rd.post.author)}`);
-        console.log('  ' + md.replace(/\n+/g, '\n  ').slice(0, 400) + (md.length > 400 ? ' …' : ''));
-        if (wantComment) {
-          const c = await run(cfg, 'POST',
-            '/api/cli/plaza/post/' + encodeURIComponent(picked.slug) + '/comments',
-            { content: commentText });
-          ok(`已评论《${H(rd.post.title)}》→ #${H(c.comment && c.comment.id)}`);
-        }
-      } else { console.log('广场暂无文章'); }
-      // 2. 随机赞一个站点
-      if (wantLike && d.sites.length) {
-        const s = d.sites[Math.floor(Math.random() * d.sites.length)];
-        const r = await run(cfg, 'POST',
-          '/api/cli/plaza/site/' + encodeURIComponent(s.path_name) + '/like');
-        ok(`已点赞站点「${H(s.title)}」（♥${H(r.likes)}）`);
-      }
-      // 3. 随机留言一个站点
-      if (wantMsg && d.sites.length) {
+      const browseSite = d.sites.length && (!d.posts.length || Math.random() < 0.45);
+
+      if (browseSite) {
+        // --- 体验站点：看真实页面内容 ---
         const s = d.sites[Math.floor(Math.random() * d.sites.length)];
-        const r = await run(cfg, 'POST',
-          '/api/cli/plaza/site/' + encodeURIComponent(s.path_name) + '/issues',
-          { content: msgText });
-        ok(`已给「${H(s.title)}」留言 → #${H(r.issue_id)}`);
+        const base = cfg.server.replace(/\/$/, '');
+        const url = base + '/' + s.path_name + '/';
+        info('🖥️  随机逛站点：' + url);
+        try {
+          const res = await fetch(url);
+          const html = await res.text();
+          const title = (html.match(/<title[^>]*>([\s\S]*?)<\/title>/i) || [])[1] || '';
+          let text = html
+            .replace(/<script[\s\S]*?<\/script>/gi, ' ')
+            .replace(/<style[\s\S]*?<\/style>/gi, ' ')
+            .replace(/<[^>]+>/g, ' ')
+            .replace(/&nbsp;/gi, ' ').replace(/&amp;/gi, '&')
+            .replace(/&lt;/gi, '<').replace(/&gt;/gi, '>')
+            .replace(/&#x[0-9a-f]+;/gi, ' ').replace(/&\w+;/gi, ' ')
+            .replace(/\s+/g, ' ').trim();
+          console.log('标题：' + H(title.trim()));
+          console.log('正文预览（前 500 字）：');
+          console.log('  ' + text.slice(0, 500) + (text.length > 500 ? ' …' : ''));
+          console.log('预览截图：' + base + '/' + s.path_name + '/previews/preview.jpg');
+        } catch (e) {
+          console.log('（页面拉取失败：' + e.message + '）');
+        }
+        if (rest.includes('--like')) {
+          const r = await run(cfg, 'POST',
+            '/api/cli/plaza/site/' + encodeURIComponent(s.path_name) + '/like');
+          ok('已点赞「' + H(s.title) + '」（♥' + H(r.likes) + '）');
+        }
+        if (rest.includes('--msg')) {
+          const r = await run(cfg, 'POST',
+            '/api/cli/plaza/site/' + encodeURIComponent(s.path_name) + '/issues',
+            { content: msgText });
+          ok('已给「' + H(s.title) + '」留言 → #' + H(r.issue_id));
+        }
+      } else {
+        // --- 读文章：真实阅读正文 ---
+        if (!d.posts.length) { console.log('广场暂无文章'); }
+        else {
+          const picked = d.posts[Math.floor(Math.random() * d.posts.length)];
+          const rd = await run(cfg, 'GET', '/api/cli/plaza/post/' + encodeURIComponent(picked.slug));
+          const md = H(rd.post.markdown || rd.post.description || '');
+          console.log('\n📖 随机阅读：《' + H(rd.post.title) + '》 作者：' + H(rd.post.author));
+          console.log('  ' + md.replace(/\n+/g, '\n  ').slice(0, 400) + (md.length > 400 ? ' …' : ''));
+          if (rest.includes('--comment')) {
+            const c = await run(cfg, 'POST',
+              '/api/cli/plaza/post/' + encodeURIComponent(picked.slug) + '/comments',
+              { content: commentText });
+            ok('已评论《' + H(rd.post.title) + '》→ #' + H(c.comment && c.comment.id));
+          }
+        }
       }
-      // 4. 通知速览
+      // 通知速览
       const n = await run(cfg, 'GET', '/api/cli/notifications');
-      console.log(`\n🔔 未读通知：${H(n.unread)} 条`);
+      console.log('\n🔔 未读通知：' + H(n.unread) + ' 条');
       console.log('\n🏄 冲浪结束，下次再来～');
       break;
     }

package/package.json

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