@sglwsjxh/ffix 1.0.1

package/.github/workflows/build_and_publish.yml

@@ -0,0 +1,44 @@
+name: Build and Publish
+
+on:
+  push:
+    tags:
+      - "v*"
+
+permissions:
+  contents: write
+  packages: write
+  id-token: write
+
+jobs:
+  publish:
+    name: Build and publish
+    runs-on: windows-latest
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js for npm
+        uses: actions/setup-node@v4
+        with:
+          node-version: "22"
+          registry-url: "https://registry.npmjs.org/"
+
+      - name: Install dependencies
+        run: npm install --no-package-lock
+
+      - name: Build package
+        run: npm run build
+
+      - name: Create GitHub Release
+        uses: softprops/action-gh-release@v2
+        with:
+          generate_release_notes: true
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Publish to npm
+        run: npm publish --access public
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 清木殇
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,49 @@
+# ffix ? fuck fix !!
+
+在 powershell 里敲错命令了？  **fuck !!**
+
+```powershell
+PS C:\Users\mark3> got branch  
+got: 我不认识这个命令  
+PS C:\Users\mark3> fuck  
+→ 建议执行：git branch
+```
+
+按 Enter 就执行了，就是这么简单
+
+## 它干了什么
+
+你敲错命令 → fuck 拿到报错 → 丢给 AI → 返回修复命令 → 你确认后执行
+
+## 安装方法
+
+```powershell
+npm i -g @sglwsjxh/ffix@latest
+fuck install
+pwsh
+```
+
+## 使用方法
+
+```powershell
+# 敲错命令了
+git brnch
+
+# 让 AI 修一下
+fuck
+# → 建议执行：git branch
+# 按 Enter 执行，Ctrl+C 取消
+```
+
+## 运行环境
+
+- PowerShell 7
+- Node.js 18+
+- OpenAI 兼容的 api
+
+## 从源码开发
+
+```powershell
+npm run build        # 编译
+npx tsx src/main.ts  # 直接跑源码
+```

package/config/config.example.json

@@ -0,0 +1,5 @@
+{
+    "baseUrl": "YOUR_BASE_URL",
+    "apiKey": "YOUR_API_KEY",
+    "model": "YOUR_MODEL"
+}

package/dist/main.js

@@ -0,0 +1,114 @@
+#!/usr/bin/env node
+import{readFile as _,unlink as L}from"fs/promises";import{readFile as $,writeFile as I,mkdir as M}from"fs/promises";import{join as h}from"path";import{homedir as N}from"os";var P=h(N(),".ffix"),c=h(P,"config.json"),p={baseUrl:"",apiKey:"",model:""},R={stderrTailLines:20,timeoutMs:15e3,tempFilePath:"%TEMP%\\fuck_ctx.json"};async function w(){try{await $(c,"utf-8")}catch{await M(P,{recursive:!0}),await I(c,JSON.stringify(p,null,4),"utf-8"),console.log(`\u9996\u6B21\u4F7F\u7528\uFF0C\u8BF7\u914D\u7F6E API \u4FE1\u606F\uFF1A${c}`)}}async function y(){let t=await $(c,"utf-8"),e=JSON.parse(t);if(!e.apiKey)throw new Error(`\u8BF7\u5728 ${c} \u4E2D\u914D\u7F6E apiKey`);return{baseUrl:e.baseUrl||p.baseUrl,apiKey:e.apiKey,model:e.model||p.model}}async function m(){return R}function v(t){let e=process.env.TEMP??process.env.TMPDIR??"";return t.replace(/%TEMP%/g,e)}async function b(){let t=await m(),e=v(t.tempFilePath);return U(e)}async function U(t){try{let e=await _(t,"utf-8"),o=JSON.parse(e);return typeof o.lastCommand!="string"||o.lastCommand.length===0||typeof o.exitCode!="number"?null:o}catch{return null}finally{try{await L(t)}catch{}}}var D=`\u4F60\u662F\u4E00\u4E2A PowerShell 7 \u547D\u4EE4\u4FEE\u590D\u52A9\u624B\uFF0C\u5206\u6790\u5931\u8D25\u547D\u4EE4\u5E76\u7ED9\u51FA\u4FEE\u590D\u547D\u4EE4
+
+\u4E25\u683C\u8981\u6C42\uFF1A
+1. \u53EA\u8FD4\u56DE JSON\uFF0C\u4E0D\u8981\u591A\u4F59\u6587\u5B57
+2. JSON \u683C\u5F0F\u4E25\u683C\u56FA\u5B9A\u4E3A {"command": "\u4FEE\u590D\u547D\u4EE4", "confidence": "high|medium|low"}
+3. command \u5FC5\u987B\u662F PowerShell 7 \u53EF\u76F4\u63A5\u6267\u884C\u7684\u4E00\u6761\u547D\u4EE4
+4. \u65E0\u6CD5\u4FEE\u590D\u65F6\u8FD4\u56DE {"command": "", "confidence": "low"}
+5. \u4E0D\u8981\u751F\u6210 bash/zsh \u547D\u4EE4
+6. \u4E0D\u8981\u5047\u8BBE\u7528\u6237\u60F3\u5B89\u88C5\u8F6F\u4EF6`;function G(t){return`\u4E0A\u4E00\u6761\u547D\u4EE4\u6267\u884C\u5931\u8D25\uFF0C\u4EE5\u4E0B\u662F\u4E0A\u4E0B\u6587\uFF1A
+
+\u547D\u4EE4\uFF1A${t.lastCommand}
+\u9000\u51FA\u7801\uFF1A${t.exitCode}
+\u9519\u8BEF\u4FE1\u606F\uFF1A${t.errorOutput}
+\u5F53\u524D\u76EE\u5F55\uFF1A${t.cwd}
+\u64CD\u4F5C\u7CFB\u7EDF\uFF1A${t.os}
+Shell\uFF1A${t.shell}`}async function F(t){try{let[e,o]=await Promise.all([y(),m()]),r=`${e.baseUrl.replace(/\/+$/,"")}/chat/completions`,i=JSON.stringify({model:e.model,messages:[{role:"system",content:D},{role:"user",content:G(t)}],temperature:.2,max_tokens:1024}),s=new AbortController,u=setTimeout(()=>s.abort(),o.timeoutMs),n;try{n=await fetch(r,{method:"POST",headers:{"Content-Type":"application/json",Authorization:`Bearer ${e.apiKey}`},body:i,signal:s.signal})}finally{clearTimeout(u)}if(!n.ok){let j=await n.text();return console.error(`[llm] API returned status ${n.status}: ${j}`),null}let d=(await n.json())?.choices?.[0]?.message?.content;if(!d)return console.error("[llm] No content in response"),null;let a;try{a=JSON.parse(d)}catch{return console.error("[llm] Failed to parse LLM response as JSON:",d),null}let f=a.command??a.recommended_command??"";if(!f)return null;let l=String(a.confidence??"");return l&&!["high","medium","low"].includes(l)?{command:f}:{command:f,...l?{confidence:l}:{}}}catch(e){return e instanceof DOMException&&e.name==="AbortError"?console.error("[llm] Request timed out"):console.error("[llm] Request failed:",e),null}}import{readFile as S,writeFile as g,mkdir as J}from"fs/promises";import{join as k}from"path";import{homedir as O}from"os";function E(){return k(O(),"Documents","PowerShell","Microsoft.PowerShell_profile.ps1")}function H(){return`# >>> fuck init >>>
+
+# CLI \u5165\u53E3\u8DEF\u5F84\uFF08\u901A\u8FC7 npm root -g \u52A8\u6001\u83B7\u53D6\uFF0C\u4E0D\u5199\u6B7B\u8DEF\u5F84\uFF09
+$Fuck_NodeCli = "$(npm root -g)\\@sglwsjxh\\ffix\\dist\\main.js"
+
+# \u91C7\u96C6\u5931\u8D25\u547D\u4EE4\u7684\u4E0A\u4E0B\u6587\u5230\u4E34\u65F6\u6587\u4EF6
+function Write-FuckContext {
+    # \u51FD\u6570\u5F00\u5934\u7ACB\u523B\u4FDD\u5B58\u5173\u952E\u72B6\u6001\uFF0C\u907F\u514D\u540E\u7EED\u547D\u4EE4\u8986\u76D6
+    $lastSuccess = $?
+    $exitCode = $global:LASTEXITCODE
+
+    # Channel A: \u4F1A\u8BDD\u5386\u53F2\uFF08\u5FEB\u901F\u8DEF\u5F84\uFF09
+    $lastCmd = Get-History -Count 1 | Select-Object -ExpandProperty CommandLine -ErrorAction SilentlyContinue
+
+    # Channel B: PSReadLine \u5386\u53F2\u6587\u4EF6\u56DE\u9000\uFF08\u89E3\u51B3 PS7 \u5F02\u6B65\u5386\u53F2\u5BFC\u81F4 Get-History \u8FD4\u56DE null \u7684\u95EE\u9898\uFF09
+    if (-not $lastCmd) {
+        try {
+            $option = Get-PSReadLineOption -ErrorAction Stop
+            $historyPath = $option.HistorySavePath
+            if ($historyPath -and (Test-Path $historyPath)) {
+                $lines = Get-Content $historyPath -Tail 20 -ErrorAction Stop
+                $lastCmd = $lines |
+                    Where-Object { $_ -and ($_ -notmatch '^s*fuck(s|$)') } |
+                    Select-Object -Last 1
+            }
+        } catch {
+            # PSReadLine \u4E0D\u53EF\u7528\u65F6\u9759\u9ED8\u8DF3\u8FC7
+        }
+    }
+
+    if (-not $lastCmd) { return }
+
+    if ($exitCode -ne 0 -or -not $lastSuccess) {
+        $effectiveExitCode = if ($exitCode -ne 0) { $exitCode } else { 1 }
+        $errorMsg = if ($Error[0]) { $Error[0].Exception.Message } else { '' }
+        $ctx = @{
+            lastCommand = $lastCmd
+            exitCode    = $effectiveExitCode
+            errorOutput = $errorMsg
+            cwd         = (Get-Location).Path
+            shell       = 'powershell-7'
+            os          = 'win32'
+            timestamp   = (Get-Date -Format 'yyyy-MM-ddTHH:mm:ss.fffZ')
+        }
+        $ctx | ConvertTo-Json -Compress | Out-File -FilePath "$env:TEMP\\fuck_ctx.json" -Encoding utf8
+    }
+}
+
+# \u4FDD\u5B58\u539F\u59CB prompt \u51FD\u6570\uFF0C\u786E\u4FDD\u4E0D\u7834\u574F\u7528\u6237\u81EA\u5B9A\u4E49\u7684 prompt
+$Fuck_OriginalPrompt = \${function:prompt}
+
+# \u91CD\u5199 prompt \u51FD\u6570\uFF1A\u5728\u6BCF\u6B21\u663E\u793A\u63D0\u793A\u7B26\u524D\u91C7\u96C6\u4E0A\u4E0B\u6587\uFF0C\u7136\u540E\u6062\u590D\u539F\u59CB\u884C\u4E3A
+function prompt {
+    Write-FuckContext
+    & $Fuck_OriginalPrompt
+}
+
+# fuck \u547D\u4EE4\uFF1A\u8BFB\u53D6\u4E0A\u4E0B\u6587 \u2192 \u8C03\u7528 CLI\uFF08\u5E26\u786E\u8BA4\uFF09\u2192 \u6355\u83B7 stdout \u2192 iex \u6267\u884C
+function fuck {
+    $ctxPath = "$env:TEMP\\fuck_ctx.json"
+    if (-not (Test-Path $ctxPath)) {
+        Write-Host "\u6CA1\u6709\u627E\u5230\u4E0A\u4E00\u6761\u547D\u4EE4\u7684\u4E0A\u4E0B\u6587"
+        return
+    }
+
+    $ctx = Get-Content $ctxPath -Raw | ConvertFrom-Json
+    if (-not $ctx) {
+        Write-Host "\u6CA1\u6709\u627E\u5230\u4E0A\u4E00\u6761\u547D\u4EE4\u7684\u4E0A\u4E0B\u6587"
+        return
+    }
+
+    # \u8BFB\u53D6\u540E\u7ACB\u5373\u5220\u9664\uFF0C\u907F\u514D\u88AB\u4E0B\u4E00\u8F6E prompt hook \u8986\u76D6
+    Remove-Item $ctxPath -Force -ErrorAction SilentlyContinue
+
+    $command = & node "$Fuck_NodeCli" --cmd "$($ctx.lastCommand)" --exit-code $ctx.exitCode --error-output "$($ctx.errorOutput)" --cwd "$($ctx.cwd)" --confirm
+
+    if (-not [string]::IsNullOrWhiteSpace($command)) {
+        iex "$command"
+    }
+
+    [Console]::ResetColor()
+}
+
+# <<< fuck init <<<`}async function A(){let t=E();await J(k(O(),"Documents","PowerShell"),{recursive:!0});let e="";try{e=await S(t,"utf-8")}catch{}if(e.includes("# >>> fuck init >>>")){console.log("fuck \u5DF2\u7ECF\u5B89\u88C5\u5230 $PROFILE\uFF0C\u8DF3\u8FC7");return}await g(t+".bak",e,"utf-8");let o=H();await g(t,e+(e?`
+`:"")+o,"utf-8"),console.log(`\u5DF2\u5B89\u88C5\u5230 ${t}`)}async function T(){let t=E(),e;try{e=await S(t,"utf-8")}catch{console.log("\u6CA1\u6709\u627E\u5230 $PROFILE");return}let o="# >>> fuck init >>>",r="# <<< fuck init <<<",i=e.indexOf(o);if(i===-1){console.log("\u6CA1\u6709\u627E\u5230 fuck \u6CE8\u5165\u5185\u5BB9");return}let s=e.indexOf(r,i);if(s===-1){console.log("\u9519\u8BEF\uFF1A\u6CE8\u5165\u6807\u8BB0\u4E0D\u5B8C\u6574\uFF0C\u8BF7\u624B\u52A8\u68C0\u67E5 $PROFILE");return}let u=e.substring(0,i),n=e.substring(s+r.length),C=n.startsWith(`\r
+`)?n.substring(2):n.startsWith(`
+`)?n.substring(1):n;await g(t,u+C,"utf-8"),console.log("\u5DF2\u4ECE $PROFILE \u5378\u8F7D")}var x=t=>process.stderr.write(t);function W(){return new Promise(t=>{process.stdin.setRawMode(!0),process.stdin.resume(),process.stdin.once("data",e=>{process.stdin.pause(),process.stdin.setRawMode(!1),t(e.toString())})})}function q(t){let e={json:!1,quiet:!1,confirm:!1};for(let o=0;o<t.length;o++)switch(t[o]){case"install":e.subcommand="install";break;case"uninstall":e.subcommand="uninstall";break;case"--cmd":e.cmd=t[++o];break;case"--exit-code":e.exitCode=Number(t[++o]);break;case"--error-output":e.errorOutput=t[++o];break;case"--cwd":e.cwd=t[++o];break;case"--json":e.json=!0;break;case"--quiet":e.quiet=!0;break;case"--confirm":e.confirm=!0;break}return e}function K(t){return{lastCommand:t.cmd,exitCode:t.exitCode,errorOutput:t.errorOutput??"",cwd:t.cwd??process.cwd(),shell:"powershell-7",os:"win32",timestamp:new Date().toISOString()}}async function B(){let t=q(process.argv.slice(2));if(t.subcommand==="install"){await A();return}if(t.subcommand==="uninstall"){await T();return}await w();let e=null;t.cmd&&t.exitCode!==void 0&&!Number.isNaN(t.exitCode)?e=K(t):e=await b(),e||(console.error("\u6CA1\u6709\u627E\u5230\u4E0A\u4E00\u6761\u547D\u4EE4\u7684\u4E0A\u4E0B\u6587"),process.exit(1));let o=await F(e);if((!o||!o.command)&&(console.error("\u6CA1\u80FD\u627E\u5230\u4FEE\u590D\u65B9\u6848"),process.exit(1)),t.confirm){x(`\u4E0A\u4E00\u6761\u547D\u4EE4\uFF1A${e.lastCommand}
+
+`),x(`\x1B[32m\u2726  \u5EFA\u8BAE\u6267\u884C\uFF1A${o.command}\x1B[0m
+
+`),x("Enter = \u6267\u884C    Ctrl+C = \u53D6\u6D88");try{let r=await W();(r==="\r"||r===`
+`)&&(process.stderr.write(`
+
+\x1B[32m> ${o.command}\x1B[0m
+`),process.stdout.write(o.command),process.exit(0)),process.stderr.write(`
+
+\u5DF2\u53D6\u6D88
+`),process.exit(1)}catch{process.exit(1)}}t.json?console.log(JSON.stringify({command:o.command,confidence:o.confidence??"medium"})):(t.quiet,console.log(o.command)),process.exit(0)}B().catch(t=>{console.error(t),process.exit(1)});

package/package.json

@@ -0,0 +1,21 @@
+{
+  "name": "@sglwsjxh/ffix",
+  "version": "1.0.1",
+  "type": "module",
+  "bin": {
+    "fuck": "./dist/main.js"
+  },
+  "scripts": {
+    "dev": "tsx src/main.ts",
+    "build": "tsup src/main.ts --clean --minify --format esm",
+    "typecheck": "tsc --noEmit",
+    "prepublish": "npm run build"
+  },
+  "dependencies": {},
+  "devDependencies": {
+    "typescript": "*",
+    "tsup": "*",
+    "tsx": "*",
+    "@types/node": "*"
+  }
+}

package/src/config.ts

@@ -0,0 +1,49 @@
+import { readFile, writeFile, mkdir } from 'node:fs/promises'
+import { join } from 'node:path'
+import { homedir } from 'node:os'
+
+import type { UserConfig, AppConfig } from './types.js'
+
+const CONFIG_DIR = join(homedir(), '.ffix')
+const CONFIG_PATH = join(CONFIG_DIR, 'config.json')
+
+const DEFAULT_USER_CONFIG: UserConfig = {
+  baseUrl: '',
+  apiKey: '',
+  model: '',
+}
+
+const DEFAULT_APP_CONFIG: AppConfig = {
+  stderrTailLines: 20,
+  timeoutMs: 15_000,
+  tempFilePath: '%TEMP%\\fuck_ctx.json',
+}
+
+export async function ensureConfig(): Promise<void> {
+  try {
+    await readFile(CONFIG_PATH, 'utf-8')
+  } catch {
+    await mkdir(CONFIG_DIR, { recursive: true })
+    await writeFile(CONFIG_PATH, JSON.stringify(DEFAULT_USER_CONFIG, null, 4), 'utf-8')
+    console.log(`首次使用，请配置 API 信息：${CONFIG_PATH}`)
+  }
+}
+
+export async function loadUserConfig(): Promise<UserConfig> {
+  const raw = await readFile(CONFIG_PATH, 'utf-8')
+  const config: UserConfig = JSON.parse(raw)
+
+  if (!config.apiKey) {
+    throw new Error(`请在 ${CONFIG_PATH} 中配置 apiKey`)
+  }
+
+  return {
+    baseUrl: config.baseUrl || DEFAULT_USER_CONFIG.baseUrl,
+    apiKey: config.apiKey,
+    model: config.model || DEFAULT_USER_CONFIG.model,
+  }
+}
+
+export async function loadAppConfig(): Promise<AppConfig> {
+  return DEFAULT_APP_CONFIG
+}

package/src/context.ts

@@ -0,0 +1,30 @@
+import type { FixContext } from './types.js'
+import { readFile, unlink } from 'node:fs/promises'
+import { loadAppConfig } from './config.js'
+
+function resolveTempPath(template: string): string {
+  const tempDir = process.env.TEMP ?? process.env.TMPDIR ?? ''
+  return template.replace(/%TEMP%/g, tempDir)
+}
+
+export async function readContext(): Promise<FixContext | null> {
+  const appConfig = await loadAppConfig()
+  const filePath = resolveTempPath(appConfig.tempFilePath)
+  return readContextFromPath(filePath)
+}
+
+export async function readContextFromPath(filePath: string): Promise<FixContext | null> {
+  try {
+    const raw = await readFile(filePath, 'utf-8')
+    const ctx: FixContext = JSON.parse(raw)
+
+    if (typeof ctx.lastCommand !== 'string' || ctx.lastCommand.length === 0) return null
+    if (typeof ctx.exitCode !== 'number') return null
+
+    return ctx
+  } catch {
+    return null
+  } finally {
+    try { await unlink(filePath) } catch { }
+  }
+}

package/src/llm.ts

@@ -0,0 +1,106 @@
+import type { FixContext, FixSuggestion } from './types.js'
+import { loadUserConfig, loadAppConfig } from './config.js'
+
+const SYSTEM_PROMPT = `你是一个 PowerShell 7 命令修复助手，分析失败命令并给出修复命令
+
+严格要求：
+1. 只返回 JSON，不要多余文字
+2. JSON 格式严格固定为 {"command": "修复命令", "confidence": "high|medium|low"}
+3. command 必须是 PowerShell 7 可直接执行的一条命令
+4. 无法修复时返回 {"command": "", "confidence": "low"}
+5. 不要生成 bash/zsh 命令
+6. 不要假设用户想安装软件`
+
+function buildUserPrompt(context: FixContext): string {
+  return `上一条命令执行失败，以下是上下文：
+
+命令：${context.lastCommand}
+退出码：${context.exitCode}
+错误信息：${context.errorOutput}
+当前目录：${context.cwd}
+操作系统：${context.os}
+Shell：${context.shell}`
+}
+
+export async function getFixSuggestion(context: FixContext): Promise<FixSuggestion | null> {
+  try {
+    const [userConfig, appConfig] = await Promise.all([
+      loadUserConfig(),
+      loadAppConfig(),
+    ])
+
+    const url = `${userConfig.baseUrl.replace(/\/+$/, '')}/chat/completions`
+
+    const body = JSON.stringify({
+      model: userConfig.model,
+      messages: [
+        { role: 'system', content: SYSTEM_PROMPT },
+        { role: 'user', content: buildUserPrompt(context) },
+      ],
+      temperature: 0.2,
+      max_tokens: 1024,
+    })
+
+    const controller = new AbortController()
+    const timeoutId = setTimeout(() => controller.abort(), appConfig.timeoutMs)
+
+    let response: Response
+    try {
+      response = await fetch(url, {
+        method: 'POST',
+        headers: {
+          'Content-Type': 'application/json',
+          'Authorization': `Bearer ${userConfig.apiKey}`,
+        },
+        body,
+        signal: controller.signal,
+      })
+    } finally {
+      clearTimeout(timeoutId)
+    }
+
+    if (!response.ok) {
+      const responseBody = await response.text()
+      console.error(`[llm] API returned status ${response.status}: ${responseBody}`)
+      return null
+    }
+
+    const json = await response.json() as { choices?: Array<{ message?: { content?: string } }> }
+
+    const content = json?.choices?.[0]?.message?.content
+    if (!content) {
+      console.error('[llm] No content in response')
+      return null
+    }
+
+    let parsed: Record<string, unknown>
+    try {
+      parsed = JSON.parse(content)
+    } catch {
+      console.error('[llm] Failed to parse LLM response as JSON:', content)
+      return null
+    }
+
+    const cmd = (parsed.command ?? parsed.recommended_command ?? '') as string
+    if (!cmd) {
+      return null
+    }
+
+    const confidence = String(parsed.confidence ?? '') as FixSuggestion['confidence']
+    if (confidence && !['high', 'medium', 'low'].includes(confidence)) {
+      return { command: cmd }
+    }
+
+    return {
+      command: cmd,
+      ...(confidence ? { confidence } : {}),
+    }
+  } catch (err) {
+    if (err instanceof DOMException && err.name === 'AbortError') {
+      console.error('[llm] Request timed out')
+    } else {
+      console.error('[llm] Request failed:', err)
+    }
+    return null
+  }
+}

package/src/main.ts

@@ -0,0 +1,155 @@
+#!/usr/bin/env node
+
+import { readContext } from './context.js'
+import { getFixSuggestion } from './llm.js'
+import { install, uninstall } from './shell.js'
+import { ensureConfig } from './config.js'
+import type { FixContext } from './types.js'
+
+const w = (s: string) => process.stderr.write(s)
+
+function keyPress(): Promise<string> {
+  return new Promise((resolve) => {
+    process.stdin.setRawMode(true)
+    process.stdin.resume()
+    process.stdin.once('data', (data) => {
+      process.stdin.pause()
+      process.stdin.setRawMode(false)
+      resolve(data.toString())
+    })
+  })
+}
+
+interface CliArgs {
+  subcommand?: 'install' | 'uninstall'
+  cmd?: string
+  exitCode?: number
+  errorOutput?: string
+  cwd?: string
+  json: boolean
+  quiet: boolean
+  confirm: boolean
+}
+
+function parseArgs(argv: string[]): CliArgs {
+  const args: CliArgs = { json: false, quiet: false, confirm: false }
+
+  for (let i = 0; i < argv.length; i++) {
+    switch (argv[i]) {
+      case 'install':
+        args.subcommand = 'install'
+        break
+      case 'uninstall':
+        args.subcommand = 'uninstall'
+        break
+      case '--cmd':
+        args.cmd = argv[++i]
+        break
+      case '--exit-code':
+        args.exitCode = Number(argv[++i])
+        break
+      case '--error-output':
+        args.errorOutput = argv[++i]
+        break
+      case '--cwd':
+        args.cwd = argv[++i]
+        break
+      case '--json':
+        args.json = true
+        break
+      case '--quiet':
+        args.quiet = true
+        break
+      case '--confirm':
+        args.confirm = true
+        break
+    }
+  }
+
+  return args
+}
+
+function buildContextFromArgs(args: CliArgs): FixContext {
+  return {
+    lastCommand: args.cmd!,
+    exitCode: args.exitCode!,
+    errorOutput: args.errorOutput ?? '',
+    cwd: args.cwd ?? process.cwd(),
+    shell: 'powershell-7',
+    os: 'win32',
+    timestamp: new Date().toISOString(),
+  }
+}
+
+async function main(): Promise<void> {
+  const args = parseArgs(process.argv.slice(2))
+
+  if (args.subcommand === 'install') {
+    await install()
+    return
+  }
+
+  if (args.subcommand === 'uninstall') {
+    await uninstall()
+    return
+  }
+
+  await ensureConfig()
+
+  let context: FixContext | null = null
+
+  if (args.cmd && args.exitCode !== undefined && !Number.isNaN(args.exitCode)) {
+    context = buildContextFromArgs(args)
+  } else {
+    context = await readContext()
+  }
+
+  if (!context) {
+    console.error('没有找到上一条命令的上下文')
+    process.exit(1)
+  }
+
+  const suggestion = await getFixSuggestion(context)
+
+  if (!suggestion || !suggestion.command) {
+    console.error('没能找到修复方案')
+    process.exit(1)
+  }
+
+  if (args.confirm) {
+    w(`上一条命令：${context.lastCommand}\n\n`)
+    w(`\x1b[32m✦  建议执行：${suggestion.command}\x1b[0m\n\n`)
+    w('Enter = 执行    Ctrl+C = 取消')
+
+    try {
+      const key = await keyPress()
+      if (key === '\r' || key === '\n') {
+        process.stderr.write(`\n\n\x1b[32m> ${suggestion.command}\x1b[0m\n`)
+        process.stdout.write(suggestion.command)
+        process.exit(0)
+      }
+      process.stderr.write('\n\n已取消\n')
+      process.exit(1)
+    } catch {
+      process.exit(1)
+    }
+  }
+
+  if (args.json) {
+    console.log(JSON.stringify({
+      command: suggestion.command,
+      confidence: suggestion.confidence ?? 'medium',
+    }))
+  } else if (args.quiet) {
+    console.log(suggestion.command)
+  } else {
+    console.log(suggestion.command)
+  }
+
+  process.exit(0)
+}
+
+main().catch((err: unknown) => {
+  console.error(err)
+  process.exit(1)
+})

package/src/shell.ts

@@ -0,0 +1,184 @@
+import { readFile, writeFile, mkdir } from 'node:fs/promises'
+import { join } from 'node:path'
+import { homedir } from 'node:os'
+
+function getProfilePath(): string {
+  return join(homedir(), 'Documents', 'PowerShell', 'Microsoft.PowerShell_profile.ps1')
+}
+
+/**
+ * 检测当前是否在 PowerShell 7 环境中运行
+ * 通过检查 PSModulePath 环境变量是否包含 "PowerShell\" 来判断
+ */
+export async function detectPs7(): Promise<boolean> {
+  return (process.env.PSModulePath ?? '').includes('PowerShell\\')
+}
+
+/**
+ * 生成要注入到 $PROFILE 的 PowerShell 脚本
+ * 内容包含：
+ * - 标记块 # >>> fuck init >>> / # <<< fuck init <<<
+ * - $Fuck_NodeCli 变量（指向 CLI 入口路径）
+ * - Write-FuckContext 函数（采集失败命令上下文）
+ * - prompt 函数重写（渲染前调用 Write-FuckContext）
+ * - fuck 命令（读取上下文 → 调用 LLM → 展示建议 → 确认执行）
+ */
+export function generateProfileScript(): string {
+  return `# >>> fuck init >>>
+
+# CLI 入口路径（通过 npm root -g 动态获取，不写死路径）
+$Fuck_NodeCli = "$(npm root -g)\\@sglwsjxh\\ffix\\dist\\main.js"
+
+# 采集失败命令的上下文到临时文件
+function Write-FuckContext {
+    # 函数开头立刻保存关键状态，避免后续命令覆盖
+    $lastSuccess = $?
+    $exitCode = $global:LASTEXITCODE
+
+    # Channel A: 会话历史（快速路径）
+    $lastCmd = Get-History -Count 1 | Select-Object -ExpandProperty CommandLine -ErrorAction SilentlyContinue
+
+    # Channel B: PSReadLine 历史文件回退（解决 PS7 异步历史导致 Get-History 返回 null 的问题）
+    if (-not $lastCmd) {
+        try {
+            $option = Get-PSReadLineOption -ErrorAction Stop
+            $historyPath = $option.HistorySavePath
+            if ($historyPath -and (Test-Path $historyPath)) {
+                $lines = Get-Content $historyPath -Tail 20 -ErrorAction Stop
+                $lastCmd = $lines |
+                    Where-Object { $_ -and ($_ -notmatch '^\s*fuck(\s|$)') } |
+                    Select-Object -Last 1
+            }
+        } catch {
+            # PSReadLine 不可用时静默跳过
+        }
+    }
+
+    if (-not $lastCmd) { return }
+
+    if ($exitCode -ne 0 -or -not $lastSuccess) {
+        $effectiveExitCode = if ($exitCode -ne 0) { $exitCode } else { 1 }
+        $errorMsg = if ($Error[0]) { $Error[0].Exception.Message } else { '' }
+        $ctx = @{
+            lastCommand = $lastCmd
+            exitCode    = $effectiveExitCode
+            errorOutput = $errorMsg
+            cwd         = (Get-Location).Path
+            shell       = 'powershell-7'
+            os          = 'win32'
+            timestamp   = (Get-Date -Format 'yyyy-MM-ddTHH:mm:ss.fffZ')
+        }
+        $ctx | ConvertTo-Json -Compress | Out-File -FilePath "$env:TEMP\\fuck_ctx.json" -Encoding utf8
+    }
+}
+
+# 保存原始 prompt 函数，确保不破坏用户自定义的 prompt
+$Fuck_OriginalPrompt = \${function:prompt}
+
+# 重写 prompt 函数：在每次显示提示符前采集上下文，然后恢复原始行为
+function prompt {
+    Write-FuckContext
+    & $Fuck_OriginalPrompt
+}
+
+# fuck 命令：读取上下文 → 调用 CLI（带确认）→ 捕获 stdout → iex 执行
+function fuck {
+    $ctxPath = "$env:TEMP\\fuck_ctx.json"
+    if (-not (Test-Path $ctxPath)) {
+        Write-Host "没有找到上一条命令的上下文"
+        return
+    }
+
+    $ctx = Get-Content $ctxPath -Raw | ConvertFrom-Json
+    if (-not $ctx) {
+        Write-Host "没有找到上一条命令的上下文"
+        return
+    }
+
+    # 读取后立即删除，避免被下一轮 prompt hook 覆盖
+    Remove-Item $ctxPath -Force -ErrorAction SilentlyContinue
+
+    $command = & node "$Fuck_NodeCli" --cmd "$($ctx.lastCommand)" --exit-code $ctx.exitCode --error-output "$($ctx.errorOutput)" --cwd "$($ctx.cwd)" --confirm
+
+    if (-not [string]::IsNullOrWhiteSpace($command)) {
+        iex "$command"
+    }
+
+    [Console]::ResetColor()
+}
+
+# <<< fuck init <<<`
+}
+
+/**
+ * 将 fuck 注入到当前用户的 $PROFILE 中
+ * 先备份原文件，再追加注入脚本
+ * 如果已经注入过则跳过
+ */
+export async function install(): Promise<void> {
+  const profilePath = getProfilePath()
+
+  await mkdir(join(homedir(), 'Documents', 'PowerShell'), { recursive: true })
+
+  let content = ''
+  try {
+    content = await readFile(profilePath, 'utf-8')
+  } catch {
+  }
+
+  if (content.includes('# >>> fuck init >>>')) {
+    console.log('fuck 已经安装到 $PROFILE，跳过')
+    return
+  }
+
+  await writeFile(profilePath + '.bak', content, 'utf-8')
+
+  const script = generateProfileScript()
+  const separator = content ? '\n' : ''
+  await writeFile(profilePath, content + separator + script, 'utf-8')
+
+  console.log(`已安装到 ${profilePath}`)
+}
+
+/**
+ * 从 $PROFILE 中卸载 fuck 注入内容
+ * 只删除标记块之间的内容，不影响用户其他配置
+ */
+export async function uninstall(): Promise<void> {
+  const profilePath = getProfilePath()
+
+  let content: string
+  try {
+    content = await readFile(profilePath, 'utf-8')
+  } catch {
+    console.log('没有找到 $PROFILE')
+    return
+  }
+
+  const startTag = '# >>> fuck init >>>'
+  const endTag = '# <<< fuck init <<<'
+
+  const startIdx = content.indexOf(startTag)
+  if (startIdx === -1) {
+    console.log('没有找到 fuck 注入内容')
+    return
+  }
+
+  const endIdx = content.indexOf(endTag, startIdx)
+  if (endIdx === -1) {
+    console.log('错误：注入标记不完整，请手动检查 $PROFILE')
+    return
+  }
+
+  // 提取标记块前后的内容，合并回文件
+  const before = content.substring(0, startIdx)
+  const after = content.substring(endIdx + endTag.length)
+  const trimmed = after.startsWith('\r\n')
+    ? after.substring(2)
+    : after.startsWith('\n')
+      ? after.substring(1)
+      : after
+
+  await writeFile(profilePath, before + trimmed, 'utf-8')
+  console.log('已从 $PROFILE 卸载')
+}

package/src/types.ts

@@ -0,0 +1,26 @@
+export interface UserConfig {
+  baseUrl: string
+  apiKey: string
+  model: string
+}
+
+export interface AppConfig {
+  stderrTailLines: number
+  timeoutMs: number
+  tempFilePath: string
+}
+
+export interface FixContext {
+  lastCommand: string
+  exitCode: number
+  errorOutput: string
+  cwd: string
+  shell: 'powershell-7'
+  os: 'win32'
+  timestamp: string
+}
+
+export interface FixSuggestion {
+  command: string
+  confidence?: 'high' | 'medium' | 'low'
+}

package/tsconfig.json

@@ -0,0 +1,14 @@
+{
+  "compilerOptions": {
+    "strict": true,
+    "target": "ES2022",
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext",
+    "outDir": "dist",
+    "rootDir": "src",
+    "esModuleInterop": true,
+    "types": ["node"],
+    "skipLibCheck": true
+  },
+  "include": ["src"]
+}