@talesofai/neta-skills 0.16.6 → 0.17.0

package/CHANGELOG.md

@@ -1,5 +1,19 @@
 # @neta/skills-neta
 
+## 0.17.0
+
+### Minor Changes
+
+- Add authenticated user commands: `me` (profile/identity check), `get_ap_info` (AP balance breakdown), `get_ap_history` (cursor-paginated AP transactions), and `list_my_artifacts` (offset-paginated generated media with modality/starred filters)
+- API layer: add `apInfo()`, `apDeltaInfo()` to user APIs; add `listArtifacts()` to artifact APIs
+- Documentation: add "Credits & your artifacts" section to neta-creative SKILL.md (EN/ZH); add reference docs `ap-credits.md` and `my-artifacts.md` (EN/ZH)
+
+## 0.16.7
+
+### Patch Changes
+
+- update config dir path
+
 ## 0.16.6
 
 ### Patch Changes

package/README.md

@@ -69,12 +69,13 @@ npx skills add talesofai/neta-skills/skills/neta-adventure
 
 ### Available Commands
 
-The skill includes **45 commands** for various tasks:
+The skill includes **49 commands** for various tasks:
 
 | Category | Command | Description |
 |----------|---------|-------------|
 | **User** | `login` | Start OAuth device login (`request-code`) or complete it (`verify-code`); stores tokens locally on success |
 | | `logout` | Clear stored CLI session (access token and any in-progress device flow) |
+| | `me` | Show the authenticated user's profile, AP balance, and asset totals |
 | **Adventure Campaigns** | `create_adventure_campaign` | Create an AI-driven interactive story adventure |
 | | `update_adventure_campaign` | Update an existing adventure campaign |
 | | `list_my_adventure_campaigns` | List your created adventure campaigns |
@@ -86,6 +87,10 @@ The skill includes **45 commands** for various tasks:
 | | `edit_collection` | Edit an existing collection (name, description, tags, status, etc.) |
 | | `publish_collection` | Publish or update a collection |
 | | `search_character_or_elementum` | Search reusable TCP building blocks (characters / elements / flows) |
+| | `get_ap_info` | Get detailed AP (Action Points) balance breakdown |
+| | `get_ap_history` | Get paginated AP consumption and recharge history |
+| | `list_my_artifacts` | List your generated media assets with filters |
+| | `upload` | Upload a local or remote media file to create a media artifact |
 | **Premium** | `get_current_premium_plan` | Get the signed-in user’s current tier and subscription end when applicable |
 | | `list_premium_plans` | List available premium plans and SPU UUIDs |
 | | `create_premium_order` | Create an order for a plan (by SPU UUID) |
@@ -299,8 +304,11 @@ pnpm type-check
 # Run lint
 pnpm lint
 
-# Test CLI commands locally
-pnpm dev <command> [options]
+# Test CLI commands locally (commands without extra flags)
+pnpm dev -- <command>
+
+# Subcommands with options: `pnpm` may insert `--` before argv; use the entrypoint directly, e.g.:
+# NODE_ENV=development node src/cli.ts get_ap_history --page_size 5
 
 # Build bin scripts
 pnpm build

package/README.zh_cn.md

@@ -4,7 +4,7 @@
 [![Node](https://img.shields.io/badge/Node-%3E%3D22-green)](https://nodejs.org/)
 [![TypeScript](https://img.shields.io/badge/TypeScript-5.7-blue)](https://www.typescriptlang.org/)
 
-[简体中文](./README.md) · [English](./README.en.md)
+[简体中文](./README.zh_cn.md) · [English](./README.md)
 
 ---
 
@@ -25,6 +25,7 @@
 ## ✨ 功能特性
 
 - 🎨 **多媒体创作**：使用最新的 AI 模型生成图片、视频和歌曲。
+- ⭐ **会员与订阅**：列出套餐、创建订单、发起 Stripe 结账，并通过 CLI 校验当前档位（全球 API 环境）。
 - 🔧 **图像与视频处理**：支持移除背景、视频合并等常见素材处理流程。
 - 👤 **角色与风格管理**：搜索、获取角色与风格元素详情，在创作中标准化复用。
 - 🏷️ **社区与标签集成**：浏览热门标签、空间、玩法合集与角色。
@@ -69,12 +70,13 @@ npx skills add talesofai/neta-skills/skills/zh_cn/neta-adventure
 
 ### 可用指令总览
 
-当前技能共包含 **36 个命令**，覆盖创作、奇遇、角色与社区探索等场景：
+当前技能共包含 **49 个命令**，覆盖用户身份、创作、会员、奇遇、VToken 与社区探索等场景：
 
 | 分类 | 命令 | 说明 |
 |------|------|------|
 | **用户 User** | `login` | OAuth 设备流：默认 `request-code` 发起登录；浏览器完成后用 `verify-code` 换票并写入本地会话 |
 | | `logout` | 清除本地保存的访问令牌及未完成的设备授权状态 |
+| | `me` | 查看当前登录用户的资料、AP 汇总与作品统计 |
 | **奇遇剧本 Adventure** | `create_adventure_campaign` | 创建 AI 驱动的交互式故事冒险剧本 |
 | | `update_adventure_campaign` | 更新已有奇遇剧本 |
 | | `list_my_adventure_campaigns` | 列出你创建的奇遇剧本 |
@@ -86,6 +88,16 @@ npx skills add talesofai/neta-skills/skills/zh_cn/neta-adventure
 | | `edit_collection` | 编辑已有玩法合集（名称、描述、标签、状态等） |
 | | `publish_collection` | 发布或更新玩法合集内容 |
 | | `search_character_or_elementum` | 搜索可复用的 TCP（角色 / 元素 / 玩法模块） |
+| | `get_ap_info` | 查询 AP（电量）余额明细（临时 / 付费 / 无限期等） |
+| | `get_ap_history` | 分页查询 AP 消耗与充值流水（游标分页） |
+| | `list_my_artifacts` | 分页列出你生成的媒体产物，可按类型 / 是否收藏筛选 |
+| | `upload` | 上传本地或远程媒体文件以创建媒体产物 |
+| **会员 Premium** | `get_current_premium_plan` | 查询当前用户档位与订阅到期时间（如适用） |
+| | `list_premium_plans` | 列出可购套餐与 SPU UUID |
+| | `create_premium_order` | 按 SPU 创建订单 |
+| | `get_premium_order` | 查询单笔订单详情 |
+| | `list_premium_orders` | 分页列出订单 |
+| | `pay_premium_order` | 为未支付订单发起支付（如 Stripe Checkout） |
 | **VToken 管理** | `create_character` | 创建角色 VToken（消耗电量） |
 | | `update_character` | 更新现有角色 VToken |
 | | `list_my_characters` | 列出当前用户创建的所有角色 |
@@ -297,8 +309,11 @@ pnpm type-check
 # 代码检查（lint）
 pnpm lint
 
-# 本地调试技能（watch / dev）
-pnpm dev <command> [options]
+# 本地调试（无额外参数时）
+pnpm dev -- <command>
+
+# 带子命令参数时，pnpm 可能在 argv 中插入 `--`，可直接调用入口，例如：
+# NODE_ENV=development node src/cli.ts get_ap_history --page_size 5
 
 # 构建 bin 脚本
 pnpm build

package/bin/apis/artifact.js

@@ -65,6 +65,17 @@ export const createArtifactApis = (client) => {
         })
             .then((res) => res.data);
     };
+    const listArtifacts = async (params) => {
+        const res = await client.get("/v1/artifact/list", {
+            params: {
+                page_index: params?.page_index ?? 0,
+                page_size: params?.page_size ?? 20,
+                modality: params?.modality,
+                is_starred: params?.is_starred,
+            },
+        });
+        return res.data;
+    };
     return {
         makeImage,
         makeVideo,
@@ -76,5 +87,6 @@ export const createArtifactApis = (client) => {
         artifactDetail,
         createPicture,
         createVideo,
+        listArtifacts,
     };
 };

package/bin/apis/user.js

@@ -4,6 +4,19 @@ export const createUserApis = (client) => {
             const res = await client.get("/v1/user/");
             return res.data ?? null;
         },
+        apInfo: async () => {
+            const res = await client.get("/v2/user/ap_info");
+            return res.data;
+        },
+        apDeltaInfo: async (params) => {
+            const res = await client.get("/v2/users/ap-delta-info", {
+                params: {
+                    cursor_id: params?.cursor_id,
+                    page_size: params?.page_size ?? 10,
+                },
+            });
+            return res.data;
+        },
         subscribeUser: async (params) => {
             const response = await client.request({
                 method: "PUT",

package/bin/commands/creative/get_ap_history.cmd.en_us.yml

@@ -0,0 +1,14 @@
+name: get_ap_history
+title: Get My AP History
+description: |
+  Get the current user's AP (Action Points) transaction history, paginated by cursor.
+
+  Each record shows: type (operation type), ap_delta (negative = spent, positive = gained),
+  ctime (timestamp), and extra_data.display_name (human-readable label).
+
+  Pagination: pass the returned next_cursor as cursor_id to fetch the next page.
+  When has_next is false, you have reached the end of history.
+
+parameters:
+  cursor_id: Cursor ID for pagination — pass the last record id from the previous page to get the next page (optional)
+  page_size: Number of records per page, defaults to 10 (optional)

package/bin/commands/creative/get_ap_history.cmd.js

@@ -0,0 +1,29 @@
+import { Type } from "@sinclair/typebox";
+import { parseMeta } from "../../utils/parse_meta.js";
+import { createCommand } from "../factory.js";
+const meta = parseMeta(Type.Object({
+    name: Type.String(),
+    title: Type.String(),
+    description: Type.String(),
+    parameters: Type.Object({
+        cursor_id: Type.String(),
+        page_size: Type.String(),
+    }),
+}), import.meta);
+const getApHistoryParameters = Type.Object({
+    cursor_id: Type.Optional(Type.Integer({ description: meta.parameters.cursor_id })),
+    page_size: Type.Optional(Type.Integer({
+        minimum: 1,
+        maximum: 50,
+        default: 10,
+        description: meta.parameters.page_size,
+    })),
+});
+export const getApHistory = createCommand({
+    name: meta.name,
+    title: meta.title,
+    description: meta.description,
+    inputSchema: getApHistoryParameters,
+}, async ({ cursor_id, page_size }, { apis }) => {
+    return apis.user.apDeltaInfo({ cursor_id, page_size });
+});

package/bin/commands/creative/get_ap_history.cmd.zh_cn.yml

@@ -0,0 +1,14 @@
+name: get_ap_history
+title: 获取我的 AP 电量变动记录
+description: |
+  获取当前用户的 AP 电量变动历史，支持游标分页。
+
+  每条记录包含：type（操作类型）、ap_delta（负数=消耗，正数=获得）、
+  ctime（时间戳）、extra_data.display_name（可读的操作名称）。
+
+  分页：将返回的 next_cursor 作为 cursor_id 传入即可获取下一页。
+  当 has_next 为 false 时，表示已到达历史末尾。
+
+parameters:
+  cursor_id: 分页游标，传入上一页最后一条记录的 id 以获取下一页（可选）
+  page_size: 每页记录数，默认 10（可选）

package/bin/commands/creative/get_ap_info.cmd.en_us.yml

@@ -0,0 +1,13 @@
+name: get_ap_info
+title: Get My AP Info
+description: |
+  Get the current user's AP (Action Points / Energy) balance details.
+
+  AP is the credit currency used to generate images, videos, and other AI content.
+  Returns: ap (available to spend), ap_limit (daily cap), temp_ap (daily free quota for
+  overseas users), paid_ap (purchased AP), and unlimited_until (timestamp if on unlimited plan).
+
+  Use this before starting a generation task to check if you have sufficient AP.
+  For transaction history, use get_ap_history instead.
+
+parameters: {}

package/bin/commands/creative/get_ap_info.cmd.js

@@ -0,0 +1,22 @@
+import { Type } from "@sinclair/typebox";
+import { parseMeta } from "../../utils/parse_meta.js";
+import { createCommand } from "../factory.js";
+const meta = parseMeta(Type.Object({
+    name: Type.String(),
+    title: Type.String(),
+    description: Type.String(),
+}), import.meta);
+export const getApInfo = createCommand({
+    name: meta.name,
+    title: meta.title,
+    description: meta.description,
+}, async (_args, { apis }) => {
+    const info = await apis.user.apInfo();
+    return {
+        ap: info.ap,
+        ap_limit: info.ap_limit,
+        temp_ap: info.temp_ap ?? null,
+        paid_ap: info.paid_ap ?? null,
+        unlimited_until: info.unlimited_until,
+    };
+});

package/bin/commands/creative/get_ap_info.cmd.zh_cn.yml

@@ -0,0 +1,13 @@
+name: get_ap_info
+title: 获取我的 AP 电量信息
+description: |
+  获取当前用户的 AP（电量/行动点数）余额详情。
+
+  AP 是生成图片、视频等 AI 内容所消耗的虚拟货币。
+  返回：ap（可用电量）、ap_limit（每日上限）、temp_ap（海外用户每日免费配额）、
+  paid_ap（付费购买的电量）、unlimited_until（无限套餐到期时间戳，如有）。
+
+  在发起生成任务前可调用此命令确认电量是否充足。
+  如需查看消耗明细，请使用 get_ap_history。
+
+parameters: {}

package/bin/commands/creative/list_my_artifacts.cmd.en_us.yml

@@ -0,0 +1,22 @@
+name: list_my_artifacts
+title: List My Artifacts
+description: |
+  List AI-generated assets (images, videos, audio) created by the current user.
+
+  Returns: has_more (true = more pages exist, increment page_index and fetch again; false = done),
+  and list of artifacts. If has_more is true but next page returns an empty list, stop.
+
+  Each item includes: uuid, status, url (image/video thumbnail), modality (PICTURE / VIDEO / AUDIO),
+  is_starred, ctime, and audio_name (for audio).
+
+  Filter by modality to narrow results — e.g. pass "PICTURE" for images only, "VIDEO" for
+  videos only, or "PICTURE,VIDEO" for both. Leave empty to return all types.
+
+  Artifact uuids can be used with make_video (as image_source) or publish_collection
+  to incorporate assets into a story.
+
+parameters:
+  page_index: Page index for pagination, defaults to 0 (optional)
+  page_size: Results per page, 1–100, defaults to 20 (optional)
+  modality: Filter by type — PICTURE, VIDEO, or AUDIO; comma-separate for multiple (optional)
+  is_starred: Filter to starred/favourited artifacts only — true or false (optional)

package/bin/commands/creative/list_my_artifacts.cmd.js

@@ -0,0 +1,49 @@
+import { Type } from "@sinclair/typebox";
+import { parseMeta } from "../../utils/parse_meta.js";
+import { createCommand } from "../factory.js";
+const meta = parseMeta(Type.Object({
+    name: Type.String(),
+    title: Type.String(),
+    description: Type.String(),
+    parameters: Type.Object({
+        page_index: Type.String(),
+        page_size: Type.String(),
+        modality: Type.String(),
+        is_starred: Type.String(),
+    }),
+}), import.meta);
+const listMyArtifactsParameters = Type.Object({
+    page_index: Type.Optional(Type.Integer({
+        minimum: 0,
+        default: 0,
+        description: meta.parameters.page_index,
+    })),
+    page_size: Type.Optional(Type.Integer({
+        minimum: 1,
+        maximum: 100,
+        default: 20,
+        description: meta.parameters.page_size,
+    })),
+    modality: Type.Optional(Type.String({ description: meta.parameters.modality })),
+    is_starred: Type.Optional(Type.Boolean({ description: meta.parameters.is_starred })),
+});
+export const listMyArtifacts = createCommand({
+    name: meta.name,
+    title: meta.title,
+    description: meta.description,
+    inputSchema: listMyArtifactsParameters,
+}, async ({ page_index, page_size, modality, is_starred }, { apis }) => {
+    const resolvedPageIndex = page_index ?? 0;
+    const resolvedPageSize = page_size ?? 20;
+    const result = await apis.artifact.listArtifacts({
+        page_index: resolvedPageIndex,
+        page_size: resolvedPageSize,
+        modality,
+        is_starred,
+    });
+    return {
+        has_more: result.list.length > 0 &&
+            (resolvedPageIndex + 1) * resolvedPageSize < result.total,
+        list: result.list,
+    };
+});

package/bin/commands/creative/list_my_artifacts.cmd.zh_cn.yml

@@ -0,0 +1,23 @@
+name: list_my_artifacts
+title: 获取我的素材列表
+description: |
+  获取当前用户生成的 AI 素材（图片、视频、音频）列表。
+
+  返回：has_more（true = 还有更多页，递增 page_index 继续获取；false = 已全部返回），
+  以及素材列表。若 has_more 为 true 但下一页返回空列表，则停止翻页。
+
+  每条素材包含：uuid、status、url（图片/视频首帧）、
+  modality（PICTURE / VIDEO / AUDIO）、is_starred（是否收藏）、ctime、
+  audio_name（音频名称，仅音频类型）。
+
+  通过 modality 过滤缩小结果范围 —— 例如传 "PICTURE" 仅返回图片，
+  "VIDEO" 仅返回视频，"PICTURE,VIDEO" 返回图片和视频。不传则返回全部类型。
+
+  素材 uuid 可传入 make_video（作为 image_source）或 publish_collection
+  以将素材加入作品中。
+
+parameters:
+  page_index: 分页页码，默认 0（可选）
+  page_size: 每页数量，1–100，默认 20（可选）
+  modality: 按类型过滤 —— PICTURE、VIDEO 或 AUDIO；多选用逗号分隔（可选）
+  is_starred: 仅返回已收藏的素材 —— true 或 false（可选）

package/bin/commands/user/me.cmd.en_us.yml

@@ -0,0 +1,14 @@
+name: me
+title: Who Am I
+description: |
+  Show the current authenticated user's profile and account summary.
+
+  Returns: uuid, nick_name (nullable), avatar_url (nullable), AP balance
+  (ap / ap_limit, nullable if not available), content counts
+  (total_collections, total_pictures, total_travel_characters), and active privileges.
+
+  Related commands:
+    - get_ap_info: detailed AP balance breakdown
+    - list_my_characters / list_my_elementum: your created characters and elementum
+
+parameters: {}

package/bin/commands/user/me.cmd.js

@@ -0,0 +1,30 @@
+import { Type } from "@sinclair/typebox";
+import { parseMeta } from "../../utils/parse_meta.js";
+import { createCommand } from "../factory.js";
+const meta = parseMeta(Type.Object({
+    name: Type.String(),
+    title: Type.String(),
+    description: Type.String(),
+}), import.meta);
+export const me = createCommand({
+    name: meta.name,
+    title: meta.title,
+    description: meta.description,
+}, async (_args, { user }) => {
+    return {
+        uuid: user.uuid,
+        nick_name: user.nick_name ?? null,
+        avatar_url: user.avatar_url,
+        ap: user.ap_info?.ap ?? null,
+        ap_limit: user.ap_info?.ap_limit ?? null,
+        unlimited_until: user.ap_info?.unlimited_until ?? null,
+        total_collections: user.total_collections,
+        total_pictures: user.total_pictures,
+        total_travel_characters: user.total_travel_characters,
+        privileges: user.privileges?.map((p) => ({
+            type: p.privilege_type,
+            is_active: p.is_active,
+            valid_until: p.valid_until,
+        })) ?? [],
+    };
+});

package/bin/commands/user/me.cmd.zh_cn.yml

@@ -0,0 +1,13 @@
+name: me
+title: 我是谁
+description: |
+  显示当前已登录用户的个人资料和账户概览。
+
+  返回：uuid、昵称（可为 null）、头像（可为 null）、AP 电量（ap / ap_limit，不可用时为 null）、
+  内容数量（作品数、生图数、奇遇角色数）以及当前有效的权益。
+
+  相关命令：
+    - get_ap_info：详细的 AP 电量明细
+    - list_my_characters / list_my_elementum：你创建的捏宝角色和元素
+
+parameters: {}

package/bin/utils/config.js

@@ -4,7 +4,7 @@ import { resolve } from "node:path";
 import envPaths from "env-paths";
 import { IS_DEV } from "./env.js";
 import { logger } from "./logger.js";
-const paths = envPaths("neta-cli", {
+const paths = envPaths("neta", {
     suffix: IS_DEV ? "dev" : "",
 });
 const CONFIG_DIR = process.env["NETA_CONFIG_DIR"] ?? paths.config;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@talesofai/neta-skills",
-  "version": "0.16.6",
+  "version": "0.17.0",
   "description": "Neta API pi coding agent skills for interacting with Neta API to generate images, videos, songs, and manage characters/elements.",
   "type": "module",
   "repository": {

package/skills/neta-creative/SKILL.md

@@ -140,6 +140,32 @@ npx -y @talesofai/neta-skills@latest pay_premium_order --order_uuid "order-uuid"
 
 📖 [Premium workflow and limits](./references/premium.md)
 
+### Credits & your artifacts
+
+AP (Action Points) is consumed by every generation command. Use these to monitor your balance and review generated output.
+
+**AP balance**
+
+```bash
+npx -y @talesofai/neta-skills@latest get_ap_info
+```
+
+**AP consumption history**
+
+```bash
+npx -y @talesofai/neta-skills@latest get_ap_history --page_size 10
+```
+
+**List your generated artifacts**
+
+```bash
+npx -y @talesofai/neta-skills@latest list_my_artifacts --page_size 20
+npx -y @talesofai/neta-skills@latest list_my_artifacts --modality PICTURE
+npx -y @talesofai/neta-skills@latest list_my_artifacts --is_starred true
+```
+
+📖 [AP credits guide](./references/ap-credits.md) · [Artifacts guide](./references/my-artifacts.md)
+
 ## Reference docs
 
 | Scenario              | Doc                                      |
@@ -152,4 +178,6 @@ npx -y @talesofai/neta-skills@latest pay_premium_order --order_uuid "order-uuid"
 | 👤 Character queries  | [character-search.md](./references/character-search.md) |
 | 🖊️ Creative remixing | [collection-remix.md](./references/collection-remix.md) |
 | ⭐ Premium / subscribe | [premium.md](./references/premium.md)                   |
+| 💡 AP credits         | [ap-credits.md](./references/ap-credits.md)             |
+| 🖼️ My artifacts      | [my-artifacts.md](./references/my-artifacts.md)         |
 

package/skills/neta-creative/references/ap-credits.md

@@ -0,0 +1,44 @@
+# AP Credits
+
+Guide for checking AP (Action Points) balance and consumption history.
+
+## get_ap_info
+
+Get a detailed breakdown of your current AP balance.
+
+```bash
+npx -y @talesofai/neta-skills@latest get_ap_info
+```
+
+### Response fields
+
+- **`ap`** — currently available AP
+- **`ap_limit`** — daily AP ceiling
+- **`temp_ap`** — free/daily quota AP remaining
+- **`paid_ap`** — purchased AP remaining
+- **`unlimited_until`** — ISO timestamp if on an unlimited plan, otherwise `null`
+
+## get_ap_history
+
+Paginated AP consumption and recharge history.
+
+```bash
+npx -y @talesofai/neta-skills@latest get_ap_history
+npx -y @talesofai/neta-skills@latest get_ap_history --cursor_id 0 --page_size 10
+```
+
+### Parameters
+
+- **`cursor_id`** (optional) — cursor for next page; use `next_cursor` from the previous response
+- **`page_size`** (optional, default `10`, max `50`)
+
+### Response fields
+
+Each record includes:
+
+- **`type`** — what the AP was spent on (e.g. `PICTURE,VERSE`)
+- **`ap_delta`** — change amount (negative for consumption, positive for recharge)
+- **`ctime`** — timestamp
+- **`extra_data.display_name`** — human-readable reason (e.g. "图片生成")
+- **`extra_data.ap_delta_original`** — original cost before discounts
+- **`has_next`** / **`next_cursor`** — pagination controls; keep paginating while `has_next` is `true`

package/skills/neta-creative/references/my-artifacts.md

@@ -0,0 +1,35 @@
+# My Artifacts
+
+Guide for listing generated media artifacts owned by the current user.
+
+## list_my_artifacts
+
+List generated media artifacts (images, videos, audio) owned by the authenticated user.
+
+```bash
+npx -y @talesofai/neta-skills@latest list_my_artifacts --page_size 10 --modality PICTURE
+npx -y @talesofai/neta-skills@latest list_my_artifacts --page_size 5 --is_starred true
+```
+
+### Parameters
+
+- **`page_index`** (optional, default `0`)
+- **`page_size`** (optional, default `20`, max `100`)
+- **`modality`** (optional) — filter by `PICTURE`, `VIDEO`, `AUDIO`; comma-separated for multiple
+- **`is_starred`** (optional boolean) — filter starred items only
+
+### Pagination
+
+Keep incrementing `page_index` while `has_more` is `true`. Stop when `has_more` is `false` or `list` is empty.
+
+### Response
+
+- **`has_more`** — `true` if more pages exist
+- **`list`** — array of artifact records:
+  - `uuid` — artifact id; use this in `make_video --image_source`, `remove_background`, or collection commands
+  - `status` — e.g. `SUCCESS`, `PENDING`, `FAILED`
+  - `url` — media URL
+  - `modality` — `PICTURE` / `VIDEO` / `AUDIO`
+  - `is_starred` — starred flag
+  - `ctime` / `mtime` — creation and modification times
+  - `audio_name` — name if audio artifact

package/skills/zh_cn/neta-creative/SKILL.md

@@ -86,6 +86,32 @@ npx -y @talesofai/neta-skills@latest read_collection --uuid "作品-uuid"
 
 📖 [详细指南](./references/collection-remix.md)
 
+### 积分与我的作品
+
+AP（Action Points，行动电量）在每次生成命令时消耗。使用以下命令查看余额和回顾生成记录。
+
+**AP 余额**
+
+```bash
+npx -y @talesofai/neta-skills@latest get_ap_info
+```
+
+**AP 消耗历史**
+
+```bash
+npx -y @talesofai/neta-skills@latest get_ap_history --page_size 10
+```
+
+**列出我的作品**
+
+```bash
+npx -y @talesofai/neta-skills@latest list_my_artifacts --page_size 20
+npx -y @talesofai/neta-skills@latest list_my_artifacts --modality PICTURE
+npx -y @talesofai/neta-skills@latest list_my_artifacts --is_starred true
+```
+
+📖 [AP 积分指南](./references/ap-credits.md) · [作品指南](./references/my-artifacts.md)
+
 ## 参考文档
 
 | 场景 | 文档 |
@@ -97,3 +123,5 @@ npx -y @talesofai/neta-skills@latest read_collection --uuid "作品-uuid"
 | 📤 本地上传 | [media-upload.md](./references/media-upload.md) |
 | 👤 角色查询 | [character-search.md](./references/character-search.md) |
 | 🖊️ 内容创作思路 | [collection-remix.md](./references/collection-remix.md) |
+| 💡 AP 积分 | [ap-credits.md](./references/ap-credits.md) |
+| 🖼️ 我的作品 | [my-artifacts.md](./references/my-artifacts.md) |

package/skills/zh_cn/neta-creative/references/ap-credits.md

@@ -0,0 +1,44 @@
+# AP 积分
+
+查看 AP（Action Points，行动电量）余额和消耗历史的指南。
+
+## get_ap_info
+
+获取当前 AP 余额的详细明细。
+
+```bash
+npx -y @talesofai/neta-skills@latest get_ap_info
+```
+
+### 响应字段
+
+- **`ap`** — 当前可用 AP
+- **`ap_limit`** — 每日 AP 上限
+- **`temp_ap`** — 免费/每日额度 AP 剩余
+- **`paid_ap`** — 购买的 AP 剩余
+- **`unlimited_until`** — 无限套餐到期时间戳，否则为 `null`
+
+## get_ap_history
+
+分页获取 AP 消耗和充值历史。
+
+```bash
+npx -y @talesofai/neta-skills@latest get_ap_history
+npx -y @talesofai/neta-skills@latest get_ap_history --cursor_id 0 --page_size 10
+```
+
+### 参数
+
+- **`cursor_id`**（可选）— 下一页游标；使用上一次响应的 `next_cursor`
+- **`page_size`**（可选，默认 `10`，最大 `50`）
+
+### 响应字段
+
+每条记录包含：
+
+- **`type`** — AP 消耗来源（如 `PICTURE,VERSE`）
+- **`ap_delta`** — 变化量（消耗为负，充值为正）
+- **`ctime`** — 时间戳
+- **`extra_data.display_name`** — 可读原因（如"图片生成"）
+- **`extra_data.ap_delta_original`** — 折扣前原始消耗量
+- **`has_next`** / **`next_cursor`** — 翻页控制；`has_next` 为 `true` 时继续翻页

package/skills/zh_cn/neta-creative/references/my-artifacts.md

@@ -0,0 +1,35 @@
+# 我的作品
+
+列出当前用户生成媒体作品的指南。
+
+## list_my_artifacts
+
+列出已登录用户生成的媒体作品（图片、视频、音频）。
+
+```bash
+npx -y @talesofai/neta-skills@latest list_my_artifacts --page_size 10 --modality PICTURE
+npx -y @talesofai/neta-skills@latest list_my_artifacts --page_size 5 --is_starred true
+```
+
+### 参数
+
+- **`page_index`**（可选，默认 `0`）
+- **`page_size`**（可选，默认 `20`，最大 `100`）
+- **`modality`**（可选）— 按 `PICTURE`、`VIDEO`、`AUDIO` 过滤；多值用逗号分隔
+- **`is_starred`**（可选布尔值）— 仅显示收藏项
+
+### 翻页
+
+持续递增 `page_index` 直到 `has_more` 为 `false`，或 `list` 为空时停止。
+
+### 响应
+
+- **`has_more`** — `true` 表示还有更多页
+- **`list`** — 作品记录数组：
+  - `uuid` — 作品 ID；可用于 `make_video --image_source`、`remove_background` 或合集命令
+  - `status` — 例如 `SUCCESS`、`PENDING`、`FAILED`
+  - `url` — 媒体 URL
+  - `modality` — `PICTURE` / `VIDEO` / `AUDIO`
+  - `is_starred` — 收藏标记
+  - `ctime` / `mtime` — 创建和修改时间
+  - `audio_name` — 音频作品的名称