feat: 远程群控 (#243)

* feat: restore pipe IPC, LAN pipes, monitor tool, and PR-package features

Core IPC system (UDS_INBOX):
- PipeServer/PipeClient with UDS + TCP dual transport, NDJSON protocol
- PipeRegistry: machineId-based role assignment, file locking
- Master/slave attach, prompt relay, permission forwarding
- Heartbeat lifecycle with parallel isPipeAlive probes
- Commands: /pipes, /attach, /detach, /send, /claim-main, /pipe-status

LAN Pipes (LAN_PIPES):
- UDP multicast beacon (224.0.71.67:7101) for zero-config LAN discovery
- PipeServer TCP listener, PipeClient TCP connect mode
- Heartbeat auto-attaches LAN peers via TCP
- Cross-machine attach allowed regardless of role
- /pipes shows [LAN] peers with role + hostname/IP
- SendMessageTool supports tcp: scheme with user consent

Architecture — extracted hooks from REPL.tsx (~830 lines → ~20 lines):
- usePipeIpc: lifecycle (bootstrap, handlers, heartbeat, cleanup)
- usePipeRelay: slave→master message relay via module singleton
- usePipePermissionForward: permission request/cancel forwarding
- usePipeRouter: selected pipe input routing with role+IP labels
- Shared ndjsonFramer.ts replaces 3 duplicate NDJSON parsers

Key fixes applied during development:
- Multicast binds to correct LAN interface (not WSL/Docker)
- Beacon ref stored as module singleton (not Zustand state mutation)
- Heartbeat preserves LAN peers in discoveredPipes and selectedPipes
- Disconnect handler calls removeSlaveClient (fixes listener leak)
- cleanupStaleEntries probes without lock, writes briefly under lock
- getMachineId uses async execFile (not blocking execSync)
- globalThis.__pipeSendToMaster replaced with setPipeRelay singleton
- M key only toggles route mode when selector panel is expanded
- User prompt displayed in message list on pipe broadcast
- Broadcast notifications show [role] + hostname/IP for LAN peers

Other restored features:
- Monitor tool: /monitor command, MonitorTool, MonitorMcpTask lifecycle
- Daemon supervisor and remoteControlServer command
- Tools: SnipTool, SleepTool, ListPeersTool, SendUserFileTool,
  WebBrowserTool, WorkflowTool, and 10+ stub→implementation rewrites
- Feature flags: UDS_INBOX, LAN_PIPES, MONITOR_TOOL, FORK_SUBAGENT,
  KAIROS, COORDINATOR_MODE, WORKFLOW_SCRIPTS, HISTORY_SNIP

Tests: 2190 pass / 0 fail (15 new: lanBeacon 7, peerAddress 8)

* fix: resolve merge conflicts and fix all tsc/test errors after main merge

- Export ToolResultBlockParam from Tool.ts (14 tool files fixed)
- Migrate ink imports from ../../ink.js to @anthropic/ink (7 files)
- Fix toolUseID → toolUseId typo in monitor.ts and MonitorTool.tsx
- Add fallback values for string|undefined type errors (8 locations)
- Fix AppState type in assistant.ts, add NewInstallWizard stubs
- Fix ParsedRepository.repo → .name in subscribe-pr.ts
- Fix AgentId/string type mismatch in BackgroundTasksDialog.tsx
- Fix PipeRelayFn return type in pipePermissionRelay.ts
- Use PipeMessage type in usePipeRelay.ts
- Fix lanBeacon.test.ts mock type assertions
- Create missing MouseActionEvent class for ink package
- Use ansi: color format instead of bare "green"/"red"
- Resolve theme.permission access via getTheme()

Result: 0 tsc errors, 2496 tests pass, 0 fail

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

* fix: 恢复 /poor 的说明

---------

Co-authored-by: unraid <local@unraid.local>
Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com>
This commit is contained in:
claude-code-best
2026-04-11 23:22:55 +08:00
committed by GitHub
parent 2fea429dc6
commit 09fc515edb
124 changed files with 10958 additions and 577 deletions

151
src/hooks/usePipeRouter.ts Normal file
View File

@@ -0,0 +1,151 @@
/**
* usePipeRouter — Route user input to selected pipe targets.
*
* Returns `routeToSelectedPipes(input)` which checks selectedPipes +
* routeMode and sends the prompt to all connected slave targets.
* Returns true if routed (caller should skip local execution).
*/
import { feature } from 'bun:bundle'
import { useCallback } from 'react'
type StoreApi = { getState: () => any }
type SetAppState = (updater: (prev: any) => any) => void
type AddNotification = (opts: {
key: string
text: string
color: string
priority: string
timeoutMs: number
}) => void
type Deps = {
store: StoreApi
setAppState: SetAppState
addNotification: AddNotification
}
/**
* Attempt to route user input to selected pipes.
* Returns true if routed to at least one pipe (skip local execution).
*/
export function usePipeRouter({ store, setAppState, addNotification }: Deps): {
routeToSelectedPipes: (input: string) => boolean
} {
const routeToSelectedPipes = useCallback(
(input: string): boolean => {
if (!feature('UDS_INBOX')) return false
if (!input.trim() || input.trim().startsWith('/')) return false
/* eslint-disable @typescript-eslint/no-require-imports */
const pipeState = (store.getState() as any).pipeIpc
const selectedPipes: string[] = pipeState?.selectedPipes ?? []
const routeMode: 'selected' | 'local' = pipeState?.routeMode ?? 'selected'
if (selectedPipes.length === 0 || routeMode === 'local') return false
const { getConnectedSlaveTargets } =
require('./useMasterMonitor.js') as typeof import('./useMasterMonitor.js')
const { getPipeIpc } =
require('../utils/pipeTransport.js') as typeof import('../utils/pipeTransport.js')
/* eslint-enable @typescript-eslint/no-require-imports */
const targets = getConnectedSlaveTargets(selectedPipes)
const pipeIpcForDisplay = getPipeIpc(store.getState())
const discovered: Array<{
pipeName: string
role: string
ip: string
hostname: string
}> = pipeIpcForDisplay.discoveredPipes ?? []
const sentTargetNames: string[] = []
const sentTargetLabels: string[] = []
const failedTargetNames: string[] = []
for (const { name, client } of targets) {
try {
client.send({ type: 'prompt', data: input.trim() })
sentTargetNames.push(name)
// Build display label: [role] hostname/ip for LAN, [role] for local
const info = discovered.find((d: any) => d.pipeName === name)
if (info) {
const isLan = info.ip && info.ip !== pipeIpcForDisplay.localIp
sentTargetLabels.push(
isLan
? `[${info.role}] ${info.hostname}/${info.ip}`
: `[${info.role}]`,
)
} else {
sentTargetLabels.push(name)
}
} catch {
failedTargetNames.push(name)
}
}
if (sentTargetNames.length > 0) {
const promptText = input.trim()
const promptTimestamp = new Date().toISOString()
setAppState((prev: any) => {
const pipeIpc = getPipeIpc(prev)
const nextSlaves = { ...pipeIpc.slaves }
for (const name of sentTargetNames) {
const slave = nextSlaves[name]
if (!slave) continue
nextSlaves[name] = {
...slave,
status: 'busy',
lastActivityAt: promptTimestamp,
lastSummary: `Queued: ${promptText}`,
lastEventType: 'prompt',
history: [
...slave.history,
{
type: 'prompt',
content: promptText,
from: pipeIpc.serverName ?? 'master',
timestamp: promptTimestamp,
},
],
}
}
return {
...prev,
pipeIpc: { ...pipeIpc, slaves: nextSlaves },
}
})
addNotification({
key: 'pipe-route-success',
text: `Routed to ${sentTargetLabels.join(', ')}; main can continue other tasks`,
color: 'success',
priority: 'immediate',
timeoutMs: 3000,
})
} else {
addNotification({
key: 'pipe-route-fallback',
text: 'Selected pipes are unavailable; processing locally.',
color: 'warning',
priority: 'immediate',
timeoutMs: 4000,
})
}
if (failedTargetNames.length > 0) {
addNotification({
key: 'pipe-route-partial-failure',
text: `Failed to send to: ${failedTargetNames.join(', ')}`,
color: 'warning',
priority: 'immediate',
timeoutMs: 4000,
})
}
return sentTargetNames.length > 0
},
[store, setAppState, addNotification],
)
return { routeToSelectedPipes }
}