yuanflow-cli 0.1.16 → 0.1.18

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "yuanflow-cli",
-  "version": "0.1.16",
+  "version": "0.1.18",
   "description": "YuanFlow API CLI and skill installer for supported AI coding agents.",
   "type": "module",
   "license": "MIT",

package/skills/yuanflow-skill/README.md

@@ -12,6 +12,7 @@ YuanFlow Skill 是 `yuanflow-cli` 的 Agent Skill 仓库，用于把社媒平台
 - `HTML报告生成/`：单页 HTML 报告生成 Skill，内置 9 种米色留白报告模板。
 - `本地音视频转文字/`：本地 SenseVoice 音视频转文字 Skill，首次明确使用时按需下载模型。
 - `帐号监控/`：帐号搜索、主页资料、主页作品、历史快照、变化对比和 HTML 可视化分流 Skill。
+- `个人创作库/`：长期保存、整理、复盘和复用用户认可的自媒体合格产出物。
 
 ## 适用场景
 
@@ -24,6 +25,7 @@ YuanFlow Skill 是 `yuanflow-cli` 的 Agent Skill 仓库，用于把社媒平台
 - 把自媒体分析、数据复盘、文案方案、账号监控、知识梳理和执行计划生成可直接打开的单页 HTML 报告。
 - 在用户明确要求本地转写时，把本地音频或视频转成文字；视频会先抽取音频，模型和缓存都保存在 Skill 自己目录下。
 - 监控抖音、小红书、微博、知乎、Bilibili、TikTok、YouTube、Twitter/X 帐号主页，保存快照并对比历史变化；抖音链路优先使用 `get-sec-user-id -> user-profile -> user-posts -> works detail`。
+- 在用户要求保存、归档、复盘或复用已完成创作成果时，把选题、标题、文案、脚本、封面、剪辑思路、发布计划和数据复盘沉淀进个人创作库。
 
 ## 双环境使用方式
 
@@ -94,6 +96,11 @@ yuanflow-skill list-skills
 ├─ 本地音视频转文字
 │  ├─ SKILL.md
 │  └─ scripts/
+├─ 个人创作库
+│  ├─ SKILL.md
+│  ├─ raw/
+│  ├─ library/
+│  └─ templates/
 └─ OSS文件中转工具
    └─ SKILL.md
 ```

package/skills/yuanflow-skill/SKILL.md

@@ -24,6 +24,7 @@ description: Use when the user asks about social-media API workflows, platform d
 - `HTML报告生成/`
 - `本地音视频转文字/`
 - `帐号监控/`
+- `个人创作库/`
 
 ## 环境判断
 
@@ -179,6 +180,20 @@ description: Use when the user asks about social-media API workflows, platform d
 
 - `HTML报告生成`
 
+### 12. 走 `个人创作库`
+
+遇到下面这些需求，优先进入这个子 Skill：
+
+- 用户要求保存、归档、整理、沉淀、回看、复查、复用自媒体创作成果。
+- 用户明确说“加入个人创作库”“保存到创作库”“整理我的历史作品/脚本/文案/选题/标题/发布复盘”。
+- 用户要求把某次已完成的合格产出物整理成长期资产，方便后续复盘或复用。
+
+不要用它替代选题、标题、文案、脚本、生图、帐号监控等从 0 到 1 的创作或数据能力。先让对应 Skill 完成任务，用户确认产出值得保留后，再使用个人创作库归档。
+
+子 Skill 名称：
+
+- `个人创作库`
+
 ### 12. 走 `本地音视频转文字`
 
 只有当用户明确要求使用本地音视频转文字、本地转写、本地 ASR、离线转写或本地模型把音频/视频转成文字时，才进入这个子 Skill。

package/skills/yuanflow-skill//344/270/252/344/272/272/345/210/233/344/275/234/345/272/223/SKILL.md

@@ -0,0 +1,155 @@
+---
+name: 个人创作库
+description: 当用户要求保存、归档、整理、沉淀、复盘、回看、复用自媒体创作成果，或明确说“加入个人创作库”“保存到创作库”“整理我的历史作品/脚本/文案/选题/标题/发布复盘”时使用。本 Skill 只负责收集和维护用户已经认可的合格产出物，不替代选题、文案、脚本、生图、帐号监控等从 0 到 1 的创作能力。
+---
+
+# 个人创作库
+
+这个 Skill 是创作者长期资产库。它的目标不是帮用户从零创作，而是在每次工作结束后，把用户认可的合格产出物整理、归档、复盘和沉淀，方便后续回看、复查、复用。
+
+## 触发边界
+
+使用本 Skill 的典型场景：
+
+- 用户说“保存到个人创作库”“加入创作库”“归档这次成果”。
+- 用户要求整理某次已经完成的选题、标题、文案、脚本、封面方案、剪辑思路、发布计划或数据复盘。
+- 用户要求回看、检索、对比、复用以前的创作成果。
+- 用户要求从历史产出中提炼自己的常用表达、结构、爆款规律或风格资产。
+
+不要在这些场景误用本 Skill：
+
+- 从 0 到 1 做选题、写文案、写脚本、生成图片。
+- 采集平台数据、监控帐号、下载作品、查询评论。
+- 生成 HTML 报告。
+
+这些任务应先使用对应 Skill；只有产出被用户确认值得保存时，才进入个人创作库。
+
+## 总结构
+
+```text
+个人创作库/
+├─ SKILL.md
+├─ index.md
+├─ log.md
+├─ operation-log.md
+├─ raw/
+│  ├─ manual/
+│  └─ agent/
+├─ library/
+│  ├─ account-positioning/
+│  ├─ topics/
+│  ├─ titles/
+│  ├─ covers/
+│  ├─ copywriting/
+│  ├─ scripts/
+│  ├─ video-style/
+│  ├─ editing-ideas/
+│  ├─ publishing-plans/
+│  ├─ performance-reviews/
+│  ├─ reusable-patterns/
+│  └─ best-works/
+└─ templates/
+```
+
+## 分层规则
+
+### raw/manual
+
+保存用户手动提供但尚未正式整理的原始资料，例如：
+
+- 历史文案、截图、链接、音频、视频、草稿。
+- 用户临时丢进来的待整理文件。
+
+### raw/agent
+
+保存 Agent 接管后的正式资料包。资料包目录名建议：
+
+```text
+YYYYMMDD_HHMMSS_<platform-or-type>_<stable-slug>
+```
+
+每个资料包内部固定为：
+
+```text
+source/
+derived/
+analysis/
+meta/
+```
+
+- `source/`：原始内容。
+- `derived/`：中间产物，例如转写、截图整理、结构化拆分。
+- `analysis/`：最终分析结果，例如摘要、复盘、可复用点。
+- `meta/`：来源、状态、标签和关联作品信息。
+
+### library
+
+保存已经整理好的长期创作资产。优先按“创作流程职责”分类，不按文件来源分类。
+
+- `account-positioning/`：帐号定位、人设、受众、栏目方向、表达边界。
+- `topics/`：已采用选题、选题判断理由、选题来源。
+- `titles/`：最终标题、备选标题、标题公式。
+- `covers/`：封面文案、封面视觉方向、封面参考。
+- `copywriting/`：图文、小红书、朋友圈、短文案等合格版本。
+- `scripts/`：短视频脚本、口播稿、分镜稿、直播话术。
+- `video-style/`：视频风格、镜头语言、表达节奏、标志性结构。
+- `editing-ideas/`：剪辑节奏、BGM、转场、字幕、素材使用。
+- `publishing-plans/`：发布时间、平台、帐号、发布策略、A/B 方案。
+- `performance-reviews/`：发布后数据、评论反馈、复盘结论。
+- `reusable-patterns/`：长期复用的方法、句式、结构、爆点模板。
+- `best-works/`：用户确认表现好或值得复用的代表作。
+
+## 写入原则
+
+1. 先确认用户是否认可该产出值得沉淀。
+2. 判断内容属于哪个创作流程分类。
+3. 如果内容来自某次完整任务，先建立 `raw/agent` 资料包，再把高价值结果沉淀到 `library/`。
+4. 同一作品可以在多个分类中互相引用，但不要到处复制全文。
+5. 每次完整写入后更新 `index.md` 和 `operation-log.md`。
+6. 重要更新追加到 `log.md`。
+
+## 单条资产模板
+
+优先使用 `templates/asset-entry-template.md`。
+
+必要字段：
+
+- 标题
+- 类型
+- 平台
+- 关联帐号
+- 关联项目或作品
+- 创建/归档时间
+- 内容正文或摘要
+- 为什么值得保存
+- 可复用点
+- 标签
+- 关联文件
+
+## 复用和检索流程
+
+用户要求查找历史内容时：
+
+1. 先读 `index.md`，确定可能的分类。
+2. 再进入对应 `library/` 子目录查找。
+3. 如果查不到，再看 `operation-log.md` 和 `raw/agent`。
+4. 回复时说明命中的文件路径、匹配原因和可复用建议。
+
+用户要求复盘历史内容时：
+
+1. 先找具体作品或资产。
+2. 读取对应内容和 `performance-reviews/`。
+3. 总结可复用结构、表达方式、失败点和下一次优化方向。
+
+## YuanFlow 内置使用方式
+
+在 YuanFlow 主程序内，本 Skill 是托管 CLI Skill 的一个整体目录。不要把 `library/` 下的分类当成独立 Skill 安装，也不要在子目录里创建 `SKILL.md`。
+
+如果需要写入文件，优先使用当前 Skill 的真实目录：
+
+```text
+config.managed_skill_dir
+```
+
+在没有明确用户授权前，不要删除、覆盖或批量移动用户已有创作资料。
+

package/skills/yuanflow-skill//344/270/252/344/272/272/345/210/233/344/275/234/345/272/223/index.md

@@ -0,0 +1,74 @@
+# 个人创作库索引
+
+> 这是个人创作库的总入口。新增合格产出、沉淀可复用方法、完成阶段复盘后，都要同步更新这里。
+
+## 最近更新
+
+- 
+
+## 入口
+
+- 规则入口：`SKILL.md`
+- 时间线：`log.md`
+- 操作记录：`operation-log.md`
+- 原始资料：`raw/manual`
+- 正式资料包：`raw/agent`
+- 创作资产：`library`
+- 模板：`templates`
+
+## 分类索引
+
+### 帐号定位
+
+当前暂无内容。
+
+### 选题
+
+当前暂无内容。
+
+### 标题
+
+当前暂无内容。
+
+### 封面
+
+当前暂无内容。
+
+### 文案
+
+当前暂无内容。
+
+### 脚本
+
+当前暂无内容。
+
+### 视频风格
+
+当前暂无内容。
+
+### 剪辑思路
+
+当前暂无内容。
+
+### 发布计划
+
+当前暂无内容。
+
+### 数据复盘
+
+当前暂无内容。
+
+### 可复用模式
+
+当前暂无内容。
+
+### 代表作
+
+当前暂无内容。
+
+## 待补重点
+
+- 建立首批历史合格产出物索引。
+- 把用户确认表现好的作品沉淀到 `library/best-works/`。
+- 从多次创作中提炼可复用表达和结构，沉淀到 `library/reusable-patterns/`。
+

package/skills/yuanflow-skill//344/270/252/344/272/272/345/210/233/344/275/234/345/272/223/library/account-positioning//347/233/256/345/275/225/350/257/264/346/230/216/346/226/207/346/241/243.md

@@ -0,0 +1,4 @@
+# account-positioning 目录说明
+
+这里保存帐号定位、人设、受众、栏目方向、表达边界和长期运营假设。
+

package/skills/yuanflow-skill//344/270/252/344/272/272/345/210/233/344/275/234/345/272/223/library/best-works//347/233/256/345/275/225/350/257/264/346/230/216/346/226/207/346/241/243.md

@@ -0,0 +1,4 @@
+# best-works 目录说明
+
+这里保存用户确认表现好、值得复盘或值得复用的代表作索引。
+

package/skills/yuanflow-skill//344/270/252/344/272/272/345/210/233/344/275/234/345/272/223/library/copywriting//347/233/256/345/275/225/350/257/264/346/230/216/346/226/207/346/241/243.md

@@ -0,0 +1,4 @@
+# copywriting 目录说明
+
+这里保存用户认可的图文、小红书、朋友圈、短文案、营销文案等合格版本。
+

package/skills/yuanflow-skill//344/270/252/344/272/272/345/210/233/344/275/234/345/272/223/library/covers//347/233/256/345/275/225/350/257/264/346/230/216/346/226/207/346/241/243.md

@@ -0,0 +1,4 @@
+# covers 目录说明
+
+这里保存封面文案、封面视觉方向、封面参考和封面复盘。
+

package/skills/yuanflow-skill//344/270/252/344/272/272/345/210/233/344/275/234/345/272/223/library/editing-ideas//347/233/256/345/275/225/350/257/264/346/230/216/346/226/207/346/241/243.md

@@ -0,0 +1,4 @@
+# editing-ideas 目录说明
+
+这里保存剪辑节奏、BGM、转场、字幕、素材使用和后期处理思路。
+

package/skills/yuanflow-skill//344/270/252/344/272/272/345/210/233/344/275/234/345/272/223/library/performance-reviews//347/233/256/345/275/225/350/257/264/346/230/216/346/226/207/346/241/243.md

@@ -0,0 +1,4 @@
+# performance-reviews 目录说明
+
+这里保存发布后数据、评论反馈、转化反馈、复盘结论和下一次优化建议。
+

package/skills/yuanflow-skill//344/270/252/344/272/272/345/210/233/344/275/234/345/272/223/library/publishing-plans//347/233/256/345/275/225/350/257/264/346/230/216/346/226/207/346/241/243.md

@@ -0,0 +1,4 @@
+# publishing-plans 目录说明
+
+这里保存发布时间、平台、帐号、发布策略、A/B 方案和分发计划。
+

package/skills/yuanflow-skill//344/270/252/344/272/272/345/210/233/344/275/234/345/272/223/library/reusable-patterns//347/233/256/345/275/225/350/257/264/346/230/216/346/226/207/346/241/243.md

@@ -0,0 +1,4 @@
+# reusable-patterns 目录说明
+
+这里保存长期可复用的方法、句式、结构、爆点模板、表达习惯和个人风格资产。
+

package/skills/yuanflow-skill//344/270/252/344/272/272/345/210/233/344/275/234/345/272/223/library/scripts//347/233/256/345/275/225/350/257/264/346/230/216/346/226/207/346/241/243.md

@@ -0,0 +1,4 @@
+# scripts 目录说明
+
+这里保存短视频脚本、口播稿、分镜稿、直播话术和脚本复盘。
+

package/skills/yuanflow-skill//344/270/252/344/272/272/345/210/233/344/275/234/345/272/223/library/titles//347/233/256/345/275/225/350/257/264/346/230/216/346/226/207/346/241/243.md

@@ -0,0 +1,4 @@
+# titles 目录说明
+
+这里保存最终使用标题、备选标题、标题结构和可复用标题公式。
+

package/skills/yuanflow-skill//344/270/252/344/272/272/345/210/233/344/275/234/345/272/223/library/topics//347/233/256/345/275/225/350/257/264/346/230/216/346/226/207/346/241/243.md

@@ -0,0 +1,4 @@
+# topics 目录说明
+
+这里保存已经采用或值得复用的选题，包括选题来源、判断理由、适用平台和后续延展方向。
+

package/skills/yuanflow-skill//344/270/252/344/272/272/345/210/233/344/275/234/345/272/223/library/video-style//347/233/256/345/275/225/350/257/264/346/230/216/346/226/207/346/241/243.md

@@ -0,0 +1,4 @@
+# video-style 目录说明
+
+这里保存视频风格、镜头语言、表达节奏、人物状态、画面调性和标志性结构。
+

package/skills/yuanflow-skill//344/270/252/344/272/272/345/210/233/344/275/234/345/272/223/log.md

@@ -0,0 +1,14 @@
+# 个人创作库时间线
+
+> 按时间追加，记录结构调整、重要资产归档、阶段性复盘和分类变更。
+
+## [2026-05-15] init | 初始化个人创作库骨架
+
+- 新建：`SKILL.md`
+- 新建：`index.md`
+- 新建：`operation-log.md`
+- 新建：`raw/manual`、`raw/agent`
+- 新建：`library/` 下创作者全流程分类
+- 新建：`templates/asset-entry-template.md`
+- 说明：本库用于沉淀用户认可的合格自媒体创作产出，不替代从 0 到 1 的创作型 Skill。
+

package/skills/yuanflow-skill//344/270/252/344/272/272/345/210/233/344/275/234/345/272/223/operation-log.md

@@ -0,0 +1,45 @@
+# 个人创作库操作记录
+
+> 每次开始整理前先看这里，避免重复归档、重复分析、覆盖已有内容。每次完整任务结束后追加记录。
+
+## 使用规则
+
+### 开始任务前
+
+- 先看最近几条记录。
+- 确认最近整理过哪些作品、分类、模板和索引。
+- 如果用户要求“继续上次整理”，优先从最近记录定位上下文。
+
+### 完成任务后
+
+追加一条记录，至少包含：
+
+- 时间戳
+- 任务内容
+- 涉及文件
+- 更改内容
+- 验证情况
+- 备注 / 风险
+
+## 记录模板
+
+```markdown
+## [YYYY-MM-DD HH:MM:SS +08:00] task | 任务标题
+
+- 任务内容：
+- 涉及文件：
+- 更改内容：
+- 验证情况：
+- 备注 / 风险：
+```
+
+## 执行记录
+
+## [2026-05-15 00:00:00 +08:00] init | 初始化个人创作库
+
+- 任务内容：建立个人创作库基础目录、索引和操作记录。
+- 涉及文件：`SKILL.md`、`index.md`、`log.md`、`operation-log.md`、`raw/`、`library/`、`templates/`
+- 更改内容：创建面向创作者全流程的归档分类。
+- 验证情况：待首次真实归档任务验证。
+- 备注 / 风险：后续不要在子目录创建 `SKILL.md`，避免被程序识别为多个 Skill。
+

package/skills/yuanflow-skill//344/270/252/344/272/272/345/210/233/344/275/234/345/272/223/raw/agent/.gitkeep

@@ -0,0 +1 @@
+

package/skills/yuanflow-skill//344/270/252/344/272/272/345/210/233/344/275/234/345/272/223/raw/manual/.gitkeep

@@ -0,0 +1 @@
+

package/skills/yuanflow-skill//344/270/252/344/272/272/345/210/233/344/275/234/345/272/223/templates/asset-entry-template.md

@@ -0,0 +1,39 @@
+# [资产标题]
+
+## 基本信息
+
+- 类型：
+- 平台：
+- 关联帐号：
+- 关联项目/作品：
+- 创建时间：
+- 归档时间：
+- 状态：已确认 / 待复查 / 已淘汰
+- 标签：
+
+## 内容正文或摘要
+
+
+## 为什么值得保存
+
+
+## 可复用点
+
+- 
+
+## 适用场景
+
+- 
+
+## 关联资料
+
+- 原始资料包：
+- 关联分类：
+- 关联作品链接：
+
+## 复盘记录
+
+- 数据表现：
+- 用户反馈：
+- 下次优化：
+

package/src/knowledge-tools.js

@@ -70,6 +70,7 @@ export async function navigateKnowledge({ action, options }) {
 }
 
 function knowledgeCommand(action, description, extraOptions = []) {
+  const normalizedAction = normalizeAction(action);
   return {
     key: `knowledge.${action}`,
     command: `knowledge ${action}`,
@@ -79,12 +80,12 @@ function knowledgeCommand(action, description, extraOptions = []) {
     apiPath: KNOWLEDGE_NAVIGATE_PATH,
     positionals: [],
     options: [
-      ...taskFrameOptions(),
+      ...taskFrameOptions(normalizedAction),
       ...extraOptions,
       ...commonOptions(),
     ],
     requestBody: {
-      action: normalizeAction(action),
+      action: normalizedAction,
       task_frame: '<由 task-frame 参数组装>',
       params: '<由命令参数组装>',
     },
@@ -92,12 +93,13 @@ function knowledgeCommand(action, description, extraOptions = []) {
   };
 }
 
-function taskFrameOptions() {
+function taskFrameOptions(action) {
+  const requiresTaskFrame = ['entry', 'packs', 'evaluate'].includes(action);
   return [
     { flag: '--task-intent', name: 'taskIntent', required: false, label: '兼容旧字段；v2 接口不要求填写。' },
     { flag: '--output-format', name: 'outputFormat', required: false, label: '输出格式，例如 short_video_script、social_post、any。' },
-    { flag: '--domain', name: 'domain', required: false, label: '内容领域。' },
-    { flag: '--content-goal', name: 'contentGoal', required: true, label: '具体创作或评估目标；等同 task_frame.content_goal，不能为空。' },
+    { flag: '--domain', name: 'domain', required: requiresTaskFrame, label: '内容领域；等同 task_frame.domain，不能为空。' },
+    { flag: '--content-goal', name: 'contentGoal', required: requiresTaskFrame, label: '具体创作或评估目标；等同 task_frame.content_goal，不能为空。' },
     { flag: '--target-audience', name: 'targetAudience', required: false, label: '目标受众，例如 创业者、宝妈、普通用户。' },
     { flag: '--tone', name: 'tone', required: false, label: '语气风格。' },
     { flag: '--communication-mode', name: 'communicationMode', required: false, label: '表达方式，例如 口播、图文、文章。' },
@@ -121,7 +123,7 @@ async function buildTaskFrame(options) {
     ...fromFile,
     task_intent: pick(options, 'task-intent', fromFile.task_intent),
     output_format: pick(options, 'output-format', fromFile.output_format || 'any'),
-    domain: pick(options, 'domain', fromFile.domain || '自媒体运营'),
+    domain: pick(options, 'domain', fromFile.domain),
     content_goal: pick(options, 'content-goal', fromFile.content_goal || ''),
     target_audience: pick(options, 'target-audience', fromFile.target_audience || ''),
     tone: pick(options, 'tone', fromFile.tone || ''),