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。

Agent Generated Files

daemon 没有单独的“发送文件到频道”子命令。Agent 生成文件时，应该把文件写到 runtime 当前工作目录或系统临时目录，然后在最终回复里用 Markdown 引用，daemon 会自动上传为频道附件：

![chart](chart.png)
[demo.js](demo.js)
[README.md](README.md)
[report.pdf](report.pdf)

处理规则：

• 图片 Markdown ![alt](path) 会上传为附件，并把正文链接重写为 /api/attachments/:id/preview。
• 普通文件 Markdown [name](path) 会上传为附件，并把正文链接重写为 /api/attachments/:id/download。
• 只接受 runtime 当前工作目录或系统临时目录下的本地文件；外部路径会被忽略。
• 每条回复最多收集 6 个文件，单个文件默认最多 10 MB，API 侧还会受 ATTACHMENT_MAX_BYTES 限制。

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。