CLI-EXPLORER — 适配器探索式开发完全指南
本文档教你（或 AI Agent）如何为 OpenCLI 添加一个新网站的命令。
从零到发布，覆盖 API 发现、方案选择、适配器编写、测试验证全流程。
[!TIP]
只想为一个具体页面快速生成一个命令？
看
opencli-oneshot skill
（~150 行，4 步搞定）。
本文档适合从零探索一个新站点的完整流程。
[!TIP]
想要全自动生成？
直接运行
opencli generate
在浏览器中打开目标页面，观察网络请求
opencli explore https://www.example.com --site mysite -v
或直接用 evaluate 测试 API
opencli bilibili hot -v
查看已有命令的 pipeline 每步数据流
- 关注抓包结果中的关键信息：
- URL pattern
- :
- /api/v2/hot?limit=20
- → 这就是你要调用的端点
- Method
- :
- GET
- /
- POST
- Request Headers
-
- Cookie? Bearer? 自定义签名头（X-s、X-t）?
- Response Body
-
- JSON 结构，特别是数据在哪个路径（
- data.items
- 、
- data.list
- ）
- 1c. 高阶 API 发现捷径法则 (Heuristics)
- 在开始死磕复杂的抓包拦截之前，按照以下优先级进行尝试：
- 后缀爆破法 (
- .json
- )
-
- 像 Reddit 这样复杂的网站，只要在其 URL 后加上
- .json
- （例如
- /r/all.json
- ），就能在带 Cookie 的情况下直接利用
- fetch
- 拿到极其干净的 REST 数据（Tier 2 Cookie 策略极速秒杀）。另外如功能完备的
- 雪球 (xueqiu)
- 也可以走这种纯 API 的方式极简获取，成为你构建简单 TS pipeline 适配器的黄金标杆。
- 全局状态查找法 (
- INITIAL_STATE
- )
-
- 许多服务端渲染 (SSR) 的网站（如小红书、Bilibili）会将首页或详情页的完整数据挂载到全局 window 对象上。与其去拦截网络请求，不如直接
- page.evaluate('() => window.INITIAL_STATE')
- 获取整个数据树。
- 主动交互触发法 (Active Interaction)
-
- 很多深层 API（如视频字幕、评论下的回复）是懒加载的。在静态抓包找不到数据时，尝试在
- evaluate
- 步骤或手动打断点时，主动去
- 点击（Click）页面上的对应按钮
- （如"CC"、"展开全部"），从而诱发隐藏的 Network Fetch。
- 框架探测与 Store Action 截断
-
- 如果站点使用 Vue + Pinia，可以使用
- tap
- 步骤调用 action，让前端框架代替你完成复杂的鉴权签名封装。
- 底层 XHR/Fetch 拦截
- 最后手段，当上述都不行时，使用 TypeScript 适配器进行无侵入式的请求抓取。 1d. 框架检测 Explore 自动检测前端框架。如果需要手动确认：
在已打开目标网站的情况下
opencli evaluate "(()=>{ const vue3 = !!document.querySelector('#app')?.vue_app; const vue2 = !!document.querySelector('#app')?.vue; const react = !!window.REACT_DEVTOOLS_GLOBAL_HOOK; const pinia = vue3 && !!document.querySelector('#app').vue_app.config.globalProperties.\ $pinia ; return JSON.stringify({vue3, vue2, react, pinia}); })()" Vue + Pinia 的站点（如小红书）可以直接通过 Store Action 绕过签名。 Step 2: 选择认证策略 OpenCLI 提供 5 级认证策略。使用 cascade 命令自动探测： opencli cascade https://api.example.com/hot 策略决策树 直接 fetch(url) 能拿到数据？ → ✅ Tier 1: public（公开 API，不需要浏览器） → ❌ fetch(url, {credentials:'include'}) 带 Cookie 能拿到？ → ✅ Tier 2: cookie（最常见，evaluate 步骤内 fetch） → ❌ → 加上 Bearer / CSRF header 后能拿到？ → ✅ Tier 3: header（如 Twitter ct0 + Bearer） → ❌ → 网站有 Pinia/Vuex Store？ → ✅ Tier 4: intercept（Store Action + XHR 拦截） → ❌ Tier 5: ui（UI 自动化，最后手段） 各策略对比 Tier 策略 速度 复杂度 适用场景 实例 1 public ⚡ ~1s 最简 公开 API，无需登录 Hacker News, V2EX 2 cookie 🔄 ~7s 简单 Cookie 认证即可 Bilibili, Zhihu, Reddit 3 header 🔄 ~7s 中等 需要 CSRF token 或 Bearer Twitter GraphQL 4 intercept 🔄 ~10s 较高 请求有复杂签名 小红书 (Pinia + XHR) 5 ui 🐌 ~15s+ 最高 无 API，纯 DOM 解析 遗留网站 Step 2.5: 准备工作（写代码之前） 先找模板：从最相似的现有适配器开始 不要从零开始写 。先看看同站点已有哪些适配器： ls clis/ < site
/
看看已有什么
cat clis/ < site
/feed.ts
读最相似的那个
最高效的方式是
复制最相似的适配器，然后改 3 个地方
：
name
→ 新命令名
API URL → 你在 Step 1 发现的端点
字段映射 → 对应新 API 的字段
平台 SDK 速查表
写 TS 适配器之前，先看看你的目标站点有没有
现成的 helper 函数
可以复用：
Bilibili (
clis/bilibili/utils.ts
)
函数
用途
何时使用
fetchJson(page, url)
带 Cookie 的 fetch + JSON 解析
普通 Cookie-tier API
apiGet(page, path, {signed, params})
带 Wbi 签名的 API 调用
URL 含
/wbi/
的接口
getSelfUid(page)
获取当前登录用户的 UID
"我的xxx" 类命令
resolveUid(page, input)
解析用户输入的 UID(支持数字/URL)
--uid
参数处理
wbiSign(page, params)
底层 Wbi 签名生成
通常不直接用，
apiGet
已封装
stripHtml(s)
去除 HTML 标签
清理富文本字段
如何判断需不需要
apiGet
？看 Network 请求 URL：
含
/wbi/
或
w_rid=
→ 必须用
apiGet(..., { signed: true })
不含 → 直接用
fetchJson
其他站点（Twitter、小红书等）暂无专用 SDK，直接用
page.evaluate
+
fetch
即可。
Step 3: 编写适配器
适配器格式：统一使用 TypeScript
所有适配器统一使用 TypeScript
cli()
API。YAML adapter 格式已不再支持。
所有新适配器 → TypeScript (clis/https://api.example.com/list?pn=
${
pn
}
&ps=
${
ps
}
)
;
return
payload
.
data
?.
list
||
[
]
;
}
,
大多数站点的
ps
上限是 20~50。超过会被静默截断或返回错误。
方式 A: TS
cli()
+
func()
（标准模式，推荐）
文件路径:
clis/(async () => {
const res = await fetch('/api/v3/feed/topstory/hot-lists/total?limit=50', {
credentials: 'include'
});
const d = await res.json();
return (d?.data || []).map(item => {
const t = item.target || {};
return {
title: t.title,
heat: item.detail_text || '',
answers: t.answer_count,
};
});
})()
)
;
return
(
data
as
any
[
]
)
.
slice
(
0
,
kwargs
.
limit
)
.
map
(
(
item
,
i
)
=>
(
{
rank
:
i
+
1
,
title
:
item
.
title
,
heat
:
item
.
heat
,
answers
:
item
.
answers
,
}
)
)
;
}
,
}
)
;
关键
:
page.evaluate
内的
fetch
运行在浏览器页面内，自动携带
credentials: 'include'
，无需手动处理 Cookie。
进阶 — 带搜索参数
// clis/zhihu/search.ts
import
{
cli
,
Strategy
}
from
'@jackwener/opencli/registry'
;
cli
(
{
site
:
'zhihu'
,
name
:
'search'
,
description
:
'知乎搜索'
,
domain
:
'www.zhihu.com'
,
strategy
:
Strategy
.
COOKIE
,
browser
:
true
,
args
:
[
{
name
:
'query'
,
type
:
'str'
,
required
:
true
,
positional
:
true
,
help
:
'Search query'
}
,
{
name
:
'limit'
,
type
:
'int'
,
default
:
10
}
,
]
,
columns
:
[
'rank'
,
'title'
,
'type'
,
'author'
,
'votes'
]
,
func
:
async
(
page
,
kwargs
)
=>
{
await
page
.
goto
(
'https://www.zhihu.com'
)
;
const
data
=
await
page
.
evaluate
(
(async () => {
const q = encodeURIComponent('
${
kwargs
.
query
}
');
const res = await fetch('/api/v4/search_v3?q=' + q + '&t=general&limit=
${
kwargs
.
limit
}
', {
credentials: 'include'
});
const d = await res.json();
return (d?.data || [])
.filter(item => item.type === 'search_result')
.map(item => ({
title: (item.object?.title || '').replace(/<[^>]+>/g, ''),
type: item.object?.type || '',
author: item.object?.author?.name || '',
votes: item.object?.voteup_count || 0,
}));
})()
)
;
return
(
data
as
any
[
]
)
.
slice
(
0
,
kwargs
.
limit
)
.
map
(
(
item
,
i
)
=>
(
{
rank
:
i
+
1
,
...
item
,
}
)
)
;
}
,
}
)
;
Tier 4 — Store Action + Interceptor（intercept 策略）
适用于 Vue + Pinia/Vuex 的网站（如小红书），使用
installInterceptor
捕获 store action 触发的请求：
// clis/xiaohongshu/notifications.ts
import
{
cli
,
Strategy
}
from
'@jackwener/opencli/registry'
;
cli
(
{
site
:
'xiaohongshu'
,
name
:
'notifications'
,
description
:
'小红书通知'
,
domain
:
'www.xiaohongshu.com'
,
strategy
:
Strategy
.
INTERCEPT
,
browser
:
true
,
args
:
[
{
name
:
'type'
,
type
:
'str'
,
default
:
'mentions'
,
help
:
'Notification type: mentions, likes, or connections'
}
,
{
name
:
'limit'
,
type
:
'int'
,
default
:
20
}
,
]
,
columns
:
[
'rank'
,
'user'
,
'action'
,
'content'
,
'note'
,
'time'
]
,
func
:
async
(
page
,
kwargs
)
=>
{
await
page
.
goto
(
'https://www.xiaohongshu.com/notification'
)
;
await
page
.
wait
(
3
)
;
// 安装拦截器捕获包含 '/you/' 的请求
await
page
.
installInterceptor
(
'/you/'
)
;
// 通过 Pinia store action 触发 API 请求
await
page
.
evaluate
(
(async () => {
const app = document.querySelector('#app')?.__vue_app__;
const pinia = app?.config?.globalProperties?.$pinia;
const store = pinia?._s?.get('notification');
if (store?.getNotification) {
await store.getNotification('
${
kwargs
.
type
}
');
}
})()
)
;
// 获取拦截的请求
const
requests
=
await
page
.
getInterceptedRequests
(
)
;
if
(
!
requests
?.
length
)
return
[
]
;
let
results
:
any
[
]
=
[
]
;
for
(
const
req
of
requests
)
{
const
items
=
req
.
data
?.
data
?.
message_list
||
[
]
;
results
.
push
(
...
items
)
;
}
return
results
.
slice
(
0
,
kwargs
.
limit
)
.
map
(
(
item
,
i
)
=>
(
{
rank
:
i
+
1
,
user
:
item
.
user_info
?.
nickname
||
''
,
action
:
item
.
title
||
''
,
content
:
item
.
comment_info
?.
content
||
''
,
}
)
)
;
}
,
}
)
;
方式 B: TypeScript 适配器（进阶模式）
适用于需要嵌入 JS 代码读取 Pinia state、XHR 拦截、GraphQL、分页、复杂数据转换等场景。
文件路径:
clis/(async () => {
// 从 Cookie 提取 CSRF token
const ct0 = document.cookie.split(';')
.map(c => c.trim())
.find(c => c.startsWith('ct0='))?.split('=')[1];
if (!ct0) return { error: 'Not logged in' };
const bearer = 'AAAAAAAAAAAAAAAAAAAAANRILgAAAAAAnNwIzUejRCOuH5E6I8xnZz4puTs%3D...';
const headers = {
'Authorization': 'Bearer ' + decodeURIComponent(bearer),
'X-Csrf-Token': ct0,
'X-Twitter-Auth-Type': 'OAuth2Session',
};
const variables = JSON.stringify({ rawQuery: '
${
kwargs
.
query
}
', count: 20 });
const url = '/i/api/graphql/xxx/SearchTimeline?variables=' + encodeURIComponent(variables);
const res = await fetch(url, { headers, credentials: 'include' });
return await res.json();
})()
)
;
// ... 解析 data
}
,
}
)
;
Tier 4 — XHR/Fetch 双重拦截 (Twitter/小红书 通用模式)
// clis/xiaohongshu/user.ts
import
{
cli
,
Strategy
}
from
'@jackwener/opencli/registry'
;
cli
(
{
site
:
'xiaohongshu'
,
name
:
'user'
,
description
:
'获取用户笔记'
,
strategy
:
Strategy
.
INTERCEPT
,
args
:
[
{
name
:
'id'
,
required
:
true
}
]
,
columns
:
[
'rank'
,
'title'
,
'likes'
,
'url'
]
,
func
:
async
(
page
,
kwargs
)
=>
{
await
page
.
goto
(
https://www.xiaohongshu.com/user/profile/
${
kwargs
.
id
}
)
;
await
page
.
wait
(
5
)
;
// XHR/Fetch 底层拦截：捕获所有包含 'v1/user/posted' 的请求
await
page
.
installInterceptor
(
'v1/user/posted'
)
;
// 触发后端 API：模拟人类用户向底部滚动2次
await
page
.
autoScroll
(
{
times
:
2
,
delayMs
:
2000
}
)
;
// 提取所有被拦截捕获的 JSON 响应体
const
requests
=
await
page
.
getInterceptedRequests
(
)
;
if
(
!
requests
||
requests
.
length
===
0
)
return
[
]
;
let
results
=
[
]
;
for
(
const
req
of
requests
)
{
if
(
req
.
data
?.
data
?.
notes
)
{
for
(
const
note
of
req
.
data
.
data
.
notes
)
{
results
.
push
(
{
title
:
note
.
display_title
||
''
,
likes
:
note
.
interact_info
?.
liked_count
||
'0'
,
url
:
https://explore/
${
note
.
note_id
||
note
.
id
}
}
)
;
}
}
}
return
results
.
slice
(
0
,
20
)
.
map
(
(
item
,
i
)
=>
(
{
rank
:
i
+
1
,
...
item
,
}
)
)
;
}
,
}
)
;
拦截核心思路
：不自己构造签名，而是利用
installInterceptor
劫持网站自己的
XMLHttpRequest
和
fetch
，让网站发请求，我们直接在底层取出解析好的
response.json()
。
级联请求
（如 BVID→CID→字幕）的完整模板和要点见下方
进阶模式: 级联请求
章节。
Step 4: 测试
构建通过 ≠ 功能正常
。
npm run build
只验证 TypeScript 语法，不验证运行时行为。
每个新命令
必须实际运行
并确认输出正确后才算完成。
必做清单
1. 构建（确认语法无误）
npm run build
2. 确认命令已注册
opencli list | grep mysite
3. 实际运行命令（最关键！）
opencli mysite hot --limit 3 -v
verbose 查看每步数据流
opencli mysite hot --limit 3 -f json
JSON 输出确认字段完整
tap 步骤调试（intercept 策略专用） 不要猜 store name / action name 。先用 evaluate 探索，再写 TS 适配器。 Step 1: 列出所有 Pinia store 在浏览器中打开目标网站后： opencli evaluate "(() => { const app = document.querySelector('#app')?.vue_app; const pinia = app?.config?.globalProperties?.\ $pinia ; return [...pinia._s.keys()]; })()"
输出: ["user", "feed", "search", "notification", ...]
Step 2: 查看 store 的 action 名称 故意写一个错误 action 名，tap 会返回所有可用 actions： ⚠ tap: Action not found: wrongName on store notification 💡 Available: getNotification, replyComment, getNotificationCount, reset Step 3: 用 network requests 确认 capture 模式
在浏览器打开目标页面，查看网络请求
找到目标 API 的 URL 特征（如 "/you/mentions"、"homefeed"）
完整流程 ┌──────────────┐ ┌──────────────┐ ┌──────────────┐ ┌────────┐ │ 1. navigate │ ──▶ │ 2. 探索 store │ ──▶ │ 3. 写 TS │ ──▶ │ 4. 测试 │ │ 到目标页面 │ │ name/action │ │ interceptor │ │ 运行验证 │ └──────────────┘ └──────────────┘ └──────────────┘ └────────┘ Verbose 模式 & 输出验证 opencli bilibili hot --limit 1 -v
查看 pipeline 每步数据流
opencli mysite hot -f json | jq '.[0]'
确认 JSON 可被解析
opencli mysite hot -f csv
data.csv
确认 CSV 可导入
Step 5: 提交发布
文件放入
clis/
确认注册
git
add
clis/mysite/
&&
git
commit
-m
"feat(mysite): add hot"
&&
git
push
架构理念
：OpenCLI 内建
Zero-Dependency jq
数据流 — 所有解析在
evaluate
的原生 JS 内完成，TS
func()
内直接处理数据，无需依赖系统
jq
二进制。
进阶模式: 级联请求 (Cascading Requests)
当目标数据需要多步 API 链式获取时（如
BVID → CID → 字幕列表 → 字幕内容
），在 TS
func()
内按步骤串联即可。
模板代码
import
{
cli
,
Strategy
}
from
'@jackwener/opencli/registry'
;
import
type
{
IPage
}
from
'@jackwener/opencli/types'
;
import
{
apiGet
}
from
'./utils.js'
;
// 复用平台 SDK
cli
(
{
site
:
'bilibili'
,
name
:
'subtitle'
,
strategy
:
Strategy
.
COOKIE
,
args
:
[
{
name
:
'bvid'
,
required
:
true
}
]
,
columns
:
[
'index'
,
'from'
,
'to'
,
'content'
]
,
func
:
async
(
page
:
IPage
|
null
,
kwargs
:
any
)
=>
{
if
(
!
page
)
throw
new
Error
(
'Requires browser'
)
;
// Step 1: 建立 Session
await
page
.
goto
(
https://www.bilibili.com/video/
${
kwargs
.
bvid
}
/
)
;
// Step 2: 从页面提取中间 ID (INITIAL_STATE)
const
cid
=
await
page
.
evaluate
(
(async () => {
return window.__INITIAL_STATE__?.videoData?.cid;
})()
)
;
if
(
!
cid
)
throw
new
Error
(
'无法提取 CID'
)
;
// Step 3: 用中间 ID 调用下一级 API (自动 Wbi 签名)
const
payload
=
await
apiGet
(
page
,
'/x/player/wbi/v2'
,
{
params
:
{
bvid
:
kwargs
.
bvid
,
cid
}
,
signed
:
true
,
// ← 自动生成 w_rid
}
)
;
// Step 4: 检测风控降级 (空值断言)
const
subtitles
=
payload
.
data
?.
subtitle
?.
subtitles
||
[
]
;
const
url
=
subtitles
[
0
]
?.
subtitle_url
;
if
(
!
url
)
throw
new
Error
(
'subtitle_url 为空，疑似风控降级'
)
;
// Step 5: 拉取最终数据 (CDN JSON)
const
items
=
await
page
.
evaluate
(
(async () => {
const res = await fetch(
${
JSON
.
stringify
(
'https:'
+
url
)
}
);
const json = await res.json();
return { data: json.body || json };
})()
)
;
return
items
.
data
.
map
(
(
item
,
idx
)
=>
(
{
...
}
)
)
;
}
,
}
)
;
关键要点
步骤
注意事项
提取中间 ID
优先从
INITIAL_STATE
拿，避免额外 API 调用
Wbi 签名
B 站
/wbi/
接口
强制校验
w_rid
，纯
fetch
会被 403
空值断言
即使 HTTP 200，核心字段可能为空串（风控降级）
CDN URL
常以
//
开头，记得补
https:
JSON.stringify
拼接 URL 到 evaluate 时必须用它转义，避免注入
常见陷阱
陷阱
表现
解决方案
缺少
navigate
evaluate 报
Target page context
错误
在 evaluate 前加
page.goto()
步骤
嵌套字段访问
${{ item.node?.title }}
不工作
在 evaluate 中 flatten 数据，不在模板中用 optional chaining
缺少
strategy: public
公开 API 也启动浏览器，7s → 1s
公开 API 加上
strategy: public
+
browser: false
evaluate 返回字符串
map 步骤收到
""
而非数组
pipeline 有 auto-parse，但建议在 evaluate 内
.map()
整形
搜索参数被 URL 编码
${{ args.query }}
被浏览器二次编码
在 evaluate 内用
encodeURIComponent()
手动编码
Cookie 过期
返回 401 / 空数据
在浏览器里重新登录目标站点
Extension tab 残留
Chrome 多出
chrome-extension://
tab
已自动清理；若残留，手动关闭即可
TS evaluate 格式
() => {}
报
result is not a function
TS 中
page.evaluate()
必须用 IIFE：
(async () => { ... })()
页面异步加载
evaluate 拿到空数据（store state 还没更新）
在 evaluate 内用 polling 等待数据出现，或增加
wait
时间
evaluate 内嵌大段 JS
调试困难，字符串转义问题
把逻辑放在
func()
内，用原生 TS 编写
风控被拦截(伪200)
获取到的 JSON 里核心数据是
""
(空串)
极易被误判。必须添加断言！无核心数据立刻要求升级鉴权 Tier 并重新配置 Cookie
API 没找见
explore
工具打分出来的都拿不到深层数据
点击页面按钮诱发懒加载数据，再结合
getInterceptedRequests
获取
用 AI Agent 自动生成适配器
最快的方式是让 AI Agent 完成全流程：
一键：探索 → 分析 → 合成 → 注册
opencli generate https://www.example.com --goal "hot"
或分步执行：
opencli explore https://www.example.com --site mysite
发现 API
opencli explore https://www.example.com --auto --click "字幕,CC"
模拟点击触发懒加载 API
opencli synthesize mysite
生成候选 TS
opencli verify mysite/hot --smoke
冒烟测试
生成的候选 TS 保存在
.opencli/explore/mysite/candidates/
，可直接复制到
clis/mysite/
并微调。
Record Workflow
record
是为「无法用
explore
自动发现」的页面（需要登录操作、复杂交互、SPA 内路由）准备的手动录制方案。
工作原理
opencli record
1. 启动录制（建议 --timeout 给足操作时间）
opencli record "https://example.com/page" --timeout 120000
2. 在弹出的 automation window 里正常操作页面：
- 打开列表、搜索、点击条目、切换 Tab
- 凡是触发网络请求的操作都会被捕获
3. 完成操作后按 Enter 停止（或等超时自动停止）
4. 查看结果
cat .opencli/record/ < site
/captured.json
原始捕获
ls .opencli/record/ < site
/candidates/
候选 TS
页面类型与捕获预期
页面类型
预期捕获量
说明
列表/搜索页
多（5~20+）
每次搜索/翻页都会触发新请求
详情页（只读）
少（1~5）
首屏数据一次性返回，后续操作走 form/redirect
SPA 内路由跳转
中等
路由切换会触发新接口，但首屏请求在注入前已发出
需要登录的页面
视操作而定
确保 Chrome 已登录目标网站
注意
：如果页面在导航完成前就发出了大部分请求（服务端渲染 / SSR 注水），拦截器会错过这些请求。
解决方案：在页面加载完成后，手动触发能产生新请求的操作（搜索、翻页、切 Tab、展开折叠项等）。
候选 TS 微调
生成的候选 TS 是起点，通常需要微调（尤其是 tae 等内部系统）：
候选结构
（自动生成，可能需要调整）：
// 自动生成的候选，需要微调
// site: tae
// name: getList # 从 URL path 推断的名称
// strategy: cookie
browser
:
true
pipeline
:
-
navigate
:
https
:
/
/
...
-
evaluate
:
|
(
async
(
)
=>
{
const
res
=
await
fetch
(
'/approval/getList.json?procInsId=...'
,
{
credentials
:
'include'
}
)
;
const
data
=
await
res
.
json
(
)
;
return
(
data
?.
content
?.
operatorRecords
||
[
]
)
.
map
(
item
=>
(
{
...
}
)
)
;
}
)
(
)
转换为 TS CLI
（参考
clis/tae/add-expense.ts
风格）：
import
{
cli
,
Strategy
}
from
'@jackwener/opencli/registry'
;
cli
(
{
site
:
'tae'
,
name
:
'get-approval'
,
description
:
'查看报销单审批流程和操作记录'
,
domain
:
'tae.alibaba-inc.com'
,
strategy
:
Strategy
.
COOKIE
,
browser
:
true
,
args
:
[
{
name
:
'proc_ins_id'
,
type
:
'string'
,
required
:
true
,
positional
:
true
,
help
:
'流程实例 ID（procInsId）'
}
,
]
,
columns
:
[
'step'
,
'operator'
,
'action'
,
'time'
]
,
func
:
async
(
page
,
kwargs
)
=>
{
await
page
.
goto
(
'https://tae.alibaba-inc.com/expense/pc.html?_authType=SAML'
)
;
await
page
.
wait
(
2
)
;
const
result
=
await
page
.
evaluate
(
(async () => {
const res = await fetch('/approval/getList.json?taskId=&procInsId=
${
kwargs
.
proc_ins_id
}
', {
credentials: 'include'
});
const data = await res.json();
return data?.content?.operatorRecords || [];
})()
)
;
return
(
result
as
any
[
]
)
.
map
(
(
r
,
i
)
=>
(
{
step
:
i
+
1
,
operator
:
r
.
operatorName
||
r
.
userId
,
action
:
r
.
operationType
,
time
:
r
.
operateTime
,
}
)
)
;
}
,
}
)
;
转换要点
：
URL 中的动态 ID（
procInsId
、
taskId
等）提取为
args
captured.json
里的真实 body 结构用于确定正确的数据路径（如
content.operatorRecords
）
tae 系统统一用
{ success, content, errorCode, errorMsg }
外层包裹，取数据要走
content.*
认证方式：cookie（
credentials: 'include'
），不需要额外 header
文件放入
clis/