poi-plugin-remodel-assistant 1.2.7 → 1.2.8-beta.1

package/README.md

@@ -1,43 +1,35 @@
 # 改修助手
 
-Poi plugin for planning Kantai Collection equipment improvements.
+Poi 用舰队 Collection 装备改修规划插件。结合当前库存与随包数据，把长期改修目标拆成“今天改什么”、具体起点、完整升级路线、秘书舰条件和材料消耗。
 
-Tell the plugin the equipment you ultimately want, the target improvement level, and quantity. It will combine that goal with your current inventory to organize routes, intermediate equipment, material requirements, and what you can improve today.
+Beta preview channel. Beta and Stable share the npm package name `poi-plugin-remodel-assistant`; Beta uses the `beta` dist-tag and Stable uses `latest`.
 
 ## Features
 
-- Create improvement plans directly from **Equipment library**.
-- Match plans against your current inventory to determine the practical starting point.
-- Manage complete improvement routes, with explicit user choice when more than one valid route exists.
-- Review acquisition sources for missing prerequisite equipment, including development, quests, and ship initial/remodel equipment when available.
-- Use **Today** to see plans that can be advanced now, together with assistant ships, available days, materials, and remaining routes.
-- Filter and sort equipment, manage low-priority equipment, and customize ordinary detail sections.
-- Back up and restore plans, route choices, and interface settings.
+- Use **Today** as the execution list for unfinished plans, with current equipment, assistant ships, available days, current-step materials, and the remaining equipment-star route in one detail view.
+- Use **Equipment library** to search equipment, review owned copies, add explicit target-star/quantity plans, compare total cost, and manage each plan route.
+- Keep route choices explicit: one valid complete route is used directly, while multiple valid routes wait for the user to choose instead of being silently auto-ranked.
+- Review acquisition sources when a route requires equipment you do not own, including development, quest, and ship initial/remodel sources when available.
+- Compare expected and guaranteed material needs, with development materials and improvement materials presented separately.
+- Customize ordinary detail sections by visibility and order, while required unresolved/action sections remain visible.
+- Use category filters, sorting, and low-priority equipment to narrow recommendations without removing valid plans or routes.
 
 ## Quick Start
 
-1. Open **Equipment library** and select your target equipment.
-2. Set the target improvement level and quantity, then create a plan.
-3. If more than one route is available, choose the route you want.
-4. Open **Today** and follow the current guidance.
+1. Open **Equipment library**, select an equipment, and add a plan with the target improvement level and quantity.
+2. If the plan has more than one complete valid route, choose the route you want; if the starting equipment is missing, open its acquisition details.
+3. Open **Today** and follow the current equipment, assistant ship, available day, material requirement, and remaining route shown in the detail pane.
 
-The in-plugin **Help** entry contains illustrated guides.
-
-## Data Sources
-
-Improvement information is based on:
-
-- Akashi-List
-- wikiwiki.jp
-- KcWiki-Api
-- KC3
-
-The plugin uses the latest available data and shows the active data version and update time in **Help**.
+The in-plugin **Help** entry contains this workflow, detailed category/low-priority guides, data-source information, and user-facing release notes.
 
 ## Installation
 
 Install `poi-plugin-remodel-assistant` from the Poi plugin manager.
 
+## Data
+
+Improvement data is based on Akashi-List, wikiwiki.jp, KcWiki-Api, and KC3. Data is updated with the packaged plugin data and is not fetched in real time while the plugin is running.
+
 ## License
 
 MIT

package/assets/main.css

@@ -12471,3 +12471,73 @@ body.decision-modal-is-dragging * {
     width: 100%;
   }
 }
+
+/* Allocation recommendations: actionable strict-progress updates + read-only audit history. */
+.decision-binding-recommendation-trigger.has-pending {
+  font-weight: 600;
+  box-shadow: 0 0 0 1px rgba(255, 193, 7, 0.36);
+}
+
+.decision-binding-adjustment-dialog {
+  width: min(760px, calc(100vw - 48px));
+}
+
+.decision-binding-adjustment-modal {
+  display: grid;
+  gap: 18px;
+  max-height: min(72vh, 720px);
+  overflow: auto;
+}
+
+.decision-binding-recommendation-notice {
+  margin: 0;
+}
+
+.decision-binding-adjustment-section {
+  display: grid;
+  gap: 10px;
+}
+
+.decision-binding-adjustment-section > header {
+  display: grid;
+  gap: 2px;
+}
+
+.decision-binding-adjustment-section > header small {
+  opacity: 0.72;
+}
+
+.decision-binding-adjustment-list,
+.decision-binding-adjustment-history {
+  display: grid;
+  gap: 8px;
+}
+
+.decision-binding-adjustment-entry,
+.decision-binding-adjustment-history-entry {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  gap: 14px;
+  padding: 10px 12px;
+  border: 1px solid rgba(127, 127, 127, 0.28);
+  border-radius: 4px;
+}
+
+.decision-binding-adjustment-copy,
+.decision-binding-adjustment-history-entry > div {
+  display: grid;
+  min-width: 0;
+  gap: 3px;
+}
+
+.decision-binding-adjustment-copy span,
+.decision-binding-adjustment-history-entry span {
+  overflow-wrap: anywhere;
+}
+
+.decision-binding-adjustment-history-entry time {
+  flex: 0 0 auto;
+  opacity: 0.66;
+  font-size: 0.9em;
+}

package/data/changelog.json

@@ -1,6 +1,13 @@
 {
   "schemaVersion": 1,
   "entries": [
+    {
+      "version": "1.2.8",
+      "items": [
+        "changelog_1_2_8_allocation_recommendations",
+        "changelog_1_2_8_recommendation_history"
+      ]
+    },
     {
       "version": "1.2.7",
       "items": [

package/i18n/en-US.json

@@ -1682,5 +1682,47 @@
   "app.changelog_1_2_7_remaining_cost_fix": "Fixed an issue where remaining resources, development materials, improvement materials, and equipment consumables could incorrectly show as 0 for partially executed improvement plans.",
   "statistics.Current": "Owned",
   "statistics.Equipment gaps": "Equipment gaps",
-  "chain.Open the complete chain to pan and zoom": "Open the complete chain to pan and zoom."
+  "chain.Open the complete chain to pan and zoom": "Open the complete chain to pan and zoom.",
+  "app.Equipment allocation": "Equipment allocation",
+  "app.Adjustable %d": "%d adjustable",
+  "app.Available adjustments": "Available adjustments",
+  "app.Only strict progress on the current route is suggested. Nothing changes until you confirm.": "Only an available item further along the selected route is suggested. Nothing changes until you confirm.",
+  "app.No allocation adjustments are currently available": "No allocation adjustments are currently available",
+  "app.Confirming...": "Confirming…",
+  "app.Confirm adjustment": "Confirm adjustment",
+  "app.History": "History",
+  "app.History is read-only and cannot be rolled back or reapplied.": "History is read-only and cannot be rolled back or reapplied.",
+  "app.No allocation adjustment history yet": "No allocation adjustment history yet",
+  "app.This adjustment is no longer available. The current allocation has been refreshed.": "This adjustment is no longer available. The current allocation has been refreshed.",
+  "app.Allocation adjusted": "Allocation adjusted",
+  "plan.Equipment allocation": "Equipment allocation",
+  "plan.Adjustable %d": "%d adjustable",
+  "plan.Available adjustments": "Available adjustments",
+  "plan.Only strict progress on the current route is suggested. Nothing changes until you confirm.": "Only an available item further along the selected route is suggested. Nothing changes until you confirm.",
+  "plan.No allocation adjustments are currently available": "No allocation adjustments are currently available",
+  "plan.Confirming...": "Confirming…",
+  "plan.Confirm adjustment": "Confirm adjustment",
+  "plan.History": "History",
+  "plan.History is read-only and cannot be rolled back or reapplied.": "History is read-only and cannot be rolled back or reapplied.",
+  "plan.No allocation adjustment history yet": "No allocation adjustment history yet",
+  "plan.This adjustment is no longer available. The current allocation has been refreshed.": "This adjustment is no longer available. The current allocation has been refreshed.",
+  "plan.Allocation adjusted": "Allocation adjusted",
+  "app.Allocation recommendations": "Allocation recommendations",
+  "app.A recommendation is shown only when an available item is further along the selected route. Your allocation changes only after you apply it.": "A recommendation is shown only when an available item is further along the selected route. Your allocation changes only after you apply it.",
+  "app.Applying...": "Applying…",
+  "app.This recommendation is no longer available. The current allocation has been refreshed.": "This recommendation is no longer available. The current allocation has been refreshed.",
+  "app.Recommended update applied": "Recommended update applied",
+  "app.changelog_1_2_8_allocation_recommendations": "Added allocation recommendations: when a plan has a more advanced available starting option, the plugin alerts you and updates the allocation only after confirmation.",
+  "app.changelog_1_2_8_recommendation_history": "Added recommendation update history and a clearer attention state when a recommendation is waiting for confirmation.",
+  "plan.Allocation recommendations": "Allocation recommendations",
+  "plan.Applying...": "Applying…",
+  "app.Allocation recommendations available": "Allocation recommendations available",
+  "plan.There are %d allocation recommendations. Confirm to update the allocation.": "There are %d allocation recommendations. Confirm to update the allocation.",
+  "plan.A recommendation appears when a more advanced starting item is available on the selected route. The allocation changes only after you confirm the update.": "A recommendation appears when a more advanced starting item is available on the selected route. The allocation changes only after you confirm the update.",
+  "plan.Update allocation": "Update allocation",
+  "plan.Updating...": "Updating...",
+  "plan.Update records": "Update records",
+  "plan.Update records show successful allocation changes only and are read-only.": "Update records show successful allocation changes only and are read-only.",
+  "plan.No allocation update records yet": "No allocation update records yet",
+  "plan.No allocation recommendations available": "No allocation recommendations available"
 }

package/i18n/ja-JP.json

@@ -1682,5 +1682,47 @@
   "app.changelog_1_2_7_remaining_cost_fix": "一部実行済みの改修計画で、残りの資源・開発資材・改修資材・装備素材が誤って 0 と表示されることがある問題を修正しました。",
   "statistics.Current": "所持",
   "statistics.Equipment gaps": "装備不足",
-  "chain.Open the complete chain to pan and zoom": "完全な改修チェーンを開くと、移動・拡大縮小して確認できます。"
+  "chain.Open the complete chain to pan and zoom": "完全な改修チェーンを開くと、移動・拡大縮小して確認できます。",
+  "app.Equipment allocation": "装備割り当て",
+  "app.Adjustable %d": "調整可能 %d",
+  "app.Available adjustments": "調整可能な割り当て",
+  "app.Only strict progress on the current route is suggested. Nothing changes until you confirm.": "選択中のルートで、より先まで進んでいる利用可能な装備だけを表示します。確認するまで装備割り当ては変更されません。",
+  "app.No allocation adjustments are currently available": "現在調整できる装備割り当てはありません",
+  "app.Confirming...": "確認中…",
+  "app.Confirm adjustment": "調整を確認",
+  "app.History": "履歴",
+  "app.History is read-only and cannot be rolled back or reapplied.": "履歴は参照専用で、ロールバックや再実行はできません。",
+  "app.No allocation adjustment history yet": "装備割り当ての調整履歴はまだありません",
+  "app.This adjustment is no longer available. The current allocation has been refreshed.": "この調整は無効になりました。現在の装備割り当てを更新しました。",
+  "app.Allocation adjusted": "装備割り当てを調整しました",
+  "plan.Equipment allocation": "装備割り当て",
+  "plan.Adjustable %d": "調整可能 %d",
+  "plan.Available adjustments": "調整可能な割り当て",
+  "plan.Only strict progress on the current route is suggested. Nothing changes until you confirm.": "選択中のルートで、より先まで進んでいる利用可能な装備だけを表示します。確認するまで装備割り当ては変更されません。",
+  "plan.No allocation adjustments are currently available": "現在調整できる装備割り当てはありません",
+  "plan.Confirming...": "確認中…",
+  "plan.Confirm adjustment": "調整を確認",
+  "plan.History": "履歴",
+  "plan.History is read-only and cannot be rolled back or reapplied.": "履歴は参照専用で、ロールバックや再実行はできません。",
+  "plan.No allocation adjustment history yet": "装備割り当ての調整履歴はまだありません",
+  "plan.This adjustment is no longer available. The current allocation has been refreshed.": "この調整は無効になりました。現在の装備割り当てを更新しました。",
+  "plan.Allocation adjusted": "装備割り当てを調整しました",
+  "app.Allocation recommendations": "割り当てのおすすめ",
+  "app.A recommendation is shown only when an available item is further along the selected route. Your allocation changes only after you apply it.": "選択中のルートで、より先まで進んでいる利用可能な装備がある場合だけおすすめします。適用するまで現在の装備割り当ては変更されません。",
+  "app.Applying...": "適用中…",
+  "app.This recommendation is no longer available. The current allocation has been refreshed.": "このおすすめは無効になりました。現在の装備割り当てを更新しました。",
+  "app.Recommended update applied": "おすすめ更新を適用しました",
+  "app.changelog_1_2_8_allocation_recommendations": "装備割り当てのおすすめを追加しました。計画の開始地点に、より先まで進んだ利用可能な選択肢がある場合に通知し、確認後に割り当てを更新できます。",
+  "app.changelog_1_2_8_recommendation_history": "おすすめ更新の履歴を追加し、確認待ちのおすすめがある場合の表示を分かりやすくしました。",
+  "plan.Allocation recommendations": "割り当てのおすすめ",
+  "plan.Applying...": "適用中…",
+  "app.Allocation recommendations available": "割り当てのおすすめあり",
+  "plan.There are %d allocation recommendations. Confirm to update the allocation.": "割り当てのおすすめが %d 件あります。確認すると装備割り当てを更新します。",
+  "plan.A recommendation appears when a more advanced starting item is available on the selected route. The allocation changes only after you confirm the update.": "選択中のルートで、計画の開始地点としてより先まで進んだ利用可能な装備がある場合におすすめします。確認するまで割り当ては変更されません。",
+  "plan.Update allocation": "割り当てを更新",
+  "plan.Updating...": "更新中…",
+  "plan.Update records": "更新記録",
+  "plan.Update records show successful allocation changes only and are read-only.": "正常に適用された装備割り当ての更新だけを記録します。記録は閲覧専用です。",
+  "plan.No allocation update records yet": "更新記録はまだありません",
+  "plan.No allocation recommendations available": "現在、割り当てのおすすめはありません"
 }

package/i18n/zh-CN.json

@@ -1682,5 +1682,47 @@
   "app.changelog_1_2_7_remaining_cost_fix": "修复部分已经开始执行的改修计划，其剩余资源、开发资材、改修资材及装备耗材可能错误显示为 0 的问题。",
   "statistics.Current": "持有",
   "statistics.Equipment gaps": "装备缺口",
-  "chain.Open the complete chain to pan and zoom": "打开完整升级链后可拖动和缩放查看。"
+  "chain.Open the complete chain to pan and zoom": "打开完整升级链后可拖动和缩放查看。",
+  "app.Equipment allocation": "装备分配",
+  "app.Adjustable %d": "可调整 %d",
+  "app.Available adjustments": "可操作调整",
+  "app.Only strict progress on the current route is suggested. Nothing changes until you confirm.": "这里只显示所选路线中已经推进得更远的可用装备；确认前不会实际调整装备分配。",
+  "app.No allocation adjustments are currently available": "当前没有可调整的装备分配",
+  "app.Confirming...": "正在确认…",
+  "app.Confirm adjustment": "确认调整",
+  "app.History": "历史",
+  "app.History is read-only and cannot be rolled back or reapplied.": "历史仅供查看，不支持回滚或重新执行。",
+  "app.No allocation adjustment history yet": "暂无装备分配调整历史",
+  "app.This adjustment is no longer available. The current allocation has been refreshed.": "这条调整已经失效，当前装备分配已刷新。",
+  "app.Allocation adjusted": "装备分配已调整",
+  "plan.Equipment allocation": "装备分配",
+  "plan.Adjustable %d": "可调整 %d",
+  "plan.Available adjustments": "可操作调整",
+  "plan.Only strict progress on the current route is suggested. Nothing changes until you confirm.": "这里只显示所选路线中已经推进得更远的可用装备；确认前不会实际调整装备分配。",
+  "plan.No allocation adjustments are currently available": "当前没有可调整的装备分配",
+  "plan.Confirming...": "正在确认…",
+  "plan.Confirm adjustment": "确认调整",
+  "plan.History": "历史",
+  "plan.History is read-only and cannot be rolled back or reapplied.": "历史仅供查看，不支持回滚或重新执行。",
+  "plan.No allocation adjustment history yet": "暂无装备分配调整历史",
+  "plan.This adjustment is no longer available. The current allocation has been refreshed.": "这条调整已经失效，当前装备分配已刷新。",
+  "plan.Allocation adjusted": "装备分配已调整",
+  "app.Allocation recommendations": "分配建议",
+  "app.A recommendation is shown only when an available item is further along the selected route. Your allocation changes only after you apply it.": "仅当所选路线存在推进得更远的可用装备时才会给出推荐；只有应用推荐后才会更新当前装备分配。",
+  "app.Applying...": "正在应用…",
+  "app.This recommendation is no longer available. The current allocation has been refreshed.": "这条推荐已经失效，当前装备分配已刷新。",
+  "app.Recommended update applied": "推荐更新已应用",
+  "app.changelog_1_2_8_allocation_recommendations": "新增装备分配建议：当计划起点有更进一步的可用选择时会进行提醒，确认后即可更新装备分配。",
+  "app.changelog_1_2_8_recommendation_history": "新增推荐更新历史，并在存在待确认推荐时提供更明显的提示。",
+  "plan.Allocation recommendations": "分配建议",
+  "plan.Applying...": "正在应用…",
+  "app.Allocation recommendations available": "有分配建议",
+  "plan.There are %d allocation recommendations. Confirm to update the allocation.": "有 %d 项分配建议，确认后才会更新装备分配。",
+  "plan.A recommendation appears when a more advanced starting item is available on the selected route. The allocation changes only after you confirm the update.": "当计划起点有沿所选路线更进一步的可用装备时会给出建议，确认后才会更新分配。",
+  "plan.Update allocation": "更新分配",
+  "plan.Updating...": "更新中…",
+  "plan.Update records": "更新记录",
+  "plan.Update records show successful allocation changes only and are read-only.": "这里只记录已成功更新的装备分配，仅供查看。",
+  "plan.No allocation update records yet": "暂无更新记录",
+  "plan.No allocation recommendations available": "当前没有分配建议"
 }

package/i18n/zh-TW.json

@@ -1682,5 +1682,47 @@
   "app.changelog_1_2_7_remaining_cost_fix": "修復部分已開始執行的改修計畫，其剩餘資源、開發資材、改修資材及裝備耗材可能錯誤顯示為 0 的問題。",
   "statistics.Current": "持有",
   "statistics.Equipment gaps": "裝備缺口",
-  "chain.Open the complete chain to pan and zoom": "開啟完整升級鏈後可拖動和縮放查看。"
+  "chain.Open the complete chain to pan and zoom": "開啟完整升級鏈後可拖動和縮放查看。",
+  "app.Equipment allocation": "裝備分配",
+  "app.Adjustable %d": "可調整 %d",
+  "app.Available adjustments": "可操作調整",
+  "app.Only strict progress on the current route is suggested. Nothing changes until you confirm.": "只顯示所選路線中已經推進得更遠的可用裝備；確認前不會實際調整裝備分配。",
+  "app.No allocation adjustments are currently available": "目前沒有可調整的裝備分配",
+  "app.Confirming...": "正在確認…",
+  "app.Confirm adjustment": "確認調整",
+  "app.History": "歷史",
+  "app.History is read-only and cannot be rolled back or reapplied.": "歷史僅供查看，不支援回滾或重新執行。",
+  "app.No allocation adjustment history yet": "尚無裝備分配調整歷史",
+  "app.This adjustment is no longer available. The current allocation has been refreshed.": "這項調整已失效，目前裝備分配已重新整理。",
+  "app.Allocation adjusted": "裝備分配已調整",
+  "plan.Equipment allocation": "裝備分配",
+  "plan.Adjustable %d": "可調整 %d",
+  "plan.Available adjustments": "可操作調整",
+  "plan.Only strict progress on the current route is suggested. Nothing changes until you confirm.": "只顯示所選路線中已經推進得更遠的可用裝備；確認前不會實際調整裝備分配。",
+  "plan.No allocation adjustments are currently available": "目前沒有可調整的裝備分配",
+  "plan.Confirming...": "正在確認…",
+  "plan.Confirm adjustment": "確認調整",
+  "plan.History": "歷史",
+  "plan.History is read-only and cannot be rolled back or reapplied.": "歷史僅供查看，不支援回滾或重新執行。",
+  "plan.No allocation adjustment history yet": "尚無裝備分配調整歷史",
+  "plan.This adjustment is no longer available. The current allocation has been refreshed.": "這項調整已失效，目前裝備分配已重新整理。",
+  "plan.Allocation adjusted": "裝備分配已調整",
+  "app.Allocation recommendations": "分配建議",
+  "app.A recommendation is shown only when an available item is further along the selected route. Your allocation changes only after you apply it.": "只有所選路線中存在推進得更遠的可用裝備時才會顯示推薦；只有套用推薦後才會更新目前裝備分配。",
+  "app.Applying...": "正在套用…",
+  "app.This recommendation is no longer available. The current allocation has been refreshed.": "這項推薦已失效，目前裝備分配已重新整理。",
+  "app.Recommended update applied": "推薦更新已套用",
+  "app.changelog_1_2_8_allocation_recommendations": "新增裝備分配建議：當計畫起點有更進一步的可用選擇時會提醒，確認後即可更新裝備分配。",
+  "app.changelog_1_2_8_recommendation_history": "新增推薦更新歷史，並在有待確認推薦時提供更明顯的提示。",
+  "plan.Allocation recommendations": "分配建議",
+  "plan.Applying...": "正在套用…",
+  "app.Allocation recommendations available": "有分配建議",
+  "plan.There are %d allocation recommendations. Confirm to update the allocation.": "有 %d 項分配建議，確認後才會更新裝備分配。",
+  "plan.A recommendation appears when a more advanced starting item is available on the selected route. The allocation changes only after you confirm the update.": "當計畫起點有沿所選路線更進一步的可用裝備時會提供建議，確認後才會更新分配。",
+  "plan.Update allocation": "更新分配",
+  "plan.Updating...": "更新中…",
+  "plan.Update records": "更新記錄",
+  "plan.Update records show successful allocation changes only and are read-only.": "這裡只記錄已成功更新的裝備分配，僅供查看。",
+  "plan.No allocation update records yet": "暫無更新記錄",
+  "plan.No allocation recommendations available": "目前沒有分配建議"
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "poi-plugin-remodel-assistant",
-  "version": "1.2.7",
+  "version": "1.2.8-beta.1",
   "description": "View enhanced KanColle improvement data, manage improvement plans, and receive improvement recommendations.",
   "main": "index.js",
   "author": {
@@ -27,7 +27,7 @@
     "icon": "fa/wrench",
     "id": "poi-plugin-remodel-assistant",
     "priority": 50,
-    "releaseChannel": "stable",
+    "releaseChannel": "beta",
     "title": "改修助手",
     "runtimeFlags": {
       "forceFullDecisionRebuild": false,

package/views/new-interface/app/decision-snapshot-jobs.js

@@ -31,7 +31,9 @@ const measureProfile = (profile, event, startedAt, details = {}) => {
 const prefixedProfile = (profile, prefix) => typeof profile === 'function' ? (event, durationMs, details = {}) => profile(`${prefix}.${event}`, durationMs, details) : null; // Public Decision Snapshot contract.
 //
 // UserAllocation（用户计划分配）与 ConsumableAllocation（耗材分配）属于同一个
-// Allocation Round。最终 Binding / Final Resolution 以 ConsumableAllocation 的结果为准，
+
+
+const retainedUserBindingCurrentIds = snapshot => (snapshot && snapshot.assignmentDiagnostics || []).filter(entry => entry && entry.planKind !== 'consumable' && entry.decision === 'retained').map(entry => String(entry.currentId || '').trim()).filter(Boolean); // Allocation Round。最终 Binding / Final Resolution 以 ConsumableAllocation 的结果为准，
 // 但阶段 evidence 不能只保留最后一个阶段，否则 UserAllocation 中真实发生过的
 // materialized / reallocated 等事实会被后续 retained 观察结果掩盖。
 //
@@ -109,7 +111,11 @@ const publishDecisionSnapshot = ({
     assignmentBindingTransitions: [...(userAllocation && userAllocation.assignmentBindingTransitions || []), ...(bindingTransferTransitions || []), ...(effective.assignmentBindingTransitions || [])],
     // invariant findings 读取最终阶段即可；它不是阶段历史，不做重复累积。
     assignmentFindings: effective.assignmentFindings || [],
-    assignmentDiagnostics: [...(userAllocation && userAllocation.assignmentDiagnostics || []), ...(effective.assignmentDiagnostics || [])]
+    assignmentDiagnostics: [...(userAllocation && userAllocation.assignmentDiagnostics || []), ...(effective.assignmentDiagnostics || [])],
+    // Binding Adjustment is a projection of the final Allocation state, not
+    // stage history. Publishing only the effective phase prevents a User-stage
+    // candidate from surviving after Derived Consumable Allocation claims it.
+    bindingAdjustmentActions: effective.bindingAdjustmentActions || []
   };
   logPublishedDecisionSnapshotAlignment(snapshot, effective.currentInventoryBindings || {});
   return snapshot;
@@ -262,7 +268,8 @@ const allocationStageProjection = (result, allocationScope) => ({
   bindings: result && (result.assignmentPersistenceBindings || result.currentInventoryBindings) || {},
   retainedBindingCurrentIds: result && result.retainedBindingCurrentIds || [],
   assignmentBindingTransitions: result && result.assignmentBindingTransitions || [],
-  assignmentDiagnostics: result && result.assignmentDiagnostics || []
+  assignmentDiagnostics: result && result.assignmentDiagnostics || [],
+  bindingAdjustmentActions: result && result.bindingAdjustmentActions || []
 });
 
 const buildFullDecisionSnapshotPayload = input => {
@@ -346,7 +353,8 @@ const buildFullDecisionSnapshotPayload = input => {
     plans: composition.plans,
     planRouteSelections: effectiveRouteSelections,
     currentInventoryBindings: effectiveBindings,
-    allocationScope: 'consumable'
+    allocationScope: 'consumable',
+    bindingAdjustmentEligibleCurrentIds: retainedUserBindingCurrentIds(base)
   }));
   observeAllocationStage(job, 'ConsumableAllocation', _extends({
     mode: 'full'
@@ -489,6 +497,7 @@ const buildDecisionSnapshotPayload = (input, profile = null) => {
     currentInventoryBindings: effectiveBindings,
     previous: effectivePrevious,
     allocationScope: 'consumable',
+    bindingAdjustmentEligibleCurrentIds: retainedUserBindingCurrentIds(base),
     profile: prefixedProfile(profile, 'effective')
   }));
   measureProfile(profile, 'effective-core-total', phaseStartedAt, {

package/views/new-interface/app/new-interface-area.js

@@ -35,7 +35,7 @@ var _search = require("../../shared/search");
 
 var _currentStartCandidateDomain = require("../plan/domain/current-start-candidate-domain");
 
-var _currentStartSelectionDomain = require("../plan/domain/current-start-selection-domain");
+var _planRouteSelectionDomain = require("../plan/domain/plan-route-selection-domain");
 
 var _currentPlanIdentityDomain = require("../plan/domain/current-plan-identity-domain");
 
@@ -81,6 +81,8 @@ var _materialDetailModal = require("../workbench/components/material-detail-moda
 
 var _currentStartPlannerModal = require("../plan/components/current-start-planner-modal");
 
+var _bindingAdjustmentModal = require("../plan/components/binding-adjustment-modal");
+
 var _decisionDomain = require("../decisions/domain/decision-domain");
 
 var _stableStateValidationDomain = require("../decisions/domain/stable-state-validation-domain");
@@ -238,6 +240,10 @@ class NewInterfaceArea extends _react.Component {
       detailPanelLayouts: (0, _uiPreferences.getDetailPanelLayouts)(_pluginStateStorage.pluginConfig),
       showDataTransfer: false,
       showProblemDiagnostics: false,
+      showBindingAdjustments: false,
+      bindingAdjustmentBusyKey: '',
+      bindingAdjustmentMessage: '',
+      bindingAdjustmentError: '',
       showEquipmentBlacklist: false,
       showRecommendedExclusions: false,
       showAddBlacklist: false,
@@ -372,6 +378,10 @@ class NewInterfaceArea extends _react.Component {
       workbenchActionFilter,
       showDataTransfer,
       showProblemDiagnostics,
+      showBindingAdjustments,
+      bindingAdjustmentBusyKey,
+      bindingAdjustmentMessage,
+      bindingAdjustmentError,
       showEquipmentBlacklist,
       showRecommendedExclusions,
       showAddBlacklist,
@@ -394,6 +404,9 @@ class NewInterfaceArea extends _react.Component {
     const snapshot = exactCachedSnapshot || this.currentDecisionSnapshot;
     const publishedSnapshotInputs = exactCachedSnapshot ? snapshotInputs : this.currentDecisionSnapshot ? this.currentDecisionSnapshotInputs : null;
     const snapshotReady = Boolean(snapshot);
+    const bindingAdjustmentActions = snapshot && Array.isArray(snapshot.bindingAdjustmentActions) ? snapshot.bindingAdjustmentActions : [];
+    const bindingAdjustmentHistory = (0, _pluginStateSchema.getStateBindingAdjustmentHistory)((0, _pluginStateStorage.getPluginStateSnapshot)());
+    const liveAllocationOwners = snapshot && Array.isArray(snapshot.liveAllocationOwners) ? snapshot.liveAllocationOwners : [];
     const runtimeDataDecisionRefreshPending = Boolean(snapshotReady && publishedSnapshotInputs && Number(publishedSnapshotInputs.dataRevision) !== Number(runtimeDataRevision));
     const publishedInitialDay = publishedSnapshotInputs ? publishedSnapshotInputs.initialDay : initialDay;
     const publishedMasterEquips = publishedSnapshotInputs ? publishedSnapshotInputs.masterEquips : masterEquips;
@@ -531,6 +544,11 @@ class NewInterfaceArea extends _react.Component {
       value: uiDensity,
       onChange: this.handleDensityChange
     }), _react.default.createElement(_reactBootstrap.Button, {
+      bsSize: "small",
+      bsStyle: bindingAdjustmentActions.length > 0 ? 'warning' : 'default',
+      className: `decision-binding-recommendation-trigger${bindingAdjustmentActions.length > 0 ? ' has-pending' : ''}`,
+      onClick: this.handleShowBindingAdjustments
+    }, bindingAdjustmentActions.length > 0 ? `${__('Allocation recommendations available')} · ${bindingAdjustmentActions.length}` : __('Allocation recommendations')), _react.default.createElement(_reactBootstrap.Button, {
       bsSize: "small",
       onClick: this.handleShowEquipmentBlacklist
     }, __('Equipment blacklist')), _react.default.createElement(_reactBootstrap.Button, {
@@ -653,6 +671,17 @@ class NewInterfaceArea extends _react.Component {
       staticItems: staticItems,
       onAdd: this.handleAddManualBlacklist,
       onHide: this.handleHideAddBlacklist
+    }), _react.default.createElement(_bindingAdjustmentModal.BindingAdjustmentModal, {
+      show: showBindingAdjustments,
+      actions: bindingAdjustmentActions,
+      history: bindingAdjustmentHistory,
+      liveAllocationOwners: liveAllocationOwners,
+      masterEquips: publishedMasterEquips,
+      busyActionKey: bindingAdjustmentBusyKey,
+      message: bindingAdjustmentMessage,
+      error: bindingAdjustmentError,
+      onConfirm: this.handleConfirmBindingAdjustment,
+      onHide: this.handleHideBindingAdjustments
     }), _react.default.createElement(_dataTransferModal.DataTransferModal, {
       show: showDataTransfer,
       onHide: this.handleHideDataTransfer,
@@ -1607,14 +1636,14 @@ var _initialiseProps = function () {
       const sourceOwnerRef = sourceItem && sourceItem.planOrigin && sourceItem.planOrigin.ownerRef;
       const liveOwner = (0, _allocationOwnerDomain.allocationOwnerByTransportCurrentId)(this.currentDecisionSnapshot && this.currentDecisionSnapshot.liveAllocationOwners, transportCurrentId);
       const ownerRef = sourceOwnerRef || liveOwner && liveOwner.ownerRef || null;
-      const selection = (0, _currentStartSelectionDomain.snapshotCurrentStartCandidate)(path, targetId, targetLevel, analysis, planOrdinal, ownerRef);
+      const selection = (0, _planRouteSelectionDomain.snapshotPlanRouteSelection)(path, targetId, targetLevel, analysis, planOrdinal, ownerRef);
       if (!selection) return;
       const currentId = String(selection.currentId || '').trim();
       const previousSelection = currentId ? (this.state.planRouteSelections || {})[currentId] || null : null;
       const selectionChanged = !previousSelection || String(previousSelection.currentCandidateKey || '') !== String(selection.currentCandidateKey || '');
 
       const nextSelections = _extends({}, this.state.planRouteSelections || {}, {
-        [(0, _currentStartSelectionDomain.currentStartSelectionKey)(targetId, targetLevel, planOrdinal)]: selection
+        [(0, _planRouteSelectionDomain.planRouteSelectionKey)(targetId, targetLevel, planOrdinal)]: selection
       });
 
       const nextAssignments = selectionChanged ? (0, _currentStartAssignmentDomain.clearCurrentStartAssignment)(this.planEquipmentAssignments, currentId) : this.planEquipmentAssignments; // User route intent and release of an incompatible concrete binding are one
@@ -1854,6 +1883,96 @@ var _initialiseProps = function () {
       });
     }
   });
+  Object.defineProperty(this, "handleShowBindingAdjustments", {
+    configurable: true,
+    enumerable: true,
+    writable: true,
+    value: () => {
+      this.setState({
+        showBindingAdjustments: true,
+        bindingAdjustmentMessage: '',
+        bindingAdjustmentError: ''
+      });
+    }
+  });
+  Object.defineProperty(this, "handleHideBindingAdjustments", {
+    configurable: true,
+    enumerable: true,
+    writable: true,
+    value: () => {
+      if (this.state.bindingAdjustmentBusyKey) return;
+      this.setState({
+        showBindingAdjustments: false,
+        bindingAdjustmentMessage: '',
+        bindingAdjustmentError: ''
+      });
+    }
+  });
+  Object.defineProperty(this, "handleConfirmBindingAdjustment", {
+    configurable: true,
+    enumerable: true,
+    writable: true,
+    value: actionKey => {
+      const expectedKey = String(actionKey || '').trim();
+      if (!expectedKey || this.state.bindingAdjustmentBusyKey) return Promise.resolve(null);
+      this.setState({
+        bindingAdjustmentBusyKey: expectedKey,
+        bindingAdjustmentMessage: '',
+        bindingAdjustmentError: ''
+      }); // Confirmation never trusts the Action object that was originally rendered.
+      // Re-enter the normal Decision lifecycle first, then commit only if the same
+      // semantic Action is still present in the latest finalized Allocation facts.
+
+      return this.scheduleDecisionSnapshotRefresh().then(latestSnapshot => {
+        if (!latestSnapshot) return {
+          changed: false,
+          reason: 'snapshot-unavailable'
+        };
+        const currentActions = Array.isArray(latestSnapshot.bindingAdjustmentActions) ? latestSnapshot.bindingAdjustmentActions : [];
+
+        if (!currentActions.some(action => String(action && action.actionKey || '') === expectedKey)) {
+          return {
+            changed: false,
+            reason: 'action-not-current'
+          };
+        }
+
+        return (0, _pluginStateCommands.commitBindingAdjustmentAction)({
+          actionKey: expectedKey,
+          bindingAdjustmentActions: currentActions,
+          liveAllocationOwners: latestSnapshot.liveAllocationOwners || []
+        });
+      }).then(result => {
+        if (!result || !result.changed) {
+          this.setState({
+            bindingAdjustmentBusyKey: '',
+            bindingAdjustmentMessage: __('This recommendation is no longer available. The current allocation has been refreshed.'),
+            bindingAdjustmentError: ''
+          });
+          return this.scheduleDecisionSnapshotRefresh();
+        }
+
+        this.planEquipmentAssignments = persistedPlanEquipmentAssignments();
+        this.decisionSnapshotCache = null;
+        this.decisionSnapshotRequestGate.reset();
+        return this.scheduleDecisionSnapshotRefresh().then(snapshot => {
+          this.setState({
+            bindingAdjustmentBusyKey: '',
+            bindingAdjustmentMessage: __('Recommended update applied'),
+            bindingAdjustmentError: ''
+          });
+          return snapshot;
+        });
+      }).catch(error => {
+        this.setState({
+          bindingAdjustmentBusyKey: '',
+          bindingAdjustmentMessage: '',
+          bindingAdjustmentError: String(error && error.message || error)
+        });
+        return null;
+      });
+    }
+  });
   Object.defineProperty(this, "handleDataImported", {
     configurable: true,
     enumerable: true,

package/views/new-interface/app/startup-decision-snapshot-storage.js

@@ -41,8 +41,12 @@ const readPersistentStartupDecisionSnapshot = () => {
 
     if (!isPlainObject(value) || value.format !== STARTUP_DECISION_SNAPSHOT_FORMAT || Number(value.schemaVersion) !== STARTUP_DECISION_SNAPSHOT_SCHEMA || !isPlainObject(value.snapshot)) {
       return null;
-    }
+    } // Startup snapshots are presentation-only stale state. Binding Adjustment
+    // Actions are executable projections and must be re-derived from the current
+    // session's authoritative Reality before they can be shown or confirmed.
 
+
+    value.snapshot.bindingAdjustmentActions = [];
     return value.snapshot;
   } catch (error) {
     return null;