✨ feat(vscode): PyCharm 启动命令可配置（支持 ~/绝对路径），抽 expandTilde 复用

GUI 启动的 VS Code 扩展进程 PATH 常不含 JetBrains 启动器，裸 pycharm 易 ENOENT。
新增设置 pycharmCommand（默认 pycharm），贯穿 store/settings handler/messages/
KanbanPanel 与 webview，「钩子」分组在选 PyCharm 时显示「PyCharm 启动命令」输入框。
handleOpenWorktree 用该命令并经 expandTilde 展开 ~。expandTilde 从 resolveWorktreePath
抽出共用。

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

vscode/webview-ui/src/App.tsx

@@ -447,6 +447,7 @@ export function App() {
         initialAutoBuildBranch={settings?.autoBuildBranch ?? ''}
         initialWorktreeDirectory={settings?.worktreeDirectory ?? ''}
         initialWorktreeOpenWith={settings?.worktreeOpenWith ?? 'vscode'}
+        initialPycharmCommand={settings?.pycharmCommand ?? 'pycharm'}
         initialWorktreePostCreateScript={settings?.worktreePostCreateScript ?? ''}
         initialWorktreePreRemoveScript={settings?.worktreePreRemoveScript ?? ''}
         initialImplTabPreCreateScript={settings?.implTabPreCreateScript ?? ''}

vscode/webview-ui/src/components/SettingsModal.tsx

@@ -25,6 +25,7 @@ interface SubmitValues {
   autoBuildBranch: string
   worktreeDirectory: string
   worktreeOpenWith: 'vscode' | 'pycharm'
+  pycharmCommand: string
   worktreePostCreateScript: string
   worktreePreRemoveScript: string
   implTabPreCreateScript: string
@@ -63,6 +64,7 @@ export interface SettingsModalProps {
   initialAutoBuildBranch: string
   initialWorktreeDirectory: string
   initialWorktreeOpenWith: 'vscode' | 'pycharm'
+  initialPycharmCommand: string
   initialWorktreePostCreateScript: string
   initialWorktreePreRemoveScript: string
   initialImplTabPreCreateScript: string
@@ -134,6 +136,7 @@ export function SettingsModal({
   initialAutoBuildBranch,
   initialWorktreeDirectory,
   initialWorktreeOpenWith,
+  initialPycharmCommand,
   initialWorktreePostCreateScript,
   initialWorktreePreRemoveScript,
   initialImplTabPreCreateScript,
@@ -159,6 +162,7 @@ export function SettingsModal({
   const [autoBuildBranch, setAutoBuildBranch] = useState(initialAutoBuildBranch)
   const [worktreeDirectory, setWorktreeDirectory] = useState(initialWorktreeDirectory)
   const [worktreeOpenWith, setWorktreeOpenWith] = useState(initialWorktreeOpenWith)
+  const [pycharmCommand, setPycharmCommand] = useState(initialPycharmCommand)
   const [worktreePostCreateScript, setWorktreePostCreateScript] = useState(initialWorktreePostCreateScript)
   const [worktreePreRemoveScript, setWorktreePreRemoveScript] = useState(initialWorktreePreRemoveScript)
   const [implTabPreCreateScript, setImplTabPreCreateScript] = useState(initialImplTabPreCreateScript)
@@ -263,6 +267,8 @@ export function SettingsModal({
       // worktree 目录模板：trim 后留空 = 用默认模板（getSettings 读时回退）
       worktreeDirectory: worktreeDirectory.trim(),
       worktreeOpenWith,
+      // pycharm 启动命令：trim 后留空 = 用默认 `pycharm`（getSettings 读时回退）
+      pycharmCommand: pycharmCommand.trim(),
       // 钩子路径保持原样 trim（前后空格无意义；空串 = 用默认 .spx/*.sh）
       worktreePostCreateScript: worktreePostCreateScript.trim(),
       worktreePreRemoveScript: worktreePreRemoveScript.trim(),
@@ -669,6 +675,35 @@ export function SettingsModal({
                   </select>
                 </Field>
 
+                {worktreeOpenWith === 'pycharm' && (
+                  <Field
+                    label="PyCharm 启动命令"
+                    hint={(
+                      <>
+                        可填绝对路径或
+                        {' '}
+                        <code>~</code>
+                        {' '}
+                        开头路径（如
+                        {' '}
+                        <code>~/.local/share/JetBrains/Toolbox/scripts/pycharm</code>
+                        ）；GUI 启动的 VS Code 可能找不到裸
+                        {' '}
+                        <code>pycharm</code>
+                        ，填全路径最稳。
+                      </>
+                    )}
+                  >
+                    <input
+                      type="text"
+                      value={pycharmCommand}
+                      onChange={e => setPycharmCommand(e.target.value)}
+                      placeholder="pycharm"
+                      className={inputClass}
+                    />
+                  </Field>
+                )}
+
                 <Field
                   label="worktree 创建后脚本"
                   hint={(

vscode/webview-ui/src/hooks/useIssues.ts

@@ -35,6 +35,7 @@ export interface SettingsValues {
   autoBuildBranch: string
   worktreeDirectory: string
   worktreeOpenWith: 'vscode' | 'pycharm'
+  pycharmCommand: string
   worktreePostCreateScript: string
   worktreePreRemoveScript: string
   implTabPreCreateScript: string
@@ -59,6 +60,7 @@ export interface SettingsOverlayState {
   autoBuildBranch: string
   worktreeDirectory: string
   worktreeOpenWith: 'vscode' | 'pycharm'
+  pycharmCommand: string
   worktreePostCreateScript: string
   worktreePreRemoveScript: string
   implTabPreCreateScript: string
@@ -271,6 +273,7 @@ export function useIssues(): UseIssuesResult {
       autoBuildBranch: values.autoBuildBranch,
       worktreeDirectory: values.worktreeDirectory,
       worktreeOpenWith: values.worktreeOpenWith,
+      pycharmCommand: values.pycharmCommand,
       worktreePostCreateScript: values.worktreePostCreateScript,
       worktreePreRemoveScript: values.worktreePreRemoveScript,
       implTabPreCreateScript: values.implTabPreCreateScript,
@@ -598,6 +601,7 @@ export function useIssues(): UseIssuesResult {
             autoBuildBranch: msg.autoBuildBranch,
             worktreeDirectory: msg.worktreeDirectory,
             worktreeOpenWith: msg.worktreeOpenWith,
+            pycharmCommand: msg.pycharmCommand,
             worktreePostCreateScript: msg.worktreePostCreateScript,
             worktreePreRemoveScript: msg.worktreePreRemoveScript,
             implTabPreCreateScript: msg.implTabPreCreateScript,

vscode/webview-ui/src/lib/messages.ts

@@ -78,6 +78,7 @@ export type ExtensionToWebview
       autoBuildBranch: string
       worktreeDirectory: string
       worktreeOpenWith: 'vscode' | 'pycharm'
+      pycharmCommand: string
       worktreePostCreateScript: string
       worktreePreRemoveScript: string
       implTabPreCreateScript: string
@@ -134,6 +135,7 @@ export type WebviewToExtension
       autoBuildBranch: string
       worktreeDirectory: string
       worktreeOpenWith: 'vscode' | 'pycharm'
+      pycharmCommand: string
       worktreePostCreateScript: string
       worktreePreRemoveScript: string
       implTabPreCreateScript: string