@tbox.cn/app-cli 0.4.2 → 0.5.1

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.
@@ -1,38 +0,0 @@
1
- # tbox starter: agent-support
2
-
3
- 这是客服支持 AI Agent 的启动指南,适合搭建面向客户答疑、知识检索、澄清确认和人工承接准备的应用。starter 只负责告诉 agent 如何选择应用模板;它不是应用模板,不能作为 `tbox-app create --source` 的源。
4
-
5
- ## 初始化
6
-
7
- CLI 免安装:指南命令以 `tbox-app` 短名书写;任意 `tbox-app <cmd>` 均可换成 `npx --yes @tbox.cn/app-cli <cmd>` 直接运行(`--yes` 跳过 npx 首次安装确认)。
8
-
9
- 在沙箱 `/workspace` 中直接初始化当前目录,不要把应用生成到新的子目录。Support 模板不发 npm——create 源为 tbox-app 仓本地目录,路径须 cwd 可达(绝对路径或正确的相对路径):
10
-
11
- ```sh
12
- tbox-app create . --name my-support --source <tbox-app 仓>/templates/template-agent-support
13
- pnpm install
14
- ```
15
-
16
- `--name` 会写入根 `package.json.name`。初始化会用应用模板的 `AGENTS.md` 覆盖 starter 的 `AGENTS.md`,但会保留 `.git`、`.agents/skills` 中的非冲突内容以及其他未被模板声明的文件。
17
-
18
- ## Support 模板
19
-
20
- 应用模板:`@tbox.cn/app-template-agent-support`(不发 npm——create 源为 tbox-app 仓本地目录 `templates/template-agent-support`)。模板提供浏览器与支付宝小程序 web-view 共用的客服对话壳,内置 support 私有契约、`module-support-core` 骨架和客服 FAQ skill。
21
-
22
- 模板为答疑、知识检索、澄清确认和受策略约束的读写动作预留统一 support 契约;真实写动作必须经过持久 plan/binding、幂等和审计或 Provider 权威收口。人工承接只保留可替换的 prepare 入口,一期不接入实际人工服务。不要把 mall 业务模块、`contracts-mall` 或第三方 provider 直接加入客服应用,也不要在客户端暴露内部工具调用、调试信息或原始错误。
23
-
24
- 常用流程:
25
-
26
- ```sh
27
- pnpm install
28
- tbox-app module doctor
29
- pnpm dev
30
- ```
31
-
32
- 需要重新查看本指南时运行:
33
-
34
- ```sh
35
- tbox-app starter --type agent-support
36
- ```
37
-
38
- 模块形态、装配锚点、鉴权和凭证规则以生成应用中的 `AGENTS.md` 与 `ENV.md` 为准;凭证只使用 `credentialRef` 或平台环境注入,不写入应用源码。