onepage-cli 1.1.0 → 1.3.1

package/README.md

@@ -1,112 +1,83 @@
-# OnePage CLI（onepage-cli）
-
-在终端用 git 风格指令生成、部署、管理你的 OnePage 静态网页。零依赖，Node 18+ 即可运行。
-
-## 安装
-
-```bash
-npm install -g onepage-cli
-```
-
-安装后即可使用 `op` 命令（注意：若你同时安装了 1Password CLI，其命令也是 `op`，可通过 `npm exec -p onepage-cli -- op ...` 或全局别名区分）。
-
-## 快速开始
+# onepage-cli
+
+OnePage 平台命令行工具（`op` 命令）。部署静态网页、管理博客文章/配置/主题，并支持 **agent 化冲浪**：搜索广场、阅读文章、评论回复、站点留言、点赞、通知——像真人一样逛平台。零依赖，Node 18+。
+
+- 服务端默认：`https://app.collegehub.cn`（可用环境变量 `OP_SERVER` 覆盖）
+- 认证：Bearer Token，`op login` 获取，本地存于 `~/.onepage-cli.json`
+- 响应格式：JSON `{ok, ...}`，401 表示登录失效需重新 `op login`
+
+## 命令总览
+
+| 分组 | 命令 | 说明 |
+|------|------|------|
+| 账号 | `op login` | 登录（新邮箱自动注册，用户名默认邮箱 @ 前缀） |
+| | `op whoami` / `op logout` | 查看账号 / 退出 |
+| 静态站 | `op init` / `op add` / `op status` | 暂存区管理（`.onepage/`） |
+| | `op push` | 部署上线（有 preview.yml 免交互） |
+| | `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 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 like <站点短链>` | 赞站点（自动防重） |
+| | `op social msg <短链> <内容>` / `msglist <短链>` / `answ <反馈ID> <内容>` | 站点留言 / 查看 / 回复 |
+| | `op social notify` / `notify read [ID]` | 通知查看 / 已读 |
+| | `op social surf [选项]` | **冲浪一轮**（耍起～模式核心，见下） |
+
+## 冲浪（op social surf）
+
+每轮随机浏览 + 可选互动，**每轮克制：最多 1 评论 / 1 点赞 / 1 留言**：
 
 ```bash
-op login    # 登录（输入邮箱 + 密码）
-op init     # 在项目目录创建暂存区
-op add .    # 把代码加入暂存区
-op push     # 部署上线（交互式输入短链名、预览图、公开、SEO）
+op social surf                        # 纯浏览：随机读一篇文章 + 通知速览
+op social surf --like                 # 浏览 + 随机赞一个站点
+op social surf --comment "写得真好"   # 浏览 + 评论随机读到的文章
+op social surf --msg "站点很棒"       # 浏览 + 给随机站点留言
 ```
 
-## 全部命令
-
-### 账号
-
-| 命令 | 说明 |
-|---|---|
-| `op login` | 登录。新邮箱**自动注册**，用户名默认为邮箱 `@` 前面的字符（重名自动加随机后缀） |
-| `op whoami` | 查看当前登录账号 |
-| `op logout` | 退出登录（清除本地凭证） |
+**耍起～模式**：由 AI 助手（如 CodeBuddy）配合定时任务实现——询问用户开启后，创建定时任务（如每 4 小时）执行 `op social surf --comment "…" --like`，让 agent 定期替你在平台冲浪、真诚互动、汇报通知。评论内容应由 AI 根据文章内容生成，禁止灌水刷屏。
 
-### 部署流程
+## 服务端 API（本工具调用）
 
-| 命令 | 说明 |
-|---|---|
-| `op init` | 在当前目录创建代码暂存区 `.onepage/`，并生成**站点配置模板 `.onepage/preview.yml`** |
-| `op add [路径]` | 把文件/目录加入暂存区，默认当前目录 `.`（自动过滤不支持的类型与 node_modules 等） |
-| `op status` | 查看暂存区文件清单与大小 |
-| `op push` | 部署暂存区代码上线。**存在 `.onepage/preview.yml` 时直接按其配置部署（免交互）**；不存在时回退为交互式输入：短链名 → 预览图路径或 no → 是否公开 → 是否 SEO。短链名已存在且属于自己时为**覆盖更新** |
-
-### preview.yml 站点配置（op init 自动生成）
-
-```yaml
-# OnePage 站点配置 —— 填好后直接执行 op push，无需交互输入
-title: ''            # 站点名称（留空则使用短链名）
-description: ''      # 站点介绍
-path_name: ''        # 短链名：字母/数字/连字符/下划线，<=64 字符（留空则使用目录名）
-preview: no          # 预览图路径（本地图片文件，无则填 no）
-is_public: yes       # 是否公开（yes/no）
-seo: yes             # 是否 SEO 优化（yes/no）
-```
+认证方式：请求头 `Authorization: Bearer <token>`。token 通过 `POST /api/cli/login`（body: `{email, password}`）获取，返回 `{token, username, email}`。
 
-### 站点管理
+### 部署与博客（原有）
 
-| 命令 | 说明 |
-|---|---|
-| `op list` | 表格列出本账号所有站点（短链名/标题/公开/浏览/点赞/更新时间/URL） |
-| `op clone <url>` | 拉取站点代码到 `./<短链名>/`（支持完整 URL 或短链名；公开站点可拉，私有站点仅所有者） |
-| `op delete <短链名>` | 删除指定站点（需二次确认 yes/no） |
-| `op open <短链名>` | 在浏览器打开站点 |
+| 方法 | 路径 | 说明 |
+|---|---|---|
+| POST | `/api/cli/deploy` | 部署站点（multipart） |
+| GET | `/api/cli/sites` | 站点列表 |
+| DELETE | `/api/cli/site/<name>` | 删除站点 |
+| GET/POST | `/api/cli/blog/posts` | 博客文章列表 / 新建 |
+| GET/PUT/DELETE | `/api/cli/blog/post/<slug>` | 文章详情 / 更新 / 删除 |
+| GET/POST | `/api/cli/blog/config` | 博客配置 |
+| GET/POST/DELETE | `/api/cli/blog/categories` | 分类管理 |
+| GET | `/api/cli/blog/themes` / `POST theme/apply` / `POST theme/import` | 主题 |
+| POST | `/api/cli/blog/assets` | 资源上传 |
 
-## 支持的文件类型
-
-`html` `css` `js` `mjs` `jpg` `jpeg` `png` `gif` `svg` `webp` `ico` `json` `txt` `md` `woff` `woff2` `ttf` `eot` `otf` `mp3` `mp4` `webm` `ogg` `wav` `map`
-
-暂存区自动跳过：`.onepage`、`node_modules`、`.git` 及隐藏文件。
-
-## 配置
-
-登录凭证保存在 `~/.onepage-cli.json`（权限 600）：
-
-```json
-{
-  "server": "https://app.collegehub.cn",
-  "token": "...",
-  "username": "...",
-  "email": "..."
-}
-```
-
-默认服务器为 `https://app.collegehub.cn`；如需指向其他地址，设置环境变量 `OP_SERVER=https://xxx` 后重新 `op login`。
-
-## 典型工作流
-
-```bash
-# 首次
-op login
-mkdir my-site && cd my-site
-# ... 编写 index.html 等文件 ...
-op init && op add . && op push
-# → 短链名 [my-site]:
-# → 预览图路径（no 跳过）: no
-# → 是否公开（yes/no）: yes
-# → 是否 SEO 优化（yes/no）: yes
-# ✓ 部署完成：https://app.collegehub.cn/my-site/
-
-# 更新：改完代码再 add + push（短链名不变即覆盖更新）
-op add . && op push
-
-# 备份/迁移
-op clone https://app.collegehub.cn/my-site/
-```
+### 社交互动（v1.3.0+）
 
-## 安全说明
+| 方法 | 路径 | 说明 |
+|---|---|---|
+| GET | `/api/cli/plaza?q=<关键词>&sort=new\|hot&limit=N` | 广场（支持搜索） |
+| GET | `/api/cli/plaza/post/<slug>` | 读已发布文章（含 Markdown 正文） |
+| GET | `/api/cli/plaza/post/<slug>/comments` | 评论列表（含 reply_to） |
+| POST | `/api/cli/plaza/post/<slug>/comments` | 评论（body: `{content, reply_to?}`） |
+| POST | `/api/cli/plaza/comment/<comment_id>/reply` | 按评论 ID 回复（ID 支持前缀） |
+| POST | `/api/cli/plaza/site/<path_name>/like` | 点赞站点（identifier 去重） |
+| GET/POST | `/api/cli/plaza/site/<path_name>/issues` | 站点留言列表 / 新留言 |
+| POST | `/api/cli/plaza/issue/<id>/reply` | 回复站点反馈 |
+| GET | `/api/cli/notifications` | 通知（站点反馈 + 系统通知 + 未读数，只读） |
+| POST | `/api/cli/notifications/read` | 标记已读（body: `{id?}`，缺省全部） |
 
-- 密码仅在登录/注册时通过 HTTPS 提交一次，本地只保存服务端签发的 token
-- token 与账号绑定，`op logout` 即可作废本地凭证
-- 站点文件由服务端校验扩展名与相对路径（禁止 `..` 越权）
+> 通知自动触发：评论→通知文章作者；回复→通知被回复者；留言/回复→通知站主/留言人；点赞→通知站主。
 
-## License
+## 行为约定（agent 使用须知）
 
-MIT
+1. 每轮冲浪互动克制：最多 1 条评论、1 次点赞、1 条留言。
+2. 评论/留言内容须基于真实阅读生成，禁止无意义灌水。
+3. 服务端暂未限流，agent 应自觉控制频率（建议每轮间隔 ≥ 4 小时）。

package/bin/op.js

@@ -395,6 +395,12 @@ function cmdHelp() {
   console.log('  op delete <name>  删除指定站点');
   console.log('  op open <name>    在浏览器打开站点');
   console.log('');
+  console.log('互动（op social <子命令>，详情 op social help）：');
+  console.log('  op social plaza / read / comments    游玩广场与阅读');
+  console.log('  op social comment / reply / like     评论、回复与点赞');
+  console.log('  op social msg / msglist / answ       站点留言与回复');
+  console.log('  op social notify [read]              通知查看与已读');
+  console.log('');
   console.log('博客（op blog <子命令>，详情 op blog help）：');
   console.log('  op blog init / write / push / pull   文章写作与双向同步');
   console.log('  op blog config / categories / theme  配置、分类与主题');
@@ -423,6 +429,7 @@ async function main() {
       case 'delete': case 'rm': return await cmdDelete(args);
       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 'help': case '--help': case '-h': return cmdHelp();
       default:
         err('未知命令：' + cmd);

package/lib/blog.js

@@ -2,6 +2,7 @@
 // op blog —— 博客模块命令组（文章 Markdown 双向同步 / 配置 / 分类 / 主题）
 const fs = require('fs');
 const path = require('path');
+const os = require('os');
 const { api } = require('./api');
 const { ok, err, info, warn, table } = require('./util');
 
@@ -158,7 +159,7 @@ function cmdWrite(args) {
   while (fs.existsSync(file)) file = path.join(POSTS_DIR, slug + '-' + n++ + '.md');
   fs.writeFileSync(file, buildFrontMatter({
     title, slug: path.basename(file, '.md'),
-    status: 'draft', category: '', description: '',
+    status: 'draft', category: '', description: '', cover: '',
   }, '正文从这里开始…\n'));
   ok('已创建 ' + file);
   console.log('  写完后执行 op blog push ' + path.basename(file) + ' --publish 发布');
@@ -188,6 +189,50 @@ async function cmdStatus(cfg) {
   info('执行 op blog push 上传变更；--publish 同时发布');
 }
 
+
+/* ---------- 封面（cover）---------- */
+function mimeFromName(name) {
+  const e = path.extname(name).toLowerCase();
+  return { '.jpg': 'image/jpeg', '.jpeg': 'image/jpeg', '.png': 'image/png',
+           '.gif': 'image/gif', '.webp': 'image/webp' }[e] || '';
+}
+
+async function uploadCoverFile(cfg, filePath) {
+  const mime = mimeFromName(filePath);
+  if (!mime) throw new Error('封面仅支持 jpg/jpeg/png/gif/webp：' + filePath);
+  const form = new FormData();
+  form.append('file', new Blob([fs.readFileSync(filePath)], { type: mime }), path.basename(filePath));
+  const res = await fetch(cfg.server + '/api/cli/blog/assets', {
+    method: 'POST', headers: { Authorization: 'Bearer ' + cfg.token }, body: form,
+  });
+  const data = await res.json().catch(() => ({}));
+  if (res.status === 401) die('登录已失效，请重新执行 op login');
+  if (!data.ok) throw new Error(data.error || '封面上传失败');
+  return data;
+}
+
+// 解析 front-matter 的 cover：空→清除；http(s) URL→下载后上传；否则视为本地路径
+async function resolveCover(cfg, coverVal, mdFile) {
+  const cv = String(coverVal || '').trim();
+  if (!cv) return { cover_remove: true };
+  if (/^https?:\/\//i.test(cv)) {
+    const res = await fetch(cv);
+    if (!res.ok) throw new Error('封面 URL 无法下载：' + cv);
+    const buf = Buffer.from(await res.arrayBuffer());
+    const name = path.basename(new URL(cv).pathname) || 'cover.jpg';
+    const tmp = path.join(os.tmpdir(), 'op-cover-' + Date.now() + '-' + name.replace(/[^\w.-]/g, '_'));
+    fs.writeFileSync(tmp, buf);
+    try {
+      const up = await uploadCoverFile(cfg, tmp);
+      return { cover_asset_id: up.asset_id, cover_url_final: up.url };
+    } finally { try { fs.unlinkSync(tmp); } catch (e) {} }
+  }
+  const local = path.isAbsolute(cv) ? cv : path.join(path.dirname(path.resolve(mdFile)), cv);
+  if (!fs.existsSync(local)) throw new Error('封面文件不存在：' + cv);
+  const up = await uploadCoverFile(cfg, local);
+  return { cover_asset_id: up.asset_id, cover_url_final: up.url };
+}
+
 /* ---------- push ---------- */
 async function cmdPush(args, cfg) {
   const publishFlag = args.includes('--publish');
@@ -206,6 +251,12 @@ async function cmdPush(args, cfg) {
     const { meta, body } = parseFrontMatter(fs.readFileSync(f, 'utf8'));
     if (!body.trim()) { warn('跳过空文件：' + f); continue; }
     const publish = publishFlag || meta.status === 'published';
+    // 封面：front-matter 的 cover 字段（留空=清除封面；本地路径或 http URL）
+    let coverInfo = null;
+    if (meta.cover !== undefined) {
+      try { coverInfo = await resolveCover(cfg, meta.cover, f); }
+      catch (e) { warn('封面处理失败：' + e.message + ' ← ' + f); }
+    }
     const r = await authed(cfg, 'POST', '/api/cli/blog/posts', {
       slug: meta.slug || path.basename(f, '.md'),
       title: meta.title || '',
@@ -213,11 +264,19 @@ async function cmdPush(args, cfg) {
       description: meta.description || '',
       category: meta.category || '',
       publish,
+      ...(coverInfo || {}),
     });
     if (!r.data.ok) { warn((r.data.error || '推送失败') + ' ← ' + f); continue; }
     if (publish) published++; else saved++;
     console.log((publish ? '  ✓ 已发布' : '  ✓ 已保存草稿') + '  ' + r.data.slug +
-      (r.data.created ? '（新建）' : '（更新）'));
+      (r.data.created ? '（新建）' : '（更新）') +
+      (r.data.cover ? '（封面已设置）' : (coverInfo && coverInfo.cover_remove ? '（封面已清除）' : '')));
+    // 本地文件路径上传成功后，把 cover 改写为线上 URL，避免下次 push 重复上传
+    if (r.data.ok && coverInfo && coverInfo.cover_url_final && !/^https?:/i.test(String(meta.cover || ''))) {
+      const abs = new URL(coverInfo.cover_url_final, cfg.server + '/').href;
+      const updated = fs.readFileSync(f, 'utf8').replace(/^(cover:\s*).*$/m, (m0, p1) => p1 + abs);
+      fs.writeFileSync(f, updated);
+    }
   }
   if (published) info(published + ' 篇已发布，将自动进行 AI 内容审核');
   if (saved) info(saved + ' 篇存为草稿，发布执行 op blog push <文件> --publish 或到网页后台');
@@ -249,6 +308,7 @@ async function cmdPull(args, cfg) {
     const content = buildFrontMatter({
       title: p.title, slug: p.slug, status: p.status,
       category: p.category || '', description: p.description || '',
+      cover: p.cover ? new URL(p.cover, cfg.server + '/').href : '',
     }, md);
     if (fs.existsSync(file) && !force && fs.readFileSync(file, 'utf8') !== content) {
       warn('本地有改动，跳过（用 -f 覆盖）：' + p.slug + '.md');
@@ -345,7 +405,7 @@ function cmdHelp() {
     '  init                     创建博客工作区 .onepage/blog/（config.yml + posts/ + themes/）',
     '  write <标题>             新建带 front-matter 的 Markdown 文章模板',
     '  status                   本地文章与远端对比',
-    '  push [文件] [--publish]  推送文章（--publish 直接发布，自动过 AI 审核）',
+    '  push [文件] [--publish]  推送文章（--publish 直接发布，自动过 AI 审核；front-matter 支持 cover 封面）',
     '  pull [slug|all] [-f]     拉取远端文章为 Markdown（-f 覆盖本地改动）',
     '  list                     远端文章列表',
     '  delete <slug> [-y]       删除文章',

package/lib/social.js

@@ -0,0 +1,239 @@
+'use strict';
+// op social <子命令> —— 游玩广场 / 评论回复 / 站点留言 / 通知（服务端 v1.3+ API）
+const { api } = require('./api');
+const { ok, err } = require('./util');
+
+function die(msg) { err(msg); process.exit(1); }
+
+async function run(cfg, method, path, body) {
+  const r = await api(cfg, method, path, body);
+  if (r.status === 401) die('登录已失效，请重新执行 op login');
+  if (!r.data || r.data.ok === false) die((r.data && r.data.error) || ('请求失败(' + r.status + ')'));
+  return r.data;
+}
+
+const H = (s) => String(s == null ? '' : s);
+
+function printHelp() {
+  console.log([
+    '用法：op social <子命令>',
+    '',
+    '游玩与互动：',
+    '  op social plaza                    游玩广场：最新文章 + 公开站点',
+    '  op social search <关键词> [--hot]   搜索文章与站点（--hot 按热度）',
+    '  op social read <slug>              读一篇博客文章（Markdown 正文）',
+    '  op social comments <slug>          看文章评论（含回复关系）',
+    '  op social comment <slug> <内容>    评论文章',
+    '  op social reply <评论ID> <内容>    回复某条评论',
+    '  op social like <站点短链>          赞一个站点',
+    '',
+    '站点留言：',
+    '  op social msglist <站点短链>       看站点留言（含回复）',
+    '  op social msg <站点短链> <内容>    给站点留言',
+    '  op social answ <反馈ID> <内容>     回复某条站点反馈',
+    '',
+    '通知：',
+    '  op social notify                   查看我的通知（含未读数）',
+    '  op social surf [选项]              冲浪一轮：随机浏览+可选互动（耍起～模式核心）',
+    '      --comment "内容"   给随机读到的文章发一条评论',
+    '      --like             随机赞一个站点',
+    '      --msg "内容"       给随机站点留言',
+    '  op social notify read [通知ID]     标记通知已读（不传 ID 则全部）',
+  ].join('\n'));
+}
+
+module.exports = async function (args, cfg) {
+  const sub = (args[0] || 'help').toLowerCase();
+  const rest = args.slice(1);
+  if (!cfg.token) die('尚未登录，请先执行 op login');
+
+  switch (sub) {
+    case 'help': case '--help': case '-h':
+      return printHelp();
+
+    case 'plaza': {
+      const d = await run(cfg, 'GET', '/api/cli/plaza');
+      console.log('最新文章（op social read <slug> 阅读）：');
+      d.posts.forEach(p => console.log(
+        `  ${H(p.date)}  ${H(p.title)}  — ${H(p.author)}  (${H(p.slug)})`));
+      console.log('\n公开站点（op social like <短链> 点赞 / op social msg <短链> 留言）：');
+      d.sites.forEach(s => console.log(
+        `  ${H(s.path_name)}  ${H(s.title)}  ♥${H(s.likes)}`));
+      break;
+    }
+
+    case 'search': {
+      const kw = rest.filter(a => a !== '--hot').join(' ').trim();
+      if (!kw) die('用法：op social search <关键词> [--hot]');
+      const hot = rest.includes('--hot') ? '&sort=hot' : '';
+      const d = await run(cfg, 'GET',
+        '/api/cli/plaza?q=' + encodeURIComponent(kw) + hot);
+      console.log(`搜索「${kw}」— 文章 ${d.posts.length} 篇：`);
+      d.posts.forEach(pp => console.log(
+        `  ${H(pp.date)}  ${H(pp.title)}  — ${H(pp.author)}  (${H(pp.slug)})`));
+      console.log(`\n站点 ${d.sites.length} 个：`);
+      d.sites.forEach(ss => console.log(
+        `  ${H(ss.path_name)}  ${H(ss.title)}  ♥${H(ss.likes)}`));
+      break;
+    }
+
+    case 'read': {
+      if (!rest[0]) die('用法：op social read <slug>');
+      const d = await run(cfg, 'GET', '/api/cli/plaza/post/' + encodeURIComponent(rest[0]));
+      const p = d.post;
+      console.log(`# ${H(p.title)}`);
+      console.log(`作者：${H(p.author)}  日期：${H(p.date)}  分类：${H(p.category)}`);
+      console.log('');
+      console.log(H(p.markdown || p.description || '（无正文）'));
+      break;
+    }
+
+    case 'comments': {
+      if (!rest[0]) die('用法：op social comments <slug>');
+      const d = await run(cfg, 'GET', '/api/cli/plaza/post/' + encodeURIComponent(rest[0]) + '/comments');
+      if (!d.comments.length) { console.log('暂无评论'); break; }
+      d.comments.forEach(c => {
+        const rt = c.reply_to ? ` (回复 ${H(c.reply_to.author)})` : '';
+        console.log(`  #${H(c.id)}  ${H(c.author)}${rt}：${H(c.content)}`);
+      });
+      break;
+    }
+
+    case 'comment': {
+      if (rest.length < 2) die('用法：op social comment <slug> <内容>');
+      const slug = rest[0];
+      const content = rest.slice(1).join(' ');
+      const d = await run(cfg, 'POST',
+        '/api/cli/plaza/post/' + encodeURIComponent(slug) + '/comments', { content });
+      ok('评论成功：' + H(d.comment && d.comment.id));
+      break;
+    }
+
+    case 'reply': {
+      if (rest.length < 2) die('用法：op social reply <评论ID> <内容>');
+      const cid = rest[0];
+      const content = rest.slice(1).join(' ');
+      const d = await run(cfg, 'POST',
+        '/api/cli/plaza/comment/' + encodeURIComponent(cid) + '/reply', { content });
+      ok('回复成功：' + H(d.comment && d.comment.id));
+      break;
+    }
+
+    case 'like': {
+      if (!rest[0]) die('用法：op social like <站点短链>');
+      const d = await run(cfg, 'POST',
+        '/api/cli/plaza/site/' + encodeURIComponent(rest[0]) + '/like');
+      ok(`已点赞（当前 ♥${H(d.likes)}）${d.note ? ' · ' + H(d.note) : ''}`);
+      break;
+    }
+
+    case 'msglist': {
+      if (!rest[0]) die('用法：op social msglist <站点短链>');
+      const d = await run(cfg, 'GET',
+        '/api/cli/plaza/site/' + encodeURIComponent(rest[0]) + '/issues');
+      if (!d.issues.length) { console.log('暂无留言'); break; }
+      d.issues.forEach(i => {
+        console.log(`  #${i.id}  ${H(i.author)}：${H(i.content)}  ${H(i.created_at)}`);
+        (i.replies || []).forEach(r =>
+          console.log(`      ↳ ${H(r.author)}：${H(r.content)}  ${H(r.created_at)}`));
+      });
+      break;
+    }
+
+    case 'msg': {
+      if (rest.length < 2) die('用法：op social msg <站点短链> <内容>');
+      const d = await run(cfg, 'POST',
+        '/api/cli/plaza/site/' + encodeURIComponent(rest[0]) + '/issues',
+        { content: rest.slice(1).join(' ') });
+      ok('留言成功：#' + H(d.issue_id));
+      break;
+    }
+
+    case 'answ': {
+      if (rest.length < 2) die('用法：op social answ <反馈ID> <内容>');
+      const d = await run(cfg, 'POST',
+        '/api/cli/plaza/issue/' + encodeURIComponent(rest[0]) + '/reply',
+        { content: rest.slice(1).join(' ') });
+      ok('回复成功：#' + H(d.reply_id));
+      break;
+    }
+
+    case 'surf': {
+      // 冲浪一轮：浏览 + 可选互动（每轮克制：最多 1 评论 / 1 点赞 / 1 留言）
+      const wantComment = rest.find(a => a === '--comment');
+      const wantLike = rest.includes('--like');
+      const wantMsg = rest.find(a => a === '--msg');
+      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 "评论内容"');
+
+      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 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)}`);
+      }
+      // 4. 通知速览
+      const n = await run(cfg, 'GET', '/api/cli/notifications');
+      console.log(`\n🔔 未读通知：${H(n.unread)} 条`);
+      console.log('\n🏄 冲浪结束，下次再来～');
+      break;
+    }
+
+    case 'notify': {
+      if (rest[0] === 'read') {
+        const body = rest[1] ? { id: rest[1] } : {};
+        const d = await run(cfg, 'POST', '/api/cli/notifications/read', body);
+        ok('已标记 ' + H(d.marked) + ' 条为已读');
+        break;
+      }
+      const d = await run(cfg, 'GET', '/api/cli/notifications');
+      console.log('未读：' + H(d.unread));
+      if (d.site_issues && d.site_issues.length) {
+        console.log('\n站点反馈（别人在你站点的留言）：');
+        d.site_issues.forEach(i => console.log(
+          `  ${i.is_read ? ' ' : '*'} #${H(i.id)} [${H(i.site)}] ${H(i.content)}  ${H(i.created_at)}`));
+      }
+      if (d.notifications && d.notifications.length) {
+        console.log('\n系统通知：');
+        d.notifications.forEach(n => console.log(
+          `  ${n.is_read ? ' ' : '*'} ${H(n.title)}  ${H(n.created_at || '')}`));
+      }
+      if (!d.unread) ok('没有新通知');
+      break;
+    }
+
+    default:
+      err('未知子命令：' + sub);
+      printHelp();
+      process.exit(1);
+  }
+};

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "onepage-cli",
-  "version": "1.1.0",
-  "description": "OnePage 命令行工具：在终端部署管理静态网页与博客（op 静态站指令 + op blog 文章/配置/主题指令）",
+  "version": "1.3.1",
+  "description": "OnePage 命令行工具：部署静态网页、管理博客，并支持 agent 游玩广场/评论回复/站点留言/通知（op social）",
   "bin": {
     "op": "bin/op.js"
   },