@metagptx/deepflow-suite-cli 0.3.2 → 0.3.3
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/bundle/deepflow-release.json +6 -6
- package/bundle/skills/df-agentrt/SKILL.md +13 -17
- package/bundle/skills/df-agentrt-repo/SKILL.md +29 -60
- package/manifest.json +1 -1
- package/package.json +1 -1
- package/runtime/df-agentctrl/release.json +1 -1
- package/runtime/df-agentrt/release.json +1 -1
- package/runtime/df-task/release.json +1 -1
- package/runtime/df-taskdriver/release.json +1 -1
- package/runtime/df-workbench/release.json +1 -1
|
@@ -2,13 +2,13 @@
|
|
|
2
2
|
"schemaVersion": 1,
|
|
3
3
|
"distribution": "deepflow-suite",
|
|
4
4
|
"package": "@metagptx/deepflow-suite-cli",
|
|
5
|
-
"version": "0.3.
|
|
5
|
+
"version": "0.3.3",
|
|
6
6
|
"platform": "any",
|
|
7
7
|
"arch": "any",
|
|
8
8
|
"cli": {
|
|
9
9
|
"name": "deepflow-suite",
|
|
10
10
|
"package": "@metagptx/deepflow-suite-cli",
|
|
11
|
-
"version": "0.3.
|
|
11
|
+
"version": "0.3.3",
|
|
12
12
|
"command": "deepflow-suite"
|
|
13
13
|
},
|
|
14
14
|
"skills": [
|
|
@@ -173,8 +173,8 @@
|
|
|
173
173
|
},
|
|
174
174
|
{
|
|
175
175
|
"path": "SKILL.md",
|
|
176
|
-
"size":
|
|
177
|
-
"sha256": "
|
|
176
|
+
"size": 12201,
|
|
177
|
+
"sha256": "6af6181c7094ca4217578c8d13938ecfd3df006dacdef6446c30b00fcd8ddfec"
|
|
178
178
|
}
|
|
179
179
|
]
|
|
180
180
|
},
|
|
@@ -184,8 +184,8 @@
|
|
|
184
184
|
"files": [
|
|
185
185
|
{
|
|
186
186
|
"path": "SKILL.md",
|
|
187
|
-
"size":
|
|
188
|
-
"sha256": "
|
|
187
|
+
"size": 3962,
|
|
188
|
+
"sha256": "1b8d4b372f04a78430b96c4a39661a83903c1aefc777a9da10600277497ec205"
|
|
189
189
|
}
|
|
190
190
|
]
|
|
191
191
|
}
|
|
@@ -12,22 +12,20 @@ CLI 由 `@metagptx/deepflow-suite-cli` 统一安装，本 Skill 不携带 CLI
|
|
|
12
12
|
你运行在 **DeepFlow Agent Runtime** 上。这是一个把「会话 + 多轮消息 + 代码仓库」
|
|
13
13
|
管起来的服务，你现在执行的是其中一轮。
|
|
14
14
|
|
|
15
|
-
##
|
|
15
|
+
## 执行环境与工具范围
|
|
16
16
|
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
**这里一个都没有。**
|
|
20
|
-
|
|
21
|
-
简报里那份 `multica` 命令手册，只有一条在本环境真实可用：
|
|
17
|
+
执行引擎的自动简报按完整 multica 产品生成，其中的 issue、chat channel、squad、
|
|
18
|
+
附件、workspace、project 等操作不适用于本 Runtime。当前 `multica` shim 只支持：
|
|
22
19
|
|
|
23
20
|
```bash
|
|
24
21
|
multica repo checkout <URL>
|
|
25
22
|
```
|
|
26
23
|
|
|
27
|
-
|
|
28
|
-
|
|
24
|
+
这限定的是 `multica` 子命令，不限制普通 Git、shell 或其他已提供的工具。
|
|
25
|
+
简报中的“先用 checkout 获取代码”不是唯一入口要求；已授权仓库可通过普通 Git
|
|
26
|
+
取得或复用工作副本，也可使用托管检出，不设固定的工具调用顺序。
|
|
29
27
|
|
|
30
|
-
|
|
28
|
+
Runtime 镜像通过标准 PATH 提供 `df-task`、`df-agentctrl`、`df-agentrt` 和 `multica` shim，普通 shell 与登录 shell 均应可直接调用。命令缺失或 `--help` 失败表示对应能力存在执行环境缺口；不在 Run 中安装、编译 CLI 或猜绝对路径反复尝试。保留具体失败与可用能力，是否阻塞当前目标由执行者结合执行定义和任务判断，不能把某个可替代工具不可用直接当作整个任务无法继续。
|
|
31
29
|
|
|
32
30
|
Skill 内容通过 provider 的原生目录交付，以当前会话的 Skill 目录清单为准。清单中的 `r0` 等是根目录别名，打开前先展开，不能拼成 `skills/r0/...`。Codex 的 Runtime Skills 在 `$CODEX_HOME/skills/<slug>/SKILL.md`；Claude 在任务工作目录的 `.claude/skills/<slug>/SKILL.md`。支持文件相对该 Skill 目录读取。`$DEEPFLOW_WORKDIR` 表示任务工作目录，不是通用 Skill 根目录。
|
|
33
31
|
|
|
@@ -64,11 +62,11 @@ Run 中 `df-agentrt` 只使用部署注入的 `MULTICA_SERVER_URL`，忽略 `AGE
|
|
|
64
62
|
|
|
65
63
|
文件仍依赖所属 Worker 工作目录，不是归档或永久可用承诺；未发布或仍在生成的文件不能宣称已交付。
|
|
66
64
|
|
|
67
|
-
##
|
|
65
|
+
## 工作目录与工作副本
|
|
68
66
|
|
|
69
67
|
- 同一个会话的多轮**复用同一个工作目录**，上一轮留下的文件这一轮还在。
|
|
70
|
-
- `repo add` / `repo checkout`
|
|
71
|
-
-
|
|
68
|
+
- 托管 `repo add` / `repo checkout` 检出的仓库位于任务工作目录的同级；用命令返回的绝对路径访问，不猜目录名。这不是所有 Git 工作副本的目录规则。
|
|
69
|
+
- 普通 Git 获取的工作副本放在本 Session 拥有的工作区内；保留已有改动、提交和分支，不把 daemon 缓存或其他 Session 的目录当作自己的工作副本。需要通过文件通道交付的普通文件应位于可读取的任务工作目录内，代码交付使用远端固定引用。
|
|
72
70
|
|
|
73
71
|
## release 之后工作目录的生命周期
|
|
74
72
|
|
|
@@ -160,10 +158,8 @@ release 会停止会话接收新轮次并改变生命周期状态（当前不会
|
|
|
160
158
|
| 0 | 成功 | —— |
|
|
161
159
|
| 1 | 请求发出去了，但失败了 | 看 stderr，它写清了原因 |
|
|
162
160
|
| 2 | 命令行写错了，一个请求都没发 | 改命令 |
|
|
163
|
-
| 3 |
|
|
161
|
+
| 3 | 对应命令所需环境/部署不满足 | 报告具体缺口；不靠改参数反复执行同一命令，不据此推断其他授权方式也不可用 |
|
|
164
162
|
|
|
165
|
-
##
|
|
163
|
+
## 仓库发现与托管检出
|
|
166
164
|
|
|
167
|
-
|
|
168
|
-
见 `df-agentrt-repo` skill。一句话版本：**不要自己拼 `multica repo checkout` 去检出刚加的
|
|
169
|
-
仓库**，daemon 的白名单按 URL 逐字符匹配，你手敲的那个字符串未必是服务端存下来的那个。
|
|
165
|
+
需要按应用名发现仓库、查询或追加 Session 仓库配置、使用托管检出时，见 `df-agentrt-repo`。该能力不是普通 Git 操作的前置条件。
|
|
@@ -1,91 +1,60 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: df-agentrt-repo
|
|
3
|
-
description:
|
|
3
|
+
description: 在 Runtime 会话中查询已配置仓库、按应用名发现仓库，或追加仓库配置并托管检出时使用。
|
|
4
4
|
---
|
|
5
5
|
|
|
6
|
-
#
|
|
6
|
+
# Runtime 仓库发现与托管检出
|
|
7
7
|
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
CLI 由 `@metagptx/deepflow-suite-cli` 统一安装，本 Skill 不携带 CLI 实现。使用前应已完成 Suite 安装；缺少命令或版本不匹配时，用 `deepflow-suite doctor --json` 核对。Run 内缺少工具属于执行环境异常，不临时安装或编译。
|
|
11
|
-
|
|
12
|
-
会话创建时定下的配置里，只有**代码仓库**这一项是可以在任务进行中追加的。
|
|
8
|
+
本 Skill 说明 Runtime 的仓库登记与托管检出能力。已知授权仓库及所需 ref 时，也可通过普通 Git 获取或复用工作副本，不要求先查询、登记或托管检出。按当前任务需要选择能力，不设固定调用顺序。
|
|
13
9
|
|
|
14
|
-
|
|
15
|
-
等人重建会话，用 `df-agentrt` 自己把仓库加进来，一个回合内就能继续。
|
|
10
|
+
仓库列表、应用搜索结果和登记成功都不增加任务授权；只操作任务范围内的相关仓库。工作目录与复用边界见 `df-agentrt`，Git 认证、提交和 MR 操作见已加载的 Git 能力。
|
|
16
11
|
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
## 已经有哪些仓库
|
|
20
|
-
|
|
21
|
-
```bash
|
|
22
|
-
df-agentrt repo list
|
|
23
|
-
```
|
|
24
|
-
|
|
25
|
-
每行一个仓库：URL、`@分支`（如果固定了分支）、括号里是说明。
|
|
26
|
-
**先跑这个**——需要的仓库很可能已经在列表里，那就只差一个检出：
|
|
27
|
-
|
|
28
|
-
```bash
|
|
29
|
-
multica repo checkout <上面列出的 URL>
|
|
30
|
-
```
|
|
12
|
+
## CLI 依赖
|
|
31
13
|
|
|
32
|
-
|
|
14
|
+
CLI 由 `@metagptx/deepflow-suite-cli` 统一安装，本 Skill 不携带 CLI 实现。缺少命令或版本不匹配时，用 `deepflow-suite doctor --json` 核对。Run 内不临时安装或编译 CLI。
|
|
33
15
|
|
|
34
|
-
|
|
16
|
+
## 按需查询与发现
|
|
35
17
|
|
|
36
|
-
|
|
37
|
-
df-agentrt repo search 结算服务
|
|
38
|
-
```
|
|
18
|
+
`df-agentrt repo list` 查询本 Session 已配置的仓库。每行包含 URL、`@ref`（若已指定）和说明；列表不证明工作副本已存在或远端已刷新。
|
|
39
19
|
|
|
40
|
-
|
|
20
|
+
知道应用名、不知道仓库地址时，可用 `df-agentrt repo search <应用名>`。输出为应用代码、应用名和仓库地址，以 Tab 分隔。搜索无结果只表示此次未匹配到应用；可调整关键词，已有准确地址时无需搜索。
|
|
41
21
|
|
|
42
|
-
|
|
22
|
+
## 登记与托管检出
|
|
43
23
|
|
|
44
|
-
|
|
24
|
+
向本 Session 追加仓库并检出：
|
|
45
25
|
|
|
46
26
|
```bash
|
|
47
27
|
df-agentrt repo add <应用代码或 clone 地址> [...]
|
|
48
28
|
```
|
|
49
29
|
|
|
50
|
-
|
|
51
|
-
|
|
52
|
-
要固定分支：
|
|
30
|
+
参数含 `://` 或 `@` 时按 clone 地址处理，其余按应用代码查询。`--ref` 仅支持单个 clone 地址，可指定任务所需的分支、tag 或提交：
|
|
53
31
|
|
|
54
32
|
```bash
|
|
55
33
|
df-agentrt repo add https://git.example.com/g/settle --ref release/2026-09
|
|
56
34
|
```
|
|
57
35
|
|
|
58
|
-
|
|
59
|
-
真要这么做就分成几条命令。
|
|
60
|
-
|
|
61
|
-
**这条命令会把仓库检出，不需要再跑别的。** stdout 上每行是一个检出目录的绝对路径，
|
|
62
|
-
直接拿去读文件。
|
|
36
|
+
对已配置的仓库单独执行托管检出时，使用配置中的 URL，并保留所需 ref：
|
|
63
37
|
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
|
|
67
|
-
**逐字符**匹配，你手敲的地址少一个 `.git`、多一个尾斜杠，就是另一个仓库，
|
|
68
|
-
会得到「repo is not configured」——而 `repo list` 里明明有它。`repo add` 用的是服务端存下来的
|
|
69
|
-
那个字符串，所以它检出得了，你重新敲一遍的不一定。
|
|
70
|
-
|
|
71
|
-
**仓库只能加不能删。** 当前回合可能正在某个仓库里工作，删掉就把这个回合弄坏了。
|
|
72
|
-
|
|
73
|
-
**重复添加是安全的。** 已经有了就不会重复加，但仍然会做一次检出——
|
|
74
|
-
「在列表里」和「在磁盘上」是两回事。
|
|
38
|
+
```bash
|
|
39
|
+
multica repo checkout <已配置的URL> [--ref <所需ref>]
|
|
40
|
+
```
|
|
75
41
|
|
|
76
|
-
|
|
42
|
+
成功时使用工具返回的工作副本绝对路径。缓存命中或检出成功都不能证明最新远端 ref 已刷新，仍需核对所需版本与实际起始 SHA。
|
|
77
43
|
|
|
78
|
-
|
|
44
|
+
### 操作语义
|
|
79
45
|
|
|
80
|
-
-
|
|
81
|
-
-
|
|
82
|
-
-
|
|
46
|
+
- `repo add` 包含登记和检出两个动作。登记已成功但检出失败时，配置仍然保留，不能把整体失败当作登记回滚。
|
|
47
|
+
- 重复添加不重复登记，但仍会执行检出，不是无副作用的查询或重试。已有工作副本时先核对实际目录与改动，不为切换传输方式重新检出。
|
|
48
|
+
- 托管检出按已保存的 URL 精确匹配。使用 `repo list` 或登记结果中的原始 URL；手工改变 `.git`、尾斜杠或 SSH/HTTPS 可能不匹配。`repo add` 已完成检出时，无需再调用 checkout。
|
|
49
|
+
- Session 仓库配置只支持追加，不提供移除接口；这描述的是配置能力，不是所有本地文件操作的规则。
|
|
83
50
|
|
|
84
|
-
|
|
51
|
+
## 失败含义
|
|
85
52
|
|
|
86
|
-
|
|
53
|
+
根据失败发生的位置解释结果，不把某条命令失败直接当作仓库或整个任务不可用：
|
|
87
54
|
|
|
88
|
-
|
|
55
|
+
- `retrying will not help` 表示该命令缺少所需执行环境；换参数不会修复该缺口，不代表普通 Git 或其他已有能力也不可用。
|
|
56
|
+
- `remain configured` 表示登记保留、检出未成功；按实际错误判断是否适合重试，不能无条件再次检出已有工作副本。
|
|
57
|
+
- Runtime 仓库配置刷新或查询超时，不证明 GitLab 不可达、仓库不存在、凭据缺失或缓存未命中。已知授权仓库和所需 ref 时，普通 Git 不依赖这条托管检出链路。
|
|
58
|
+
- SSH 主机校验或公钥认证失败，表示对应 SSH 连接未成功；Token 与 SSH 私钥是不同凭据，传输方式和凭据绑定按 Git 能力说明处理。
|
|
89
59
|
|
|
90
|
-
|
|
91
|
-
不要猜目录名——仓库目录名来自 URL 最后一段，不一定等于应用名。
|
|
60
|
+
保留具体失败操作、已完成动作、实际目录及未确认项。是否采用其他授权方法、续办或请求人工协助，由执行者结合任务与执行定义判断；不通过扩大仓库范围、切换账号或访问其他 Session 的工作副本绕过限制。
|
package/manifest.json
CHANGED
package/package.json
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":"0.3.
|
|
1
|
+
{"version":"0.3.3","project":"deepflow-agent-ctrl","sourceCommit":"dee1a88615b09bd979562902cebc631f81b1859b","sourceDirty":false}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":"0.3.
|
|
1
|
+
{"version":"0.3.3","project":"deepflow-agent-runtime","sourceCommit":"592af8311ec783961a98e47377340121b78f2a68","sourceDirty":false}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":"0.3.
|
|
1
|
+
{"version":"0.3.3","project":"deepflow-task","sourceCommit":"cc53e86834b19e8a4fe73f9e9a08d76853d51e51","sourceDirty":false}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":"0.3.
|
|
1
|
+
{"version":"0.3.3","project":"deepflow-task-driver","sourceCommit":"c05efdc13dfd0d7a9043007f7421dbd1ac6daab2","sourceDirty":false}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":"0.3.
|
|
1
|
+
{"version":"0.3.3","project":"deepflow-workbench","sourceCommit":"adfb558b1c3532b338b5a8b0d5c11a43739e4ca6","sourceDirty":false}
|