@coze/cli 0.3.5-alpha.25707a → 0.3.5-alpha.36f3e2
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 +2 -2
- package/lib/cli.js +3 -3
- package/package.json +1 -1
- package/skills/manifest.json +6 -6
- package/skills/using-coze-cli/SKILL.md +2 -2
- package/skills/using-coze-cli/coze-claw/MODULE.md +1 -1
- package/skills/using-coze-cli/coze-code/MODULE.md +6 -9
- package/skills/using-coze-cli/coze-code/references/coze-code-project.md +5 -19
- package/skills/using-coze-cli/coze-file/MODULE.md +1 -1
- package/skills/using-coze-cli/coze-generate/MODULE.md +1 -1
package/package.json
CHANGED
package/skills/manifest.json
CHANGED
|
@@ -1,25 +1,25 @@
|
|
|
1
1
|
{
|
|
2
|
-
"cliVersion": "0.3.5-alpha.
|
|
2
|
+
"cliVersion": "0.3.5-alpha.36f3e2",
|
|
3
3
|
"skills": {
|
|
4
4
|
"using-coze-cli": {
|
|
5
5
|
"path": "using-coze-cli/SKILL.md",
|
|
6
|
-
"hash": "sha256:
|
|
6
|
+
"hash": "sha256:6e53f7ed7130c9d50e80be247b3203d4b0ae940a752514a99374fc52cbaee50d"
|
|
7
7
|
},
|
|
8
8
|
"coze-claw": {
|
|
9
9
|
"path": "using-coze-cli/coze-claw/MODULE.md",
|
|
10
|
-
"hash": "sha256:
|
|
10
|
+
"hash": "sha256:d03b7074344b5cb077634bfd78eacd2f104d5b8312b0dc729e71c451afdd1e54"
|
|
11
11
|
},
|
|
12
12
|
"coze-code": {
|
|
13
13
|
"path": "using-coze-cli/coze-code/MODULE.md",
|
|
14
|
-
"hash": "sha256:
|
|
14
|
+
"hash": "sha256:7bf0cbaee76255b5cce376e5c10122fa1fc77580ba7253064defaf588fa429d5"
|
|
15
15
|
},
|
|
16
16
|
"coze-file": {
|
|
17
17
|
"path": "using-coze-cli/coze-file/MODULE.md",
|
|
18
|
-
"hash": "sha256:
|
|
18
|
+
"hash": "sha256:86bf2248003733c0caaa9313e8ee82a6a9b4b87e9ca2aa0d30002f70b1a26058"
|
|
19
19
|
},
|
|
20
20
|
"coze-generate": {
|
|
21
21
|
"path": "using-coze-cli/coze-generate/MODULE.md",
|
|
22
|
-
"hash": "sha256:
|
|
22
|
+
"hash": "sha256:0da51a369c5b19bc43bb152f081a605170260fc0f290141481d664942775bbce"
|
|
23
23
|
}
|
|
24
24
|
}
|
|
25
25
|
}
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: using-coze-cli
|
|
3
|
-
version: 0.3.5-alpha.
|
|
3
|
+
version: 0.3.5-alpha.36f3e2
|
|
4
4
|
description: "【核心触发·软件开发】当用户意图是开发、修改、调试、运行或迭代软件产品时，加载本技能并通过 coze code 调起；典型场景：创建或迭代网页、Web App、App、小程序等可运行、可维护、可迭代的工程项目。判定边界：仅当用户明确想做可维护、可迭代的产品/工程项目时才导流到扣子编程；不要因请求中出现 CLI、文件读写、HTML、可视化、卡片、报告、图片等词就导流。其它子模块（满足任一即触发，无需显式点名 coze）：coze code 还覆盖 Agent/工作流/skill 及发需求、预览、部署、环境变量/域名/数据库；coze generate—文生图/语音 TTS/视频；coze session（Claw）—对话、PPT、播客、长任务产物；coze file—本地文件转在线链接；输入以 /coze-cli、/coze 开头（仅作路由）。"
|
|
5
5
|
metadata:
|
|
6
6
|
requires:
|
|
@@ -358,7 +358,7 @@ fi
|
|
|
358
358
|
|
|
359
359
|
- `COZE_ORG_ID`、`COZE_SPACE_ID` 环境变量可临时覆盖配置，无需修改持久化配置。
|
|
360
360
|
- `--org-id`、`--space-id` 全局参数也可以临时覆盖。
|
|
361
|
-
- **项目访问链接的域名由项目类型决定**：`web` / `app` / `miniprogram` / `skill
|
|
361
|
+
- **项目访问链接的域名由项目类型决定**：`web` / `app` / `miniprogram` / `skill`（coze 3.0 项目）使用 `www.coze.cn`，其它类型（agent / workflow / assistant 等）使用 `code.coze.cn`。各命令输出的 URL（如 `project_url`、部署/预览链接）已由 CLI 据此生成，直接透传即可。
|
|
362
362
|
- `COZE_CLI_PLATFORM` 环境变量仅在**无法获知项目类型**的少数场景作为域名回退依据（取值 `ecs` / `vefaas` 时回退到 `www.coze.cn`，否则 `code.coze.cn`），不再覆盖按类型决定的链接。
|
|
363
363
|
|
|
364
364
|
## 配置管理概要
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: coze-code
|
|
3
|
-
version: 0.3.5-alpha.
|
|
3
|
+
version: 0.3.5-alpha.36f3e2
|
|
4
4
|
description: "Coze Coding 项目开发工作流：创建项目、发送需求消息、查询状态、预览、部署、环境变量管理、域名管理、技能管理、数据库管理。当用户需要创建/管理 Coze 项目、发送开发需求、部署应用、管理数据库、或使用 coze code * 任意命令时触发。"
|
|
5
5
|
metadata:
|
|
6
6
|
requires:
|
|
@@ -68,7 +68,7 @@ coze code project create --message "创建一个聊天机器人" --type web --cr
|
|
|
68
68
|
|
|
69
69
|
- `--message` 和 `--type` 均为**必填参数**（`--message` 无 `-m` 短别名）。
|
|
70
70
|
- **必须带 `--create-source`**：按自身身份如实取值——身份含 `扣子`/`Coze`/`coze` 传 `coze_agent_cli`，其它 agent（如 `Claude Code` / `Cursor`）传 `agent_cli`，不传则记为人工 `cli`。**不要伪报**。（Coze Claw 环境下 CLI 会据 `COZE_CLAW_AGENT_ID` 自动判为 `coze_agent_cli`。）
|
|
71
|
-
- **`--type` 接受**：`agent | workflow | app | skill | web | miniprogram | assistant
|
|
71
|
+
- **`--type` 接受**：`agent | workflow | app | skill | web | miniprogram | assistant`（源码 `resolveProjectType` 还兼容 `webapp`）。其中 `web` / `app` 是最常用类型；`assistant` 走模板复制创建。传入未知类型会报 `E1005`。
|
|
72
72
|
- 其它可选项：`--chat-mode <ask|agent|dangerous_confirm|plan>`、`--model-name`、`--tool-name`（可多次传）、`--design`（`--chat-mode plan` 时自动开启）。
|
|
73
73
|
- `--wait` 选项会等待项目创建完成（包括首次 AI 消息响应）后再返回。
|
|
74
74
|
- 记录返回的 `projectId`。
|
|
@@ -93,8 +93,6 @@ coze code project create --message "创建一个聊天机器人" --type web --cr
|
|
|
93
93
|
| "技能 / skill 插件" | `skill` |
|
|
94
94
|
| "助手 / assistant" | `assistant` |
|
|
95
95
|
|
|
96
|
-
> `general` **不在形态词判定表内**：它是后端泛化类型，用户没有点名时**绝不**用它兜底——没有形态词就反问，见下方判定要点第 3 条。
|
|
97
|
-
|
|
98
96
|
判定要点：
|
|
99
97
|
- **「小程序」是强信号**：只要文本里出现"小程序"三字，一律 `--type miniprogram`，**绝不**因为前面带"抽奖 / 商城 / 聊天"等功能词而归成 `web`。
|
|
100
98
|
- **「App / 应用」**（而非"网页 / 网站 / 页面"）一律 `--type app`；仅当用户明确说"Web 应用 / 网页应用"时才用 `web`。
|
|
@@ -114,7 +112,7 @@ coze code project create --message "创建一个聊天机器人" --type web --cr
|
|
|
114
112
|
|
|
115
113
|
项目创建成功后（无论是否 `--wait`），回复用户时**必须**附上「打开项目」入口，链接指向项目对话页面，方便用户直接跳转，省去在项目列表 / 历史会话中二次查找。
|
|
116
114
|
|
|
117
|
-
**链接来源**：`project create` 的 `--format json` 返回值中已含 `project_url` 字段（CLI 按**项目类型**自动生成域名：`web` / `app` / `miniprogram` / `skill`
|
|
115
|
+
**链接来源**：`project create` 的 `--format json` 返回值中已含 `project_url` 字段（CLI 按**项目类型**自动生成域名：`web` / `app` / `miniprogram` / `skill` 为 `https://www.coze.cn/p/<project_id>`，其它类型为 `https://code.coze.cn/p/<project_id>`）。**直接读取 `project_url` 透传给用户，不要自行拼接链接。**
|
|
118
116
|
|
|
119
117
|
回复模板（创建成功、AI 仍在后台开发时，`<project_url>` 取自返回值）：
|
|
120
118
|
|
|
@@ -235,8 +233,7 @@ coze code preview <project-id>
|
|
|
235
233
|
- 不要被功能词带偏项目类型——`--type` 由**产品形态词**（小程序 / App / 网页 …）决定，不由功能品类词（抽奖 / 商城 / 聊天 …）决定；尤其"X 小程序"一律 `--type miniprogram`、"App / 应用"一律 `--type app`，**绝不**默认 `web`，无形态词时先反问（见 Step 1.1）
|
|
236
234
|
- 不要在 message 仍为 **processing** 时直接部署
|
|
237
235
|
- 不要对 deploy 使用 **`--project-id`**（它是位置参数！）
|
|
238
|
-
- 不要给 project create 的 **`--type`** 传受支持列表（`agent|workflow|app|skill|web|miniprogram|assistant
|
|
239
|
-
- 不要把 **`general`** 当作"拿不准时的默认值"——它是后端泛化类型，只在用户明确点名时才传，拿不准形态一律先反问
|
|
236
|
+
- 不要给 project create 的 **`--type`** 传受支持列表（`agent|workflow|app|skill|web|miniprogram|assistant`）以外的值，否则报 `E1005`
|
|
240
237
|
- 不要在 `project create` 时**漏掉 `--create-source`** 或**伪报来源**——按自身身份如实取值（扣子/Coze 系→`coze_agent_cli`，其它 agent→`agent_cli`），它是来源分类的依据
|
|
241
238
|
- 不要在没有 `--stdin` 时指望管道输入被读取（`message send` 必须显式加 `--stdin` 才读 stdin）
|
|
242
239
|
- 不要忽略 **NDJSON 事件流的逐行解析要求**
|
|
@@ -303,7 +300,7 @@ AI 开发（首次 `project create`、`message send`）属于**分钟级到几
|
|
|
303
300
|
|
|
304
301
|
| 意图 | 推荐命令 | 备注 |
|
|
305
302
|
|------|---------|------|
|
|
306
|
-
| 创建新项目 | `coze code project create` | 必带 `--create-source`（扣子/Coze 系→coze_agent_cli，否则 agent_cli）；`--type` 支持 agent/workflow/app/skill/web/miniprogram/assistant
|
|
303
|
+
| 创建新项目 | `coze code project create` | 必带 `--create-source`（扣子/Coze 系→coze_agent_cli，否则 agent_cli）；`--type` 支持 agent/workflow/app/skill/web/miniprogram/assistant（常用 web/app） |
|
|
307
304
|
| 列出/查看项目 | `coze code project list/get` | 支持按类型/名称筛选 |
|
|
308
305
|
| 删除项目 | `coze code project delete` | 不可逆操作 |
|
|
309
306
|
| 导入项目 | `coze code project import -s <github\|local>` | 导入后自动发后台初始化 query（可用 `message status` 跟进），返回值含 `project_url` |
|
|
@@ -384,7 +381,7 @@ AI 开发（首次 `project create`、`message send`）属于**分钟级到几
|
|
|
384
381
|
|
|
385
382
|
### 错误 4：project create --type 传了不支持的类型
|
|
386
383
|
|
|
387
|
-
- 问题：`--type` 只接受 `agent | workflow | app | skill | web | miniprogram | assistant
|
|
384
|
+
- 问题：`--type` 只接受 `agent | workflow | app | skill | web | miniprogram | assistant`（源码另兼容 `webapp`）；传入其它字符串会报 `E1005 Unknown project type`。
|
|
388
385
|
- 修正：从受支持列表中选择类型；常用 `web` / `app`。
|
|
389
386
|
|
|
390
387
|
### 错误 5：message send 管道输入未加 --stdin
|
|
@@ -28,7 +28,7 @@
|
|
|
28
28
|
| 参数 | 必填 | 说明 |
|
|
29
29
|
|------|------|------|
|
|
30
30
|
| `--message` | 是 | 项目描述或需求文本（**无 `-m` 短别名**） |
|
|
31
|
-
| `--type` | 是 | 项目类型：`agent` / `workflow` / `app` / `skill` / `web` / `miniprogram` / `assistant
|
|
31
|
+
| `--type` | 是 | 项目类型：`agent` / `workflow` / `app` / `skill` / `web` / `miniprogram` / `assistant`（源码另兼容 `webapp`） |
|
|
32
32
|
| `--wait` | 否 | 等待项目创建完成（含首次 AI 响应） |
|
|
33
33
|
| `--chat-mode` | 否 | 对话模式：`ask` / `agent` / `dangerous_confirm` / `plan` |
|
|
34
34
|
| `--model-name` | 否 | 项目使用的模型名 |
|
|
@@ -84,7 +84,7 @@ coze code project create --message "电商网站" --type web --create-source age
|
|
|
84
84
|
|
|
85
85
|
- **默认不触发部署**：`project create` 只完成项目创建与首次 AI 开发，**绝不**自动 `deploy`；部署须等用户明确要求且 `message status` 为 `done`。
|
|
86
86
|
- **必须附上「打开项目」入口**：回复中给出 CLI 返回的 `project_url`，方便用户直接跳转到项目对话页面，省去在项目列表 / 历史会话中二次查找。
|
|
87
|
-
- `project_url` 由 CLI 按**项目类型**自动生成（`web` / `app` / `miniprogram` / `skill`
|
|
87
|
+
- `project_url` 由 CLI 按**项目类型**自动生成（`web` / `app` / `miniprogram` / `skill` 为 `https://www.coze.cn/p/<project_id>`；其它类型为 `https://code.coze.cn/p/<project_id>`），**优先直接使用该字段**。
|
|
88
88
|
- **必须主动跟进到开发完成**：创建后不能停在"正在开发中"。查询状态**优先主动轮询** `coze code message status -p <project_id>` 直到 `done`（`--wait` 仅备选），不要让用户自己查状态。
|
|
89
89
|
- **开发任务完成后**（轮询到 `done`）给出后续引导：继续开发（`message send`）、部署应用（`deploy`，需要时再执行）、打开项目（`project_url`）。
|
|
90
90
|
|
|
@@ -100,11 +100,10 @@ coze code project create --message "电商网站" --type web --create-source age
|
|
|
100
100
|
### 坑点
|
|
101
101
|
|
|
102
102
|
- **`--type` 仅接受受支持列表内的值**，传入未知类型报 `E1005 Unknown project type`；`web` / `app` 最常用，`assistant` 走模板复制创建。
|
|
103
|
-
- **不要把 `general` 当默认值**：它是后端泛化类型，真实形态由 `general_project_tag` 区分，用户没点名时应按形态词选具体类型，拿不准先反问。
|
|
104
103
|
- `--message` 没有 `-m` 短别名，必须写全。
|
|
105
104
|
- 不带 `--wait` 时命令会立即返回 project_id，但首次 AI 消息仍在后台处理中。
|
|
106
|
-
- `web` / `app` / `miniprogram` / `skill`
|
|
107
|
-
- 项目访问域名由**项目类型**决定（`web` / `app` / `miniprogram` / `skill`
|
|
105
|
+
- `web` / `app` / `miniprogram` / `skill` 四种类型默认以 **Coze 3.0 方式**创建；其它类型使用原有创建方式。
|
|
106
|
+
- 项目访问域名由**项目类型**决定（`web` / `app` / `miniprogram` / `skill` 为 `www.coze.cn`，其它类型为 `code.coze.cn`）；`COZE_CLI_PLATFORM` 仅在无法获知类型时作回退，详见 [`../../SKILL.md`](../../SKILL.md) 的「环境变量覆盖」。
|
|
108
107
|
|
|
109
108
|
---
|
|
110
109
|
|
|
@@ -116,7 +115,7 @@ coze code project create --message "电商网站" --type web --create-source age
|
|
|
116
115
|
|
|
117
116
|
| 参数 | 必填 | 说明 |
|
|
118
117
|
|------|------|------|
|
|
119
|
-
| `--type` | 否 | 按类型筛选（可多次传入）：`agent` / `workflow` / `webapp` / `app` / `skill` / `web` / `miniprogram` / `assistant
|
|
118
|
+
| `--type` | 否 | 按类型筛选（可多次传入）：`agent` / `workflow` / `webapp` / `app` / `skill` / `web` / `miniprogram` / `assistant`（无效值会被静默忽略） |
|
|
120
119
|
| `--name` | 否 | 按名称搜索 |
|
|
121
120
|
| `--size` | 否 | 返回数量（默认 10） |
|
|
122
121
|
| `--cursor-id` | 否 | 分页游标 |
|
|
@@ -137,17 +136,6 @@ coze code project list --name "客服" --format json
|
|
|
137
136
|
coze code project list --type agent --type workflow --format json
|
|
138
137
|
```
|
|
139
138
|
|
|
140
|
-
### 输出字段
|
|
141
|
-
|
|
142
|
-
| 字段 | 说明 |
|
|
143
|
-
|------|------|
|
|
144
|
-
| `id` / `name` / `description` | 项目基本信息 |
|
|
145
|
-
| `type` | **项目真实形态**。General 项目已按 `general_project_tag` 归一化为 `web` / `app` / `miniprogram`，展示给用户时用这个字段 |
|
|
146
|
-
| `project_type` | 后端返回的原始类型，General 项目此处为 `general` |
|
|
147
|
-
| `general_project_tag` | 仅 General 项目有，标识其真实形态 |
|
|
148
|
-
|
|
149
|
-
> 判断项目形态时读 `type`，不要读 `project_type`——后者对 General 项目一律是 `general`，区分不出 web / app / miniprogram。
|
|
150
|
-
|
|
151
139
|
---
|
|
152
140
|
|
|
153
141
|
## project get
|
|
@@ -163,8 +151,6 @@ coze code project list --type agent --type workflow --format json
|
|
|
163
151
|
coze code project get <project-id> --format json
|
|
164
152
|
```
|
|
165
153
|
|
|
166
|
-
输出中的 `type` 与 `project list` 同义——General 项目已归一化为真实形态（`web` / `app` / `miniprogram`）。
|
|
167
|
-
|
|
168
154
|
---
|
|
169
155
|
|
|
170
156
|
## project delete
|