duaer-spec 0.27.1 → 0.27.2

package/.duaer/active-job.json

@@ -1,5 +1,5 @@
 {
-  "feature": "275-release-0271",
-  "branch": "feat/release-0271",
-  "worktree": ".worktree/feat-release-0271"
+  "feature": "281-release-0272",
+  "branch": "feat/release-0272",
+  "worktree": ".worktree/feat-release-0272"
 }

package/.duaer/specs/275-release-0271/delivery.json

@@ -0,0 +1,9 @@
+{
+  "status": "accepted",
+  "summary": "0.27.1 is on main as v0.27.1, GitHub Release published, npm Trusted Publishing succeeded.",
+  "verification": {
+    "publish": "git push origin main develop v0.27.1 — fast-forward 1d6d164..26ede20",
+    "release": "https://github.com/Duaer/duaer-spec/releases/tag/v0.27.1",
+    "npm": "gh run 35558574069 success — + duaer-spec@0.27.1"
+  }
+}

package/.duaer/specs/275-release-0271/tasks.md

@@ -1,4 +1,4 @@
 # Tasks — 275-release-0271
 
 - [x] Bump 0.27.1 and move changelog notes
-- [ ] Tag v0.27.1 on main and publish the GitHub Release
+- [x] Tag v0.27.1 on main and publish the GitHub Release

package/.duaer/specs/276-fde08-perf-budget/delivery.json

@@ -0,0 +1,9 @@
+{
+  "status": "accepted",
+  "summary": "Feature confirm requires LCP, INP, bundle size, virtualized long lists, a weak-network check, and a large-data check, or a no-page-performance opt-out. A vague speed line fails. Kickoff schedules the budget before implement.",
+  "verification": {
+    "L0": "node --check bin/duaer-live.mjs bin/live-modules.mjs web/live-dev/app.js web/live-dev/perf-budget.mjs — pass",
+    "L1": "npm test — 254 pass",
+    "L3": "npm run test:live — pass"
+  }
+}

package/.duaer/specs/276-fde08-perf-budget/spec.md

@@ -0,0 +1,38 @@
+# Feature Specification: FDE-08 performance budget
+
+## Goal
+
+A feature confirm card cannot pass on a vague speed claim. It must record
+LCP, INP, bundle size, virtualized long lists, a weak-network check, and a
+large-data check. Kickoff schedules that budget before implementation.
+
+## In scope
+
+- Local validate on perfBudget
+- One FDE-08 task per confirmed module that declares page performance,
+  placed before implement and after the env probe, data precheck, and
+  external-dependency board when those exist
+- Hint, placeholder, and chat/accept prompts
+- Explicit opt-out: no page performance requirement
+
+## Out of scope
+
+- Bug desk
+- Running a customer performance lab from the desk
+
+## Assumptions
+
+- The desk records the budget; the digital employee runs the weak-network
+  and large-data checks.
+- 「本模块无页面性能要求」 / "no page performance" skips the six items
+  and the kickoff task.
+- "挺快的" and other vague speed lines fail.
+
+## Acceptance
+
+1. A vague speed line, or a line missing any of the six items, fails
+   local validate
+2. All six present, or the no-page-performance opt-out, passes
+3. Kickoff adds an FDE-08 task before implement when page performance is
+   declared, and skips it on the opt-out
+4. npm test and npm run test:live pass

package/.duaer/specs/276-fde08-perf-budget/tasks.md

@@ -0,0 +1,5 @@
+# Tasks — 276-fde08-perf-budget
+
+- [x] Validate the performance budget (LCP, INP, bundle, long list, weak network, large data, or opt-out)
+- [x] Inject an FDE-08 kickoff task before implement
+- [x] Update hints, prompts, docs, and tests

package/.duaer/specs/277-project-dir-reuse/delivery.json

@@ -0,0 +1,9 @@
+{
+  "status": "accepted",
+  "summary": "Create mode refuses when the target project directory already exists. Open from the list or browse still works. Existing folder contents are left untouched.",
+  "verification": {
+    "L0": "node --check bin/live-repo-path.mjs bin/duaer-live.mjs web/live-dev/app.js — pass",
+    "L1": "npm test — pass",
+    "L3": "npm run test:live — pass"
+  }
+}

package/.duaer/specs/277-project-dir-reuse/spec.md

@@ -0,0 +1,31 @@
+# Feature Specification: Refuse reusing an existing project directory on create
+
+## Goal
+
+Creating a new project must not reuse a directory that already exists.
+An existing folder can only be opened from the project list or by browse-open.
+
+## In scope
+
+- `/api/projects/activate` create mode refuses when the target path already exists
+- Create form sends create mode; list click opens without create
+- Clear Chinese error telling the user to rename or open the existing project
+- Unit / smoke coverage
+
+## Out of scope
+
+- Deleting or renaming old project folders
+- Changing how desk sessions are keyed
+
+## Assumptions
+
+- "选为当前项目" on the create form means create when the path is new
+- Clicking an item under 「已有项目」 means open
+- Browse into an existing folder opens it; it does not create over it
+
+## Acceptance
+
+1. Create with a folder name that already exists under the parent returns an error; disk contents are unchanged
+2. Opening the same path from the project list still works
+3. Create with a never-used name still creates the directory
+4. `npm test` and `npm run test:live` pass

package/.duaer/specs/277-project-dir-reuse/tasks.md

@@ -0,0 +1,5 @@
+# Tasks — 277-project-dir-reuse
+
+- [x] Refuse create when the target project directory already exists
+- [x] Keep open-from-list / browse-open working for existing paths
+- [x] Add tests, copy, and E2E row

package/.duaer/specs/278-project-create-unique/delivery.json

@@ -0,0 +1,9 @@
+{
+  "status": "accepted",
+  "summary": "Create uses only a short folder name under the product parent. Absolute paths, existing folders, and duplicate project titles are refused. Open from the list or browse still works.",
+  "verification": {
+    "L0": "node --check bin/live-repo-path.mjs bin/duaer-live.mjs — pass",
+    "L1": "npm test — pass",
+    "L3": "npm run test:live — pass"
+  }
+}

package/.duaer/specs/278-project-create-unique/spec.md

@@ -0,0 +1,27 @@
+# Feature Specification: Unique create — short name under parent only
+
+## Goal
+
+Create and open are separate. Creating a project only uses a short folder
+name under the product parent. Absolute paths, duplicate folders, and
+duplicate project titles are refused.
+
+## In scope
+
+- Create mode: short name only, must have parent set, refuse if folder exists
+- Create mode: refuse if an existing project already uses that path or title
+- Open from list / browse still accepts absolute paths
+- Copy and labels match the rule
+
+## Out of scope
+
+- Moving or renaming existing project folders on disk
+- Deleting stale list entries
+
+## Acceptance
+
+1. Create with `/Users/.../pcdemo` fails; asks for a short name under the parent
+2. Create with a short name that already exists on disk or in the project list fails
+3. Create with a title already used by another project fails
+4. Open from the list still works with absolute paths
+5. `npm test` and `npm run test:live` pass

package/.duaer/specs/278-project-create-unique/tasks.md

@@ -0,0 +1,5 @@
+# Tasks — 278-project-create-unique
+
+- [x] Create resolves only a short name under the product parent
+- [x] Refuse duplicate folder and duplicate project title on create
+- [x] Update labels, hints, and tests

package/.duaer/specs/279-arch-side-detour/delivery.json

@@ -0,0 +1,8 @@
+{
+  "status": "accepted",
+  "summary": "Corridor-aware Archify edge detours (validated bottom/top/side/gutter) plus vertical labelAt so stacked clean-flow IR renders.",
+  "verification": {
+    "commands": ["node --test test/live-archify.test.mjs"],
+    "result": "16 pass / 0 fail"
+  }
+}

package/.duaer/specs/279-arch-side-detour/spec.md

@@ -0,0 +1,28 @@
+# Feature Specification: Architecture corridor detour for clean-flow
+
+## Goal
+
+When Archify rejects edges that cross unrelated components, auto-routing
+must pick a corridor whose segments stay clear of other boxes — not a
+naive bottom exit through column neighbors, and not a side via whose
+horizontal leg clips co-row nodes. Vertical edge labels must sit in the
+gap between stacked boxes.
+
+## In scope
+
+- `routeCrossingEdges` validates candidate routes (bottom/top wrap, side
+  corridor, gutter wrap) and applies the first clear detour
+- Re-route edges that already have a bad bottom via
+- Vertical edge labels get `labelAt` in the inter-box gap
+- Regression test matching the speaker/editor/store failure
+
+## Out of scope
+
+- Changing Archify itself
+- Full force-directed relayout
+
+## Acceptance
+
+1. The reproduced IR (speaker→editor, store→gen, 初稿/定稿 labels) renders
+2. Existing same-row reverse-edge test still passes
+3. `npm test` live-archify tests pass

package/.duaer/specs/279-arch-side-detour/tasks.md

@@ -0,0 +1,5 @@
+# Tasks — 279-arch-side-detour
+
+- [x] Corridor-aware detour for edges that cross unrelated components
+- [x] Place vertical edge labels in the gap (`labelAt`)
+- [x] Regression test + docs

package/.duaer/specs/280-arch-bottom-via-label/delivery.json

@@ -0,0 +1,8 @@
+{
+  "status": "accepted",
+  "summary": "Bottom/top via edge labels pin labelAt on the via corridor so 改稿 no longer overlaps artifact.",
+  "verification": {
+    "commands": ["node --check bin/live-archify.mjs", "node --test test/live-archify.test.mjs"],
+    "result": "17 pass / 0 fail"
+  }
+}

package/.duaer/specs/280-arch-bottom-via-label/spec.md

@@ -0,0 +1,22 @@
+# Feature Specification: Bottom-via edge labels clear mid-row boxes
+
+## Goal
+
+When a same-row edge detours under the floor, its label must stay on the
+via (below) — not be pulled up with `labelDy: -36` onto mid-row components
+such as `artifact`.
+
+## In scope
+
+- `repairEdgeLabelPlacement` pins `labelAt` under bottom vias / above top vias
+- Overlap nudge when an offset mid still hits a box
+- Regression for speaker→revise「改稿」 overlapping artifact
+
+## Out of scope
+
+- Changing Archify itself
+
+## Acceptance
+
+1. Reproduced IR renders via Archify
+2. `node --test test/live-archify.test.mjs` passes

package/.duaer/specs/280-arch-bottom-via-label/tasks.md

@@ -0,0 +1,5 @@
+# Tasks — 280-arch-bottom-via-label
+
+- [x] Pin bottom/top via labels with labelAt on the via corridor
+- [x] Regression test for 改稿 / artifact overlap
+- [x] Docs + delivery stamp

package/.duaer/specs/281-release-0272/spec.md

@@ -0,0 +1,13 @@
+# Feature Specification: Release 0.27.2
+
+## Goal
+
+Ship 0.27.2: architecture clean-flow corridor detours, bottom-via label
+placement, unique project create paths, and FDE-08 performance budget.
+Promote develop to main, publish a GitHub Release, and let npm Trusted
+Publishing run.
+
+## Acceptance
+
+1. `package.json` is `0.27.2`; CHANGELOG has `0.27.2` and an empty Unreleased section.
+2. Tag `v0.27.2` is on `main`; GitHub Release is published.

package/.duaer/specs/281-release-0272/tasks.md

@@ -0,0 +1,4 @@
+# Tasks — 281-release-0272
+
+- [x] Bump package.json to 0.27.2 and move CHANGELOG Unreleased
+- [ ] Promote develop → main, tag, GitHub Release

package/CHANGELOG.md

@@ -2,6 +2,40 @@
 
 ## Unreleased
 
+## 0.27.2 — 2026-09-23
+
+### Fix: bottom-via edge labels stay under the floor
+
+- Bottom/top via labels use `labelAt` on the via corridor instead of
+  `labelDy: -36`, which pulled「改稿」up onto mid-row boxes like `artifact`
+
+### Fix: architecture corridor detour when edges cross stacked nodes
+
+- Auto-routing validates candidate corridors (bottom/top wrap, side, gutter)
+  so detours stay clear of unrelated boxes — not only avoid bottom exits
+- Vertical edge labels use `labelAt` in the inter-box gap
+- Fixes Archify `clean-flow/edge-through-node` and label-overlap failures on stacked layouts
+
+### Fix: create project uses a unique short name under the parent only
+
+- Create form no longer accepts absolute paths; folder name is a short name under the product parent
+- Duplicate on-disk folders and duplicate project titles are refused
+- Open existing projects from the list or Browse to open; create and open are separate
+
+### Fix: creating a project no longer reuses an existing directory
+
+- Create mode refuses when the target folder already exists on disk
+- Open an existing project from the list or browse; do not create over it
+- Hint copy tells the operator to rename or open the existing project
+
+### Feat: FDE-08 performance budget before confirm
+
+- Feature confirm must name LCP, INP, bundle size, virtualized long lists, a weak-network check, and a large-data check
+- A vague speed line such as "pretty fast" fails local validate
+- Modules with no page performance requirement may write that opt-out
+- Kickoff schedules the budget before implement, after the environment probe, data precheck, and external-dependency board when those exist
+- The desk records the budget; it does not run a customer performance lab
+
 ## 0.27.1 — 2026-09-21
 
 ### Feat: FDE-05 external dependency board before kickoff

package/bin/duaer-live.mjs

@@ -67,13 +67,20 @@ import {
   externalDepsDeclaresNone,
   missingExternalDeps,
 } from "../web/live-dev/external-deps.mjs";
+import {
+  missingPerfBudget,
+  perfBudgetDeclaresNone,
+} from "../web/live-dev/perf-budget.mjs";
 import { allocateUniqueBranch } from "./live-worktree-name.mjs";
 import {
   ensureGitInstalled,
   CURSOR_INSTALL_CMD as TOOLING_CURSOR_INSTALL,
 } from "./live-tooling.mjs";
 import {
+  assertProductDirFreeForCreate,
+  assertProjectIdentityFreeForCreate,
   ensureProductDir,
+  resolveCreateProductRepoPath,
   resolveProductRepoPath,
 } from "./live-repo-path.mjs";
 import {
@@ -758,6 +765,7 @@ const SYSTEM_PROMPT = `你是「Duaer-spec FDE」需求助手。通过多轮对
    - envChecklist = 环境检查：DNS、TLS、CORS、鉴权、第三方可达须全部写明且通过；无客户联调则写「无客户联调环境」。任一未通过不得开工
    - dataPrecheck = 数据预检：字段映射、导入预检失败清单、可导出给业务清洗；无导入则写「本模块无导入」
    - externalDeps = 外部依赖：阻塞项、SLA、备用 Mock、并行路径；无第三方/ERP/SSO 则写「本模块无外部依赖」
+   - perfBudget = 性能预算：LCP、INP、包体、长列表虚拟滚动、弱网、大数据压测；写「挺快的」不合格；无页面则写「本模块无页面性能要求」
    用户没提时：先根据产品形态填合理默认并写进 JSON，再在正文用一句话请用户改；不要长期留空。小项目可只有一个模块（id=main）。
 4. acceptance 必须可客观检查（打开何处、看到什么、哪条命令通过）；禁止只写「更好用/更好看」。
 5. ready=true 只表示**当前 active 模块**可确认，且上述字段都已非空、验收可检查。不是整系统开工。不要催用户立刻派工。
@@ -767,7 +775,7 @@ const SYSTEM_PROMPT = `你是「Duaer-spec FDE」需求助手。通过多轮对
    - 先写对用户说的纯文本（可多行，不要 JSON；正文里不要再列一遍选项清单）
    - 然后单独一行：<<<JSON>>>
    - 再输出一个 JSON 对象（不要 markdown 围栏）：
-{"modules":[{"id":"auth","title":"登录","status":"draft","goal":"...","outOfScope":"...","acceptance":"...","assumptions":"...","deviceMatrix":"...","criticalPaths":"...","exceptionCases":"...","apiContract":"...","envChecklist":"...","dataPrecheck":"...","externalDeps":"..."}],"activeModuleId":"auth","goal":"...","outOfScope":"...","acceptance":"...","assumptions":"...","deviceMatrix":"...","criticalPaths":"...","exceptionCases":"...","apiContract":"...","envChecklist":"...","dataPrecheck":"...","externalDeps":"...","ready":false,"options":["可选A","可选B"]}
+{"modules":[{"id":"auth","title":"登录","status":"draft","goal":"...","outOfScope":"...","acceptance":"...","assumptions":"...","deviceMatrix":"...","criticalPaths":"...","exceptionCases":"...","apiContract":"...","envChecklist":"...","dataPrecheck":"...","externalDeps":"...","perfBudget":"..."}],"activeModuleId":"auth","goal":"...","outOfScope":"...","acceptance":"...","assumptions":"...","deviceMatrix":"...","criticalPaths":"...","exceptionCases":"...","apiContract":"...","envChecklist":"...","dataPrecheck":"...","externalDeps":"...","perfBudget":"...","ready":false,"options":["可选A","可选B"]}
 说明：顶层字段与 ready 对应 activeModuleId 那一模块；modules 为完整清单（可增删改名）。`;
 
 const BUG_CHAT_PROMPT = `你是「Duaer-spec FDE」缺陷助手。用户要修 bug，不是做新功能。通过多轮对话整理成一张可派工的缺陷卡，使数字员工能复现、修复并回归。
@@ -805,6 +813,7 @@ const REVISE_CHAT_PROMPT = `你是「Duaer-spec FDE」改进对话助手。用
    - envChecklist = 若触及客户环境则更新探测结果，或写「无客户联调环境」/「同基线」
    - dataPrecheck = 若触及导入则更新映射与失败清单，或写「本模块无导入」/「同基线」
    - externalDeps = 若触及第三方/ERP/SSO 则更新阻塞项、SLA、备用 Mock、并行路径，或写「本模块无外部依赖」/「同基线」
+   - perfBudget = 若有页面则更新 LCP、INP、包体、长列表虚拟滚动、弱网、大数据压测，或写「本模块无页面性能要求」/「同基线」
 3. 字段够清楚且可执行时 ready=true（确认前系统会自动校验）。缺基线/契约字段时先填合理默认或用 options 点选。
 4. 不要写代码。不要立刻派工。不要假设仓库路径。
 5. 只要问题是让用户做选择，必须在 options 填 2～5 个短选项（≤20字）；界面可点选发送。禁止只让用户手打或「请回复数字」。
@@ -812,7 +821,7 @@ const REVISE_CHAT_PROMPT = `你是「Duaer-spec FDE」改进对话助手。用
    - 先写对用户说的纯文本（正文不要再列选项清单）
    - 然后单独一行：<<<JSON>>>
    - 再输出 JSON（不要 markdown 围栏）：
-{"goal":"...","outOfScope":"...","acceptance":"...","assumptions":"...","deviceMatrix":"...","criticalPaths":"...","exceptionCases":"...","apiContract":"...","envChecklist":"...","dataPrecheck":"...","externalDeps":"...","ready":false,"options":["可选A","可选B"]}`;
+{"goal":"...","outOfScope":"...","acceptance":"...","assumptions":"...","deviceMatrix":"...","criticalPaths":"...","exceptionCases":"...","apiContract":"...","envChecklist":"...","dataPrecheck":"...","externalDeps":"...","perfBudget":"...","ready":false,"options":["可选A","可选B"]}`;
 
 const ARCHITECTURE_CHAT_PROMPT = `你是「Duaer-spec FDE」架构助手。需求已确认。通过多轮对话设计系统架构图，供数字员工按图开发。系统会把 JSON 自动渲染成图，用户看不到原始 JSON。
 
@@ -843,23 +852,24 @@ const ACCEPT_PROMPT = `你是「Duaer-spec FDE」需求验收官。用户即将
 7. envChecklist 是否已填：DNS、TLS、CORS、鉴权、第三方可达全部通过，或明确「无客户联调环境」；存在未通过项则 passed=false
 8. dataPrecheck 是否已填：字段映射、导入预检失败清单、可导出，或明确「本模块无导入」
 9. externalDeps 是否已填：阻塞项、SLA、备用 Mock、并行路径，或明确「本模块无外部依赖」
-10. 按该验收标准做完后，用户是否有理由满意（成品可核对，而非过程叙事）
+10. perfBudget 是否已填：LCP、INP、包体、长列表虚拟滚动、弱网、大数据压测，或明确「本模块无页面性能要求」；禁止只写「挺快的」
+11. 按该验收标准做完后，用户是否有理由满意（成品可核对，而非过程叙事）
 
 规则：
 - 若小改即可通过：修订确认卡字段（尤其把 acceptance 改成可检查句子，并补全基线与契约），passed=true
 - 若缺关键信息：passed=false，issues 列出缺什么（中文，短句）
 - 不要写代码。不要假设仓库路径。不要催派工。
 - 只输出一个 JSON，不要 markdown 围栏：
-{"passed":false,"summary":"一句话结论","issues":["问题1"],"goal":"...","outOfScope":"...","acceptance":"...","assumptions":"...","deviceMatrix":"...","criticalPaths":"...","exceptionCases":"...","apiContract":"...","envChecklist":"...","dataPrecheck":"...","externalDeps":"..."}`;
+{"passed":false,"summary":"一句话结论","issues":["问题1"],"goal":"...","outOfScope":"...","acceptance":"...","assumptions":"...","deviceMatrix":"...","criticalPaths":"...","exceptionCases":"...","apiContract":"...","envChecklist":"...","dataPrecheck":"...","externalDeps":"...","perfBudget":"..."}`;
 
-const FIX_ACCEPT_PROMPT = `你是「Duaer-spec FDE」需求修正助手。自动验收未通过，请根据 issues 修订确认卡。优先把 acceptance 改成可客观检查的句子（打开何处、看到什么、哪条命令通过），并补全 deviceMatrix / criticalPaths / exceptionCases / apiContract / envChecklist / dataPrecheck / externalDeps；不要编造用户没提过的大功能。
+const FIX_ACCEPT_PROMPT = `你是「Duaer-spec FDE」需求修正助手。自动验收未通过，请根据 issues 修订确认卡。优先把 acceptance 改成可客观检查的句子（打开何处、看到什么、哪条命令通过），并补全 deviceMatrix / criticalPaths / exceptionCases / apiContract / envChecklist / dataPrecheck / externalDeps / perfBudget；不要编造用户没提过的大功能。
 
 规则：
-1. 针对每条 issue 修改 goal / outOfScope / acceptance / assumptions / deviceMatrix / criticalPaths / exceptionCases / apiContract / envChecklist / dataPrecheck / externalDeps
-2. 保持用户原意；缺信息时写合理、可检查的默认（如 Chrome 最近两版、手机 Safari，云测截图放 compat/，旧壳降级提示升级；主路径对齐 goal；异常态须同时写上空态、失败、权限不足、超时、重试，有接口则补错误码；无接口则写「本模块无 HTTP API」；无客户联调则 envChecklist 写「无客户联调环境」，否则 DNS、TLS、CORS、鉴权、第三方可达全部写通过；无导入则 dataPrecheck 写「本模块无导入」，否则写字段映射、导入预检失败清单、可导出；无外部依赖则 externalDeps 写「本模块无外部依赖」，否则写阻塞项、SLA、备用 Mock、并行路径），并写进 assumptions
+1. 针对每条 issue 修改 goal / outOfScope / acceptance / assumptions / deviceMatrix / criticalPaths / exceptionCases / apiContract / envChecklist / dataPrecheck / externalDeps / perfBudget
+2. 保持用户原意；缺信息时写合理、可检查的默认（如 Chrome 最近两版、手机 Safari，云测截图放 compat/，旧壳降级提示升级；主路径对齐 goal；异常态须同时写上空态、失败、权限不足、超时、重试，有接口则补错误码；无接口则写「本模块无 HTTP API」；无客户联调则 envChecklist 写「无客户联调环境」，否则 DNS、TLS、CORS、鉴权、第三方可达全部写通过；无导入则 dataPrecheck 写「本模块无导入」，否则写字段映射、导入预检失败清单、可导出；无外部依赖则 externalDeps 写「本模块无外部依赖」，否则写阻塞项、SLA、备用 Mock、并行路径；无页面则 perfBudget 写「本模块无页面性能要求」，否则写 LCP、INP、包体、长列表虚拟滚动、弱网、大数据压测，禁止只写「挺快的」），并写进 assumptions
 3. 不要写代码。不要假设仓库路径。
 4. 只输出一个 JSON，不要 markdown 围栏：
-{"summary":"一句话说明改了什么","goal":"...","outOfScope":"...","acceptance":"...","assumptions":"...","deviceMatrix":"...","criticalPaths":"...","exceptionCases":"...","apiContract":"...","envChecklist":"...","dataPrecheck":"...","externalDeps":"..."}`;
+{"summary":"一句话说明改了什么","goal":"...","outOfScope":"...","acceptance":"...","assumptions":"...","deviceMatrix":"...","criticalPaths":"...","exceptionCases":"...","apiContract":"...","envChecklist":"...","dataPrecheck":"...","externalDeps":"...","perfBudget":"..."}`;
 
 const BUG_ACCEPT_PROMPT = `你是「Duaer-spec FDE」缺陷验收官。用户即将锁定缺陷卡（尚未派工）。目标是：规范缺陷描述，使数字员工能复现、修复并回归。
 
@@ -1138,6 +1148,7 @@ function parseChatResult(content) {
               envChecklist: flat(m.envChecklist ?? m.card?.envChecklist),
               dataPrecheck: flat(m.dataPrecheck ?? m.card?.dataPrecheck),
               externalDeps: flat(m.externalDeps ?? m.card?.externalDeps),
+              perfBudget: flat(m.perfBudget ?? m.card?.perfBudget),
               dependsOn: Array.isArray(m.dependsOn)
                 ? m.dependsOn.map((x) => flat(x)).filter(Boolean).slice(0, 20)
                 : [],
@@ -1159,6 +1170,7 @@ function parseChatResult(content) {
       envChecklist: flat(obj.envChecklist),
       dataPrecheck: flat(obj.dataPrecheck),
       externalDeps: flat(obj.externalDeps),
+      perfBudget: flat(obj.perfBudget),
       ready: Boolean(obj.ready),
       activeModuleId: flat(obj.activeModuleId) || undefined,
       modules,
@@ -1184,6 +1196,7 @@ function parseChatResult(content) {
       envChecklist: "",
       dataPrecheck: "",
       externalDeps: "",
+      perfBudget: "",
       ready: false,
       options: [],
     };
@@ -1206,6 +1219,7 @@ function chatDoneSsePayload(parsed, { includeJsonBlock = true } = {}) {
     envChecklist: String(parsed?.envChecklist || ""),
     dataPrecheck: String(parsed?.dataPrecheck || ""),
     externalDeps: String(parsed?.externalDeps || ""),
+    perfBudget: String(parsed?.perfBudget || ""),
     ready: Boolean(parsed?.ready),
     activeModuleId: parsed?.activeModuleId
       ? String(parsed.activeModuleId).slice(0, 80)
@@ -1226,6 +1240,7 @@ function chatDoneSsePayload(parsed, { includeJsonBlock = true } = {}) {
           envChecklist: String(m.envChecklist || "").slice(0, 4000),
           dataPrecheck: String(m.dataPrecheck || "").slice(0, 4000),
           externalDeps: String(m.externalDeps || "").slice(0, 4000),
+          perfBudget: String(m.perfBudget || "").slice(0, 4000),
           dependsOn: Array.isArray(m.dependsOn)
             ? m.dependsOn.map(String).slice(0, 20)
             : [],
@@ -1392,6 +1407,7 @@ function parseAcceptResult(content, fallback) {
     envChecklist: pick("envChecklist"),
     dataPrecheck: pick("dataPrecheck"),
     externalDeps: pick("externalDeps"),
+    perfBudget: pick("perfBudget"),
   };
 }
 
@@ -1504,6 +1520,18 @@ function localAcceptCheck(card, { kind = "feature" } = {}) {
           : "「外部依赖」必填（阻塞项、SLA、备用 Mock、并行路径，或写「本模块无外部依赖」）",
       );
     }
+    const perfBudget = String(card.perfBudget || "").trim();
+    if (
+      !perfBudgetDeclaresNone(perfBudget) &&
+      (perfBudget.length < 4 || missingPerfBudget(perfBudget).length)
+    ) {
+      const missing = missingPerfBudget(perfBudget);
+      issues.push(
+        missing.length
+          ? `「性能预算」未写清：${missing.join("、")}（须含 LCP、INP、包体、长列表、弱网、大数据压测，或写「本模块无页面性能要求」）`
+          : "「性能预算」必填（LCP、INP、包体、长列表、弱网、大数据压测，或写「本模块无页面性能要求」）",
+      );
+    }
   }
   return issues;
 }
@@ -1526,6 +1554,7 @@ async function autoAcceptCard(cfg, card, { kind = "feature", projectContext = nu
       envChecklist: card.envChecklist,
       dataPrecheck: card.dataPrecheck,
       externalDeps: card.externalDeps,
+      perfBudget: card.perfBudget,
     };
   }
   const ctxNote =
@@ -1559,6 +1588,7 @@ async function validateCardOnly(cfg, card, { kind = "feature", projectContext =
     envChecklist: String(card.envChecklist || "").trim(),
     dataPrecheck: String(card.dataPrecheck || "").trim(),
     externalDeps: String(card.externalDeps || "").trim(),
+    perfBudget: String(card.perfBudget || "").trim(),
   };
   if (kind === "bug" && projectContext) {
     normalized = {
@@ -1620,6 +1650,7 @@ async function validateCardOnly(cfg, card, { kind = "feature", projectContext =
     envChecklist: review.envChecklist || normalized.envChecklist,
     dataPrecheck: review.dataPrecheck || normalized.dataPrecheck,
     externalDeps: review.externalDeps || normalized.externalDeps,
+    perfBudget: review.perfBudget || normalized.perfBudget,
   };
 }
 
@@ -1670,6 +1701,7 @@ async function autoFixConfirmCard(cfg, card, issues, { kind = "feature", project
     envChecklist: String(obj.envChecklist || card.envChecklist || "").trim(),
     dataPrecheck: String(obj.dataPrecheck || card.dataPrecheck || "").trim(),
     externalDeps: String(obj.externalDeps || card.externalDeps || "").trim(),
+    perfBudget: String(obj.perfBudget || card.perfBudget || "").trim(),
   };
 }
 
@@ -2516,20 +2548,53 @@ function activateProject(body = {}) {
   const cfg = readConfig();
   let raw = String(body.path || body.name || "").trim();
   if (!raw) {
-    const e = new Error("请填写目录名或绝对路径");
+    const e = new Error(
+      body.create === true || body.mode === "create"
+        ? "请填写要新建的目录短名"
+        : "请填写目录名或绝对路径",
+    );
     e.code = "EMPTY_PATH";
     throw e;
   }
   const titleIn = String(body.title || "").trim();
   const descriptionIn = String(body.description || "").trim();
-  const abs = resolveProductRepoPath(raw, {
-    projectsRoot: cfg.projectsRoot,
-  });
+  const create = body.create === true || body.mode === "create";
+  if (create) {
+    if (!titleIn) {
+      const e = new Error("请填写项目名称");
+      e.code = "NEED_TITLE";
+      throw e;
+    }
+    if (!descriptionIn) {
+      const e = new Error("请填写简单的背景描述");
+      e.code = "NEED_DESCRIPTION";
+      throw e;
+    }
+  }
+  const abs = create
+    ? resolveCreateProductRepoPath(raw, {
+        projectsRoot: cfg.projectsRoot,
+      })
+    : resolveProductRepoPath(raw, {
+        projectsRoot: cfg.projectsRoot,
+      });
+  if (create) {
+    assertProductDirFreeForCreate(abs);
+    assertProjectIdentityFreeForCreate(
+      { path: abs, title: titleIn },
+      readRepos(),
+    );
+  } else if (!fs.existsSync(abs)) {
+    const e = new Error(`项目目录不存在：${abs}`);
+    e.code = "PATH_MISSING";
+    e.path = abs;
+    throw e;
+  }
   const ensured = ensureProductDir(abs);
   const existing = readRepos().find(
     (r) => normalizeRepoPath(r.path) === normalizeRepoPath(abs),
   );
-  const isNew = Boolean(ensured.created) || !existing;
+  const isNew = Boolean(ensured.created) || (create && !existing);
   const needMeta = Boolean(body.requireMeta) || isNew;
   if (needMeta && !titleIn) {
     const e = new Error("请填写项目名称");
@@ -2546,12 +2611,17 @@ function activateProject(body = {}) {
     exact: true,
     ensureDuaer: false,
   });
-  const savedTitle =
-    titleIn ||
-    existing?.title ||
-    existing?.name ||
-    path.basename(probe.path);
-  const savedDesc = descriptionIn || existing?.description || "";
+  // Opening an existing project keeps prior title/description unless the
+  // caller sends non-empty replacements. Create always writes the new meta.
+  const savedTitle = create
+    ? titleIn || path.basename(probe.path)
+    : titleIn ||
+      existing?.title ||
+      existing?.name ||
+      path.basename(probe.path);
+  const savedDesc = create
+    ? descriptionIn
+    : descriptionIn || existing?.description || "";
   rememberRepo(probe.path, {
     title: savedTitle,
     name: savedTitle,
@@ -6485,6 +6555,7 @@ async function handleApi(req, res) {
         envChecklist: body.envChecklist,
         dataPrecheck: body.dataPrecheck,
         externalDeps: body.externalDeps,
+        perfBudget: body.perfBudget,
       });
       const deskKind =
         String(body.deskKind || body.kind || "").trim() === "bug"
@@ -6541,6 +6612,7 @@ async function handleApi(req, res) {
         envChecklist: body.envChecklist,
         dataPrecheck: body.dataPrecheck,
         externalDeps: body.externalDeps,
+        perfBudget: body.perfBudget,
       });
       const issues = Array.isArray(body.issues) ? body.issues : [];
       const deskKind =
@@ -6605,6 +6677,7 @@ async function handleApi(req, res) {
         envChecklist: body.envChecklist,
         dataPrecheck: body.dataPrecheck,
         externalDeps: body.externalDeps,
+        perfBudget: body.perfBudget,
       });
       if (!card.goal || !card.acceptance) {
         send(res, 400, { error: "goal and acceptance are required" });
@@ -6717,6 +6790,7 @@ async function handleApi(req, res) {
         envChecklist: body.envChecklist,
         dataPrecheck: body.dataPrecheck,
         externalDeps: body.externalDeps,
+        perfBudget: body.perfBudget,
       });
       const issues = Array.isArray(body.issues) ? body.issues : [];
       if (!card.goal && !card.acceptance) {