siluzan-cso-cli 1.1.12 → 1.1.14

package/dist/skill/assets//347/203/271/350/260/203/346/226/271/346/263/225/345/272/223.md

@@ -176,4 +176,4 @@
 - **产品资产库**回答：有什么可用模板。
 - **烹调方法库**回答：怎么把模板做成内容。
 
-二者配合，才是完整的内容生产流程。
+二者配合，才是完整的内容生产流程。

package/dist/skill/references/account-group.md

@@ -10,11 +10,11 @@
 
 `list-accounts --json` 输出的每个账号对象中有多个 ID 字段，**极易混淆**：
 
-| 字段 | 示例值 | 用途 |
-|------|--------|------|
-| `mediaCustomerId` | `UCg3_FESu2sADBKq4WKGozug` | ✅ **account-group 的 `--accounts` 参数用这个** |
-| `entityId` | `a2ace2a2-00c1-478d-a991-...`（UUID） | 发布配置 `accounts[].entityId`，**不是这个** |
-| `externalMediaAccountTokenId` | `f4f687..`（UUID） | 发布配置 `accounts[].externalMediaAccountTokenId`，**不是这个** |
+| 字段                          | 示例值                                | 用途                                                            |
+| ----------------------------- | ------------------------------------- | --------------------------------------------------------------- |
+| `mediaCustomerId`             | `UCg3_FESu2sADBKq4WKGozug`            | ✅ **account-group 的 `--accounts` 参数用这个**                 |
+| `entityId`                    | `a2ace2a2-00c1-478d-a991-...`（UUID） | 发布配置 `accounts[].entityId`，**不是这个**                    |
+| `externalMediaAccountTokenId` | `f4f687..`（UUID）                    | 发布配置 `accounts[].externalMediaAccountTokenId`，**不是这个** |
 
 **操作流程：**
 
@@ -31,16 +31,16 @@ siluzan-cso account-group create --name "分组名" --accounts "mediaCustomerId1
 
 ## 常用场景速查
 
-| 用户意图 | 命令 |
-|----------|------|
-| 查看所有分组 | `siluzan-cso account-group list` |
-| 查某分组内有哪些账号 | `siluzan-cso account-group list --json` |
-| 新建空分组 | `siluzan-cso account-group create --name <名称>` |
-| 新建分组并添加账号 | `siluzan-cso account-group create --name <名称> --accounts <id1,id2>` |
-| **向已有分组追加账号（不影响其他账号）** | `siluzan-cso account-group add-accounts --id <groupId> --accounts <ids>` |
-| **从分组移除指定账号（不影响其他账号）** | `siluzan-cso account-group remove-accounts --id <groupId> --accounts <ids>` |
-| 全量替换分组账号列表 | `siluzan-cso account-group update --id <groupId> --name <名称> --accounts <ids>` |
-| 删除分组 | `siluzan-cso account-group delete --id <groupId>` |
+| 用户意图                                 | 命令                                                                             |
+| ---------------------------------------- | -------------------------------------------------------------------------------- |
+| 查看所有分组                             | `siluzan-cso account-group list`                                                 |
+| 查某分组内有哪些账号                     | `siluzan-cso account-group list --json`                                          |
+| 新建空分组                               | `siluzan-cso account-group create --name <名称>`                                 |
+| 新建分组并添加账号                       | `siluzan-cso account-group create --name <名称> --accounts <id1,id2>`            |
+| **向已有分组追加账号（不影响其他账号）** | `siluzan-cso account-group add-accounts --id <groupId> --accounts <ids>`         |
+| **从分组移除指定账号（不影响其他账号）** | `siluzan-cso account-group remove-accounts --id <groupId> --accounts <ids>`      |
+| 全量替换分组账号列表                     | `siluzan-cso account-group update --id <groupId> --name <名称> --accounts <ids>` |
+| 删除分组                                 | `siluzan-cso account-group delete --id <groupId>`                                |
 
 ---
 

package/dist/skill/references/authorize.md

@@ -21,15 +21,14 @@ siluzan-cso authorize --media-type Twitter    # X（推特）
 
 ## 支持的平台
 
-| 用户说法 | `--media-type` 参数值 | 备注 |
-|----------|----------------------|------|
-| YouTube | `YouTube` | |
-| TikTok | `TikTokBusinessAccount` | ⚠️ 必须用这个值，传 `TikTok` 会跳到错误的授权页 |
-| Instagram / IG | `Instagram` | |
-| Facebook / FB | `Facebook` | |
-| LinkedIn | `LinkedIn` | |
-| Twitter（即 X / 推特，同一平台） | `Twitter` | Twitter 已更名为 X，前端显示为"X"，但 API 参数固定为 `Twitter` |
-
+| 用户说法                         | `--media-type` 参数值   | 备注                                                           |
+| -------------------------------- | ----------------------- | -------------------------------------------------------------- |
+| YouTube                          | `YouTube`               |                                                                |
+| TikTok                           | `TikTokBusinessAccount` | ⚠️ 必须用这个值，传 `TikTok` 会跳到错误的授权页                |
+| Instagram / IG                   | `Instagram`             |                                                                |
+| Facebook / FB                    | `Facebook`              |                                                                |
+| LinkedIn                         | `LinkedIn`              |                                                                |
+| Twitter（即 X / 推特，同一平台） | `Twitter`               | Twitter 已更名为 X，前端显示为"X"，但 API 参数固定为 `Twitter` |
 
 ---
 

package/dist/skill/references/extract-cover.md

@@ -28,17 +28,17 @@ siluzan-cso extract-cover -f video.mp4 -p youtube -t 3 -o /path/to/output/
 
 ## 平台规格速查
 
-| 平台 ID（`-p` 参数） | 平台名称 | 尺寸 | 比例 |
-|----------------------|----------|------|------|
-| `youtube` | YouTube | 1280×720 | 16:9 |
-| `youtube-shorts` | YouTube Shorts | 1080×1920 | 9:16 |
-| `tiktok` | TikTok | 1080×1920 | 9:16 |
-| `twitter` | Twitter / X | 1280×720 | 16:9 |
-| `facebook` | Facebook | 1280×720 | 16:9 |
-| `instagram` | Instagram | 1080×1080 | 1:1 |
-| `instagram-portrait` | Instagram Portrait | 1080×1350 | 4:5 |
-| `douyin` | 抖音 (Douyin) | 1080×1920 | 9:16 |
-| `channel` | 微信视频号 | 1080×1440 | 3:4 |
+| 平台 ID（`-p` 参数） | 平台名称           | 尺寸      | 比例 |
+| -------------------- | ------------------ | --------- | ---- |
+| `youtube`            | YouTube            | 1280×720  | 16:9 |
+| `youtube-shorts`     | YouTube Shorts     | 1080×1920 | 9:16 |
+| `tiktok`             | TikTok             | 1080×1920 | 9:16 |
+| `twitter`            | Twitter / X        | 1280×720  | 16:9 |
+| `facebook`           | Facebook           | 1280×720  | 16:9 |
+| `instagram`          | Instagram          | 1080×1080 | 1:1  |
+| `instagram-portrait` | Instagram Portrait | 1080×1350 | 4:5  |
+| `douyin`             | 抖音 (Douyin)      | 1080×1920 | 9:16 |
+| `channel`            | 微信视频号         | 1080×1440 | 3:4  |
 
 > 完整规格（含文件大小限制等）运行 `siluzan-cso extract-cover --list-platforms` 查看。
 
@@ -48,10 +48,10 @@ siluzan-cso extract-cover -f video.mp4 -p youtube -t 3 -o /path/to/output/
 
 加 `--upload` 后自动上传，输出：
 
-| 字段 | 用途 |
-|------|------|
+| 字段            | 用途                           |
+| --------------- | ------------------------------ |
 | `sourceImageId` | 发布配置 `cover.sourceImageId` |
-| `imageUrl` | 发布配置 `cover.imageUrl` |
+| `imageUrl`      | 发布配置 `cover.imageUrl`      |
 
 ---
 

package/dist/skill/references/list-accounts.md

@@ -6,30 +6,30 @@
 
 ## 常用场景速查
 
-| 用户意图 | 命令 |
-|----------|------|
-| 查所有账号总览（粉丝/播放/获赞横向对比） | `siluzan-cso list-accounts` |
-| 按平台筛选账号 | `siluzan-cso list-accounts --media-type <平台>` |
-| 按名称搜索账号 | `siluzan-cso list-accounts --name "账号名"` |
-| 获取账号完整字段（用于发布配置或脚本） | `siluzan-cso list-accounts --json` |
-| 精准定位单个账号（名称 + 平台） | `siluzan-cso list-accounts --name "账号名" --media-type YouTube --json` |
-| 只看异常/过期账号 | `siluzan-cso list-accounts --state abnormal` |
-| 只展示基础信息（隐藏总览数据） | `siluzan-cso list-accounts --no-overview` |
+| 用户意图                                 | 命令                                                                    |
+| ---------------------------------------- | ----------------------------------------------------------------------- |
+| 查所有账号总览（粉丝/播放/获赞横向对比） | `siluzan-cso list-accounts`                                             |
+| 按平台筛选账号                           | `siluzan-cso list-accounts --media-type <平台>`                         |
+| 按名称搜索账号                           | `siluzan-cso list-accounts --name "账号名"`                             |
+| 获取账号完整字段（用于发布配置或脚本）   | `siluzan-cso list-accounts --json`                                      |
+| 精准定位单个账号（名称 + 平台）          | `siluzan-cso list-accounts --name "账号名" --media-type YouTube --json` |
+| 只看异常/过期账号                        | `siluzan-cso list-accounts --state abnormal`                            |
+| 只展示基础信息（隐藏总览数据）           | `siluzan-cso list-accounts --no-overview`                               |
 
 ---
 
 ## 平台名称对照表
 
-| 用户常说 | `--media-type` 参数值 |
-|----------|-----------------------|
-| 抖音 | `Douyin` |
-| TikTok | `TikTokBusinessAccount` |
-| YouTube | `YouTube` |
-| 微信视频号 / 视频号 | `Wechat` |
-| Instagram / IG | `Instagram` |
-| Facebook / FB | `Facebook` |
-| Twitter / X（同一平台，Twitter 已更名为 X） | `Twitter` |
-| Kwai / 快手 | `Kwai` |
+| 用户常说                                    | `--media-type` 参数值   |
+| ------------------------------------------- | ----------------------- |
+| 抖音                                        | `Douyin`                |
+| TikTok                                      | `TikTokBusinessAccount` |
+| YouTube                                     | `YouTube`               |
+| 微信视频号 / 视频号                         | `Wechat`                |
+| Instagram / IG                              | `Instagram`             |
+| Facebook / FB                               | `Facebook`              |
+| Twitter / X（同一平台，Twitter 已更名为 X） | `Twitter`               |
+| Kwai / 快手                                 | `Kwai`                  |
 
 > 同一平台名称在 `--media-type`（list-accounts）和 `report fetch --media` 中通用。
 
@@ -39,18 +39,18 @@
 
 `--json` 输出的每个账号对象中，常用字段如下：
 
-| 字段 | 用途 |
-|------|------|
-| `entityId` | 发布配置 `accounts[].entityId`（UUID 格式） |
-| `mediaCustomerId` | `report fetch --maids <id>` 的参数；也用于账号分组 |
-| `mediaAccountType` | 发布配置 `accounts[].mediaAccountType`；`--media-type` 参数值 |
-| `mediaCustomerName` | 发布配置 `accounts[].mediaCustomerName` |
-| `externalMediaAccountTokenId` | 发布配置 `accounts[].externalMediaAccountTokenId`（UUID 格式） |
-| `invalidOAuthToken` | `true` 表示 Token 已失效，需重新授权（参见 `references/authorize.md`） |
-| `expiresOn` | Token 到期时间 |
-| `overview.fansCount` | 当前粉丝数 |
-| `overview.videoCount` | 发布作品总数 |
-| `overview.playCount` | 历史总播放数 |
+| 字段                          | 用途                                                                   |
+| ----------------------------- | ---------------------------------------------------------------------- |
+| `entityId`                    | 发布配置 `accounts[].entityId`（UUID 格式）                            |
+| `mediaCustomerId`             | `report fetch --maids <id>` 的参数；也用于账号分组                     |
+| `mediaAccountType`            | 发布配置 `accounts[].mediaAccountType`；`--media-type` 参数值          |
+| `mediaCustomerName`           | 发布配置 `accounts[].mediaCustomerName`                                |
+| `externalMediaAccountTokenId` | 发布配置 `accounts[].externalMediaAccountTokenId`（UUID 格式）         |
+| `invalidOAuthToken`           | `true` 表示 Token 已失效，需重新授权（参见 `references/authorize.md`） |
+| `expiresOn`                   | Token 到期时间                                                         |
+| `overview.fansCount`          | 当前粉丝数                                                             |
+| `overview.videoCount`         | 发布作品总数                                                           |
+| `overview.playCount`          | 历史总播放数                                                           |
 
 ---
 

package/dist/skill/references/persona.md

@@ -8,23 +8,23 @@
 siluzan-cso persona list [选项]
 ```
 
-| 选项 | 说明 |
-|------|------|
+| 选项                  | 说明                                          |
+| --------------------- | --------------------------------------------- |
 | `-t, --token <token>` | 凭据（可选，默认读 `~/.siluzan/config.json`） |
-| `--id <id>` | 只显示指定人设 id |
-| `--name <text>` | 按人设名称子串过滤（客户端过滤） |
-| `--json` | 输出完整 JSON（含完整 `styleGuide`） |
-| `--unicode` | 表格使用 Unicode 线框 |
-| `--verbose` | 打印详细错误 |
+| `--id <id>`           | 只显示指定人设 id                             |
+| `--name <text>`       | 按人设名称子串过滤（客户端过滤）              |
+| `--json`              | 输出完整 JSON（含完整 `styleGuide`）          |
+| `--unicode`           | 表格使用 Unicode 线框                         |
+| `--verbose`           | 打印详细错误                                  |
 
 ## 字段说明
 
-| 字段 | 含义 |
-|------|------|
-| `personaName` | 人设名称 |
-| `styleGuide` | 风格指南正文（Markdown） |
-| `materials` | 参考素材（文件名、URL 等） |
-| `taskStatus` | `1` 待生成 · `2` 生成中 · `3` 生成完成 · `4` 生成失败 |
+| 字段          | 含义                                                  |
+| ------------- | ----------------------------------------------------- |
+| `personaName` | 人设名称                                              |
+| `styleGuide`  | 风格指南正文（Markdown）                              |
+| `materials`   | 参考素材（文件名、URL 等）                            |
+| `taskStatus`  | `1` 待生成 · `2` 生成中 · `3` 生成完成 · `4` 生成失败 |
 
 终端表格仅展示 `styleGuide` 摘要；需要全文时用 `--json`。
 

package/dist/skill/references/planning.md

@@ -14,19 +14,19 @@ enterprises → generate → watch（监控进度）→ get（查看详情）→
 
 ## 命令速查
 
-| 命令 | 说明 |
-|------|------|
-| `planning enterprises` | 查询企业目录（生成前先选企业） |
-| `planning content-types` | 查询可用内容类型（post / video） |
-| `planning generate` | 创建规划生成任务 |
-| `planning watch <taskId>` | 监听生成任务进度（SSE 实时推送） |
-| `planning list` | 查询规划任务列表 |
-| `planning get <planId>` | 获取规划详情 |
-| `planning regenerate <planId>` | 对已有规划重新生成 |
-| `planning task cancel <taskId>` | 取消任务 |
-| `planning task retry <taskId>` | 重试失败/取消的任务 |
-| `planning task delete <taskId>` | 删除任务 |
-| `planning export txt` | 导出规划为 TXT（Markdown 表格格式） |
+| 命令                            | 说明                                |
+| ------------------------------- | ----------------------------------- |
+| `planning enterprises`          | 查询企业目录（生成前先选企业）      |
+| `planning content-types`        | 查询可用内容类型（post / video）    |
+| `planning generate`             | 创建规划生成任务                    |
+| `planning watch <taskId>`       | 监听生成任务进度（SSE 实时推送）    |
+| `planning list`                 | 查询规划任务列表                    |
+| `planning get <planId>`         | 获取规划详情                        |
+| `planning regenerate <planId>`  | 对已有规划重新生成                  |
+| `planning task cancel <taskId>` | 取消任务                            |
+| `planning task retry <taskId>`  | 重试失败/取消的任务                 |
+| `planning task delete <taskId>` | 删除任务                            |
+| `planning export txt`           | 导出规划为 TXT（Markdown 表格格式） |
 
 ---
 
@@ -59,19 +59,19 @@ siluzan-cso planning export txt --plan-id <planId> --output plan.md
 
 ## generate 主要参数
 
-| 参数 | 必填 | 说明 |
-|------|------|------|
-| `--enterprise-id` | ✅ | 企业 ID |
-| `--year-month` | ✅ | 规划月份，格式 `YYYY-MM` |
-| `--content-types` | ✅ | 内容类型，逗号分隔：`post`（图文）/ `video`（视频） |
-| `--marketing-goal` | — | 营销目标（自然语言描述） |
-| `--key-products` | — | 重点产品 |
-| `--target-markets` | — | 目标市场 |
-| `--key-events` | — | 重要节点/活动 |
-| `--content-tone` | — | 内容风格（如"专业严肃"/"轻松活泼"） |
-| `--freq-unit` | — | 发布频率单位：`week` / `month` |
-| `--freq-count` | — | 发布频率数量（与 `--freq-unit` 同时使用） |
-| `--watch` | — | 生成后自动监听进度，无需单独执行 watch |
+| 参数               | 必填 | 说明                                                |
+| ------------------ | ---- | --------------------------------------------------- |
+| `--enterprise-id`  | ✅   | 企业 ID                                             |
+| `--year-month`     | ✅   | 规划月份，格式 `YYYY-MM`                            |
+| `--content-types`  | ✅   | 内容类型，逗号分隔：`post`（图文）/ `video`（视频） |
+| `--marketing-goal` | —    | 营销目标（自然语言描述）                            |
+| `--key-products`   | —    | 重点产品                                            |
+| `--target-markets` | —    | 目标市场                                            |
+| `--key-events`     | —    | 重要节点/活动                                       |
+| `--content-tone`   | —    | 内容风格（如"专业严肃"/"轻松活泼"）                 |
+| `--freq-unit`      | —    | 发布频率单位：`week` / `month`                      |
+| `--freq-count`     | —    | 发布频率数量（与 `--freq-unit` 同时使用）           |
+| `--watch`          | —    | 生成后自动监听进度，无需单独执行 watch              |
 
 ---
 

package/dist/skill/references/publish.md

@@ -24,6 +24,7 @@ siluzan-cso config show
 > "请问这次要发布的是 **视频** 还是 **图文**（图片+文案）？"
 
 根据用户回答确定 `contentType`：
+
 - 视频 → `contentType: 1`
 - 图文 → `contentType: 2`
 
@@ -41,6 +42,7 @@ siluzan-cso list-accounts
 > "以上是可用账号，请告诉我要发布到哪些账号（可多选）？"
 
 注意：
+
 - 过期账号（`到期`日期已过）不可选，告知用户
 - 记住用户选择的账号 `entityId`，后续写入配置文件
 
@@ -99,6 +101,7 @@ siluzan-cso upload -f /path/to/video.mp4 --cover /path/to/cover.jpg
 ### 文案编写与润色
 
 文案对应配置文件中的 `title` 字段（视频和图文均如此）：
+
 - `title`：所有平台共用的主文案/标题
 - `description`：YouTube、Facebook 专有的独立描述（其他平台忽略）
 - `topics`：话题标签数组，如 `["美妆", "TikTok"]`
@@ -111,11 +114,13 @@ AI 可直接帮助润色：加钩子开头、适配平台风格、加 SEO 关键
 ### 定时发布 vs 立即发布
 
 **立即发布**
+
 ```json
 "publishMode": "immediate"
 ```
 
 **定时发布**
+
 ```json
 "publishMode": "scheduled",
 "publishAt": "2026-04-08T10:00:00+08:00"
@@ -123,14 +128,15 @@ AI 可直接帮助润色：加钩子开头、适配平台风格、加 SEO 关键
 
 `publishAt` 时间格式：**ISO 8601，必须包含时区**，中国时间后缀 `+08:00`。
 
-| 用户说 | publishAt 值 |
-|--------|-------------|
-| 明天上午 10 点（北京时间） | `2026-04-08T10:00:00+08:00` |
+| 用户说                      | publishAt 值                |
+| --------------------------- | --------------------------- |
+| 明天上午 10 点（北京时间）  | `2026-04-08T10:00:00+08:00` |
 | 后天下午 3 点半（北京时间） | `2026-04-09T15:30:00+08:00` |
 
 > AI 须根据今天日期自动推算"明天"、"后天"等相对时间，不需要让用户手动输入 ISO 格式。
 
 **多平台不同时间发布**
+
 ```json
 "publishMode": "scheduled",
 "publishAt": "2026-04-08T10:00:00+08:00",
@@ -149,11 +155,12 @@ AI 可直接帮助润色：加钩子开头、适配平台风格、加 SEO 关键
 将收集到的信息汇总展示给用户：
 
 > "我将为你创建以下发布任务，请确认：
+>
 > - 类型：视频 / 图文
 > - 账号：XXX（YouTube）
 > - 标题：XXX
 > - 发布方式：立即 / 定时（时间）
-> 确认提交？"
+>   确认提交？"
 
 ---
 
@@ -166,12 +173,12 @@ AI 可直接帮助润色：加钩子开头、适配平台风格、加 SEO 关键
 
 以下字段后端会做严格 GUID 格式校验，填写错误将导致 HTTP 500：
 
-| 字段 | 来源 |
-|------|------|
-| `accounts[].entityId` | `list-accounts --json` 的 `entityId` 字段 |
+| 字段                                     | 来源                                                         |
+| ---------------------------------------- | ------------------------------------------------------------ |
+| `accounts[].entityId`                    | `list-accounts --json` 的 `entityId` 字段                    |
 | `accounts[].externalMediaAccountTokenId` | `list-accounts --json` 的 `externalMediaAccountTokenId` 字段 |
-| `videos[].videoId` | `upload` 命令返回的 `videoId` |
-| `cover.sourceImageId` | `upload` 命令返回的 `sourceImageId` |
+| `videos[].videoId`                       | `upload` 命令返回的 `videoId`                                |
+| `cover.sourceImageId`                    | `upload` 命令返回的 `sourceImageId`                          |
 
 > `mediaCustomerId` 不是 UUID，是各平台账号 ID，直接填写即可。
 
@@ -192,6 +199,7 @@ siluzan-cso publish -c publish-config.json
 ```
 
 成功后：
+
 1. 记录返回的**任务 ID（publishId）**，后续查询状态时需要用到
 2. 告知用户：
    - 立即发布：正在发布，可用 `siluzan-cso task list` 查看进度

package/dist/skill/references/rag.md

@@ -1,6 +1,7 @@
 # rag：RAG 知识库检索
 
 与 Siluzan-RAG-sys-ui `MultiFileChat.vue` / `queryKnowledges` 一致，用于写稿、产品知识问答、三库素材提取等场景。
+其他任意时刻，你觉得需要查询知识库的场景
 
 ## 命令速览
 
@@ -15,13 +16,13 @@ siluzan-cso rag query -q "<关键词>"                          # 全库 + 三
 
 ## 参数说明
 
-| 选项 | 默认 | 说明 |
-|------|------|------|
-| `-q, --query` | 必填 | 检索关键词或短句（越具体越好，避免长段落） |
-| `--folder-id` | 全库 | 指定一个或多个文件夹 ID（逗号分隔），锁定检索范围 |
-| `--tags` | 不过滤 | 不传 = 全量检索（无标签限制）；传具体标签 = 只返回含该标签的片段 |
-| `--top-k` | 7 | 每次返回条数，3–30；复杂问题建议调高到 10–15 |
-| `--json` | false | 输出完整 JSON，适合程序处理 |
+| 选项          | 默认   | 说明                                                             |
+| ------------- | ------ | ---------------------------------------------------------------- |
+| `-q, --query` | 必填   | 检索关键词或短句（越具体越好，避免长段落）                       |
+| `--folder-id` | 全库   | 指定一个或多个文件夹 ID（逗号分隔），锁定检索范围                |
+| `--tags`      | 不过滤 | 不传 = 全量检索（无标签限制）；传具体标签 = 只返回含该标签的片段 |
+| `--top-k`     | 7      | 每次返回条数，3–30；复杂问题建议调高到 10–15                     |
+| `--json`      | false  | 输出完整 JSON，适合程序处理                                      |
 
 ---
 
@@ -32,11 +33,13 @@ siluzan-cso rag query -q "<关键词>"                          # 全库 + 三
 ### 1. 判断是否需要 RAG
 
 **需要 RAG 的场景：**
+
 - 用户询问特定品牌/产品的信息（"海科佳的产品有哪些卖点"）
 - 需要基于公司素材库写文案、口播稿、选题
 - 执行三库内容工作流（流量因子库/产品资产库/烹调方法库）
 
 **不需要 RAG 的场景：**
+
 - 询问平台功能、操作方法（查 references 文档即可）
 - 纯创意写作、无需依赖品牌素材的通用内容
 - 用户明确说"不用查知识库"
@@ -47,12 +50,12 @@ siluzan-cso rag query -q "<关键词>"                          # 全库 + 三
 
 先运行 `siluzan-cso rag list --rag-only --json` 获取列表，再按以下规则匹配：
 
-| 用户意图 | 文件夹选择策略 |
-|----------|----------------|
-| 明确提到某品牌/产品名 | 找名称最匹配的文件夹，用 `--folder-id <id>` 锁定 |
-| 没有指定品牌，做通用内容 | 不传 `--folder-id`（全库检索） |
-| 需要公司公共素材（总部公共库） | 不传 `--folder-id`，isGlobal 已覆盖公共库 |
-| 用户提到多个品牌 | `--folder-id <id1>,<id2>` 同时检索 |
+| 用户意图                       | 文件夹选择策略                                   |
+| ------------------------------ | ------------------------------------------------ |
+| 明确提到某品牌/产品名          | 找名称最匹配的文件夹，用 `--folder-id <id>` 锁定 |
+| 没有指定品牌，做通用内容       | 不传 `--folder-id`（全库检索）                   |
+| 需要公司公共素材（总部公共库） | 不传 `--folder-id`，isGlobal 已覆盖公共库        |
+| 用户提到多个品牌               | `--folder-id <id1>,<id2>` 同时检索               |
 
 > 文件夹名称匹配优先：语义近似 > 包含关键词 > 不确定时全库。
 
@@ -62,7 +65,7 @@ siluzan-cso rag query -q "<关键词>"                          # 全库 + 三
 
 **默认行为（不传 `--tags`）= 不过滤标签 = 全量检索**，适用于绝大多数场景。
 
-只有在知识库**已按标签打标**，且用户明确需要**精确筛选某类内容**时，才传具体标签：
+只有在知识库**已按标签打标**，且用户明确需要**精确筛选某类内容**时，才传具体标签：如果误传不存在的tag会导致查不到任何内容
 
 ```bash
 # 只检索打了"流量因子库"标签的片段
@@ -82,6 +85,7 @@ siluzan-cso rag query -q "海科佳产品特点"
 单次检索语义受限，**同一个问题应拆分为 2–5 个独立关键词并行检索**，每个关键词聚焦一个子维度：
 
 **示例 1：写产品口播文案**
+
 ```
 用户意图 → "帮我写海科佳产品的口播文案"
 
@@ -93,6 +97,7 @@ siluzan-cso rag query -q "海科佳产品特点"
 ```
 
 **示例 2：三库选题（知识库已按三库打标）**
+
 ```
 用户意图 → "给我找抖音爆款选题角度"
 
@@ -105,6 +110,7 @@ siluzan-cso rag query -q "海科佳产品特点"
 ```
 
 **示例 3：回答品牌知识问题**
+
 ```
 用户意图 → "成功易是做什么的"
 
@@ -115,6 +121,7 @@ siluzan-cso rag query -q "海科佳产品特点"
 ```
 
 **拆词规则：**
+
 - 每个子查询 **2–6 个字**，过长的句子效果反而差
 - 避免重复语义（"卖点"和"优势"只选一个）
 - 优先具体名词，避免虚词（不要查"的"、"是"、"如何"）
@@ -128,7 +135,7 @@ siluzan-cso rag query -q "海科佳产品特点"
 
 1. **去重**：相似度分数相同且内容高度重合的片段只保留一条
 2. **分类归档**：按检索关键词分组（例如：卖点类、场景类、情绪类）
-3. **优先级**：相似度分数（`score` 字段，越接近 0 越相关）较低的片段排前
+3. **优先级**：`rag query` 的 `--json` 与 Markdown 中，`score` 已为 **1 − 接口原始分** 并限制在 0–1，**越大越相关**；合并结果时优先采用 `score` 更高的片段
 4. **引用而非复制**：将片段作为信息来源重新组织表达，不直接粘贴原文
 5. **结果为空时**：尝试更换关键词（同义替换、扩大范围），或告知用户知识库中暂无相关内容
 
@@ -157,10 +164,10 @@ siluzan-cso rag query -q "产品使用场景" --folder-id affe64c5-d3d4-4cec-ab3
 
 三库写稿流程（见 `three-lib-content-workflow/content-writer.workflow.md`）可以调用 RAG 检索作为素材来源。若知识库已按三库体系打标，可按标签精确分库：
 
-| 三库 | 对应 `--tags` | 检索内容 |
-|------|--------------|----------|
+| 三库       | 对应 `--tags`         | 检索内容                     |
+| ---------- | --------------------- | ---------------------------- |
 | 流量因子库 | `--tags "流量因子库"` | 平台趋势、爆款钩子、流量密码 |
-| 产品资产库 | `--tags "产品资产库"` | 产品特性、卖点、品牌故事 |
+| 产品资产库 | `--tags "产品资产库"` | 产品特性、卖点、品牌故事     |
 | 烹调方法库 | `--tags "烹调方法库"` | 内容结构、创作手法、情绪设计 |
 
 **若知识库未打三库标签，直接不传 `--tags`，全量检索后按内容性质自行归类。**

package/dist/skill/references/report.md

@@ -7,28 +7,28 @@
 
 ## 常用场景速查
 
-| 用户意图 | 命令 |
-|----------|------|
-| 查某账号近期运营数据 | `siluzan-cso report fetch --media <平台> --maids <账号ID>` |
-| 查整个平台的汇总数据 | `siluzan-cso report fetch --media <平台>` |
-| 近 N 天数据 | `siluzan-cso report fetch --media <平台> --days <N>` |
-| 哪条视频播放最高 | `siluzan-cso report fetch --media <平台> --include works --order play` |
+| 用户意图              | 命令                                                                        |
+| --------------------- | --------------------------------------------------------------------------- |
+| 查某账号近期运营数据  | `siluzan-cso report fetch --media <平台> --maids <账号ID>`                  |
+| 查整个平台的汇总数据  | `siluzan-cso report fetch --media <平台>`                                   |
+| 近 N 天数据           | `siluzan-cso report fetch --media <平台> --days <N>`                        |
+| 哪条视频播放最高      | `siluzan-cso report fetch --media <平台> --include works --order play`      |
 | 查粉丝趋势（按天/周） | `siluzan-cso report fetch --media <平台> --include fans-trend --method Day` |
 
 ---
 
 ## 平台名称对照表
 
-| 用户常说 | `--media` 参数值 |
-|----------|--------------------|
-| 抖音 | `Douyin` |
-| TikTok | `TikTokBusinessAccount` |
-| YouTube | `YouTube` |
-| 微信视频号 | `Wechat` |
-| Instagram / IG | `Instagram` |
-| Facebook / FB | `Facebook` |
-| Twitter / X | `Twitter` |
-| Kwai / 快手 | `Kwai` |
+| 用户常说       | `--media` 参数值        |
+| -------------- | ----------------------- |
+| 抖音           | `Douyin`                |
+| TikTok         | `TikTokBusinessAccount` |
+| YouTube        | `YouTube`               |
+| 微信视频号     | `Wechat`                |
+| Instagram / IG | `Instagram`             |
+| Facebook / FB  | `Facebook`              |
+| Twitter / X    | `Twitter`               |
+| Kwai / 快手    | `Kwai`                  |
 
 ---
 
@@ -63,21 +63,21 @@ siluzan-cso report fetch --media YouTube --days 90 --method Week --include fans-
 
 不传 `--include` 时默认查所有模块：
 
-| 模块名 | 含义 |
-|--------|------|
-| `operation` | 核心运营指标（播放、互动、粉丝增量等） |
-| `total-fans` | 当前总粉丝数 |
-| `fans-analysis` | 粉丝画像 |
-| `works` | 视频明细（可按播放/点赞/完播排序） |
-| `fans-trend` | 粉丝趋势 |
-| `new-fans-trend` | 新增粉丝趋势 |
-| `comment-trend` | 评论趋势 |
-| `hot-topic` | 热门话题 |
-| `hot-comment-word` | 热门评论词云 |
-| `comment-top10` | Top10 热门评论 |
-| `video-duration` | 视频时长分布 |
-| `video-distribution` | 视频流量分布 |
-| `homepage-visit` | 主页访问数据 |
+| 模块名               | 含义                                   |
+| -------------------- | -------------------------------------- |
+| `operation`          | 核心运营指标（播放、互动、粉丝增量等） |
+| `total-fans`         | 当前总粉丝数                           |
+| `fans-analysis`      | 粉丝画像                               |
+| `works`              | 视频明细（可按播放/点赞/完播排序）     |
+| `fans-trend`         | 粉丝趋势                               |
+| `new-fans-trend`     | 新增粉丝趋势                           |
+| `comment-trend`      | 评论趋势                               |
+| `hot-topic`          | 热门话题                               |
+| `hot-comment-word`   | 热门评论词云                           |
+| `comment-top10`      | Top10 热门评论                         |
+| `video-duration`     | 视频时长分布                           |
+| `video-distribution` | 视频流量分布                           |
+| `homepage-visit`     | 主页访问数据                           |
 
 **`--order` 可选值**（配合 `--include works`）：`play`（播放）/ `digg`（点赞）/ `fullplay`（完播）
 
@@ -85,11 +85,11 @@ siluzan-cso report fetch --media YouTube --days 90 --method Week --include fans-
 
 ## `--method` 聚合维度
 
-| 值 | 含义 | 适用场景 |
-|----|------|---------|
+| 值            | 含义 | 适用场景             |
+| ------------- | ---- | -------------------- |
 | `Day`（默认） | 按天 | 近 7~30 天细粒度分析 |
-| `Week` | 按周 | 近 2~3 个月趋势 |
-| `Moth` | 按月 | 年度趋势 |
+| `Week`        | 按周 | 近 2~3 个月趋势      |
+| `Moth`        | 按月 | 年度趋势             |
 
 ---