Siluzan CSO

丝路赞内容运营平台（CSO）。**凡涉及以下任一类业务，必须先加载并使用本 skill**。 (1) **文案生成与改稿**：选题、爆款拆解、新写成稿（公众号、小红书、**视频口播/字幕/配音/分镜脚本**、博客、改稿润色、评论区回复等）须走 three-lib-content-workflow/content-writer.workflow.md；**热点/资讯生成选题**见 topic-selection.md；**单轨 / 多轨**（多轨默认 2 篇、可增减，可主动推断）见 multi-track.md；**禁止**直接成稿或聊天润色。 **视频脚本 vs 发布 Caption**：口播/字幕/分镜走 content-writer；上传发布框 Caption 走 overseas-b2b-social-post。 (2) **人设管理**：运营账号人设卡（styleGuide）；反推/查询/保存。 (3) **发布与运营**（YouTube/TikTok/Instagram/LinkedIn/X/Facebook）：OAuth、**账号分组**、发布、任务/重试、upload、**extract-cover**、planning、报表。 (4) **RAG 知识库**：品牌/产品问答与写稿事实依据。 **海外 B2B 社媒贴文/Caption**：走独立 skill overseas-b2b-social-post，不在本 skill 文案流程内。 **高频误路由**：写文案禁联网代替 rag query；发布/截封面须调 CLI。 **账号不明先问**：仅运营媒体账号；广告账户走 siluzan-tso。

一键安装

如果 CLI 尚未安装，直接帮用户执行对应平台的安装脚本：

• macOS / Linux / WSL：

  bash

  bash <(curl -fsSL https://unpkg.com/siluzan-cso-cli@latest/dist/skill/scripts/install.sh)
  

• Windows PowerShell：

  powershell

  irm https://unpkg.com/siluzan-cso-cli@latest/dist/skill/scripts/install.ps1 | iex
  

Windows 注意：部分 Agent 客户端通过 PowerShell / cmd 代执行命令时存在兼容性问题。若上述命令异常失败，请先安装 Git for Windows，然后在 Git Bash 中执行 macOS / Linux / WSL 的 Bash 安装命令。

脚本会自动完成 Node.js 检测/安装、CLI 安装、Skill 全局注册，并引导用户配置 API Key。无需选择，本脚本专为 siluzan-cso-cli 定制。

---

可执行的操作范围

• 只读：查询媒体账号列表、账号分组、运营报表、发布任务状态、人设列表、RAG 知识库检索、AI 内容规划详情
• 写入（需用户确认）：上传素材、提交发布任务、创建/更新账号分组、生成 AI 内容规划、站内信回复
• 本地文件操作：extract-cover 在本地截取视频帧并输出图片文件；workflow validate 在本地校验文案文件（字数限制 / 内部内容泄漏）；init 将 Skill 文件写入 AI 助手目录

---

可选环境变量

变量	说明
SILUZAN_API_KEY	从环境变量读取 API Key（优先级高于 config.json，CI/CD 推荐）
SILUZAN_AUTH_TOKEN	从环境变量读取 JWT Token（优先级高于 config.json）
SILUZAN_DATA_PERMISSION	从环境变量读取数据权限标识（优先级高于 config.json）

---

能力范围

业务流程	手段	说明
发布与运营	下方 CLI 命令 + references/*.md	上传、发布、任务、报表、账号、规划等
文案生产	three-lib-content-workflow/content-writer.workflow.md	选题、三库、口播/视频脚本/公众号/成稿、改稿

两类流程同属 CSO 业务。海外 B2B 社媒贴文/Caption 为独立 skill overseas-b2b-social-post，不在本包内。

命令索引

命令	作用	详细文档
siluzan-cso login / siluzan-cso send-login-code	登录 / 配置凭据；手机号 + 验证码两段式登录	references/setup.md
siluzan-cso config show/set/clear	查看 / 修改 / 清空本地配置	references/setup.md
siluzan-cso init	Skill 文件初始化（写入 AI 助手目录）	references/setup.md
siluzan-cso update	更新 CLI 版本并刷新 Skill 文件	references/setup.md
siluzan-cso authorize --media-type <平台>	发起媒体账号 OAuth 授权	references/authorize.md
siluzan-cso list-accounts	列出媒体账号，获取账号 ID / 数据总览	references/list-accounts.md
siluzan-cso persona list	拉取 CSO 人设列表。请先阅读详细文档，规范操作，避免误用。	references/persona.md
siluzan-cso rag list	列出知识库文件夹；--rag-only 仅已建索引；--folder-id 查指定文件夹下的子库	references/rag.md
siluzan-cso rag query	知识库向量检索；--partition wiki 或 default（默认 default；写稿与须贴库作答时优先 wiki，不足再 default）；-q 含空白时多词分检合并；--folder-id / --tags 见 references/rag.md	references/rag.md
siluzan-cso account-group list/create/add-accounts/remove-accounts/update/delete	账号分组管理	references/account-group.md
siluzan-cso upload -f <file>	上传视频 / 图片到素材库	references/upload.md
siluzan-cso extract-cover -f <video> -p <平台>	从视频截取封面帧	references/extract-cover.md
siluzan-cso publish -c config.json	提交多平台发布任务	references/publish.md
siluzan-cso task list/detail/item	查看任务状态 / 处理失败 / 重试	references/task.md
siluzan-cso report fetch --media <平台>	运营报表（核心指标 / 视频排行 / 趋势）	references/report.md
siluzan-cso planning ...	AI 内容规划：生成、监控、详情、导出	references/planning.md
—（网页端）	CSO web端全部页面 URL	references/web-pages.md

---

常见业务场景 → 阅读哪个文件

用户在做什么	先阅读
首次安装 / 登录 / 更新	references/setup.md
发布视频或图文	references/publish.md
上传素材	references/upload.md
截取视频封面	references/extract-cover.md
文案写完落盘后校验字数 / 检查内部内容泄漏	references/validate-content.md
查发布记录 / 处理失败	references/task.md
查账号数据 / 运营报表	references/report.md
查找账号 ID 或账号详情	references/list-accounts.md
账号 Token 失效 / 重新授权	references/authorize.md
管理账号分组	references/account-group.md
AI 内容规划	references/planning.md
需要给用户提供后台页面链接	references/web-pages.md
拉取人设 / styleGuide（写稿前）/ 保存人设	references/persona.md
写稿时检索素材库 RAG 片段（三库拆素材等）	references/rag.md
选题 / 三库拆解 / 口播或视频脚本 / 公众号文章 / 单轨或多轨成稿 / 改稿润色 / 人设卡 / 反推人设 / 审稿打分	three-lib-content-workflow/content-writer.workflow.md（多轨 → multi-track.md）

---

命令间依赖关系（交叉引用速览）

text

publish ──需要账号字段──► list-accounts
publish ──需要素材 ID──► upload ──需要封面──► extract-cover
publish ──提交后查状态──► task ──失败重授权──► authorize

report ──需要 mediaCustomerId──► list-accounts
account-group ──需要 mediaCustomerId──► list-accounts

rag query ──需要知识库 ID──► rag list（按用户意图自动选择）

---

RAG 知识库检索工作流

详细检索策略见 references/rag.md；确定用哪个库见 references/core/knowledge-base-resolution.md。以下为决策摘要。

何时使用 RAG

• ✅ 询问特定品牌/产品知识、写需要品牌素材的文案 → 必须先 RAG
• ✅ 执行三库内容工作流 → 按三库分库检索
• ❌ 询问平台操作方法、纯通用创作、用户明确不需要 → 跳过 RAG

四步执行流程

Step 0 — 检查已选库（优先于 list）

若上下文有 <knowledge_base_selection>，直接取其 comid 作 --folder-id，跳过 Step 1–2。详见 references/core/knowledge-base-resolution.md。

Step 1 — 获取知识库（无已选库时，只在任务开始时调用一次）

bash

# 列出所有已建索引的根级知识库（落盘后用脚本读 id，见 references/core/tips.md）
siluzan-cso rag list --rag-only --json-out ./snap-cso

# 若根级库下还有子文件夹，可钻取查看
siluzan-cso rag list --folder-id <父文件夹id> --rag-only --json-out ./snap-cso

Step 2 — 选择知识库（无已选库时，按名称语义匹配）

• 用户提到品牌名 → 找名称最匹配的文件夹，记录 id
• 多品牌 → --folder-id id1,id2（逗号分隔）
• 无明确品牌 → 不传 --folder-id（全库检索）

Step 3 — 拆词检索（2–5 个短关键词；--partition）

• 首轮：--partition wiki，--top-k 建议 8–15（常用 12）。写稿、须贴库作答、需要较长正文作依据时优先。
• 仍不足时：同一 -q / --folder-id / --tags 下再跑 --partition default，--top-k 5–10；两轮按片段 id 去重合并，禁止编造。
• 取值仅 wiki 或 default（小写）；非法值 CLI 会报错。

bash

# 默认不传 --tags = 全量检索（适用于绝大多数场景）
# 推荐：同一库、同一标签策略下，用空格一次传多词，CLI 会分检合并排序
siluzan-cso rag query -q "产品核心卖点 用户使用场景 品牌差异优势" --folder-id <id> --partition wiki --top-k 12

# 证据仍不足时再补 default（按需执行）
# siluzan-cso rag query -q "产品核心卖点 用户使用场景 品牌差异优势" --folder-id <id> --partition default --top-k 8

# 仍可用多轮独立 -q（例如需要分步查看或参数不同）
# siluzan-cso rag query -q "产品核心卖点" --folder-id <id> --partition wiki --top-k 12
# siluzan-cso rag query -q "用户使用场景" --folder-id <id> --partition wiki --top-k 12

# 仅当知识库已按标签打标，且需要精确筛选时才传 --tags（不同标签需多条命令；`--partition` 规则同上）
siluzan-cso rag query -q "抖音 爆款 钩子" --tags "流量因子库" --partition wiki --top-k 12
siluzan-cso rag query -q "产品 卖点 故事" --tags "产品资产库" --partition wiki --top-k 12

Step 4 — 合成使用

合并后的结果中 score 越大越相关（CLI 已做 0–1 归一化）。若执行了 wiki + default 两轮，按片段 id 去重后再合成。将片段作为写稿/回答的事实依据，重新组织表达（不直接粘贴原文）；若执行了多条 rag query，再在对话侧对重复片段去重。

---

AI 行为规范

执行任务的标准流程

遵循计划 → 确认 → 执行 → 验证 → 预测五步：

1. 计划：根据用户意图，查阅命令索引与 references，或「三库内容工作流」与 GetPersonas 人设要求，制定操作步骤，不暴露命令行细节。
2. 确认：与用户确认关键信息（目标账号、发布内容、时间等），不替用户做选择。
3. 执行：按计划调用命令，处理异常。
4. 验证：
   • 写入/修改操作后，通过读取命令确认结果是否正确。
   • 失败时优先尝试重试或用其他方式补救，而不是直接告知用户"任务失败"。
5. 预测：任务完成后，结合当前结果对用户下一步操作给出合理建议。

硬规范

• 知识库确定：涉及 RAG、planning、三库写稿等品牌/企业素材前，先 Read references/core/knowledge-base-resolution.md；上下文有 <knowledge_base_selection> 时直接用 comid，跳过 rag list / planning enterprises。
• 数据处理纪律（防工具死循环，最高优先级）：先 Read references/core/agent-conventions.md。要点：读取/列表/检索/详情类命令一律 --json-out <路径> 落盘，stdout 仅一行摘要 + agentHint；禁止对 stdout 写翻页循环，禁止用 Read/cat 打开落盘业务 *.json，先读 *.outline.txt 再用 node -e 读 JSON；已有 JSON 不重跑、查无结果即停。脚本食谱见 references/core/tips.md。
• 不确定时先读文档：遇到不熟悉的命令，先查对应 references 文件，不猜参数。
• 先查账号再操作：对具体账号做操作前，先用 list-accounts --name <名称> --media-type <平台> 确认账号存在且 Token 有效。
• 需要计算/筛选时用 --json-out：加 --json-out <目录或 *.json 文件> 落盘，再按 references/core/tips.md 的脚本食谱（node -e readFileSync / require 读盘）提取字段；旧 --json 已移除。
• 不猜账号 ID：entityId ≠ mediaCustomerId，两者均须从 list-accounts --json-out 落盘数据获取，不可假设。
• 命令透明性：以简洁的方式向用户说明即将执行的操作意图（如「正在上传视频到素材库」「正在为您查询 YouTube 账号列表」），让用户了解操作进度。用户主动要求查看执行细节时，应如实提供完整命令。安装/登录/更新等一次性命令（见 references/setup.md）可直接展示给用户自行执行。
• 操作后必须验证：完成发布、上传、分组等写操作后，需通过对应的查询命令确认结果。
• 内容创作必须严格按本 skill 流程，禁止绕过指引直接生成内容。所有相关子文件须完整读取后再生成。

必须遵守

• 主动更新（详情请读取 references/setup.md）。
• 破坏性操作必须用户确认：涉及写入/修改/删除的操作（发布、上传、分组变更等），执行前必须明确告知用户操作内容并获得确认。
• 只读操作可自主执行：查询类命令（list-accounts、report fetch、task list、config show 等）可直接执行，无需额外确认。
• 禁止提供虚假信息，比如web端连接就必须确认 references/web-pages.md 中存在才能提供给用户

---

时间字段输出约定（全局）

CLI 返回的时间字段（如 *DateTime / *Time / createTime / publishTime / lastAuthorizationTime / expiresOn 等）如果是 UTC 时间，在显示给用户时需要完成时区转换。

输出规则（按优先级）：

1. 优先用用户在当前对话中明确表达过的时区（如「我在深圳」「PST 时间」「我刚从纽约出差回来」）。
2. 否则用对话语言推断默认时区：中文 → Asia/Shanghai (UTC+8)，日文 → Asia/Tokyo (UTC+9)，英文且无其他线索 → 保留 UTC 并明确标注。
3. 若仍不确定且时间对用户决策有意义（如「最近一次更新」、「创建于多久前」、「Token 何时过期」），主动询问用户所在时区，不要瞎猜。

展示格式：

• 推荐 YYYY-MM-DD HH:mm (时区标识)，例如 2024-03-15 18:30 (UTC+8)、2024-03-15 10:30 (UTC)。
• 禁止把 2024-03-15T10:30:00Z 这种原始 ISO 串直接吐给用户——用户会误以为是当地时间。
• 跨日 / 月底 / 年底 / 夏令时切换附近的时间，换算时要特别小心，必要时多核对一遍。
• 极少数字段（如 report 报表里按用户业务时区聚合的统计时间）已经是用户本地时区，文档若有特别说明则以文档为准。

---

常见 HTTP 错误处理

状态码	原因	处理方式
400 Bad Request	参数错误	查对应 references 文档或用 --help 确认命令用法
401 Unauthorized	凭据失效	引导用户重新执行 siluzan-cso login（详见 references/setup.md）
500 Internal Server Error	服务部署中或数据异常	稍后重试；若持续失败，提交给 Siluzan 相关人员处理

---

平台名称速查

阅读： references/authorize.md

Web 功能导航

无对应 CLI 命令的模块，或需要引导用户在网页端查看数据时，查阅 references/web-pages.md 获取完整页面清单与链接。

URL 格式：https://www.siluzan.com/v3/foreign_trade/cso/{页面}

常用页面：task（任务管理）· postVideo（发布页）· ManageAccounts（账号管理）· planning（AI 内容规划）· table（绩效报表）· Workdata（作品数据）