@muyichengshayu/promptx 0.1.0

package/README.md

@@ -0,0 +1,80 @@
+# PromptX
+
+PromptX 是一个面向本机 AI 协作的轻量工作台。
+
+它适合先整理需求、截图、文本、PDF、禅道 Bug 等上下文，再持续发送给本机 Codex，在同一页里查看执行过程和多轮结果。
+
+## 核心能力
+
+- 左侧管理任务，中间查看项目执行过程，右侧整理输入内容
+- 支持文本、图片、`md`、`txt`、`pdf`
+- 支持为任务绑定本机项目，并持续复用同一个 Codex 线程
+- 支持查看执行过程、代码变更和最终回复
+- 支持公开页与 Raw 导出
+- 内置禅道 Chrome 扩展，可一键把 Bug 内容带入工作台
+
+## 运行前提
+
+- 已安装 Node，支持 `20`、`22`、`24`，推荐 `22`
+- 本机可以正常运行 `codex --version`
+- Codex 已开启高权限，并使用满血模式
+
+## 安装
+
+```bash
+npm install -g @muyichengshayu/promptx
+promptx doctor
+```
+
+## 启动
+
+默认地址：
+
+- `http://127.0.0.1:3000`
+
+```bash
+promptx start
+promptx status
+promptx stop
+```
+
+```bash
+promptx doctor
+```
+
+## 使用方式
+
+1. 打开工作台，新建或选择一个任务
+2. 在右侧整理文本、图片、文件等上下文
+3. 在中间选择一个 PromptX 项目
+4. 点击发送，把当前内容交给 Codex
+5. 在中间继续查看执行过程，并按需多轮发送
+
+## 禅道扩展
+
+仓库内置了禅道 Chrome 扩展：`apps/zentao-extension`
+
+1. 打开 `chrome://extensions`
+2. 开启开发者模式
+3. 点击“加载已解压的扩展程序”
+4. 选择 `apps/zentao-extension`
+
+使用时保持 PromptX 已启动，然后在禅道 Bug 详情页点击右下角 `AI修复` 即可。
+
+## 注意事项
+
+- 当前只支持 Codex，不支持其他模型后端
+- 当前以本机单用户使用为主，不包含账号体系和团队权限
+- 默认仅监听本机地址；如需跨设备访问，建议通过 Tailscale
+- 如果 Codex 运行在受限权限下，文件读写和自动修改能力会明显受限
+
+## 本地数据目录
+
+运行数据默认保存在 `~/.promptx/`，包含：
+
+```text
+data/
+uploads/
+tmp/
+run/
+```

package/apps/server/src/appPaths.js

@@ -0,0 +1,102 @@
+import fs from 'node:fs'
+import os from 'node:os'
+import path from 'node:path'
+import { fileURLToPath } from 'node:url'
+
+const serverRootDir = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..')
+const defaultPromptxHomeDir = path.join(os.homedir(), '.promptx')
+
+let preparedStorageKey = ''
+
+function directoryHasEntries(targetPath = '') {
+  try {
+    return fs.readdirSync(targetPath).length > 0
+  } catch {
+    return false
+  }
+}
+
+function moveDirectoryContents(sourceDir, targetDir) {
+  if (!fs.existsSync(sourceDir) || !directoryHasEntries(sourceDir)) {
+    return false
+  }
+
+  if (fs.existsSync(targetDir) && directoryHasEntries(targetDir)) {
+    return false
+  }
+
+  fs.mkdirSync(path.dirname(targetDir), { recursive: true })
+
+  try {
+    fs.renameSync(sourceDir, targetDir)
+    return true
+  } catch (error) {
+    if (error?.code !== 'EXDEV') {
+      throw error
+    }
+  }
+
+  fs.mkdirSync(targetDir, { recursive: true })
+  fs.cpSync(sourceDir, targetDir, { recursive: true })
+  fs.rmSync(sourceDir, { recursive: true, force: true })
+  return true
+}
+
+function resolvePromptxPaths() {
+  const promptxHomeDir = process.env.PROMPTX_HOME
+    ? path.resolve(process.env.PROMPTX_HOME)
+    : defaultPromptxHomeDir
+
+  const dataDir = process.env.PROMPTX_DATA_DIR
+    ? path.resolve(process.env.PROMPTX_DATA_DIR)
+    : path.join(promptxHomeDir, 'data')
+
+  const uploadsDir = process.env.PROMPTX_UPLOADS_DIR
+    ? path.resolve(process.env.PROMPTX_UPLOADS_DIR)
+    : path.join(promptxHomeDir, 'uploads')
+
+  const tmpDir = process.env.PROMPTX_TMP_DIR
+    ? path.resolve(process.env.PROMPTX_TMP_DIR)
+    : path.join(promptxHomeDir, 'tmp')
+
+  return { promptxHomeDir, dataDir, uploadsDir, tmpDir }
+}
+
+export function ensurePromptxStorageReady() {
+  const resolved = resolvePromptxPaths()
+  const storageKey = JSON.stringify(resolved)
+
+  if (preparedStorageKey === storageKey) {
+    return resolved
+  }
+
+  fs.mkdirSync(resolved.promptxHomeDir, { recursive: true })
+
+  const migrationPlans = [
+    process.env.PROMPTX_DATA_DIR
+      ? null
+      : { source: path.join(serverRootDir, 'data'), target: resolved.dataDir },
+    process.env.PROMPTX_UPLOADS_DIR
+      ? null
+      : { source: path.join(serverRootDir, 'uploads'), target: resolved.uploadsDir },
+    process.env.PROMPTX_TMP_DIR
+      ? null
+      : { source: path.join(serverRootDir, 'tmp'), target: resolved.tmpDir },
+  ].filter(Boolean)
+
+  migrationPlans.forEach(({ source, target }) => {
+    moveDirectoryContents(source, target)
+  })
+
+  fs.mkdirSync(resolved.dataDir, { recursive: true })
+  fs.mkdirSync(resolved.uploadsDir, { recursive: true })
+  fs.mkdirSync(resolved.tmpDir, { recursive: true })
+
+  preparedStorageKey = storageKey
+  return resolved
+}
+
+export {
+  serverRootDir,
+  resolvePromptxPaths,
+}