create-dwy 0.1.0

package/bin/index.js

@@ -0,0 +1,31 @@
+#!/usr/bin/env node
+
+import { program } from 'commander'
+import { createProject } from '../src/create.js'
+import { syncClaude, syncProjectClaude } from '../src/sync.js'
+
+program
+  .name('dwy')
+  .description('Project scaffolding and Claude Code config sync')
+  .version('0.1.0')
+
+program
+  .command('create [name]')
+  .description('Create a new project from template')
+  .action(createProject)
+
+program
+  .command('sync <target>')
+  .description('Sync configuration (claude | project-claude)')
+  .action(async (target) => {
+    if (target === 'claude') {
+      await syncClaude()
+    } else if (target === 'project-claude') {
+      await syncProjectClaude()
+    } else {
+      console.error(`Unknown sync target: ${target}. Use "claude" or "project-claude".`)
+      process.exit(1)
+    }
+  })
+
+program.parse()

package/package.json

@@ -0,0 +1,29 @@
+{
+  "name": "create-dwy",
+  "version": "0.1.0",
+  "description": "Project scaffolding and Claude Code config sync CLI",
+  "type": "module",
+  "bin": {
+    "dwy": "./bin/index.js"
+  },
+  "files": [
+    "bin",
+    "src",
+    "templates"
+  ],
+  "keywords": ["cli", "scaffold", "fastapi", "vue"],
+  "license": "MIT",
+  "author": "danweiyuan",
+  "dependencies": {
+    "commander": "^12.0.0",
+    "inquirer": "^9.0.0",
+    "handlebars": "^4.7.0",
+    "fs-extra": "^11.0.0",
+    "chalk": "^5.0.0",
+    "simple-git": "^3.0.0"
+  },
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org/",
+    "access": "public"
+  }
+}

package/src/create.js

@@ -0,0 +1,93 @@
+import fs from 'fs-extra'
+import path from 'path'
+import inquirer from 'inquirer'
+import { renderTemplate, chalk, PACKAGE_ROOT } from './utils.js'
+
+export async function createProject(name) {
+  console.log(chalk.blue('Creating a new project...\n'))
+
+  const answers = await inquirer.prompt([
+    {
+      type: 'input',
+      name: 'projectName',
+      message: '项目名称:',
+      default: name || 'my-app',
+      validate: (v) => /^[a-z0-9-]+$/.test(v) || '只允许小写字母、数字和连字符',
+    },
+    {
+      type: 'input',
+      name: 'projectDescription',
+      message: '项目描述:',
+      default: '',
+    },
+    {
+      type: 'list',
+      name: 'template',
+      message: '选择项目模板:',
+      choices: [
+        { name: 'web     — Vue + FastAPI', value: 'web' },
+        { name: 'mobile  — 移动端 + FastAPI (预留)', value: 'mobile', disabled: '即将推出' },
+        { name: 'backend — 纯 FastAPI 服务 (预留)', value: 'backend', disabled: '即将推出' },
+      ],
+    },
+    {
+      type: 'confirm',
+      name: 'includeDolphindb',
+      message: '需要 DolphinDB 吗?',
+      default: false,
+    },
+    {
+      type: 'input',
+      name: 'sshAlias',
+      message: 'SSH 部署别名:',
+      default: (a) => `${a.projectName}-server`,
+    },
+    {
+      type: 'input',
+      name: 'devDbPort',
+      message: '本地开发 DB 端口:',
+      default: '5432',
+    },
+    {
+      type: 'input',
+      name: 'devRedisPort',
+      message: '本地开发 Redis 端口:',
+      default: '6379',
+    },
+    {
+      type: 'input',
+      name: 'backendPort',
+      message: '生产 Backend 端口:',
+      default: '8001',
+    },
+  ])
+
+  const context = {
+    ...answers,
+    dbName: answers.projectName.replace(/-/g, '_'),
+    dbUser: answers.projectName.replace(/-/g, '_'),
+    year: new Date().getFullYear(),
+    createdAt: new Date().toISOString().split('T')[0],
+    dwyVersion: '0.1.0',
+  }
+
+  const templateDir = path.join(PACKAGE_ROOT, 'templates', 'project', context.template)
+  const destDir = path.resolve(process.cwd(), context.projectName)
+
+  if (await fs.pathExists(destDir)) {
+    console.error(chalk.red(`Error: directory "${context.projectName}" already exists.`))
+    process.exit(1)
+  }
+
+  console.log(chalk.gray(`\nGenerating project in ${destDir}...`))
+  await fs.ensureDir(destDir)
+  await renderTemplate(templateDir, destDir, context)
+
+  console.log(chalk.green(`\n✅ 项目 ${context.projectName} 创建成功!\n`))
+  console.log(chalk.gray('Next steps:'))
+  console.log(chalk.gray(`  cd ${context.projectName}`))
+  console.log(chalk.gray('  git init && git add . && git commit -m "init"'))
+  console.log(chalk.gray('  docker compose -f docker-compose.dev.yml up -d'))
+  console.log(chalk.gray('  cd backend && uv venv && uv pip install -e ".[dev]"'))
+  console.log(chalk.gray('  cd frontend && pnpm install && pnpm dev'))
+}

package/src/sync.js

@@ -0,0 +1,75 @@
+import fs from 'fs-extra'
+import path from 'path'
+import { ensureRepoCache, copyDir, chalk } from './utils.js'
+
+export async function syncClaude() {
+  console.log(chalk.blue('Syncing global Claude configuration...'))
+
+  const repoDir = await ensureRepoCache()
+  const sourceDir = path.join(repoDir, 'templates', 'claude-global')
+  const targetDir = path.join(process.env.HOME, '.claude')
+
+  if (!await fs.pathExists(sourceDir)) {
+    console.error(chalk.red('Error: claude-global templates not found in repo'))
+    process.exit(1)
+  }
+
+  const subdirs = ['rules', 'skills', 'commands', 'hooks']
+  let syncedCount = 0
+
+  for (const subdir of subdirs) {
+    const src = path.join(sourceDir, subdir)
+    if (await fs.pathExists(src)) {
+      const dest = path.join(targetDir, subdir)
+      await copyDir(src, dest)
+      const files = await fs.readdir(src).catch(() => [])
+      syncedCount += files.length
+      console.log(chalk.green(`  ✓ ${subdir}/ — ${files.length} files`))
+    }
+  }
+
+  const settingsSrc = path.join(sourceDir, 'settings.json')
+  if (await fs.pathExists(settingsSrc)) {
+    const settingsDest = path.join(targetDir, 'settings.json')
+    const newSettings = await fs.readJson(settingsSrc)
+
+    if (await fs.pathExists(settingsDest)) {
+      const existing = await fs.readJson(settingsDest)
+      const merged = { ...existing, ...newSettings }
+      await fs.writeJson(settingsDest, merged, { spaces: 2 })
+      console.log(chalk.green('  ✓ settings.json — merged'))
+    } else {
+      await fs.writeJson(settingsDest, newSettings, { spaces: 2 })
+      console.log(chalk.green('  ✓ settings.json — created'))
+    }
+    syncedCount++
+  }
+
+  console.log(chalk.blue(`\nDone! Synced ${syncedCount} items to ~/.claude/`))
+}
+
+export async function syncProjectClaude() {
+  console.log(chalk.blue('Syncing project Claude configuration...'))
+
+  const dwyFile = path.join(process.cwd(), '.dwy')
+  if (!await fs.pathExists(dwyFile)) {
+    console.error(chalk.red('Error: .dwy marker file not found. Is this a dwy project?'))
+    console.error(chalk.gray('Run "dwy create" to create a new project, or create .dwy manually.'))
+    process.exit(1)
+  }
+
+  const marker = await fs.readJson(dwyFile)
+  const template = marker.template || 'web'
+
+  const repoDir = await ensureRepoCache()
+  const sourceDir = path.join(repoDir, 'templates', 'project', template, '.claude')
+  const targetDir = path.join(process.cwd(), '.claude')
+
+  if (!await fs.pathExists(sourceDir)) {
+    console.error(chalk.red(`Error: template "${template}" not found in repo`))
+    process.exit(1)
+  }
+
+  await copyDir(sourceDir, targetDir)
+  console.log(chalk.blue('Done! Synced .claude/ for current project.'))
+}

package/src/utils.js

@@ -0,0 +1,61 @@
+import fs from 'fs-extra'
+import path from 'path'
+import Handlebars from 'handlebars'
+import { simpleGit } from 'simple-git'
+import chalk from 'chalk'
+import { fileURLToPath } from 'url'
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url))
+
+export const PACKAGE_ROOT = path.resolve(__dirname, '..')
+export const CACHE_DIR = path.join(process.env.HOME, '.dwy', 'cache')
+export const DWY_REPO_URL = 'https://gitee.com/snailyuanyuan/dwy-cli.git'
+
+export async function ensureRepoCache() {
+  await fs.ensureDir(CACHE_DIR)
+  const repoDir = path.join(CACHE_DIR, 'dwy')
+
+  if (await fs.pathExists(path.join(repoDir, '.git'))) {
+    console.log(chalk.gray('Pulling latest templates...'))
+    const git = simpleGit(repoDir)
+    await git.pull()
+  } else {
+    console.log(chalk.gray('Cloning template repo...'))
+    await simpleGit().clone(DWY_REPO_URL, repoDir)
+  }
+
+  return repoDir
+}
+
+export async function renderTemplate(templateDir, destDir, context) {
+  const entries = await fs.readdir(templateDir, { withFileTypes: true })
+
+  for (const entry of entries) {
+    const srcPath = path.join(templateDir, entry.name)
+    let destName = entry.name
+
+    if (entry.isDirectory()) {
+      const destPath = path.join(destDir, destName)
+      await fs.ensureDir(destPath)
+      await renderTemplate(srcPath, destPath, context)
+      continue
+    }
+
+    if (destName.endsWith('.hbs')) {
+      destName = destName.slice(0, -4)
+      const template = await fs.readFile(srcPath, 'utf-8')
+      const rendered = Handlebars.compile(template)(context)
+      await fs.writeFile(path.join(destDir, destName), rendered)
+    } else if (destName === '.gitkeep') {
+      continue
+    } else {
+      await fs.copy(srcPath, path.join(destDir, destName))
+    }
+  }
+}
+
+export async function copyDir(src, dest) {
+  await fs.copy(src, dest, { overwrite: true })
+}
+
+export { chalk }

package/templates/claude-global/rules/git-security.md

@@ -0,0 +1,144 @@
+---
+name: git-security
+description: Git 提交安全规则
+type: claude-rule
+tags: [security, git]
+version: 1.0.0
+author: chances
+---
+
+# Git 提交安全规则
+
+每次执行 `git add` 或 `git commit` 前必须遵循以下规则。违反时必须**立即停止并提示用户确认**。
+
+## 一、禁止提交的文件
+
+### 绝对禁止（无论任何理由）
+以下文件**永远不得**被 `git add`：
+
+| 文件类型 | 示例 |
+|---|---|
+| 环境变量文件 | `.env`、`.env.local`、`.env.production`、`*.env` |
+| SSH 密钥 | `id_rsa`、`id_ed25519`、`*.pem`、`*.key` |
+| 证书文件 | `*.p12`、`*.pfx`、`*.jks`、`*.keystore` |
+| 数据库文件 | `*.sql`（含真实数据的）、`*.dump`、`*.sqlite` |
+| 原始数据 | `*.xlsx`、`*.csv`（含用户/学生等敏感数据的） |
+| 日志文件 | `*.log` |
+| Docker 卷数据 | `pgdata/`、`cache/*.json` |
+
+### 检测方法
+在执行 `git add` 前，检查暂存区是否包含上述文件：
+```bash
+git diff --cached --name-only | grep -iE '\.(env|pem|key|p12|pfx|jks|dump|sqlite|log)$'
+```
+
+## 二、禁止提交的内容
+
+### 总则：所有示例必须使用假值
+**禁止在代码、文档、规则文件、注释中出现任何真实的 API Key、Token、密码、IP 地址等敏感信息，即使是作为"示例"也不允许。** 所有示例必须使用明显的假值/脱敏值（如 `sk-xxxxxxxxxxxx`、`your-key-here`、`192.168.x.x`）。GitHub Secret Scanning 不区分上下文，真实格式的 key 即使写在文档示例中也会触发泄露告警。
+
+### 必须扫描的敏感模式
+对每个将要提交的文件内容，检查是否包含以下模式：
+
+| 类型 | 匹配模式 | 示例（均为假值） |
+|---|---|---|
+| API Key | `sk-[a-zA-Z0-9]{20,}` | `sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxx` |
+| AWS Key | `AKIA[0-9A-Z]{16}` | `AKIAIOSFODNN7EXAMPLE` |
+| 密码赋值 | `password\s*[:=]\s*["'][^"']{4,}` | `password = "abc123"` |
+| 数据库连接串 | `://\w+:[^@\s]+@` | `postgresql://user:pass@host` |
+| 私钥内容 | `-----BEGIN (RSA |EC )?PRIVATE KEY-----` | PEM 私钥 |
+| Token | `token\s*[:=]\s*["'][a-zA-Z0-9_\-]{20,}` | `token = "ghp_xxxx"` |
+| Secret | `secret\s*[:=]\s*["'][^"']{8,}` | `secret = "my-secret"` |
+| 服务器 IP+端口 | `\d{1,3}\.\d{1,3}\.\d{1,3}\.\d{1,3}:\d+` | `192.168.1.1:8080` |
+| SSH 连接 | `ssh\s+.*@\d{1,3}\.\d{1,3}` | `ssh user@192.168.1.1` |
+
+### 例外：允许的模式
+以下情况**不算**违规：
+- `.env.example` 中的占位符（如 `DEEPSEEK_API_KEY=your-key-here`）
+- 代码中从环境变量读取的引用（如 `os.getenv("API_KEY")`）
+- `localhost` 或 `127.0.0.1` 的连接串
+- 文档中的示例/假数据（如 `sk-xxxxxxxxxxxx`）
+- 配置文件中的空字符串默认值（如 `api_key: str = ""`）
+
+## 三、提交前检查流程
+
+每次 `git commit` 前必须执行：
+
+```
+1. 检查暂存文件列表 → 是否包含禁止文件类型？
+2. 检查文件内容差异 → 是否包含敏感模式？
+3. 检查 .gitignore → 是否已排除敏感目录？
+4. 通过 → 执行提交
+5. 未通过 → 停止，提示用户具体违规项
+```
+
+### 自动检查命令
+```bash
+# 检查暂存区的敏感文件
+git diff --cached --name-only | grep -iE '\.(env|pem|key|log|dump|sqlite)$'
+
+# 检查暂存区内容中的敏感信息
+git diff --cached -U0 | grep -iE '(sk-[a-zA-Z0-9]{20}|AKIA[0-9A-Z]{16}|-----BEGIN.*PRIVATE KEY|password\s*[:=]\s*"[^"]{4,}"|://\w+:[^@\s]+@[^l])'
+```
+
+## 四、.gitignore 最低要求
+
+每个项目的 `.gitignore` 必须至少包含：
+
+```gitignore
+# 环境变量
+.env
+*.env
+.env.*
+
+# 密钥
+*.pem
+*.key
+*.p12
+
+# 缓存与编译
+__pycache__/
+*.pyc
+node_modules/
+dist/
+
+# 日志
+*.log
+
+# 数据库
+*.sqlite
+*.dump
+```
+
+如果项目的 `.gitignore` 缺少以上条目，提交前必须先补全。
+
+## 五、已提交敏感数据的处理
+
+如果发现敏感数据已存在于 git 历史中：
+
+1. **立即通知用户**，说明哪些数据已泄露
+2. **建议轮换凭证**（API Key、密码等）
+3. **提供清理命令**（但不自动执行，等用户确认）：
+```bash
+# 从所有历史中删除文件
+git filter-repo --path <file> --invert-paths --force
+
+# 或使用 BFG
+bfg --delete-files <filename>
+```
+
+## 六、违规处理流程
+
+当检测到提交操作包含敏感数据时：
+
+1. **立即停止** `git add` 或 `git commit`
+2. **列出具体违规项**：
+   - 文件名和行号
+   - 匹配到的敏感模式类型
+   - 敏感内容的部分摘要（如 `sk-5522****dc3`，脱敏显示）
+3. **提供建议**：
+   - 将文件加入 `.gitignore`
+   - 将敏感值移到 `.env`
+   - 使用环境变量替代硬编码
+4. **等待用户明确确认**后才能继续
+5. 如用户确认提交，添加注释：`# GIT-SECURITY: 用户已确认提交此内容`