@joekytc/dsh-swarm 0.1.2 → 0.2.0

package/skills/llm-wiki-skill/templates/index-en-template.md

@@ -0,0 +1,51 @@
+# Wiki Index
+
+> Last updated: {{DATE}}
+
+---
+
+## Overview
+
+- Topic: {{TOPIC}}
+- Total sources: 0
+- Total wiki pages: 0
+
+---
+
+## Entity Pages
+
+> People, organizations, concepts, tools
+
+(none yet)
+
+---
+
+## Topic Pages
+
+> Research topics, knowledge domains
+
+(none yet)
+
+---
+
+## Source Summaries
+
+> One summary page per ingested source
+
+(none yet)
+
+---
+
+## Comparisons
+
+> Side-by-side analysis of options, tools, viewpoints
+
+(none yet)
+
+---
+
+## Synthesis
+
+> Deep cross-source analysis
+
+(none yet)

package/skills/llm-wiki-skill/templates/index-template.md

@@ -0,0 +1,51 @@
+# 知识库索引
+
+> 最后更新：{{DATE}}
+
+---
+
+## 概览
+
+- 主题：{{TOPIC}}
+- 素材总数：0
+- Wiki 页面总数：0
+
+---
+
+## 实体页
+
+> 人物、组织、概念、工具等
+
+（暂无）
+
+---
+
+## 主题页
+
+> 研究主题、知识领域
+
+（暂无）
+
+---
+
+## 素材摘要
+
+> 每个消化过的素材都有一篇摘要
+
+（暂无）
+
+---
+
+## 对比分析
+
+> 对比不同方案、工具、观点
+
+（暂无）
+
+---
+
+## 综合分析
+
+> 跨素材的深度分析
+
+（暂无）

package/skills/llm-wiki-skill/templates/log-en-template.md

@@ -0,0 +1,11 @@
+# Operation Log
+
+> Records all changes to this wiki
+
+---
+
+## {{DATE}} — Initialized
+
+- **Action**: Created wiki
+- **Topic**: {{TOPIC}}
+- **Status**: Done

package/skills/llm-wiki-skill/templates/log-template.md

@@ -0,0 +1,11 @@
+# 操作日志
+
+> 记录知识库的所有变更历史
+
+---
+
+## {{DATE}} — 初始化
+
+- **操作**：创建知识库
+- **主题**：{{TOPIC}}
+- **状态**：完成

package/skills/llm-wiki-skill/templates/overview-en-template.md

@@ -0,0 +1,41 @@
+# {{TOPIC}} — Wiki Overview
+
+> Created: {{DATE}}
+
+---
+
+## About this wiki
+
+This wiki collects all knowledge and sources about **{{TOPIC}}**.
+
+Each source is digested and organized by AI into interlinked wiki pages. Browse by:
+
+- **Entity pages**: people, organizations, concepts, tools
+- **Topic pages**: synthesis around a research theme
+- **Source summaries**: key takeaways from each source
+- **Comparisons**: side-by-side analysis of options or viewpoints
+- **Synthesis**: deep cross-source insights
+
+---
+
+## Knowledge map
+
+(Will show major coverage areas as sources accumulate)
+
+---
+
+## Quick navigation
+
+| Type | Count | View |
+|------|-------|------|
+| Sources | 0 | [[Source Summaries]] |
+| Entities | 0 | [[Entity Pages]] |
+| Topics | 0 | [[Topic Pages]] |
+| Comparisons | 0 | [[Comparisons]] |
+| Synthesis | 0 | [[Synthesis]] |
+
+---
+
+## Recent updates
+
+(none yet)

package/skills/llm-wiki-skill/templates/overview-template.md

@@ -0,0 +1,41 @@
+# {{TOPIC}} — 知识库总览
+
+> 创建于 {{DATE}}
+
+---
+
+## 关于这个知识库
+
+这里收集了关于 **{{TOPIC}}** 的所有知识和素材。
+
+每个素材都经过 AI 消化和整理，形成了互相链接的 wiki 页面。你可以通过以下方式浏览：
+
+- **实体页**：人物、组织、概念、工具的详细介绍
+- **主题页**：围绕某个研究主题的综合分析
+- **素材摘要**：每篇素材的核心观点提取
+- **对比分析**：不同方案、工具、观点的横向比较
+- **综合分析**：跨素材的深度洞察
+
+---
+
+## 知识地图
+
+（随着素材积累，这里会展示知识库覆盖的主要方向）
+
+---
+
+## 快速导航
+
+| 类型 | 数量 | 查看 |
+|------|------|------|
+| 素材 | 0 | [[素材摘要]] |
+| 实体 | 0 | [[实体页]] |
+| 主题 | 0 | [[主题页]] |
+| 对比 | 0 | [[对比分析]] |
+| 综合 | 0 | [[综合分析]] |
+
+---
+
+## 最近更新
+
+（暂无）

package/skills/llm-wiki-skill/templates/purpose-en-template.md

@@ -0,0 +1,16 @@
+# Research Purpose and Direction
+
+## Core Goal
+<!-- What problem should this wiki solve, and who does it help? -->
+[To fill]
+
+## Key Questions
+<!-- The 3-5 questions you most want this wiki to answer -->
+1. [To fill]
+2. [To fill]
+3. [To fill]
+
+## Research Scope
+<!-- What should be covered here, and what stays out of scope? -->
+**Include:** [To fill]
+**Exclude:** [To fill]

package/skills/llm-wiki-skill/templates/purpose-template.md

@@ -0,0 +1,16 @@
+# 研究目的与方向
+
+## 核心目标
+<!-- 这个知识库要解决什么问题？帮助谁？ -->
+[待填写]
+
+## 关键问题
+<!-- 你最想知道答案的 3-5 个问题 -->
+1. [待填写]
+2. [待填写]
+3. [待填写]
+
+## 研究范围
+<!-- 涵盖哪些领域/主题？不涵盖什么？ -->
+**涵盖：** [待填写]
+**不涵盖：** [待填写]

package/skills/llm-wiki-skill/templates/query-template.md

@@ -0,0 +1,19 @@
+---
+type: query
+derived: true
+title: "{{TITLE}}"
+created: {{DATE}}
+updated: {{DATE}}
+tags: [{{TAGS}}]
+sources: [{{SOURCES}}]
+related: [{{RELATED}}]
+---
+
+## 问题
+{{QUESTION}}
+
+## 回答
+{{ANSWER}}
+
+## 引用来源
+{{SOURCE_LINKS}}

package/skills/llm-wiki-skill/templates/schema-template.md

@@ -0,0 +1,185 @@
+# Wiki Schema（知识库配置规范）
+
+> 这个文件告诉 AI 如何维护你的知识库。你和 AI 可以一起调整它。
+
+## 知识库信息
+
+- 主题：{{TOPIC}}
+- 创建日期：{{DATE}}
+- 语言：{{LANGUAGE}}
+- 版本：1.1
+
+## 目录结构
+
+```
+{{WIKI_ROOT}}/
+├── raw/                    # 原始素材（AI 只读，不会修改）
+│   ├── articles/           # 网页文章
+│   ├── tweets/             # X/Twitter 内容
+│   ├── wechat/             # 微信公众号文章
+│   ├── xiaohongshu/        # 小红书内容
+│   ├── zhihu/              # 知乎内容
+│   ├── pdfs/               # PDF 文件
+│   ├── notes/              # 手写笔记
+│   └── assets/             # 图片等附件
+├── wiki/                   # 知识库主体（AI 写，你看）
+│   ├── entities/           # 实体页（人物、组织、概念）
+│   ├── topics/             # 主题页（研究主题、知识领域）
+│   ├── sources/            # 素材摘要页（每个素材一篇摘要）
+│   ├── comparisons/        # 对比分析页
+│   └── synthesis/          # 综合分析页
+├── index.md                # 内容索引（目录）
+├── log.md                  # 操作日志（时间线）
+└── .wiki-schema.md         # 本文件（配置规范）
+```
+
+## 页面命名规范
+
+- 实体页：`wiki/entities/{名称}.md`
+  - 例：`wiki/entities/知识构建.md`、`wiki/entities/Transformer.md`
+- 主题页：`wiki/topics/{主题名}.md`
+  - 例：`wiki/topics/AI编程工具.md`、`wiki/topics/大语言模型.md`
+- 素材摘要：`wiki/sources/{日期}-{短标题}.md`
+  - 例：`wiki/sources/2026-04-05-karpathy-llm-wiki.md`
+- 对比分析：`wiki/comparisons/{对比主题}.md`
+  - 例：`wiki/comparisons/工具选型.md`
+- 综合分析：`wiki/synthesis/{分析主题}.md`
+  - 例：`wiki/synthesis/AI工具选型建议.md`
+
+## 交叉引用规范
+
+- 页面间使用 `[[页面名]]` 语法（Obsidian 兼容的双向链接）
+- 素材引用格式：`[来源: 素材标题](../sources/xxx.md)`
+- 每个页面底部维护"相关页面"列表
+
+## 页面格式规范
+
+每个 wiki 页面应包含：
+
+```markdown
+---
+tags: [标签1, 标签2]
+created: YYYY-MM-DD
+updated: YYYY-MM-DD
+sources: [关联素材列表]
+---
+
+# 页面标题
+
+> 一句话摘要
+
+## 正文内容
+
+...
+
+## 相关页面
+
+- [[另一个页面]]
+- [[又一个页面]]
+```
+
+## Ingest（消化素材）规则
+
+### 分级处理
+
+根据素材长度和信息密度自动分级：
+
+**完整处理**（素材 > 1000 字）：
+1. 每个新素材**必须**生成摘要页（`wiki/sources/` 下）
+2. 从素材中提取 3-5 个关键概念
+3. 检查是否需要创建新的实体页（`wiki/entities/`）
+4. 检查是否需要创建或更新主题页（`wiki/topics/`）
+5. 更新 `index.md`（添加新条目）
+6. 更新 `log.md`（记录操作）
+7. 更新 `overview.md`（如果知识库全貌有变化）
+
+**简化处理**（素材 < 1000 字，如短推文、小红书笔记）：
+1. 生成摘要页（`wiki/sources/` 下）
+2. 提取 1-3 个关键概念
+3. 如果关键概念已有实体页，追加信息；如果没有，在摘要页中标记 `[待创建]`
+4. 更新 `index.md` 和 `log.md`
+5. 跳过主题页和 overview 更新
+
+### 来源边界
+
+这套边界和安装输出、状态说明、回归测试保持一致。
+
+| 分类 | 当前来源 | 处理原则 |
+|------|----------|----------|
+| 核心主线 | `PDF / 本地 PDF`、`Markdown/文本/HTML`、`纯文本粘贴` | 不依赖外挂，直接进入主线 |
+| 可选外挂 | `网页文章`、`X/Twitter`、`微信公众号`、`YouTube`、`知乎` | 先自动提取；失败时退回手动入口 |
+| 手动入口 | `小红书` | 只接受用户手动粘贴 |
+
+### 素材类型路由
+
+| 来源 | raw 目录 | 提取方式 |
+|------|----------|----------|
+| 网页文章 | `raw/articles/` | baoyu-url-to-markdown skill |
+| X/Twitter | `raw/tweets/` | baoyu-url-to-markdown skill（需 Chrome 登录） |
+| 微信公众号 | `raw/wechat/` | wechat-article-to-markdown |
+| YouTube | `raw/articles/` | youtube-transcript skill |
+| 小红书 | `raw/xiaohongshu/` | 用户手动粘贴内容 |
+| 知乎 | `raw/zhihu/` | 用户手动粘贴内容 或 baoyu-url-to-markdown skill |
+| PDF / 本地 PDF | `raw/pdfs/` | 直接读取 |
+| Markdown/文本/HTML | `raw/notes/` | 直接读取 |
+| 纯文本粘贴 | `raw/notes/` | 直接使用 |
+
+## 别名词表（Alias Table）
+
+用于 query 和 digest 时自动展开搜索。搜索任意一个词，会同时搜索同一行的所有别名。
+AI 在 ingest 时如果发现新的同义词关系，可以建议用户添加。
+
+格式：每行一组同义词，用 `=` 分隔。
+
+```
+LLM = 大语言模型 = 大模型 = Large Language Model
+RAG = 检索增强生成 = Retrieval Augmented Generation
+fine-tuning = 微调 = 精调
+prompt engineering = 提示工程 = 提示词工程
+```
+
+维护原则：
+- 只收录在你的知识库里**实际出现过**的同义词，不要预填一堆用不到的
+- 每组控制在 5 个以内，太多说明概念本身需要拆分
+- 中英文混用时把最常用的放第一个
+- ingest 发现新的同义词关系时，AI 应主动建议添加到此表
+
+## Query（查询）规则
+
+1. 先读 `index.md`，定位相关条目
+2. 用 Grep 在 `wiki/` 下搜索关键词
+3. 阅读相关页面后综合回答
+4. 回答中标注来源页面（引用链接）
+5. 有价值的分析建议保存为新的 wiki 页面
+
+## Lint（健康检查）规则
+
+1. 检查范围：随机抽查 10 个页面 + 最近更新的 10 个页面
+2. 检查项：
+   - 页面间矛盾（不同页面说法不一致）
+   - 孤立页面（没有其他页面链接到它）
+   - 缺失概念页（被 `[[某概念]]` 链接但实际不存在）
+   - 缺少交叉引用（相关页面之间没有互相链接）
+   - index 一致性（index.md 记录与实际文件是否对应）
+3. 输出中文报告，对每个问题给出修复建议
+4. 如果发现问题，询问用户是否自动修复
+
+## 关系类型词汇表（可选，用于手动标注知识图谱）
+
+这张表提供 graph 工作流生成的 `wiki/knowledge-graph.md` 里**可选**的关系类型词汇。
+AI 生成图谱时默认全部用 `-->`（无标注），不自动判断关系类型。如果你想让图谱
+更清楚地表达节点之间的语义，可以用编辑器把最重要的几条箭头改写成带标注的形式：
+
+| 类型关键词 | 含义 | Mermaid 写法示例 |
+|-----------|------|-----------------|
+| 实现       | A 是 B 的具体实现 | `A -->|实现| B` |
+| 依赖       | A 依赖 B 才能工作 | `A -->|依赖| B` |
+| 对比       | A 与 B 是同类可以比较 | `A -->|对比| B` |
+| 矛盾       | A 与 B 存在观点冲突 | `A -->|矛盾| B` |
+| 衍生       | A 从 B 演化而来 | `A -->|衍生| B` |
+
+使用原则：
+- 只标最重要的 3-5 条关系，不要强行给所有箭头打标
+- 不确定的关系保持默认 `-->` 箭头
+- 自定义类型控制在 2 个以内，避免词汇表膨胀
+- 标注后在 Obsidian / VS Code（Markdown Preview Enhanced）/ Typora 里重新渲染就能看到标签

package/skills/llm-wiki-skill/templates/source-template.md

@@ -0,0 +1,51 @@
+---
+tags: [素材摘要]
+created: {{DATE}}
+updated: {{DATE}}
+sources: []
+source_type: {{TYPE}}
+source_path: {{RAW_PATH}}
+images: 0
+image_paths: []
+---
+
+# {{SOURCE_TITLE}}
+
+> 一句话总结这篇素材的核心观点
+
+## 基本信息
+
+- **来源类型**：{{TYPE}}（文章 / 推文 / 公众号 / PDF / 笔记 / 视频）
+- **原文位置**：{{RAW_PATH}}
+- **消化日期**：{{DATE}}
+
+## 核心观点
+
+（3-5 个要点，每个要点用 1-2 句话说清楚）
+
+1. **要点一**：...
+2. **要点二**：...
+3. **要点三**：...
+
+## 关键概念
+
+（素材中提到的重要概念，链接到或标注需要创建的实体页）
+
+- [[概念1]]
+- [[概念2]]
+
+## 与其他素材的关联
+
+（这篇素材和已有素材之间有什么联系？是补充、反驳、还是扩展？）
+
+- 与 [[另一篇素材]] 的关系：...
+
+## 原文精彩摘录
+
+（值得原样保留的 2-3 段原文）
+
+> 摘录一...
+
+> 摘录二...
+
+## 相关页面

package/skills/llm-wiki-skill/templates/synthesis-template.md

@@ -0,0 +1,25 @@
+# {{TOPIC}} 结晶化
+
+日期：{{DATE}}
+来源：对话/工作会话
+置信度：INFERRED
+
+## 核心洞见
+
+<!-- 3-5 条关键洞见，每条一行 -->
+
+## 关键决策
+
+<!-- 做了什么决定，为什么这么决定 -->
+
+## 涉及概念
+
+<!-- 列出本次会话涉及的重要概念，每个用 [[概念名]] 格式链接 -->
+
+## 参考资料
+
+<!-- 对话中提到的文章、工具、项目 -->
+
+## 待跟进
+
+<!-- 还没解决的问题，或者下一步要验证的假设 -->

package/skills/llm-wiki-skill/templates/topic-template.md

@@ -0,0 +1,35 @@
+---
+tags: [主题]
+created: {{DATE}}
+updated: {{DATE}}
+sources: []
+---
+
+# {{TOPIC_NAME}}
+
+> 一句话概括这个主题的核心问题或方向
+
+## 核心观点
+
+（从多个素材中综合出来的关于这个主题的核心认知）
+
+## 素材汇总
+
+（列出所有讨论过这个主题的素材，标注每篇的核心贡献）
+
+| 素材 | 核心贡献 | 详见 |
+|------|----------|------|
+| （素材名） | （一句话） | [[素材摘要页]] |
+
+## 关键概念
+
+（这个主题涉及的关键概念，链接到对应实体页）
+
+- [[概念1]] — 简要说明
+- [[概念2]] — 简要说明
+
+## 未解决的问题
+
+（素材中提到但没有答案的问题，或素材之间存在矛盾的地方）
+
+## 相关页面