ask4me
Compare original and translation side by side
🇺🇸
Original
English🇨🇳
Translation
ChineseAsk4Me · 让人工确认 / 选择 / 填表
Ask4Me · Let a human confirm / select / fill out a form
Ask4Me 是一个已部署好的 Human-in-the-Loop 服务:你发一个请求,服务把交互链接推到真人的手机(ServerChan),对方点按钮或填表后,你的命令拿到最终结果。
这是纯客户端 skill,不需要部署服务。 默认用公共试用服务器;用户唯一需要准备的是 ServerChan SendKey。
Ask4Me is a deployed Human-in-the-Loop service: you send a request, the service pushes an interaction link to a real person's phone (ServerChan), and after they tap a button or submit a form, your command receives the final result.
This is a pure client-side skill and does not require deploying a service. By default, it uses the public trial server; the only thing the user needs to prepare is the ServerChan SendKey.
从这里开始(GitHub 直接安装的用户)
Start here (users installing directly from GitHub)
从 GitHub / 安装后,只读本文件就够了;不需要等任何人发话术。
npx skills add- 确认 Node 18+:
node -v - 先准备 ServerChan SendKey(必填):
- 有:保存到 ;
ASK4ME_SERVERCHAN_SENDKEY - 没有:引导用户打开 https://sct.ftqq.com/ → 微信扫码登录(自动注册)→ 复制 SendKey(或
SCT...)→ 保存到sctp...。ASK4ME_SERVERCHAN_SENDKEY - 没有 SendKey 不要创建请求。
- 有:保存到
- 发请求:
node scripts/ask4me.mjs ask --title "确认发布" --body "请确认"- 首次运行会自动生成并保存 API key,不需要手动 keygen。
- 用户在手机上点 OK,拿到结果即接通。
- 之后按“正式使用”发按钮/输入/JSON Forms 请求。
After installing from GitHub / , this file is all you need to read; there is no need to wait for anyone to provide further instructions.
npx skills add- Verify Node 18+:
node -v - First, prepare the ServerChan SendKey (required):
- If you have one: save it to ;
ASK4ME_SERVERCHAN_SENDKEY - If you do not: guide the user to open https://sct.ftqq.com/ → scan the QR code with WeChat (registration is automatic) → copy the SendKey (or
SCT...) → save it tosctp....ASK4ME_SERVERCHAN_SENDKEY - Do not create a request without a SendKey.
- If you have one: save it to
- Send a request:
node scripts/ask4me.mjs ask --title "确认发布" --body "请确认"- The first run automatically generates and saves an API key; no manual keygen is required.
- The user taps OK on their phone, and the connection is established once the result is received.
- Then send button/input/JSON Forms requests as described under “Regular use.”
默认:先用公共试用服务
Default: start with the public trial service
- 服务地址:
https://ask.app.ft07.com - 邀请码:
askd-2026 - 这是公共试用服务:可能不稳定、限流、停机或清理数据;不要放长期/敏感数据,也不要做关键业务依赖。
- 先让用户用试用服务跑通;如果用户需要长期使用、数据不能丢,或遇到不稳定问题,再引导他自建:
不要一上来就让用户自建服务器——先用试用服务,门槛最低;自建是升级路径,不是前置条件。
- Service URL:
https://ask.app.ft07.com - Invitation code:
askd-2026 - This is a public trial service: it may be unstable, subject to rate limiting, downtime, or data cleanup. Do not store long-lived or sensitive data there, and do not rely on it for mission-critical business operations.
- First let the user get the service working through the trial service. If they need long-term use, cannot afford data loss, or encounter instability, guide them toward self-hosting:
Do not ask the user to self-host a server right away—start with the trial service because it has the lowest barrier to entry; self-hosting is an upgrade path, not a prerequisite.
自动更新检查
Automatic update checks
脚本在每次 / / 启动时检查一次 GitHub 上的 skill 版本(最多每 24 小时一次,网络失败自动忽略,不阻塞请求)。发现新版本会在 stderr 提示:
askcreatetesttext
[Ask4Me] 发现 skill 新版本 x.y.z(当前 a.b.c)。
[Ask4Me] 更新:npx skills add easychen/skills --skill ask4me- 手动查版本:
node scripts/ask4me.mjs version - 关闭检查:或
ASK4ME_NO_UPDATE_CHECK=1--no-update-check - 不要自动替用户执行更新;提示后让用户决定。
The script checks GitHub for a new skill version whenever / / starts (at most once every 24 hours; network failures are ignored automatically and do not block requests). If a new version is available, it is reported on stderr:
askcreatetesttext
[Ask4Me] 发现 skill 新版本 x.y.z(当前 a.b.c)。
[Ask4Me] 更新:npx skills add easychen/skills --skill ask4me- Check the version manually:
node scripts/ask4me.mjs version - Disable the check: or
ASK4ME_NO_UPDATE_CHECK=1--no-update-check - Do not automatically run updates for the user; notify them and let them decide.
先做环境检查
Perform environment checks first
需要 Node.js 18+。脚本在技能目录的 ,零依赖。
scripts/ask4me.mjsbash
node -v如果低于 18,先让用户升级 Node,不要继续。
Node.js 18+ is required. The script is located at in the skill directory and has zero dependencies.
scripts/ask4me.mjsbash
node -vIf the version is below 18, first have the user upgrade Node and do not continue.
第一次配置(只有 SendKey 一步)
First-time setup (only the SendKey step)
1. 服务地址和邀请码
1. Service URL and invitation code
默认已经内置,不需要问用户。只有用户明确要自建/自定义时,才改 和 。
ASK4ME_BASE_URL--inviteThe defaults are already built in, so there is no need to ask the user. Only change and if the user explicitly wants to self-host or customize them.
ASK4ME_BASE_URL--invite2. API key
2. API key
不需要手动生成。第一次运行 会自动生成 ,保存到 (权限 600)。
aska4m_askd-2026_<random>~/.config/ask4me/config.json不要回显完整 key;如果用户已有自己的 key,用 覆盖。
ASK4ME_API_KEYNo manual generation is required. The first run automatically generates and saves it to (permissions 600).
aska4m_askd-2026_<random>~/.config/ask4me/config.jsonDo not echo the full key; if the user already has their own key, override it with .
ASK4ME_API_KEY3. ServerChan SendKey(必填)
3. ServerChan SendKey (required)
没有 SendKey 就不能发通知,请求没有意义。 先问用户要 SendKey:
- 打开 https://sct.ftqq.com/;
- 微信扫码登录(没有账号会自动注册);
- 复制 SendKey(形如 或
SCT...);sctp... - 保存到当前项目环境变量 。
ASK4ME_SERVERCHAN_SENDKEY
如果用户没有 SendKey,停下来引导他完成这一步,不要创建请求,也不要用所谓的“链接模式”绕过。不要 echo / log SendKey。
Without a SendKey, no notification can be sent and the request is meaningless. First ask the user for the SendKey:
- Open https://sct.ftqq.com/;
- Scan the QR code and log in with WeChat (an account is created automatically if necessary);
- Copy the SendKey (in the form or
SCT...);sctp... - Save it to the current project's environment variable.
ASK4ME_SERVERCHAN_SENDKEY
If the user does not have a SendKey, stop and guide them through this step. Do not create a request, and do not attempt to bypass it using the so-called “link mode.” Do not echo or log the SendKey.
4. 可选:E2EE
4. Optional E2EE
问用户:“这次/以后要不要端到端加密?”
- 不开启:不设置 ,或加
ASK4ME_E2EE_PASSWORD。--no-e2ee - 开启:让用户设一个口令,保存到 。口令只用于加密,不会发给服务端。
ASK4ME_E2EE_PASSWORD - 提醒用户:口令必须另行告知回答者,不能放在通知里;忘记口令数据不可恢复。
Ask the user: “Do you want end-to-end encryption for this request / in the future?”
- Disabled: do not set , or add
ASK4ME_E2EE_PASSWORD.--no-e2ee - Enabled: have the user set a passphrase and save it to . The passphrase is used only for encryption and will not be sent to the server.
ASK4ME_E2EE_PASSWORD - Remind the user that the passphrase must be communicated to the respondent separately and must not be placed in the notification. If it is lost, the data cannot be recovered.
5. 发一条测试
5. Send a test request
在用户确认可以发推送后:
bash
node scripts/ask4me.mjs ask \
--title "Ask4Me 配置测试" \
--body "收到请点 OK,确认链路正常。" \
--expires 3600等用户在手机上点 OK。返回 / 即配置成功。脚本会打印公共试用服务提醒;请把“不稳定、正式使用请自建”转告用户。
user.submittedaction=okAfter the user confirms that push notifications can be sent:
bash
node scripts/ask4me.mjs ask \
--title "Ask4Me 配置测试" \
--body "收到请点 OK,确认链路正常。" \
--expires 3600Wait for the user to tap OK on their phone. A / response means setup is successful. The script prints a public trial service reminder; relay the message that it may be unstable and should be self-hosted for regular use.
user.submittedaction=ok正式使用
Regular use
按钮 / 审批
Buttons / Approval
bash
node scripts/ask4me.mjs ask \
--title "确认发布 v1.2.3" \
--body "请确认是否发布到生产环境。" \
--mcd $':::buttons\n- [OK](ok)\n- [取消](cancel)\n:::' \
--expires 3600bash
node scripts/ask4me.mjs ask \
--title "确认发布 v1.2.3" \
--body "请确认是否发布到生产环境。" \
--mcd $':::buttons\n- [OK](ok)\n- [取消](cancel)\n:::' \
--expires 3600文字输入
Text input
bash
node scripts/ask4me.mjs ask \
--title "补充说明" \
--body "请填写发布备注。" \
--mcd $':::input name="note" label="备注" submit="提交"\n:::' \
--expires 3600bash
node scripts/ask4me.mjs ask \
--title "补充说明" \
--body "请填写发布备注。" \
--mcd $':::input name="note" label="备注" submit="提交"\n:::' \
--expires 3600JSON Forms 表单
JSON Forms
先写一个 JSON 文件(例如 ):
/tmp/form.jsonjson
{
"schema": {
"type": "object",
"properties": {
"name": { "type": "string", "minLength": 1 },
"age": { "type": "integer", "minimum": 0 }
},
"required": ["name"]
},
"uischema": {
"type": "VerticalLayout",
"elements": [
{ "type": "Control", "scope": "#/properties/name" },
{ "type": "Control", "scope": "#/properties/age" }
]
},
"data": { "age": 18 },
"submit_label": "提交"
}bash
node scripts/ask4me.mjs ask \
--title "填写信息" \
--body "请填写后提交。" \
--jsonforms /tmp/form.json \
--expires 3600脚本会把结果 JSON 打到 stdout:
json
{
"request_id": "req_xxx",
"last_event_type": "user.submitted",
"data": {
"action": "ok",
"text": "",
"payload": { "name": "Alice", "age": 18 }
}
}E2EE 开启时, / 已在本地解密,直接使用。
data.textdata.payloadFirst, create a JSON file, for example :
/tmp/form.jsonjson
{
"schema": {
"type": "object",
"properties": {
"name": { "type": "string", "minLength": 1 },
"age": { "type": "integer", "minimum": 0 }
},
"required": ["name"]
},
"uischema": {
"type": "VerticalLayout",
"elements": [
{ "type": "Control", "scope": "#/properties/name" },
{ "type": "Control", "scope": "#/properties/age" }
]
},
"data": { "age": 18 },
"submit_label": "提交"
}bash
node scripts/ask4me.mjs ask \
--title "填写信息" \
--body "请填写后提交。" \
--jsonforms /tmp/form.json \
--expires 3600The script prints the result JSON to stdout:
json
{
"request_id": "req_xxx",
"last_event_type": "user.submitted",
"data": {
"action": "ok",
"text": "",
"payload": { "name": "Alice", "age": 18 }
}
}When E2EE is enabled, / have already been decrypted locally and can be used directly.
data.textdata.payload试用 vs 自建
Trial vs. self-hosted
| 公共试用服务 | 自建服务器 | |
|---|---|---|
| 地址 | | 自己的域名 |
| 邀请码 | | 自己配置 |
| 数据 | 可能清理,不保证保留 | 自己控制 |
| 稳定性 | 不保证,可能限流/停机 | 自己负责 |
| 适合 | 试用、体验、轻量任务 | 长期使用、敏感/关键任务 |
先用试用服务跑通,再决定是否自建;不要在用户还没体验前就要求他搭服务器。
| Public trial service | Self-hosted server | |
|---|---|---|
| URL | | Your own domain |
| Invitation code | | Configure your own |
| Data | May be cleaned up; retention is not guaranteed | Under your control |
| Stability | Not guaranteed; may be rate-limited or unavailable | Your responsibility |
| Suitable for | Trials, evaluation, lightweight tasks | Long-term use, sensitive or critical tasks |
Self-hosting entry point: https://github.com/easychen/ask4me.
Get the service working through the trial service first, then decide whether to self-host. Do not require the user to set up a server before they have tried the service.
对用户怎么说
How to communicate with the user
发请求后,用一句简短的话告诉用户:
已经把确认请求推到你手机了,请点 OK(或打开链接提交)。我这边会等你的结果。
不要把 SendKey、API key、E2EE 口令、完整交互 URL 发到公开频道。交互 URL 是访问凭证。
After sending a request, tell the user briefly:
The confirmation request has been pushed to your phone. Tap OK, or open the link to submit. I will wait for your result here.
Do not send the SendKey, API key, E2EE passphrase, or full interaction URL to a public channel. The interaction URL is an access credential.
排错
Troubleshooting
| 现象 | 处理 |
|---|---|
没有 | 停下来,引导用户去 https://sct.ftqq.com/ 微信扫码登录并复制 SendKey;不要创建请求 |
| 自动保存的 key 失效或邀请码被更换;删掉 |
| SendKey 无效/被限流;让用户检查 ServerChan,或更换 SendKey |
点 OK 后 | 请求已过期(默认 1 小时);让用户尽快点,或重发并调大 |
| 配额满(每 key / 每 IP / 全局);稍后再试,不要循环重发 |
| 用户没在有效期内提交;问用户是否重发,不要自动连发 |
| 命令被 Agent 超时 | 把 |
| E2EE 页面提示口令错误 | 口令不一致;让用户确认大小写/空格。服务端无法找回 |
| Symptom | Action |
|---|---|
| Stop and guide the user to https://sct.ftqq.com/ to log in by scanning the QR code with WeChat and copy the SendKey; do not create a request |
| The automatically saved key has expired or the invitation code has changed; delete |
| The SendKey is invalid or rate-limited; have the user check ServerChan or replace the SendKey |
| The request has expired (default: 1 hour); have the user tap it as soon as possible, or resend it with a larger |
| The quota is exhausted (per key / per IP / global); try again later and do not resend in a loop |
| The user did not submit within the validity period; ask whether they want to resend it, and do not send it automatically |
| The command times out in the Agent | Reduce |
| The E2EE page reports an incorrect passphrase | The passphrases do not match; have the user check capitalization and spacing. The server cannot recover the passphrase |
安全红线
Security red lines
- 不把 、
ASK4ME_API_KEY、ASK4ME_SERVERCHAN_SENDKEY写进仓库、提交、日志或公开回答。ASK4ME_E2EE_PASSWORD - 不把 E2EE 口令放进通知正文;口令必须另行传递。
- 一次只发一个请求;不要循环轰炸用户。
- 交互 URL 含访问 token,不要发到公开群组/issue。
- 用户拒绝或长时间不回复时,停止等待并如实说明,不要伪造结果。
- Do not write ,
ASK4ME_API_KEY, orASK4ME_SERVERCHAN_SENDKEYinto repositories, commits, logs, or public responses.ASK4ME_E2EE_PASSWORD - Do not place the E2EE passphrase in the notification body; it must be communicated separately.
- Send only one request at a time; do not repeatedly spam the user.
- The interaction URL contains an access token, so do not post it to public groups or issues.
- If the user declines or does not respond for a long time, stop waiting and explain the situation accurately; do not fabricate a result.
服务端事实
Server-side facts
- 默认是公共试用服务:可能不稳定、限流、停机或清理数据;不要放长期/敏感数据。正式使用请自建。
- 多用户模式:key = 租户,无账号;服务端不保存用户资料。
- 必须每请求携带;全局 ServerChan/Apprise 不生效。
notify - E2EE 是按请求 opt-in:只表示服务器允许,不会强制。
ASK4ME_E2EE_ENABLED=true - 服务端只存密文和盐,不接触 E2EE 口令。
- 协议与测试向量见 https://github.com/easychen/ask4me/blob/main/E2EE.md。
- The default is a public trial service: it may be unstable, subject to rate limiting, downtime, or data cleanup. Do not store long-lived or sensitive data there. Self-host it for regular use.
- Multi-user mode: key = tenant, with no account; the server does not store user profiles.
- must be included with every request; global ServerChan/Apprise settings do not take effect.
notify - E2EE is opt-in per request: only means that the server permits it and does not enforce it.
ASK4ME_E2EE_ENABLED=true - The server stores only ciphertext and salt and never handles the E2EE passphrase.
- See the protocol and test vectors at https://github.com/easychen/ask4me/blob/main/E2EE.md.
给运营方:给被引导用户的一段话
For operators: a message for guided users
INSTALL_PROMPT.mdINSTALL_PROMPT.md