@muyichengshayu/promptx 0.1.0

package/packages/shared/src/index.js

@@ -0,0 +1,121 @@
+export const EXPIRY_PRESETS = {
+  none: {
+    label: '不过期',
+    hours: null,
+  },
+}
+
+export const EXPIRY_OPTIONS = Object.entries(EXPIRY_PRESETS).map(([value, preset]) => ({
+  value,
+  label: preset.label,
+}))
+
+export const VISIBILITY_OPTIONS = [
+  { value: 'private', label: '仅自己可见' },
+]
+
+export const BLOCK_TYPES = {
+  TEXT: 'text',
+  IMAGE: 'image',
+  IMPORTED_TEXT: 'imported_text',
+}
+
+export const BLOCK_TYPE_LABELS = {
+  [BLOCK_TYPES.TEXT]: '文本',
+  [BLOCK_TYPES.IMAGE]: '图片',
+  [BLOCK_TYPES.IMPORTED_TEXT]: '导入文件',
+}
+
+export function normalizeVisibility(value) {
+  return 'private'
+}
+
+export function normalizeExpiry(value) {
+  return 'none'
+}
+
+export function getVisibilityLabel(value) {
+  return VISIBILITY_OPTIONS.find((item) => item.value === value)?.label || '仅自己可见'
+}
+
+export function getBlockTypeLabel(value) {
+  return BLOCK_TYPE_LABELS[value] || '内容'
+}
+
+export function resolveExpiresAt(expiry = 'none', now = new Date()) {
+  const preset = EXPIRY_PRESETS[normalizeExpiry(expiry)]
+  if (!preset || preset.hours === null) {
+    return null
+  }
+
+  return new Date(now.getTime() + preset.hours * 60 * 60 * 1000).toISOString()
+}
+
+export function getExpiryValue(expiresAt, now = new Date()) {
+  if (!expiresAt) {
+    return 'none'
+  }
+
+  const diffMs = new Date(expiresAt).getTime() - now.getTime()
+  if (diffMs <= 24 * 60 * 60 * 1000 + 60 * 1000) {
+    return 'none'
+  }
+  return 'none'
+}
+
+export function clampText(value = '', max = 20000) {
+  return String(value).slice(0, max)
+}
+
+export function slugifyTitle(title = '') {
+  const base = String(title)
+    .toLowerCase()
+    .replace(/[^a-z0-9]+/g, '-')
+    .replace(/^-+|-+$/g, '')
+    .slice(0, 36)
+
+  return base || 'task'
+}
+
+export function deriveTitleFromBlocks(blocks = [], max = 10) {
+  const firstText = blocks.find(
+    (block) =>
+      (block.type === BLOCK_TYPES.TEXT || block.type === BLOCK_TYPES.IMPORTED_TEXT) &&
+      block.content?.trim()
+  )
+  if (!firstText) {
+    return ''
+  }
+
+  return firstText.content.replace(/\s+/g, ' ').trim().slice(0, max)
+}
+
+export function buildRawTaskText(task) {
+  const parts = []
+  if (task.title) {
+    parts.push(`标题：${task.title}`, '')
+  }
+
+  for (const [index, block] of (task.blocks || []).entries()) {
+    if (block.type === BLOCK_TYPES.TEXT || block.type === BLOCK_TYPES.IMPORTED_TEXT) {
+      parts.push(block.content?.trim() || '', '')
+      continue
+    }
+
+    if (block.type === BLOCK_TYPES.IMAGE) {
+      parts.push(`图片 ${index + 1}：${block.content || ''}`)
+      parts.push('')
+    }
+  }
+
+  return parts.join('\n').trim() + '\n'
+}
+
+export function summarizeTask(task) {
+  const textBlock = (task.blocks || []).find(
+    (block) =>
+      (block.type === BLOCK_TYPES.TEXT || block.type === BLOCK_TYPES.IMPORTED_TEXT) &&
+      block.content?.trim()
+  )
+  return (textBlock?.content || '').replace(/\s+/g, ' ').trim().slice(0, 180)
+}

package/scripts/doctor.mjs

@@ -0,0 +1,251 @@
+import fs from 'node:fs'
+import net from 'node:net'
+import path from 'node:path'
+import process from 'node:process'
+import { execFileSync } from 'node:child_process'
+import { fileURLToPath } from 'node:url'
+
+import { resolvePromptxPaths } from '../apps/server/src/appPaths.js'
+
+const DEFAULT_HOST = '127.0.0.1'
+const DEFAULT_PORT = 3000
+const SUPPORTED_NODE_RANGES = [
+  { min: [20, 19, 0], maxExclusiveMajor: 21, label: '20.19+' },
+  { min: [22, 13, 0], maxExclusiveMajor: 23, label: '22.13+' },
+  { min: [24, 0, 0], maxExclusiveMajor: 25, label: '24.x' },
+]
+const RECOMMENDED_NODE_MAJOR = 22
+const CODEX_BIN = process.env.CODEX_BIN || 'codex'
+
+const rootDir = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..')
+const webIndexPath = path.join(rootDir, 'apps', 'web', 'dist', 'index.html')
+
+function compareVersions(left = [], right = []) {
+  const maxLength = Math.max(left.length, right.length)
+  for (let index = 0; index < maxLength; index += 1) {
+    const leftValue = Number(left[index] || 0)
+    const rightValue = Number(right[index] || 0)
+    if (leftValue > rightValue) {
+      return 1
+    }
+    if (leftValue < rightValue) {
+      return -1
+    }
+  }
+  return 0
+}
+
+function parseNodeVersion(value = '') {
+  return String(value || '')
+    .replace(/^v/, '')
+    .split('.')
+    .map((part) => Number(part) || 0)
+}
+
+function resolveCodexBinary() {
+  if (process.platform !== 'win32') {
+    return CODEX_BIN
+  }
+
+  if (path.extname(CODEX_BIN)) {
+    return CODEX_BIN
+  }
+
+  if (fs.existsSync(`${CODEX_BIN}.cmd`)) {
+    return `${CODEX_BIN}.cmd`
+  }
+
+  if (fs.existsSync(`${CODEX_BIN}.bat`)) {
+    return `${CODEX_BIN}.bat`
+  }
+
+  if (fs.existsSync(CODEX_BIN)) {
+    return CODEX_BIN
+  }
+
+  try {
+    const output = execFileSync('where.exe', [CODEX_BIN], {
+      encoding: 'utf8',
+      stdio: ['ignore', 'pipe', 'ignore'],
+    }).trim()
+
+    if (!output) {
+      return CODEX_BIN
+    }
+
+    const candidates = output
+      .split(/\r?\n/g)
+      .map((line) => line.trim())
+      .filter(Boolean)
+
+    return candidates.find((item) => /\.(cmd|bat)$/i.test(item))
+      || candidates.find((item) => /\.(exe|com)$/i.test(item))
+      || candidates[0]
+      || CODEX_BIN
+  } catch {
+    return CODEX_BIN
+  }
+}
+
+function execCodex(args = []) {
+  const resolvedCodexBin = resolveCodexBinary()
+  if (process.platform === 'win32' && /\.(cmd|bat)$/i.test(resolvedCodexBin)) {
+    return execFileSync(process.env.ComSpec || 'cmd.exe', ['/d', '/s', '/c', resolvedCodexBin, ...args], {
+      encoding: 'utf8',
+      stdio: ['ignore', 'pipe', 'pipe'],
+    })
+  }
+
+  return execFileSync(resolvedCodexBin, args, {
+    encoding: 'utf8',
+    stdio: ['ignore', 'pipe', 'pipe'],
+  })
+}
+
+function createCheck(name, status, detail) {
+  return { name, status, detail }
+}
+
+function printCheck(result) {
+  const symbol = result.status === 'pass' ? 'OK' : result.status === 'warn' ? 'WARN' : 'FAIL'
+  console.log(`[${symbol}] ${result.name}: ${result.detail}`)
+}
+
+function checkNodeVersion() {
+  const current = parseNodeVersion(process.version)
+  const matchedRange = SUPPORTED_NODE_RANGES.find((range) => (
+    current[0] < range.maxExclusiveMajor
+    && compareVersions(current, range.min) >= 0
+  ))
+
+  if (!matchedRange) {
+    return createCheck(
+      'Node.js',
+      'fail',
+      `当前 ${process.version}，支持范围是 20.19+ / 22.13+ / 24.x，推荐 Node ${RECOMMENDED_NODE_MAJOR}`
+    )
+  }
+
+  const recommendation = current[0] === RECOMMENDED_NODE_MAJOR ? '，当前就是推荐版本线' : `，推荐 Node ${RECOMMENDED_NODE_MAJOR}`
+  return createCheck('Node.js', 'pass', `当前 ${process.version}（支持 ${matchedRange.label}${recommendation}）`)
+}
+
+function checkStorageWritable() {
+  try {
+    const { promptxHomeDir, dataDir, uploadsDir, tmpDir } = resolvePromptxPaths()
+    ;[promptxHomeDir, dataDir, uploadsDir, tmpDir].forEach((targetPath) => {
+      fs.mkdirSync(targetPath, { recursive: true })
+    })
+    const probePath = path.join(tmpDir, `.doctor-${process.pid}-${Date.now()}.tmp`)
+    fs.writeFileSync(probePath, 'ok')
+    fs.rmSync(probePath, { force: true })
+    return createCheck('数据目录', 'pass', `${promptxHomeDir} 可读写`)
+  } catch (error) {
+    return createCheck('数据目录', 'fail', error.message || '无法写入 ~/.promptx')
+  }
+}
+
+function checkBuiltAssets() {
+  if (!fs.existsSync(webIndexPath)) {
+    return createCheck('前端产物', 'fail', '缺少 apps/web/dist/index.html，请先构建或确认发包内容完整')
+  }
+  return createCheck('前端产物', 'pass', '已包含前端构建产物')
+}
+
+function checkCodexVersion() {
+  try {
+    const output = execCodex(['--version']).trim()
+    const detail = output ? `${resolveCodexBinary()} -> ${output}` : `${resolveCodexBinary()} 可执行`
+    return createCheck('Codex CLI', 'pass', detail)
+  } catch (error) {
+    return createCheck(
+      'Codex CLI',
+      'fail',
+      `找不到可用 Codex。请先确认终端里可以运行 \`codex --version\`，或设置 \`CODEX_BIN\`。${error.message ? ` (${error.message})` : ''}`
+    )
+  }
+}
+
+function checkCodexFullModeFlags() {
+  try {
+    execCodex(['exec', '--dangerously-bypass-approvals-and-sandbox', '--skip-git-repo-check', '--help'])
+    return createCheck('Codex 满血参数', 'pass', '支持 PromptX 默认的满血参数')
+  } catch (error) {
+    const detail = String(error?.stderr || error?.stdout || error?.message || '').trim()
+    return createCheck(
+      'Codex 满血参数',
+      'warn',
+      detail
+        ? `当前 Codex 可能不支持 PromptX 默认启动参数：${detail.split(/\r?\n/)[0]}`
+        : '当前 Codex 可能不支持 PromptX 默认启动参数'
+    )
+  }
+}
+
+async function isPortOccupied(host, port) {
+  return new Promise((resolve) => {
+    const server = net.createServer()
+    server.unref()
+    server.once('error', (error) => {
+      resolve(error?.code === 'EADDRINUSE')
+    })
+    server.once('listening', () => {
+      server.close(() => resolve(false))
+    })
+    server.listen(port, host)
+  })
+}
+
+async function checkServicePort() {
+  const host = String(process.env.HOST || DEFAULT_HOST).trim() || DEFAULT_HOST
+  const port = Math.max(1, Number(process.env.PORT || process.env.PROMPTX_SERVER_PORT) || DEFAULT_PORT)
+  const baseUrl = `http://${host}:${port}`
+
+  try {
+    const response = await fetch(`${baseUrl}/health`)
+    if (response.ok) {
+      return createCheck('服务端口', 'pass', `${baseUrl} 已有 PromptX 服务在运行`)
+    }
+  } catch {
+    // Ignore and continue.
+  }
+
+  if (await isPortOccupied(host, port)) {
+    return createCheck('服务端口', 'warn', `${baseUrl} 端口已被其他进程占用`)
+  }
+
+  return createCheck('服务端口', 'pass', `${baseUrl} 可用`)
+}
+
+async function main() {
+  const codexVersionCheck = checkCodexVersion()
+  const checks = [
+    checkNodeVersion(),
+    checkStorageWritable(),
+    checkBuiltAssets(),
+    codexVersionCheck,
+    codexVersionCheck.status === 'pass'
+      ? checkCodexFullModeFlags()
+      : createCheck('Codex 满血参数', 'warn', '已跳过，因为 Codex CLI 当前不可用'),
+    await checkServicePort(),
+  ]
+
+  console.log('PromptX Doctor')
+  console.log('')
+  checks.forEach(printCheck)
+
+  const failCount = checks.filter((item) => item.status === 'fail').length
+  const warnCount = checks.filter((item) => item.status === 'warn').length
+
+  console.log('')
+  console.log(`[promptx] 检查完成：${checks.length - failCount - warnCount} 通过，${warnCount} 警告，${failCount} 失败`)
+
+  if (failCount > 0) {
+    process.exitCode = 1
+  }
+}
+
+main().catch((error) => {
+  console.error(`[promptx] Doctor 执行失败：${error.message || error}`)
+  process.exitCode = 1
+})

package/scripts/service.mjs

@@ -0,0 +1,308 @@
+import fs from 'node:fs'
+import path from 'node:path'
+import process from 'node:process'
+import { spawn } from 'node:child_process'
+import { setTimeout as delay } from 'node:timers/promises'
+import { fileURLToPath } from 'node:url'
+
+import { resolvePromptxPaths } from '../apps/server/src/appPaths.js'
+
+const DEFAULT_PORT = 3000
+const DEFAULT_HOST = '127.0.0.1'
+const STARTUP_TIMEOUT_MS = 15_000
+const STOP_TIMEOUT_MS = 8_000
+const POLL_INTERVAL_MS = 250
+
+const rootDir = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..')
+const webDistDir = path.join(rootDir, 'apps', 'web', 'dist')
+const webIndexPath = path.join(webDistDir, 'index.html')
+const serverEntryPath = path.join(rootDir, 'apps', 'server', 'src', 'index.js')
+
+function ensureRuntimeDir() {
+  const { promptxHomeDir } = resolvePromptxPaths()
+  const runtimeDir = path.join(promptxHomeDir, 'run')
+  fs.mkdirSync(runtimeDir, { recursive: true })
+  return runtimeDir
+}
+
+function getRuntimePaths() {
+  const runtimeDir = ensureRuntimeDir()
+  return {
+    runtimeDir,
+    pidFile: path.join(runtimeDir, 'service.pid'),
+    stateFile: path.join(runtimeDir, 'service.json'),
+    logFile: path.join(runtimeDir, 'service.log'),
+  }
+}
+
+function readJsonFile(filePath) {
+  try {
+    return JSON.parse(fs.readFileSync(filePath, 'utf8'))
+  } catch {
+    return null
+  }
+}
+
+function readPid(filePath) {
+  try {
+    const value = fs.readFileSync(filePath, 'utf8').trim()
+    const pid = Number(value)
+    return Number.isInteger(pid) && pid > 0 ? pid : 0
+  } catch {
+    return 0
+  }
+}
+
+function isProcessAlive(pid) {
+  if (!Number.isInteger(pid) || pid <= 0) {
+    return false
+  }
+
+  try {
+    process.kill(pid, 0)
+    return true
+  } catch (error) {
+    return error?.code === 'EPERM'
+  }
+}
+
+function removeRuntimeFiles() {
+  const { pidFile, stateFile } = getRuntimePaths()
+  fs.rmSync(pidFile, { force: true })
+  fs.rmSync(stateFile, { force: true })
+}
+
+function getServiceState() {
+  const { pidFile, stateFile, logFile } = getRuntimePaths()
+  const pid = readPid(pidFile)
+  const state = readJsonFile(stateFile) || {}
+
+  if (!isProcessAlive(pid)) {
+    removeRuntimeFiles()
+    return {
+      running: false,
+      pid: 0,
+      state: null,
+      logFile,
+    }
+  }
+
+  return {
+    running: true,
+    pid,
+    state,
+    logFile,
+  }
+}
+
+function getBaseUrl(host, port) {
+  return `http://${host}:${port}`
+}
+
+async function waitForHealth(baseUrl, pid) {
+  const deadline = Date.now() + STARTUP_TIMEOUT_MS
+  const healthUrl = `${baseUrl}/health`
+
+  while (Date.now() < deadline) {
+    if (!isProcessAlive(pid)) {
+      throw new Error('服务进程启动后很快退出。')
+    }
+
+    try {
+      const response = await fetch(healthUrl)
+      if (response.ok) {
+        return
+      }
+    } catch {
+      // Ignore until timeout.
+    }
+
+    await delay(POLL_INTERVAL_MS)
+  }
+
+  throw new Error('等待服务启动超时。')
+}
+
+async function checkHealth(baseUrl) {
+  try {
+    const response = await fetch(`${baseUrl}/health`)
+    return response.ok
+  } catch {
+    return false
+  }
+}
+
+function tailLog(filePath, maxLines = 30) {
+  try {
+    const lines = fs.readFileSync(filePath, 'utf8').trim().split(/\r?\n/)
+    return lines.slice(-maxLines).join('\n').trim()
+  } catch {
+    return ''
+  }
+}
+
+async function startService() {
+  if (!fs.existsSync(webIndexPath)) {
+    throw new Error('没有找到前端构建产物，请先运行 `pnpm build`。')
+  }
+
+  const existing = getServiceState()
+  if (existing.running) {
+    const host = String(existing.state?.host || DEFAULT_HOST)
+    const port = Number(existing.state?.port || DEFAULT_PORT)
+    console.log(`[promptx] 已在运行：${getBaseUrl(host, port)}（PID ${existing.pid}）`)
+    return
+  }
+
+  const { pidFile, stateFile, logFile } = getRuntimePaths()
+  const host = String(process.env.HOST || DEFAULT_HOST).trim() || DEFAULT_HOST
+  const port = Math.max(1, Number(process.env.PORT || process.env.PROMPTX_SERVER_PORT) || DEFAULT_PORT)
+  const baseUrl = getBaseUrl(host, port)
+  const startedAt = new Date().toISOString()
+
+  if (await checkHealth(baseUrl)) {
+    throw new Error(`检测到 ${baseUrl} 已有服务在运行，请先释放端口或改用其他端口。`)
+  }
+
+  const logFd = fs.openSync(logFile, 'a')
+
+  const child = spawn(process.execPath, [serverEntryPath], {
+    cwd: rootDir,
+    detached: true,
+    stdio: ['ignore', logFd, logFd],
+    env: {
+      ...process.env,
+      HOST: host,
+      PORT: String(port),
+    },
+  })
+
+  fs.closeSync(logFd)
+  child.unref()
+
+  fs.writeFileSync(pidFile, `${child.pid}\n`, 'utf8')
+  fs.writeFileSync(stateFile, JSON.stringify({
+    pid: child.pid,
+    host,
+    port,
+    startedAt,
+    logFile,
+  }, null, 2))
+
+  try {
+    await waitForHealth(baseUrl, child.pid)
+    await delay(300)
+    if (!isProcessAlive(child.pid)) {
+      throw new Error(`服务进程已退出，通常是端口 ${port} 被占用或启动参数冲突。`)
+    }
+  } catch (error) {
+    if (isProcessAlive(child.pid)) {
+      try {
+        process.kill(child.pid, 'SIGTERM')
+      } catch {
+        // Ignore shutdown failure.
+      }
+    }
+
+    removeRuntimeFiles()
+    const recentLog = tailLog(logFile)
+    throw new Error([
+      error.message || '服务启动失败。',
+      recentLog ? `最近日志：\n${recentLog}` : '',
+    ].filter(Boolean).join('\n\n'))
+  }
+
+  console.log(`[promptx] 已后台启动：${baseUrl}`)
+  console.log(`[promptx] 日志文件：${logFile}`)
+}
+
+async function stopService() {
+  const current = getServiceState()
+  if (!current.running) {
+    console.log('[promptx] 当前没有运行中的服务。')
+    return
+  }
+
+  const pid = current.pid
+
+  try {
+    process.kill(pid, 'SIGTERM')
+  } catch (error) {
+    if (error?.code !== 'ESRCH') {
+      throw error
+    }
+  }
+
+  const deadline = Date.now() + STOP_TIMEOUT_MS
+  while (Date.now() < deadline) {
+    if (!isProcessAlive(pid)) {
+      removeRuntimeFiles()
+      console.log(`[promptx] 已停止服务（PID ${pid}）。`)
+      return
+    }
+    await delay(POLL_INTERVAL_MS)
+  }
+
+  try {
+    process.kill(pid, 'SIGKILL')
+  } catch {
+    // Ignore when process already exited.
+  }
+
+  removeRuntimeFiles()
+  console.log(`[promptx] 已强制停止服务（PID ${pid}）。`)
+}
+
+async function restartService() {
+  await stopService()
+  await startService()
+}
+
+function printStatus() {
+  const current = getServiceState()
+  if (!current.running) {
+    console.log('[promptx] 服务未运行。')
+    return
+  }
+
+  const host = String(current.state?.host || DEFAULT_HOST)
+  const port = Number(current.state?.port || DEFAULT_PORT)
+  const startedAt = current.state?.startedAt || ''
+  console.log(`[promptx] 运行中：${getBaseUrl(host, port)}`)
+  console.log(`[promptx] PID：${current.pid}`)
+  if (startedAt) {
+    console.log(`[promptx] 启动时间：${startedAt}`)
+  }
+  console.log(`[promptx] 日志文件：${current.logFile}`)
+}
+
+async function main() {
+  const command = String(process.argv[2] || 'status').trim()
+
+  if (command === 'start') {
+    await startService()
+    return
+  }
+
+  if (command === 'stop') {
+    await stopService()
+    return
+  }
+
+  if (command === 'status') {
+    printStatus()
+    return
+  }
+
+  if (command === 'restart') {
+    await restartService()
+    return
+  }
+
+  throw new Error(`不支持的命令：${command}`)
+}
+
+main().catch((error) => {
+  console.error(`[promptx] ${error.message || error}`)
+  process.exitCode = 1
+})