@lark-apaas/miaoda-cli 0.1.24-alpha.1425dbf → 0.1.24-alpha.22ed5b0
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 +5 -5
- package/dist/cli/commands/index.js +8 -5
- package/dist/cli/commands/registry/index.js +5 -3
- package/dist/cli/handlers/app/export.js +6 -0
- package/dist/cli/handlers/app/init.js +29 -17
- package/dist/services/app/init/index.js +2 -1
- package/dist/services/app/init/template.js +8 -1
- package/dist/services/registry/index.js +2 -1
- package/dist/utils/http.js +7 -1
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -46,16 +46,16 @@ miaoda file ls --output json
|
|
|
46
46
|
| `miaoda file ...` | 文件操作:上传、下载、元数据、签名下载、批量删除 |
|
|
47
47
|
| `miaoda db ...` | 数据操作:SQL 执行、表结构查询、数据导入导出 |
|
|
48
48
|
| `miaoda observability ...` | 线上日志、链路、前端源码堆栈反查、监控指标、运营指标 |
|
|
49
|
-
| `miaoda comment ...` |
|
|
50
|
-
| `miaoda registry ...` | 组件 registry:列出 / copy-in
|
|
49
|
+
| `miaoda comment ...` | 应用评论:查看评论列表、解决评论(仅 design-html 场景开放) |
|
|
50
|
+
| `miaoda registry ...` | 组件 registry:列出 / copy-in SDK 文件(本地执行) |
|
|
51
51
|
|
|
52
52
|
完整命令通过 `miaoda --help` 或 `miaoda <domain> --help` 查看。
|
|
53
53
|
|
|
54
|
-
## 组件 registry
|
|
54
|
+
## 组件 registry
|
|
55
55
|
|
|
56
|
-
`miaoda registry`
|
|
56
|
+
`miaoda registry` 提供 shadcn 式的「组件 registry」:把 SDK 文件**拷进**当前项目(copy-in),而非作为依赖安装。registry 是独立 npm 包,按运行时分发(design-html / html → buildless runtime → `@lark-apaas/coding-registry-buildless`)。
|
|
57
57
|
|
|
58
|
-
前置:当前目录(或 `--dir`)已走过 `miaoda app init
|
|
58
|
+
前置:当前目录(或 `--dir`)已走过 `miaoda app init`,且 `.spark/meta.json` 的 `stack` 有对应 registry 包(当前支持 `design-html` / `html`);其余 stack 执行时报 `REGISTRY_STACK_UNSUPPORTED` 并提示支持列表。
|
|
59
59
|
|
|
60
60
|
```bash
|
|
61
61
|
# 列出可用 SDK 条目(输出各文件 USAGE 注释块原文,便于 Agent 直接读用法)
|
|
@@ -31,6 +31,9 @@ function resolveScene(appType, _archType) {
|
|
|
31
31
|
return 'design-html';
|
|
32
32
|
return 'default';
|
|
33
33
|
}
|
|
34
|
+
// registry(shadcn 式 copy-in SDK)挂在全部 scene:scene 路由不感知 registry 的可用性,
|
|
35
|
+
// stack 是否有对应 registry 包由运行时映射表(services/registry STACK_RUNTIME)校验,
|
|
36
|
+
// 无映射的 stack 执行时报 REGISTRY_STACK_UNSUPPORTED 并提示支持列表。
|
|
34
37
|
const SCENE_REGISTRARS = {
|
|
35
38
|
default: (p) => {
|
|
36
39
|
// init / upgrade / skills 都挂出来:本地用户不需要 export MIAODA_APP_TYPE=3
|
|
@@ -42,13 +45,13 @@ const SCENE_REGISTRARS = {
|
|
|
42
45
|
(0, index_1.registerFileCommands)(p);
|
|
43
46
|
(0, index_3.registerObservabilityCommands)(p);
|
|
44
47
|
(0, index_6.registerSkillsCommands)(p);
|
|
45
|
-
(0,
|
|
48
|
+
(0, index_8.registerRegistryCommands)(p);
|
|
46
49
|
},
|
|
47
50
|
modern: (p) => {
|
|
48
51
|
(0, index_4.registerAppCommands)(p, { includeInit: true });
|
|
49
52
|
(0, modern_1.registerDeployCommandsModern)(p);
|
|
50
53
|
(0, index_6.registerSkillsCommands)(p);
|
|
51
|
-
(0,
|
|
54
|
+
(0, index_8.registerRegistryCommands)(p);
|
|
52
55
|
},
|
|
53
56
|
// application scene(AppType_APPLICATION=3):
|
|
54
57
|
// 在 default 命令集基础上加 skills(按 meta.json.stack 拉对应 stack 技能)
|
|
@@ -60,7 +63,7 @@ const SCENE_REGISTRARS = {
|
|
|
60
63
|
(0, index_1.registerFileCommands)(p);
|
|
61
64
|
(0, index_3.registerObservabilityCommands)(p);
|
|
62
65
|
(0, index_6.registerSkillsCommands)(p);
|
|
63
|
-
(0,
|
|
66
|
+
(0, index_8.registerRegistryCommands)(p);
|
|
64
67
|
},
|
|
65
68
|
// design scene(AppType_DESIGN=4):design-stack 仅 SSR 渲染、无后端业务逻辑、
|
|
66
69
|
// 无数据库、无 UGC 文件。命令集裁掉 db / file,保留 deploy / observability / app(init) / skills。
|
|
@@ -69,11 +72,11 @@ const SCENE_REGISTRARS = {
|
|
|
69
72
|
(0, index_5.registerDeployCommands)(p);
|
|
70
73
|
(0, index_3.registerObservabilityCommands)(p);
|
|
71
74
|
(0, index_6.registerSkillsCommands)(p);
|
|
72
|
-
(0,
|
|
75
|
+
(0, index_8.registerRegistryCommands)(p);
|
|
73
76
|
},
|
|
74
77
|
// design-html scene(AppType_DESIGN_HTML=8):buildless 静态 HTML,
|
|
75
78
|
// 命令集与 modern 一致(app init/sync + modern 拆分版 deploy + skills),不挂 db/file/observability。
|
|
76
|
-
//
|
|
79
|
+
// comment(应用评论)仅 design-html 开放。
|
|
77
80
|
'design-html': (p) => {
|
|
78
81
|
(0, index_4.registerAppCommands)(p, { includeInit: true });
|
|
79
82
|
(0, modern_1.registerDeployCommandsModern)(p);
|
|
@@ -4,7 +4,8 @@ exports.registerRegistryCommands = registerRegistryCommands;
|
|
|
4
4
|
const shared_1 = require("../../../cli/commands/shared");
|
|
5
5
|
const index_1 = require("../../../cli/handlers/registry/index");
|
|
6
6
|
/**
|
|
7
|
-
* miaoda registry
|
|
7
|
+
* miaoda registry:「组件 registry」(shadcn 式 copy-in),供有对应 registry 包的 stack 使用
|
|
8
|
+
* (当前 design-html / html,见 services/registry 的 STACK_RUNTIME)。
|
|
8
9
|
*
|
|
9
10
|
* registry 是独立 npm 包,按 runtime 命名分发(buildless runtime → @lark-apaas/coding-registry-buildless)。
|
|
10
11
|
* SDK 文件放在包根的 components/ · scripts/ · stylesheets/ 三个目录下(这三个顶层目录里的代码文件
|
|
@@ -15,7 +16,7 @@ const index_1 = require("../../../cli/handlers/registry/index");
|
|
|
15
16
|
function registerRegistryCommands(program) {
|
|
16
17
|
const registryCmd = program
|
|
17
18
|
.command('registry')
|
|
18
|
-
.description('组件 registry:列出 / copy-in
|
|
19
|
+
.description('组件 registry:列出 / copy-in SDK 文件')
|
|
19
20
|
.usage('<command> [flags]');
|
|
20
21
|
registryCmd.action(() => {
|
|
21
22
|
registryCmd.outputHelp();
|
|
@@ -32,7 +33,8 @@ function registerRegistryCommands(program) {
|
|
|
32
33
|
- add 落地:拍平到项目根(包根 scripts/x.js → 项目 x.js);同名 basename 撞车时后者覆盖前者
|
|
33
34
|
|
|
34
35
|
前置
|
|
35
|
-
当前目录(或 --dir)已走过 'miaoda app init'
|
|
36
|
+
当前目录(或 --dir)已走过 'miaoda app init',且 .spark/meta.json 的 stack 有对应
|
|
37
|
+
registry 包(当前支持 design-html / html);其余 stack 执行时报 REGISTRY_STACK_UNSUPPORTED
|
|
36
38
|
`);
|
|
37
39
|
registerRegistryList(registryCmd);
|
|
38
40
|
registerRegistryAdd(registryCmd);
|
|
@@ -169,6 +169,12 @@ async function handleAppExport(opts) {
|
|
|
169
169
|
finally {
|
|
170
170
|
node_fs_1.default.rmSync(tmpDir, { recursive: true, force: true });
|
|
171
171
|
}
|
|
172
|
+
// 防御清理:git archive 语义不含 .git,防通道实现变化带出嵌套仓(git 会记 gitlink,
|
|
173
|
+
// 参考稿进不了提交);源仓 .gitignore 会成为新仓子树的嵌套忽略规则,极端 case(源仓
|
|
174
|
+
// force-add 过被自身 ignore 的文件)会让参考稿部分文件被 git add 静默忽略。
|
|
175
|
+
// 两者对 UX 对照均无价值,解压后移除,保证"进 git 的参考稿 = 导出的全部内容文件"。
|
|
176
|
+
node_fs_1.default.rmSync(node_path_1.default.join(outDir, '.git'), { recursive: true, force: true });
|
|
177
|
+
node_fs_1.default.rmSync(node_path_1.default.join(outDir, '.gitignore'), { force: true });
|
|
172
178
|
const fileCount = countFiles(outDir);
|
|
173
179
|
const manifest = {
|
|
174
180
|
sourceAppId: appId,
|
|
@@ -60,11 +60,16 @@ async function handleAppInit(opts) {
|
|
|
60
60
|
const tplResult = (0, index_1.renderTemplate)({ stack, version, targetDir, projectName });
|
|
61
61
|
// source_path 导入:当前仅 app_type=modern_html 生效。渲染完模板后、装依赖前叠加进 src/。
|
|
62
62
|
const sourceImport = applySourcePathImport(opts, targetDir);
|
|
63
|
+
// 本地脚手架门禁:沙箱内所有栈照旧同步(nested,产出 .agent/);本地只有 LOCAL_STEERING_STACKS
|
|
64
|
+
// 白名单栈(nestjs-react-fullstack / vite-react)才落地 steering(.claude/.agents)与 logs/。
|
|
65
|
+
// html / design-html 是纯静态 / 设计产物,本地不需要这套 agent skills 脚手架,整段跳过。
|
|
66
|
+
const sandbox = (0, env_1.isSandboxEnv)();
|
|
67
|
+
const scaffoldSteering = sandbox || index_1.LOCAL_STEERING_STACKS.has(stack);
|
|
63
68
|
// 先建 logs/,防止 user 跑 dev 之前 AI/工具 redirect 到 logs/*.log 因为父目录不存在直接挂
|
|
64
69
|
// (dev.js / dev-local.js 自己也建 logs/,但只在它启动后;启动前的 shell redirect 会先于此)。
|
|
65
|
-
//
|
|
66
|
-
//
|
|
67
|
-
if (!
|
|
70
|
+
// 仅本地白名单栈需要:沙箱环境由平台 supervisor 拉起 dev,无 init 前的 shell redirect 场景;
|
|
71
|
+
// 非白名单栈本地不落 steering 脚手架,也无需预建 logs/。
|
|
72
|
+
if (!sandbox && scaffoldSteering) {
|
|
68
73
|
(0, logs_dir_1.ensureLogsDir)(targetDir);
|
|
69
74
|
}
|
|
70
75
|
// skills 同步软失败:拉不到 coding-steering 包不该阻断 writeSparkMeta /
|
|
@@ -74,21 +79,28 @@ async function handleAppInit(opts) {
|
|
|
74
79
|
// 跟沙箱端 update-skills.sh 链路对齐
|
|
75
80
|
// - 本地 → flat (.agents/skills + .claude/skills 软链),
|
|
76
81
|
// Agent / Claude Code 用同一份;nrf 在本地是主战场,vite-react 等也一样适用
|
|
77
|
-
const outputLayout =
|
|
78
|
-
|
|
82
|
+
const outputLayout = sandbox ? 'nested' : 'flat';
|
|
83
|
+
// 默认空结果:非白名单栈跳过 steering 同步时(scaffoldSteering=false)直接沿用,
|
|
84
|
+
// 与"拉不到 coding-steering 包"软失败路径共用同一份占位,emit / meta 落盘不受影响。
|
|
85
|
+
let steeringResult = {
|
|
86
|
+
version: 'unknown',
|
|
87
|
+
syncedSkills: [],
|
|
88
|
+
techSynced: false,
|
|
89
|
+
};
|
|
79
90
|
let steeringError;
|
|
80
|
-
|
|
81
|
-
|
|
82
|
-
|
|
83
|
-
|
|
84
|
-
|
|
85
|
-
|
|
86
|
-
|
|
87
|
-
|
|
88
|
-
|
|
89
|
-
|
|
90
|
-
|
|
91
|
-
|
|
91
|
+
if (scaffoldSteering) {
|
|
92
|
+
try {
|
|
93
|
+
steeringResult = (0, coding_steering_1.syncCodingSteering)({
|
|
94
|
+
stack,
|
|
95
|
+
targetDir,
|
|
96
|
+
logPrefix: 'init',
|
|
97
|
+
outputLayout,
|
|
98
|
+
});
|
|
99
|
+
}
|
|
100
|
+
catch (err) {
|
|
101
|
+
steeringError = err instanceof Error ? err.message : String(err);
|
|
102
|
+
(0, logger_1.log)('init', `⚠ skills sync failed (continuing init): ${steeringError}`);
|
|
103
|
+
}
|
|
92
104
|
}
|
|
93
105
|
// 依赖安装:async 模式留到 meta 落盘后派发后台进程(不等装完),同步模式当场装。
|
|
94
106
|
// 同步:装模板钉死的依赖。不带 <pkg>@latest 位置参数,因此 npm 不会改写 package.json/lockfile
|
|
@@ -1,10 +1,11 @@
|
|
|
1
1
|
"use strict";
|
|
2
2
|
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
-
exports.ASYNC_INSTALL_LOG = exports.runAsyncInstallWorker = exports.dispatchAsyncInstall = exports.resolveNpmInstallRegistry = exports.installDependencies = exports.writeSparkMeta = exports.readSparkMeta = exports.IMPORT_SKIP_FILES = exports.IMPORT_SKIP_DIRS = exports.importSourceSrc = exports.TEMPLATE_PACKAGE_BY_STACK = exports.STACK_BY_APP_TYPE = exports.APP_TYPES = exports.SUPPORTED_STACKS = exports.resolveStack = exports.renderTemplate = void 0;
|
|
3
|
+
exports.ASYNC_INSTALL_LOG = exports.runAsyncInstallWorker = exports.dispatchAsyncInstall = exports.resolveNpmInstallRegistry = exports.installDependencies = exports.writeSparkMeta = exports.readSparkMeta = exports.IMPORT_SKIP_FILES = exports.IMPORT_SKIP_DIRS = exports.importSourceSrc = exports.TEMPLATE_PACKAGE_BY_STACK = exports.STACK_BY_APP_TYPE = exports.APP_TYPES = exports.LOCAL_STEERING_STACKS = exports.SUPPORTED_STACKS = exports.resolveStack = exports.renderTemplate = void 0;
|
|
4
4
|
var template_1 = require("./template");
|
|
5
5
|
Object.defineProperty(exports, "renderTemplate", { enumerable: true, get: function () { return template_1.renderTemplate; } });
|
|
6
6
|
Object.defineProperty(exports, "resolveStack", { enumerable: true, get: function () { return template_1.resolveStack; } });
|
|
7
7
|
Object.defineProperty(exports, "SUPPORTED_STACKS", { enumerable: true, get: function () { return template_1.SUPPORTED_STACKS; } });
|
|
8
|
+
Object.defineProperty(exports, "LOCAL_STEERING_STACKS", { enumerable: true, get: function () { return template_1.LOCAL_STEERING_STACKS; } });
|
|
8
9
|
Object.defineProperty(exports, "APP_TYPES", { enumerable: true, get: function () { return template_1.APP_TYPES; } });
|
|
9
10
|
Object.defineProperty(exports, "STACK_BY_APP_TYPE", { enumerable: true, get: function () { return template_1.STACK_BY_APP_TYPE; } });
|
|
10
11
|
Object.defineProperty(exports, "TEMPLATE_PACKAGE_BY_STACK", { enumerable: true, get: function () { return template_1.TEMPLATE_PACKAGE_BY_STACK; } });
|
|
@@ -3,7 +3,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
|
|
|
3
3
|
return (mod && mod.__esModule) ? mod : { "default": mod };
|
|
4
4
|
};
|
|
5
5
|
Object.defineProperty(exports, "__esModule", { value: true });
|
|
6
|
-
exports.APP_TYPES = exports.STACK_BY_APP_TYPE = exports.SUPPORTED_STACKS = exports.TEMPLATE_PINNED_VERSION_BY_STACK = exports.TEMPLATE_PACKAGE_BY_STACK = void 0;
|
|
6
|
+
exports.APP_TYPES = exports.STACK_BY_APP_TYPE = exports.LOCAL_STEERING_STACKS = exports.SUPPORTED_STACKS = exports.TEMPLATE_PINNED_VERSION_BY_STACK = exports.TEMPLATE_PACKAGE_BY_STACK = void 0;
|
|
7
7
|
exports.resolveStack = resolveStack;
|
|
8
8
|
exports.renderTemplate = renderTemplate;
|
|
9
9
|
const node_fs_1 = __importDefault(require("node:fs"));
|
|
@@ -27,6 +27,13 @@ exports.TEMPLATE_PACKAGE_BY_STACK = {
|
|
|
27
27
|
*/
|
|
28
28
|
exports.TEMPLATE_PINNED_VERSION_BY_STACK = {};
|
|
29
29
|
exports.SUPPORTED_STACKS = Object.keys(exports.TEMPLATE_PACKAGE_BY_STACK);
|
|
30
|
+
/**
|
|
31
|
+
* 本地开发(非沙箱)需要落地 agent skills 脚手架(.claude/.agents)与 logs/ 的 stack 白名单。
|
|
32
|
+
* 只有这些全栈 / 前端框架栈在本地才需要 coding-steering 的 skills;html / design-html 是纯
|
|
33
|
+
* 静态 / 设计产物,本地无需这套脚手架,init 直接跳过 syncCodingSteering 与 logs 创建。
|
|
34
|
+
* 沙箱环境不受此白名单约束(所有栈照旧走 nested 同步,产出 .agent/)。
|
|
35
|
+
*/
|
|
36
|
+
exports.LOCAL_STEERING_STACKS = new Set(['nestjs-react-fullstack', 'vite-react']);
|
|
30
37
|
/**
|
|
31
38
|
* app_type(业务类型)→ stack 短名映射。仅在调用方未显式传 --template 时用于解析 stack。
|
|
32
39
|
* 与 src/api/app/types.ts 的 AppType 枚举无关,是独立的业务类型概念。
|
|
@@ -22,12 +22,13 @@ const logger_1 = require("../../utils/logger");
|
|
|
22
22
|
*
|
|
23
23
|
* registry 包按 **运行时(runtime)** 命名分发(而非 stack):多个 stack 可共享同一 runtime
|
|
24
24
|
* 的同一份 registry。runtime 不引入新的 meta 字段,从已有的 `.spark/meta.json.stack` 推得。
|
|
25
|
-
* STACK_RUNTIME: stack → runtime(design-html
|
|
25
|
+
* STACK_RUNTIME: stack → runtime(design-html / html 都跑在 buildless 运行时)
|
|
26
26
|
* REGISTRY_BY_RUNTIME: runtime → registry 包名
|
|
27
27
|
* 任一步查不到都明确报错(stack 无对应 runtime / runtime 无对应 registry)。
|
|
28
28
|
*/
|
|
29
29
|
exports.STACK_RUNTIME = {
|
|
30
30
|
'design-html': 'buildless',
|
|
31
|
+
html: 'buildless',
|
|
31
32
|
};
|
|
32
33
|
exports.REGISTRY_BY_RUNTIME = {
|
|
33
34
|
buildless: '@lark-apaas/coding-registry-buildless',
|
package/dist/utils/http.js
CHANGED
|
@@ -63,8 +63,14 @@ function createClient(opts) {
|
|
|
63
63
|
/**
|
|
64
64
|
* 默认灰度泳道。当前 miaoda CLI 接入的新接口(modern deploy 等)只在该泳道生效,
|
|
65
65
|
* 缺省走这个。MIAODA_CANARY_HEADER 可显式覆盖;设为空字符串则去掉头。
|
|
66
|
+
*
|
|
67
|
+
* ⚠️ TEMP(creative-upgrade 联调用):默认泳道临时指向开发泳道 boe_debug_detail_lookup,
|
|
68
|
+
* 使 alpha 发版进沙箱镜像后,app export / code-archive 等新接口无需 wrapper 即可命中
|
|
69
|
+
* 尚未合流的 studio_server 改动。
|
|
70
|
+
* 上线前必须还原为 'boe_miaoda_ccm',或改为由 agent_tool 按请求 x-tt-env 注入
|
|
71
|
+
* MIAODA_CANARY_HEADER(详见 http.ts 的 applyCanaryHeader 与 agent_tool ExecShellCmd)。
|
|
66
72
|
*/
|
|
67
|
-
const DEFAULT_CANARY_HEADER = '
|
|
73
|
+
const DEFAULT_CANARY_HEADER = 'boe_debug_detail_lookup';
|
|
68
74
|
/**
|
|
69
75
|
* 注入 x-tt-env 小流量头:env 显式设值 > DEFAULT_CANARY_HEADER。
|
|
70
76
|
*
|