183 lines
3.4 KiB
Markdown
183 lines
3.4 KiB
Markdown
# lingma-ipc-proxy
|
||
|
||
A standalone Go backend that talks to Lingma over Windows named-pipe IPC and exposes:
|
||
|
||
- `GET /v1/models`
|
||
- `POST /v1/messages`
|
||
- `POST /v1/chat/completions`
|
||
|
||
Current scope:
|
||
|
||
- non-streaming only
|
||
- one request at a time
|
||
- Windows only
|
||
- directly uses Lingma IPC, not DOM/CDP
|
||
|
||
## Run
|
||
|
||
```powershell
|
||
cd C:\Workspace\Personal\lingma-ipc-proxy
|
||
go run .\cmd\lingma-ipc-proxy
|
||
```
|
||
|
||
## Build
|
||
|
||
Build a Windows executable:
|
||
|
||
```powershell
|
||
cd C:\Workspace\Personal\lingma-ipc-proxy
|
||
.\scripts\build.ps1
|
||
```
|
||
|
||
Default output:
|
||
|
||
```text
|
||
dist\lingma-ipc-proxy.exe
|
||
```
|
||
|
||
Direct Go build command:
|
||
|
||
```powershell
|
||
$env:CGO_ENABLED = "0"
|
||
$env:GOOS = "windows"
|
||
$env:GOARCH = "amd64"
|
||
go build -trimpath -ldflags "-s -w" -o .\dist\lingma-ipc-proxy.exe .\cmd\lingma-ipc-proxy
|
||
```
|
||
|
||
Run the built binary:
|
||
|
||
```powershell
|
||
.\dist\lingma-ipc-proxy.exe --host 127.0.0.1 --port 8095 --session-mode auto
|
||
```
|
||
|
||
## Windows Service
|
||
|
||
For this project, the correct deployment shape is a native Windows process, not Docker. The proxy talks to Lingma over Windows named pipes, so it should run on the same Windows host as Lingma itself.
|
||
|
||
### NSSM
|
||
|
||
Build first:
|
||
|
||
```powershell
|
||
.\scripts\build.ps1
|
||
```
|
||
|
||
Install with NSSM:
|
||
|
||
```powershell
|
||
.\scripts\install-nssm-service.ps1 -NssmPath C:\Tools\nssm\nssm.exe
|
||
```
|
||
|
||
This wraps:
|
||
|
||
```powershell
|
||
nssm.exe install LingmaIpcProxy C:\Workspace\Personal\lingma-ipc-proxy\dist\lingma-ipc-proxy.exe --host 127.0.0.1 --port 8095 --session-mode auto
|
||
nssm.exe set LingmaIpcProxy AppDirectory C:\Workspace\Personal\lingma-ipc-proxy
|
||
nssm.exe start LingmaIpcProxy
|
||
```
|
||
|
||
### WinSW
|
||
|
||
Prepare the executable:
|
||
|
||
```powershell
|
||
.\scripts\build.ps1
|
||
```
|
||
|
||
Put a WinSW binary at:
|
||
|
||
```text
|
||
dist\WinSW-x64.exe
|
||
```
|
||
|
||
Then generate the wrapper files:
|
||
|
||
```powershell
|
||
.\scripts\install-winsw-service.ps1
|
||
```
|
||
|
||
That script creates:
|
||
|
||
- `LingmaIpcProxy.exe`
|
||
- `LingmaIpcProxy.xml`
|
||
|
||
Then install/start:
|
||
|
||
```powershell
|
||
.\LingmaIpcProxy.exe install
|
||
.\LingmaIpcProxy.exe start
|
||
```
|
||
|
||
The WinSW XML template lives at:
|
||
|
||
- `scripts\lingma-ipc-proxy.xml.template`
|
||
|
||
## Flags
|
||
|
||
```powershell
|
||
go run .\cmd\lingma-ipc-proxy --port 8095 --session-mode auto
|
||
```
|
||
|
||
- `--host`
|
||
- `--port`
|
||
- `--pipe`
|
||
- `--cwd`
|
||
- `--current-file-path`
|
||
- `--mode`
|
||
- `--shell-type`
|
||
- `--session-mode`
|
||
- `reuse`: keep using the sticky Lingma session
|
||
- `fresh`: create a temporary session for the request and delete it after completion
|
||
- `auto`: single-turn requests reuse; requests with system/history use a temporary fresh session and delete it after completion
|
||
- `--timeout`
|
||
|
||
## Environment
|
||
|
||
- `LINGMA_IPC_PIPE`
|
||
- `LINGMA_PROXY_HOST`
|
||
- `LINGMA_PROXY_PORT`
|
||
- `LINGMA_PROXY_CWD`
|
||
- `LINGMA_PROXY_CURRENT_FILE_PATH`
|
||
- `LINGMA_PROXY_MODE`
|
||
- `LINGMA_PROXY_SHELL_TYPE`
|
||
- `LINGMA_PROXY_SESSION_MODE`
|
||
- `LINGMA_PROXY_TIMEOUT_SECONDS`
|
||
|
||
## Examples
|
||
|
||
Anthropic:
|
||
|
||
```powershell
|
||
$body = @{
|
||
model = "dashscope_qwen3_coder"
|
||
messages = @(
|
||
@{ role = "user"; content = "请只回复：ANTHROPIC_OK" }
|
||
)
|
||
stream = $false
|
||
} | ConvertTo-Json -Depth 8
|
||
|
||
Invoke-RestMethod `
|
||
-Method Post `
|
||
-Uri http://127.0.0.1:8095/v1/messages `
|
||
-ContentType "application/json" `
|
||
-Body $body
|
||
```
|
||
|
||
OpenAI:
|
||
|
||
```powershell
|
||
$body = @{
|
||
model = "dashscope_qwen3_coder"
|
||
messages = @(
|
||
@{ role = "user"; content = "请只回复：OPENAI_OK" }
|
||
)
|
||
stream = $false
|
||
} | ConvertTo-Json -Depth 8
|
||
|
||
Invoke-RestMethod `
|
||
-Method Post `
|
||
-Uri http://127.0.0.1:8095/v1/chat/completions `
|
||
-ContentType "application/json" `
|
||
-Body $body
|
||
```
|