refactor: 将 paths 从 secrets.json 分离至 config.json

Author: i-stack

.gitignore

@@ -1,9 +1,10 @@
 .DS_Store
 
-# env/: only secrets.json is gitignored.
+# env/: secrets.json (keys/tokens/urls) and config.json (path overrides) are gitignored.
 # env/mcp/*.json and env/platforms/*.json are committed (use ${VAR} references, no real secrets).
-# User only needs to create env/secrets.json from env/secrets.json.example.
+# User creates env/secrets.json and (optionally) env/config.json from their .example templates.
 env/secrets.json
+env/config.json
 env/backup.json
 # 可选 MCP 启用状态（本机本地状态，不提交；脚本缺失时自动重建为 {}）
 env/optional_mcps/enabled.json

README.md

@@ -19,8 +19,10 @@
 git clone https://github.com/i-stack/ai-coding-kit.git
 cd ai-coding-kit
 
-# 唯一需要编辑的文件
-cp env/secrets.json.example env/secrets.json
+# 初始化本地配置（从 env/*.example 模板创建缺失文件，幂等）
+bash install.sh
+
+# 唯一需要编辑的文件：填入真实 API Keys / Tokens
 $EDITOR env/secrets.json
 
 # 一键同步

env/README.md

@@ -6,8 +6,10 @@
 
 ```text
 env/
-├── secrets.json              ← 你唯一需要填写的文件（gitignored）
+├── secrets.json              ← 密钥配置：key/token/url（gitignored）
 ├── secrets.json.example      ← 模板（已提交）
+├── config.json              ← 非密钥配置：安装根/路径覆盖（gitignored，可选）
+├── config.json.example      ← 模板（已提交）
 │
 ├── review.json               ← auto-code-review 配置（gitignored）
 ├── review.json.example       ← review 配置模板（已提交）
@@ -26,9 +28,7 @@ env/
 │   ├── shell.json
 │   ├── xcodebuild.json
 │   ├── lanhu.json
-│   ├── moonvy.json
-│   ├── postgres.json
-│   └── sqlite.json
+│   └── moonvy.json
 │
 ├── optional_mcps/            ← 可选 MCP 服务器（需手动启用）
 │   ├── enabled.json          ← 启用状态记录
@@ -88,7 +88,7 @@ env/
 
 **加载优先级**：`env/review.json` → `.auto-review-config.json` → `AUTO_REVIEW_*` 环境变量。
 
-复制 `review.json.example` 为 `review.json` 后填写即可。仅在用户显式启动 `/auto-review` 后加载。
+复制 `review.json.example` 为 `review.json` 后填写即可（`bash install.sh` 会一并从模板创建，无需手动 cp）。仅在用户显式启动 `/auto-review` 后加载。
 
 ## backup.json
 
@@ -111,11 +111,16 @@ env/
 跨会话用户画像用于让 Codex / Claude / Gemini 等 Agent 在不同会话中共享你的稳定偏好、角色和约束。
 
 ```bash
-cp env/user-profile.md.example env/user-profile.md
-cp env/user-profile.json.example env/user-profile.json
-bash sync.sh
+bash install.sh   # 创建 user-profile.json（enabled=auto）；user-profile.md 不自动创建
+bash sync.sh      # 同步（画像文件缺失时自动跳过）
 ```
 
+> `env/user-profile.md` 是含占位符的内容模板，`install.sh` 不会自动复制它，否则会被当成真实画像同步成假的全局用户画像。需要画像时再手动：
+>
+> ```bash
+> cp env/user-profile.md.example env/user-profile.md   # 然后填写真实信息
+> ```
+
 `env/user-profile.json`：
 
 ```json
@@ -175,7 +180,7 @@ bash sync/scripts/optional_mcps.sh disable puppeteer
 
 各平台的安装根目录默认是 `~/.codex`、`~/.claude`、`~/.gemini` 等固定位置。
 如果某工具安装在非默认路径（例如自定义前缀、便携版、或 Xcode 的 CodingAssistant 目录被移动），
-可以在 `secrets.json` 顶层增加 `paths` 对象来覆盖：
+可以在 `config.json` 顶层增加 `paths` 对象来覆盖（`bash install.sh` 会自动从 `config.json.example` 创建该文件，也可手动 `cp env/config.json.example env/config.json`）：
 
 ```json
 {
@@ -201,7 +206,7 @@ bash sync/scripts/optional_mcps.sh disable puppeteer
 - 设置后，该平台的所有派生路径（配置、settings、skills、MCP 文件等）都会基于覆盖值解析。
 - `cursor_project_roots` 是额外的 Cursor 项目根列表，用于同步项目内 `.cursor/rules/*.mdc`；也可用 `CURSOR_PROJECT_ROOTS="/path/a:/path/b"` 临时覆盖。
 - Codex 仍优先使用标准环境变量 `CODEX_HOME` / `CODEX_CONFIG`，其次才是此处覆盖。
-- `paths` 不是密钥，不会参与 `${...}` 占位符注入，仅用于路径解析。
+- `paths` 不是密钥，放在 `env/config.json`（gitignored 的本地配置），不会参与 `${...}` 占位符注入，仅用于路径解析。
 
 ## 占位符机制
 

env/config.json.example

@@ -1,16 +1,13 @@
 {
     "_comment": "=== 非密钥的本地配置（路径/安装根覆盖）=== 复制为 env/config.json。此文件不是密钥，但含你本机路径，故也 gitignore，不提交。路径覆盖之外的非密钥配置也放这里。",
     "paths": {
-        "_comment": "可选：覆盖各 AI 工具的「安装根目录」。留空字符串或删除该键即使用默认路径（~/.codex、~/.claude 等）。当工具安装在非默认位置时（例如自定义前缀），在此填写绝对或 ~/ 开头的路径，所有派生路径都会基于此处解析。",
+        "_comment": "可选：覆盖各 AI 工具的「安装根目录」。留空字符串或删除该键即使用默认路径（~/.codex、~/.claude 等）。当工具安装在非默认位置时（例如自定义前缀），在此填写绝对或 ~/ 开头的路径，所有派生路径都会基于此处解析。cursor_project_roots 留空数组 [] 表示不同步 Cursor 项目内 .cursor/rules；需要时填入如 [\"/Users/you/path/to/projA\", \"/Users/you/path/to/projB\"]。",
         "codex": "",
         "claude": "",
         "gemini": "",
         "codebuddy": "",
         "cursor": "",
-        "cursor_project_roots": [
-            "/Users/you/path/to/projA",
-            "/Users/you/path/to/projB"
-        ],
+        "cursor_project_roots": [],
         "cline": "",
         "continue": "",
         "qwen": "",

env/mcp/postgres.json

@@ -8,7 +8,6 @@
         "mcp"
     ],
     "env": {
-        "XCODEBUILDMCP_CWD": "${workspaceFolder}",
         "XCODEBUILDMCP_ENABLED_WORKFLOWS": "simulator,ui-automation,debugging,device"
     },
     "platforms": [

env/mcp/sqlite.json

@@ -1,5 +1,5 @@
 {
-    "_comment": "=== 用户唯一需要配置的文件 === 复制为 env/secrets.json，每个平台填入你的 key/token 和 url。然后运行 bash sync.sh。",
+    "_comment": "=== 密钥配置文件 === 复制为 env/secrets.json，每个平台填入你的 key/token 和 url（路径/安装根覆盖请放入 env/config.json）。然后运行 bash sync.sh。",
     "github": {
         "token": "ghp_your-github-personal-access-token"
     },
@@ -30,30 +30,8 @@
         "url": "",
         "key": "sk-your-cline-gemini-api-key"
     },
-    "postgres": {
-        "connection_string": "postgresql://user:password@localhost:5432/your_database"
-    },
-    "sqlite": {
-        "db_path": "./data/your_database.sqlite"
-    },
     "qwen": {
         "url": "https://dashscope.aliyuncs.com/compatible-mode/v1",
         "dashscopeApiKey": "sk-your-qwen-api-key"
-    },
-    "paths": {
-        "_comment": "可选：覆盖各 AI 工具的「安装根目录」。留空字符串或删除该键即使用默认路径（~/.codex、~/.claude 等）。当工具安装在非默认位置时（例如自定义前缀），在此填写绝对或 ~/ 开头的路径，所有派生路径都会基于此处解析。",
-        "codex": "",
-        "claude": "",
-        "gemini": "",
-        "codebuddy": "",
-        "cursor": "",
-        "cursor_project_roots": [
-            "/Users/you/path/to/projA",
-            "/Users/you/path/to/projB"
-        ],
-        "cline": "",
-        "continue": "",
-        "qwen": "",
-        "xcode_coding_assistant": ""
     }
 }

env/mcp/xcodebuild.json

@@ -3,8 +3,11 @@
 # ai-coding-kit 初始化脚本
 #
 # clone 项目后运行一次，完成本地配置初始化：
-#   - 从 env/*.example 模板复制出缺失的本地配置文件
+#   - 从 env/*.example 模板复制出缺失的本地配置（config/backup/review/secrets/user-profile.json）
 #     （幂等：目标已存在则跳过，绝不覆盖你已填好的真实配置）
+#   - 不自动创建 user-profile.md：它是含占位符的「内容模板」，若自动复制会被
+#     sync-user-profile.sh 当成真实画像同步成假的全局用户画像。需要画像时再手动
+#     cp env/user-profile.md.example env/user-profile.md 并填写。
 #   - 提醒填写 env/secrets.json 中的真实 API Keys / Tokens
 #
 # 用法:
@@ -32,6 +35,10 @@ shopt -s nullglob
 created=0
 for src in "$ENV_DIR"/*.example; do
   dst="${src%.example}"
+  # user-profile.md 是含占位符的内容模板，不自动创建（避免假画像被同步）
+  if [[ "$src" == */user-profile.md.example ]]; then
+    continue
+  fi
   if [ ! -e "$dst" ]; then
     cp "$src" "$dst"
     echo_ok "已创建 ${dst#$SCRIPT_DIR/}"

env/secrets.json.example

@@ -213,9 +213,9 @@ SYNC_CLAUDE=0 SYNC_CODEX=0 SYNC_CURSOR=0 SYNC_XCODE_CODEX=0 SYNC_XCODE_CLAUDE=1
 CURSOR_PROJECT_ROOTS="/path/to/appA:/path/to/appB" ./scripts/sync-agent-preamble.sh
 ```
 
-也可以把外部 Cursor 项目根写进 `env/secrets.json` 的 `paths.cursor_project_roots`。命令行传入的 `CURSOR_PROJECT_ROOTS` 仍然优先，适合一次性覆盖。
+也可以把外部 Cursor 项目根写进 `env/config.json` 的 `paths.cursor_project_roots`。命令行传入的 `CURSOR_PROJECT_ROOTS` 仍然优先，适合一次性覆盖。
 
-Claude / Codex 两端同样遵循 `SYNC_CLAUDE` / `SYNC_CODEX` 门控语义（`1 / 0 / 留空自动探测`）；Cursor 项目规则由 `env/secrets.json` 的 `paths.cursor_project_roots` 或临时 `CURSOR_PROJECT_ROOTS` 决定，不复用 `SYNC_CURSOR`。
+Claude / Codex 两端同样遵循 `SYNC_CLAUDE` / `SYNC_CODEX` 门控语义（`1 / 0 / 留空自动探测`）；Cursor 项目规则由 `env/config.json` 的 `paths.cursor_project_roots` 或临时 `CURSOR_PROJECT_ROOTS` 决定，不复用 `SYNC_CURSOR`。
 Xcode Codex / Claude 侧分别遵循 `SYNC_XCODE_CODEX` / `SYNC_XCODE_CLAUDE` 门控语义（`1 / 0 / 留空自动探测`），默认写入 `codex/AGENTS.md` 与 `ClaudeAgentConfig/CLAUDE.md`。
 
 脚本只重写 `<!-- managed-block:agent-preamble:begin ... :end -->` 托管块（并兼容迁移旧的 `ios-engineer` 托管块标记），保留文件中的其他内容。
@@ -252,7 +252,7 @@ curl -fsSL https://raw.githubusercontent.com/i-stack/ai-coding-kit/main/skills-e
 - `SKIP_PREAMBLE=true`：跳过 `sync-agent-preamble.sh`
 - `SKIP_USER_PROFILE=true`：跳过 `sync-user-profile.sh`（跨会话用户画像）
 - `SKIP_MEMORY=true`：跳过 `sync-memory.sh`（跨会话事件记忆）
-- `CURSOR_PROJECT_ROOTS`：临时覆盖 `env/secrets.json` 的 `paths.cursor_project_roots`，透传给 `sync-agent-preamble.sh`
+- `CURSOR_PROJECT_ROOTS`：临时覆盖 `env/config.json` 的 `paths.cursor_project_roots`，透传给 `sync-agent-preamble.sh`
 
 ### 5. 跨会话记忆（用户画像 + 事件记忆）