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

108
src/commands/monitor.ts Normal file
View File

@@ -0,0 +1,108 @@
/**
* /monitor <command> — Start a background monitor task.
*
* Shortcut for the MonitorTool. Spawns a long-running shell command
* as a background task visible in the footer pill (Shift+Down to view).
*
* Usage:
* /monitor tail -f /var/log/syslog
* /monitor watch -n 5 git status
* /monitor "while true; do curl -s http://localhost:3000/health; sleep 10; done"
*/
import { feature } from 'bun:bundle'
import type {
Command,
LocalJSXCommandContext,
LocalJSXCommandOnDone,
} from '../types/command.js'
import type { ToolUseContext } from '../Tool.js'
const monitor = {
type: 'local-jsx',
name: 'monitor',
description: 'Start a background shell monitor (Shift+Down to view)',
isEnabled: () => {
if (feature('MONITOR_TOOL')) {
return true
}
return false
},
immediate: false,
userFacingName: () => 'monitor',
load: () =>
Promise.resolve({
async call(
onDone: LocalJSXCommandOnDone,
context: ToolUseContext & LocalJSXCommandContext,
args: string,
): Promise<React.ReactNode> {
let command = args.trim()
if (!command) {
onDone(
process.platform === 'win32'
? 'Usage: /monitor <command>\nExample: /monitor powershell -c "while(1){git status; Start-Sleep 5}"'
: 'Usage: /monitor <command>\nExample: /monitor watch -n 5 git status',
{ display: 'system' },
)
return null
}
// Windows compatibility: convert `watch -n <sec> <cmd>` to a PowerShell loop
if (process.platform === 'win32') {
const watchMatch = command.match(/^watch\s+-n\s+(\d+)\s+(.+)$/)
if (watchMatch) {
const interval = watchMatch[1]
const innerCmd = watchMatch[2]
command = `powershell -c "while(1){${innerCmd}; Start-Sleep ${interval}}"`
}
}
// Dynamic require to stay behind feature gate
const { spawnShellTask } =
require('../tasks/LocalShellTask/LocalShellTask.js') as typeof import('../tasks/LocalShellTask/LocalShellTask.js')
const { exec } =
require('../utils/Shell.js') as typeof import('../utils/Shell.js')
const { getTaskOutputPath } =
require('../utils/task/diskOutput.js') as typeof import('../utils/task/diskOutput.js')
try {
const shellCommand = await exec(
command,
context.abortController.signal,
'bash',
)
const handle = await spawnShellTask(
{
command,
description: command,
shellCommand,
toolUseId: context.toolUseId ?? `monitor-${Date.now()}`,
agentId: undefined,
kind: 'monitor',
},
{
abortController: context.abortController,
getAppState: context.getAppState,
setAppState: context.setAppState,
},
)
const outputFile = getTaskOutputPath(handle.taskId)
onDone(
`Monitor started (${handle.taskId}). Press Shift+Down to view.\nOutput: ${outputFile}`,
{ display: 'system' },
)
} catch (err) {
onDone(
`Monitor failed: ${err instanceof Error ? err.message : String(err)}`,
{ display: 'system' },
)
}
return null
},
}),
} satisfies Command
export default monitor