@doubao-dev/cli 0.0.32 → 0.0.33

package/skills/doubao-agentic-service-development/references/overview.md

@@ -194,12 +194,11 @@ Agent 可以自主编排流程，不再通过状态机脚本获取下一步。
 `workspace.py` 只管理本地工作文件路径，不调用平台接口。涉及 manifest、skill、前端目录时，必须先调用脚本获取路径，再按返回值读写或传给 `dbx` 命令。
 
 ```bash
-python3 <skill_dir>/scripts/workspace.py config-status --json
+python3 <skill_dir>/scripts/workspace.py project-status --json
 python3 <skill_dir>/scripts/workspace.py app-id --json
 python3 <skill_dir>/scripts/workspace.py app-id set --value <app_id> --json
 python3 <skill_dir>/scripts/platform_info.py dashboard --json
 python3 <skill_dir>/scripts/workspace.py frontend path --json
-python3 <skill_dir>/scripts/workspace.py workspace ensure --json
 python3 <skill_dir>/scripts/workspace.py manifest path --create --json
 python3 <skill_dir>/scripts/workspace.py skill path --create --json
 python3 <skill_dir>/scripts/workspace.py artifacts check --json
@@ -239,7 +238,7 @@ python3 <skill_dir>/scripts/workspace.py artifacts check --json
    dbx dev --mcp-endpoint <mcp_endpoint>
    ```
 
-   命令默认读取 `<project>/manifest.yaml`，并递归加载 `<project>/skill/` 下的所有 `SKILL.md`；传入 `--skill <目录>` 时改为遍历指定目录。同时按项目布局和 `.dbx/config.json` 解析前端目录。`<mcp_endpoint>` 使用步骤 3 确认的 Streamable HTTP `/mcp` 地址。纯前端改动只刷新模拟器，不要重启 `dbx dev`。
+   命令默认读取 `<project>/manifest.yaml`，并递归加载 `<project>/skill/` 下的所有 `SKILL.md`；传入 `--skill <目录>` 时改为遍历指定目录。同时按项目布局（兼容旧 `.dbx/config.json`）解析前端目录。`<mcp_endpoint>` 使用步骤 3 确认的 Streamable HTTP `/mcp` 地址。纯前端改动只刷新模拟器，不要重启 `dbx dev`。
 
 5. 只有默认路径不符合项目结构时，才调用 workspace 脚本获取调试路径：
 
@@ -258,7 +257,7 @@ python3 <skill_dir>/scripts/workspace.py artifacts check --json
      --skill <runtime_skill_dir>
    ```
 
-   当前目录是整个 dbx 项目根目录，也是写入 `.dbx/localdebug` 状态、默认 Manifest、Skills 和前端目录的目录。`workspace.py skill path --json` 返回的 `path` 是 Skill 目录；`dbx dev --skill` 只能传这个目录或另一 Skill 目录，不能传 `skill_md` 文件路径。
+   当前目录是整个 dbx 项目根目录，也是写入 `node_modules/.doubao-dev/dev/` 状态、默认 Manifest、Skills 和前端目录的目录。`workspace.py skill path --json` 返回的 `path` 是 Skill 目录；`dbx dev --skill` 只能传这个目录或另一 Skill 目录，不能传 `skill_md` 文件路径。
 
 6. `dbx dev` 已运行后，前端 Page / Widget / 样式改动只刷新 Web 模拟器或点“刷新资源并重载卡片”；不要重启工程。
 7. 完成验证后，退出 `dbx dev` 控制台或按 Ctrl-C。
@@ -380,7 +379,7 @@ MCP 阶段不强制要求一定已经有公网 URL。已有合规代码但没有
 
 ### 关键原则
 
-前端源码不放在 `.dbx/workspace` 下。`.dbx/workspace` 只保存打包产物和中间工作文件。
+前端源码保留在项目根目录；打包临时文件由上传命令管理。
 
 本阶段不打包前端源码快照。前端必须将非敏感运行时配置集中在 `src/config/runtime.ts`（或脚本返回的等价路径）：`appId` 和 `apiBaseUrl` 是必需字段。`src/app.config.ts` 从该模块读取 `appId`，所有普通 HTTP 请求通过统一 client 使用 `apiBaseUrl`。不要在 Page/Widget 中硬编码 AppID 或服务端 URL；AppSecret 绝不属于前端配置。
 
@@ -391,8 +390,8 @@ MCP 阶段不强制要求一定已经有公网 URL。已有合规代码但没有
 ### 执行方式
 
 1. 确认前端目录。
-   - 优先读取 `.dbx/config.json` 中 `frontend.directory`。
-   - 若配置缺失，再根据项目结构判断，常见目录为项目根目录下的 `doubao-agentic-service`。
+   - 兼容读取旧 `.dbx/config.json` 中 `frontend.directory`。
+   - 若配置缺失，再根据项目结构判断，新项目使用根目录，旧项目按脚本返回的路径处理。
 
 2. 根据用户需求开发前端。
    - 补齐页面、组件、路由、状态管理、接口调用、空态、错误态和基础样式。
@@ -407,39 +406,25 @@ MCP 阶段不强制要求一定已经有公网 URL。已有合规代码但没有
 
 - 前端目录存在，并包含本轮需求所需页面、组件和交互。
 - 本轮可运行的项目校验已通过，或已说明项目没有可用校验命令。
-- 不要求 `.dbx/workspace/doubao-agentic-service.zip` 存在；前端源码包由 `build` 阶段的 upload 命令临时生成并清理。
+- 前端源码包由 `build` 阶段的 upload 命令临时生成并清理。
 
 ## setup
 
 ### 目标
 
-确认当前项目基础结构完整，恢复本地开发状态，获得本地 workspace 路径。
-
-### 关键原则
-
-Agent 只检查初始化产物是否存在，不负责创建或补齐这些产物。关键产物缺失时停止当前开发流程，提示用户先完成项目初始化。
+确认 Manifest、运行态 Skill 和前端工程是否完整。
 
 ### 检查项
 
-1. 检查 `.dbx/config.json` 是否存在：
-
-   ```bash
-   python3 <skill_dir>/scripts/workspace.py config-status --json
-   ```
-
-   如果 `config_exists=false`，停止当前流程并提示用户先完成项目初始化。不要继续创建 workspace。
-
-2. 确认 `.dbx/config.json` 存在后，获取本地 workspace 目录：
-
-   ```bash
-   python3 <skill_dir>/scripts/workspace.py workspace ensure --json
-   ```
-
-3. 检查基础产物：
-   - `.dbx/config.json` 存在。
-   - 项目中存在前端脚手架目录；优先读取 `.dbx/config.json` 中的 `frontend.directory` 配置，其次再按项目结构判断。
+```bash
+python3 <skill_dir>/scripts/workspace.py project-status --json
+python3 <skill_dir>/scripts/workspace.py frontend path --json
+python3 <skill_dir>/scripts/workspace.py artifacts check --json
+```
 
-如果关键产物缺失，不要自行补一个平行结构；提示用户先完成或修复项目初始化。
+新项目以 `manifest.yaml` 标记项目根目录，不要求 `.dbx/config.json` 存在。
+旧配置中的 `frontend.directory` 仍可读取，但工具不会再写入旧配置。
+如果 Manifest、运行态 Skill 或前端工程缺失，提示用户先完成或修复项目初始化，不创建平行结构。
 
 ## template-widget
 

package/skills/doubao-agentic-service-development/scripts/workspace.py

@@ -4,7 +4,6 @@ import argparse
 import json
 import os
 import re
-import shutil
 import stat
 from pathlib import Path
 from typing import Any, Dict, List, Optional, Tuple
@@ -13,7 +12,7 @@ from typing import Any, Dict, List, Optional, Tuple
 def find_project_root(start_dir: Path) -> Path:
     current = start_dir.resolve()
     while True:
-        if (current / ".dbx").exists() or (current / ".git").exists():
+        if (current / "manifest.yaml").is_file() or (current / ".dbx" / "config.json").is_file():
             return current
         if current.parent == current:
             return start_dir.resolve()
@@ -24,10 +23,6 @@ def config_path(project_root: Path) -> Path:
     return project_root / ".dbx" / "config.json"
 
 
-def workspace_dir(project_root: Path) -> Path:
-    return project_root / ".dbx" / "workspace"
-
-
 def manifest_path(project_root: Path) -> Path:
     return project_root / "manifest.yaml"
 
@@ -145,10 +140,6 @@ def is_root_layout(project_root: Path) -> bool:
     return not (project_root / "miniapp").is_dir()
 
 
-def archive_dir(project_root: Path) -> Path:
-    return project_root / ".dbx" / "archive"
-
-
 def workspace_required_files(project_root: Path) -> Dict[str, Tuple[Path, str]]:
     frontend_dir = frontend_directory_from_config(project_root, read_config(config_path(project_root)))
     app_config = frontend_app_config_path(frontend_dir)
@@ -181,7 +172,6 @@ def check_workspace_artifacts(
     }
     missing = [name for name, exists in present.items() if not exists]
     return {
-        "workspace_dir": str(workspace_dir(project_root)),
         "required": {name: str(path) for name, (path, _kind) in files.items()},
         "present": present,
         "missing": missing,
@@ -302,16 +292,11 @@ def build_parser() -> argparse.ArgumentParser:
     output_parent = argparse.ArgumentParser(add_help=False)
     output_parent.add_argument("--json", action="store_true", help="Print structured JSON.")
 
-    subparsers.add_parser("config-status", parents=[output_parent])
+    subparsers.add_parser("project-status", parents=[output_parent])
     app_id_parser = subparsers.add_parser("app-id", parents=[output_parent])
     app_id_parser.add_argument("app_id_command", nargs="?", choices=["get", "set"], default="get")
     app_id_parser.add_argument("--value", help="AppID to write into the resolved Manifest when using `set`.")
 
-    workspace_parser = subparsers.add_parser("workspace")
-    workspace_sub = workspace_parser.add_subparsers(dest="workspace_command", required=True)
-    workspace_sub.add_parser("path", parents=[output_parent])
-    workspace_sub.add_parser("ensure", parents=[output_parent])
-
     frontend_parser = subparsers.add_parser("frontend")
     frontend_sub = frontend_parser.add_subparsers(dest="frontend_command", required=True)
     frontend_sub.add_parser("path", parents=[output_parent])
@@ -326,15 +311,6 @@ def build_parser() -> argparse.ArgumentParser:
     skill_path = skill_sub.add_parser("path", parents=[output_parent])
     skill_path.add_argument("--create", action="store_true")
 
-    file_parser = subparsers.add_parser("file")
-    file_sub = file_parser.add_subparsers(dest="file_command", required=True)
-    file_path = file_sub.add_parser("path", parents=[output_parent])
-    file_path.add_argument("--name", required=True)
-    file_path.add_argument("--create", action="store_true")
-
-    archive_parser = subparsers.add_parser("archive", parents=[output_parent])
-    archive_parser.add_argument("--version-tag", required=True)
-
     artifacts_parser = subparsers.add_parser("artifacts")
     artifacts_sub = artifacts_parser.add_subparsers(dest="artifacts_command", required=True)
     artifacts_check = artifacts_sub.add_parser("check", parents=[output_parent])
@@ -347,15 +323,13 @@ def build_parser() -> argparse.ArgumentParser:
 def main() -> None:
     args = build_parser().parse_args()
     project_root = find_project_root(Path(args.project))
-    cfg_path = config_path(project_root)
-    ws_dir = workspace_dir(project_root)
 
-    if args.command == "config-status":
+    if args.command == "project-status":
         emit(
             {
                 "project_root": str(project_root),
-                "config_path": str(cfg_path),
-                "config_exists": cfg_path.exists(),
+                "manifest_path": str(manifest_path(project_root)),
+                "manifest_exists": manifest_path(project_root).is_file(),
             },
             args.json,
         )
@@ -390,22 +364,8 @@ def main() -> None:
         )
         return
 
-    if args.command == "workspace":
-        if args.workspace_command == "ensure":
-            ws_dir.mkdir(parents=True, exist_ok=True)
-        emit(
-            {
-                "project_root": str(project_root),
-                "workspace_dir": str(ws_dir),
-                "workspace_rel": rel(project_root, ws_dir),
-                "exists": ws_dir.exists(),
-            },
-            args.json,
-        )
-        return
-
     if args.command == "frontend":
-        frontend_dir = frontend_directory_from_config(project_root, read_config(cfg_path))
+        frontend_dir = frontend_directory_from_config(project_root, read_config(config_path(project_root)))
         if args.frontend_command == "path":
             app_config = frontend_app_config_path(frontend_dir)
             candidates = frontend_app_config_candidates(frontend_dir)
@@ -477,49 +437,6 @@ def main() -> None:
         )
         return
 
-    if args.command == "file":
-        safe_name = Path(args.name)
-        if safe_name.is_absolute() or ".." in safe_name.parts:
-            raise ValueError("--name must be a relative path inside .dbx/workspace")
-        target = ws_dir / safe_name
-        if args.create:
-            target.parent.mkdir(parents=True, exist_ok=True)
-            target.touch(exist_ok=True)
-        emit(
-            {
-                "project_root": str(project_root),
-                "path": str(target),
-                "rel": rel(project_root, target),
-                "exists": target.exists(),
-            },
-            args.json,
-        )
-        return
-
-    if args.command == "archive":
-        if not ws_dir.exists():
-            emit({"project_root": str(project_root), "archived": [], "workspace_exists": False}, args.json)
-            return
-        target_dir = archive_dir(project_root) / args.version_tag
-        target_dir.mkdir(parents=True, exist_ok=True)
-        moved = []
-        for item in sorted(ws_dir.iterdir()):
-            dest = target_dir / item.name
-            if dest.exists():
-                raise FileExistsError(f"archive target already exists: {dest}")
-            shutil.move(str(item), str(dest))
-            moved.append(rel(project_root, dest))
-        emit(
-            {
-                "project_root": str(project_root),
-                "archive_dir": str(target_dir),
-                "archive_rel": rel(project_root, target_dir),
-                "archived": moved,
-            },
-            args.json,
-        )
-        return
-
     if args.command == "artifacts":
         if args.artifacts_command == "check":
             selected_skill_dir = None

package/dist/180.js

@@ -1 +0,0 @@
-import t,{createRequire as e}from"node:module";let r=t.createRequire(import.meta.url);import{__webpack_require__ as o}from"./rslib-runtime.js";let p=e(import.meta.url);o.add({bufferutil(t){t.exports=r("bufferutil")},"utf-8-validate"(t){t.exports=r("utf-8-validate")},buffer(t){t.exports=p("buffer")},crypto(t){t.exports=p("crypto")},events(t){t.exports=p("events")},http(t){t.exports=p("http")},https(t){t.exports=p("https")},net(t){t.exports=p("net")},stream(t){t.exports=p("stream")},tls(t){t.exports=p("tls")},url(t){t.exports=p("url")},util(t){t.exports=p("util")},zlib(t){t.exports=p("zlib")}});