kslock-daemon

本机 daemon 负责连接 KSLock API，检测本机 runtime，并在用户机器上执行 Agent Delivery。

Usage

npx -y kslock-daemon@latest start \
  --server-url https://kslock.example.com \
  --machine-key mk_xxx

本地源码调试：

KSLOCK_SERVER_URL=http://127.0.0.1:3001
KSLOCK_MACHINE_KEY=mk_xxx
pnpm dev:daemon

daemon 通过 /daemon/connect 连接 API WebSocket，执行 Codex、Claude、KSCC、OpenCode 等本地 CLI runtime。

Runtime Paths

建议显式指定 runtime CLI 路径，避免 nvm、多 Node 版本或 shell PATH 差异导致 daemon 找错命令：

CODEX_BIN=/absolute/path/to/codex \
CLAUDE_BIN=/absolute/path/to/claude \
KSCC_BIN=/absolute/path/to/kscc \
OPENCODE_BIN=/absolute/path/to/opencode \
npx -y kslock-daemon@latest start \
  --server-url https://kslock.example.com \
  --machine-key mk_xxx

也支持：

<COMMAND>_BIN
<COMMAND>_PATH
KSLOCK_<COMMAND>_BIN
KSLOCK_RUNTIME_<COMMAND>_BIN
KSLOCK_RUNTIME_PATHS
KSLOCK_RUNTIME_PATH

Runtime Session

daemon 会按 scope 保存 runtime session，避免多人在频道里调用同一个本地助手时上下文混乱。

scope 优先级：

task > thread > user > channel

含义：

• 任务 thread 使用共享 session，适合团队协作 review。
• 普通频道 @Agent 按 agentId + channelId + requesterUserId 隔离。
• 没有 task/thread/requester 时回退到频道级 session。