cloudcc-cli 2.4.1 → 2.4.2
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 +42 -0
- package/bin/index.js +5 -0
- package/cloudcc-dev-skill/SKILL.md +6 -12
- package/cloudcc-dev-skill/config.json +2 -2
- package/package.json +2 -2
- package/src/classes/create.js +1 -1
- package/src/config/use.js +20 -5
- package/src/dupeCatcher/create.js +76 -0
- package/src/dupeCatcher/delete.js +69 -0
- package/src/dupeCatcher/detail.js +57 -0
- package/src/dupeCatcher/doc.js +11 -0
- package/src/dupeCatcher/docs/devguide.md +125 -0
- package/src/dupeCatcher/docs/introduction.md +21 -0
- package/src/dupeCatcher/get.js +88 -0
- package/src/dupeCatcher/index.js +14 -0
- package/src/html/doc.js +35 -0
- package/src/html/docs/devguide.md +67 -0
- package/src/html/docs/introduction.md +4 -0
- package/src/html/index.js +11 -0
- package/src/openapi/cloudcc-openapi-sdk.js +1085 -0
- package/src/openapi/doc.js +30 -0
- package/src/openapi/docs/devguide.md +65 -0
- package/src/openapi/docs/introduction.md +43 -0
- package/src/openapi/get.js +45 -0
- package/src/openapi/index.js +12 -0
- package/src/plugin/publish1.js +1 -1
- package/src/plugin/pull.js +2 -2
- package/src/sharingRule/doc.js +46 -0
- package/src/sharingRule/docs/devguide.md +28 -0
- package/src/sharingRule/docs/introduction.md +7 -0
- package/src/sharingRule/get.js +48 -0
- package/src/sharingRule/index.js +9 -0
- package/src/site/doc.js +35 -0
- package/src/site/docs/devguide.md +209 -0
- package/src/site/docs/introduction.md +4 -0
- package/src/site/index.js +11 -0
- package/src/triggers/docs/devguide.md +1 -2
- package/src/triggers/get.js +1 -2
- package/src/version/doctor.js +11 -4
- package/src/version/listModuleCommands.js +20 -0
- package/template/index.js +2 -2
- package/utils/config.js +129 -21
- package/cloudcc-dev-skill/cloudcc-dev-html.md +0 -42
- package/template/cloudcc-cli.configjs +0 -7
package/src/html/doc.js
ADDED
|
@@ -0,0 +1,35 @@
|
|
|
1
|
+
const fs = require("fs");
|
|
2
|
+
const path = require("path");
|
|
3
|
+
|
|
4
|
+
const DOCS_DIR = path.join(__dirname, "docs");
|
|
5
|
+
|
|
6
|
+
function getIntroductionDoc() {
|
|
7
|
+
return fs.readFileSync(path.join(DOCS_DIR, "introduction.md"), "utf8");
|
|
8
|
+
}
|
|
9
|
+
|
|
10
|
+
function getDevGuideDoc() {
|
|
11
|
+
return fs.readFileSync(path.join(DOCS_DIR, "devguide.md"), "utf8");
|
|
12
|
+
}
|
|
13
|
+
|
|
14
|
+
function doc(argvs) {
|
|
15
|
+
const subType = argvs[2];
|
|
16
|
+
const key = String(subType || "").trim().toLowerCase();
|
|
17
|
+
if (!key) {
|
|
18
|
+
throw new Error("cloudcc doc html 需要子命令：introduction 或 devguide");
|
|
19
|
+
}
|
|
20
|
+
if (key === "introduction") {
|
|
21
|
+
const content = getIntroductionDoc();
|
|
22
|
+
console.log(content);
|
|
23
|
+
return content;
|
|
24
|
+
}
|
|
25
|
+
if (key === "devguide") {
|
|
26
|
+
const content = getDevGuideDoc();
|
|
27
|
+
console.log(content);
|
|
28
|
+
return content;
|
|
29
|
+
}
|
|
30
|
+
throw new Error(
|
|
31
|
+
`doc 不支持的子命令: ${subType}，请使用 introduction 或 devguide`
|
|
32
|
+
);
|
|
33
|
+
}
|
|
34
|
+
|
|
35
|
+
module.exports = doc;
|
|
@@ -0,0 +1,67 @@
|
|
|
1
|
+
# CloudCC 自定义 HTML 组件开发指南
|
|
2
|
+
|
|
3
|
+
## 1. 适用范围
|
|
4
|
+
|
|
5
|
+
- 本文用于在 CloudCC 相关项目中编写单个 HTML 入口页（通常为 `html/index.html`），适合 CloudCC 内嵌页面或独立打开的轻量页面场景。
|
|
6
|
+
- 静态依赖（样式、脚本、字体等）优先使用线上绝对地址（`https://...`）引入；公有云推荐使用中国大陆可稳定访问的源（如 BootCDN）。
|
|
7
|
+
- 私有云或内网环境可先下载依赖并上传为组织静态资源，再替换为静态资源 URL。
|
|
8
|
+
|
|
9
|
+
## 2. 推荐前端依赖组合
|
|
10
|
+
|
|
11
|
+
推荐组合：Tailwind CSS + Alpine.js + ECharts。
|
|
12
|
+
|
|
13
|
+
### 2.1 Tailwind CSS（浏览器端编译）
|
|
14
|
+
|
|
15
|
+
```html
|
|
16
|
+
<script src="https://cdn.bootcdn.net/ajax/libs/tailwindcss-browser/4.1.13/index.global.min.js"></script>
|
|
17
|
+
```
|
|
18
|
+
|
|
19
|
+
### 2.2 Alpine.js（交互层）
|
|
20
|
+
|
|
21
|
+
```html
|
|
22
|
+
<script defer src="https://cdn.bootcdn.net/ajax/libs/alpinejs/3.15.0/cdn.min.js"></script>
|
|
23
|
+
```
|
|
24
|
+
|
|
25
|
+
建议放在 `head`，并在同页组合时保持 Tailwind 在前、Alpine 在后。
|
|
26
|
+
|
|
27
|
+
### 2.3 ECharts（图表）
|
|
28
|
+
|
|
29
|
+
```html
|
|
30
|
+
<script src="https://cdn.bootcdn.net/ajax/libs/echarts/6.0.0/echarts.min.js"></script>
|
|
31
|
+
```
|
|
32
|
+
|
|
33
|
+
建议在 Tailwind 与 Alpine 之后加载，并在图表初始化脚本之前引入。
|
|
34
|
+
|
|
35
|
+
## 3. CloudCC 运行环境能力（CCDK）
|
|
36
|
+
|
|
37
|
+
- 在 CloudCC 运行环境（如自定义页面、内嵌 HTML）中，可通过 `window.$CCDK` 使用平台能力。
|
|
38
|
+
- 本地直接用浏览器打开 HTML 文件时通常不存在 `$CCDK`，请先做存在性判断，避免运行时报错。
|
|
39
|
+
- 业务接口与平台能力细节以各模块文档为准：`cloudcc doc <module> introduction|devguide`。
|
|
40
|
+
|
|
41
|
+
## 4. 最小可用模板
|
|
42
|
+
|
|
43
|
+
```html
|
|
44
|
+
<!doctype html>
|
|
45
|
+
<html lang="zh-CN">
|
|
46
|
+
<head>
|
|
47
|
+
<meta charset="UTF-8" />
|
|
48
|
+
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
|
|
49
|
+
<title>CloudCC HTML Page</title>
|
|
50
|
+
<script src="https://cdn.bootcdn.net/ajax/libs/tailwindcss-browser/4.1.13/index.global.min.js"></script>
|
|
51
|
+
<script defer src="https://cdn.bootcdn.net/ajax/libs/alpinejs/3.15.0/cdn.min.js"></script>
|
|
52
|
+
</head>
|
|
53
|
+
<body class="p-4">
|
|
54
|
+
<div x-data="{ ready: true }">
|
|
55
|
+
<h1 class="text-xl font-semibold">CloudCC HTML 页面</h1>
|
|
56
|
+
<p class="mt-2 text-gray-600" x-show="ready">页面已初始化</p>
|
|
57
|
+
</div>
|
|
58
|
+
|
|
59
|
+
<script>
|
|
60
|
+
const cc = window.$CCDK || null;
|
|
61
|
+
if (!cc) {
|
|
62
|
+
console.warn("$CCDK 不可用，当前可能是本地浏览器环境。");
|
|
63
|
+
}
|
|
64
|
+
</script>
|
|
65
|
+
</body>
|
|
66
|
+
</html>
|
|
67
|
+
```
|