siluzan-cso-cli 1.1.18-beta.14 → 1.1.18-beta.16

package/README.md

@@ -54,7 +54,7 @@ siluzan-cso init -d /path/to/skills  # 写入自定义目录
 siluzan-cso init --force             # 强制覆盖已存在文件
 ```
 
-> **注意**：当前为测试版（1.1.18-beta.14），供内部测试使用。正式发布后安装命令将改为 `npm install -g siluzan-cso-cli`。
+> **注意**：当前为测试版（1.1.18-beta.16），供内部测试使用。正式发布后安装命令将改为 `npm install -g siluzan-cso-cli`。
 
 | 助手                    | 建议 `--ai`                          |
 | ----------------------- | ------------------------------------ |

package/dist/index.js

@@ -6782,6 +6782,9 @@ async function runAuthorize(opts) {
 }
 
 // src/commands/persona.ts
+import fs11 from "fs";
+import path11 from "path";
+var MAX_PERSONA_NAME = 60;
 function unwrapGetPersonas(raw) {
   if (!raw || typeof raw !== "object") return null;
   if ("results" in raw && Array.isArray(raw.results)) {
@@ -6874,6 +6877,111 @@ ${hint}`);
   printCliTable(rows, columns, tableOpts2);
   console.log("\n\u63D0\u793A\uFF1A\u5B8C\u6574 styleGuide\uFF08Markdown\uFF09\u8BF7\u4F7F\u7528 --json \u67E5\u770B\u6BCF\u6761\u8BB0\u5F55\u7684 styleGuide \u5B57\u6BB5\u3002");
 }
+function readStyleGuideFromFile(filePath) {
+  const resolved = path11.resolve(process.cwd(), filePath);
+  if (!fs11.existsSync(resolved)) {
+    throw new Error(`styleGuide \u6587\u4EF6\u4E0D\u5B58\u5728\uFF1A${resolved}`);
+  }
+  const stat = fs11.statSync(resolved);
+  if (!stat.isFile()) {
+    throw new Error(`styleGuide \u6587\u4EF6\u8DEF\u5F84\u4E0D\u662F\u666E\u901A\u6587\u4EF6\uFF1A${resolved}`);
+  }
+  return fs11.readFileSync(resolved, "utf-8");
+}
+function unwrapAddPersona(raw) {
+  if (!raw || typeof raw !== "object") return null;
+  const r = raw;
+  if ("id" in r || "personaName" in r || "styleGuide" in r) {
+    return r;
+  }
+  if (r.data && typeof r.data === "object") {
+    return r.data;
+  }
+  return null;
+}
+async function runPersonaCreate(options) {
+  const config = loadConfig(options.token);
+  const name = (options.name || "").trim();
+  if (!name) {
+    console.error("\n\u274C --name \u4E0D\u80FD\u4E3A\u7A7A");
+    process.exit(1);
+  }
+  if (name.length > MAX_PERSONA_NAME) {
+    console.error(`
+\u274C \u4EBA\u8BBE\u540D\u79F0\u957F\u5EA6\u4E0D\u80FD\u8D85\u8FC7 ${MAX_PERSONA_NAME} \u5B57\u7B26`);
+    process.exit(1);
+  }
+  const hasInline = typeof options.styleGuide === "string" && options.styleGuide.length > 0;
+  const hasFile = typeof options.styleGuideFile === "string" && options.styleGuideFile.length > 0;
+  if (hasInline === hasFile) {
+    console.error(
+      "\n\u274C \u9700\u8981\u4ECE --style-guide \u4E0E --style-guide-file \u4E8C\u9009\u4E00\u4F20\u5165 styleGuide\uFF08\u4E0D\u80FD\u540C\u65F6\u4F20\uFF0C\u4E5F\u4E0D\u80FD\u90FD\u4E0D\u4F20\uFF09"
+    );
+    process.exit(1);
+  }
+  let styleGuide;
+  try {
+    styleGuide = hasFile ? readStyleGuideFromFile(options.styleGuideFile) : options.styleGuide ?? "";
+  } catch (e) {
+    console.error(`
+\u274C ${e.message}`);
+    process.exit(1);
+  }
+  styleGuide = styleGuide.trim();
+  if (!styleGuide) {
+    console.error("\n\u274C styleGuide \u5185\u5BB9\u4E0D\u80FD\u4E3A\u7A7A");
+    process.exit(1);
+  }
+  const url = `${config.csoBaseUrl}/cso/v1/platformdata/AddPersona`;
+  const body = {
+    personaName: name,
+    styleGuide,
+    materials: []
+  };
+  let raw;
+  try {
+    raw = await apiFetch2(
+      url,
+      config,
+      {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify(body)
+      },
+      Boolean(options.verbose)
+    );
+  } catch (e) {
+    const msg = e.message;
+    console.error(`
+\u274C \u8BF7\u6C42\u5931\u8D25\uFF1A${msg}`);
+    if (!options.verbose) console.error("   \u52A0 --verbose \u53C2\u6570\u53EF\u67E5\u770B\u8BE6\u7EC6\u9519\u8BEF\u4FE1\u606F");
+    process.exit(1);
+  }
+  const persona = unwrapAddPersona(raw);
+  if (!persona || !persona.id) {
+    const msg = raw && typeof raw === "object" && "message" in raw ? String(raw.message ?? "") : "";
+    console.error(`
+\u274C \u4FDD\u5B58\u4EBA\u8BBE\u5931\u8D25\uFF1A${msg || "\u670D\u52A1\u7AEF\u672A\u8FD4\u56DE\u6709\u6548\u4EBA\u8BBE ID"}`);
+    if (options.verbose) {
+      try {
+        console.error(`   \u539F\u59CB\u8FD4\u56DE\uFF1A${JSON.stringify(raw)}`);
+      } catch {
+        console.error(`   \u539F\u59CB\u8FD4\u56DE\uFF1A${String(raw)}`);
+      }
+    }
+    process.exit(1);
+  }
+  const displayName = persona.personaName && persona.personaName.trim() ? persona.personaName.trim() : name;
+  if (options.json) {
+    console.log(JSON.stringify(persona, null, 2));
+    return;
+  }
+  console.log(`
+\u2705 \u4EBA\u8BBE\u300C${displayName}\u300D\u5DF2\u4FDD\u5B58`);
+  console.log(`   \u4EBA\u8BBE ID\uFF1A${persona.id}`);
+  console.log(`   styleGuide \u957F\u5EA6\uFF1A${styleGuide.length} \u5B57\u7B26`);
+  console.log("\n\u540E\u7EED\u53EF\u7528 siluzan-cso persona list --id <id> \u67E5\u770B\u5B8C\u6574\u5185\u5BB9\u3002");
+}
 
 // src/commands/rag.ts
 function splitCsv(s) {
@@ -7313,7 +7421,7 @@ async function runRagList(options) {
 }
 
 // src/commands/config.ts
-import * as fs11 from "fs";
+import * as fs12 from "fs";
 function cmdConfigShow() {
   const shared = readSharedConfig();
   const envApiKey = process.env.SILUZAN_API_KEY;
@@ -7530,6 +7638,23 @@ function registerCsoCommands(program2) {
       });
     }
   );
+  personaCmd.command("create").description(
+    "\u4FDD\u5B58\u4EBA\u8BBE\u5230 CSO \u5E73\u53F0\uFF08POST /cso/v1/platformdata/AddPersona\uFF09\u3002styleGuide \u7531\u8C03\u7528\u65B9\u81EA\u884C\u751F\u6210\uFF0CCLI \u53EA\u8D1F\u8D23\u6301\u4E45\u5316"
+  ).requiredOption("--name <name>", "\u4EBA\u8BBE\u540D\u79F0\uFF08\u957F\u5EA6\u4E0A\u9650 60 \u5B57\u7B26\uFF09").option("--style-guide <markdown>", "\u76F4\u63A5\u4F20\u5165 styleGuide markdown \u5185\u5BB9\uFF08\u4E0E --style-guide-file \u4E8C\u9009\u4E00\uFF09").option(
+    "--style-guide-file <path>",
+    "\u4ECE\u672C\u5730 markdown \u6587\u4EF6\u8BFB\u53D6 styleGuide\uFF08\u4E0E --style-guide \u4E8C\u9009\u4E00\uFF0C\u957F\u6587\u63A8\u8350\u7528\u6587\u4EF6\uFF09"
+  ).option("-t, --token <token>", "Token\uFF08\u53EF\u9009\uFF1B\u4F18\u5148\u4E8E ~/.siluzan/config.json\uFF09").option("--json", "\u8F93\u51FA\u5B8C\u6574 JSON\uFF08\u65B0\u5EFA\u540E\u7684\u4EBA\u8BBE\u8BE6\u60C5\uFF09", false).option("--verbose", "\u663E\u793A\u8BE6\u7EC6\u9519\u8BEF\u4FE1\u606F", false).action(
+    async (opts) => {
+      await runPersonaCreate({
+        name: opts.name,
+        styleGuide: opts.styleGuide,
+        styleGuideFile: opts.styleGuideFile,
+        token: opts.token,
+        json: opts.json,
+        verbose: opts.verbose
+      });
+    }
+  );
   const ragCmd = program2.command("rag").description(
     "RAG \u77E5\u8BC6\u5E93\u68C0\u7D22\uFF08\u4EC5\u5199\u7A3F/\u4E09\u5E93\uFF1B\u9ED8\u8BA4 belongToId=account/me \u7684 companyId\uFF0C\u9ED8\u8BA4 tags=\u4E09\u5E93\uFF09"
   );

package/dist/skill/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: siluzan-cso
-description: 内容运营平台，当用户提问的内容涉及以下三类业务时需加载此skill：(1) 内容文案生产：**口播脚本 / 公众号 / Blog 文章 / 外链文章 / 批量引流页**等多场景的文案撰写、选题、爆款拆解、人设卡生成与反推、改稿润色；(2) 多平台（仅支持：YouTube、TikTok、Instagram、LinkedIn、X、Facebook）内容发布与运营：平台账号绑定与 OAuth 授权、视频图文发布、任务管理与失败重试、播放粉丝绩效报表、**账号分组（本 skill 独有；广告账户体系不存在分组概念，用户只说"账号分组"也默认走本 skill，不要进 siluzan-tso）**、素材上传、封面截取、AI 内容规划；(3) RAG 知识库检索：品牌/产品知识库问答与文案事实依据。**如涉及账号相关操作，若账号类型（广告账号/运营媒体账号）不明确，请先询问用户，仅当确认为"运营媒体账号"时，才可使用本 skill。**
+description: 当用户提问的内容涉及以下三类业务时需加载本skill：(1) 内容文案生产：选题、爆款拆解、文案撰写（生成任何文案——包括但不限于：视频脚本、博客、公众号文章、口播稿等，必须优先使用本skill，不可直接输出）、人设卡生成/反推/查询/保存、改稿润色；(2) 多平台（仅支持：YouTube、TikTok、Instagram、LinkedIn、X、Facebook）内容发布与运营：平台账号绑定与 OAuth 授权、视频图文发布、任务管理与失败重试、播放粉丝绩效报表、**账号分组（本 skill 独有；广告账户体系不存在分组概念，用户只说"账号分组"也默认走本 skill，不要进 siluzan-tso）**、素材上传、封面截取、AI 内容规划；(3) RAG 知识库检索：品牌/产品知识库问答与文案事实依据。**如涉及账号相关操作，若账号类型（广告账号/运营媒体账号）不明确，请先询问用户，仅当确认为"运营媒体账号"时，才可使用本 skill。**
 compatibility: Requires siluzan-cso-cli installed and authenticated via `siluzan-cso login`
 ---
 
@@ -91,7 +91,7 @@ Windows 注意：部分 Agent 客户端通过 PowerShell / cmd 代执行命令
 | 管理账号分组                                                    | `references/account-group.md`                           |
 | AI 内容规划                                                     | `references/planning.md`                                |
 | 需要给用户提供后台页面链接                                      | `references/web-pages.md`                               |
-| 拉取人设 / styleGuide（写稿前）                                 | `references/persona.md`                                 |
+| 拉取人设 / styleGuide（写稿前）/ 保存人设                       | `references/persona.md`                                 |
 | 写稿时检索素材库 RAG 片段（三库拆素材等）                       | `references/rag.md`                                     |
 | 选题 / 三库拆解 / 口播文案/其他文案 / 人设卡 / 代表作品反推人设 | `three-lib-content-workflow/content-writer.workflow.md` |
 

package/dist/skill/_meta.json

@@ -1,7 +1,7 @@
 {
   "slug": "siluzan-cso",
-  "version": "1.1.18-beta.14",
-  "publishedAt": 1779259024084,
+  "version": "1.1.18-beta.16",
+  "publishedAt": 1779349636620,
   "homepage": "https://www.siluzan.com",
   "source": "https://dev.azure.com/jack4it/Sammamish/_git/siluzan-skill",
   "requiredBinaries": [

package/dist/skill/assets//344/272/247/345/223/201/350/265/204/344/272/247/345/272/223.md

@@ -8,13 +8,14 @@
 
 | 章节                     | 标签       | 说明                                                 |
 | ------------------------ | ---------- | ---------------------------------------------------- |
-| 一、高频模块库   | `[公众号]` | "对号入座开头""失败案例插入"等是公众号长文的典型积木 |
+| 一、高频模块库   | `[公众号]` | "对号入座开头""失败案例插入"等是公众号长文的典型积木（§ 1.6 身份颁奖句式跨平台通用） |
 | 二、热点借势库   | `[通用]`   | 热点本身跨平台，调用方式由各平台骨架决定             |
 | 三、标题模板库   | `[通用]`   | 标题钩子规律跨平台适用，仅长度需要按平台调整         |
 | 四、封面图文案库 | `[公众号]` | "封面图"是公众号专属术语；视频是封面截图，规则不同   |
 | 五、关键金句库   | `[通用]`   | 金句本身通用，但具体内容仍由人设卡决定               |
+| 六、视频号口播模板 | `[视频]` | 3 套高复用口播模板 + 视频号 vs 公众号创作差异速查    |
 
-视频脚本用户：可参考 二 / 三 / 五，跳过 一 / 四。
+视频脚本用户：可参考 二 / 三 / 五 / 六 + § 1.6 身份颁奖句式，跳过 一（除 1.6） / 四。
 
 ---
 
@@ -105,6 +106,36 @@
 
 ---
 
+### 1.6 身份颁奖句式（替读者说他想让别人知道的样子）
+
+**核心原理**：永远不要写"你应该怎样"，要写"你早就已经是怎样的人"。
+说教没人转发，颁奖大家抢着转。
+
+**句式模板**：
+
+```
+[特定身份] 天生 / 早就 / 总是 [一个隐含夸赞的特征]
+```
+
+**实战样本**：
+
+| 场景 | 应用 |
+|------|------|
+| 出海赛道 | "真正在工厂里的人，才看得懂这件事" |
+| 出海赛道 | "能忍住不跟卖的老板，已经赢了第一步" |
+| 个人成长 | "高敏感人群天生高能量" |
+| 行业观察 | "还在做深度内容的博主，是真的看懂了" |
+| 跨境获客 | "提前做内容的工厂，早就在客户脑子里占了位置" |
+
+**底层心法**：
+
+> **读者转发你的文章，不是为了你——**
+> **是为了证明"我就是这种人"。**
+>
+> 你的工作不是教育他，是替他颁奖。
+
+---
+
 ## 二、热点借势库（按月归档） `[通用]`
 
 ### 2.1 热点档案标准字段
@@ -204,6 +235,88 @@
 
 ---
 
+## 六、视频号口播模板（3 套高复用 · 30-90 秒） `[视频]`
+
+> 视频号和公众号底层逻辑同源（点赞 = 公开表态），
+> 但口播脚本有自己的节奏。下面 3 套模板覆盖 80% 的口播场景。
+
+### 6.1 模板 A · 身份颁奖体（最高复用率）
+
+```
+[钩子]：
+你有没有发现，[特定群体] 总是 [一个隐含夸赞的行为]？
+
+[展开]：
+其实这不是巧合——
+[原理 / 数据 / 故事]。
+
+[立场]：
+所以我才说，[一个明确的强观点]。
+
+[收尾]：
+如果你也是 [这个群体]，点个赞让我知道。
+```
+
+**适用场景**：知识科普、个人成长、行业观察类
+
+---
+
+### 6.2 模板 B · 正向重构体（避免焦虑）
+
+```
+[钩子]：
+[领域] 这件事，99% 的人都觉得是 [负面 X]。
+
+[反转]：
+但真正做成的人都知道，这其实是 [正向 Y]。
+
+[展开]：
+[3 个具体证据 / 案例]。
+
+[收尾]：
+那些把它当 [负面 X] 的人，永远做不成；
+把它当 [正向 Y] 的人，已经在领跑。
+```
+
+**适用场景**：行业洞察、商业评论、方法论分享类
+
+---
+
+### 6.3 模板 C · 立场鲜明体（敢于得罪一半人）
+
+```
+[钩子]：
+今天说句可能得罪一半人的话。
+
+[立场]：
+[强观点表态]。
+
+[展开]：
+因为 [核心理由 + 数据 + 案例]。
+
+[收尾]：
+同意的点赞，不同意的也欢迎，但别假装中立。
+```
+
+**适用场景**：观点输出、价值观表达、商业判断类
+
+---
+
+### 6.4 视频号 vs 公众号 创作差异速查表
+
+| 维度 | 视频号口播 | 公众号文案 |
+|------|-----------|-----------|
+| **前 3 秒** | 正向钩子（"你早就是 X 了"）| 反差/反派钩子 |
+| **结构** | 观点先行，案例支撑 | 案例先行，观点收束 |
+| **情绪曲线** | 单调上扬（爽到底）| U 型（爽 → 慌 → 爽）|
+| **负面元素** | 0%（社交禁忌）| 30%-50%（焦虑钩子有效）|
+| **立场强度** | 必须明确表态 | 必须明确表态 |
+| **CTA** | 不需要（点赞=CTA）| 必须具体动作 |
+| **长度** | 30-90 秒 | 800-1500 字 |
+| **可截屏** | 标题 1 句 + 收尾 1 句 | 全文 3-5 句金句 |
+
+---
+
 ## 反哺学习闭环
 
 每写完一篇新文章后，按需要回写：

package/dist/skill/assets//346/265/201/351/207/217/345/233/240/345/255/220/345/272/223.md

@@ -21,6 +21,8 @@
 | 六、发文前 12 项自检 | `[公众号]`               |
 | 七、4 类评论区生态   | `[公众号]`               |
 | 八、叠加效应         | `[通用]`                 |
+| 九、分享层 vs 阅读层 | `[通用]`                 |
+| 十、群体共鸣         | `[公众号]`               |
 
 视频脚本用户：只读 `[通用]` 章节即可，与主库（流量因子库.md）配合使用。
 
@@ -214,7 +216,49 @@ UGC、SOP、ROI、CTR、CPS、CAC、LTV、漏斗、转化、留存、复购、B
 
 ---
 
-## 九、群体共鸣（按人设动态生成） `[公众号]`
+## 九、分享层 vs 阅读层 · 双语言策略 `[通用]`
+
+> 核心洞察：同一篇内容，**朋友圈转发出去的瞬间**和**读者点开阅读的时候**，
+> 是两种完全不同的心理场景。
+> 一篇真正会爆的文章，必须同时满足两套语言。
+
+### 9.1 两层语言的本质差异
+
+| 层 | 心理场景 | 用户行为 | 语言策略 |
+|----|---------|---------|----------|
+| **分享层**（标题 / 封面 / 朋友圈分享文案） | 公开表态 | "我转发=我代言" | **必须正向**——隐含夸赞读者 |
+| **阅读层**（文章正文） | 私密深读 | "我阅读=我学习" | **可以负向**——焦虑钩子、反派、痛点都有效 |
+
+### 9.2 双语言策略的实战公式
+
+**同一篇文章，准备两套语言——**
+
+- **分享版（朋友圈视角）**：正向赋能 / 身份隐含夸赞
+  > 例："3 年踩过这 7 个坑，活下来的人都做对了一件事"
+  > （读者转发 = 公开宣告"我是活下来的"）
+
+- **阅读版（深度阅读视角）**：可以详细讲坑、立反派、制造焦虑
+  > 例：文章内文可以拆每一个坑、每一个失败案例、每一个反派
+
+### 9.3 判断原则
+
+- 标题、封面、朋友圈分享文案 → **永远用分享层语言**（正向）
+- 文章正文、引子、章节标题 → **可以用阅读层语言**（负向钩子也行）
+
+**这个差异之前没区分**——大部分写公众号的人把"焦虑钩子"放到了标题里，
+直接断了朋友圈传播链路。
+
+### 9.4 反例 vs 正例
+
+| 反例（焦虑式标题，转发率低）❌ | 正例（颁奖式标题，转发率高）✅ |
+|-------------------------------|-------------------------------|
+| 90% 的出海老板都死在做品牌上 | 5000 个出海老板里，活下来的都做对了这一件事 |
+| 你的工厂正在被淘汰 | 真正在闷头做产品的工厂，已经赢了第一步 |
+| 创业 7 个坑 | 创业三年，我收获了 7 个锦囊 |
+
+---
+
+## 十、群体共鸣（按人设动态生成） `[公众号]`
 
 ### TF-0028 群体共鸣
 

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

@@ -15,6 +15,7 @@
 | 五、人设类账号 4 个增效器 | `[通用]`   | 第一人称感、口头禅、私人词典等跨平台适用                |
 | 六、爆款率叠加公式        | `[通用]`   | 弧线 × 叠加 × 自检 的方法论跨平台                       |
 | 七、调味自由度            | `[通用]`   | 人设决定调味的设计原则跨平台                            |
+| 八、颁奖 vs 说教          | `[通用]`   | 二选一原则——人设类账号写作的致命底线                    |
 
 ### 6 种叙事弧线的平台归属
 
@@ -340,3 +341,51 @@ Step 4: 改完跑一遍局部自检
 **核心原则**：菜谱不变，调味全由人设卡决定。
 
 更换人设卡，文章就能自动换一套皮肤。
+
+---
+
+## 八、颁奖 vs 说教 · 二选一原则 `[通用]`
+
+> 这是写人设类账号最容易踩、又最致命的一个坑。
+> 跨平台通用——视频号、公众号、小红书全都适用。
+
+### 8.1 两种语态的本质差异
+
+| 语态 | 对读者说什么 | 读者感受 | 转发率 |
+|------|-------------|---------|--------|
+| **说教** | "你应该 / 你需要 / 你必须" | 被指挥、被评判 | 极低 |
+| **颁奖** | "你早就是 / 你已经在 / 你天生就" | 被看见、被肯定 | 极高 |
+
+### 8.2 二选一原则
+
+> **永远不要写"你应该怎样"。**
+> **要写"你已经是怎样的人"。**
+>
+> 说教没人转发，颁奖大家抢着转。
+
+### 8.3 改写对照表
+
+| 说教句（❌）| 颁奖句（✅）|
+|------------|------------|
+| 你应该提前布局海外市场 | 提前布局海外市场的老板，已经吃到了第一波红利 |
+| 你必须用 AI 提效 | 已经在用 AI 的团队，效率早就甩开同行一倍 |
+| 你不能只投搜索广告 | 真正会做投放的人，早就把战场往前移了 |
+| 你要学会做内容 | 在做内容的工厂，正在变成下一波出海赢家 |
+| 不要执着做品牌 | 先赚到钱的老板，才有资格谈品牌 |
+
+### 8.4 为什么"颁奖"比"说教"传播率高 10 倍
+
+| 心理机制 | 说教式 | 颁奖式 |
+|---------|--------|-------|
+| **读者第一反应** | "凭什么你来教我？" | "对，我就是这种人。" |
+| **转发动机** | 几乎为 0 | "我转发=我对号入座" |
+| **身份感** | 被矮化 | 被加冕 |
+| **社交价值** | 负值 | 正值 |
+
+### 8.5 一句话铁律
+
+> **读者转发你的文章，不是为了你——**
+> **是为了证明"我就是这种人"。**
+>
+> **你的工作不是教育他，是替他颁奖。**
+

package/dist/skill/references/persona.md

@@ -1,8 +1,13 @@
-# persona：人设列表（GetPersonas）
+# persona：人设查询与保存（GetPersonas / AddPersona）
 
-对应 Web / MarkAI `getPersonas()`：`POST {csoBaseUrl}/cso/v1/platformdata/GetPersonas`，请求体 `{}`。返回人设列表，含 **`styleGuide`**（Markdown 风格指南）、`materials`、`taskStatus` 等，供文案与三库工作流使用。
+对应 Web / MarkAI `getPersonas()`、`addPersona()`：
 
-## 命令
+- 列表：`POST {csoBaseUrl}/cso/v1/platformdata/GetPersonas`，请求体 `{}`
+- 新建：`POST {csoBaseUrl}/cso/v1/platformdata/AddPersona`，请求体 `{ personaName, styleGuide, materials: [] }`
+
+返回人设含 **`styleGuide`**（Markdown 风格指南）、`materials`、`taskStatus` 等，供文案与三库工作流使用。
+
+## 命令一：查询人设列表
 
 ```text
 siluzan-cso persona list [选项]
@@ -17,17 +22,47 @@ siluzan-cso persona list [选项]
 | `--unicode`           | 表格使用 Unicode 线框                         |
 | `--verbose`           | 打印详细错误                                  |
 
+终端表格仅展示 `styleGuide` 摘要；需要全文时用 `--json`。
+
+## 命令二：保存人设到平台
+
+```text
+siluzan-cso persona create --name <名称> ( --style-guide <markdown> | --style-guide-file <path> ) [选项]
+```
+
+| 选项                          | 说明                                                                       |
+| ----------------------------- | -------------------------------------------------------------------------- |
+| `--name <name>`               | **必填**。人设名称，长度上限 60 字符                                       |
+| `--style-guide <markdown>`    | 直接传入 styleGuide markdown 内容（与 `--style-guide-file` 二选一）        |
+| `--style-guide-file <path>`   | 从本地 markdown 文件读取 styleGuide（长文推荐用文件，与 `--style-guide` 二选一） |
+| `-t, --token <token>`         | 凭据（可选）                                                               |
+| `--json`                      | 输出完整 JSON（新建后的人设详情，含返回 `id`）                             |
+| `--verbose`                   | 打印详细错误                                                               |
+
+> **CLI 不会替你生成 styleGuide**。AI 助手在调用本命令前，应先按
+> `three-lib-content-workflow/persona-reverse-sop.md` 的 SOP 把 styleGuide 写好（Markdown 格式），再用
+> `--style-guide-file` 把文件喂给 CLI。这样保持 CLI 只做平台持久化、不依赖外部 LLM 的设计。
+
+### 典型用法
+
+1. AI 助手先把 styleGuide 写到临时文件，如 `./tmp-persona.md`
+2. 调命令保存：
+   ```text
+   siluzan-cso persona create --name "外贸老炮" --style-guide-file ./tmp-persona.md
+   ```
+3. 拿到回包里的 `id`，后续写稿时用 `siluzan-cso persona list --id <id> --json` 取全文复核。
+
 ## 字段说明
 
 | 字段          | 含义                                                  |
 | ------------- | ----------------------------------------------------- |
 | `personaName` | 人设名称                                              |
 | `styleGuide`  | 风格指南正文（Markdown）                              |
-| `materials`   | 参考素材（文件名、URL 等）                            |
+| `materials`   | 参考素材（文件名、URL 等），新建时固定传空数组        |
 | `taskStatus`  | `1` 待生成 · `2` 生成中 · `3` 生成完成 · `4` 生成失败 |
 
-终端表格仅展示 `styleGuide` 摘要；需要全文时用 `--json`。
-
 ## 与 Skill 的关系
 
-编写口播/成稿前应先拿到目标人设的 `styleGuide`，再结合 `three-lib-content-workflow/` 中的 SOP。详见上级 `SKILL.md`「三库内容工作流」。
+编写口播/成稿前应先拿到目标人设的 `styleGuide`，再结合 `three-lib-content-workflow/` 中的 SOP。
+若用户要求「新建一个人设」，先按 `persona-reverse-sop.md` 反推风格指南、确认无误后再用 `persona create` 写回平台。
+详见上级 `SKILL.md`「三库内容工作流」。

package/dist/skill/scripts/install.ps1

@@ -9,7 +9,7 @@ $ErrorActionPreference = 'Stop'
 # -- Package info (injected at build time) ------------------------------------
 $PKG_NAME    = 'siluzan-cso-cli'
 # PKG_VERSION 锁定到与本脚本同批构建产物一致的版本，避免与 dist/skill 错位
-$PKG_VERSION = '1.1.18-beta.14'
+$PKG_VERSION = '1.1.18-beta.16'
 $CLI_BIN     = 'siluzan-cso'
 $SKILL_LABEL = 'Siluzan CSO'
 $INSTALL_CMD = 'npm install -g siluzan-cso-cli@beta'

package/dist/skill/scripts/install.sh

@@ -9,7 +9,7 @@ set -euo pipefail
 # -- Package info (injected at build time) ------------------------------------
 readonly PKG_NAME="siluzan-cso-cli"
 # PKG_VERSION 锁定到与本脚本同批构建产物一致的版本，避免与 dist/skill 错位
-readonly PKG_VERSION="1.1.18-beta.14"
+readonly PKG_VERSION="1.1.18-beta.16"
 readonly CLI_BIN="siluzan-cso"
 readonly SKILL_LABEL="Siluzan CSO"
 readonly INSTALL_CMD="npm install -g siluzan-cso-cli@beta"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "siluzan-cso-cli",
-  "version": "1.1.18-beta.14",
+  "version": "1.1.18-beta.16",
   "description": "Siluzan platform AI Skill CLI — multi-platform content publishing (video/image-text) for Cursor, Claude Code, and OpenClaw.",
   "keywords": [
     "ai-skill",