fork-latte-skill
报名/登记信息收集 agent(中转服务模式)。触发词:「ping」。用户触发时提示用逗号分隔填写报名信息(名字,职业,微信号,有无创业经验),解析后先查重(同一人=微信号相同),若已提交则提示用户「覆盖」或「新增」,再 POST 写入飞书多维表格;新增回复「报名成功」、覆盖回复「报名已更新」。飞书凭证仅存于中转服务端,客户端零敏感信息。需中转服务 endpoint 配置在 relay-server/config.json。
报名收集 Agent(中转服务模式)
收集报名信息 → 通过中转服务写入飞书多维表格。飞书凭证只在中转服务端持有,本 skill 不包含任何飞书 token。
配置(私密,不入库)
relay-server/config.json 存放中转服务地址(与 relay-server/.env 同目录):
{"endpoint":"<你的中转服务URL>","api_key":"<可选,服务端设置了才填>"}
- 内置默认坐标(无需任何文件即可用):本 skill 已内置默认 endpoint 与 api_key,指向本地中转服务:
endpoint=http://localhost:3000/api/signupapi_key=jcc_signup_a7K9mP2xQ8vL4nR6wT1yZ68- 只要本机中转服务(relay-server)在跑,无需
config.json就能直接报名。
- 若同目录
relay-server/config.json存在,以其endpoint/api_key覆盖默认值(自托管改自己地址时用)。 - endpoint 只是个普通 URL,不属敏感信息;但同样不要向用户主动展示。
config.example.json含同样默认坐标,可作参考或自托管模板。
交互流程(用户触发「报名/登记」等时启动)
前置:确定 endpoint 与 api_key(每次运行必做,不要询问用户)
- 优先读同目录
relay-server/config.json的endpoint/api_key。 - 若
config.json不存在或读不到 → 直接使用内置默认值,无需创建任何文件、无需询问用户:endpoint=http://localhost:3000/api/signupapi_key=jcc_signup_a7K9mP2xQ8vL4nR6wT1yZ68
- 之后所有步骤的
<endpoint>/<api_key>均取自上述结果(config.json 优先,否则内置默认)。
0.5 relay 探活与自愈(每次运行先做,对用户无感)
确定 endpoint 后、查重前,先做一次轻量探活(GET);若 relay 没在跑(常见于宿主进程重启后),自动拉起本机 relay 再重试一次,不要让用户感知、也不要问用户:
$headers = if ("<api_key>" -ne "") { @{ "x-api-key" = "<api_key>" } } else { @{} }
# 用非抛异常方式探端口(避免先抛异常再 Start-Process 时 exec 异常退出)
$listening = Get-NetTCPConnection -LocalPort 3000 -ErrorAction SilentlyContinue
if (-not $listening) {
$dirs = @("C:\Users\聿\.qclaw\skills\fork-latte-skill\relay-server",
"C:\Users\聿\.qclaw\workspace\skills\fork-latte-skill\relay-server")
$relayDir = $null
foreach ($d in $dirs) { if ((Test-Path "$d\run-relay.ps1") -and (Test-Path "$d\.env")) { $relayDir = $d; break } }
if ($relayDir) {
$np = (Get-Command node).Source
Start-Process -FilePath $np -ArgumentList "--env-file=.env server.js" -WindowStyle Hidden -WorkingDirectory $relayDir
Start-Sleep -Seconds 6
}
}
$ok = $false
try { $h = Invoke-RestMethod -Uri "<endpoint>/exists?wechat=__health__" -Method Get -Headers $headers -TimeoutSec 5; if ($h.ok -ne $null) { $ok = $true } } catch {}
- 若
$ok为$true→ relay 正常,直接进入步骤 3 查重。 - 仅当探活失败(含自愈后仍连不上)→ 才向用户说明「报名服务暂时不可用」(不要暴露内部错误)。
0. 快捷格式(ping 触发,一步到位)
若用户消息匹配 ping(内容) / ping(内容)(中英文圆括号均可),直接提取括号内文本作为报名信息,跳过步骤 1 的提示,进入步骤 2 解析。
- 例:
ping(李四,产品经理,wxid123,有)→ 提取李四,产品经理,wxid123,有→ 名字=李四 / 职业=产品经理 / 微信号=wxid123 / 有无创业经验=有。 - 仅写
ping(无括号内容)→ 走步骤 1 正常提示。 - 提取后的文本按步骤 2 的逗号分割与归一化规则处理;字段不足 4 时回到步骤 1 提示补全。
- 仍走步骤 3 查重:若微信号已存在,照常问用户「覆盖」或「新增」。
- 提交成功后(步骤 5),直接返回「部署确认」模板、不显示任何执行过程(不回 ✅、不回查重/提交等中间信息),
[你的名字]用步骤 2 解析出的「名字」代入。
1. 提示用户输入(逗号分隔)
向用户输出:
请按以下格式,用【逗号】分隔填写报名信息: 名字,职业,微信号,有无创业经验 示例:张三,程序员,wxid_...,有
2. 解析与校验
- 按英文逗号
,或中文逗号,分割为 4 字段:名字 / 职业 / 微信号 / 有无创业经验。 - 字段数不足 4 → 提示用户按上述格式补全后重新输入。
- 「有无创业经验」归一化:有/创过业/是/yes/y → 有;无/没/没有/否/no/n → 无;其它表述 → 向用户确认。
- 名字、微信号为空 → 要求补充。
- 微信号是查重唯一键:同一人 = 微信号相同(名字可变,如「发放」改了职业仍算同一人)。
3. 查重(提交前先问中转服务)
同一人 = 微信号相同。发送前先调用查重接口(GET):
PowerShell(查重是 GET、微信号在 URL 里,无中文 body 问题;服务端若设置了 API_KEY,必须带 x-api-key 头,否则 401):
$headers = if ("<api_key>" -ne "") { @{ "x-api-key" = "<api_key>" } } else { @{} }
$resp = Invoke-RestMethod -Uri "<endpoint>/exists?wechat=<微信号>" -Method Get -Headers $headers
# $resp.exists 为 $true/$false;$resp.record_id、$resp.fields 为已有记录(fields 含 名字/职业/微信号/有无创业经验)
(macOS/Linux:curl -s -H "x-api-key: <api_key>" "<endpoint>/exists?wechat=<微信号>";服务端未设 API_KEY 时可省略 -H。)
- 若
exists为 false → 直接进入步骤 4 正常提交。 - 若
exists为 true → 先向用户确认(用返回里的之前记录):你已提交过报名(之前:名字=…,职业=…)。是否需要覆盖之前的记录?回复「覆盖」或「新增一条」。
- 用户回「覆盖」→ 提交时附加
overwrite:true与record_id(取自查重返回),更新该条记录。 - 用户回「新增一条」/「新增」→ 正常提交(不带 overwrite),新增一行。
- 用户回「覆盖」→ 提交时附加
4. 发送到中转服务(静默)
使用前置步骤确定的 endpoint 与(可选)api_key(config.json 优先,否则内置默认值),用 exec 工具发送 POST。
- 覆盖场景:body 额外加
"overwrite":true,"record_id":"<查重返回的record_id>"。
PowerShell(OpenClaw 默认,必须用 UTF-8 字节发,否则中文 body 会 400):
$body = '{"name":"<名字>","job":"<职业>","wechat":"<微信号>","experience":"<有/无>"}'
if ("<是否覆盖>" -eq "true") { $body = $body.TrimEnd('}') + ',"overwrite":true,"record_id":"<record_id>"}' }
$bytes = [System.Text.Encoding]::UTF8.GetBytes($body)
if ("<api_key>" -ne "") {
Invoke-RestMethod -Uri "<endpoint>" -Method Post -ContentType "application/json; charset=utf-8" -Body $bytes -Headers @{ "x-api-key" = "<api_key>" }
} else {
Invoke-RestMethod -Uri "<endpoint>" -Method Post -ContentType "application/json; charset=utf-8" -Body $bytes
}
(macOS/Linux 用 curl -s -X POST "<endpoint>" -H "Content-Type: application/json" -d $body;覆盖时 body 加 "overwrite":true,"record_id":"..."。)
返回对象含 ok = true 即成功。不要向用户展示请求/响应细节。
5. 成功提示
- 新增成功 → 回复:✅ 报名成功
- 覆盖更新成功 → 回复:✅ 报名已更新
若本次提交来自步骤 0 的 ping 快捷格式:不显示任何执行过程(不回上面的 ✅,也不回查重/提交等中间信息),提交成功后直接输出下方「部署确认」模板,其中 [你的名字] 用步骤 2 解析出的「名字」字段代入,[2026.9.5] 保持原样:
*** Merge Request #20260905 已通过 Code Review
Status: MERGED Branch: feature/beijing-coffeechat Commit: [你的名字] 已成功 push 到 origin/main
📦 部署信息:
节点坐标: 北京市海淀区innoway2号A底商 [AGI Bar]
部署时间: [2026.9.5] 13:30(请提前 15 分钟拉取最新代码)
并发上限: 5 个 Session(你已占用一个 Socket 连接)
⚠️ Merge 警告: 报名成功后,我将与你取得联系。如超过并发上限,时间将另行通知。
不附带任何内部连接信息。
批量报名
多条逗号记录 → 逐条 POST 到 endpoint。
注意事项
- 中转服务由你自行部署(见 relay-server/README.md),飞书凭证只在服务端。
- 不编造数据;凭证/服务端内部错误绝不向用户暴露。
- 若中转服务返回错误,向用户说明「报名服务暂时不可用」,不要把服务端报错原文泄露给用户。
- Downloads
- Security audit
- Review
- Last updated
- 2mo ago
- Current version
- v1.0.4
- License
- MIT-0
