@tianacloud/agent-skills 1.0.4 → 1.0.5

package/package.json

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

package/plugin.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
   "name": "tiana",
-  "version": "1.0.4",
+  "version": "1.0.5",
   "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: Apache-2.0
 metadata:
   author: Tiana Cloud
-  version: "1.0.4"
+  version: "1.0.5"
   source: https://github.com/tianacloud/agent-skills/tree/main/skills/tiana
 ---
 
@@ -14,7 +14,7 @@ metadata:
 
 ## 每个会话一次的更新检查
 
-四个 Tiana 技能共享当前会话的更新检查记录。CLI 已满足最低版本要求且本会话尚未尝试检查时，执行 `tiana version check --skills-version 1.0.4 --json`，使用实际加载的 metadata.version。调用前在会话上下文中记为已尝试；后续轮次、重复加载或切换技能均复用该记录，检查失败也不自动重试。上下文压缩或任务交接时保留记录，新会话重新检查。
+四个 Tiana 技能共享当前会话的更新检查记录。CLI 已满足最低版本要求且本会话尚未尝试检查时，执行 `tiana version check --skills-version 1.0.5 --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: Apache-2.0
 metadata:
   author: Tiana Cloud
-  version: "1.0.4"
+  version: "1.0.5"
   parent: tiana
   source: https://github.com/tianacloud/agent-skills/tree/main/skills/tiana-git
 ---
@@ -15,7 +15,7 @@ metadata:
 
 ## 每个会话一次的更新检查
 
-四个 Tiana 技能共享当前会话的更新检查记录。CLI 已满足最低版本要求且本会话尚未尝试检查时，执行 `tiana version check --skills-version 1.0.4 --json`，使用实际加载的 metadata.version。调用前在会话上下文中记为已尝试；后续轮次、重复加载或切换技能均复用该记录，检查失败也不自动重试。上下文压缩或任务交接时保留记录，新会话重新检查。
+四个 Tiana 技能共享当前会话的更新检查记录。CLI 已满足最低版本要求且本会话尚未尝试检查时，执行 `tiana version check --skills-version 1.0.5 --json`，使用实际加载的 metadata.version。调用前在会话上下文中记为已尝试；后续轮次、重复加载或切换技能均复用该记录，检查失败也不自动重试。上下文压缩或任务交接时保留记录，新会话重新检查。
 
 仅在 `should_notify=true` 时简短提醒并询问是否升级；用户选择稍后或检查不可用时继续原任务。CLI 仍管理检查缓存和共同的 24 小时提醒额度。升级及重载见[开始使用](../tiana/references/getting-started.md#更新)。
 

package/skills/tiana-sqlite/SKILL.md

@@ -4,7 +4,7 @@ description: 查询 Tiana SQLite 表结构、执行 SQL、选择数据库分支
 license: Apache-2.0
 metadata:
   author: Tiana Cloud
-  version: "1.0.4"
+  version: "1.0.5"
   parent: tiana
   source: https://github.com/tianacloud/agent-skills/tree/main/skills/tiana-sqlite
 ---
@@ -15,7 +15,7 @@ metadata:
 
 ## 每个会话一次的更新检查
 
-四个 Tiana 技能共享当前会话的更新检查记录。CLI 已满足最低版本要求且本会话尚未尝试检查时，执行 `tiana version check --skills-version 1.0.4 --json`，使用实际加载的 metadata.version。调用前在会话上下文中记为已尝试；后续轮次、重复加载或切换技能均复用该记录，检查失败也不自动重试。上下文压缩或任务交接时保留记录，新会话重新检查。
+四个 Tiana 技能共享当前会话的更新检查记录。CLI 已满足最低版本要求且本会话尚未尝试检查时，执行 `tiana version check --skills-version 1.0.5 --json`，使用实际加载的 metadata.version。调用前在会话上下文中记为已尝试；后续轮次、重复加载或切换技能均复用该记录，检查失败也不自动重试。上下文压缩或任务交接时保留记录，新会话重新检查。
 
 仅在 `should_notify=true` 时简短提醒并询问是否升级；用户选择稍后或检查不可用时继续原任务。CLI 仍管理检查缓存和共同的 24 小时提醒额度。升级及重载见[开始使用](../tiana/references/getting-started.md#更新)。
 

package/skills/tiana-web/SKILL.md

@@ -4,7 +4,7 @@ description: 使用 Tiana 创建、修改、预览和发布 Web 应用。用户
 license: Apache-2.0
 metadata:
   author: Tiana Cloud
-  version: "1.0.4"
+  version: "1.0.5"
   parent: tiana
   source: https://github.com/tianacloud/agent-skills/tree/main/skills/tiana-web
 ---
@@ -15,7 +15,7 @@ metadata:
 
 ## 每个会话一次的更新检查
 
-四个 Tiana 技能共享当前会话的更新检查记录。CLI 已满足最低版本要求且本会话尚未尝试检查时，执行 `tiana version check --skills-version 1.0.4 --json`，使用实际加载的 metadata.version。调用前在会话上下文中记为已尝试；后续轮次、重复加载或切换技能均复用该记录，检查失败也不自动重试。上下文压缩或任务交接时保留记录，新会话重新检查。
+四个 Tiana 技能共享当前会话的更新检查记录。CLI 已满足最低版本要求且本会话尚未尝试检查时，执行 `tiana version check --skills-version 1.0.5 --json`，使用实际加载的 metadata.version。调用前在会话上下文中记为已尝试；后续轮次、重复加载或切换技能均复用该记录，检查失败也不自动重试。上下文压缩或任务交接时保留记录，新会话重新检查。
 
 仅在 `should_notify=true` 时简短提醒并询问是否升级；用户选择稍后或检查不可用时继续原任务。CLI 仍管理检查缓存和共同的 24 小时提醒额度。升级及重载见[开始使用](../tiana/references/getting-started.md#更新)。
 
@@ -31,7 +31,8 @@ metadata:
 2. 采用模板时，执行 `tiana web init-template NAME --dir PROJECT_DIR --json`。PROJECT_DIR 是用户项目的不存在目录，位于技能安装目录之外。CLI 下载并原样解压；按 [模板初始化](references/template-init.md)读取工程根部 `metadata.json`，由 Agent 完成全部变量替换及 SQLite 数据初始化。
 3. 直接开发时，使用 [固定 index.html](references/index.html)、哈希路由、支持动态账号鉴权的 SDK，按实际数据库结构编写应用及构建清单。
 4. **模板和直接开发都由 Agent 处理数据库初始化。** 模板先执行已配置且存在的 schema，再执行已配置且存在的 seeds；两项独立跳过，SQL 失败先核对结果并停止后续发布。
-5. 按用户需求完成交互和定制，安装依赖并从确定源码提交构建。按 [源码版本流程](../tiana-git/references/source-releases.md)完成源码同步，用 `web publish` 发布当前归档，再用 `web status --publish-id` 核对。除非用户仅要求本地开发，交付实际托管地址、资源 ID 和对应源码提交；未验证的阶段如实说明。
+5. 构建前准备应用图标：用户明确提供图片时使用它，否则复用源码已有 `icon.png`（包括模板的 `public/icon.png`）；源码缺图时由 Agent 按标题自动生成汉字／字母加固定配色的真实 PNG，保存到源码，并确保产物根目录有 `icon.png`。查看图片并核验干净构建，细节见[应用图标](references/csr-apps.md#应用图标)。
+6. 按用户需求完成交互和定制，安装依赖并从确定源码提交构建。按 [源码版本流程](../tiana-git/references/source-releases.md)完成源码同步，用 `web publish` 发布当前归档，再用 `web status --publish-id` 核对。除非用户仅要求本地开发，交付实际托管地址、资源 ID 和对应源码提交；未验证的阶段如实说明。
 
 ## 文件上传、预览与下载
 

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

@@ -54,6 +54,16 @@ CLI 将目录打包为 ZIP Store/Deflate 的一个 `.tweb`，根目录是零字
 
 归档和原始资源总量各最多 16 MiB、最多 4096 个资源、单路径最多 1024 个 UTF-8 字节；拒绝符号链接、特殊文件和旧清单。publish 上传前检查实际归档含固定 entry。资源 URL 为 `/web/<id>/assets/<relative_file>`；例如归档内的 `assets/app.js` 对应 `/web/<id>/assets/assets/app.js`，路由前缀与文件目录各保留一层。经过 Web→Gateway→Agent→app_web，不生成 OSS 签名直链。channel=0 透传原生 GET/HEAD，channel=1 提供 publish/status 等 HTTP 管控，协议版本保持不变。
 
+## 应用图标
+
+构建前检查工程根的 `icon.png` 和工程实际采用的静态资源目录，如 `public/icon.png`；依赖包和旧 dist 内的图片不算源码。用户本次明确提供新图片时使用它，否则直接复用源码图片，包括模板自带的图标，不因应用改名或每轮修改重新生成。
+
+源码没有图标时，由执行任务的 Agent 自动生成真实 PNG：按应用标题取首个汉字或英文首字母，搭配固定配色，建议 256×256 正方形。可用 Canvas／本地图像工具绘制，汉字选择可用的中文字体，查看图片确认文字清晰、没有缺字；不把准备图片转交给用户，也不把文字预览、SVG 改扩展名当作 PNG。
+
+图片写入源码静态资源目录，再使用现有构建复制能力将它输出到产物根目录 `icon.png`；工程没有复制能力时补充直接的构建步骤。先准备源图片、提交，再从确定提交干净构建。发布前检查产物图片能解码，确认现有 CLI 打包后为 `data/icon.png`；无需新增 CLI 参数。
+
+配套图标服务部署后，每次发布含图标的包都会覆盖应用的独立管理图标；包里没有图标时保留当前图片。Console 单独上传不改写源码，后续含图标的发布仍以包内图片覆盖；用户要持续更换图标时同步修改源码。独立图标可在应用休眠或停用时读取，本地构建验证与目标环境的展示验收分别记录。
+
 ## 预览与发布
 
 需要源码关联时，先按[应用源码与版本发布](../../tiana-git/references/source-releases.md)完成已授权的 Git 同步，再构建该提交的产物。纯个人静态站无需数据库或 Git 实例。

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

@@ -55,6 +55,10 @@ JSON 中要正确转义字符串，SQL 中按实际语法处理，源码中保
 
 SQL 返回失败、断线或未知结果时停止后续发布，用独立只读查询核对已完成的结构与数据，不自动重放写入。初始化成功后进行应用定制、依赖安装、源码同步、构建及发布；工程 README 中的步骤与实际帮助一起核对。
 
+## 模板图标
+
+模板的源 `icon.png` 是用户应用的初始图标，保留图片并复用工程的静态资源复制配置。变量替换时不把 PNG 当文本处理。若下载模板没有源图标，按[应用图标](csr-apps.md#应用图标)由 Agent 自动生成并保存。干净构建后确认产物根目录 `icon.png` 可以解码，再发布；以后更新模板本身不会直接改变已有用户应用的图标。
+
 ## 构建和来源
 
 模板 `source.repository`、`source.commit` 说明下载包的源工程来源，区别于用户应用自己的 Git 提交。创建用户仓库后记录实际 git_instance_id；提交和构建按 [源码流程](../../tiana-git/references/source-releases.md)。按下载工程的 README 和构建脚本确定命令、入口与产物目录。若脚本接收源码提交号并输出 TIANA_PROJECT_PARAMS，核对其中的 entry、database_instance_id、git_instance_id 和 source_commit，再用于配置 MGR Web 项目；database_instance_id 必须与本次执行 schema/seeds 的 SQLite 一致。核对模块、资源及 MGR Web 项目的 SQLite/Git 绑定后执行 `web publish`，再用 publish_id 查询状态。