@h-ai/cli 0.1.0-alpha.53 → 0.1.0-alpha.55

package/templates/skills/hai-datapipe/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: hai-datapipe
-description: 使用 @h-ai/datapipe 进行文本清洗（HTML/URL/空白移除）、多模式分块（句子/段落/Markdown/字符/自定义）和管线组合；当需求涉及文本预处理、文档分块、数据清洗或 RAG 入库前处理时使用。
+description: "使用 @h-ai/datapipe 清洗文本、分块并组合 RAG 入库管线。"
 ---
 
 # hai-datapipe
@@ -9,22 +9,18 @@ description: 使用 @h-ai/datapipe 进行文本清洗（HTML/URL/空白移除）
 
 | 项目 | 契约 |
 | --- | --- |
-| 能力 | 使用 @h-ai/datapipe 进行文本清洗（HTML/URL/空白移除）、多模式分块（句子/段落/Markdown/字符/自定义）和管线组合；当需求涉及文本预处理、文档分块、数据清洗或 RAG 入库前处理时使用。 |
-| 适用场景 | 当任务与 `hai-datapipe` 的能力描述匹配，并且需要遵循本 Skill 的流程和边界时 |
-| 输入 | 模块配置、类型化业务参数、依赖初始化状态和目标运行环境 |
-| 输出 | 符合模块公共 API 的实现或示例；业务结果使用 HaiResult，并同步必要测试与文档 |
-| 限制 | 遵守 init → use → close 生命周期与运行环境边界；不绕过类型、授权、输入校验或敏感信息保护 |
+| 能力 | 使用 @h-ai/datapipe 清洗文本、分块并组合 RAG 入库管线 |
+| 适用场景 | 文档进入检索/知识库前的文本预处理 |
+| 输入 | 文本、清洗/分块选项、管线步骤 |
+| 输出 | 清洗/分块的 HaiResult；管线工厂按签名使用 |
+| 限制 | 纯函数，无 init/close；区分字符数和模型 token 数，分块结果不等于已生成 embedding。 |
 
 > `@h-ai/datapipe` 提供文本清洗（clean）、多模式分块（chunk）和可组合管线（pipeline），纯函数模块，无需初始化。
 
----
-
 ## 运行环境
 
 > **服务端模块（Node.js only）。** 通常在 AI 知识库入库或文档预处理场景中使用，由 `@h-ai/ai` 内部调用或在服务端显式调用。
 
----
-
 ## 适用场景
 
 - 文本清洗：移除 HTML 标签、URL、Email，标准化空白
@@ -32,8 +28,6 @@ description: 使用 @h-ai/datapipe 进行文本清洗（HTML/URL/空白移除）
 - RAG 入库前的文档预处理管线
 - 管线模式组合多步清洗 + 分块 + 自定义转换
 
----
-
 ## 使用步骤
 
 ### 直接调用（无需 init）
@@ -63,13 +57,11 @@ if (result.success) {
 }
 ```
 
----
-
 ## 核心 API
 
 ### 清洗 — `datapipe.clean`
 
-```typescript
+```text
 datapipe.clean(text: string, options?: CleanOptionsInput): HaiResult<string>
 ```
 
@@ -86,7 +78,7 @@ datapipe.clean(text: string, options?: CleanOptionsInput): HaiResult<string>
 
 ### 分块 — `datapipe.chunk`
 
-```typescript
+```text
 datapipe.chunk(text: string, options: ChunkOptionsInput): HaiResult<DataChunk[]>
 ```
 
@@ -127,7 +119,7 @@ interface DataChunk {
 
 ```typescript
 datapipe.pipeline()
-  .clean(options?)              // 添加清洗步骤
+  .clean(options)              // 添加清洗步骤
   .transform(fn)                // 添加文本转换步骤（同步/异步）
   .chunk(options)               // 添加分块步骤
   .chunkTransform(fn)           // 添加分块后处理步骤
@@ -143,8 +135,6 @@ interface PipelineResult {
 }
 ```
 
----
-
 ## 错误码 — `HaiDatapipeError`
 
 | 错误码 | code | 说明 |
@@ -156,8 +146,6 @@ interface PipelineResult {
 | `HaiDatapipeError.CONFIG_ERROR` | `hai:datapipe:005` | 配置错误 |
 | `HaiDatapipeError.MISSING_SEPARATOR` | `hai:datapipe:006` | 自定义分隔符缺失 |
 
----
-
 ## 常见模式
 
 ### RAG 文档入库前处理
@@ -221,8 +209,6 @@ if (!result.success) {
 }
 ```
 
----
-
 ## 相关 Skills
 
 - `hai-vecdb`：向量数据库存储（分块后入库）

package/templates/skills/hai-deploy/SKILL.md

@@ -1,30 +1,28 @@
 ---
 name: hai-deploy
-description: 使用 @h-ai/deploy 进行自动化部署：Vercel 部署 + 基础设施开通（Neon/Upstash/R2/Resend/Aliyun）；当需求涉及应用部署、环境配置、凭证管理或云服务开通时使用。
+description: "使用 @h-ai/deploy 配置部署和 Vercel/Neon/Upstash/R2 等基础设施。"
 ---
 
 # hai-deploy
 
 ## 能力契约
 
+`hai deploy` 在模块/配置缺失或凭证、扫描、初始化、部署、关闭失败时返回非零退出码。自动化流程必须以退出码判断成功，不要只判断命令是否完成或是否输出日志。
+
 | 项目 | 契约 |
 | --- | --- |
-| 能力 | 使用 @h-ai/deploy 进行自动化部署：Vercel 部署 + 基础设施开通（Neon/Upstash/R2/Resend/Aliyun）；当需求涉及应用部署、环境配置、凭证管理或云服务开通时使用。 |
-| 适用场景 | 当任务与 `hai-deploy` 的能力描述匹配，并且需要遵循本 Skill 的流程和边界时 |
-| 输入 | 用户目标、仓库与运行环境上下文、现有配置、授权范围和质量门禁 |
-| 输出 | 与目标匹配的配置/代码/文档或审查结论，以及可复现的验证结果 |
-| 限制 | 不扩张用户授权，不输出或固化密钥，不跳过失败门禁，不假定外部服务状态 |
+| 能力 | 使用 @h-ai/deploy 配置部署和 Vercel/Neon/Upstash/R2 等基础设施 |
+| 适用场景 | 部署目标配置、云资源开通或部署故障排查 |
+| 输入 | 项目构建产物、部署目标、环境配置与凭据引用 |
+| 输出 | 部署/资源操作结果和可验证的目标状态 |
+| 限制 | 核对实际 provider 与应用运行时；开通收费资源、发布或删除必须在用户授权范围内，凭据不写入仓库。 |
 
 > `@h-ai/deploy` 提供自动化部署能力，将 SvelteKit 应用部署到 Vercel，并自动开通 PostgreSQL (Neon)、Redis (Upstash)、S3 (Cloudflare R2)、邮件 (Resend)、短信 (阿里云) 等基础设施服务。
 
----
-
 ## 运行环境
 
 > ⚠️ **Node.js CLI / 服务端模块。** 通过 `hai deploy` CLI 命令或在 Node.js 脚本中使用。
 
----
-
 ## 适用场景
 
 - 一键部署 SvelteKit 应用到 Vercel
@@ -33,8 +31,6 @@ description: 使用 @h-ai/deploy 进行自动化部署：Vercel 部署 + 基础
 - 扫描应用依赖，自动检测所需服务
 - CLI 部署流程（`hai deploy`）
 
----
-
 ## 使用步骤
 
 ### 1. 配置
@@ -57,13 +53,17 @@ services:
     provisioner: cloudflare-r2
     accountId: ${HAI_DEPLOY_CF_ACCOUNT_ID}
     apiToken: ${HAI_DEPLOY_CF_API_TOKEN}
+    accessKeyId: ${HAI_DEPLOY_R2_ACCESS_KEY_ID}
+    secretAccessKey: ${HAI_DEPLOY_R2_SECRET_ACCESS_KEY}
   email:
     provisioner: resend
     apiKey: ${HAI_DEPLOY_RESEND_API_KEY}
+    from: ${HAI_DEPLOY_RESEND_FROM}
   sms:
     provisioner: aliyun
     accessKeyId: ${HAI_DEPLOY_ALIYUN_ACCESS_KEY_ID}
     accessKeySecret: ${HAI_DEPLOY_ALIYUN_ACCESS_KEY_SECRET}
+    signName: ${HAI_DEPLOY_ALIYUN_SIGN_NAME}
 ```
 
 这些凭证名由 `deploy.credentials` 管理，属于显式特殊映射；若同时设置
@@ -122,8 +122,6 @@ if (result.success) {
 }
 ```
 
----
-
 ## 核心 API
 
 | 方法                   | 签名                                                                       | 说明         |
@@ -140,16 +138,12 @@ if (result.success) {
 | `deploy.config`        | `DeployConfig \| null`                                                     | 当前配置     |
 | `deploy.isInitialized` | `boolean`                                                                  | 初始化状态   |
 
----
-
 ## 凭证管理
 
 所有凭证操作都通过 `deploy.credentials.*` 访问，模块入口不再单独导出自由函数。
 
 > `deploy.credentials.*()` 与 `deploy.scan()` 都不依赖 `deploy.init()`，可用于 CLI 在读取 `_deploy.yml` 之前准备环境。
 
----
-
 ## 错误码 — `HaiDeployError`
 
 | 错误码                                  | code               | 说明                     |
@@ -169,8 +163,6 @@ if (result.success) {
 | `HaiDeployError.CONFIG_ERROR`          | `hai:deploy:013`   | 配置错误                 |
 | `HaiDeployError.CREDENTIAL_ERROR`      | `hai:deploy:014`   | 凭证读写失败             |
 
----
-
 ## CLI 命令
 
 ```bash
@@ -190,8 +182,6 @@ hai deploy --skip-build
 hai deploy --project-name my-custom-name
 ```
 
----
-
 ## 常见模式
 
 ### 仅部署（跳过基础设施）
@@ -223,10 +213,14 @@ await deploy.init({
 const result = await deploy.deployApp('./apps/my-app')
 ```
 
----
-
 ## 相关 Skills
 
 - **hai-core** — 配置加载、日志、HaiResult 类型
 - **hai-reldb** — 数据库（Neon PostgreSQL）
 - **hai-cache** — 缓存（Upstash Redis）
+
+失败与降级提示也必须国际化：官网 API 按请求 locale 生成 AI 降级/邮件送达状态；未送达不能称为已接收。CLI 部署状态使用 cliM，Gallery 加密能力限制使用双语消息。中文与英文分别验证未配置、失败和成功路径，无需调用付费服务。
+
+云资源配置消费：Neon 输出 HAI_DB（PostgreSQL JSON），Upstash 输出 HAI_CACHE（Redis rediss URL JSON），R2 输出 HAI_STORAGE（扁平 S3 JSON）。邮件/短信输出 HAI_REACH_PROVIDERS 数组，deployApp 合并两个渠道并保留 YAML 中的消息模板；此覆盖替换原 providers 数组。Core 支持整体对象/数组覆盖，父节点优先于叶子变量，仍执行 Schema 校验；构建子进程与目标运行环境使用相同开通结果。R2 必须提供已有 S3 accessKeyId/secretAccessKey；Resend 必须提供已验证域名的 from；阿里云必须提供已审核 signName/模板。应用须已有相应 _db/_cache/_storage/_reach.yml 并在启动时加载，网络客户端需要 Node 运行时。
+
+部署失败恢复：`ProvisionResult.resourceStatus` 标记 created/reused；`getDeployRecovery(result.error)` 读取 projectName、stage、platformProjectId 和资源清单，unknown 表示请求结果不确定，必须先在服务商控制台核对。失败资源已返回 ID 时保留该 ID。恢复结果不含 envVars、原始异常或连接凭证，CLI 会展示清单和建议。同名重试复用现有资源；不自动删除复用资源，新建资源仅在人工确认未被使用后清理。

package/templates/skills/hai-framework-sync/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: hai-framework-sync
-description: 管理 hai-framework 与应用仓库之间的依赖、技能模板、Copilot/AGENTS 指令和本地联调同步；当需求涉及 hai-framework 源头修改、skills 同步、framework:use:local、framework:watch、版本漂移或双仓 PR 时使用。
+description: "同步 hai-framework 通用 skills、AI 入口与应用依赖，排查 npm/本地联调漂移。"
 ---
 
 # hai-framework-sync — hai-framework 与应用仓库同步规范
@@ -9,16 +9,14 @@ description: 管理 hai-framework 与应用仓库之间的依赖、技能模板
 
 | 项目 | 契约 |
 | --- | --- |
-| 能力 | 管理 hai-framework 与应用仓库之间的依赖、技能模板、Copilot/AGENTS 指令和本地联调同步；当需求涉及 hai-framework 源头修改、skills 同步、framework:use:local、framework:watch、版本漂移或双仓 PR 时使用。 |
-| 适用场景 | 当任务与 `hai-framework-sync` 的能力描述匹配，并且需要遵循本 Skill 的流程和边界时 |
-| 输入 | 用户目标、仓库与运行环境上下文、现有配置、授权范围和质量门禁 |
-| 输出 | 与目标匹配的配置/代码/文档或审查结论，以及可复现的验证结果 |
-| 限制 | 不扩张用户授权，不输出或固化密钥，不跳过失败门禁，不假定外部服务状态 |
+| 能力 | 同步 hai-framework 通用 skills、AI 入口与应用依赖，排查 npm/本地联调漂移 |
+| 适用场景 | 有明确源/目标仓库的模板或版本同步 |
+| 输入 | 框架源目录、应用目录、版本、现有本地覆盖 |
+| 输出 | 同步后的完整 skill 目录、入口及版本验证结果 |
+| 限制 | 仅操作授权仓库；保留应用私有规则。先查 scripts，不假定 framework:* 联调命令存在；未发布行为不能当 npm 已支持。 |
 
 > hai-framework 是能力与 skill 模板源头；应用仓库消费这些能力，并可以有少量项目本地覆盖。同步的目标是减少漂移，而不是把两个仓库混成一个仓库。
 
----
-
 ## 适用场景
 
 - 修改 `.agents/skills/**`，且内容应成为所有 hai-framework 应用通用规范
@@ -28,8 +26,6 @@ description: 管理 hai-framework 与应用仓库之间的依赖、技能模板
 - 排查应用仓库与 hai-framework npm 版本不一致
 - 规划双仓 PR 或同步发布
 
----
-
 ## 同步原则
 
 1. **通用规范先改 hai-framework**：可复用的 skill、模板、AI 工作流从 `packages/cli/templates/skills/` 起源。
@@ -38,8 +34,6 @@ description: 管理 hai-framework 与应用仓库之间的依赖、技能模板
 4. **双仓改动要成套**：framework 模板、应用本地 `.agents/skills`、AGENTS/Copilot 路由同时更新。
 5. **不复制敏感聊天记录**：只同步脱敏后的团队规则和流程。
 
----
-
 ## 标准同步流程
 
 ### 1. 判断来源
@@ -57,7 +51,7 @@ description: 管理 hai-framework 与应用仓库之间的依赖、技能模板
 
 ### 3. 同步到应用仓库
 
-把源头 skill 复制到应用仓库 `.agents/skills/<skill>/SKILL.md`，并同步入口引用：
+把源头完整 skill 目录（含 reference.md 等被引用资源）复制到应用仓库 `.agents/skills/<skill>/`，并同步入口引用：
 
 - `AGENTS.md`
 - `.github/copilot-instructions.md`
@@ -70,7 +64,7 @@ description: 管理 hai-framework 与应用仓库之间的依赖、技能模板
 
 - 仅模板 / skill 变更：检查 diff、入口引用与模板泛化程度。
 - 同步到应用仓库：按 `hai-ci` 定义的质量门禁运行。
-- 涉及 framework runtime 时，再选择：
+- 涉及 framework runtime 时，先确认应用 package.json 已定义下列脚本；没有时按 README 的本地联调方式操作：
 
 ```bash
 pnpm framework:status
@@ -78,8 +72,6 @@ pnpm framework:use:local <package>
 pnpm framework:watch <package>
 ```
 
----
-
 ## 漂移检查清单
 
 - [ ] framework 模板和应用 `.agents/skills` 对同名 skill 内容一致，除非 PR 明确说明本地覆盖
@@ -89,8 +81,6 @@ pnpm framework:watch <package>
 - [ ] 本地联调结束后可恢复 npm 模式
 - [ ] README 或 PR 描述说明双仓改动顺序
 
----
-
 ## 禁止事项
 
 - ❌ 只改应用 `.agents/skills`，忘记更新 hai-framework 模板中的通用规范
@@ -99,8 +89,6 @@ pnpm framework:watch <package>
 - ❌ 把聊天记录原文、token、私有 URL 写入模板
 - ❌ 双仓 PR 没有关联 issue 或同步说明
 
----
-
 ## 相关 Skills
 
 - `hai-ci` — CI 对 npm/local framework 模式的验证策略