@doubao-dev/plugin-cli 0.0.0-stage → 0.0.40-canary-dea0ddc73-20261026073950

package/README.md

@@ -1,3 +1,17 @@
-# Temporary Holding Version
+# @doubao-dev/plugin-cli
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+豆包应用插件 CLI 的公开版本，需要 Node.js >=22.13.0。
+
+```sh
+npm install -g @doubao-dev/plugin-cli
+dbx auth login
+dbx init my-plugin
+```
+
+默认创建空插件；添加 App 使用 `dbx init my-plugin --app`，调试使用 `dbx dev --app`。
+App 工具按需从 npm 下载 `@doubao-dev/plugin-app-dev` 和 `@doubao-dev/kit`。
+构建时从 npm 解析 Kit 的 `latest` 并锁定准确版本；发布流水线的 `kit_version` 或本地构建的 `DBX_BUILD_KIT_VERSION` 可指定 RC 版本。运行时 `DBX_KIT_VERSION` 可覆盖为准确版本；其余命令通过 `dbx --help` 查看，项目开发指引通过 `dbx skills` 同步。
+
+直接运行 `dbx init` 会交互询问项目名称和是否添加 App（默认不添加）；指定项目名时直接创建，使用 `--app` 添加 App。
+
+`dbx dev` 在含 App 的项目中交互选择调试目标，无 App 时直接启动 Skill / MCP 调试。`--plugin` 和 `--app` 显式指定目标且互斥。Agent 使用 `--no-tui` 禁用询问和交互面板，调试 App 时同时传 `--app`。

package/bin/run.js

@@ -0,0 +1,16 @@
+#!/usr/bin/env node
+
+import { stripVTControlCharacters } from 'node:util';
+import { log } from '@clack/prompts';
+
+import('../dist/main.js')
+  .then(({ main }) => main())
+  .catch((error) => {
+    const message = error instanceof Error ? error.message : String(error);
+    if (process.stdin.isTTY && process.stdout.isTTY) {
+      log.error(message);
+    } else {
+      process.stderr.write(`${stripVTControlCharacters(message)}\n`);
+    }
+    process.exitCode = 1;
+  });