ask4me

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Ask4Me · 让人工确认 / 选择 / 填表

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
安装后,只读本文件就够了;不需要等任何人发话术。
  1. 确认 Node 18+:
    node -v
  2. 先准备 ServerChan SendKey(必填):
    • 有:保存到
      ASK4ME_SERVERCHAN_SENDKEY
      ;
    • 没有:引导用户打开 https://sct.ftqq.com/ → 微信扫码登录(自动注册)→ 复制 SendKey(
      SCT...
      或
      sctp...
      )→ 保存到
      ASK4ME_SERVERCHAN_SENDKEY
      。
    • 没有 SendKey 不要创建请求。
  3. 发请求:
    node scripts/ask4me.mjs ask --title "确认发布" --body "请确认"
    • 首次运行会自动生成并保存 API key,不需要手动 keygen。
  4. 用户在手机上点 OK,拿到结果即接通。
  5. 之后按“正式使用”发按钮/输入/JSON Forms 请求。
After installing from GitHub /
npx skills add
, this file is all you need to read; there is no need to wait for anyone to provide further instructions.
  1. Verify Node 18+:
    node -v
  2. 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 (
      SCT...
      or
      sctp...
      ) → save it to
      ASK4ME_SERVERCHAN_SENDKEY
      .
    • Do not create a request without a SendKey.
  3. 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.
  4. The user taps OK on their phone, and the connection is established once the result is received.
  5. Then send button/input/JSON Forms requests as described under “Regular use.”

默认:先用公共试用服务

Default: start with the public trial service

不要一上来就让用户自建服务器——先用试用服务,门槛最低;自建是升级路径,不是前置条件。
  • 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

脚本在每次
ask
/
create
/
test
启动时检查一次 GitHub 上的 skill 版本(最多每 24 小时一次,网络失败自动忽略,不阻塞请求)。发现新版本会在 stderr 提示:
text
[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
ask
/
create
/
test
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:
text
[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:
    ASK4ME_NO_UPDATE_CHECK=1
    or
    --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.mjs
,零依赖。
bash
node -v
如果低于 18,先让用户升级 Node,不要继续。
Node.js 18+ is required. The script is located at
scripts/ask4me.mjs
in the skill directory and has zero dependencies.
bash
node -v
If 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
和
--invite
。
The defaults are already built in, so there is no need to ask the user. Only change
ASK4ME_BASE_URL
and
--invite
if the user explicitly wants to self-host or customize them.

2. API key

2. API key

不需要手动生成。第一次运行
ask
会自动生成
a4m_askd-2026_<random>
,保存到
~/.config/ask4me/config.json
(权限 600)。
不要回显完整 key;如果用户已有自己的 key,用
ASK4ME_API_KEY
覆盖。
No manual generation is required. The first
ask
run automatically generates
a4m_askd-2026_<random>
and saves it to
~/.config/ask4me/config.json
(permissions 600).
Do not echo the full key; if the user already has their own key, override it with
ASK4ME_API_KEY
.

3. ServerChan SendKey(必填)

3. ServerChan SendKey (required)

没有 SendKey 就不能发通知,请求没有意义。 先问用户要 SendKey:
  1. 打开 https://sct.ftqq.com/;
  2. 微信扫码登录(没有账号会自动注册);
  3. 复制 SendKey(形如
    SCT...
    或
    sctp...
    );
  4. 保存到当前项目环境变量
    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:
  1. Open https://sct.ftqq.com/;
  2. Scan the QR code and log in with WeChat (an account is created automatically if necessary);
  3. Copy the SendKey (in the form
    SCT...
    or
    sctp...
    );
  4. Save it to the current project's
    ASK4ME_SERVERCHAN_SENDKEY
    environment variable.
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
    ASK4ME_E2EE_PASSWORD
    , or add
    --no-e2ee
    .
  • Enabled: have the user set a passphrase and save it to
    ASK4ME_E2EE_PASSWORD
    . The passphrase is used only for encryption and will not be sent to the server.
  • 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.submitted
/
action=ok
即配置成功。脚本会打印公共试用服务提醒;请把“不稳定、正式使用请自建”转告用户。
After the user confirms that push notifications can be sent:
bash
node scripts/ask4me.mjs ask \
  --title "Ask4Me 配置测试" \
  --body "收到请点 OK,确认链路正常。" \
  --expires 3600
Wait for the user to tap OK on their phone. A
user.submitted
/
action=ok
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.

正式使用

Regular use

按钮 / 审批

Buttons / Approval

bash
node scripts/ask4me.mjs ask \
  --title "确认发布 v1.2.3" \
  --body "请确认是否发布到生产环境。" \
  --mcd $':::buttons\n- [OK](ok)\n- [取消](cancel)\n:::' \
  --expires 3600
bash
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 3600
bash
node scripts/ask4me.mjs ask \
  --title "补充说明" \
  --body "请填写发布备注。" \
  --mcd $':::input name="note" label="备注" submit="提交"\n:::' \
  --expires 3600

JSON Forms 表单

JSON Forms

先写一个 JSON 文件(例如
/tmp/form.json
):
json
{
  "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.text
/
data.payload
已在本地解密,直接使用。
First, create a JSON file, for example
/tmp/form.json
:
json
{
  "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
The 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,
data.text
/
data.payload
have already been decrypted locally and can be used directly.

试用 vs 自建

Trial vs. self-hosted

公共试用服务自建服务器
地址
https://ask.app.ft07.com
自己的域名
邀请码
askd-2026
自己配置
数据可能清理,不保证保留自己控制
稳定性不保证,可能限流/停机自己负责
适合试用、体验、轻量任务长期使用、敏感/关键任务
先用试用服务跑通,再决定是否自建;不要在用户还没体验前就要求他搭服务器。
Public trial serviceSelf-hosted server
URL
https://ask.app.ft07.com
Your own domain
Invitation code
askd-2026
Configure your own
DataMay be cleaned up; retention is not guaranteedUnder your control
StabilityNot guaranteed; may be rate-limited or unavailableYour responsibility
Suitable forTrials, evaluation, lightweight tasksLong-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

现象处理
没有
ASK4ME_SERVERCHAN_SENDKEY
停下来,引导用户去 https://sct.ftqq.com/ 微信扫码登录并复制 SendKey;不要创建请求
401 Unauthorized
自动保存的 key 失效或邀请码被更换;删掉
~/.config/ask4me/config.json
后重试,或
--invite
指定新邀请码
notify.failed
SendKey 无效/被限流;让用户检查 ServerChan,或更换 SendKey
点 OK 后
403 forbidden
请求已过期(默认 1 小时);让用户尽快点,或重发并调大
--expires
429
配额满(每 key / 每 IP / 全局);稍后再试,不要循环重发
request.expired
用户没在有效期内提交;问用户是否重发,不要自动连发
命令被 Agent 超时把
--expires
调小(如 120/300),或让用户先确认在线再发
E2EE 页面提示口令错误口令不一致;让用户确认大小写/空格。服务端无法找回
SymptomAction
ASK4ME_SERVERCHAN_SENDKEY
is missing
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
401 Unauthorized
The automatically saved key has expired or the invitation code has changed; delete
~/.config/ask4me/config.json
and retry, or specify a new invitation code with
--invite
notify.failed
The SendKey is invalid or rate-limited; have the user check ServerChan or replace the SendKey
403 forbidden
after tapping OK
The request has expired (default: 1 hour); have the user tap it as soon as possible, or resend it with a larger
--expires
value
429
The quota is exhausted (per key / per IP / global); try again later and do not resend in a loop
request.expired
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 AgentReduce
--expires
(for example, to 120/300), or have the user confirm that they are online before sending
The E2EE page reports an incorrect passphraseThe 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
    ,
    ASK4ME_SERVERCHAN_SENDKEY
    , or
    ASK4ME_E2EE_PASSWORD
    into repositories, commits, logs, or public responses.
  • 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 = 租户,无账号;服务端不保存用户资料。
  • notify
    必须每请求携带;全局 ServerChan/Apprise 不生效。
  • 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.
  • notify
    must be included with every request; global ServerChan/Apprise settings do not take effect.
  • E2EE is opt-in per request:
    ASK4ME_E2EE_ENABLED=true
    only means that the server permits it and does not enforce it.
  • 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.md
只有一段,供我们主动发给用户复制;从 GitHub 直接安装的用户不需要它,按本文件即可。
INSTALL_PROMPT.md
contains only one paragraph for us to proactively send to users to copy. Users who install directly from GitHub do not need it; they can follow this file instead.