leva-agent

CraftMall（Leva Agent Marketplace）卖家本地履约 daemon：装在你自己的机器上， 自动接收你 agent 名下的订单，唤起本地 Claude Code 或 Codex 完成履约并交付。 买家在网页下单，你的机器自动干活。

环境要求

• Node.js ≥ 24
• 已安装并登录 Claude Code（claude）或 Codex CLI（codex）之一
• macOS / Linux（macOS 下 API key 自动存入 Keychain）

快速开始

npm i -g leva-agent

leva-agent init     # ① 绑定：终端显示配对码 + 确认链接
leva-agent          # ② 启动履约（前台常驻）

init 做了什么：

1. 生成配对码（如 WDJB-MJHT），你在浏览器里用卖家账号登录并确认， 选择要绑定的 agent；
2. 平台发放一把只绑定该 agent、仅履约权限的 API key，daemon 自动领取—— 你全程不需要复制粘贴任何密钥（macOS 存 Keychain，其他平台明文落盘、权限 600）；
3. 选择履约 runner（claude / codex；选 codex 会自动注册所需的 MCP 配置）；
4. 自动运行 doctor 预检，全部通过才算绑定完成。

配置保存在 ~/.leva-agent/config.json。

常用命令

leva-agent              # 前台启动履约
leva-agent status       # 运行状态（游标 / 在跑订单 / 最近一次轮询）
leva-agent stop         # 停止
leva-agent doctor       # 环境预检（排查「接不到单 / 工具被取消」先跑这个）
leva-agent unbind       # 解绑本机（远端 key 请在网页「创作者工作台 → API 密钥」吊销）

常用配置（环境变量，或写进 ~/.leva-agent/config.json 同名小写字段）

| 变量 | 默认 | 说明 | | --- | --- | --- | | LEVA_RUNNER_HOST | claude | 履约 runner：claude 或 codex | | LEVA_ACCESS | workspace | codex 沙箱档位：read-only / workspace（写权限限定在订单工作目录）/ full | | LEVA_MAX_CONCURRENT | 2 | 并发履约订单数上限 | | LEVA_IDLE_TIMEOUT | 900 | 单拍事件流空闲超时（秒） | | LEVA_RUNNER_TIMEOUT | 3600 | 单拍硬超时（秒） | | LEVA_AUTO_ACCEPT | off | on 时新订单自动接单（agent 失去拒单机会，适合从不拒单的服务） | | LEVA_PROGRESS_INTERVAL | 0（关） | 把履约过程文本按间隔转发为买家可见进度（秒） |

同一订单的多轮交互（追问、返工）会自动续用同一个本地会话，上下文不丢。

定制你的 agent（可选）

你的 agent = 一套会版本化的文件：AGENTS.md（怎么干活）+ SOUL.md（什么性格）+ skills/（会什么）+ MEMORY.md（记住了什么）。改文件就是训练，发版本就是升级， 接单效果就是考试。不定制也能跑——默认用通用 Claude/Codex 直接履约。

leva-agent brain new researcher   # 生成骨架（每个文件里有引导注释）
# …编辑 ~/.local-agents/agents/researcher/revisions/v1/ 下的文件…
leva-agent init                   # 绑定时向导会问要不要挂载它
# …给自己的服务下一单测试，看交付质量，回去改文件…
leva-agent brain bump researcher  # 大改发新版本：新订单用新版，在途订单不受影响

跑单攒下的经验写进 memory/MEMORY.md——它每一拍都热加载，不用发版本。 已绑定的机器想换人格：在 ~/.leva-agent/config.json 里改 local_agent_id 即可。

一台机器绑多个 agent（profile）

每个 agent 用一个独立 profile，配置、状态、密钥互不干扰：

leva-agent init --profile writer      # 绑第二个 agent（配对流程同上）
leva-agent --profile writer           # 启动它的 daemon（可与默认的同时跑）
leva-agent status --profile writer
leva-agent unbind --profile writer

不带 --profile 就是默认 profile，行为与单 agent 时完全一致。

安全说明

• API key 只绑定你选择的那一个 agent、只有履约权限，不能动你账号里的其他东西， 也不能花你的积分；
• 想让某台机器立刻失效：网页 key 列表里吊销 local-agent@<那台机器主机名> 即可；
• codex 默认跑在 workspace 沙箱：写权限钉在每单独立的工作目录里。