siluzan-cso-cli 1.1.18-beta.13 → 1.1.18-beta.15

package/README.md

@@ -54,7 +54,7 @@ siluzan-cso init -d /path/to/skills  # 写入自定义目录
 siluzan-cso init --force             # 强制覆盖已存在文件
 ```
 
-> **注意**：当前为测试版（1.1.18-beta.13），供内部测试使用。正式发布后安装命令将改为 `npm install -g siluzan-cso-cli`。
+> **注意**：当前为测试版（1.1.18-beta.15），供内部测试使用。正式发布后安装命令将改为 `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.13",
-  "publishedAt": 1779257752255,
+  "version": "1.1.18-beta.15",
+  "publishedAt": 1779335349577,
   "homepage": "https://www.siluzan.com",
   "source": "https://dev.azure.com/jack4it/Sammamish/_git/siluzan-skill",
   "requiredBinaries": [

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

@@ -8,6 +8,8 @@ $ErrorActionPreference = 'Stop'
 
 # -- Package info (injected at build time) ------------------------------------
 $PKG_NAME    = 'siluzan-cso-cli'
+# PKG_VERSION 锁定到与本脚本同批构建产物一致的版本，避免与 dist/skill 错位
+$PKG_VERSION = '1.1.18-beta.15'
 $CLI_BIN     = 'siluzan-cso'
 $SKILL_LABEL = 'Siluzan CSO'
 $INSTALL_CMD = 'npm install -g siluzan-cso-cli@beta'
@@ -230,12 +232,12 @@ function Main {
     # Step 2: Install CLI
     Write-Step "Step 2/4: Install $PKG_NAME"
 
-    Write-Info "Running: $INSTALL_CMD"
-    $installParts = $INSTALL_CMD -split ' '
-    $installArgs = $installParts[1..($installParts.Length - 1)]
-    & $installParts[0] @installArgs
-    if ($LASTEXITCODE -ne 0) { Write-Err "$INSTALL_CMD failed"; return }
-    Write-Info "$PKG_NAME installed"
+    # 用打包时锁定的 PKG_VERSION，保证脚本与同批 dist/skill 行为对齐
+    $installTarget = "$PKG_NAME@$PKG_VERSION"
+    Write-Info "Running: npm install -g $installTarget"
+    & npm install -g $installTarget
+    if ($LASTEXITCODE -ne 0) { Write-Err "npm install -g $installTarget failed"; return }
+    Write-Info "$installTarget installed"
 
     Write-Info 'Registering Skill to all AI platform global directories...'
     & $CLI_BIN init --global --force

package/dist/skill/scripts/install.sh

@@ -8,6 +8,8 @@ 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.15"
 readonly CLI_BIN="siluzan-cso"
 readonly SKILL_LABEL="Siluzan CSO"
 readonly INSTALL_CMD="npm install -g siluzan-cso-cli@beta"
@@ -141,9 +143,11 @@ main() {
   # Step 2: Install CLI
   step "Step 2/4: Install ${PKG_NAME}"
 
-  info "Running: ${INSTALL_CMD}"
-  $PKG_MANAGER install -g ${PKG_NAME}$(echo "${INSTALL_CMD}" | grep -o '@[^ ]*' || true)
-  info "${PKG_NAME} installed"
+  # 用打包时锁定的 PKG_VERSION，保证脚本与同批 dist/skill 行为对齐
+  local install_target="${PKG_NAME}@${PKG_VERSION}"
+  info "Running: $PKG_MANAGER install -g ${install_target}"
+  $PKG_MANAGER install -g "${install_target}"
+  info "${install_target} installed"
 
   info "Registering Skill to all AI platform global directories..."
   ${CLI_BIN} init --global --force

package/package.json

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