ai-yuca 1.5.5 → 1.6.2

package/.claude/skills/ai-yuca/SKILL.md

@@ -0,0 +1,61 @@
+---
+name: ai-yuca
+description: Use this skill whenever working in the AI-Yuca repository or helping with its CLI commands, docs, deployment flow, GCP upload/download, image tools, icon font generation, ico generation, i18n/Crowdin helpers, or project release/versioning rules.
+---
+
+# AI-Yuca Repository Skill
+
+## When To Use
+
+Use this skill for tasks involving:
+
+- Adding, changing, or documenting `ai-yuca` CLI commands.
+- Working with GCP upload/download, `upload-config`, or `deploy`.
+- Updating resource tools such as `sharp`, `tinify`, `zip-anim`, `svg-fix`, `font`, or `ico`.
+- Updating i18n/Crowdin helpers such as `transKey`, `useTrans`, `gkeys`, `cr-pull`, or `cr-push`.
+- Preparing releases, README updates, CHANGELOG entries, or version bumps.
+
+## Repository Map
+
+- `bin/cli.ts`: CLI command registration and option parsing.
+- `src/*.ts`: command implementations.
+- `src/types/*.ts`: command option and result types.
+- `src/config.ts`: `vs.config.json` schema helpers.
+- `dist/`: compiled output from `npm run build`.
+- `docs/`: longer user-facing documentation.
+- `README.md`: primary public usage guide.
+- `CHANGELOG.md`: release notes.
+- `vs.config.json`: local/example project configuration.
+
+## Workflow
+
+1. Inspect the relevant command in `bin/cli.ts`.
+2. Inspect the implementation in `src/` and types in `src/types/`.
+3. Make the smallest change that matches existing project style.
+4. Update user-facing docs for behavior or option changes.
+5. For functional changes, bump patch/minor/major version and add a CHANGELOG entry.
+6. Run `npm run build`.
+7. Run targeted CLI smoke checks when practical, for example:
+
+```bash
+node dist/bin/cli.js --help
+node dist/bin/cli.js font --help
+```
+
+## Release And Version Rules
+
+Functional code changes require:
+
+- `package.json` version update.
+- `package-lock.json` version update.
+- `CHANGELOG.md` entry for the new version.
+
+Documentation-only changes do not need a version bump.
+
+## Cautions
+
+- Do not edit `dist/` directly. Rebuild.
+- Do not remove unrelated user changes from `.gitignore`, `README.md`, or local configuration files.
+- Do not expose real API keys, GCP service account content, or webhook secrets.
+- `vs.config.json` can include local project values; treat secrets conservatively.
+

package/.cline/rules/ai-yuca.md

@@ -0,0 +1,11 @@
+# AI-Yuca Rules
+
+When working in this repository:
+
+- Read `AGENTS.md` first.
+- Prefer existing CLI and module patterns.
+- Update docs and changelog for user-facing behavior.
+- Bump package versions for functional changes.
+- Run `npm run build` after TypeScript edits.
+- Do not expose or commit credentials.
+

package/.cursor/rules/ai-yuca.mdc

@@ -0,0 +1,21 @@
+---
+description: AI-Yuca repository conventions for CLI, docs, config, and releases.
+globs:
+  - "**/*"
+alwaysApply: true
+---
+
+# AI-Yuca Rules
+
+AI-Yuca is a TypeScript Node.js CLI. Follow these conventions:
+
+- Register CLI commands in `bin/cli.ts`.
+- Put command implementations in `src/`.
+- Put command option/result types in `src/types/`.
+- Update `src/config.ts` for `vs.config.json` schema changes.
+- Update `README.md` and `CHANGELOG.md` for user-facing behavior changes.
+- Bump `package.json` and `package-lock.json` for functional changes.
+- Run `npm run build` after TypeScript changes.
+- Rebuild generated `dist/` output; do not edit `dist/` manually.
+- Do not commit credentials, local caches, or local IDE/agent state.
+

package/.github/workflows/version-check.yml

@@ -0,0 +1,30 @@
+name: Version & Changelog Check
+
+on:
+  pull_request:
+    branches:
+      - main
+      - master
+
+jobs:
+  version-check:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Fetch base branch
+        run: git fetch origin "${{ github.base_ref }}" --depth=1
+
+      - name: Setup Node
+        uses: actions/setup-node@v4
+        with:
+          node-version: 20
+
+      - name: Verify version bump & changelog
+        run: node scripts/check-version-bump.js
+        env:
+          BASE_REF: origin/${{ github.base_ref }}
+

package/.idea/ai-yuca.iml

@@ -0,0 +1,12 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<module type="WEB_MODULE" version="4">
+  <component name="NewModuleRootManager">
+    <content url="file://$MODULE_DIR$">
+      <excludeFolder url="file://$MODULE_DIR$/.tmp" />
+      <excludeFolder url="file://$MODULE_DIR$/temp" />
+      <excludeFolder url="file://$MODULE_DIR$/tmp" />
+    </content>
+    <orderEntry type="inheritedJdk" />
+    <orderEntry type="sourceFolder" forTests="false" />
+  </component>
+</module>

package/.idea/claudeCodeTabState.xml

@@ -0,0 +1,34 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="ClaudeCodeTabState">
+    <option name="tabSessions">
+      <map>
+        <entry key="0">
+          <value>
+            <TabSessionState>
+              <option name="provider" value="codex" />
+              <option name="sessionId" value="019e252d-ca1c-7f33-850b-c6c31adb3871" />
+              <option name="cwd" value="$PROJECT_DIR$" />
+              <option name="model" value="gpt-5.5" />
+              <option name="permissionMode" value="default" />
+              <option name="reasoningEffort" value="high" />
+            </TabSessionState>
+          </value>
+        </entry>
+        <entry key="1">
+          <value>
+            <TabSessionState>
+              <option name="provider" value="codex" />
+              <option name="sessionId" value="019e2533-5257-7d82-bb0e-647740eabce8" />
+              <option name="cwd" value="$PROJECT_DIR$" />
+              <option name="model" value="gpt-5.5" />
+              <option name="permissionMode" value="default" />
+              <option name="reasoningEffort" value="high" />
+            </TabSessionState>
+          </value>
+        </entry>
+      </map>
+    </option>
+    <option name="tabCount" value="2" />
+  </component>
+</project>

package/.idea/inspectionProfiles/Project_Default.xml

@@ -0,0 +1,6 @@
+<component name="InspectionProjectProfileManager">
+  <profile version="1.0">
+    <option name="myName" value="Project Default" />
+    <inspection_tool class="Eslint" enabled="true" level="WARNING" enabled_by_default="true" />
+  </profile>
+</component>

package/.idea/modules.xml

@@ -0,0 +1,8 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="ProjectModuleManager">
+    <modules>
+      <module fileurl="file://$PROJECT_DIR$/.idea/ai-yuca.iml" filepath="$PROJECT_DIR$/.idea/ai-yuca.iml" />
+    </modules>
+  </component>
+</project>

package/.idea/vcs.xml

@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="VcsDirectoryMappings">
+    <mapping directory="" vcs="Git" />
+  </component>
+</project>

package/.mcp.json

@@ -0,0 +1,21 @@
+{
+  "mcpServers": {
+    "filesystem-ai-yuca": {
+      "command": "npx",
+      "args": [
+        "-y",
+        "@modelcontextprotocol/server-filesystem",
+        "/Users/yucang/Desktop/ai-project/ai-yuca"
+      ]
+    },
+    "git-ai-yuca": {
+      "command": "uvx",
+      "args": [
+        "mcp-server-git",
+        "--repository",
+        "/Users/yucang/Desktop/ai-project/ai-yuca"
+      ]
+    }
+  }
+}
+

package/.windsurf/rules/ai-yuca.md

@@ -0,0 +1,13 @@
+# AI-Yuca Workspace Rules
+
+Use `AGENTS.md` as the primary repository instruction file.
+
+Project conventions:
+
+- TypeScript source lives in `src/`.
+- CLI registration lives in `bin/cli.ts`.
+- Compiled output lives in `dist/` and should be regenerated with `npm run build`.
+- User-facing command changes need README and CHANGELOG updates.
+- Functional changes need version bumps in `package.json` and `package-lock.json`.
+- Avoid committing credentials, local cache files, and personal editor or agent settings.
+

package/.windsurf/skills/ai-yuca/SKILL.md

@@ -0,0 +1,18 @@
+---
+name: ai-yuca
+description: Use when editing or explaining the AI-Yuca CLI repository, including commands, configuration, docs, deployment, GCP storage workflows, resource processing, icon generation, i18n/Crowdin helpers, and release/version rules.
+---
+
+# AI-Yuca Skill
+
+AI-Yuca is a TypeScript Node.js CLI. Use the same workflow as other AI agents in this repo:
+
+- Read `AGENTS.md` first for repository-wide instructions.
+- Use `bin/cli.ts` for command registration.
+- Use `src/` for implementations and `src/types/` for command types.
+- Update `README.md` and `CHANGELOG.md` for user-facing changes.
+- Bump `package.json` and `package-lock.json` for functional changes.
+- Run `npm run build` after TypeScript edits.
+
+Known commands include `upload`, `download`, `upload-config`, `deploy`, `sharp`, `tinify`, `zip-anim`, `svg-fix`, `font`, `ico`, `gkeys`, `transKey`, `useTrans`, `cr-pull`, `cr-push`, `analyze`, and `lg`.
+

package/AGENTS.md

@@ -0,0 +1,43 @@
+# AI-Yuca Agent Instructions
+
+Use these instructions when working on this repository with AI coding tools.
+
+## Project Context
+
+AI-Yuca is a TypeScript Node.js CLI for frontend release workflows, static asset processing, Google Cloud Storage upload/download, deployment configuration, image compression, icon font generation, favicon generation, and i18n/Crowdin helpers.
+
+The CLI entrypoint is `bin/cli.ts`; command implementations live in `src/`; compiled output lives in `dist/`.
+
+## Common Commands
+
+```bash
+npm install
+npm run build
+npm test
+npm run lint
+npm run dev -- --help
+node dist/bin/cli.js --help
+```
+
+## Engineering Rules
+
+- Prefer existing CLI patterns in `bin/cli.ts` and module patterns in `src/*.ts`.
+- Keep command option types under `src/types/` and export them from `src/types/index.ts` when needed.
+- Update `README.md` and `CHANGELOG.md` when adding or changing user-facing CLI behavior.
+- Keep `README.md` focused on installation and user-facing command usage only. Do not put contributor rules, AI-agent rules, internal development notes, or operational cautions there.
+- Put repository rules, development cautions, AI workflow instructions, and MCP/Skill guidance in `AGENTS.md`, `docs/ai-dev-tools.md`, and the tool-specific rule/skill files.
+- When functionality is added, changed, removed, or behavior changes, update the relevant user-facing install/usage/config examples in `README.md` in the same change.
+- When `package.json` version changes, check whether README usage or capability descriptions need to be updated.
+- Bump `package.json` and `package-lock.json` for functional changes. The repository uses `scripts/check-version-bump.js` to enforce this.
+- Run `npm run build` after TypeScript changes.
+- If generated `dist/` files are committed in the current workflow, rebuild instead of editing `dist/` manually.
+- Do not commit local credentials, service account files, cache files, `.idea/`, `.vscode/`, or local `.claude/settings.local.json`.
+
+## Current Known Test Issues
+
+At the time this instruction was written, `npm test` has known failures unrelated to recent documentation/config changes:
+
+- `test/download.test.ts` and `test/upload.test.ts` attempt to stub `fs.existsSync`, which is non-configurable in the current runtime.
+- `test/index.test.ts` expects word count `9`, while `analyzeContent` currently returns `10` for the fixture text.
+
+Still run tests when relevant and report these failures clearly if they remain.

package/CHANGELOG.md

@@ -0,0 +1,31 @@
+## [Unreleased]
+
+## [1.6.2] - 2026-05-20
+
+### Added
+- 新增 `proxy-upload-image` 命令，通过项目代理接口 `/proxy-upload/gcp-image` 上传本地图片到 GCP，并返回可直接使用的图片链接。
+
+## [1.6.1] - 2026-05-14
+
+### Added
+- `font` 命令支持通过 `vs.config.json` 的 `font.styleTypes` 控制最终生成的样式文件类型
+- `font.styleTypes` 支持 `css`、`less`、`module.less`、`scss`、`sass`、`styl`、`stylus`，其中 `sass` 映射为 `.scss`
+- 新增主流 AI 开发工具配置文档、项目级 Agent 指令、Skill/Rules 模板和 MCP 配置模板
+
+## [1.6.0] - 2026-05-14
+
+### Added
+- 新增 `ico` 命令：支持将单个 png、jpg、jpeg、svg、webp 图标转换为 `.ico` 文件
+- `ico` 命令支持尺寸设置，可通过逗号传入多尺寸，例如 `16,32,48,64,128,256`
+- `ico` 命令默认按原文件同目录同名输出，也支持自定义输出目录或完整输出路径
+
+## [1.5.7] - 2026-05-14
+
+### Added
+- 增加版本管理规则与 CI 校验，确保每次功能变更同步更新 package.json 版本号并记录更新日志
+- deploy 发布成功后增加飞书机器人通知（包含版本号、项目名、更新时间、环境、分支等）
+- 新增 font 命令：基于 svgtofont 生成字体库，支持通过 vs.config.json 配置输入/输出与前缀
+
+### Changed
+- tinify 批量压缩：如果 zip 目录已存在对应文件则跳过，避免重复压缩与配额消耗
+- 测试脚本排除 font 生成产物（避免将生成的 .d.ts 误作为测试文件执行）

package/CONTRIBUTING.md

@@ -39,6 +39,56 @@ npm run lint
 4. 推送到分支 (`git push origin feature/amazing-feature`)
 5. 打开一个Pull Request
 
+## 版本管理（强制）
+
+本项目采用语义化版本号（SemVer）三段式格式：`主版本号.次版本号.修订号`。
+
+### 核心要求
+
+每当项目完成任何功能变更（含 BUG 修复、功能新增、架构重构等所有代码改动），必须同步更新 `package.json` 内的 `version` 字段，并在 `CHANGELOG.md` 中记录本次变更。
+
+### 版本号递增规则
+
+- **BUG 修复 / 小改动**：仅将修订号（第三段）加 1  
+  - 示例：`1.2.3` → `1.2.4`
+- **新增功能 / 新增命令（向下兼容）**：将次版本号（第二段）加 1  
+  - 示例：`1.2.3` → `1.3.0`
+- **重大重构 / 不兼容变更**：将主版本号（第一段）加 1  
+  - 示例：`1.2.3` → `2.0.0`
+
+### 版本号重置规则
+
+任意一段版本号递增后，其后续所有低位版本号必须统一重置为 `0`：
+
+- `1.2.3`（次版本 +1）→ `1.3.0`
+- `1.2.3`（主版本 +1）→ `2.0.0`
+
+### 更新日志（CHANGELOG）
+
+每次版本更新必须同步在 `CHANGELOG.md` 中新增对应版本条目，并明确写清：
+
+- 版本号
+- 变更类型（例如 Added / Changed / Fixed / Removed）
+- 变更内容要点
+
+### 本地自检
+
+提交前建议在本地执行：
+
+```bash
+npm run build
+npm test
+npm run check:version -- --base-ref origin/main
+```
+
+### CI 强制校验
+
+CI 会在 Pull Request 合入主干前执行版本校验：
+
+- 若检测到有功能性代码变更但未提升 `package.json` 版本号，将直接失败
+- 若版本号提升但未同步更新 `CHANGELOG.md`，将直接失败
+- 若版本号递增不符合三段式 + 重置规则，也将直接失败
+
 ## 功能建议
 
 如果您有新功能的想法，请先开一个issue讨论您想要添加的内容，以确保它符合项目的方向。
@@ -55,4 +105,4 @@ npm run lint
 
 ## 许可证
 
-通过贡献代码，您同意您的贡献将在MIT许可证下发布。
+通过贡献代码，您同意您的贡献将在MIT许可证下发布。