@yizhuan-cli/cli 0.1.17-beta.0 → 0.1.17-beta.1

package/README.md

@@ -99,3 +99,9 @@ yizhuan execute --ability hot_topics --params "{\"platform\":\"douyin\"}"
 - `我的会员什么时候到期`
 
 纯创作请求（例如“写一篇中秋文章”）由当前 Agent 完成，不调用 `content_extract`；CLI 只提供真实内容素材，不负责生成、改写或发布。
+
+## 使用统计
+
+仅采集业务调用元数据，不采集问题、关键词、URL、正文或返回内容。
+调用方可设置 `YIZHUAN_TRIGGER=user_initiated` 表示用户当前提问或手动触发（含 AI 代执行），设置 `YIZHUAN_TRIGGER=automated` 表示定时或无人值守任务。
+未设置时归为 `unknown`，不会猜测来源。检测轮询不计活跃。通过 `YIZHUAN_TELEMETRY=0` 可关闭使用埋点。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yizhuan-cli/cli",
-  "version": "0.1.17-beta.0",
+  "version": "0.1.17-beta.1",
   "description": "易撰命令行工具，用于通过 API Key 查询易撰真实数据。",
   "private": false,
   "type": "module",

package/resources/yizhuan-cli/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: yizhuan-cli
 description: |
-  安装、配置并使用易撰 CLI（yizhuan 命令）查询真实数据、提取文章/视频/图文内容的全量 Skill；若已安装用户明确指定平台对应的 yizhuan-<platform> Skill，必须优先使用对应的拆分平台 Skill。业务数据禁止臆造，文章创作由当前 Agent 完成。
+  安装、配置并使用易撰 CLI（yizhuan 命令）查询真实数据、提取文章/视频/图文内容的全量 Skill；若已安装用户明确指定平台对应的易撰平台 Skill，必须优先使用对应的拆分平台 Skill。业务数据禁止臆造，文章创作由当前 Agent 完成。
 ---
 
 # 易撰 CLI
@@ -94,3 +94,33 @@ yizhuan doctor
 - 取消关注前先查询关注列表，使用匹配项的 `articleId`，不得因结果不符合预期自行取消。
 - `unsupported` 表示当前口径不支持，`empty` 表示没有匹配数据；如实转述，不编造补充结果。
 - CLI 报错时保留脱敏后的错误信息，引导检查 `yizhuan doctor`，不得输出完整 Key。
+
+## CLI 调用来源
+
+在每次 `execute` 或 `query` 业务调用前，根据本次任务的触发原因设置进程环境变量 `YIZHUAN_TRIGGER`：
+
+- `user_initiated`：用户当前提问、手动指令及为完成该请求而执行的分页、后续能力调用。AI 代用户执行仍属于主动使用。
+- `automated`：定时执行、无人值守批处理、后台监控或自动唤醒。用户曾要求建立定时任务，不代表每次定时运行都是主动使用。
+- `unknown`：无法确定触发原因；不得默认标为主动，也不得仅因使用 AI 工具就标为自动。
+
+每次按当前触发原因显式覆盖，避免继承上一任务的来源。来源只通过子进程环境传递，不写入业务 JSON、API Key 配置或系统全局环境。调用结束后恢复原环境；一个任务中的分页保持同一来源，CLI 内置检测轮询由 CLI/服务端自动排除，不手工伪造 `polling`。
+
+Bash/zsh 的单次主动查询示例（自动任务把值改为 `automated`）：
+
+```bash
+YIZHUAN_TRIGGER=user_initiated yizhuan query --json-file request.json
+```
+
+PowerShell 示例，使用当前任务选择的来源并恢复原值：
+
+```powershell
+$cliPreviousTrigger = $env:YIZHUAN_TRIGGER
+try {
+  $env:YIZHUAN_TRIGGER = 'user_initiated'
+  yizhuan query --json-file request.json
+} finally {
+  $env:YIZHUAN_TRIGGER = $cliPreviousTrigger
+}
+```
+
+只有元数据参与使用统计，不额外上传用户问题、关键词、链接或正文。尊重用户现有的 `YIZHUAN_TELEMETRY=0` 设置，不启用或覆盖它。安装、配置、doctor、help 和 version 不作为业务使用；来源设置无需额外询问用户。来源标签不是触发新业务调用或定时任务的授权。

package/resources/yizhuan-cli/manifest.json

@@ -1,14 +1,14 @@
 {
   "schemaVersion": 1,
   "name": "yizhuan-cli",
-  "version": "0.1.16",
-  "compatibleCliVersion": "0.1.16",
-  "source": "npm:@yizhuan-cli/cli@0.1.16",
+  "version": "0.1.17-beta.1",
+  "compatibleCliVersion": "0.1.17-beta.1",
+  "source": "npm:@yizhuan-cli/cli@0.1.17-beta.1",
   "digestAlgorithm": "sha256",
   "files": [
     {
       "path": "SKILL.md",
-      "sha256": "b58b68be1bd53fb3c9c572e8ccefcf000ad837c4f54d5269959d23f2c12150d4"
+      "sha256": "f5d8858b7377e3afabc394bf2aab72ffce7b7cee60864d0d97d86549d68fd70b"
     }
   ]
 }

package/src/index.js

@@ -103,6 +103,8 @@ Abilities:
 Config:
   ${CONFIG_PATH}
   可通过环境变量 YIZHUAN_CONFIG_PATH 指定独立配置文件
+  YIZHUAN_TRIGGER=user_initiated 标识用户主动请求，automated 标识自动任务；未设置为 unknown
+  YIZHUAN_TELEMETRY=0 关闭使用元数据埋点
 `)
 }
 
@@ -238,6 +240,8 @@ function buildRequestHeaders(config) {
     'content-type': 'application/json',
     'x-device-type': 'pc',
     'x-yizhuan-cli-version': readPackageVersion(),
+    'x-yizhuan-trigger': ['user_initiated', 'automated'].includes(process.env.YIZHUAN_TRIGGER)
+      ? process.env.YIZHUAN_TRIGGER : 'unknown',
     'x-yizhuan-telemetry': config.telemetryEnabled ? '1' : '0'
   }
 }
@@ -494,7 +498,7 @@ async function execute(args) {
       if (Date.now() >= deadline) break
       const poll = await fetch(`${config.apiBaseUrl}/api/cli.execute`, {
         method: 'POST',
-        headers: buildRequestHeaders(config),
+        headers: { ...buildRequestHeaders(config), 'x-yizhuan-trigger': 'polling' },
         body: JSON.stringify({
           json: { ability: 'detection', params: { mode: 'get', id: result.data.id } }
         })