@tianacloud/agent-skills 0.3.2 → 0.3.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tianacloud/agent-skills",
-  "version": "0.3.2",
+  "version": "0.3.3",
   "description": "Tiana Cloud Skills for accounts, SQLite, Git and Web applications",
   "license": "MIT",
   "repository": {

package/plugin.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
   "name": "tiana",
-  "version": "0.3.2",
+  "version": "0.3.3",
   "description": "Tiana Cloud account, SQLite, Git and Web application workflows",
   "author": {
     "name": "Tiana Cloud",

package/skills/tiana/SKILL.md

@@ -4,7 +4,7 @@ description: 使用 Tiana Cloud 管理实例、安装 CLI、登录和恢复账
 license: MIT
 metadata:
   author: Tiana Cloud
-  version: "0.3.2"
+  version: "0.3.3"
   source: https://github.com/tianacloud/agent-skills/tree/main/skills/tiana
 ---
 
@@ -14,7 +14,7 @@ metadata:
 
 ## 每次调用的更新检查
 
-CLI 可用后，执行 `tiana version check --skills-version 0.3.2 --json`，传入本次实际加载的 metadata.version。只在 `should_notify=true` 时简短提醒可用版本并询问是否升级；用户稍后再升级时继续原任务。检查不可用也继续任务。本地 CLI 统一控制检查缓存和 24 小时一次提醒，无需自行记忆或计时。用户确认后的升级及重载见[开始使用](references/getting-started.md#更新)。
+CLI 可用后，执行 `tiana version check --skills-version 0.3.3 --json`，传入本次实际加载的 metadata.version。只在 `should_notify=true` 时简短提醒可用版本并询问是否升级；用户稍后再升级时继续原任务。检查不可用也继续任务。本地 CLI 统一控制检查缓存和 24 小时一次提醒，无需自行记忆或计时。用户确认后的升级及重载见[开始使用](references/getting-started.md#更新)。
 
 ## 选择工作流程
 

package/skills/tiana-git/SKILL.md

@@ -4,7 +4,7 @@ description: 使用 Tiana Git 管理 Git 实例和原生仓库，关联项目远
 license: MIT
 metadata:
   author: Tiana Cloud
-  version: "0.3.2"
+  version: "0.3.3"
   parent: tiana
   source: https://github.com/tianacloud/agent-skills/tree/main/skills/tiana-git
 ---
@@ -15,7 +15,7 @@ metadata:
 
 ## 每次调用的更新检查
 
-CLI 可用后执行 `tiana version check --skills-version 0.3.2 --json`，使用本次加载的 metadata.version。仅在 `should_notify=true` 时提醒并询问是否升级；用户稍后或检查不可用时继续原任务。升级和会话重载见 [开始使用](../tiana/references/getting-started.md#更新)。CLI 控制共同的 24 小时提醒额度。
+CLI 可用后执行 `tiana version check --skills-version 0.3.3 --json`，使用本次加载的 metadata.version。仅在 `should_notify=true` 时提醒并询问是否升级；用户稍后或检查不可用时继续原任务。升级和会话重载见 [开始使用](../tiana/references/getting-started.md#更新)。CLI 控制共同的 24 小时提醒额度。
 
 ## 实例与仓库
 

package/skills/tiana-git/references/source-releases.md

@@ -1,6 +1,6 @@
-# 应用源码与版本发布
+# 应用源码与发布
 
-创建 Tiana 应用或发布应用版本时使用此流程。根据下方用户对源码托管的选择，一个版本包含 Tiana Git 中的源码快照及对应的托管构建产物。
+创建或发布 Tiana 应用时使用此流程。按用户选择同步源码，从确定的 Git 提交构建并发布当前归档；源码关联通过 MGR Web 项目参数记录。
 
 ## 准备 Git 客户端
 
@@ -17,7 +17,7 @@
 | 已有仓库托管在 GitHub、Gitee 或其他外部服务 | 创建 Tiana 仓库或向其上传源码前，询问一次。 |
 | 现有项目的仓库归属或托管选择不明确 | 首次上传前确认目标源码仓库。 |
 
-对于外部仓库，说明拟操作的范围：“是否同时将这个应用的源码托管到 Tiana Git，并随每次应用发布同步？现有仓库和远程配置会保留。”获得答复前，不上传源码或发布与之关联的托管版本；本地开发可以继续。在项目交付记录中保存批准或拒绝的结果。用户拒绝时，将源码保留在现有托管平台，按用户选择的范围发布，并说明未启用 Tiana 源码托管。单仓多应用中，对一个应用的批准不包含上传无关项目或整个仓库历史。
+对于外部仓库，说明拟操作的范围：“是否同时将这个应用的源码托管到 Tiana Git，并随每次应用发布同步？现有仓库和远程配置会保留。”获得答复前，不上传源码或发布与之关联的应用；本地开发可以继续。在项目交付记录中保存批准或拒绝的结果。用户拒绝时，将源码保留在现有托管平台，按用户选择的范围发布，并说明未启用 Tiana 源码托管。单仓多应用中，对一个应用的批准不包含上传无关项目或整个仓库历史。
 
 ## 关联仓库
 
@@ -42,14 +42,14 @@ git remote add tiana 'tiana://HOST:PORT/repo.git'
 ## 发布对应源码的当前内容
 
 1. 提交应用源码、构建配置、锁文件、SQL 和迁移。生成物只包含模块与资源，不含 tiana.app.json。应用源码提交和推送仍须在用户授权范围内；验证远端分支/标签确实指向将要构建的提交，不改写已分配的源码引用。
-2. 从干净、已确认的源码提交构建，六个脚本接收完整小写 40/64 位提交号，检查 Git ID 格式并输出 `TIANA_PROJECT_PARAMS` 供调用方录入；这些参数不会写进 dist。脚本检查格式，调用方核验真实源码和远端提交。不得只修改参数冒充重新构建。
+2. 从干净、已确认的源码提交按工程 README 构建。用实际 Git ID 和完整小写 40/64 位提交号更新项目参数；若构建脚本输出 `TIANA_PROJECT_PARAMS`，核对其值与真实源码及远端提交一致。项目参数不写进 dist。不得只修改参数冒充重新构建。
 3. 新建项目：`tiana web create NAME --entry assets/app.js --database-instance-id DB_ID --git-instance-id GIT_ID --source-commit FULL_HASH --json`。既有项目先读取最新 project_revision，再用 `tiana web update WEB_ID --expected-revision REV --git-instance-id GIT_ID --source-commit FULL_HASH --json`。Git ID 可先绑定、commit 可暂缺；commit 非空时必须有 Git。entry 创建后不可修改，没有 styles/rendering/routing 字段。
 4. 发布该提交产物：`tiana web publish WEB_ID --dir DIST --json`，保存 publish_id 和归档 SHA256，随后 `tiana web status WEB_ID --publish-id PUBLISH_ID --json` 确认 ACTIVATED 和 serving_sha256。项目参数和归档分别更新，MGR 不管理发布。参数更新成功但文件发布失败时报告部分完成；不伪称源码、项目参数、S3 对象原子一致。
 5. 保存 Web/实例 ID、Git ID、远端引用、源码 commit、publish_id、校验和及托管链接。没有 Web 版本列表或恢复接口；Git 源码历史由 Git 管理。发布结果未知时只查询，禁止自动重放 PUT。用户不采用 Tiana Git 时保留原托管平台，不填写虚构关联。
 
 ## 构建时传入源码提交
 
-账单、记事本、日历、学习、备孕和白板这六个应用模板统一由命令工具执行 Git，构建脚本接收完整提交号并生成产物。`source.json` 保留 Git 实例 ID；提交号随 TIANA_PROJECT_PARAMS 输出，作为 MGR 命令参数录入，不进入归档。在应用仓库根目录完成依赖安装和源码提交后，使用当前命令工具对应的一组命令。
+先读取下载工程的 README 和构建脚本。以下示例适用于接收 `SOURCE_COMMIT` 的 `scripts/build.mjs`：由命令工具执行 Git，`source.json` 保留 Git 实例 ID，提交号随 TIANA_PROJECT_PARAMS 输出，作为 MGR 命令参数录入，不进入归档。在应用仓库根目录完成依赖安装和源码提交后，使用当前命令工具对应的一组命令；其他工程使用自己的构建命令。
 
 Bash：
 
@@ -86,4 +86,4 @@ if ($buildStatus -or $buildCommit -ne $sourceCommit) { throw '构建期间源码
 
 记录失败的具体层级和原始错误：命令工具启动失败、npm 生命周期失败、Node 启动 Git 失败、Vite/esbuild 启动失败是不同阶段。`EBUSY` 等 `spawn` / `execFileSync` 错误本身不能证明是沙箱或本机策略，只有明确的策略拒绝才能据此归因。没有环境变化时，不盲目重复同一命令。
 
-模板构建不再需要 Node 启动 Git，但 Vite/esbuild 仍可能需要子进程；这不保证整个构建能在禁止所有子进程的环境中运行。明确禁止执行的操作交由获准的构建环境完成。若旧应用仍在构建脚本中调用 Git，先按该应用的实际构建步骤修改源码并提交，再从新提交构建；保留它的其他生成逻辑，不临时拆解“等价构建”、手填产物清单或删除源码核验来宣称完成。
+上述构建示例由命令工具读取 Git 提交，但 Vite/esbuild 仍可能需要子进程；这不保证整个构建能在禁止所有子进程的环境中运行。明确禁止执行的操作交由获准的构建环境完成。若旧应用仍在构建脚本中调用 Git，先按该应用的实际构建步骤修改源码并提交，再从新提交构建；保留它的其他生成逻辑，不临时拆解“等价构建”、手填产物清单或删除源码核验来宣称完成。

package/skills/tiana-sqlite/SKILL.md

@@ -4,7 +4,7 @@ description: 查询 Tiana SQLite 表结构、执行 SQL、选择数据库分支
 license: MIT
 metadata:
   author: Tiana Cloud
-  version: "0.3.2"
+  version: "0.3.3"
   parent: tiana
   source: https://github.com/tianacloud/agent-skills/tree/main/skills/tiana-sqlite
 ---
@@ -15,7 +15,7 @@ metadata:
 
 ## 每次调用的更新检查
 
-CLI 可用后执行 `tiana version check --skills-version 0.3.2 --json`，使用本次加载的 metadata.version。仅在 `should_notify=true` 时提醒并询问是否升级；用户选择稍后或检查不可用时继续原任务。用户确认后的升级和重载见 [开始使用](../tiana/references/getting-started.md#更新)。CLI 管理共同的 24 小时提醒额度。
+CLI 可用后执行 `tiana version check --skills-version 0.3.3 --json`，使用本次加载的 metadata.version。仅在 `should_notify=true` 时提醒并询问是否升级；用户选择稍后或检查不可用时继续原任务。用户确认后的升级和重载见 [开始使用](../tiana/references/getting-started.md#更新)。CLI 管理共同的 24 小时提醒额度。
 
 ## 查询与命令行
 

package/skills/tiana-sqlite/references/js-sdk.md

@@ -12,12 +12,12 @@
 
 ## 核验目标托管环境
 
-以下步骤用于用户要求浏览器验证或排查托管连接故障时。六个应用模板的常规交付以构建与 CLI 发布状态核验完成，交互由用户检查；不主动执行以下浏览器步骤。
+以下步骤用于用户要求浏览器验证或排查托管连接故障时。模板应用的常规交付以构建与 CLI 发布状态核验完成，交互由用户检查；不主动执行以下浏览器步骤。
 
 配套托管运行时已实现账号 provider；文档中的能力要求不是对所有环境“尚未部署”的判定。同一任务已有目标部署、登录会话和应用数据库的有效验证结果时直接复用，环境变化或出现具体失败时再核验。
 
 1. 在目标托管页面完成登录并等待 Bootstrap 初始化，检查 `typeof window.tiana?.auth?.getAccessToken === 'function'` 和 `typeof window.tiana?.connection === 'function'`。检查页面实际加载的 Bootstrap 源码可辅助确认接口已提供，但不能仅凭文件中的字符串、行号或 HTTP 200 宣称运行成功；登录页响应也不是 Bootstrap 缺失。
-2. 调用 `connection()` 核对目标数据库和协议；六个应用模板使用 `hrana-v3`。通过下文共享 provider/SDK 通道执行只读 `SELECT 1 AS ready`，同时检查 HTTP、SQL 语句结果和返回值。仅报告接口是否存在、协议与只读结果，不输出 access token 或整个连接对象。不用 CLI SQL 或本地预览成功替代托管页面验证。
+2. 调用 `connection()` 核对目标数据库和 `sql_api`，按实际返回值选择对应协议。通过下文共享 provider/SDK 通道执行只读 `SELECT 1 AS ready`，同时检查 HTTP、SQL 语句结果和返回值。仅报告接口是否存在、协议与只读结果，不输出 access token 或整个连接对象。不用 CLI SQL 或本地预览成功替代托管页面验证。
 3. 接口与只读查询通过后继续正常发布和验收，不再引用历史部署提醒报告阻塞。仅在实际确认接口缺失时报告运行时能力阻塞；登录、网络、授权或 SQL 失败分别按实际错误处理，不能一概归因为 Bootstrap 未升级。没有目标页面或浏览器验证能力时记录“托管运行时未验证”，继续可完成的构建及已授权发布步骤，并在取得托管入口后验收；未验证不能写成“已连通”或“确认未部署”。
 
 这个只读检查验证当前会话的数据读取链路。应用写入、刷新后的持久化和具体交互由用户检查；它不证明未来刷新或所有写操作都成功。

package/skills/tiana-web/SKILL.md

@@ -4,7 +4,7 @@ description: 使用 Tiana 创建、修改、预览和发布 Web 应用。用户
 license: MIT
 metadata:
   author: Tiana Cloud
-  version: "0.3.2"
+  version: "0.3.3"
   parent: tiana
   source: https://github.com/tianacloud/agent-skills/tree/main/skills/tiana-web
 ---
@@ -15,7 +15,7 @@ metadata:
 
 ## 每次调用的更新检查
 
-CLI 可用后执行 `tiana version check --skills-version 0.3.2 --json`，使用实际加载的 metadata.version。仅在 `should_notify=true` 时提醒并询问是否升级；用户稍后或检查不可用时继续应用任务。升级及重载见 [开始使用](../tiana/references/getting-started.md#更新)。24 小时提醒额度由 CLI 统一管理。
+CLI 可用后执行 `tiana version check --skills-version 0.3.3 --json`，使用实际加载的 metadata.version。仅在 `should_notify=true` 时提醒并询问是否升级；用户稍后或检查不可用时继续应用任务。升级及重载见 [开始使用](../tiana/references/getting-started.md#更新)。24 小时提醒额度由 CLI 统一管理。
 
 ## 每次任务必须查询当前模板目录
 

package/skills/tiana-web/references/csr-apps.md

@@ -10,7 +10,7 @@
 
 应用与 Console 使用独立 origin；同一环境的多个应用共享站点 origin，路径划分不提供浏览器同源隔离。Bootstrap、session、logout 和 connection 使用站点同源入口。
 
-模板提供 `<div id="app"></div>`。`entry` 指定的模块按正常方式启动并渲染应用。需要数据库连接时，调用 `window.tiana.connection()`；返回的凭据只保存在内存中。加载指示器是临时的，与应用样式隔离。
+模板提供 `<div id="app"></div>`。`entry` 指定的模块按正常方式启动并渲染应用。需要数据库连接时，调用 `window.tiana.connection()` 获取连接元信息，使用 `window.tiana.auth` provider 提供动态凭据；凭据只保存在内存中。加载指示器是临时的，与应用样式隔离。
 
 ## 确认账号与数据库
 
@@ -26,7 +26,7 @@
 
 SDK、参数化 SQL 和结果解析按 [JavaScript 数据库连接](../../tiana-sqlite/references/js-sdk.md)处理。应用必须使用支持 `auth` 的 SDK 和 `window.tiana.auth` provider；`window.tiana.connection()` 用于获取连接元信息。共享 provider 和 adapter，不读取 Token 快照，不保留旧 SDK、旧 Bootstrap 或实例 Token 回退路径。
 
-CLI 本地预览优先复用已保存的 CLI 登录，通过一次性本地启动链接授权浏览器；凭据刷新和持久化锁由 CLI/SDK 负责，refresh token 不交给页面。没有可用的已保存账号时才走独立 Console 登录。配套 Web/MGR 托管 Bootstrap 也提供 `window.tiana.auth`，由现有 HttpOnly 登录会话在服务端取得并同步账号授权。账号/租户级 access token 的权限不局限于应用目标实例，业务代码应在相应信任范围内运行。用户要求验证或排查连接故障时，按 [目标托管环境核验](../../tiana-sqlite/references/js-sdk.md#核验目标托管环境)检查实际 provider 和只读 SQL 链路。六个模板常规发布后由用户检查页面；没有运行时验证结果不等于确认缺失，也不代表链路已连通。
+CLI 本地预览优先复用已保存的 CLI 登录，通过一次性本地启动链接授权浏览器；凭据刷新和持久化锁由 CLI/SDK 负责，refresh token 不交给页面。没有可用的已保存账号时才走独立 Console 登录。配套 Web/MGR 托管 Bootstrap 也提供 `window.tiana.auth`，由现有 HttpOnly 登录会话在服务端取得并同步账号授权。账号/租户级 access token 的权限不局限于应用目标实例，业务代码应在相应信任范围内运行。用户要求验证或排查连接故障时，按 [目标托管环境核验](../../tiana-sqlite/references/js-sdk.md#核验目标托管环境)检查实际 provider 和只读 SQL 链路。模板应用常规发布后由用户检查页面；没有运行时验证结果不等于确认缺失，也不代表链路已连通。
 
 凭据只保存在内存，不写入源码、构建产物或浏览器持久存储。skills 不读取 refresh token、不调用刷新接口、不设置管理地址；刷新和授权同步由 SDK/CLI 或运行时代理处理，部署路由由外围环境负责。鉴权失败不自动重放 SQL，写入结果不明时先用独立只读查询核实。
 
@@ -46,7 +46,7 @@ CLI 本地预览优先复用已保存的 CLI 登录，通过一次性本地启
 
 ## 构建与项目参数
 
-输出浏览器可直接执行的 ES 模块、CSS 和资源，引用使用相对路径。Vite 库模式在顶层配置 `define: { 'process.env.NODE_ENV': JSON.stringify('production') }`，并验证产物无残留引用。六个模板输出 `assets/app.js` 和 `assets/app.css`；入口的 load-style.js 自行加载 CSS。不要生成或读取 tiana.app.json，不提交 style、rendering、routing 参数。
+输出浏览器可直接执行的 ES 模块、CSS 和资源，引用使用相对路径。Vite 库模式在顶层配置 `define: { 'process.env.NODE_ENV': JSON.stringify('production') }`，并验证产物无残留引用。入口与资源路径以实际工程的构建配置为准；入口模块自行加载 CSS。不要生成或读取 tiana.app.json，不提交 style、rendering、routing 参数。
 
 Site 参数来自 MGR 的 web_project：name、description、固定 entry、可选 database_instance_id、git_instance_id、source_commit。实例只保存通用 Serverless 属性。首次创建可传 `--entry assets/app.js --database-instance-id DATABASE_ID --git-instance-id GIT_ID`；Git commit 可以稍后用 `web update ID --expected-revision REV --source-commit FULL_COMMIT` 录入，完整小写 40/64 位 commit 要求已有 Git 绑定。MGR 验证关联实例属于当前租户、产品正确且可用。源码构建和远端引用核验见[源码发布](../../tiana-git/references/source-releases.md)，参数更新与归档发布是分开的操作，不假称两者跨服务原子提交。
 

package/skills/tiana-web/references/template-init.md

@@ -49,4 +49,4 @@ SQL 返回失败、断线或未知结果时停止后续发布，用独立只读
 
 ## 构建和来源
 
-模板 `source.repository`、`source.commit` 说明下载包的源工程来源，区别于用户应用自己的 Git 提交。创建用户仓库后记录实际 git_instance_id；提交和构建按 [源码流程](../../tiana-git/references/source-releases.md)。六个现有模板的构建脚本接收提交号：`node scripts/build.mjs SOURCE_COMMIT`，构建 dist/ 并输出 TIANA_PROJECT_PARAMS，提供 entry、git_instance_id 和 source_commit；用它们配置 MGR Web 项目，数据库绑定也通过管理命令设置；其他模板按自己的 README 构建。核对模块、资源及 MGR Web 项目的 SQLite/Git 绑定后执行 `web publish`，再用 publish_id 查询状态。
+模板 `source.repository`、`source.commit` 说明下载包的源工程来源，区别于用户应用自己的 Git 提交。创建用户仓库后记录实际 git_instance_id；提交和构建按 [源码流程](../../tiana-git/references/source-releases.md)。按下载工程的 README 和构建脚本确定命令、入口与产物目录。若脚本接收源码提交号并输出 TIANA_PROJECT_PARAMS，核对其中的 entry、git_instance_id 和 source_commit，再用于配置 MGR Web 项目；数据库绑定也通过管理命令设置。核对模块、资源及 MGR Web 项目的 SQLite/Git 绑定后执行 `web publish`，再用 publish_id 查询状态。