onepage-cli 0.0.0-stage → 1.0.0

package/README.md

@@ -1,3 +1,98 @@
-# Temporary Holding Version
+# OnePage CLI（onepage-cli）
 
-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.
+在终端用 git 风格指令生成、部署、管理你的 OnePage 静态网页。零依赖，Node 18+ 即可运行。
+
+## 安装
+
+```bash
+npm install -g onepage-cli
+```
+
+安装后即可使用 `op` 命令（注意：若你同时安装了 1Password CLI，其命令也是 `op`，可通过 `npm exec -p onepage-cli -- op ...` 或全局别名区分）。
+
+## 快速开始
+
+```bash
+op login    # 登录（输入邮箱 + 密码）
+op init     # 在项目目录创建暂存区
+op add .    # 把代码加入暂存区
+op push     # 部署上线（交互式输入短链名、预览图、公开、SEO）
+```
+
+## 全部命令
+
+### 账号
+
+| 命令 | 说明 |
+|---|---|
+| `op login` | 登录。新邮箱**自动注册**，用户名默认为邮箱 `@` 前面的字符（重名自动加随机后缀） |
+| `op whoami` | 查看当前登录账号 |
+| `op logout` | 退出登录（清除本地凭证） |
+
+### 部署流程
+
+| 命令 | 说明 |
+|---|---|
+| `op init` | 在当前目录创建代码暂存区 `.onepage/` |
+| `op add [路径]` | 把文件/目录加入暂存区，默认当前目录 `.`（自动过滤不支持的类型与 node_modules 等） |
+| `op status` | 查看暂存区文件清单与大小 |
+| `op push` | 部署暂存区代码上线，依次交互确认：**短链名** → **预览图路径或 no** → **是否公开 yes/no** → **是否 SEO 优化 yes/no**。短链名已存在且属于自己时为**覆盖更新** |
+
+### 站点管理
+
+| 命令 | 说明 |
+|---|---|
+| `op list` | 表格列出本账号所有站点（短链名/标题/公开/浏览/点赞/更新时间/URL） |
+| `op clone <url>` | 拉取站点代码到 `./<短链名>/`（支持完整 URL 或短链名；公开站点可拉，私有站点仅所有者） |
+| `op delete <短链名>` | 删除指定站点（需二次确认 yes/no） |
+| `op open <短链名>` | 在浏览器打开站点 |
+
+## 支持的文件类型
+
+`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://app1.cloudstudio.site",
+  "token": "...",
+  "username": "...",
+  "email": "..."
+}
+```
+
+## 典型工作流
+
+```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://app1.cloudstudio.site/my-site/
+
+# 更新：改完代码再 add + push（短链名不变即覆盖更新）
+op add . && op push
+
+# 备份/迁移
+op clone https://app1.cloudstudio.site/my-site/
+```
+
+## 安全说明
+
+- 密码仅在登录/注册时通过 HTTPS 提交一次，本地只保存服务端签发的 token
+- token 与账号绑定，`op logout` 即可作废本地凭证
+- 站点文件由服务端校验扩展名与相对路径（禁止 `..` 越权）
+
+## License
+
+MIT

package/bin/op.js

@@ -0,0 +1,377 @@
+#!/usr/bin/env node
+'use strict';
+// OnePage CLI —— git 风格的静态网页部署命令行工具
+// 文档：https://app1.cloudstudio.site
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
+const { exec } = require('child_process');
+const conf = require('../lib/config');
+const { api } = require('../lib/api');
+const { ask, askHidden, parseBool } = require('../lib/prompt');
+const { ok, err, info, warn, table, pad } = require('../lib/util');
+
+const STAGE_DIR = '.onepage';
+const STAGE_FILES = path.join(STAGE_DIR, 'stage');
+const STAGE_MANIFEST = path.join(STAGE_DIR, 'manifest.json');
+
+// 允许部署的文件扩展名（与服务端保持一致）
+const ALLOWED_EXTS = new Set([
+  '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',
+]);
+const SKIP_DIRS = new Set([STAGE_DIR, 'node_modules', '.git', '.svn']);
+
+const IS_PUBLIC = (process.stdout.isTTY !== false) && process.platform !== 'win32'
+  ? true : true; // ANSI 在多数终端可用
+
+function die(msg) { err(msg); process.exit(1); }
+
+function requireToken(cfg) {
+  if (!cfg.token) die('尚未登录，请先执行 op login');
+}
+
+async function requireAuth(cfg) {
+  requireToken(cfg);
+  const r = await api(cfg, 'GET', '/api/cli/sites');
+  if (r.status === 401) die('登录已失效，请重新执行 op login');
+  return r;
+}
+
+/* ---------- login ---------- */
+async function cmdLogin() {
+  const cfg = conf.load();
+  console.log('登录 OnePage（新邮箱将自动注册，用户名默认为邮箱 @ 前缀）');
+  const email = await ask('邮箱');
+  if (!/^[^@\s]+@[^@\s]+\.[^@\s]+$/.test(email)) die('邮箱格式不正确');
+  const password = await askHidden('密码');
+  if (password.length < 6) die('密码至少 6 位');
+
+  info('登录中…');
+  const r = await api(cfg, 'POST', '/api/cli/login', { email, password });
+  if (!r.data.ok) die(r.data.error || '登录失败');
+
+  cfg.token = r.data.token;
+  cfg.username = r.data.username;
+  cfg.email = r.data.email;
+  conf.save(cfg);
+  if (r.data.created) {
+    ok('新账号已自动创建并登录：' + r.data.username + ' <' + r.data.email + '>');
+  } else {
+    ok('登录成功：' + r.data.username);
+  }
+  console.log('配置已保存到 ' + conf.CONF_PATH);
+}
+
+/* ---------- whoami ---------- */
+function cmdWhoami() {
+  const cfg = conf.load();
+  if (!cfg.token) { warn('未登录'); return; }
+  table(['字段', '值'], [
+    ['用户名', cfg.username || '-'],
+    ['邮箱', cfg.email || '-'],
+    ['服务器', cfg.server],
+  ]);
+}
+
+/* ---------- logout ---------- */
+function cmdLogout() {
+  const cfg = conf.load();
+  cfg.token = ''; cfg.username = ''; cfg.email = '';
+  conf.save(cfg);
+  ok('已退出登录（本地凭证已清除）');
+}
+
+/* ---------- init ---------- */
+function cmdInit() {
+  const cwd = process.cwd();
+  if (fs.existsSync(STAGE_DIR)) {
+    warn('当前目录已存在暂存区（.onepage/）');
+    return;
+  }
+  fs.mkdirSync(STAGE_FILES, { recursive: true });
+  fs.writeFileSync(STAGE_MANIFEST, JSON.stringify({
+    version: 1,
+    created_at: new Date().toISOString(),
+    files: [],
+  }, null, 2));
+  ok('已创建暂存区 .onepage/stage/');
+  console.log('接下来：');
+  console.log('  ' + 'op add .' + '        ' + '把当前目录代码加入暂存区');
+  console.log('  ' + 'op push' + '          ' + '把暂存区代码部署上线');
+}
+
+/* ---------- add ---------- */
+function walkFiles(dir, base, out) {
+  for (const name of fs.readdirSync(dir)) {
+    if (name.startsWith('.')) continue; // 跳过隐藏文件/目录
+    const full = path.join(dir, name);
+    const rel = path.relative(base, full).split(path.sep).join('/');
+    const st = fs.statSync(full);
+    if (st.isDirectory()) {
+      if (SKIP_DIRS.has(name)) continue;
+      walkFiles(full, base, out);
+    } else {
+      const ext = name.includes('.') ? name.split('.').pop().toLowerCase() : '';
+      if (!ALLOWED_EXTS.has(ext)) continue;
+      out.push({ rel, full });
+    }
+  }
+}
+
+function cmdAdd(args) {
+  if (!fs.existsSync(STAGE_DIR)) die('暂存区不存在，请先执行 op init');
+  const targets = args.length ? args : ['.'];
+  const cwd = process.cwd();
+  const added = [];
+  const skipped = [];
+
+  for (const t of targets) {
+    const p = path.resolve(cwd, t);
+    if (!fs.existsSync(p)) { err('路径不存在：' + t); continue; }
+    const st = fs.statSync(p);
+    let files = [];
+    if (st.isDirectory()) {
+      walkFiles(p, p, files);
+    } else {
+      const ext = path.basename(p).includes('.') ? path.basename(p).split('.').pop().toLowerCase() : '';
+      if (ALLOWED_EXTS.has(ext)) files.push({ rel: path.basename(p), full: p });
+      else skipped.push(t);
+    }
+    for (const f of files) {
+      const dest = path.join(STAGE_FILES, f.rel);
+      fs.mkdirSync(path.dirname(dest), { recursive: true });
+      fs.copyFileSync(f.full, dest);
+      added.push(f.rel);
+    }
+  }
+
+  // 更新 manifest（去重合并）
+  let manifest = { files: [] };
+  try { manifest = JSON.parse(fs.readFileSync(STAGE_MANIFEST, 'utf8')); } catch (e) {}
+  const set = new Set(manifest.files || []);
+  added.forEach((f) => set.add(f));
+  manifest.files = Array.from(set).sort();
+  manifest.updated_at = new Date().toISOString();
+  fs.writeFileSync(STAGE_MANIFEST, JSON.stringify(manifest, null, 2));
+
+  if (added.length) {
+    ok('已加入暂存区 ' + added.length + ' 个文件：');
+    added.slice(0, 20).forEach((f) => console.log('  + ' + f));
+    if (added.length > 20) console.log('  … 等共 ' + added.length + ' 个');
+  }
+  if (skipped.length) warn('跳过不支持的文件：' + skipped.join(', '));
+  if (!added.length && !skipped.length) warn('没有可添加的文件');
+  else console.log('执行 op push 部署上线');
+}
+
+/* ---------- status ---------- */
+function cmdStatus() {
+  if (!fs.existsSync(STAGE_DIR)) die('暂存区不存在，请先执行 op init');
+  const files = listStaged();
+  if (!files.length) { warn('暂存区为空，执行 op add 添加文件'); return; }
+  ok('暂存区共 ' + files.length + ' 个文件：');
+  let total = 0;
+  files.forEach((f) => {
+    total += f.size;
+    console.log('  ' + pad(f.rel, 40) + ' ' + (f.size / 1024).toFixed(1) + ' KB');
+  });
+  console.log('合计 ' + (total / 1024).toFixed(1) + ' KB');
+}
+
+function listStaged() {
+  const out = [];
+  (function walk(dir, base) {
+    for (const name of fs.readdirSync(dir)) {
+      const full = path.join(dir, name);
+      const rel = path.relative(base, full).split(path.sep).join('/');
+      const st = fs.statSync(full);
+      if (st.isDirectory()) walk(full, base);
+      else out.push({ rel, full, size: st.size });
+    }
+  })(STAGE_FILES, STAGE_FILES);
+  return out;
+}
+
+/* ---------- push ---------- */
+async function cmdPush() {
+  const cfg = conf.load();
+  await requireAuth(cfg);
+  if (!fs.existsSync(STAGE_DIR)) die('暂存区不存在，请先执行 op init 和 op add');
+  const files = listStaged();
+  if (!files.length) die('暂存区为空，先执行 op add 添加文件');
+  if (!files.some((f) => f.rel.toLowerCase() === 'index.html')) {
+    die('缺少 index.html（网站入口文件），无法部署');
+  }
+
+  // 默认短链名：目录名
+  const dirName = path.basename(process.cwd()).replace(/[^A-Za-z0-9_\-]/g, '-').toLowerCase() || 'site';
+  const pathName = await ask('短链名（字母/数字/连字符/下划线）', dirName);
+  if (!/^[A-Za-z0-9_\-]{1,64}$/.test(pathName)) die('短链名只能包含字母、数字、连字符和下划线（≤64 字符）');
+
+  const previewAns = await ask('预览图路径（图片文件，输入 no 跳过）', 'no');
+  let previewPath = null;
+  if (previewAns && previewAns.toLowerCase() !== 'no') {
+    const pp = path.resolve(process.cwd(), previewAns);
+    if (!fs.existsSync(pp)) die('预览图不存在：' + previewAns);
+    const pext = path.basename(pp).split('.').pop().toLowerCase();
+    if (!['jpg', 'jpeg', 'png', 'gif', 'webp'].includes(pext)) die('预览图仅支持 jpg/png/gif/webp');
+    previewPath = pp;
+  }
+
+  const pubAns = await ask('是否公开（yes/no）', 'yes');
+  const isPublic = parseBool(pubAns, true);
+  const seoAns = await ask('是否 SEO 优化（yes/no）', 'yes');
+  const useSeo = parseBool(seoAns, true);
+
+  info('上传 ' + files.length + ' 个文件中…');
+  const form = new FormData();
+  form.append('path_name', pathName);
+  form.append('title', pathName);
+  form.append('description', '');
+  form.append('is_public', isPublic ? 'true' : 'false');
+  form.append('seo', useSeo ? 'true' : 'false');
+  for (const f of files) {
+    const buf = fs.readFileSync(f.full);
+    form.append('files', new Blob([buf]), f.rel);
+  }
+  if (previewPath) {
+    const buf = fs.readFileSync(previewPath);
+    form.append('preview', new Blob([buf]), path.basename(previewPath));
+  }
+
+  const r = await api(cfg, 'POST', '/api/cli/deploy', form, true);
+  if (r.status === 401) die('登录已失效，请重新执行 op login');
+  if (!r.data.ok) die(r.data.error || '部署失败');
+  ok('部署完成：' + r.data.url);
+  console.log('在浏览器打开：op open ' + pathName);
+}
+
+/* ---------- clone ---------- */
+async function cmdClone(args) {
+  const cfg = conf.load();
+  await requireAuth(cfg);
+  const arg = args[0];
+  if (!arg) die('用法：op clone <站点URL或短链名>   例如 op clone https://app1.cloudstudio.site/my-site/');
+  let name = arg;
+  try {
+    const u = new URL(arg);
+    name = u.pathname.split('/').filter(Boolean)[0] || '';
+  } catch (e) { /* 不是 URL，按短链名处理 */ }
+  if (!/^[A-Za-z0-9_\-]{1,64}$/.test(name)) die('无法从参数解析出短链名：' + arg);
+
+  info('拉取 ' + name + ' …');
+  const r = await api(cfg, 'GET', '/api/cli/download/' + encodeURIComponent(name));
+  if (r.status === 401) die('登录已失效，请重新执行 op login');
+  if (!r.data.ok) die(r.data.error || '拉取失败');
+
+  const destDir = path.resolve(process.cwd(), name);
+  if (fs.existsSync(destDir)) die('目录已存在：' + name);
+  fs.mkdirSync(destDir, { recursive: true });
+  for (const f of r.data.files) {
+    const dest = path.join(destDir, ...f.path.split('/'));
+    fs.mkdirSync(path.dirname(dest), { recursive: true });
+    fs.writeFileSync(dest, Buffer.from(f.content, 'base64'));
+  }
+  ok('已拉取 ' + r.data.files.length + ' 个文件到 ./' + name + '/');
+}
+
+/* ---------- list ---------- */
+async function cmdList() {
+  const cfg = conf.load();
+  const r = await requireAuth(cfg);
+  const sites = r.data.sites || [];
+  if (!sites.length) { warn('账号下还没有站点，执行 op init + op add + op push 创建'); return; }
+  ok('共 ' + sites.length + ' 个站点：');
+  table(
+    ['短链名', '标题', '公开', '浏览', '点赞', '更新时间', 'URL'],
+    sites.map((s) => [s.path_name, s.title, s.is_public ? '是' : '否', s.views, s.likes, s.updated_at, s.url])
+  );
+}
+
+/* ---------- delete ---------- */
+async function cmdDelete(args) {
+  const cfg = conf.load();
+  await requireAuth(cfg);
+  const name = args[0];
+  if (!name) die('用法：op delete <短链名>');
+  const ans = await ask('确认删除站点 ' + name + '（yes/no）', 'no');
+  if (!parseBool(ans, false)) { info('已取消'); return; }
+  const r = await api(cfg, 'DELETE', '/api/cli/site/' + encodeURIComponent(name));
+  if (r.status === 401) die('登录已失效，请重新执行 op login');
+  if (!r.data.ok) die(r.data.error || '删除失败');
+  ok('已删除站点：' + name);
+}
+
+/* ---------- open ---------- */
+async function cmdOpen(args) {
+  const cfg = conf.load();
+  await requireAuth(cfg);
+  const name = args[0];
+  if (!name) die('用法：op open <短链名>');
+  const url = cfg.server.replace(/\/$/, '') + '/' + name + '/';
+  const cmdLine = process.platform === 'darwin' ? 'open' :
+    process.platform === 'win32' ? 'start ""' : 'xdg-open';
+  exec(cmdLine + ' "' + url + '"', () => {});
+  ok('已在浏览器打开：' + url);
+}
+
+/* ---------- help ---------- */
+function cmdHelp() {
+  console.log('OnePage CLI —— 在终端部署你的静态网页');
+  console.log('');
+  console.log('用法：op <命令> [参数]');
+  console.log('');
+  console.log('账号：');
+  console.log('  op login          登录（新邮箱自动注册，用户名默认邮箱 @ 前缀）');
+  console.log('  op whoami         查看当前登录账号');
+  console.log('  op logout         退出登录');
+  console.log('');
+  console.log('部署流程：');
+  console.log('  op init           在当前目录创建代码暂存区（.onepage/）');
+  console.log('  op add [路径]     把文件/目录加入暂存区（默认当前目录）');
+  console.log('  op status         查看暂存区文件');
+  console.log('  op push           部署暂存区代码上线（交互式输入短链名/预览图/公开/SEO）');
+  console.log('');
+  console.log('站点管理：');
+  console.log('  op list           列出本账号所有站点');
+  console.log('  op clone <url>    拉取站点代码到本地（支持 URL 或短链名）');
+  console.log('  op delete <name>  删除指定站点');
+  console.log('  op open <name>    在浏览器打开站点');
+  console.log('');
+  console.log('示例：');
+  console.log('  op login && op init && op add . && op push');
+  console.log('  op clone https://app1.cloudstudio.site/demo/');
+}
+
+/* ---------- main ---------- */
+async function main() {
+  const argv = process.argv.slice(2);
+  const cmd = (argv[0] || 'help').toLowerCase();
+  const args = argv.slice(1);
+  try {
+    switch (cmd) {
+      case 'login': return await cmdLogin();
+      case 'whoami': return cmdWhoami();
+      case 'logout': return cmdLogout();
+      case 'init': return cmdInit();
+      case 'add': return cmdAdd(args);
+      case 'status': return cmdStatus();
+      case 'push': return await cmdPush();
+      case 'clone': return await cmdClone(args);
+      case 'list': case 'ls': return await cmdList();
+      case 'delete': case 'rm': return await cmdDelete(args);
+      case 'open': return await cmdOpen(args);
+      case 'help': case '--help': case '-h': return cmdHelp();
+      default:
+        err('未知命令：' + cmd);
+        cmdHelp();
+        process.exit(1);
+    }
+  } catch (e) {
+    die(e.message || String(e));
+  }
+}
+
+main();

package/lib/api.js

@@ -0,0 +1,22 @@
+'use strict';
+// HTTP 封装（Node 18+ 原生 fetch，零依赖）
+async function api(cfg, method, pathname, body, isForm) {
+  const headers = {};
+  if (cfg.token) headers['Authorization'] = 'Bearer ' + cfg.token;
+  if (!isForm) headers['Content-Type'] = 'application/json';
+  let res;
+  try {
+    res = await fetch(cfg.server + pathname, {
+      method: method,
+      headers: headers,
+      body: isForm ? body : (body !== undefined ? JSON.stringify(body) : undefined),
+    });
+  } catch (e) {
+    throw new Error('无法连接服务器 ' + cfg.server + '（' + e.message + '）');
+  }
+  let data = {};
+  try { data = await res.json(); } catch (e) { /* 忽略非 JSON 响应 */ }
+  return { status: res.status, data: data };
+}
+
+module.exports = { api };

package/lib/config.js

@@ -0,0 +1,22 @@
+'use strict';
+// 配置读写：~/.onepage-cli.json
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
+
+const CONF_PATH = path.join(os.homedir(), '.onepage-cli.json');
+const DEFAULTS = { server: 'https://app1.cloudstudio.site', token: '', username: '', email: '' };
+
+function load() {
+  try {
+    return Object.assign({}, DEFAULTS, JSON.parse(fs.readFileSync(CONF_PATH, 'utf8')));
+  } catch (e) {
+    return Object.assign({}, DEFAULTS);
+  }
+}
+
+function save(cfg) {
+  fs.writeFileSync(CONF_PATH, JSON.stringify(cfg, null, 2), { mode: 0o600 });
+}
+
+module.exports = { load, save, CONF_PATH };

package/lib/prompt.js

@@ -0,0 +1,79 @@
+'use strict';
+// 交互输入（git 风格提示）
+// 统一处理两种模式：
+//   - TTY 交互：逐条提问，密码回显 *
+//   - 管道/脚本：预先读入所有行排队消费（避免多个 readline 实例丢行）
+const readline = require('readline');
+
+const queue = [];
+let eof = false;
+let interactive = !!process.stdin.isTTY;
+
+if (!interactive) {
+  const rl = readline.createInterface({ input: process.stdin, terminal: false });
+  rl.on('line', (l) => queue.push(l));
+  rl.on('close', () => { eof = true; });
+}
+
+function nextLine() {
+  return new Promise((resolve) => {
+    if (queue.length) return resolve(queue.shift());
+    if (eof) return resolve('');
+    const t = setInterval(() => {
+      if (queue.length) { clearInterval(t); resolve(queue.shift()); }
+      else if (eof) { clearInterval(t); resolve(''); }
+    }, 20);
+  });
+}
+
+async function ask(question, def) {
+  const suffix = def ? ' [' + def + ']' : '';
+  if (interactive) {
+    return new Promise((resolve) => {
+      const r = readline.createInterface({ input: process.stdin, output: process.stdout });
+      r.question(question + suffix + ': ', (ans) => {
+        r.close();
+        const v = (ans || '').trim();
+        resolve(v || (def || ''));
+      });
+    });
+  }
+  const line = await nextLine();
+  const v = (line || '').trim();
+  return v || (def || '');
+}
+
+// 密码输入：TTY 下回显 *；非 TTY 直接读行
+async function askHidden(question) {
+  if (!interactive) {
+    const line = await nextLine();
+    return (line || '').trim();
+  }
+  return new Promise((resolve) => {
+    const r = readline.createInterface({
+      input: process.stdin,
+      output: process.stdout,
+      terminal: true,
+    });
+    r.question(question + ': ', (answer) => {
+      r.close();
+      process.stdout.write('\n');
+      resolve((answer || '').trim());
+    });
+    // 拦截输出：问题文本照常打印，输入字符替换为 *
+    r._writeToOutput = function (stringToWrite) {
+      if (stringToWrite.includes(question)) {
+        r.output.write(stringToWrite);
+      } else {
+        r.output.write('*');
+      }
+    };
+  });
+}
+
+function parseBool(v, def) {
+  if (v === undefined || v === '') return def;
+  return /^(y|yes|true|1)$/i.test(String(v).trim());
+}
+
+module.exports = { ask, askHidden, parseBool };

package/lib/util.js

@@ -0,0 +1,41 @@
+'use strict';
+// 终端输出辅助（ANSI 颜色 + 简易表格）
+const C = {
+  reset: '\x1b[0m',
+  bold: '\x1b[1m',
+  dim: '\x1b[2m',
+  green: '\x1b[32m',
+  red: '\x1b[31m',
+  yellow: '\x1b[33m',
+  cyan: '\x1b[36m',
+  gray: '\x1b[90m',
+};
+
+function ok(msg) { console.log(C.green + '✓ ' + C.reset + msg); }
+function err(msg) { console.error(C.red + '✗ ' + msg + C.reset); }
+function info(msg) { console.log(C.cyan + '› ' + C.reset + msg); }
+function warn(msg) { console.log(C.yellow + '! ' + msg + C.reset); }
+
+function pad(s, n) {
+  s = String(s == null ? '' : s);
+  let w = 0;
+  for (const ch of s) w += ch.charCodeAt(0) > 255 ? 2 : 1; // 中文按 2 列宽
+  return w >= n ? s : s + ' '.repeat(n - w);
+}
+
+function table(headers, rows) {
+  const widths = headers.map((h) => displayWidth(h));
+  rows.forEach((r) => r.forEach((c, i) => { widths[i] = Math.max(widths[i], displayWidth(c)); }));
+  const line = (cells, sep) => cells.map((c, i) => pad(c, widths[i])).join(sep);
+  console.log(line(headers, '  '));
+  console.log(C.gray + widths.map((w) => '─'.repeat(w)).join('  ') + C.reset);
+  rows.forEach((r) => console.log(line(r, '  ')));
+}
+
+function displayWidth(s) {
+  let w = 0;
+  for (const ch of String(s == null ? '' : s)) w += ch.charCodeAt(0) > 255 ? 2 : 1;
+  return w;
+}
+
+module.exports = { ok, err, info, warn, table, pad };

package/package.json

@@ -1,6 +1,30 @@
 {
   "name": "onepage-cli",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "1.0.0",
+  "description": "OnePage 命令行工具：在终端生成、部署、管理你的静态网页（git 风格指令 op login / init / add / push / clone / list / delete）",
+  "bin": {
+    "op": "bin/op.js"
+  },
+  "main": "bin/op.js",
+  "files": [
+    "bin/",
+    "lib/",
+    "README.md"
+  ],
+  "keywords": [
+    "onepage",
+    "cli",
+    "deploy",
+    "static-site",
+    "web",
+    "ai"
+  ],
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "url",
+    "url": "https://app1.cloudstudio.site"
+  }
+}