@vitex/nook 0.0.0-stage → 0.1.0

package/src/backend/cli.js

@@ -0,0 +1,237 @@
+/**
+ * Nook CLI
+ *
+ *   nook start      前台启动 Web 服务
+ *   nook status     查看运行状态
+ *   nook service    launchd 服务管理
+ */
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import {
+  DEFAULT_HOST,
+  DEFAULT_PORT,
+  ensureHome,
+  getHomeDir,
+  getHost,
+  getLogsDir,
+  getPort,
+} from './config.js';
+import { listProjects } from './projects.js';
+import { accessUrls } from './net.js';
+import { log, logErr } from './logging.js';
+import { startServer } from './server.js';
+import {
+  installService,
+  restartService,
+  serviceStatus,
+  startService,
+  stopService,
+  uninstallService,
+} from './service.js';
+
+const VERSION = '0.1.0';
+
+const HELP = `Nook ${VERSION}
+给 Pi 用的轻量 Web 界面
+
+用法：
+  nook start [--host ${DEFAULT_HOST}] [--port ${DEFAULT_PORT}]
+  nook status
+  nook service install
+  nook service uninstall
+  nook service start
+  nook service stop
+  nook service restart
+  nook service status
+  nook help
+
+说明：
+  只保存项目索引 ${path.join(getHomeDir(), 'projects.json')}
+  日志目录 ${getLogsDir()}
+  Pi 配置与会话沿用 Pi 自己的设置（~/.pi）
+`;
+
+function parseArgs(argv) {
+  const flags = {};
+  const positional = [];
+  for (let i = 0; i < argv.length; i++) {
+    const arg = argv[i];
+    if (arg === '--') { positional.push(...argv.slice(i + 1)); break; }
+    if (arg.startsWith('--')) {
+      const eq = arg.indexOf('=');
+      if (eq !== -1) {
+        flags[arg.slice(2, eq)] = arg.slice(eq + 1);
+      } else {
+        const key = arg.slice(2);
+        const next = argv[i + 1];
+        if (next !== undefined && !next.startsWith('--')) {
+          flags[key] = next;
+          i++;
+        } else {
+          flags[key] = true;
+        }
+      }
+    } else {
+      positional.push(arg);
+    }
+  }
+  return { flags, positional };
+}
+
+function applyFlags(flags) {
+  if (flags.host) process.env.NOOK_HOST = String(flags.host);
+  if (flags.port) process.env.NOOK_PORT = String(flags.port);
+}
+
+function printStartup({ port, host }) {
+  const urls = accessUrls(port, host);
+  const lines = [
+    `Nook ${VERSION}`,
+    `  监听      ${host}:${port}`,
+    `  本机      ${urls.local}`,
+  ];
+  for (const url of urls.network) lines.push(`  网络      ${url}`);
+  console.log(lines.join('\n'));
+}
+
+async function startCmd() {
+  ensureHome();
+  const port = getPort();
+  const host = getHost();
+  let started;
+  try {
+    started = await startServer({ port, host });
+  } catch (e) {
+    if (e?.code === 'EADDRINUSE') {
+      logErr(`端口 ${port} 已被占用。可以换一个端口：nook start --port 4318`);
+      return 1;
+    }
+    if (e?.code === 'EADDRNOTAVAIL') {
+      logErr(`无法监听 ${host}:${port}，请检查 --host 是否是本机网卡地址`);
+      return 1;
+    }
+    throw e;
+  }
+  printStartup({ port: started.port, host: started.host });
+  log('服务已启动，等待访问…');
+
+  let closing = false;
+  const shutdown = async (signal) => {
+    if (closing) return;
+    closing = true;
+    log(`收到 ${signal}，正在退出…`);
+    try { started.server.close(); } catch { }
+    setTimeout(() => process.exit(0), 100).unref();
+  };
+  process.on('SIGINT', () => shutdown('SIGINT'));
+  process.on('SIGTERM', () => shutdown('SIGTERM'));
+  await new Promise(() => { });
+}
+
+function statusCmd() {
+  const service = serviceStatus();
+  const port = service.running && service.port ? service.port : getPort();
+  const host = service.running && service.host ? service.host : getHost();
+  const urls = accessUrls(port, host);
+  const projects = listProjects();
+  const url = urls.network[0] || urls.local;
+  const logs = service.manager === 'systemd' ? `journalctl --user -u ${service.label}` : getLogsDir();
+
+  console.log(`Nook ${VERSION}`);
+  console.log(`地址      ${url}`);
+  console.log(`状态      ${service.installed ? (service.running ? 'running' : 'stopped') : 'not-installed'}`);
+  console.log(`项目      ${path.join(getHomeDir(), 'projects.json')}（${projects.length} 个）`);
+  console.log(`日志      ${logs}`);
+  return 0;
+}
+
+function serviceCmd(sub) {
+  const port = getPort();
+  const host = getHost();
+  switch (sub || 'status') {
+    case 'install': {
+      installService({ port, host });
+      const urls = accessUrls(port, host);
+      log(`  监听      ${host}:${port}`);
+      log(`  本机      ${urls.local}`);
+      for (const url of urls.network) log(`  网络      ${url}`);
+      log('  提示      修改代码后运行 nook service restart');
+      return 0;
+    }
+    case 'uninstall':
+      uninstallService();
+      return 0;
+    case 'start':
+      startService();
+      return 0;
+    case 'stop':
+      stopService();
+      return 0;
+    case 'restart':
+      restartService();
+      return 0;
+    case 'status': {
+      const s = serviceStatus();
+      console.log(`服务      ${s.installed ? (s.running ? 'running' : 'stopped') : 'not-installed'}`);
+      if (s.host && s.port) console.log(`监听      ${s.host}:${s.port}`);
+      console.log(`管理器    ${s.manager}`);
+      console.log(`Label     ${s.label}`);
+      console.log(`文件      ${s.file || '-'}`);
+      return 0;
+    }
+    default:
+      logErr('未知 service 子命令：' + sub);
+      console.log(`用法：
+  nook service install
+  nook service uninstall
+  nook service start
+  nook service stop
+  nook service restart
+  nook service status`);
+      return 1;
+  }
+}
+
+export async function main(argv = process.argv.slice(2)) {
+  const { flags, positional } = parseArgs(argv);
+  applyFlags(flags);
+
+  const cmd = flags.version ? 'version' : (positional[0] || 'help');
+  switch (cmd) {
+    case 'start':
+    case 'run':
+      return startCmd();
+    case 'status':
+      return statusCmd();
+    case 'service':
+    case 'daemon':
+      return serviceCmd(positional[1]);
+    case 'version':
+    case '-v':
+    case '--version':
+      console.log(VERSION);
+      return 0;
+    case 'help':
+    case '-h':
+    case '--help':
+    case undefined:
+      console.log(HELP);
+      return 0;
+    default:
+      logErr('未知命令：' + cmd);
+      console.log(HELP);
+      return 1;
+  }
+}
+
+const isDirectRun = process.argv[1]
+  && path.resolve(process.argv[1]) === fileURLToPath(import.meta.url);
+
+if (isDirectRun) {
+  main(process.argv.slice(2)).then((code) => {
+    process.exitCode = code ?? 0;
+  }).catch((err) => {
+    console.error(err?.stack || String(err));
+    process.exitCode = 1;
+  });
+}

package/src/backend/config.js

@@ -0,0 +1,69 @@
+/**
+ * Nook 路径与运行参数。
+ *
+ * Nook 只保存自己管理的项目目录索引，不记录任何模型或服务配置。
+ * 所有运行期数据都放在 ~/.nook（可用 NOOK_HOME 覆盖）：
+ *   projects.json 项目索引
+ *   logs/         macOS 服务日志
+ *
+ * Pi 配置与会话仍由 Pi 自己保存在 ~/.pi。
+ */
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+export const BACKEND_DIR = path.dirname(fileURLToPath(import.meta.url));
+export const PROJECT_DIR = path.resolve(BACKEND_DIR, '..', '..');
+export const DEFAULT_PORT = 4317;
+export const DEFAULT_HOST = '127.0.0.1';
+
+export function getHomeDir() {
+  return process.env.NOOK_HOME ? path.resolve(process.env.NOOK_HOME) : path.join(os.homedir(), '.nook');
+}
+
+export function getProjectsPath() {
+  return path.join(getHomeDir(), 'projects.json');
+}
+
+export function getLogsDir() {
+  return path.join(getHomeDir(), 'logs');
+}
+
+export function getWebDir() {
+  const candidates = [
+    process.env.NOOK_WEB_DIR,
+    path.join(PROJECT_DIR, 'dist', 'frontend'),
+    path.join(PROJECT_DIR, 'src', 'frontend', 'dist'),
+  ].filter(Boolean);
+  for (const dir of candidates) {
+    try {
+      if (fs.statSync(path.join(dir, 'index.html')).isFile()) return dir;
+    } catch { }
+  }
+  return '';
+}
+
+export function ensureHome() {
+  fs.mkdirSync(getHomeDir(), { recursive: true });
+  fs.mkdirSync(getLogsDir(), { recursive: true });
+  return getHomeDir();
+}
+
+export function ensureDir(dir) {
+  fs.mkdirSync(dir, { recursive: true });
+  return dir;
+}
+
+export function getNodeBin() {
+  return process.execPath;
+}
+
+export function getPort() {
+  const n = Number(process.env.NOOK_PORT || process.env.PORT || DEFAULT_PORT);
+  return Number.isFinite(n) && n > 0 && n < 65536 ? n : DEFAULT_PORT;
+}
+
+export function getHost() {
+  return process.env.NOOK_HOST || DEFAULT_HOST;
+}

package/src/backend/fs-browser.js

@@ -0,0 +1,121 @@
+/**
+ * 网页端目录选择器用的只读目录 API。
+ *
+ * 全部使用异步 fs：macOS 在后台进程访问「桌面/文稿/下载」时可能弹出权限框，
+ * 同步 fs 会把整个 Node 事件循环卡死；异步 + 超时至少保证 Web 服务本身还能响应。
+ */
+import fs from 'node:fs/promises';
+import os from 'node:os';
+import path from 'node:path';
+
+const MAX_ENTRIES = 500;
+const FS_TIMEOUT_MS = 2500;
+
+function expandHome(input) {
+  const s = String(input || '').trim();
+  if (!s || s === '~') return os.homedir();
+  if (s.startsWith('~/')) return path.join(os.homedir(), s.slice(2));
+  return s;
+}
+
+function protectedRoots() {
+  const home = os.homedir();
+  return [path.join(home, 'Desktop'), path.join(home, 'Documents'), path.join(home, 'Downloads')];
+}
+
+function isService() {
+  return process.env.NOOK_SERVICE === '1';
+}
+
+function assertAccessible(target) {
+  if (process.platform !== 'darwin') return;
+  if (!isService() || process.env.NOOK_ALLOW_PROTECTED === '1') return;
+  if (protectedRoots().some((root) => target === root || target.startsWith(root + path.sep))) {
+    throw new Error('后台服务访问不了桌面/文稿/下载（macOS 隐私保护）。可改用 nook start 前台运行，或授权后设置 NOOK_ALLOW_PROTECTED=1');
+  }
+}
+
+function withTimeout(promise, message = '读取超时（可能触发了 macOS 权限提示）') {
+  return Promise.race([
+    promise,
+    new Promise((_, reject) => setTimeout(() => reject(new Error(message)), FS_TIMEOUT_MS)),
+  ]);
+}
+
+export async function listDirectories(inputPath) {
+  const target = path.resolve(expandHome(inputPath));
+  assertAccessible(target);
+  let stat;
+  try {
+    stat = await withTimeout(fs.stat(target));
+  } catch (e) {
+    if (e?.message?.includes('超时')) throw e;
+    throw new Error('目录不存在');
+  }
+  if (!stat.isDirectory()) throw new Error('不是目录');
+
+  let entries;
+  try {
+    entries = (await withTimeout(fs.readdir(target, { withFileTypes: true })))
+      .filter((d) => !d.name.startsWith('.') && d.isDirectory())
+      .map((d) => ({ name: d.name, path: path.join(target, d.name) }))
+      .sort((a, b) => a.name.localeCompare(b.name, 'zh-Hans-CN', { numeric: true }));
+  } catch (e) {
+    if (e?.message?.includes('超时')) throw e;
+    throw new Error('没有权限读取这个目录');
+  }
+
+  let writable = false;
+  try {
+    await withTimeout(fs.access(target, fs.constants.W_OK));
+    writable = true;
+  } catch { }
+
+  const truncated = entries.length > MAX_ENTRIES;
+  if (truncated) entries = entries.slice(0, MAX_ENTRIES);
+  const parent = path.dirname(target);
+
+  return {
+    path: target,
+    parent: parent === target ? null : parent,
+    home: os.homedir(),
+    dirs: entries,
+    writable,
+    truncated,
+  };
+}
+
+export async function createDirectory(parentInput, name) {
+  const parent = path.resolve(expandHome(parentInput));
+  assertAccessible(parent);
+  const clean = String(name || '').trim();
+  if (!clean) throw new Error('请输入文件夹名称');
+  if (clean === '.' || clean === '..' || clean.startsWith('.')) throw new Error('名称不能以点开头');
+  if (/[\/\\\u0000]/.test(clean)) throw new Error('名称不能包含斜杠');
+  if (clean.length > 80) throw new Error('名称过长');
+
+  let stat;
+  try {
+    stat = await withTimeout(fs.stat(parent));
+  } catch {
+    throw new Error('上级目录不存在');
+  }
+  if (!stat.isDirectory()) throw new Error('上级路径不是目录');
+
+  const target = path.join(parent, clean);
+  try {
+    await withTimeout(fs.stat(target));
+    throw new Error('同名目录已存在');
+  } catch (e) {
+    if (e?.message === '同名目录已存在') throw e;
+    if (e?.message?.includes('超时')) throw e;
+  }
+
+  try {
+    await withTimeout(fs.mkdir(target));
+  } catch (e) {
+    if (e?.message?.includes('超时')) throw e;
+    throw new Error('没有权限在这里新建目录');
+  }
+  return { path: target };
+}

package/src/backend/index.js

@@ -0,0 +1,3 @@
+import { main } from './cli.js';
+
+export { main };

package/src/backend/logging.js

@@ -0,0 +1,9 @@
+const ts = () => new Date().toISOString();
+
+export const log = (...args) => console.log(ts(), ...args);
+export const logErr = (...args) => console.error(ts(), ...args);
+
+export function shortId(id, length = 12) {
+  const s = String(id ?? '');
+  return s.length > length ? s.slice(0, length) + '…' : s;
+}

package/src/backend/net.js

@@ -0,0 +1,43 @@
+/**
+ * 通用网络地址工具。
+ *
+ * Nook 不依赖任何特定网络服务；只根据传入的 host / port 监听，
+ * 并在 CLI 里展示本机和各网卡对应的访问地址。
+ */
+import os from 'node:os';
+
+export function isLoopback(host) {
+  return !host || host === '127.0.0.1' || host === 'localhost' || host === '::1';
+}
+
+export function isWildcard(host) {
+  return !host || host === '0.0.0.0' || host === '::';
+}
+
+export function localUrl(port) {
+  return `http://127.0.0.1:${port}`;
+}
+
+export function networkAddresses() {
+  const out = [];
+  for (const infos of Object.values(os.networkInterfaces())) {
+    for (const info of infos || []) {
+      if (info.family === 'IPv4' && !info.internal) out.push(info.address);
+    }
+  }
+  return [...new Set(out)];
+}
+
+/** 给 CLI / API 用的访问地址集合 */
+export function accessUrls(port, host = '127.0.0.1') {
+  const local = localUrl(port);
+  const network = [];
+
+  if (isWildcard(host)) {
+    for (const ip of networkAddresses()) network.push(`http://${ip}:${port}`);
+  } else if (!isLoopback(host)) {
+    network.push(`http://${host}:${port}`);
+  }
+
+  return { local, network };
+}

package/src/backend/package.json

@@ -0,0 +1,15 @@
+{
+  "name": "@nook/backend",
+  "version": "0.1.0",
+  "private": true,
+  "type": "module",
+  "main": "index.js",
+  "scripts": {
+    "dev": "node cli.js start --host 127.0.0.1",
+    "start": "node cli.js start"
+  },
+  "dependencies": {
+    "@earendil-works/pi-coding-agent": "0.86.1",
+    "typebox": "1.3.27"
+  }
+}

package/src/backend/projects.js

@@ -0,0 +1,89 @@
+/**
+ * 项目索引：每个项目就是一个 Pi 工作目录（cwd）。
+ * 项目只记录名字与路径，不复制、不移动用户目录里的文件。
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+import os from 'node:os';
+import crypto from 'node:crypto';
+import { ensureHome, getProjectsPath } from './config.js';
+
+function load() {
+  ensureHome();
+  const file = getProjectsPath();
+  if (!fs.existsSync(file)) return { version: 1, projects: [] };
+  try {
+    const data = JSON.parse(fs.readFileSync(file, 'utf8'));
+    return { version: 1, projects: Array.isArray(data.projects) ? data.projects : [] };
+  } catch {
+    return { version: 1, projects: [] };
+  }
+}
+
+function save(data) {
+  ensureHome();
+  const file = getProjectsPath();
+  const tmp = `${file}.${process.pid}.tmp`;
+  fs.writeFileSync(tmp, JSON.stringify(data, null, 2) + '\n', { mode: 0o600 });
+  fs.renameSync(tmp, file);
+  try { fs.chmodSync(file, 0o600); } catch { }
+}
+
+function expandHome(p) {
+  const s = String(p || '').trim();
+  if (s === '~') return os.homedir();
+  if (s.startsWith('~/')) return path.join(os.homedir(), s.slice(2));
+  return s;
+}
+
+export function listProjects() {
+  return load().projects
+    .slice()
+    .sort((a, b) => String(b.createdAt || '').localeCompare(String(a.createdAt || '')));
+}
+
+export function getProject(id) {
+  return load().projects.find((p) => p.id === id) || null;
+}
+
+export function createProject({ name, path: inputPath }) {
+  const label = String(name || '').trim();
+  if (!label) throw new Error('请输入项目名称');
+  if (label.length > 80) throw new Error('项目名称过长');
+  if (!inputPath || !String(inputPath).trim()) throw new Error('请选择项目目录');
+
+  const data = load();
+  const raw = expandHome(inputPath);
+  const dir = path.isAbsolute(raw) ? path.resolve(raw) : path.resolve(os.homedir(), raw);
+
+  if (fs.existsSync(dir) && !fs.statSync(dir).isDirectory()) {
+    throw new Error('这个路径不是目录');
+  }
+  fs.mkdirSync(dir, { recursive: true });
+
+  const duplicate = data.projects.find((p) => p.path === dir);
+  if (duplicate) {
+    const err = new Error(`这个目录已经是项目「${duplicate.name}」`);
+    err.code = 'DUPLICATE';
+    throw err;
+  }
+
+  const project = {
+    id: crypto.randomUUID(),
+    name: label,
+    path: dir,
+    createdAt: new Date().toISOString(),
+  };
+  data.projects.push(project);
+  save(data);
+  return project;
+}
+
+export function removeProject(id) {
+  const data = load();
+  const index = data.projects.findIndex((p) => p.id === id);
+  if (index === -1) return null;
+  const [removed] = data.projects.splice(index, 1);
+  save(data);
+  return removed;
+}