feat: add menu pin and reorder functionality

- Add pinned_items field to AppConfig for storing pinned menu items
- Add is_pinned(), pin_item(), pinned_items() methods to AppConfig
- Display pinned items at the top of main menu with 📌 icon
- Add "Manage Pins" option in Settings to toggle pin status
- Add "Reorder Pins" option in Settings to change pin order
- Support all 4 languages (en, zh-TW, zh-CN, ja)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

Author: trend-denny-lee

src/core/config.rs

@@ -14,6 +14,9 @@ pub struct AppConfig {
     /// How many common actions to show on the top menu
     #[serde(default = "default_common_actions_limit")]
     pub common_actions_limit: u32,
+    /// Pinned menu items (shown at the top)
+    #[serde(default)]
+    pub pinned_items: Vec<String>,
 }
 
 impl AppConfig {
@@ -31,6 +34,23 @@ impl AppConfig {
     pub fn common_actions_limit(&self) -> usize {
         self.common_actions_limit.max(1) as usize
     }
+
+    /// Check if an item is pinned
+    pub fn is_pinned(&self, key: &str) -> bool {
+        self.pinned_items.contains(&key.to_string())
+    }
+
+    /// Pin an item (add to the end of pinned list)
+    pub fn pin_item(&mut self, key: &str) {
+        if !self.is_pinned(key) {
+            self.pinned_items.push(key.to_string());
+        }
+    }
+
+    /// Get pinned items in order
+    pub fn pinned_items(&self) -> &[String] {
+        &self.pinned_items
+    }
 }
 
 fn default_common_actions_limit() -> u32 {

src/i18n/locales/en.toml

@@ -41,6 +41,18 @@
 "menu.language.desc" = "Switch interface language"
 "menu.exit" = "Exit"
 "menu.goodbye" = "Goodbye!"
+"menu.pinned.name" = "Pinned"
+"menu.pin.manage.name" = "Manage Pins"
+"menu.pin.manage.desc" = "Pin/unpin menu items"
+"menu.pin.prompt" = "Toggle pin status (Space to toggle, Enter to confirm)"
+"menu.pin.icon" = "📌"
+"menu.pin.count" = "{count} items pinned"
+"menu.pin.cleared" = "All pins cleared"
+"menu.pin.reorder.name" = "Reorder Pins"
+"menu.pin.reorder.desc" = "Change the order of pinned items"
+"menu.pin.reorder.prompt" = "Select items in your desired order (press Enter when done)"
+"menu.pin.reorder.done" = "Pin order updated"
+"menu.pin.reorder.empty" = "No pinned items to reorder"
 
 "settings.common_count.name" = "Common actions count"
 "settings.common_count.desc" = "Number of frequently used actions to show"

src/i18n/locales/ja.toml

@@ -41,6 +41,18 @@
 "menu.language.desc" = "インターフェース言語切替"
 "menu.exit" = "終了"
 "menu.goodbye" = "さようなら！"
+"menu.pinned.name" = "ピン留め"
+"menu.pin.manage.name" = "ピン留め管理"
+"menu.pin.manage.desc" = "ピン留め/解除"
+"menu.pin.prompt" = "ピン留めを切り替え（スペースで切替、Enter で確定）"
+"menu.pin.icon" = "📌"
+"menu.pin.count" = "{count}件をピン留めしました"
+"menu.pin.cleared" = "すべてのピン留めを解除しました"
+"menu.pin.reorder.name" = "ピン留めの並べ替え"
+"menu.pin.reorder.desc" = "ピン留め項目の順序を変更"
+"menu.pin.reorder.prompt" = "順番に選択して並べ替え（完了したら Enter）"
+"menu.pin.reorder.done" = "ピン留めの順序を更新しました"
+"menu.pin.reorder.empty" = "並べ替えるピン留め項目がありません"
 
 "settings.common_count.name" = "よく使う表示数"
 "settings.common_count.desc" = "トップに表示する件数"

src/i18n/locales/zh-CN.toml

@@ -41,6 +41,18 @@
 "menu.language.desc" = "切换界面语言"
 "menu.exit" = "退出"
 "menu.goodbye" = "再见！"
+"menu.pinned.name" = "已置顶"
+"menu.pin.manage.name" = "管理置顶"
+"menu.pin.manage.desc" = "置顶/取消置顶项目"
+"menu.pin.prompt" = "切换置顶状态（空格键切换，Enter 确认）"
+"menu.pin.icon" = "📌"
+"menu.pin.count" = "已置顶 {count} 个项目"
+"menu.pin.cleared" = "已清除所有置顶"
+"menu.pin.reorder.name" = "排序置顶"
+"menu.pin.reorder.desc" = "调整置顶项目的顺序"
+"menu.pin.reorder.prompt" = "依序选择项目以调整顺序（完成后按 Enter）"
+"menu.pin.reorder.done" = "置顶顺序已更新"
+"menu.pin.reorder.empty" = "没有可排序的置顶项目"
 
 "settings.common_count.name" = "常用显示数量"
 "settings.common_count.desc" = "顶层常用项目数量"

src/i18n/locales/zh-TW.toml

@@ -41,6 +41,18 @@
 "menu.language.desc" = "切換介面語言"
 "menu.exit" = "退出"
 "menu.goodbye" = "再見！"
+"menu.pinned.name" = "已釘選"
+"menu.pin.manage.name" = "管理釘選"
+"menu.pin.manage.desc" = "釘選/取消釘選項目"
+"menu.pin.prompt" = "切換釘選狀態（空白鍵切換，Enter 確認）"
+"menu.pin.icon" = "📌"
+"menu.pin.count" = "已釘選 {count} 個項目"
+"menu.pin.cleared" = "已清除所有釘選"
+"menu.pin.reorder.name" = "排序釘選"
+"menu.pin.reorder.desc" = "調整釘選項目的順序"
+"menu.pin.reorder.prompt" = "依序選擇項目以調整順序（完成後按 Enter）"
+"menu.pin.reorder.done" = "釘選順序已更新"
+"menu.pin.reorder.empty" = "沒有可排序的釘選項目"
 
 "settings.common_count.name" = "常用顯示數量"
 "settings.common_count.desc" = "頂層常用項目數量"

src/i18n/mod.rs

@@ -183,6 +183,18 @@ pub mod keys {
     pub const MENU_LANGUAGE_DESC: &str = "menu.language.desc";
     pub const MENU_EXIT: &str = "menu.exit";
     pub const MENU_GOODBYE: &str = "menu.goodbye";
+    pub const MENU_PINNED: &str = "menu.pinned.name";
+    pub const MENU_PIN_MANAGE: &str = "menu.pin.manage.name";
+    pub const MENU_PIN_MANAGE_DESC: &str = "menu.pin.manage.desc";
+    pub const MENU_PIN_PROMPT: &str = "menu.pin.prompt";
+    pub const MENU_PIN_ICON: &str = "menu.pin.icon";
+    pub const MENU_PIN_COUNT: &str = "menu.pin.count";
+    pub const MENU_PIN_CLEARED: &str = "menu.pin.cleared";
+    pub const MENU_PIN_REORDER: &str = "menu.pin.reorder.name";
+    pub const MENU_PIN_REORDER_DESC: &str = "menu.pin.reorder.desc";
+    pub const MENU_PIN_REORDER_PROMPT: &str = "menu.pin.reorder.prompt";
+    pub const MENU_PIN_REORDER_DONE: &str = "menu.pin.reorder.done";
+    pub const MENU_PIN_REORDER_EMPTY: &str = "menu.pin.reorder.empty";
 
     pub const LANGUAGE_SELECT_PROMPT: &str = "language.select_prompt";
     pub const LANGUAGE_CHANGED: &str = "language.changed";

src/main.rs

@@ -186,22 +186,53 @@ fn format_action_options(items: &[MenuItem]) -> Vec<String> {
         .collect()
 }
 
+fn build_pinned_actions(all_items: &[MenuItem], config: &AppConfig) -> Vec<MenuItem> {
+    config
+        .pinned_items()
+        .iter()
+        .filter_map(|key| all_items.iter().find(|item| item.name_key == key).copied())
+        .collect()
+}
+
 fn format_top_level_options(
+    pinned_actions: &[MenuItem],
     common_actions: &[MenuItem],
     categories: &[Category],
 ) -> Vec<TopLevelOption> {
     let settings_name = i18n::t(keys::MENU_SETTINGS);
     let settings_desc = i18n::t(keys::MENU_SETTINGS_DESC);
+    let pin_icon = i18n::t(keys::MENU_PIN_ICON);
 
-    let max_name_width = common_actions
+    let max_name_width = pinned_actions
         .iter()
+        .chain(common_actions.iter())
         .map(|item| i18n::t(item.name_key).width())
         .chain(categories.iter().map(|cat| i18n::t(cat.name_key).width()))
         .max()
         .unwrap_or(0);
 
     let mut options = Vec::new();
 
+    // Pinned header (only show if there are pinned items)
+    if !pinned_actions.is_empty() {
+        options.push(TopLevelOption {
+            label: format!("{} {}", pin_icon, i18n::t(keys::MENU_PINNED)),
+            choice: TopLevelChoice::Header,
+            selectable: false,
+        });
+
+        for item in pinned_actions {
+            let name = format!("  {}", i18n::t(item.name_key));
+            let desc = i18n::t(item.desc_key);
+            let padding = max_name_width.saturating_sub(name.trim_start().width());
+            options.push(TopLevelOption {
+                label: format!("{}{} — {}", name, " ".repeat(padding), desc),
+                choice: TopLevelChoice::Action(*item),
+                selectable: true,
+            });
+        }
+    }
+
     // Common header
     options.push(TopLevelOption {
         label: i18n::t(keys::MENU_COMMON).to_string(),
@@ -294,6 +325,8 @@ fn open_settings(prompts: &Prompts, console: &Console) {
                 keys::SETTINGS_COMMON_COUNT_NAME,
                 keys::SETTINGS_COMMON_COUNT_DESC,
             ),
+            (keys::MENU_PIN_MANAGE, keys::MENU_PIN_MANAGE_DESC),
+            (keys::MENU_PIN_REORDER, keys::MENU_PIN_REORDER_DESC),
         ];
 
         let max_name_width = settings_items
@@ -325,6 +358,8 @@ fn open_settings(prompts: &Prompts, console: &Console) {
         match selection_opt {
             Some(0) => select_language(prompts, console),
             Some(1) => configure_common_actions(prompts, console, &mut config),
+            Some(2) => manage_pins(console, &mut config),
+            Some(3) => reorder_pins(console, &mut config),
             _ => break,
         }
     }
@@ -355,6 +390,136 @@ fn configure_common_actions(prompts: &Prompts, console: &Console, config: &mut A
     }
 }
 
+fn manage_pins(console: &Console, config: &mut AppConfig) {
+    use dialoguer::MultiSelect;
+
+    let actions = all_actions();
+    let pin_icon = i18n::t(keys::MENU_PIN_ICON);
+
+    // Build options with pin status
+    let options: Vec<String> = actions
+        .iter()
+        .map(|item| {
+            let name = i18n::t(item.name_key);
+            let desc = i18n::t(item.desc_key);
+            if config.is_pinned(item.name_key) {
+                format!("{} {} — {}", pin_icon, name, desc)
+            } else {
+                format!("  {} — {}", name, desc)
+            }
+        })
+        .collect();
+
+    // Get currently pinned indices
+    let defaults: Vec<bool> = actions
+        .iter()
+        .map(|item| config.is_pinned(item.name_key))
+        .collect();
+
+    let option_refs: Vec<&str> = options.iter().map(|s| s.as_str()).collect();
+
+    let selection = MultiSelect::with_theme(&ColorfulTheme::default())
+        .with_prompt(i18n::t(keys::MENU_PIN_PROMPT))
+        .items(&option_refs)
+        .defaults(&defaults)
+        .interact_opt();
+
+    if let Ok(Some(selected)) = selection {
+        // Clear all pins and re-add selected ones
+        config.pinned_items.clear();
+        for idx in selected {
+            config.pin_item(actions[idx].name_key);
+        }
+
+        match save_config(config) {
+            Ok(_) => {
+                let count = config.pinned_items().len();
+                if count > 0 {
+                    console.success(&format!(
+                        "{} {}",
+                        pin_icon,
+                        crate::tr!(keys::MENU_PIN_COUNT, count = count)
+                    ));
+                } else {
+                    console.info(i18n::t(keys::MENU_PIN_CLEARED));
+                }
+            }
+            Err(err) => console.warning(&crate::tr!(keys::CONFIG_SAVE_FAILED, error = err)),
+        }
+    }
+}
+
+fn reorder_pins(console: &Console, config: &mut AppConfig) {
+    use dialoguer::Select;
+
+    let actions = all_actions();
+    let pinned_keys: Vec<String> = config.pinned_items().to_vec();
+
+    if pinned_keys.is_empty() {
+        console.info(i18n::t(keys::MENU_PIN_REORDER_EMPTY));
+        return;
+    }
+
+    // Get display names for pinned items
+    let pinned_items: Vec<(&str, String)> = pinned_keys
+        .iter()
+        .filter_map(|key| {
+            actions
+                .iter()
+                .find(|a| a.name_key == key)
+                .map(|a| (a.name_key, i18n::t(a.name_key).to_string()))
+        })
+        .collect();
+
+    let mut new_order: Vec<&str> = Vec::new();
+    let mut remaining: Vec<(&str, String)> = pinned_items;
+
+    while !remaining.is_empty() {
+        let options: Vec<String> = remaining
+            .iter()
+            .enumerate()
+            .map(|(i, (_, name))| format!("{}. {}", i + 1, name))
+            .collect();
+
+        let prompt = format!(
+            "{} ({}/{})",
+            i18n::t(keys::MENU_PIN_REORDER_PROMPT),
+            new_order.len() + 1,
+            new_order.len() + remaining.len()
+        );
+
+        let option_refs: Vec<&str> = options.iter().map(|s| s.as_str()).collect();
+
+        let selection = Select::with_theme(&ColorfulTheme::default())
+            .with_prompt(&prompt)
+            .items(&option_refs)
+            .default(0)
+            .interact_opt();
+
+        match selection {
+            Ok(Some(idx)) => {
+                let (key, _) = remaining.remove(idx);
+                new_order.push(key);
+            }
+            _ => {
+                // User cancelled - keep original order
+                return;
+            }
+        }
+    }
+
+    // Update config with new order
+    config.pinned_items.clear();
+    for key in new_order {
+        config.pinned_items.push(key.to_string());
+    }
+
+    match save_config(config) {
+        Ok(_) => console.success(i18n::t(keys::MENU_PIN_REORDER_DONE)),
+        Err(err) => console.warning(&crate::tr!(keys::CONFIG_SAVE_FAILED, error = err)),
+    }
+}
+
 fn main() {
     let prompts = Prompts::new();
     let console = Console::new();
@@ -367,8 +532,9 @@ fn main() {
         let config = load_config().ok().flatten().unwrap_or_default();
         let actions = all_actions();
         let categories = build_categories(&actions);
+        let pinned_actions = build_pinned_actions(&actions, &config);
         let common_actions = build_common_actions(actions.clone(), &config);
-        let options = format_top_level_options(&common_actions, &categories);
+        let options = format_top_level_options(&pinned_actions, &common_actions, &categories);
         let option_refs: Vec<&str> = options.iter().map(|opt| opt.label.as_str()).collect();
 
         let default_index = options.iter().position(|opt| opt.selectable).unwrap_or(0);