@lingjingai/scriptctl 0.53.5 → 0.53.6

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.
@@ -0,0 +1,13 @@
1
+ # 0.53.6
2
+
3
+ ## Added
4
+ - None.
5
+
6
+ ## Changed
7
+ - The bundled `scriptctl` skill uses default text/TSV output for direct agent reads and reserves `-j` JSON output for scripts and other programmatic consumers.
8
+
9
+ ## Fixed
10
+ - None.
11
+
12
+ ## Breaking
13
+ - None.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@lingjingai/scriptctl",
3
- "version": "0.53.5",
3
+ "version": "0.53.6",
4
4
  "description": "剧本阶段统一 CLI:素材转 Script v4,并兼容 Script v3 的本地写作、精修、校验和发布。",
5
5
  "type": "module",
6
6
  "bin": {
@@ -2,8 +2,8 @@
2
2
  name: scriptctl
3
3
  description: "剧本 script.json 的本地查询、文件化批量写作、原子精修、素材 ingest 与 revision publish CLI。处理 Script v3/v4、两个 script.json、剧本资产/state、Action、场景引用或 authoring 时使用。"
4
4
  metadata:
5
- version: "0.27.9"
6
- scriptctl_version: "0.53.5"
5
+ version: "0.27.10"
6
+ scriptctl_version: "0.53.6"
7
7
  author: "official"
8
8
  ---
9
9
 
@@ -12,9 +12,15 @@ metadata:
12
12
  `scriptctl` 始终对 `-p` 指向的本地 `script.json` 工作。远端剧本先
13
13
  `checkout`,完成本地查询、修改和 `validate` 后再 `publish`。
14
14
 
15
- 实际调用和示例优先使用短参数:`-p/-w/-s/-o/-i/-g/-t/-a/-k/-n/-j/-h/-v`。
15
+ 实际调用和示例优先使用短参数:`-p/-w/-s/-o/-i/-g/-t/-a/-k/-n/-h/-v`。
16
16
  没有短名的参数保持完整长写。
17
17
 
18
+ ## 输出模式
19
+
20
+ Agent 直接运行命令并阅读结果属于正常使用,使用默认文本输出;查询表格默认为 TSV。
21
+ 定位、查看正文、核对时间范围、读回修改和运行校验都使用默认输出。只有命令 stdout
22
+ 将由脚本、程序、测试或前端按字段消费时,才使用 `-j` JSON 输出。
23
+
18
24
  ## 先识别版本
19
25
 
20
26
  读取 `script.json.version`:
@@ -55,7 +61,7 @@ metadata:
55
61
 
56
62
  ## 查询与定位
57
63
 
58
- 默认文本查询输出 TSV。需要结构化数据时使用 `-j`:顶层固定包含
64
+ 默认文本查询输出 TSV。脚本消费查询结果时使用 `-j`:顶层固定包含
59
65
  `ok`、`exit_code`,表格数据位于 `rows`,列顺序位于 `row_columns`。地址流使用
60
66
  `--format addr`。写命令的 JSON 使用 `op`、`changed`、`plan_digest`、
61
67
  `validation`、`script_path` 等命令自身字段,不包含展示用的标题或结果区块。
@@ -116,7 +122,7 @@ scriptctl validate -p "$SCRIPT"
116
122
 
117
123
  ```bash
118
124
  scriptctl actions -i 'acR8cV4n..acT2fG6z' --span -p "$SCRIPT"
119
- scriptctl actions -i '@ep:3/scn:2' --span -j -p "$SCRIPT"
125
+ scriptctl actions -i '@ep:3/scn:2' --span -p "$SCRIPT"
120
126
  ```
121
127
 
122
128
  结果只含一行,并给出 `episode_id`、`ep_no`、`start_timestamp`、