@dmall-inc/wd-cli 0.1.0 → 0.4.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -1,5 +1,7 @@
1
1
  # @dmall-inc/wd-cli
2
2
 
3
+ [![npm](https://img.shields.io/npm/v/@dmall-inc/wd-cli.svg)](https://www.npmjs.com/package/@dmall-inc/wd-cli)
4
+
3
5
  水滴平台的命令行工具。用统一身份登录一次,选定工作空间,就能在终端里访问平台上你看得到的技能、知识库、应用、会话、评测与可观测数据。
4
6
 
5
7
  ```bash
@@ -14,6 +16,24 @@ wd-cli skill list
14
16
 
15
17
  需要 Node.js 18 或更高版本。零运行时依赖。
16
18
 
19
+ ### 安装
20
+
21
+ 包已发布到 npm 公共仓库:[npmjs.com/package/@dmall-inc/wd-cli](https://www.npmjs.com/package/@dmall-inc/wd-cli)。
22
+
23
+ ```bash
24
+ npm i -g @dmall-inc/wd-cli # 安装最新版
25
+ npm i -g @dmall-inc/wd-cli@0.1.0 # 指定版本
26
+ npm update -g @dmall-inc/wd-cli # 升级
27
+ npm view @dmall-inc/wd-cli versions # 查看已发布版本
28
+ wd-cli --version # 确认本地版本
29
+ ```
30
+
31
+ 本机 npm 若指向内部镜像且拉不到这个包,显式指定公共仓库:
32
+
33
+ ```bash
34
+ npm i -g @dmall-inc/wd-cli --registry https://registry.npmjs.org
35
+ ```
36
+
17
37
  ---
18
38
 
19
39
  ## 目录
@@ -196,21 +216,54 @@ wd-cli kb share create|list 12 99
196
216
 
197
217
  批量上传时单个文件失败不会中断其余文件,最后按整体结果给退出码。
198
218
 
219
+ ### tool 工具
220
+
221
+ ```bash
222
+ wd-cli tool list [--scope personal|team|company] [--source mcp] [--keyword 工单] [--paginate]
223
+ wd-cli tool get 12 # 认证与自定义参数值一律脱敏
224
+ wd-cli tool subtools 12 # 子工具与授权状态
225
+ wd-cli tool subtools 12 --name search_docs -o json # 单个子工具的 inputSchema
226
+
227
+ wd-cli tool create --file mcp-tool.json # - 为标准输入
228
+ wd-cli tool update 12 --file patch.json
229
+ wd-cli tool delete 12 --yes
230
+ wd-cli tool test 12 # 按已保存配置探测连通性
231
+
232
+ wd-cli tool invoke 12 search_docs --arg query=报销 --arg limit=5
233
+ wd-cli tool invoke 30 getOrder --args '{"orderId":"A1"}'
234
+ echo '{"orderId":"A1"}' | wd-cli tool invoke 30 getOrder --args-file -
235
+ ```
236
+
237
+ `invoke` 直接调用工具(不经过 Agent),**会产生真实副作用**;连接地址与认证用平台上已保存的配置,CLI 只传子工具名与入参。
238
+
239
+ - 入参合并顺序 `--args-file` < `--args` < `--arg`(后者覆盖同名键);`--arg` 的值先按 JSON 解析(`5`、`true`、`[1,2]`、`{"a":1}`),失败当字符串;要保留前导零等字面量写成 JSON 字符串:`--arg 'id="007"'`;键支持点号嵌套:`--arg filter.status=open`。
240
+ - `--timeout-ms` 同时作为服务端调用超时(上限 120 秒);缺省等服务端按工具配置执行。
241
+ - 退出码:成功 0;工具自身报错(MCP `isError` / REST HTTP ≥ 300)或调用失败 1;子工具未获授权(业务码 403)3。
242
+ - 工具认证引用个人凭证时按当前登录用户解引用;工作空间令牌(`wat_`)只能查看与调用本空间团队工具和免审批的公司级工具,不能解引用个人凭证;`create` / `update` / `delete` 需登录态。
243
+ - 创建工具时认证值建议写凭证引用(`auth.valueSource=credential` + `auth.credentialKey`),不要把明文放进 JSON 文件。
244
+
199
245
  ### agent 应用与对话
200
246
 
201
247
  ```bash
202
248
  wd-cli agent list
203
249
  wd-cli agent list --q 客服 --published
204
250
  wd-cli agent list --type high-agent --paginate --json agentCode,name
251
+
252
+ wd-cli agent create --name "数仓排障助手" --model-id 3 --prompt-file ./prompt.md --skill-id 128 --publish
253
+ wd-cli agent create --dsl ./agent.yaml --publish --remark "初始版本"
205
254
  ```
206
255
 
207
- `agent list` 列出当前工作空间的应用,按更新时间倒序;可见范围与平台界面一致(工作空间成员能看到空间内全部应用)。`--published` 只留已发布的,也就是能拿去对话的;`--type` 直接用列表里「类型」列的值。输出里的 ID 就是后续命令要的 agentCode。登录态或工作空间令牌可用,应用访问密钥不行——它只代表单个应用。
256
+ `agent list` 列出当前工作空间的应用,按更新时间倒序;可见范围与平台界面一致(工作空间成员能看到空间内全部应用)。`--published` 只留已发布的,也就是能拿去对话的;`--type` 直接用列表里「类型」列的值。输出里的 ID 就是后续命令要的 agentCode。`agent create` 支持参数化或从 YAML DSL 新建 Agent(需工作空间构建权限),加 `--publish` 可一步完成首版发布上线。登录态或工作空间令牌可用,应用访问密钥不行——它只代表单个应用。
208
257
 
209
258
  ```bash
210
259
  wd-cli agent info --agent-code 66
211
260
  wd-cli agent metadata 66
212
261
  wd-cli agent revision 66
213
262
  wd-cli agent model 3 --agent-code 66
263
+ wd-cli agent update 66 --prompt-file ./prompt.md --publish
264
+ wd-cli agent publish 66 --remark "发布新版"
265
+ wd-cli agent bind-skill 66 --skill-id 128
266
+ wd-cli agent unbind-skill 66 --skill-id 128
214
267
 
215
268
  wd-cli agent chat 66
216
269
  wd-cli agent chat 66 -m "你好"
@@ -294,6 +347,68 @@ wd-cli automation create --session-id s-1 --data @task.json
294
347
  wd-cli download-link create --data '{"path":"/data/report.xlsx"}'
295
348
  ```
296
349
 
350
+ ### diwork 我的 DiWork
351
+
352
+ 以登录用户本人身份使用自己的 DiWork(AI 数字员工):运行环境、调用、工作区文件、自动化任务。**仅接受登录态**(`wd-cli auth login`),令牌直连会被本地拒绝。与 `agent chat` 一样走对话基址:单入口部署零配置,对话端点拆在别的域名时先 `wd-cli config set chatBaseUrl <server 地址>`。
353
+
354
+ ```bash
355
+ # 运行环境
356
+ wd-cli diwork status # 只读探测
357
+ wd-cli diwork status --ensure # 未就绪时触发供给;--retry 供给失败后重来
358
+
359
+ # 调用:在你的 DiWork 内跑一轮,回复直出;会话与 Web 端同源(Web 会话列表可见)
360
+ wd-cli diwork chat -m "把昨天的销售数据整理成表格放到 reports/"
361
+ wd-cli diwork chat -m "再按区域汇总" --session-id <上一轮提示的 id>
362
+ cat task.md | wd-cli diwork chat -m - --timeout-ms 600000 -o json
363
+ # 运行环境供给中时自动等待(缺省 180s,--wait-ms 调整);执行超时缺省 300s、上限 600s
364
+
365
+ # 工作区文件(与 Web 文件管理同一份)
366
+ wd-cli diwork file ls reports
367
+ wd-cli diwork file tree -o json
368
+ wd-cli diwork file upload ./a.csv ./b.csv --path inbox
369
+ wd-cli diwork file download reports/日报.xlsx -O ./out/
370
+ wd-cli diwork file mkdir reports/2026
371
+ wd-cli diwork file rename reports/draft.md final.md
372
+ wd-cli diwork file rm tmp/a.log tmp/b.log --yes # 逐项结果,任一失败退出码 1
373
+
374
+ # 自动化任务(与 Web 自动化页同一套;归属恒为本人)
375
+ wd-cli diwork automation list
376
+ wd-cli diwork automation create --file daily.json # name / scheduleType / cronExpression|runAt / params / pushTargets
377
+ wd-cli diwork automation run 12 --params "只看华东区" # 立即执行一次,结果非 SUCCESS 退出码 1
378
+ wd-cli diwork automation executions 12 --status FAILED
379
+ wd-cli diwork automation disable 12
380
+ wd-cli diwork automation delete 12 --yes
381
+ ```
382
+
383
+ > `automation` 资源组(上一节)是 Agent 访问密钥 + `--session-id`,供 DiWork 运行时内的 Agent 代用户建任务;人在终端里管理自己的任务用 `diwork automation`。
384
+
385
+ ### daemon / device 运行时(本机 Agent 接入 DiWork)
386
+
387
+ 把本机的 Claude Code、Codex、Pi 接入 DiWork「运行时」,在任意设备的浏览器里给它们发任务、看过程、审批工具调用。
388
+ daemon 主动外连平台,本机不开端口;只在白名单目录里工作;设备只有你自己能看到和使用。
389
+
390
+ ```bash
391
+ wd-cli auth login # 统一身份登录(daemon 只认登录态,不接受 --token)
392
+ wd-cli daemon start # 后台启动,首次启动自动登记本机;--foreground 前台运行
393
+ cd ~/code/my-repo && wd-cli open # 把当前目录作为项目接入(不在白名单时先确认加入),打印页面链接
394
+ wd-cli daemon roots add ~/code # 也可直接维护白名单根目录(list / remove);根目录内的子目录可在页面里选为项目
395
+ wd-cli daemon status # 运行状态、连接、允许目录、运行时
396
+ wd-cli daemon runtimes # 探测本机运行时(claude / codex / pi)
397
+ wd-cli daemon logs -f # 跟随日志(~/.config/wd-cli/daemon.log)
398
+ wd-cli daemon service install # 开机自启(macOS launchd / Linux systemd);print 只打印配置
399
+ wd-cli daemon stop
400
+ wd-cli device list # 我登记的设备(* 为本机);rename <id> <名称> / revoke <id>
401
+ ```
402
+
403
+ - 运行时探测:PATH 上能正常回答 `--version` 的 `claude` / `codex` / `pi`。Claude Code、Codex 经 ACP 适配器驱动(优先 PATH 上的 `claude-agent-acp` / `codex-acp`,否则 `npx -y` 按平台清单版本拉取);Pi 经 `pi --mode rpc` 驱动并注入审批扩展。
404
+ - 自动恢复:运行中每 60 秒复检一次运行时(`--version` 结果按二进制缓存,二进制没变不重复起进程);页面选了不可用的运行时会当场复检,运行时启动失败或进程退出也会触发复检,可用性变化即重报给平台,开机时没探测到、后来才安装或登录的运行时不用重启 daemon。适配器 120 秒内未完成初始化(如卡在等待登录)即结束本轮;取消后 10 秒仍不收口的适配器会被强制重启,下一轮按原会话续接。
405
+ - 审批:只读类工具直接放行,其余回到页面审批,超时(平台配置,默认 10 分钟)自动拒绝;`~/.config/wd-cli/daemon.json` 的 `autoApprove` 可列出额外放行的工具名。
406
+ - 覆盖命令 / 停用某个运行时:在 `daemon.json` 写 `"runtimes": {"claude": {"command": ["my-acp-adapter"]}, "codex": {"enabled": false}}`,运行中的 daemon 3 秒内生效。
407
+ - bridge 地址:`--bridge-url` > `WD_CLI_BRIDGE_URL` > `daemon.json` 的 `bridgeUrl` > 平台下发配置 > 平台基址。
408
+ - 设备令牌(`ldt_`)存系统钥匙串账号 `device:<profile>`;被撤销后 daemon 会用登录身份重新登记一次,仍失败即退出。
409
+ - 扩展:`wd-cli daemon executor add <npm 包>` 安装声明了 `wdCliExecutor` 的执行器包。
410
+ - 项目:页面侧栏按项目(工作目录)分组会话。页面「添加项目」只能浏览白名单根目录以内的子目录;白名单外的目录只能在本机用 `wd-cli open` 加入(非交互环境须 `--yes`)。打开记录写在 `daemon.json` 的 `projects`,daemon 重报清单后平台登记为项目。
411
+
297
412
  ### completion 补全
298
413
 
299
414
  ```bash
@@ -361,6 +476,15 @@ npm test # 全量测试,离线跑,不碰真实服务
361
476
 
362
477
  测试用进程内的 mock 平台与 mock 认证中心,跑的是真实入口进程,验的是退出码与标准输出 / 标准错误的实际分工。
363
478
 
364
- 发布沿用 `skills-cli` 的流程:改 `package.json` 的 `version`,`npm publish` 到内部 registry。
479
+ 发布到 npm 公共仓库([@dmall-inc/wd-cli](https://www.npmjs.com/package/@dmall-inc/wd-cli),需 `@dmall-inc` 组织的发布权限):
480
+
481
+ ```bash
482
+ npm login --registry https://registry.npmjs.org
483
+ npm version patch # 或 minor / major,改 package.json 的 version
484
+ npm publish --access public --registry https://registry.npmjs.org
485
+ npm view @dmall-inc/wd-cli version --registry https://registry.npmjs.org # 确认已上线
486
+ ```
487
+
488
+ scoped 包默认按私有发布,首次发布必须带 `--access public`。发布内容由 `package.json` 的 `files` 决定(`bin`、`lib`、`docs`、`README.md`),发布前可用 `npm pack --dry-run` 核对。
365
489
 
366
490
  设计取舍与对标的项目(`gh`、`gcloud`、`kubectl`、AWS CLI、clig.dev)见 [`docs/design-references.md`](./docs/design-references.md)。
@@ -10,6 +10,7 @@
10
10
  |--------|---------------|-----------|
11
11
  | `auth login / status / logout` 命令族与文案(`✓ Logged in as X`、状态按 host 分组列出) | `pkg/cmd/auth/**` | `lib/commands/auth.js` |
12
12
  | 通用逃生口:`-X` 方法、`-f` 字符串字段、`-F` 带类型推断字段、`--input` 请求体、`-H` 头、`--paginate` | `pkg/cmd/api/api.go` | `lib/commands/api.js` |
13
+ | `-F` 字段类型推断 + `--input` 请求体,二者可叠加、字段覆盖请求体同名键 | `pkg/cmd/api/api.go` | `tool invoke`:`--args-file` < `--args` < `--arg`;`--arg` 值按 JSON 解析(比 `-F` 宽:可直接写数组 / 对象),失败当字符串 |
13
14
  | `--json <fields>` 选字段 + `--jq <expr>` 过滤,非 TTY 自动机器可读 | `pkg/cmdutil/json_flags.go` | `lib/output.js`、`lib/jq.js` |
14
15
  | 令牌优先存 OS 密钥链,不可用时回落配置文件 | `internal/keyring` | `lib/keyring.js`(P2),回落 `hosts.json` |
15
16
  | 环境变量令牌覆盖登录态(`GH_TOKEN`) | `internal/config` | `WD_CLI_TOKEN`,语义完全一致 |
@@ -35,6 +36,7 @@
35
36
  | `config use-context` / `current-context` 的「当前上下文」模型 | `workspace use` / `workspace current` |
36
37
  | `--namespace` 单次覆盖当前上下文而不改配置 | `--workspace` 单次覆盖 |
37
38
  | `-o json\|yaml\|wide\|name` | `--output table\|json\|raw`(`-o`) |
39
+ | `kubectl set` / `helm --set a.b=v` 的点号嵌套赋值 | `tool invoke --arg filter.status=open`(点号键展开为嵌套对象) |
38
40
 
39
41
  ## 4. AWS CLI
40
42
 
package/lib/args.js CHANGED
@@ -193,8 +193,9 @@ function renderRootHelp(registry) {
193
193
  lines.push('');
194
194
  const groups = [
195
195
  ['接入', ['auth', 'workspace', 'config']],
196
- ['资源', ['skill', 'kb', 'agent', 'session']],
196
+ ['资源', ['skill', 'kb', 'tool', 'agent', 'session']],
197
197
  ['运营', ['credential', 'eval', 'dataset', 'trace', 'obs', 'score', 'automation', 'download-link']],
198
+ ['本机', ['open', 'daemon', 'device']],
198
199
  ['其它', ['api', 'completion', 'help']],
199
200
  ];
200
201
  for (const [label, ids] of groups) {
package/lib/auth.js CHANGED
@@ -59,7 +59,7 @@ function assertPrincipalAllowed(runtime, principal, topic, command, flags = {})
59
59
 
60
60
  const wanted = allowed.map((p) => LABEL[p]).join(' 或 ');
61
61
  const hints = allowed.map((p) => HOW_TO_GET[p]).filter(Boolean);
62
- hints.push(HOW_TO_GET.user);
62
+ if (!allowed.includes('user')) hints.push(HOW_TO_GET.user);
63
63
  throw new CliError(
64
64
  `当前用的是${LABEL[principal]},此命令需要${wanted}`,
65
65
  EXIT.USAGE,