--- name: knowledge-base description: "个人知识库数据结构框架 - 面向创作者的树形知识体系+创意作品解构管理" --- ## 触发方式 Claude 原触发：`/kb`。在 Codex 中，用户提到该命令、技能名或相关任务时，先读取并遵循本 skill。 # /kb (knowledge-base) 面向创作者的树形知识库框架，支持科学知识体系化整理 + 创意作品精细化拆解。 ## 核心设计理念 - **严格树形知识架构**：科学知识按学科层级组织，支持从根到叶的无限延伸 - **标签分类树**：标签不是扁平的，而是有层级、可继承的分类体系 - **作品组件树支持**：对动漫、小说等作品按任意维度拆解（角色、世界观、剧情、主题等） - **混合导航**：树形结构为主 + 标签横向关联 ## 核心数据实体 ### 1. KnowledgeNode（知识树节点） ```yaml id: uuid parent_id: uuid | null name: string # 概念名 full_path: string # 如"科学/生物学/进化论/性选择" node_type: enum [domain, category, concept, fact, trivia] # domain=学科根, category=子分类, concept=核心概念, fact=具体事实, trivia=趣味/冷知识 content: markdown # 定义、理解、笔记 depth_level: int # 层级深度 # 关联 prerequisites: [node_ids] # 前置知识 related_nodes: [{node_id, relation_type, note}] # 溯源 sources: [{ source_type: enum [book, paper, article, video, podcast, course, conversation], title: string, author: string, url: string, timestamp: string }] # 元数据 tags: [tag_full_paths] created_at: datetime updated_at: datetime review_count: int mastery_level: enum [exposed, familiar, understood, mastered, can_teach] ``` ### 2. Tag（标签树） ```yaml id: uuid name: string parent_id: uuid full_path: string # 如"创作研究/叙事/结构/三幕式" color: hex description: string aliases: [string] usage_count: int ``` **标签树结构**: ``` 创作研究/ ├── 叙事/结构/[三幕式,英雄之旅,多线叙事] ├── 角色/原型/[成长型英雄,悲剧英雄,导师] ├── 世界观/ └── 情感/[热血,治愈,悬疑,荒诞] 知识状态/[待整理,待理解,已掌握,可输出] 关联类型/[支持强化,矛盾颠覆,类比隐喻,因果推导] ``` ### 3. CreativeWork（创意作品容器） ```yaml id: uuid title: string type: enum [animation, manga, novel, film, game, short_video] creators: [{role, name}] release_year: int status: enum [planned, consuming, consumed, re_consuming] personal_rating: 1-10 research_depth: enum [surface, component, deep_analysis] components: [WorkComponent] # 树形组件 tags: [tag_full_paths] ``` ### 4. WorkComponent（作品组件树） ```yaml id: uuid work_id: uuid parent_id: uuid | null # 支持无限嵌套 component_type: enum - narrative_arc # 叙事弧/篇章 - scene # 场景/名场面 - character # 角色 - world_element # 世界观元素 - theme # 主题/母题 - technique # 创作技法 - item # 道具/设定 - dialogue # 对白 name: string span: {start, end} # 时间范围 summary: string analysis: markdown # 你的详细研究 # 角色特有 character_profile: role_type: enum [protagonist, deuteragonist, antagonist, support] motivation: string arc_type: enum [positive_change, negative_change, flat, transformative] relationships: [{ # 双向关系追踪 target_component_id: uuid, relation_type: enum [family, friend, rival, mentor, enemy, complex], dynamics: string, # A对B reciprocal_dynamics: string # B对A（可选） evolution: string }] # 世界观特有 world_profile: category: enum [geography, history, politics, technology, magic_system, culture] rules: [{rule, implications, broken_in_story}] # 关联 inspired_knowledge: [{knowledge_node_id, connection_note}] tags: [tag_full_paths] order_index: int ``` ### 5. QuickCapture（快速捕获） ```yaml id: uuid captured_at: datetime raw_content: string status: enum [inbox, processing, triaged_to_knowledge, triaged_to_work, archived] auto_parsed: likely_type: enum [knowledge, work_observation, cross_insight] suggested_knowledge_parent: string suggested_tags: [tag_paths] mentioned_works: [string] mentioned_concepts: [string] ``` --- ## 使用场景 ### 捕获新知识 ``` /kb capture "热力学第二定律的微观解释是熵增原理，即孤立系统总是趋向于更混乱的状态" → 解析建议: 添加到 "科学/物理学/热力学/熵" → 标签建议: 知识状态/待整理 ``` ### 拆解作品 ``` /kb decompose "进击的巨人" --type animation → 创建作品容器 → 建议组件: 角色[艾伦,三笠,阿尔敏], 世界观[墙内社会,巨人起源], 主题[自由与宿命] ``` ### 建立关联 ``` /kb link --from-component "艾伦的动机" --to-knowledge "认知失调理论" → 在WorkComponent.inspired_knowledge中创建记录 ``` --- ## 数据关系图谱 ``` [KnowledgeNode] ←tree→ [KnowledgeNode] ↑ ↓ prerequisite related ↓ ↑ [KnowledgeNode] ←inspired→ [WorkComponent] ↑ tree (components) ↓ [CreativeWork] ↓ tagged ↓ [Tag] ←tree→ [Tag] ``` --- ## 目录结构 ``` TenkajinKB/ ├── 00_System/ # 系统配置层（全局资产） │ ├── Tags/ # 全局标签定义 │ │ ├── 创作研究.md │ │ ├── 知识状态.md │ │ └── 关联类型.md │ └── Config/ # 其他系统配置 │ └── knowledge-base-schema.yaml │ ├── 01_Active_Projects/ # 项目（引用全局标签） ├── 02_Knowledge_Base/ # 知识（引用全局标签） └── 03_Inbox/ # 收集箱（引用全局标签） ``` **为何 Tags 在 00_System：** - 标签是**全局资产**，跨三个一级模块共享 - 树形标签定义在中央位置，确保一致性 - Dashboard 通过 tags.html 提供可视化树形浏览器 --- ## 设计原则 1. **树形优先**：知识必须有明确父子归属，查找时层级清晰 2. **标签辅助**：横向关联通过标签树的叶子节点实现 3. **作品可拆解**：任何作品可按"篇章→场景→角色"或"主题→子主题"任意嵌套 4. **快速捕获不归类**：先捕获，后整理，inbox机制避免打断流 5. **关系双向存储**：角色关系统一存储，支持不同的A→B和B→A描述 --- ## 迭代机制 - `mastery_level` 和 `review_count` 支持间隔复习 - `research_depth` 追踪对作品的拆解深度 - `usage_count` 让高频标签自动靠前 --- Version: 0.1.0 Author: user-defined Last Updated: 2026-04-19