diff --git a/docs/操作日志_智能气阀归属互斥选择_20260813.md b/docs/操作日志_智能气阀归属互斥选择_20260813.md
new file mode 100644
index 0000000..f7ecfeb
--- /dev/null
+++ b/docs/操作日志_智能气阀归属互斥选择_20260813.md
@@ -0,0 +1,37 @@
+# 智能气阀归属互斥选择操作日志
+
+操作时间:2026-08-13
+操作类型:修改
+影响模块:平台总后台智能气阀归属变更
+
+## 操作前状态
+
+归属变更弹窗同时展示库房、气站、配送点和用户。管理员选择新归属前必须手动清空原归属;同时存在多个值时,提交阶段才提示“智能气阀只能选择一个当前归属”。
+
+## 具体操作
+
+1. 选择任一非空归属时,立即清空另外三个互斥归属。
+2. 更新弹窗提示,明确说明自动清空行为。
+3. 保留提交前的多重归属防御校验。
+4. 保留四个归属字段的完整提交,以便后端清除原归属并记录审计历史。
+
+## 操作后状态
+
+管理员只需选择目标归属,无需逐项手动清空。一个智能气阀仍然最多只有一个当前归属。
+
+## 代码变更
+
+- `frontend/platform_admin/src/views/resource/ResourceActionDialog.vue`:增加归属互斥清空逻辑。
+- `frontend/platform_admin/scripts/check-product-ownership-action.mjs`:增加静态回归检查。
+- `frontend/platform_admin/package.json`:注册归属检查命令。
+
+## 验证结果
+
+- `npm.cmd run product-ownership:check`:通过,确认选择时自动清空并保留提交防御。
+- `npm.cmd run resource-pages:check`:通过,详情 46 类、新建 25 类、编辑 23 类。
+- `npm.cmd run build`:通过,TypeScript 类型检查与 Vite 生产构建成功。
+- `git diff --check`:通过,未发现空白符错误。
+
+## 风险评估
+
+修改仅作用于智能气阀归属专用弹窗,不改变数据库、接口字段、后端校验和审计规则。提交阶段继续拒绝异常多重归属。
diff --git a/docs/项目文档_智能气阀归属互斥选择_v1.0.md b/docs/项目文档_智能气阀归属互斥选择_v1.0.md
new file mode 100644
index 0000000..1300f7c
--- /dev/null
+++ b/docs/项目文档_智能气阀归属互斥选择_v1.0.md
@@ -0,0 +1,33 @@
+# 项目文档:智能气阀归属互斥选择 v1.0
+
+## 1. 项目概述
+
+智能气阀归属变更支持库房、气站、配送点和用户四类目标,但当前归属最多一个。前端选择目标后自动清空其他归属,后端继续负责最终合法性校验和归属历史记录。
+
+## 2. 目录结构说明
+
+```text
+platforms/
+├── frontend/platform_admin/
+│ ├── src/views/resource/ResourceActionDialog.vue
+│ └── scripts/check-product-ownership-action.mjs
+└── docs/
+ ├── 项目文档_智能气阀归属互斥选择_v1.0.md
+ └── 操作日志_智能气阀归属互斥选择_20260813.md
+```
+
+## 3. 核心行为
+
+- 弹窗打开时保留当前归属,便于管理员确认现状。
+- 选择新的非空归属时,前端自动清空另外三个字段。
+- 主动清空当前字段不会自动选择其他归属。
+- 提交时仍发送全部四个归属字段,空字符串表示清除旧关系。
+- 提交前继续执行最多一个归属的防御校验。
+
+## 4. 接口兼容性
+
+继续使用 `PUT /product_info/:identity`,不新增或修改请求字段。动作、原因、备注和后端审计行为保持不变。
+
+## 5. 维护指南
+
+新增归属类型时,必须同步更新互斥字段集合、后端合法性校验、归属历史模型和回归检查,不得只增加一个下拉控件。
diff --git a/frontend/platform_admin/package.json b/frontend/platform_admin/package.json
index 38f0687..c88b1d5 100644
--- a/frontend/platform_admin/package.json
+++ b/frontend/platform_admin/package.json
@@ -22,6 +22,7 @@
"staff-organization:check": "node scripts/check-staff-organization-linkage.mjs",
"staff-relations:check": "node scripts/check-staff-relation-policy.mjs",
"user-address-display:check": "node scripts/check-user-address-relation-display.mjs",
+ "product-ownership:check": "node scripts/check-product-ownership-action.mjs",
"resource-search:check": "node scripts/check-resource-search.mjs",
"audit:platform": "node scripts/check-backend-contract.mjs",
"lint": "biome lint .",
diff --git a/frontend/platform_admin/scripts/check-product-ownership-action.mjs b/frontend/platform_admin/scripts/check-product-ownership-action.mjs
new file mode 100644
index 0000000..bc9354e
--- /dev/null
+++ b/frontend/platform_admin/scripts/check-product-ownership-action.mjs
@@ -0,0 +1,27 @@
+/**
+ * 功能:检查智能气阀归属弹窗保留互斥选择和提交防御。
+ * 版本:v1.0.0
+ */
+import { readFile } from 'node:fs/promises';
+import { fileURLToPath } from 'node:url';
+
+const componentUrl = new URL(
+ '../src/views/resource/ResourceActionDialog.vue',
+ import.meta.url,
+);
+const source = await readFile(fileURLToPath(componentUrl), 'utf8');
+const requiredFragments = [
+ '@change-relation="changeRelation"',
+ 'ownershipKeys.includes(field.key)',
+ 'if (key !== field.key) form[key] = undefined',
+ "Message.warning('智能气阀只能选择一个当前归属')",
+ "payload[key] = String(form[key] ?? '')",
+];
+
+for (const fragment of requiredFragments) {
+ if (!source.includes(fragment)) {
+ throw new Error(`智能气阀归属互斥检查缺少实现:${fragment}`);
+ }
+}
+
+console.log('智能气阀归属互斥检查通过:选择时自动清空,提交时保留防御校验。');
diff --git a/frontend/platform_admin/src/views/resource/ResourceActionDialog.vue b/frontend/platform_admin/src/views/resource/ResourceActionDialog.vue
index 373156e..d38a676 100644
--- a/frontend/platform_admin/src/views/resource/ResourceActionDialog.vue
+++ b/frontend/platform_admin/src/views/resource/ResourceActionDialog.vue
@@ -16,7 +16,7 @@
这是高风险操作,可能改变业务状态且无法直接撤销。请确认目标记录和填写内容准确。
- 智能气阀只能有一个当前归属。选择新归属前请清空原归属,操作会写入审计记录。
+ 智能气阀只能有一个当前归属。选择新归属后会自动清空其他归属,操作会写入审计记录。
@@ -75,6 +76,21 @@ function searchRelation(field: ResourceField, keyword: string) {
relations.searchField(field, keyword);
}
+/** 选择智能气阀的新归属时清空其余互斥归属,避免提交非法多重归属。 */
+function changeRelation(field: ResourceField, value: unknown) {
+ if (
+ !isOwnershipAction.value ||
+ !ownershipKeys.includes(field.key) ||
+ value == null ||
+ String(value).trim() === ''
+ ) {
+ return;
+ }
+ for (const key of ownershipKeys) {
+ if (key !== field.key) form[key] = undefined;
+ }
+}
+
watch(
() => [props.visible, props.action?.name] as const,
async ([visible]) => {