shipfolio 1.0.10 → 1.1.0

package/README.md

@@ -40,14 +40,16 @@ No need to install `wrangler` or `vercel` CLI -- shipfolio calls them via `npx`
 ```bash
 npx shipfolio --scan ~/Projects
 npx shipfolio --scan ~/Projects --output ./my-site
+npx shipfolio --scan ~/Projects --engine claude --deploy cloudflare --style dark-minimal --accent '#10b981'
+npx shipfolio --scan ~/Projects --auto --no-pdf
 npx shipfolio --scan ~/Projects --no-pdf --no-preview
 ```
 
 The pipeline:
 1. Scans directories for git repos (and non-git projects with package.json, Cargo.toml, etc.)
-2. Interactive interview: select projects, optionally merge related ones (e.g. web + mobile), enter personal info, pick theme/colors/font
+2. Interactive interview: select projects, optionally merge related ones (e.g. web + mobile), enter personal info, pick theme/colors/font, and optionally enrich key projects with case-study details
 3. Generates the site using your local AI engine
-4. Builds, exports PDF, previews locally
+4. Builds, previews locally, exports PDF
 5. Deploys to Cloudflare Pages or Vercel
 6. Optionally creates a GitHub repo with a CI/CD workflow for auto-deploy on push
 
@@ -98,6 +100,11 @@ npx shipfolio preview --site ./shipfolio-site --port 3000
 | Flag | Description | Default |
 |---|---|---|
 | `-s, --scan <dirs...>` | Directories to scan for projects | Current directory |
+| `-e, --engine <name>` | `claude`, `codex`, or `v0` | Auto-detect |
+| `-d, --deploy <platform>` | `cloudflare`, `vercel`, or `local` | Prompted |
+| `--style <theme>` | `dark-minimal`, `light-clean`, `monochrome`, or `custom` | Prompted |
+| `--accent <hex>` | Accent color like `#10b981` | Prompted |
+| `--auto` | Use safe defaults and skip prompts | `false` |
 | `-o, --output <dir>` | Output directory | `./shipfolio-site` |
 | `--no-pdf` | Skip PDF export | |
 | `--no-preview` | Skip local preview | |
@@ -144,7 +151,11 @@ npx shipfolio preview --site ./shipfolio-site --port 3000
 
 ### Project Merging
 
-When you have related projects (e.g. a web app and its mobile companion), shipfolio lets you merge them into a single portfolio entry. Tech stacks, commit histories, and READMEs are combined automatically.
+When you have related projects (e.g. a web app and its mobile companion), shipfolio lets you merge them into a single portfolio entry. Tech stacks, commit histories, and READMEs are combined automatically, and update detection now tracks every merged project path instead of only the first one.
+
+### Featured Projects And Case Studies
+
+You can mark projects as featured and optionally add richer case-study inputs such as audience, problem, solution, impact, evidence, and screenshot URLs. These fields are passed directly into the generation prompt so the resulting site can emphasize your strongest work instead of flattening every project into the same card style.
 
 ### Draft Recovery
 
@@ -243,14 +254,16 @@ npx shipfolio --scan ~/Projects
 ```bash
 npx shipfolio --scan ~/Projects
 npx shipfolio --scan ~/Projects --output ./my-site
+npx shipfolio --scan ~/Projects --engine claude --deploy cloudflare --style dark-minimal --accent '#10b981'
+npx shipfolio --scan ~/Projects --auto --no-pdf
 npx shipfolio --scan ~/Projects --no-pdf --no-preview
 ```
 
 流程:
 1. 扫描目录中的 git 仓库（也支持没有 git 但有 package.json、Cargo.toml 等的项目）
-2. 交互式问答：选择项目、可选合并相关项目（如 web + mobile）、填写个人信息、选择主题/颜色/字体
+2. 交互式问答：选择项目、可选合并相关项目（如 web + mobile）、填写个人信息、选择主题/颜色/字体，并可为重点项目补充更完整的案例信息
 3. 调用本地 AI 引擎生成网站
-4. 构建、导出 PDF、本地预览
+4. 构建、本地预览、导出 PDF
 5. 部署到 Cloudflare Pages 或 Vercel
 6. 可选创建 GitHub 仓库并配置 CI/CD workflow，实现 push 自动部署
 
@@ -301,6 +314,11 @@ npx shipfolio preview --site ./shipfolio-site --port 3000
 | 参数 | 说明 | 默认值 |
 |---|---|---|
 | `-s, --scan <dirs...>` | 扫描目录 | 当前目录 |
+| `-e, --engine <name>` | `claude`、`codex` 或 `v0` | 自动检测 |
+| `-d, --deploy <platform>` | `cloudflare`、`vercel` 或 `local` | 交互选择 |
+| `--style <theme>` | `dark-minimal`、`light-clean`、`monochrome` 或 `custom` | 交互选择 |
+| `--accent <hex>` | 强调色，如 `#10b981` | 交互选择 |
+| `--auto` | 使用安全默认值并跳过问答 | `false` |
 | `-o, --output <dir>` | 输出目录 | `./shipfolio-site` |
 | `--no-pdf` | 跳过 PDF 导出 | |
 | `--no-preview` | 跳过本地预览 | |
@@ -347,7 +365,11 @@ npx shipfolio preview --site ./shipfolio-site --port 3000
 
 ### 项目合并
 
-当你有关联项目时（如 web 端和 mobile 端），shipfolio 支持将它们合并为一个作品集条目。技术栈、提交历史和 README 会自动合并。
+当你有关联项目时（如 web 端和 mobile 端），shipfolio 支持将它们合并为一个作品集条目。技术栈、提交历史和 README 会自动合并；更新检测也会追踪所有被合并项目的路径，不再只看第一个目录。
+
+### 重点项目与案例信息
+
+你可以把项目标记为重点项目，并可选补充 audience、problem、solution、impact、evidence、screenshot URL 等案例信息。这些结构化字段会直接进入生成 prompt，让最终网站更容易突出真正重要的作品，而不是把所有项目都做成同一种平铺卡片。
 
 ### 草稿恢复