@thinkingai/ae-cli 6.1.27 → 6.1.29

package/skills/ae-community/references/community-weekly-report.md

@@ -12,8 +12,9 @@ You are "Director of Community Operations + Senior Data Analyst". The goal is no
 ## Time deduction rules
 
 1. The user clearly gives the date: query strictly according to the user scope.
-2. The user does not provide a date: automatically retrieve the past 7 days (`endTime=yesterday`, `startTime=endTime-7d`).
-3. Don’t interrupt the process due to lack of time.
+2. The user does not provide a date: automatically retrieve the past 7 days (`endTime=yesterday`, `startTime=endTime-6d`).
+3. These bounds include both dates: state the exact seven calendar days and service timezone. Use the preceding seven days for an equal-length comparison. Missing or failed data is unknown, never zero.
+4. For filtered questions, use the same effective visual query for all comparisons and evidence. An unfiltered overview is not the denominator of a filtered search.
 
 ## Required tool chain
 
@@ -24,7 +25,9 @@ You are "Director of Community Operations + Senior Data Analyst". The goal is no
 5. `+get_risk_content` (compliance risk control)
 6. `+get_hot_topics` (hotspot assisted verification)
 
-## Output structure (must be complete)
+## Output structure
+
+Mark unsupported or unavailable sections explicitly. Never invent results to fill this template.
 
 1. **Core summary of the report**: Setting the tone for this week + hot keywords
 2. **Overview indicator board**: total volume, sentiment distribution, channel matrix (table)

package/skills/ae-community/references/get_channel_info.md

@@ -1,7 +1,7 @@
 # ae-community +get_channel_info
 
 
-Get the list of valid channels for the community space, including channel IDs and names. **This is the prerequisite step for most commands that require `--channel-id` / `--channel-id-list`: First get the real channel ID here, and then call `+search_posts`, `+get_post_detail`, `+get_comments_summary`, `+get_livestream_list`, etc. with parameters (subject to the reference of each command).
+Get the list of valid channels for the community space, including channel IDs and names. **This is the prerequisite step for most commands that require `--channel-id` / `--channel-id-list`**: first get the real channel ID here, then call `+search_posts`, `+get_post_detail`, `+get_comments_summary`, `+get_livestream_list`, etc. If the space ID is unknown, run `ae-cli community spaces list` first.
 
 Mapping command: `ae-cli community +get_channel_info`
 
@@ -9,12 +9,15 @@ Mapping command: `ae-cli community +get_channel_info`
 
 | Flag | Type | Required | Description |
 |------|------|------|------|
-| `--space-id` | number | yes | community space ID |
-| `--game-id` | number | yes | game/space ID |
+| `--space-id` | int64 | yes | Community space ID returned by `community spaces list` |
+| `--game-id` | int64 | no | Deprecated compatibility alias; omit it, or make it equal to `--space-id` |
 
 ## Example
 
 ```bash
 # Get channel list
-ae-cli community +get_channel_info --space-id 1 --game-id 1
+ae-cli community +get_channel_info --space-id 1
 ```
+
+Copy returned channel IDs exactly. JSON output preserves IDs outside JavaScript's safe integer range
+as strings.

package/skills/ae-community/references/get_comment_tag_analysis.md

@@ -9,8 +9,8 @@ Mapping command: `ae-cli community +get_comment_tag_analysis`
 
 | Flag | Type | Required | Description |
 |------|------|------|------|
-| `--space-id` | number | yes | community space ID |
-| `--game-id` | number | yes | game/space ID |
+| `--space-id` | int64 | yes | Community space ID returned by `community spaces list` |
+| `--game-id` | int64 | no | Deprecated compatibility alias; omit it, or make it equal to `--space-id` |
 | `--channel-id` | number | yes | channel ID |
 | `--uuid` | string | yes | content UUID |
 | `--resource-type` | number | Yes | Resource type: `0` for posts, `1` for videos |
@@ -23,7 +23,7 @@ Mapping command: `ae-cli community +get_comment_tag_analysis`
 ```bash
 # Analyze comment tags
 ae-cli community +get_comment_tag_analysis \
-  --space-id 1 --game-id 1 \
+  --space-id 1 \
   --channel-id 1 --uuid <uuid> \
   --resource-type 0 --tag-code "sentiment"
 ```

package/skills/ae-community/references/get_comments_summary.md

@@ -9,8 +9,8 @@ Mapping command: `ae-cli community +get_comments_summary`
 
 | Flag | Type | Required | Description |
 |------|------|------|------|
-| `--space-id` | number | yes | community space ID |
-| `--game-id` | number | yes | game/space ID |
+| `--space-id` | int64 | yes | Community space ID returned by `community spaces list` |
+| `--game-id` | int64 | no | Deprecated compatibility alias; omit it, or make it equal to `--space-id` |
 | `--channel-id` | number | yes | channel ID |
 | `--uuid` | string | yes | content UUID |
 | `--start-time` | string | No | Earliest comment publish date, format yyyy-MM-dd, default is the publishing time of the post |
@@ -21,12 +21,12 @@ Mapping command: `ae-cli community +get_comments_summary`
 ```bash
 # Get comment summary
 ae-cli community +get_comments_summary \
-  --space-id 1 --game-id 1 \
+  --space-id 1 \
   --channel-id 1 --uuid <uuid>
 
 #Specify time range
 ae-cli community +get_comments_summary \
-  --space-id 1 --game-id 1 \
+  --space-id 1 \
   --channel-id 1 --uuid <uuid> \
   --start-time 2024-01-01 --end-time 2024-01-07
 ```

package/skills/ae-community/references/get_corpus_tags.md

@@ -9,12 +9,12 @@ Mapping command: `ae-cli community +get_corpus_tags`
 
 | Flag | Type | Required | Description |
 |------|------|------|------|
-| `--space-id` | number | yes | community space ID |
-| `--game-id` | number | yes | game/space ID |
+| `--space-id` | int64 | yes | Community space ID returned by `community spaces list` |
+| `--game-id` | int64 | no | Deprecated compatibility alias; omit it, or make it equal to `--space-id` |
 
 ## Example
 
 ```bash
 # Get the tag list
-ae-cli community +get_corpus_tags --space-id 1 --game-id 1
+ae-cli community +get_corpus_tags --space-id 1
 ```

package/skills/ae-community/references/get_daily_summary.md

@@ -9,8 +9,8 @@ Mapping command: `ae-cli community +get_daily_summary`
 
 | Flag | Type | Required | Description |
 |------|------|------|------|
-| `--space-id` | number | yes | community space ID |
-| `--game-id` | number | yes | game/space ID |
+| `--space-id` | int64 | yes | Community space ID returned by `community spaces list` |
+| `--game-id` | int64 | no | Deprecated compatibility alias; omit it, or make it equal to `--space-id` |
 | `--date` | string | Yes | Date, format yyyy-MM-dd |
 
 ## Example
@@ -18,5 +18,5 @@ Mapping command: `ae-cli community +get_daily_summary`
 ```bash
 # Get daily report
 ae-cli community +get_daily_summary \
-  --space-id 1 --game-id 1 --date 2024-01-01
+  --space-id 1 --date 2024-01-01
 ```

package/skills/ae-community/references/get_hot_topics.md

@@ -9,8 +9,8 @@ Mapping command: `ae-cli community +get_hot_topics`
 
 | Flag | Type | Required | Description |
 |------|------|------|------|
-| `--space-id` | number | yes | community space ID |
-| `--game-id` | number | yes | game/space ID |
+| `--space-id` | int64 | yes | Community space ID returned by `community spaces list` |
+| `--game-id` | int64 | no | Deprecated compatibility alias; omit it, or make it equal to `--space-id` |
 | `--start-time` | string | No | Topic statistics start time, format yyyy-MM-dd |
 | `--end-time` | string | No | Topic statistics end time, format yyyy-MM-dd |
 | `--order-by` | number | No | Sort: 0 by popularity desc, 1 by start time desc |
@@ -20,6 +20,6 @@ Mapping command: `ae-cli community +get_hot_topics`
 ```bash
 # Get hot topics
 ae-cli community +get_hot_topics \
-  --space-id 1 --game-id 1 \
+  --space-id 1 \
   --start-time 2024-01-01 --end-time 2024-01-07
 ```

package/skills/ae-community/references/get_livestream_analysis.md

@@ -9,14 +9,14 @@ Mapping command: `ae-cli community +get_livestream_analysis`
 
 | Flag | Type | Required | Description |
 |------|------|------|------|
-| `--space-id` | number | yes | community space ID |
-| `--game-id` | number | yes | game/space ID |
+| `--space-id` | int64 | yes | Community space ID returned by `community spaces list` |
+| `--game-id` | int64 | no | Deprecated compatibility alias; omit it, or make it equal to `--space-id` |
 | `--stream-id` | string | Yes | Livestream session ID, streamId from `get_livestream_list` |
 
 ## Example
 
 ```bash
 ae-cli community +get_livestream_analysis \
-  --space-id 1 --game-id 1 \
+  --space-id 1 \
   --stream-id <stream-id>
 ```

package/skills/ae-community/references/get_livestream_detail.md

@@ -9,8 +9,8 @@ Mapping command: `ae-cli community +get_livestream_detail`
 
 | Flag | Type | Required | Description |
 |------|------|------|------|
-| `--space-id` | number | yes | community space ID |
-| `--game-id` | number | yes | game/space ID |
+| `--space-id` | int64 | yes | Community space ID returned by `community spaces list` |
+| `--game-id` | int64 | no | Deprecated compatibility alias; omit it, or make it equal to `--space-id` |
 | `--stream-id` | string | Yes | Live session ID, obtained from get_livestream_list |
 | `--activity-types` | string | No | Interaction type filtering: 0 danmaku, 1 gift, 2 eye-catching message, 3 premium, comma separated |
 | `--anchor-time` | string | No | Interaction anchor time, format yyyy-MM-dd HH:mm |
@@ -24,10 +24,10 @@ Mapping command: `ae-cli community +get_livestream_detail`
 ```bash
 # Get livestream details
 ae-cli community +get_livestream_detail \
-  --space-id 1 --game-id 1 --stream-id <stream-id>
+  --space-id 1 --stream-id <stream-id>
 
 # Filter danmaku types
 ae-cli community +get_livestream_detail \
-  --space-id 1 --game-id 1 --stream-id <stream-id> \
+  --space-id 1 --stream-id <stream-id> \
   --activity-types 0,1
 ```

package/skills/ae-community/references/get_livestream_list.md

@@ -9,8 +9,8 @@ Mapping command: `ae-cli community +get_livestream_list`
 
 | Flag | Type | Required | Description |
 |------|------|------|------|
-| `--space-id` | number | yes | community space ID |
-| `--game-id` | number | yes | game/space ID |
+| `--space-id` | int64 | yes | Community space ID returned by `community spaces list` |
+| `--game-id` | int64 | no | Deprecated compatibility alias; omit it, or make it equal to `--space-id` |
 | `--channel-id` | number | no | Channel ID (obtain via `get_livestream_rooms`) |
 | `--room-id` | string | No | Room ID (obtain via `get_livestream_rooms`) |
 | `--start-time` | string | No | Start date for statistics, format yyyy-MM-dd |
@@ -21,5 +21,5 @@ Mapping command: `ae-cli community +get_livestream_list`
 ```bash
 # Get the livestream session list
 ae-cli community +get_livestream_list \
-  --space-id 1 --game-id 1 --channel-id 1
+  --space-id 1 --channel-id 1
 ```

package/skills/ae-community/references/get_livestream_overview.md

@@ -9,8 +9,8 @@ Mapping command: `ae-cli community +get_livestream_overview`
 
 | Flag | Type | Required | Description |
 |------|------|------|------|
-| `--space-id` | number | yes | community space ID |
-| `--game-id` | number | yes | game/space ID |
+| `--space-id` | int64 | yes | Community space ID returned by `community spaces list` |
+| `--game-id` | int64 | no | Deprecated compatibility alias; omit it, or make it equal to `--space-id` |
 | `--start-time` | string | No | Start date for statistics, format yyyy-MM-dd |
 | `--end-time` | string | No | End date for statistics, format yyyy-MM-dd |
 
@@ -19,6 +19,6 @@ Mapping command: `ae-cli community +get_livestream_overview`
 ```bash
 # Get livestream overview
 ae-cli community +get_livestream_overview \
-  --space-id 1 --game-id 1 \
+  --space-id 1 \
   --start-time 2024-01-01 --end-time 2024-01-07
 ```

package/skills/ae-community/references/get_livestream_room_metrics.md

@@ -9,8 +9,8 @@ Mapping command: `ae-cli community +get_livestream_room_metrics`
 
 | Flag | Type | Required | Description |
 |------|------|------|------|
-| `--space-id` | number | yes | community space ID |
-| `--game-id` | number | yes | game/space ID |
+| `--space-id` | int64 | yes | Community space ID returned by `community spaces list` |
+| `--game-id` | int64 | no | Deprecated compatibility alias; omit it, or make it equal to `--space-id` |
 | `--channel-id` | number | Yes | Channel ID (obtain via `get_livestream_rooms`) |
 | `--room-id` | string | yes | Room ID (obtain via `get_livestream_rooms`) |
 | `--year` | string | No | Year, format yyyy, default is the current year |
@@ -20,6 +20,6 @@ Mapping command: `ae-cli community +get_livestream_room_metrics`
 ```bash
 # Get the annual indicators of the livestream room
 ae-cli community +get_livestream_room_metrics \
-  --space-id 1 --game-id 1 \
+  --space-id 1 \
   --channel-id 1 --room-id <room-id> --year 2024
 ```

package/skills/ae-community/references/get_livestream_rooms.md

@@ -9,8 +9,8 @@ Mapping command: `ae-cli community +get_livestream_rooms`
 
 | Flag | Type | Required | Description |
 |------|------|------|------|
-| `--space-id` | number | yes | community space ID |
-| `--game-id` | number | yes | game/space ID |
+| `--space-id` | int64 | yes | Community space ID returned by `community spaces list` |
+| `--game-id` | int64 | no | Deprecated compatibility alias; omit it, or make it equal to `--space-id` |
 | `--channel-id-list` | string | No | List of channel IDs, comma separated |
 | `--start-time` | string | No | Start date for statistics, format yyyy-MM-dd |
 | `--end-time` | string | No | End date for statistics, format yyyy-MM-dd |
@@ -20,6 +20,6 @@ Mapping command: `ae-cli community +get_livestream_rooms`
 ```bash
 # Search livestream room
 ae-cli community +get_livestream_rooms \
-  --space-id 1 --game-id 1 \
+  --space-id 1 \
   --start-time 2024-01-01 --end-time 2024-01-07
 ```

package/skills/ae-community/references/get_overview_metrics.md

@@ -9,8 +9,8 @@ Mapping command: `ae-cli community +get_overview_metrics`
 
 | Flag | Type | Required | Description |
 |------|------|------|------|
-| `--space-id` | number | yes | community space ID |
-| `--game-id` | number | yes | game/space ID |
+| `--space-id` | int64 | yes | Community space ID returned by `community spaces list` |
+| `--game-id` | int64 | no | Deprecated compatibility alias; omit it, or make it equal to `--space-id` |
 | `--channel-id-list` | string | No | List of channel IDs, comma separated |
 | `--start-time` | string | Yes | Start date for statistics, format yyyy-MM-dd |
 | `--end-time` | string | Yes | End date for statistics, format yyyy-MM-dd |
@@ -20,6 +20,6 @@ Mapping command: `ae-cli community +get_overview_metrics`
 ```bash
 # Get overall indicators
 ae-cli community +get_overview_metrics \
-  --space-id 1 --game-id 1 \
+  --space-id 1 \
   --start-time 2024-01-01 --end-time 2024-01-07
 ```

package/skills/ae-community/references/get_post_detail.md

@@ -9,8 +9,8 @@ Mapping command: `ae-cli community +get_post_detail`
 
 | Flag | Type | Required | Description |
 |------|------|------|------|
-| `--space-id` | number | yes | community space ID |
-| `--game-id` | number | yes | game/space ID |
+| `--space-id` | int64 | yes | Community space ID returned by `community spaces list` |
+| `--game-id` | int64 | no | Deprecated compatibility alias; omit it, or make it equal to `--space-id` |
 | `--channel-id` | number | yes | channel ID |
 | `--uuid` | string | yes | content UUID |
 | `--resource-type` | number | Yes | Resource type: `0` for posts, `1` for videos |
@@ -26,12 +26,12 @@ Mapping command: `ae-cli community +get_post_detail`
 ```bash
 # Get post details
 ae-cli community +get_post_detail \
-  --space-id 1 --game-id 1 \
+  --space-id 1 \
   --channel-id 1 --uuid <uuid> --resource-type 0
 
 # Get video details and page comments
 ae-cli community +get_post_detail \
-  --space-id 1 --game-id 1 \
+  --space-id 1 \
   --channel-id 1 --uuid <uuid> --resource-type 1 \
   --reply-page-num 1 --reply-page-size 20
 ```

package/skills/ae-community/references/get_risk_content.md

@@ -9,8 +9,8 @@ Mapping command: `ae-cli community +get_risk_content`
 
 | Flag | Type | Required | Description |
 |------|------|------|------|
-| `--space-id` | number | yes | community space ID |
-| `--game-id` | number | yes | game/space ID |
+| `--space-id` | int64 | yes | Community space ID returned by `community spaces list` |
+| `--game-id` | int64 | no | Deprecated compatibility alias; omit it, or make it equal to `--space-id` |
 | `--start-time` | string | Yes | Lower limit of release time for risky content, format yyyy-MM-dd |
 | `--end-time` | string | yes | upper limit of release time for risky content, format yyyy-MM-dd |
 | `--risk-codes` | string | No | List of risk type codes, comma separated |
@@ -25,18 +25,18 @@ Mapping command: `ae-cli community +get_risk_content`
 ```bash
 # Query risk content
 ae-cli community +get_risk_content \
-  --space-id 1 --game-id 1 \
+  --space-id 1 \
   --start-time 2024-01-01 --end-time 2024-01-07
 
 # Filter by risk type
 ae-cli community +get_risk_content \
-  --space-id 1 --game-id 1 \
+  --space-id 1 \
   --start-time 2024-01-01 --end-time 2024-01-07 \
   --risk-codes 1,2
 
 # Keyword search
 ae-cli community +get_risk_content \
-  --space-id 1 --game-id 1 \
+  --space-id 1 \
   --start-time 2024-01-01 --end-time 2024-01-07 \
 --search-word "violating keywords"
 ```

package/skills/ae-community/references/get_sentiment_overview.md

@@ -9,8 +9,8 @@ Mapping command: `ae-cli community +get_sentiment_overview`
 
 | Flag | Type | Required | Description |
 |------|------|------|------|
-| `--space-id` | number | yes | community space ID |
-| `--game-id` | number | yes | game/space ID |
+| `--space-id` | int64 | yes | Community space ID returned by `community spaces list` |
+| `--game-id` | int64 | no | Deprecated compatibility alias; omit it, or make it equal to `--space-id` |
 | `--channel-id-list` | string | No | List of channel IDs, comma separated |
 | `--start-time` | string | Yes | Start date for statistics, format yyyy-MM-dd |
 | `--end-time` | string | Yes | End date for statistics, format yyyy-MM-dd |
@@ -22,12 +22,12 @@ Mapping command: `ae-cli community +get_sentiment_overview`
 ```bash
 #emotionoverview
 ae-cli community +get_sentiment_overview \
-  --space-id 1 --game-id 1 \
+  --space-id 1 \
   --start-time 2024-01-01 --end-time 2024-01-07
 
 # Limit the number of returns
 ae-cli community +get_sentiment_overview \
-  --space-id 1 --game-id 1 \
+  --space-id 1 \
   --start-time 2024-01-01 --end-time 2024-01-07 \
   --limit 50
 ```

package/skills/ae-community/references/get_tag_trends.md

@@ -9,8 +9,8 @@ Mapping command: `ae-cli community +get_tag_trends`
 
 | Flag | Type | Required | Description |
 |------|------|------|------|
-| `--space-id` | number | yes | community space ID |
-| `--game-id` | number | yes | game/space ID |
+| `--space-id` | int64 | yes | Community space ID returned by `community spaces list` |
+| `--game-id` | int64 | no | Deprecated compatibility alias; omit it, or make it equal to `--space-id` |
 | `--tag-code` | string | Yes | Tag code (obtain via `get_corpus_tags`) |
 | `--channel-id-list` | string | No | List of channel IDs, comma separated |
 | `--start-time` | string | No | Start date for statistics, format yyyy-MM-dd |
@@ -21,7 +21,7 @@ Mapping command: `ae-cli community +get_tag_trends`
 ```bash
 # Get tag trends
 ae-cli community +get_tag_trends \
-  --space-id 1 --game-id 1 \
+  --space-id 1 \
   --tag-code "game_version" \
   --start-time 2024-01-01 --end-time 2024-01-07
 ```

package/skills/ae-community/references/get_topic_detail.md

@@ -9,8 +9,8 @@ Mapping command: `ae-cli community +get_topic_detail`
 
 | Flag | Type | Required | Description |
 |------|------|------|------|
-| `--space-id` | number | yes | community space ID |
-| `--game-id` | number | yes | game/space ID |
+| `--space-id` | int64 | yes | Community space ID returned by `community spaces list` |
+| `--game-id` | int64 | no | Deprecated compatibility alias; omit it, or make it equal to `--space-id` |
 | `--topic-id` | string | yes | Topic ID, obtained from get_hot_topics |
 | `--start-time` | string | Yes | Statistics start date, format yyyy-MM-dd, priority is given to the start time of the topic |
 | `--end-time` | string | Yes | Statistics end date, format yyyy-MM-dd, priority is given to the end time of the topic |
@@ -20,7 +20,7 @@ Mapping command: `ae-cli community +get_topic_detail`
 ```bash
 # Get topic details
 ae-cli community +get_topic_detail \
-  --space-id 1 --game-id 1 \
+  --space-id 1 \
   --topic-id <topic-id> \
   --start-time 2024-01-01 --end-time 2024-01-07
 ```

package/skills/ae-community/references/list_sources.md

@@ -0,0 +1,28 @@
+# List Configured Community Sources
+
+Use this L2 command when an ingestion or reporting workflow needs the exact source and channel IDs
+configured in a selected community space.
+
+## Command
+
+```bash
+ae-cli community sources list --space-id <space-id>
+```
+
+## Input
+
+| Flag | Required | Description |
+|---|---|---|
+| `--space-id` | yes | Positive signed int64 space ID returned by `community spaces list`. |
+
+The command is backed by `community.source.list` and requires the product's data-configuration view
+permission. A permission error does not mean that the space has no data sources.
+
+## Output and next step
+
+Each source includes its `sourceId`, `sourceName`, `sourceType`, `channelId`, and `channelName`, plus
+the configured template/config metadata. Preserve every digit of IDs exactly.
+
+For `community data report`, select the source that matches the real data producer, then pass its
+`sourceId` as `--source-id` and its `channelId` as `--channel-id`. Do not choose a source by position
+in the list and never fabricate a missing source.

package/skills/ae-community/references/list_spaces.md

@@ -0,0 +1,39 @@
+# ae-community spaces list
+
+List the community spaces available to the authenticated user. Run this before curated community
+analysis when the real `spaceId` is unknown.
+
+Mapping command: `ae-cli community spaces list`
+
+Capability: `community.space.list`
+
+## Flags
+
+No command-specific flags are required. Authentication and host selection use the standard ae-cli
+configuration and global flags.
+
+## Example
+
+```bash
+ae-cli community spaces list
+```
+
+Use the returned `spaceId` as `--space-id` for `+get_channel_info` and the other curated commands.
+IDs outside JavaScript's safe integer range are emitted as strings in JSON. Copy all digits exactly
+and never convert an ID to a floating-point number.
+
+## Returned count and failures
+
+A successful array response includes `meta.returned_count`, calculated by the CLI from the number
+of entries in `data`. Use it when reporting how many entries this call returned; verify that the
+number matches the rows you display. It is not a global total or a count of unique space IDs.
+If the server also supplies `returned_count`, the CLI's array count takes precedence. Other server
+metadata, including `total` when present, is preserved with its original meaning.
+
+The count describes the original response before any `--jq` projection or filtering. If you filter
+the displayed rows locally, state the displayed count separately rather than presenting
+`meta.returned_count` as the filtered count.
+
+`ok: true`, `data: []`, and `meta.returned_count: 0` mean this successful call returned no visible
+spaces. Authentication, permission, routing, and capability failures remain failures; never turn
+them into an empty successful list or infer zero available spaces from an error.

package/skills/ae-community/references/search_posts.md

@@ -9,8 +9,8 @@ Mapping command: `ae-cli community +search_posts`
 
 | Flag | Type | Required | Description |
 |------|------|------|------|
-| `--space-id` | number | Yes | Community Space ID |
-| `--game-id` | number | Yes | Game/Space Logo |
+| `--space-id` | int64 | yes | Community space ID returned by `community spaces list` |
+| `--game-id` | int64 | no | Deprecated compatibility alias; omit it, or make it equal to `--space-id` |
 | `--channel-id-list` | string | No | List of channel IDs, comma separated |
 | `--keywords` | string | No | List of keywords, comma separated |
 | `--start-time` | string | Yes | Minimum content post time, format yyyy-MM-dd |
@@ -20,6 +20,8 @@ Mapping command: `ae-cli community +search_posts`
 | `--search-mode` | number | No | Search mode: 0 word (default), 1 exact match, 2 author names |
 | `--search-word` | string | No | Full-text search term, in conjunction with searchMode |
 | `--sentiment-types` | string | No | Emotion type: 0 negative, 1 positive, 2 neutral, comma separated |
+| `--topic-id-list` | string | No | Topic IDs returned by `+get_hot_topics`, comma separated |
+| `--tag-filters` | JSON | No | Corpus tag filter array using `tagName`, `tagCode`, `inferenceType`, `calcuSymbol`, and optional `ftv` |
 | `--order-by` | number | No | Sort: 0 time desc, 1 weight desc, 2 time asc, 3 replies desc, 4 heat desc |
 | `--page-num` | number | No | Page from 1 |
 | `--page-size` | number | No | Number of bars per page |
@@ -27,21 +29,33 @@ Mapping command: `ae-cli community +search_posts`
 Examples
 
 ```bash
-Basic search
+# Basic search
 ae-cli community +search_posts \
-  --space-id 1 --game-id 1 \
+  --space-id 1 \
   --start-time 2024-01-01 --end-time 2024-01-07
 
 # Filter by channel and sentiment
 ae-cli community +search_posts \
-  --space-id 1 --game-id 1 \
+  --space-id 1 \
   --start-time 2024-01-01 --end-time 2024-01-07 \
   --channel-id-list 1,2 \
   --sentiment-types 0,1
 
-Pagination Query
+# Pagination query
 ae-cli community +search_posts \
-  --space-id 1 --game-id 1 \
+  --space-id 1 \
   --start-time 2024-01-01 --end-time 2024-01-07 \
   --page-num 1 --page-size 20
+
+# Filter by topic and corpus tag
+ae-cli community +search_posts \
+  --space-id 1 \
+  --start-time 2024-01-01 --end-time 2024-01-07 \
+  --topic-id-list topic-1,topic-2 \
+  --tag-filters '[{"tagName":"Character","tagCode":"hero","inferenceType":"label","calcuSymbol":"C04"}]'
 ```
+
+`inferenceType` must be `label` or `score` and should be copied from `+get_corpus_tags`.
+Label filters support `C04` (has value) and `C05` (no value). Score filters support
+`C00`, `C01`, `C02`, `C020`, `C03`, `C030`, `C04`, `C05`, and `C06`; comparisons other
+than `C04`/`C05` require an `ftv` JSON array, and `C06` requires at least two values.

package/skills/ae-data-integration/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: ae-data-integration
-description: "Bring local CSV, TSV, TXT, JSON, JSONL (NDJSON), XLS, and XLSX files — and Feishu sheet / Bitable (多维表格) URLs — into AE end-to-end: identify the source's business meaning, generate and confirm a tracking plan, transform rows into UE records, and upload. Also supports privacy-preserving local analysis and handing a small file to AE Agent. Use whenever a user wants to import offline/local data or a Feishu sheet / Bitable into AE, or analyze a file without uploading it. Trigger words: 本地数据导入 / 离线数据 / 数据文件 / 文件导入 / 文件上报 / CSV 导入 / Excel 导入 / TSV 导入 / JSON 导入 / 飞书表格导入 / 在线表格导入 / 飞书多维表格导入 / 多维表格导入 / 在线多维表格导入 / 导入到 AE / 导入到 ThinkingAI / local data import / import local file / import Feishu sheet / import Feishu Bitable."
+description: "Bring local CSV, TSV, TXT, JSON, JSONL (NDJSON), XLS, XLSX, and Parquet files — and Feishu sheet / Bitable (多维表格) URLs — into AE end-to-end: identify the source's business meaning, generate and confirm a tracking plan, transform rows into UE records, and upload. Also supports privacy-preserving local analysis and handing a small file to AE Agent. Use whenever a user wants to import offline/local data or a Feishu sheet / Bitable into AE, or analyze a file without uploading it. Trigger words: 本地数据导入 / 离线数据 / 数据文件 / 文件导入 / 文件上报 / CSV 导入 / Excel 导入 / TSV 导入 / JSON 导入 / Parquet 导入 / 飞书表格导入 / 在线表格导入 / 飞书多维表格导入 / 多维表格导入 / 在线多维表格导入 / 导入到 AE / 导入到 ThinkingAI / local data import / import local file / parquet import / import Feishu sheet / import Feishu Bitable."
 ---
 
 # AE Data Integration
@@ -11,7 +11,7 @@ When remaining work is outside this skill's scope, or a necessary prerequisite n
 
 Turn local/offline files and Feishu sheet / Bitable (多维表格) URLs into AE data through one fixed pipeline of four submodules: **Source → Tracking plan → Transform → Sink**. A file or sheet is never uploaded merely because it is present: its business meaning is understood, confirmed once by a human, and only then ingested. The tracking plan is generated and confirmed **before** ingestion (data governance shift-left) — see [references/tracking-plan.md](references/tracking-plan.md).
 
-Two entrances lead here: the AE Agent dialog (attach / plus-button upload) and `ae-cli`. Two sink paths exist: RESTful API for one-time/small loads (current phase), and LogBus / DataX for recurring/high-volume loads (next phase). Source and Sink are pluggable — adding one does not change the main pipeline.
+Two entrances lead here: the AE Agent dialog (attach / plus-button upload) and `ae-cli`. Two sink paths exist: RESTful `/sync_json` upload for one-time/small loads, and file / LogBus2 delivery (convert-only — writes `valid.ue.jsonl` to a watched directory, never uploads) for recurring/high-volume loads. Which path applies is always the user's choice, never a default. Source and Sink are pluggable — adding one does not change the main pipeline.
 
 ## Mandatory safety rules
 
@@ -31,7 +31,7 @@ Two entrances lead here: the AE Agent dialog (attach / plus-button upload) and `
 
 ## When to use / When NOT to use
 
-Use this skill when the user wants to bring a **local data file** (CSV/TSV/TXT/JSON/JSONL/XLS/XLSX) or a **Feishu sheet / Bitable (多维表格) URL** into AE, or analyze a local file without uploading.
+Use this skill when the user wants to bring a **local data file** (CSV/TSV/TXT/JSON/JSONL/XLS/XLSX/Parquet) or a **Feishu sheet / Bitable (多维表格) URL** into AE, or analyze a local file without uploading.
 
 | User intent | Use this instead |
 | --- | --- |
@@ -53,7 +53,9 @@ Walk the four submodules in order. Each submodule is its own reference; follow i
 2. **Reuse check.** If the profile is `ue_eligible`, read [references/reuse.md](references/reuse.md) and match the recommended mapping against the handoff index. `reuse` searches the current directory's `.ae-cli/data-integration/` upward, then `~/.ae-cli/data-integration/`, so a package written elsewhere is still found. A match proposes a frozen package; after one explicit confirmation, run the returned `transform.mjs` command and jump to Sink (step 5). No match → continue.
 3. **Tracking plan.** Read [references/tracking-plan.md](references/tracking-plan.md). The plan is generated from the mapping (`plan --mapping`), so confirm the recommended mapping's key system fields with the user first — `mode`, `#account_id`/`#distinct_id`, `#time` + timezone, `#event_name`, `#ip`/`#uuid` (see [references/transform.md](references/transform.md) steps 1–5) — then generate the event/property plan and get a single explicit confirmation from the user before touching data. The plan is a separate, required deliverable from the transform mapping: a user who supplies a column→field mapping directly has **not** completed this step, so build the plan from the confirmed mapping anyway. `user_set` still requires a plan (no events; every property becomes a user property). This step runs for **every** file: a second or later file merges its new events and properties into the existing project plan (tracking-plan.md step 4) — an existing plan is never a reason to skip it.
 4. **Transform.** Read [references/transform.md](references/transform.md). Map columns to AE system fields and properties, convert, and quarantine dirty rows per [references/ue-mapping.md](references/ue-mapping.md).
-5. **Sink — upload.** Read [references/sink-upload.md](references/sink-upload.md). Resolve the destination, dry-run, confirm, then upload per [references/sync-json-upload.md](references/sync-json-upload.md). `receiver_accepted` is not persistence: after a ~1-minute ingestion delay, verify the data landed with ae-cli (`tracking live-data list` / `tracking ingest summary` / `tracking ingest-error list`) rather than telling the user to check the console.
+5. **Sink — choose the path first, then act.** Read [references/sink-upload.md](references/sink-upload.md). Before resolving any destination, ask the user which sink path this data takes — never default one silently (the user handing you an endpoint/APPID is not a sink decision):
+   - **RESTful `/sync_json` upload** — one-time / small loads. Resolve the destination, dry-run, confirm, then upload per [references/sync-json-upload.md](references/sync-json-upload.md). `receiver_accepted` is not persistence: after a ~1-minute ingestion delay, verify the data landed with ae-cli (`tracking live-data list` / `tracking ingest summary` / `tracking ingest-error list`) rather than telling the user to check the console.
+   - **File / LogBus2 mode — JSONL only, never uploads** — recurring / high-volume loads (e.g. daily parquet exports). Run `convert` (or the handoff `bin/run.sh`) so `valid.ue.jsonl` lands in the directory LogBus2 watches — never `upload.sh`, which posts to the RESTful receiver. Use the output directory confirmed in step 4. The same rows must not go through both paths: RESTful upload plus LogBus2 pickup double-ingests.
 6. **Handoff.** Read [references/handoff.md](references/handoff.md). Export the reusable package (pipeline descriptor + frozen mappings + stage executors + docs) and a shareable zip; in the completion response, state the absolute zip path, the package directory, and the one-line way to run the next same-shape file.
 
 ## Error handling

package/skills/ae-data-integration/references/error-handling.md

@@ -50,6 +50,7 @@ the user decide — never to guess an encoding or structure and retry silently.
 | `LOCAL_DATA_INPUT_NOT_FOUND` | Path is not a readable file | Ask for the correct path |
 | `LOCAL_DATA_FILE_TOO_LARGE` | XLS over 1 GB | Convert to XLSX or split the workbook |
 | `LOCAL_DATA_INPUT_INVALID` | Generic parse failure (malformed CSV/TSV/JSON/XLS) | Verify encoding and structure, then retry without changing the source |
+| `LOCAL_DATA_PARQUET_INVALID` | File cannot be read as Parquet | Verify the file is a valid Parquet file and retry without changing the source |
 | `LOCAL_DATA_JSONL_INVALID` | A JSONL line is not valid JSON (`location.record` names the line) | Point at the offending record |
 | `LOCAL_DATA_JSON_ROOT_INVALID` | JSON root is not an object or array | Check the file's top-level shape |
 | `LOCAL_DATA_XLSX_INVALID` | Workbook metadata missing / no readable sheets / worksheet entry missing | Re-export the workbook (sheet recognition accepts `<sheet>` and namespaced `<x:sheet>` alike, so this is a real metadata gap) |

package/skills/ae-data-integration/references/handoff.md

@@ -48,7 +48,7 @@ A shareable archive is written next to the package root: `<parent>/ae-data-integ
 
 ## Pipeline descriptor
 
-`pipeline.json` declares the three stages and their types. Only `source: local_file` and `sink: restful_sync_json` are implemented today; the `type` fields reserve logbus / datax / mysql for later phases. `bin/run.sh` and `bin/upload.sh` read the descriptor and dispatch each stage by its `type` to `ae-cli data-integration inspect / convert / upload` — they are executors, not a second runtime engine.
+`pipeline.json` declares the three stages and their types. Only `source: local_file` and `sink: restful_sync_json` are implemented today; the `type` fields reserve logbus / datax / mysql for later phases. `bin/run.sh` and `bin/upload.sh` read the descriptor and dispatch each stage by its `type` to `ae-cli data-integration inspect / convert / upload` — they are executors, not a second runtime engine. A Parquet source runs the same `local_file` path: `bin/run.sh` converts it to `valid.ue.jsonl` on disk. When the destination is LogBus2 (or any file-watch sink), hand the runs directory to it and **never run `bin/upload.sh`**, which posts to the RESTful receiver.
 
 ## Recorded destination