flu-cli-core 1.1.0 → 1.1.2

package/dist/index.cjs

@@ -11843,6 +11843,7 @@ var STARTER_SCAFFOLD_FILES = [
   ".env.staging.template",
   ".env.prod.example.template",
   ".vscode/launch.json.template",
+  ".vscode/settings.json.template",
   "analysis_options.yaml.template",
   "lib/main.dart.template",
   "lib/app.dart.template"
@@ -15062,6 +15063,7 @@ function _prepareInitAiBase(opts) {
       }
     };
   }
+  if (!(0, import_fs17.existsSync)(projectDir)) (0, import_fs17.mkdirSync)(projectDir, { recursive: true });
   const packageName = normalizeProjectIdToPackageName(opts.projectId);
   const skillSlug = slugForAgentSkill(packageName);
   const configPath = (0, import_path29.join)(projectDir, ".flu-cli.json");

package/dist/index.js

@@ -11050,6 +11050,7 @@ var STARTER_SCAFFOLD_FILES = [
   ".env.staging.template",
   ".env.prod.example.template",
   ".vscode/launch.json.template",
+  ".vscode/settings.json.template",
   "analysis_options.yaml.template",
   "lib/main.dart.template",
   "lib/app.dart.template"
@@ -14190,7 +14191,7 @@ features:
 }
 
 // src/commands/init_ai_base.ts
-import { existsSync as existsSync16, readFileSync as readFileSync10, writeFileSync as writeFileSync11 } from "fs";
+import { existsSync as existsSync16, mkdirSync as mkdirSync10, readFileSync as readFileSync10, writeFileSync as writeFileSync11 } from "fs";
 import { join as join27, resolve as resolve5 } from "path";
 var PROJECT_ID_RE = /^[a-z][a-z0-9-]{2,32}$/;
 function validateProjectId(projectId) {
@@ -14256,6 +14257,7 @@ function _prepareInitAiBase(opts) {
       }
     };
   }
+  if (!existsSync16(projectDir)) mkdirSync10(projectDir, { recursive: true });
   const packageName = normalizeProjectIdToPackageName(opts.projectId);
   const skillSlug = slugForAgentSkill(packageName);
   const configPath = join27(projectDir, ".flu-cli.json");
@@ -15372,7 +15374,7 @@ import { createRequire } from "module";
 import { createHash } from "crypto";
 
 // src/utils/config_manager.ts
-import { existsSync as existsSync19, readFileSync as readFileSync11, writeFileSync as writeFileSync12, mkdirSync as mkdirSync10 } from "fs";
+import { existsSync as existsSync19, readFileSync as readFileSync11, writeFileSync as writeFileSync12, mkdirSync as mkdirSync11 } from "fs";
 import { join as join30 } from "path";
 import { homedir as homedir2 } from "os";
 var ConfigManager = class _ConfigManager {
@@ -15382,7 +15384,7 @@ var ConfigManager = class _ConfigManager {
   constructor() {
     const configDir = join30(homedir2(), ".flu-cli");
     if (!existsSync19(configDir)) {
-      mkdirSync10(configDir, { recursive: true });
+      mkdirSync11(configDir, { recursive: true });
     }
     this.configPath = join30(configDir, "config.json");
     this.config = this.loadConfig();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "flu-cli-core",
-  "version": "1.1.0",
+  "version": "1.1.2",
   "description": "Core logic for flu-cli",
   "main": "dist/index.cjs",
   "module": "dist/index.cjs",

package/templates/starter_project/.vscode/settings.json.template

@@ -0,0 +1,14 @@
+{
+  "files.exclude": {
+    "**/.dart_tool": true,
+    "**/.fvm/flutter_sdk": true,
+    "**/.fvm/versions": true,
+    "**/.flutter-plugins": true,
+    "**/.flutter-plugins-dependencies": true,
+    "**/.idea": true,
+    "**/.metadata": true,
+    "**/*.iml": true,
+    "**/build": true,
+    "**/pubspec.lock": true
+  }
+}

package/templates/starter_project/DEVELOPER_GUIDE.md.template

@@ -54,6 +54,7 @@
 | `.env.prod.example` | 生产配置模板 |
 | `analysis_options.yaml` | Dart/Flutter 代码规范 |
 | `.vscode/launch.json` | IDE 调试入口 |
+| `.vscode/settings.json` | VSCode 工作区显示与 Flutter 相关设置 |
 
 生产环境通常这样创建：
 
@@ -75,6 +76,24 @@ cp .env.prod.example .env.prod
 | `AGREEMENT_VERSION` | 协议版本门禁，正文变化后应递增 |
 | `USER_AGREEMENT_URL` / `PRIVACY_POLICY_URL` | 在线协议链接 |
 
+### VSCode 工作区显示
+
+项目默认会在 `.vscode/settings.json` 中隐藏一批生成噪音：
+
+- `.dart_tool`
+- `.fvm/flutter_sdk`
+- `.fvm/versions`
+- `build`
+- `.metadata`
+- `.flutter-plugins*`
+- `.idea`
+- `*.iml`
+- `pubspec.lock`
+
+目标是让 Explorer 默认更聚焦业务代码，而不是把生成缓存长期堆在主视野里。
+
+如需调整，直接修改 `.vscode/settings.json` 中的 `files.exclude` 即可。当前模板默认把 `pubspec.lock` 也视为“工作区降噪项”，以换取更清爽的 Explorer；但 `android`、`ios`、`lib`、`test` 这类高频目录仍不做模板级强隐藏，避免排查平台问题或原生配置时来回切设置。
+
 ## 5. 代码规范
 
 当前 Lint 配置来自 `analysis_options.yaml`，默认跟随创建配置中的 `stack.lint`。

package/templates/starter_project/README.md.template

@@ -44,6 +44,7 @@ cp .env.prod.example .env.prod
 - `lib/core/`：路由、主题、配置、工具、协议弹框和通用能力
 - `.env.*`：环境变量与协议信息
 - `.vscode/launch.json`：IDE 调试入口
+- `.vscode/settings.json`：VSCode 工作区显示与 Flutter 相关设置
 
 ## 首页样板
 
@@ -71,6 +72,23 @@ VSCode 调试面板中可直接选择：
 - `{{projectName}} (staging)`
 - `{{projectName}} (release)`
 
+项目默认带一份 `.vscode/settings.json`，会隐藏 `.dart_tool`、`build`、`.metadata`、FVM SDK 缓存和 `pubspec.lock` 等生成噪音，让工作区更聚焦业务代码。
+
+如果你希望调整显示范围，可以直接修改：
+
+```json
+{
+  "files.exclude": {
+    "**/.dart_tool": true,
+    "**/build": true
+  }
+}
+```
+
+建议默认只隐藏生成目录和明显缓存项，不要直接把 `android`、`ios`、`lib`、`test` 这类高频目录一起隐藏成团队默认规则；这些文件或目录在排查平台问题、依赖锁定或原生配置时仍然经常需要查看。
+
+如果你的团队希望像业务实战项目那样进一步精简 Explorer，也可以继续在 `.vscode/settings.json` 里追加自己的规则；但更推荐先从“隐藏生成噪音”开始，而不是默认把常用源码目录一起藏掉。
+
 ## SDK 说明
 
 {{#if_fvm}}