# 黑曜石整合将 Claude 工作流程与 ObsidianVault 集成的专家指南，包括使用 Obsidian 基于 Markdown 的系统进行笔记创建、任务管理和知识组织。 ## 何时使用此技能 * 在与 Claude 的开发会议期间创建笔记 * 在 Obsidian 中跟踪任务和 TODO * 记录与 Claude 一起发现的决策和解决方案 * 建立项目见解的知识库 * 整理克劳德会议的研究成果 * 创建会议记录或会议摘要 ## 核心原则 1. **保管库位置** \- 使用 `$OBSIDIAN_VAULT` 环境变量作为保管库路径 2. **始终询问用户笔记放置** \- 切勿在未先询问用户的情况下决定保存笔记的位置。显示库结构，建议选项，并让用户选择。 3. **原子笔记** \- 每个笔记都集中于一个概念或主题 4. **链接** \- 使用 wikilinks `[[note-name]]` 连接相关的想法 5. **标签** \- 使用分层标签进行组织，如“#project/feature” 6. **任务** \- 对可操作项目使用复选框语法 7. **时间戳** \- 包含时间上下文的日期 ## 黑曜石最佳实践（2025-2026）基于黑曜石社区当前的最佳实践： ### 1\.从简单开始，不要想太多 **关键原则**：先写，后组织（或从不） * 专注于创建笔记，而不是完善系统 * 让您的保管库结构随着您添加内容而自然演变 * 不要花费大量时间来规划“完美”的组织 * 从一些注释开始，逐步探索高级功能 **避免生产性拖延**： * ❌ **不要** ：花费所有时间调整系统并让它正常工作 * ❌ **不要** ：不断优化标签、文件夹和组织 * ✅ **做** ：花 80% 的时间写作/工作，20% 的时间组织 * ✅ **要做** ：在每周回顾期间进行组织，而不是经常进行 ### 2\.在深层文件夹上使用 MOC（内容地图） **什么是 MOC？** *“内容地图”是主要链接到其他注释的注释 * 充当主题的索引或目录 * 提供灵活的多对多关系（与文件夹不同） **为什么选择 MOC > 文件夹：** * 笔记可以属于多个主题，但只能属于一个文件夹 * MOC 允许一个注释出现在许多不同的“地图”中 * 更容易重组 - 只需更新链接，无需移动文件 * 更符合知识的实际联系方式 **MOC 最佳实践：** * 将 MOC 控制在 25 项以下，以便于导航 * 将 MOC 视为高级概述，而不是综合索引 * 当部分太大时创建子 MOC * 使用一致的层次结构 - 所有链接都处于同一概念级别 * 包括用于视觉扫描的表情符号图标 **何时创建 MOC：** *“精神挤压点”——当你对许多相关笔记感到不知所措时 * 当您对相关主题有 5 个以上笔记时 * 开始新项目时 * 当您需要导航中心时 **MOC 与自述文件：** * MOC 是黑曜石原生的，具有属性和维基链接 * 自述文件更符合降价标准，但集成度较低 * 更喜欢 MOC 以获得更好的黑曜石功能（图形视图、反向链接） ### 3\.杠杆属性（元数据） **为什么选择属性>文件夹：** * 可搜索：查找整个金库中的所有“类型：规划”笔记 * 灵活：一张笔记可以有多个属性值 * 数据视图兼容：自动生成带有查询的列表 * 比仅文件夹组织更强大 **推荐的属性架构：** --- 类型：规划 |参考|待办事项 |莫克 |发展|会议|分析项目：项目名称子项目：子项目名称状态：活跃 |进行中 |已完成 |已存档 |被阻止标签： - 主题1 - 主题2 - 主题3 优先级：关键 |高|中等|低创建时间：YYYY-MM-DD 更新日期：YYYY-MM-DD --- **财产用途：** * 添加到所有新笔记以保持一致性 * 使用`type`按注释功能而不是主题进行分类 * 使用“project”对文件夹进行分组 * 使用“status”来跟踪进度 * 使用“标签”进行主题分类 * 保持保险库中的属性名称一致 * **始终将`dump`标签添加到会话/每日笔记** \- 使它们易于过滤和存档 #### 关键：转储标签要求 **始终在会话/每日笔记中包含“dump”标签。**此标签对于以下情况至关重要： * 过滤项目中的所有会话笔记：`tag:#dump` * 使用“/consolidate-notes”归档工作流程 * 将工作笔记与永久文档分开 **注意：** 会话笔记应存储在 `session-saves/` 目录中。请参阅项目结构标准的 **文件夹组织** 技能。 **在命令中创建会话笔记时：** 新文件的 Python 模板（带有 frontmatter）： # 使用 frontmatter 创建新笔记 f.write("---\n") f.write("类型：会话\n") f.write(f"项目：{PROJECT_NAME}\n") f.write(f"日期: {date_str}\n") f.write("标签：\n") f.write(" - 会话\n") f.write(" - dump\n") # 必需 f.write("状态：已完成\n") f.write("---\n\n") 附加到现有文件时： * 只追加内容（frontmatter已经存在） * 无需再次添加转储标签 **执行：** * 创建会话注释的所有命令（`/safe-exit`、`/safe-clear`）自动包含转储标签 * 技能示例在所有会话笔记模板中显示转储标签 ### 4\.实际使用你的笔记 **最大的挑战**：记笔记但不复习 **审查系统：** * 安排每周回顾以重温笔记 * 使用笔记时进行清理和重组 * 重新排列信息、添加链接、更新文本 * 将新发现链接到现有笔记 * 归档或删除过时的笔记 **主动笔记管理：** * 开始相关工作时阅读旧笔记 * 用新的见解更新笔记 * 从新笔记向后链接到旧笔记 * 以先前的知识为基础 **使笔记可操作：** * 添加 TODO 和后续步骤 * 相关代码或文件的链接 * 包括“另请参阅”部分 * 创建清晰的“快速操作”列表 ### 5\.按笔记类型而不是主题进行组织 **传统（基于主题）：** 保险库/ ├── 机器学习/ │ ├── 会话笔记.md │ ├── 研究.md │ └── todos.md └── 网页开发/ ├── 会话笔记.md └── 研究.md **更好（基于类型+属性）：** 保险库/ ├── Sessions/（所有会议笔记，按项目标记） ├── Planning/（所有规划文档，按项目标记） ├── TODOs/（所有任务跟踪） └── 参考资料/（全部参考资料）然后使用属性和标签按主题分组： * `项目：机器学习` * `标签：[ml，神经网络]` **好处：** * 无论主题如何，组织一致 * 轻松查找特定类型的所有笔记 * 属性处理主题分类 * 更简单的文件夹结构 ### 6\.创建主页/索引 MOC **中央导航中心：** * 整个金库的单一起点 * 所有项目 MOC 的链接 * 快速访问 TODO 和最近的笔记 * 项目状态概览 * 固定在黑曜石中以便于访问 **首页 MOC 结构：** # 🏠 首页 ## 🎯 活跃项目 - [[Project-1-MOC]] - 说明 - [[Project-2-MOC]] - 描述 ## 📋 快速访问 - [[待办事项/主索引]] - [[会话/最新]] ## 📚 主题知识 - [[主题-1-MOC]] - [[主题 2-MOC]] ## 🗂️ 按注释类型 - 规划笔记 - 开发会议 - 参考文档 ### 7\.大量链接，最少文件夹 **链接策略：** * 在编写时创建链接 * 立即链接到相关概念 * 相关时使用双向链接 * 通过连接构建知识图谱 **文件夹策略：** * 保持文件夹结构平坦（最多 2-3 层） * 使用文件夹作为笔记类型，而不是主题 * 依靠链接和属性进行组织 * 注重速度和导航的便捷性 ## 保险库配置 ### 环境设置黑曜石保管库位置存储在“$OBSIDIAN_VAULT”环境变量中： # 检查保管库位置回显$OBSIDIAN_VAULT # 应该返回如下内容： # /用户/用户名/文档/注释如果未设置，您需要在 shell 配置文件中配置它： # 添加到 ~/.zshrc 或 ~/.bashrc 导出 OBSIDIAN_VAULT="/path/to/your/vault" ## Vault 中的项目组织 ### 选择项目目录位置在 Obsidian 中创建新项目的注释时，询问用户项目目录应位于 Vault 中的哪个位置： **工作流程：** 1. **显示当前金库结构**以帮助用户决定 2. **提供两种选择：** * **选项 1：** 根级别 - 项目目录直接位于 Vault 根目录中 * **选项 2:** 自定义路径 - 用户指定子目录结构 3. **如果目录不存在则创建** ### 实现模式导入操作系统从 pathlib 导入路径 # 获取库路径 Vault_path = Path(os.environ.get('OBSIDIAN_VAULT')) # 向用户显示保管库结构 print("📁 当前金库结构：") 打印（f“{vault_path} /”） # 显示顶级目录（最多2级）对于已排序的项目（vault_path.iterdir（））：如果 item.is_dir() 而不是 item.name.startswith('.'): print(f" ├── {item.name}/") # 显示更深一层对于sorted(item.iterdir())[:3]中的子项：如果 subitem.is_dir() 而不是 subitem.name.startswith('.'): print(f" │ ├── {subitem.name}/") # 指出是否还有更多剩余 = len([x for x in item.iterdir() if x.is_dir()]) - 3 如果剩余> 0： print(f" │ └── ... ({剩余}更多)") 打印（） print("这个项目的笔记应该存储在哪里？") 打印（）打印（“选项：”） print(" 1.根级别 (vault/项目名称/)") print(" 2.自定义路径（例如，vault/Work/project-name/或vault/Projects/Active/project-name/）"）打印（） choice = input("输入选项[1-2]:") 如果选择==“1”： # 根级别项目目录 = 库路径 / 项目名称其他： # 自定义路径打印（） print("输入父目录路径（相对于库根目录）。") 打印（“示例：”） print(" - 工作") print(" - 项目/活动") print(" - 个人/研究") 打印（） parent_path = input("父目录：").strip() # 清理并验证路径父路径 = 父路径.strip('/') 项目目录 = 库路径 / 父路径 / 项目名称 # 如果目录不存在则创建 project_dir.mkdir（父母= True，exist_ok = True） print(f"✅ 项目目录: {project_dir.relative_to(vault_path)}") ### 组织最佳实践 **根级别：** * ✅ 快速访问常用项目 * ✅ 结构简单，适合小型金库 * ❌ 许多项目可能会变得混乱 **组织的子目录：** * ✅ 更好地组织许多项目 * ✅ 逻辑分组（工作、个人、研究等） * ✅ 在大型金库中更容易导航 * ✅ 更适合具有共享结构的团队金库 **推荐结构：** 保险库/ ├── 工作/ │ ├── 项目-a/ │ ├── 项目-b/ │ └── 项目-c/ ├── 个人/ │ ├── 爱好项目/ │ └── 研究/ ├── 档案/ │ └── 老项目/ └── 模板/ 或者按状态：保险库/ ├── 主动/ │ ├── 项目-a/ │ └── 项目-b/ ├── 策划/ │ └── 项目-c/ ├── 已完成/ │ └── 老项目/ └── 档案/ ### 目录创建安全 **创建前始终检查：** 如果project_dir.exists(): print(f"⚠️目录已存在：{project_dir}") overwrite = input("继续使用此目录？(y/n)：") 如果 overwrite.lower() != 'y': # 请求不同的名称或路径返回其他： # 与父母一起创作 project_dir.mkdir（父母= True，exist_ok = True） print(f"✅ 创建目录：{project_dir}") ### 存储项目配置保存项目目录路径以供将来的会话使用： # 在.claude/项目配置中 config_content = f"""obsidian_project={project_name} obsidian_path={project_dir.relative_to(vault_path)} ”“” 使用 open('.claude/project-config', 'w') 作为 f: f.write(配置内容) 这允许后续会话使用同一目录而无需再次询问。 ## 用户选择：永远不要假设注释的位置 **关键原则**：在 Obsidian 中创建任何注释时，始终询问用户希望将其保存在哪里。永远不要自己决定位置，即使它看起来很明显。 ### 为什么这很重要 1. **用户有你没有的上下文** \- 他们知道他们的保管库是如何组织的 2. **灵活性是关键** \- 不同的音符可能属于不同的地方 3. **避免重组工作** \- 用户以后不需要移动笔记 4. **尊重用户的系统** \- 他们的保管库组织是个人的 ### 任何笔记创建的工作流程 **第 1 步：显示当前结构** # 显示库结构以帮助用户决定 Vault_path = Path(os.environ.get('OBSIDIAN_VAULT')) print("📁 当前金库结构：") print(f" {vault_path.name}/") 对于已排序的项目（vault_path.iterdir（））[：10]：如果 item.is_dir() 而不是 item.name.startswith('.'): print(f" ├── {item.name}/") **第 2 步：提出选项建议（不要做出决定）** print("\n您想在哪里保存此便笺？") 打印（） print("建议：") print(" 1.根级别 - Notes/note-name.md") print(" 2. [特定文件夹] - Notes/Folder/note-name.md") print(" 3.自定义路径 - 您指定") 打印（） **第 3 步：获取用户输入** choice = input("输入选择或自定义路径：").strip() **第 4 步：在所选位置创建** # 使用他们的选择，不要覆盖它如果选择==“1”： note_path =Vault_path /“note-name.md” elif 选择==“2”： note_path =Vault_path /“文件夹”/“note-name.md” 其他： # 自定义路径 note_path =Vault_path / choice /“note-name.md” # 如果需要创建目录 note_path.parent.mkdir（父母= True，exist_ok = True） ### 何时询问的示例 ❌ **错误 - 假设位置：** # 创建文档注释 note_path =Vault_path /“指南”/“How-to.md”#不要这样做 ✅ **右 - 询问用户：** # 显示结构并提出建议 print("这个文档注释应该保存在哪里？") print("建议：") print(" 1. 根级别（简单）") print(" 2. 新的 'Guides' 文件夹（用于文档）") print(" 3.现有'工作'文件夹") print(" 4.自定义路径") choice = input("您的选择：") # 然后根据他们的输入创建 ### 例外：项目会议笔记唯一的例外是使用“/safe-exit”作为项目会话注释时： * 配置已存在于 `.claude/project-config` 中 * 用户之前已选择项目位置 * 该项目的所有会话笔记都位于同一位置即使如此，在第一次使用时，请务必询问并保存选择。 ### 总结 **黄金法则**：如果您要将文件写入黑曜石保险库，请停止并询问用户该文件应该首先写入哪里。 ### 成功模式示例 **会话**：创建图形分析 TODO 注释 **实施**： # 1.检查保管库位置回显$OBSIDIAN_VAULT # 2. 显示结构 ls -1 $OBSIDIAN_VAULT/ # 3.询问用户 “您希望我将用于图形分析任务的 TODO 注释保存在哪里？ **选项：** 1. curation-paper-figures/ - 与您的其他项目笔记一起（推荐） 2. curation-paper-figures/sessions-history/ - 包含会话历史记录 3.根级别-直接在Notes/中 4. 自定义路径-您指定你更喜欢哪个？” # 4. 用户响应：“1” # 5. 在选定的位置创建猫 >“$OBSIDIAN_VAULT/curation-paper-figures/Figure_Analysis_TODOs.md”<<'EOF' 【内容】 EOF **结果**：在用户的首选位置创建注释，无需稍后进行假设或重组。 **关键原则**：即使某个位置看起来“显而易见”，也要始终询问。用户比您更了解他们的组织系统。 ## Vault 重组工作流程重组大型黑曜石金库结构时，请遵循以下系统方法： ### 规划阶段 1. **提示文件中的文档目标结构** * 定义文件夹层次结构 * 指定命名约定（例如，“session-saves/”与“sessions-history/”） * 注意标准项目结构（TO-DOS.md、session-saves/、archived/daily/、archived/monthly/） 2. **创建待办事项列表**来跟踪进度 * 按主要操作细分：创建文件夹、移动文件、更新链接 * 系统地跟踪完成情况 ### 执行阶段按此顺序执行以尽量减少损坏的链接： 1. **先创建新的文件夹结构** mkdir -p Work/Brain-dump Work/Global-skills Work/Galaxy Work/VGP 2. **移动文件和文件夹** * 使用 `mv source/destination/` 移动完整目录 * 检查可能阻止 rmdir 的隐藏文件 (.DS_Store) * 使用 `rmdir` （不是 `rm -rf`）安全删除目录 - 如果不为空则失败 3. **标准化项目文件夹** * 重命名 `sessions-history/` → `session-saves/` 以保持一致性 * 创建 `archived/daily/` 和 `archived/monthly/` 子目录 * 从集中的 TODO 位置移动或创建“TO-DOS.md”文件 4. **更新 HOME.md 和 MOC 文件** * 系统地更新导航文件中的链接 * 一次处理一个文件 * 使用编辑工具进行精确的字符串匹配 5. **清理** * 删除旧的空文件夹 * 删除或重新定位孤立文件 * 使用“tree”或“find”命令验证结构 ### 链接更新策略更新多个文件的内部链接时： 1. **首先找到所有受影响的文件** grep -r“模式”vault/ --include =“*.md” 2. **编辑前阅读每个文件**（编辑工具要求） 3. **系统更新** \- 一次一个文件，完整完成每个文件 4. **删除已删除文件的链接**（如中央 Home.md） ### 常见模式 **标准项目结构：** 项目名称/ ├── TO-DOS.md ├── 会话保存/ ├── 已归档/ │ ├── 日常/ │ └── 每月/ └── [项目特定文件夹] **层级组织：** 工作/ ├── 第一类/ │ ├── HOME.md │ ├── TO-DOS.md │ └── 项目-a/ └── 类别2/ ├── HOME.md └── 项目-b/ ### 验证重组后： * 使用`tree -L 3 -d`来验证结构 * 检查链接在黑曜石中是否有效 * 验证已删除文件的链接是否已损坏 * 测试 HOME.md 文件之间的导航 ### 重组后批量链接更新在保管库重组后更新许多链接时： 1. **查找受影响的文件：** grep -r "\[\[OldPath"Vault/ --include="*.md" 2. **系统更新：** * 首先读取文件（编辑工具要求） * 一起更新该文件中的所有链接 * 在移至下一个文件之前先完成一个文件 * 在待办事项列表中标记为已完成 3. **更新模式：** # 旧的 [[旧文件夹/文件|显示]] # 新 [[工作/类别/旧文件夹/文件|显示]] 4. **删除过时的链接：** * 查找：`[[ObsoleteFile|...]]` 或 `[[ObsoleteFile]]` * 删除整个链接引用 * 清理周围的格式 ### Home.md 文件管理当使用节级 HOME.md 文件重新组织为分层结构时： **模式：用分区住宅取代中央住宅** **之前（集中）：** 保险库/ ├── Home.md（连接一切的中心枢纽） ├── 项目-1/ ├── 项目-2/ └── 项目-3/ **之后（分层）：** 保险库/ ├── 工作/ │ ├── 类别1/ │ │ ├── HOME.md（部分中心） │ │ └── 项目-1/ │ └── 类别2/ │ ├── HOME.md（部分中心） │ └── 项目-2/ └── 人/ ├── HOME.md（部分中心） └── 项目-3/ **过渡步骤：** 1. **首先创建 HOME.md 文件部分** * 每个主要类别一个（工作/类别-1/、工作/类别-2/、个人/等） * 每个都包含该部分项目的链接 * 包括部分之间的导航 2. **查找对中央主页的所有引用：** grep -r "\[\[Home"Vault/ --include="*.md" 3. **系统地更新或删除链接：** * MOC 文件：更新以链接到相应的主页部分 * 章节主页文件：链接到同级章节，而不是中央主页 * 项目说明：删除主页链接（改为通过“主页”部分导航） 4. **删除中央Home.md LAST：** * 仅在所有链接更新或删除后 * 验证没有损坏的参考 **HOME.md 模板部分：** --- 类型：莫克部分：部分名称标签： - 家 - 莫克 --- # 部分名称 ## 项目 - [[project-1/Project-1-MOC|项目 1]] - 描述 - [[project-2/Project-2-MOC|项目 2]] - 说明 ## 快速访问 - [[TO-DOS|待办事项]] - [[档案|存档作品]] ## 其他部分 - [[../其他部分/HOME|其他部分]] - [[../../Person/HOME|个人]] --- *[类别]的部分首页* **主目录文件的优点：** * 按类别逻辑组织 * 每个部分都是独立的 * 无需维护单一中央文件 * 更适合分层金库结构 * 更清晰的导航路径 ### HOME.md 命名约定 **模式：** 使用 `[section-name]_HOME.md` 而不是通用的 `HOME.md` **好处：** * 避免工作目录中有多个HOME文件时发生冲突 * 在文件浏览器中清晰识别 * 更适合搜索和导航 * 一致的命名模式 **示例：** 工作/Galaxy/Galaxy_HOME.md 工作/VGP/VGP_HOME.md 工作/全局技能/全局技能_HOME.md Perso/Person_HOME.md **重命名过程：** 1. **重命名文件：** mv 工作/Galaxy/HOME.md 工作/Galaxy/Galaxy_HOME.md mv 工作/VGP/HOME.md 工作/VGP/VGP_HOME.md ＃等 2. **更新参考文献：** # 查找所有旧名称的链接 grep -r "\[\[.*HOME\|"保险库/ --include="*.md" # 系统更新链接 # 旧：[[工作/银河/家庭|银河工作]] # 新：[[Work/Galaxy/Galaxy_HOME|Galaxy Work]] 3. **使用链接检测脚本进行验证**（请参阅链接管理部分） **何时使用通用`HOME.md`：** * 单节拱顶（无分段） * 仅限根级家庭 * 没有命名冲突 **何时使用`[name]_HOME.md`:** * 多节HOME文件（推荐） * 分层金库结构 * 同时跨多个项目工作 * 想要清晰的文件标识 ### Brain Dump 文件夹处理使用 Brain Dump 或临时暂存文件夹重新组织 Vault 时： **目的：** Brain dump 文件夹包含非结构化工作笔记，需要： 1. 审核有价值的内容 2. 搬迁至适当的永久地点 3. 存档或删除（如果过时） **典型地点：** 项目/档案/大脑转储/ 项目/大脑转储/ 工作/大脑转储/ **工作流程：** 1. **先回顾内容：** ls -lh 项目/档案/Brain-Dump/ # 检查文件大小和日期 # 读取摘要或关键文件 2. **对笔记进行分类：** * **永久价值：** 移动到适当的主题位置 * **会议笔记：** 整合和存档 * **过时/重复：** 删除 3. **移动有价值的内容：** # 示例：将 Galaxy 工作流程注释移至适当的项目 mv 工作/Brain-dump/VGP-Workflow-Notes.md 工作/Galaxy/ 4. **处理综合摘要：** * Summary.md 文件通常包含跨项目信息 * 移至最相关的项目或按主题拆分 * 移动时更新链接 5. **归档或删除文件夹：** # 大脑转储是否应该存档 mv 项目/Brain-dump/ 项目/档案/Brain-dump/ # 如果内容已全部处理并过时 rmdir Project/Brain-dump/ # 安全 - 如果不为空则失败 **反模式：** 不要在未经审查的情况下移动整个大脑转储文件夹 * 导致归档内容无组织 * 宝贵的见解被埋没 * 最好先提取并组织 **最佳实践：** * 在金库重组期间处理大脑转储内容 * 将摘要提取到主题笔记中 * 如果需要，存档单个会话 * 仅在积极使用大脑转储文件夹进行临时工作时才保留它 ## 会话笔记整合工作流程将每日会议笔记合并为主题参考笔记和项目 TODO 时： ### 目的通过以下方式将按时间顺序排列的会话历史记录转换为有组织的知识： * 创建按主题（而非日期）分组的主题参考注释 * 将可操作的任务提取到项目 TO-DOS.md 文件中 * 将处理过的会话笔记存档到存档/每日/ * 保存知识同时减少噪音 ### 何时整合 **触发器：** * 项目阶段或里程碑结束 * 会话文件夹有 5 个以上笔记 * 开始新工作并需要干净的环境 * 每月金库维护 * 在与他人分享项目之前 ### 规划阶段 1. **查看项目的 session-saves/ 文件夹中的所有会话注释** 2. **确定主要主题** \- 讨论了哪些主题？ * 示例：“数据收集”、“统计分析”、“图形生成” 3. **创建整合计划：** * 列出要创建的主题笔记 * 确定哪些会议对每个主题有贡献 * 记下要提取的任何 TODO ### 执行步骤按这个顺序执行： **1\.创建主题参考注释** 按主题而不是时间顺序对内容进行分组： --- 类型：参考项目：项目名称标签： - 主题标签 - 主题标签创建时间：YYYY-MM-DD 更新日期：YYYY-MM-DD 状态：已完成 |进行中 --- # 专题标题 **项目：** 项目名称 **期间：** 日期范围 **状态：** 当前状态 --- ## 概述该工作领域的高级摘要 --- ## 第 1 部分：副主题来自多个会议的内容组织得连贯 ### 关键决策 - 决定 1（来自会议 YYYY-MM-DD） - 决定 2（来自会议 YYYY-MM-DD） ### 实施从会议中合并的详细信息 --- ## 第 2 部分：另一个子主题【继续按主题整理】 --- ## 文件和位置记录相关文件和路径 --- ## 相关注释 - [[其他主题说明|相关主题]] - [[项目规划|规划文档]] --- *根据会话合并：YYYY-MM-DD、YYYY-MM-DD、YYYY-MM-DD* **2\.将 TODO 提取到项目 TO-DOS.md** 使用提取的任务创建或更新项目 TO-DOS.md： --- 类型：待办事项项目：项目名称状态：活跃 |已完成标签： - 待办事项 - 项目名称创建时间：YYYY-MM-DD 更新日期：YYYY-MM-DD --- # 项目名称 - TODO **最后更新时间：** YYYY-MM-DD --- ## 活动任务 ### 第 1 阶段：[阶段名称] - [ ] 从会话中提取的任务 1 - [ ] 会话中的任务 2 - [x] 任务 3（已完成） ### 第二阶段：[下一阶段] - [ ] 未来任务 --- ## 已完成（存档） ### [里程碑名称]（已完成 YYYY-MM-DD） - [x] 已完成任务 1 - [x] 已完成任务 2 --- ## 相关注释 - [[专题注释1|参考]] - [[项目规划|规划文档]] --- *摘自 YYYY-MM-DD 合并的会议记录* **3\.存档会议记录** 将已处理的会话移至 archived/daily/: # 移动所有已处理的会话笔记 mv 项目/session-saves/*.md 项目/archived/daily/ # 或者有选择地移动 mv 项目/session-saves/2026-02-*.md 项目/存档/每日/ **4\.验证完整性** 检查： * 主题笔记中捕获的所有重要内容 * 所有可操作的任务提取到 TO-DOS.md * 会议笔记已成功存档 * 主题笔记组织良好且易于导航 ### 内容组织策略 **按主题而不是时间顺序组织：** ❌ **错误 - 按时间顺序：** # 会话整合 ##一月工作 - 2026-01-15 做了 X 吗 - 是在 2026-01-20 做的吗 ##二月工作 - Z 于 2026-02-01 做吗 ✅ **右 - 主题：** # 数据收集和丰富 ## 第一阶段：端粒分类 (2026-01-24) [所有端粒工作组合在一起] ## 第 2 阶段：附加指标 (2026-01-27) [所有指标都组合在一起] ### 合并示例 **之前（9节笔记）：** 会话保存/ ├── 2026-01-27.md - 统计测试 ├── 2026-01-30.md - 图生成 ├── 2026-02-04.md - MANIFEST系统 ├── 2026-02-05.md - 更多数字 ├── 2026-02-06.md - 数据修正 ├── 2026-02-10.md - 分析文件 ├── 2026-02-12.md - 笔记本工作 ├── 2026-02-15.md - 图形改进 ├── 2026-02-16.md - 质量检查 **之后（5 个主题说明 + 1 个 TODO）：** 数据收集和丰富.md 统计分析结果.md 数据质量和更正.md 图生成.md 基础设施和工作流程.md TO-DOS.md 存档/每日/ ├── 2026-01-27.md ├── 2026-01-30.md ├── [...所有9场会议已存档] ### 主题说明示例 **良好的主题分组：** *“数据收集和充实”（不是“一月数据工作”） *“统计分析结果”（不是“分析会议”） *“图形生成”（不是“可视化工作日志”） *“基础设施和工作流程”（不是“工具开发笔记”） *“数据质量和更正”（不是“错误修复”） ### 要包含的内容 **在主题注释中：** * 关键决策和理由 * 实施细节 * 结果和发现 * 经验教训 * 文件位置和代码参考 * 相关注释和交叉引用 * 时间线注释：“会议合并：[日期]” **在 TO-DOS.md 中：** * 可行的后续步骤 * 已被阻止的项目，并注明了阻止者 * 已完成的任务（在存档部分） * 阶段组织 * 相关笔记链接 **不包括：** * 每分钟的会议详细信息 * 调试步骤（除非他们教了一些东西） * 临时工作笔记 * 冗余上下文 ### 文件命名 **主题注释 - 描述性、永恒：** * `数据收集和丰富.md` * `统计分析结果.md` * `图形生成-工作流程.md` * `基础设施和工具.md` **不基于日期：** * ❌`2026-01-Session-Summary.md` * ❌`一月工作综合.md` * ❌ `Week-3-Notes.md` ### 验证清单合并后： * 所有主题注释都有适当的前言，类型为：参考 * 每一篇主题说明都集中于一个主题领域 * TO-DOS.md 存在并包含提取的任务 * 所有会议记录均移至存档/每日/ * 主题注释可导航（良好的标题、部分） * 相关注释已交叉链接 * 记录时间线（“会议合并：...”） * 没有丢失关键信息 ### 与其他工作流程集成 **合并后：** 1. 更新项目 HOME.md 以链接到新的主题说明 2. 更新项目 MOC（如果存在） 3. 在相关的情况下将主题注释相互链接 4. 如果发现新模式，请考虑更新技能 **项目分享之前：** * 首先巩固会话 * 分享主题笔记，而不是会议历史记录 * 包括活跃项目的 TO-DOS.md * 可以排除存档文件夹以实现更清晰的共享 ## 链接管理和验证在主要的金库重组之后，系统地验证并修复所有内部维基链接。 ### 自动断开链接检测使用 Python 脚本扫描整个保管库以查找损坏的 wiki 链接：进口再从 pathlib 导入路径 Vault_root = 路径(“/path/to/vault”) 损坏的链接 = [] wikilink_pattern = r'\[\[([^\]|]+)(?:\|[^\]]+)?\]\]' 对于Vault_root.glob（“**/*.md”）中的md_file：打开（md_file，'r'，编码='utf-8'）作为f：内容 = f.read() 匹配 = re.findall(wikilink_pattern, 内容) 对于匹配中的链接：链接 = link.strip() # 跳过仅标题引用如果链接中有“#”：链接 = link.split('#')[0].strip() 如果没有链接：继续 # 尝试vault-root路径，然后是相对路径目标=Vault_root / f“{link}.md” 如果不是 target.exists(): 目标= md_file.parent / f“{link}.md” 如果不是 target.exists(): 损坏的链接.append({ '文件': str(md_file.relative_to(vault_root)), '链接'：链接 }) # 按文件分组的报告当前文件=无对于broken_links中的项目： if item['file'] != current_file: 当前文件 = 项目['文件'] print(f"\n{当前文件}:") 打印(f" - [[{item['link']}]]") ### 系统修复工作流程 **1\.按部分分类** * 按保管库区域对断开的链接进行分组（工作/、个人/等） * 使用 TodoWrite 工具跟踪进度 * 一次修复一个部分直至完成 **2\.重组后的常见链接问题** 问题 |示例|修复 ---|---|--- 文件夹已移动 | `[[Galaxy/VGP/文件]]` | `[[工作/Galaxy/文件]]` 文件重命名 | `[[主页]]` | `[[项目主目录]]` 带斜杠的文件夹链接 | `[[会话保存/]]` |删除链接（无文件）相对与绝对| `[[策展论文人物/文件]]` | `[[工作/VGP/curation-paper-figures/file]]` 综合会议 | `[[2026-01-27_session]]` | `[[主题说明]]` 集中删除 | `[[TODO/Master-TODO]]` | `[[工作/项目/TO-DOS]]` **3\.链接更新模式** **旧路径结构→新结构：** #重组前 [[TODO/项目-TODO]] [[Galaxy/VGP/规划/手记]] [[会话保存/2026-02-13]] #重组后 [[工作/项目/待办事项]] [[工作/VGP/curation-paper-figures/Thematic-Note]] [[工作/银河/iwc/存档/每日/2026-02-13]] **删除过时的链接：** * 开发会议链接 → 专题参考说明 * 文件夹引用（尾随 /）→ 删除或链接到索引 * 不存在的 TODO 索引 → 单个项目 TO-DOS **4\.修复后验证** 再次运行检测脚本来验证： # 应该输出 ✅ 成功！没有发现损坏的链接。所有链接均已修复。 ### 最佳实践 **做：** * 在开始修复之前运行检测脚本（基线计数） * 按部分系统修复（先完成一个区域，然后再完成下一个区域） * 使用待办事项跟踪进度（防止在大型修复中丢失位置） * 在每个部分之后重新运行检测（及早发现任何问题） * 使用保管库根的完整路径以保持一致性 **不要：** * 尝试一次修复所有 70 多个链接（难以承受，容易出错） * 跳过各部分之间的验证（复合错误） * 猜测链接目标（始终验证文件存在） * 保留带有斜杠的文件夹引用 ### 代币效率 **损坏链接检测：** 每次运行约 100 个令牌 **手动链接检查：** 每个文件 500-1000 个令牌（读取 + 验证） **影响：** 对于 15 个文件中有 74 个损坏链接的保管库： * 检测脚本：100个token * 人工检查为：7,500-15,000 代币 * **节省：代币减少 98-99%** ### 常见场景 **会话巩固后：** * 旧：`[[会话历史记录/2026-02-16]]` * 新内容：`[[主题注释]]`（内容现在位于主题参考中） **文件夹重组后：** * 旧：`[[Galaxy/VGP/数据/文件]]` * 新：`[[工作/VGP/curation-paper-figures/Data-Collection-Note]]` **HOME.md 重命名后：** * 旧：`[[工作/银河/家庭|银河]]` * 新：`[[工作/Galaxy/Galaxy_HOME|Galaxy]]` ### 与其他工作流程集成 **在以下时间后运行链接验证：** * 主要金库重组 * 会议记录合并 * 文件/文件夹重命名 * 创建新的 HOME.md 文件部分 * 删除过时的文件夹 **之前：** * 共享项目（共享包中没有损坏的链接） * 主要写作课程（干净的导航） * 项目交接 ## 黑曜石 Markdown 语法 ### 维基链接（内部链接） # 链接到另一个笔记 [[注释名称]] # 与自定义显示文本的链接 [[注释名称|显示文本]] # 链接到另一个笔记中的标题 [[注释名称#标题]] # 链接到块 [[笔记名称#^区块id]] ### 标签 # 简单标签 #标签 # 分层标签 #项目/功能 #状态/进行中 #类型/注释 #类型/任务 # YAML frontmatter 中的标签 --- 标签： - 项目/功能 - 状态/活动 --- ### 任务 # 基本任务 - [ ] 要做的任务 # 已完成任务 - [x] 已完成的任务 # 优先任务 - [ ] 高优先级任务⚠️ - [ ] 中等优先级任务🔸 - [ ] 低优先级任务🔹 # 带有日期的任务（如果使用黑曜石任务插件） - [ ] 任务📅2026-01-23 - [ ] 任务 ⏳ 2026-01-30 - [ ] 任务✅ 2026-01-20 # 带有元数据的任务 - [ ] 实现功能 #coding #high-priority @claude-session ### 标注（特定于黑曜石） > [!注意] > 这是注释标注 > [!提示] > 有用的提示在这里 > [!警告] > 重要警告 > [!todo] > 待完成的任务 > [!示例] > 示例代码或内容 > [!引用] > 引用或引用 ## 笔记模板 ### 会议笔记模板 --- 类型：会话项目：{{项目名称}} 日期：{{日期}} 标签： - 会话 - 转储 - {{主题标签}} 状态：已完成 |进行中 --- # 会议：{{主题}} - {{日期}} ## 上下文我们正在做什么以及为什么 ## 总结本届会议的要点和成果 ## 决定 - 决定1 - 决定2 ## 行动项目 - [ ] 任务 1 - [ ] 任务 2 ## 链接 - [[相关注释1]] - [[相关注释2]] ## 代码参考 - `file.py:123` - 代码位置描述 --- **会议**：克劳德 **持续时间**：{{持续时间}} ### 技术说明模板 --- 日期：{{日期}} 类型：技术说明标签： - 技术性的 - {{主题}} --- # {{标题}} ## 问题问题或主题的描述 ## 解决方案如何解决或实施 ## 实施细节 ``语言代码示例 ## 相关概念 * [[概念1]] * [[概念2]] ## 参考文献 * 外部链接或文档 ## 注释其他想法或考虑因素 ### 任务注释模板 ``降价 --- 日期：{{日期}} 类型：任务标签： - 任务 - 状态/待定项目：{{项目名称}} --- # 任务：{{任务名称}} ## 说明需要做什么 ## 要求 - 要求1 - 要求2 ## 清单 - [ ] 步骤 1 - [ ] 步骤 2 - [ ] 步骤 3 ## 依赖关系 - [[相关任务1]] - [[相关任务2]] ## 注释其他背景或注意事项 ## 完成 **状态**：待定 **优先级**：中 **到期**：{{日期}} ### 分析计划笔记模板对于稍后需要实施的复杂分析： --- 类型：分析规划状态：计划中优先级：中标签： - 分析 - 规划创建时间：{{日期}} --- # 分析：[标题] ## 上下文 [我们想回答什么问题？是什么引发了这个分析想法？] ## 可用数据 - **数据集 1**：[名称、位置、大小、关键字段] - **数据集 2**：[名称、位置、大小、关键字段] - **相关输出**：[现有图形、表格或分析] ## 分析选项 ### 选项 1：[描述性名称] **方法**：[简要说明] **优点**： - [优点1] - [优点2] **缺点**： - [挑战1] - [挑战2] **预计工作量**：[小时/天] ### 选项 2：[描述性名称] **方法**：[简要说明] **优点**： - [优点1] **缺点**： - [挑战1] **预计工作量**：[小时/天] ### 选项 3：[描述性名称] [继续模式...] ## 推荐方法 [采取哪种选择以及为什么] ## 实施注意事项 ````蟒蛇 # 关键代码模式或伪代码 # 分析的示例结构 ## 后续步骤 1.【具体行动1】 2.【具体行动2】 3.【生成图/表】 ## 相关文件 * [[相关分析]] * `path/to/relevant/script.py` * `path/to/dataset.csv` ## 状态更新 **{{date}}** ：创建计划说明 ## 实用组织模式（来自真实会议） ### 模式 1：家庭 MOC 作为中心枢纽 **实现示例**： ``降价 --- 类型：莫克标题：首页标签： [索引、首页] 创建时间：YYYY-MM-DD --- # 🏠 首页 **最后更新时间：** YYYY-MM-DD ## 🎯 活跃项目 ### 项目 1 **状态：** 进行中 | **优先级：** 高 - [[Project-1/规划/主规划|规划文件]] - [[项目-1/分析/分析计划|分析计划]] ### 项目 2 **状态：** 活跃 | **优先级：** 中 - [[Project-2/开发/最新会议|最新工作]] ## 📋 快速访问 ### TODO 和规划 - [[TODO/Master-TODO-Index|📋 所有 TODO]] - [[TODOs/Project-1-TODOs|项目 1 任务]] ### 最近的会议 - [[项目-1/会议/YYYY-MM-DD|今天]] - [[项目-1/会议/YYYY-MM-DD|昨天]] ## 📚 主题知识 ### 主题区域 1 **核心文件：** - [[路径/到/Core-Doc-1|核心文档]] - [[路径/至/Core-Doc-2|辅助文档]] **相关工作：** - [[路径/至/相关-1|相关项目 1]] ## 🗂️ 按笔记类型浏览 ### 📝 规划与策略 - [[路径/前往/规划-1]] - [[路径/前往/规划-2]] ### 💻 开发与实施 - [[路径/到/Dev-1]] ### 📚 参考和指南 - [[路径/至/Guide-1]] ### ✅ TODO 和任务管理 - [[TODO/主 TODO 索引]] ### 📦 档案 - [[档案/旧会议/摘要]] ## 🔗 跨项目连接 ### 相关项目 - **项目 A** ↔ **项目 B** - 共享分析工作 - 链接跨越多个项目文件夹 ## 📊 项目状态概览 |项目|状态 |优先|待办事项 |更新 | |--------|--------|----------|--------|---------| |项目1 |进行中 |高| [[TODOs/Project-1-TODOs|查看]] |年-月-日 | |项目2 |活跃|中等| [[TODOs/Project-2-TODOs|查看]] |年-月-日 | ## 🎯 快速行动 **最常见的任务：** - 回顾 [[TODOs/Master-TODO-Index|活跃 TODOs]] - 检查 [[Project-1/Planning/Main-Plan|Planning docs]] - 更新[[路径/至/状态-文档|状态]] **每周回顾：** - 更新本说明中的项目状态 - 存档旧的会议笔记 - 整合TODO - 本周发现的链接相关笔记 **好处：** * 整个金库的单一入口点 *带有表情符号的视觉层次结构 * 表格中的状态跟踪 * 常见工作流程的快速操作 * 每周回顾清单 ### 模式 2：项目 MOC **实施示例**： --- 类型：莫克项目：项目名称状态：活跃标签： - 项目名称 - 莫克优先级：高创建时间：YYYY-MM-DD 更新日期：YYYY-MM-DD --- # 🌌 项目名称 MOC *项目名称内容地图* **最后更新时间：** YYYY-MM-DD **状态：** 进行中 --- ## 📝 规划与策略 ### 核心规划文件 - [[项目/规划/主要计划|主要计划]] - **关键** - 关键决策1 - 关键决定2 - 状态：进行中 - [[项目/计划/待办事项|任务列表]] - **高优先级** - 活动任务 - 被阻止的项目 --- ## 💻 发展 ### 最近的工作（YYYY 月） - [[项目/开发/YYYY-MM-DD_topic-1|主题 1]]（日期 1） - [[项目/开发/YYYY-MM-DD_topic-2|主题 2]]（日期 2） ### 当前会话 - [[项目/会议/YYYY-MM-DD|今天]] - [[项目/会议/YYYY-MM-DD|昨天]] --- ## 📋 TODO 和任务 - [[TODOs/Project-TODOs|活动任务]] - 提取的任务列表 ### 关键任务 - [ ] 任务 1 - 高优先级 - [ ] 任务 2 - 中优先级 - [x] 任务 3 - 已完成 --- ## 🔗 相关项目 - [[其他项目/其他项目-MOC|其他项目]] - 相关工作 - 交叉引用和共享分析 --- ## 🎯 快速行动 **常见任务：** - 审查 [[项目/规划/主要规划|规划文档]] - 检查[[TODOs/Project-TODOs|活动任务]] - 更新[[项目/状态|状态]] **每周回顾：** - 存档已完成的课程 - 更新TODO状态 - 将新笔记链接到此 MOC --- [[首页|← 返回首页]] **MOC 特点：** * 每个部分的条目数不超过 25 个 * 当部分变大时使用子 MOC * 包括状态和优先级 * 为常用工作流程添加“快速操作” * 链接回到主页 ### 模式 3：实践中的属性 **添加到所有注释：** --- 类型：规划 |参考|待办事项 |莫克 |发展|会议项目：项目名称子项目：可选子项目状态：活跃 |进行中 |已完成 |已归档标签： - 相关标签1 - 相关标签2 - dump # 添加到所有会话/每日笔记以便于过滤优先级：关键 |高|中等|低创建时间：YYYY-MM-DD 更新日期：YYYY-MM-DD --- **实际使用：** # 查找所有高优先级的计划笔记 # 在黑曜石搜索中：优先级：高类型：计划 # 查找所有活跃的 TODO # 在黑曜石搜索中：输入：todo status: active # 查找项目的所有笔记 # 在黑曜石搜索中：项目：项目名称 # 查找所有已完成的工作 # 在黑曜石搜索中：状态：已完成 # 查找所有会话/每日笔记（用于存档） # 在黑曜石搜索中：tag:#dump # 查找特定项目的所有会话笔记 # 在黑曜石搜索中：标签：#dump 项目：curation-paper ### 模式 4：TODO 整合 **创建中央 TODO 目录：** TODO/ ├── Master-TODO-Index.md # 中心索引 ├── Project-1-TODOs.md # 项目特定 ├── 项目-2-TODOs.md └── 存档/ # 已完成的 TODO **主指数结构：** --- 类型：待办事项项目：全部状态：活跃标签：[todo、索引、master] 优先级：高创建时间：YYYY-MM-DD 更新日期：YYYY-MM-DD --- # 掌握 TODO 索引 ## 🧬 项目 1 **状态：** 进行中 | **优先级：** 高 [[TODO/项目-1-TODO|项目 1 TODO]] **关键任务：** - 任务1 - 任务2 **相关项目：** - [[TODOs/项目-2-TODOs|项目 2]] ## 快速导航 ### 按项目区域 - [[TODOs/项目-1-TODOs|项目 1]] - [[TODOs/项目-2-TODOs|项目 2]] ### 按来源位置 - [[项目 1/规划/主规划|项目 1 规划]] - [[项目 2/分析/分析-计划|项目 2 分析]] **项目特定的待办事项：** --- 类型：待办事项项目：项目-1 状态：进行中标签：[项目-1，待办事项] 优先级：高创建时间：YYYY-MM-DD 更新日期：YYYY-MM-DD --- # 项目 1 - TODO **来源：** [[项目 1/规划/主规划|主规划文件]] ## 活跃的 TODO ### 第 1 类 - [ ] 任务 1 #priority/high #due/YYYY-MM-DD - [ ] 任务 2 #优先级/中 ## 已完成 - [x] 任务 3 - 已完成 YYYY-MM-DD ## 相关注释 - [[项目 1/规划/主规划|规划]] - [[项目-1/分析/分析计划|分析]] --- **链接回：** [[TODOs/Master-TODO-Index|Master Index]] ### 模式 5：存档策略 **每个项目档案：** 项目/ ├── 策划/ ├── 开发/ ├── Sessions/ # 活跃会话数 └── 档案/ └── Brain-Dump/ # 旧的非结构化笔记 ├── YYYY-MM-DD.md └── 摘要.md **存档规则：** 1. **没有从当前工作到存档笔记的链接** * 档案仅供历史参考 * 不要创建对旧笔记的依赖 2. **30 天后存档**以获取会议记录 3. **在归档之前创建归档摘要** * 提取关键决策 * 链接到信息移动的位置 * 摘要保持可访问性 4. **大容量项目的每月存档文件夹**：档案/ ├── 2026-01/ ├── 2026-02/ └── README.md # 解释存档的内容以及原因 ### 模式 6：跨项目链接 **当项目共享工作时：** # 在项目 A 中注释： ## 项目 B 中的相关工作 - [[项目-B/规划/共享-分析|共享分析]] - 详细的统计工作 - [[Project-B/Development/YYYY-MM-DD_implementation|Implementation]] - 它是如何构建的 ## 另请参阅 - [[Project-B/Project-B-MOC|Project B MOC]] - 完整上下文 # 在项目 B 中注释： ## 项目A的相关要求 - [[项目-A/规划/要求|要求]] - 需要分析什么 - [[Project-A/Data/Dataset|Dataset]] - 源数据 ## 跨项目上下文项目A工作提供需求，项目B实施分析。 **好处：** * 清晰的关系文档 * 双向导航 * 上下文在两个位置都保留 ### 模式 7：项目内基于主题的文件夹 **结构：** 项目/ ├── Tools/ #主题：工具开发 │ ├── 工具-1.md │ └── 工具-2.md ├── Planning/ # 主题：规划文档 │ └── 主计划.md ├── 分析/#主题：分析工作 │ └── 分析计划.md ├── 图/#主题：可视化 │ └── 图1.md └── 档案/#主题：历史 └── 旧场/ **好处：** * 清晰的主题分离 * 易于导航 * 逻辑分组 * 最多 2-3 层深度 ### 实施清单设置新保管库或重组时： **立即（高影响）：** * 创建“Home.md”中央导航中心 * 为所有现有笔记添加属性 * 将 README 转换为具有属性的 MOC **短期（本周）：** * 实施一致的标记策略 * 创建每周回顾模板 * 建立TODO合并结构 **长期（根据需要）：** * 考虑展平较深的文件夹 * 设置数据视图查询（如果使用插件） * 实施每月档案轮换 ## 与 Claude 一起工作：常见模式 ### 模式 1：创建会话笔记与克劳德开始工作时： # 在黑曜石保险库中创建新的会话记录 cat > "$OBSIDIAN_VAULT/Sessions/$(date +%Y-%m-%d)-session.md" <> "$OBSIDIAN_VAULT/Daily/$(日期 +%Y-%m-%d).md" ### 模式 3：从 Claude Session 创建任务 # 创建任务文件 TASK_NAME =“实施功能x” 猫 >“$OBSIDIAN_VAULT/Tasks/$TASK_NAME.md”<“$OBSIDIAN_VAULT/Solutions/$SOLUTION_NAME.md”<“$文件”<“$文件”<“$daily_note”<>“$daily_note”<> ~/.zshrc 源~/.zshrc ### 问题 2：注释未出现在黑曜石中 **问题**：文件已创建但不可见 **解决方案**： * 确保文件具有“.md”扩展名 * 检查文件权限 * 验证路径是否在库内 * 刷新黑曜石文件列表 ### 问题 3：链接不起作用 **问题**：维基链接无法正确导航 **解决方案**： * 确保音符名称准确匹配（区分大小写） * 检查链接中的文件扩展名（不应包含“.md”） * 验证链接笔记是否存在 * 使用 Obsidian 的链接自动完成功能 ### 问题 4：预览中的 Frontmatter 渲染 **问题**：YAML frontmatter 显示为文本 **解决方案**： * 确保 frontmatter 是文件中的第一件事 * 使用正确的 YAML 语法（前后三个破折号） * 检查尾随空格 ### 问题 5：环境变量不匹配 **症状**：`TypeError：预期的 str、bytes 或 os.PathLike 对象，而不是 NoneType` **原因**：文档使用与用户环境不同的变量名称 **诊断步骤**： # 检查实际设置了哪个变量回显$OBSIDIAN_VAULT 回显$OBSIDIAN_CLAUDE 回显 $OBSIDIAN_PATH # 列出所有与黑曜石相关的变量环境| grep -i 黑曜石 **常用变量名称**： * `$OBSIDIAN_VAULT`（推荐标准） * `$OBSIDIAN_CLAUDE`（旧文档） * `$OBSIDIAN_PATH` （替代） **分辨率**： 1.询问用户他们使用哪个变量 2. 系统更新所有参考文献： # 查找所有引用 grep -r "OBSIDIAN_CLAUDE" $CLAUDE_METADATA/技能/黑曜石/ grep -r "OBSIDIAN_CLAUDE" $CLAUDE_METADATA/.claude/commands/safe-exit.md # 对每个文件使用带有replace_all=true 的编辑工具 3. 记录更改： ## 环境变量更新从“$OBSIDIAN_CLAUDE”更新→“$OBSIDIAN_VAULT” - 修改的文件：safe-exit.md（7 条参考文献）、obsidian/SKILL.md（21 条参考文献） - 已验证：0 剩余旧参考文献 **预防**：创建新集成时，首先检查用户环境： # 检测哪个变量存在如果[-n“$OBSIDIAN_VAULT”];那么 VAULT_VAR="OBSIDIAN_VAULT" elif [ -n "$OBSIDIAN_CLAUDE" ];那么 VAULT_VAR="OBSIDIAN_CLAUDE" 否则 echo“错误：没有设置黑曜石金库变量” 菲 ## 快速参考 ### 与 Claude 一起创建笔记 # 会话笔记 cat > "$OBSIDIAN_VAULT/Sessions/$(date +%Y-%m-%d)-topic.md" <<'EOF' --- 日期：2026-01-23 类型：会议记录标签： [克劳德会话] --- # 内容在这里 EOF # 任务注释 cat > "$OBSIDIAN_VAULT/Tasks/task-name.md" <<'EOF' --- 日期：2026-01-23 类型：任务标签：[任务、状态/待处理] --- # 任务：任务名称 - [ ] 步骤 1 EOF # 快速追加到每日回声“##注意内容”>>“$OBSIDIAN_VAULT/Daily/$(日期+%Y-%m-%d).md” ### 基本黑曜石语法 # 维基链接 [[注释名称]] [[注释#标题]] [[注意|显示文字]] # 标签 #标签 #分层/标签 # 任务 - [ ] 待定 - [x] 完成 # 标注 > [!注意] > 内容 # 块引用 ^区块ID [[注#^区块ID]] ## 与其他技能的整合该技能适用于： * **文件夹组织** \- Vault 结构标准 * **管理环境** \- 开发工作流程 * **claude-协作** \- 团队知识共享 ## 参考资料和资源 * [黑曜石文档]() * [黑曜石社区插件]() * [Zettelkasten方法]() * [PARA 方法]() \- 项目、领域、资源、档案 ** ** **记住**：目标是建立一个可搜索的、链接的知识库，该知识库随着每次 Claude 会话的增长而增长。从简单开始，根据需要添加结构。 ## 变更日志 ### 版本 2.0.0 (2026-02-17) **重大更新**：添加了全面的 2025-2026 最佳实践和实用组织模式 **添加新部分：** 1. **黑曜石最佳实践（2025-2026）** * 从简单开始，不要想太多——避免富有成效的拖延 * 在深层文件夹上使用 MOC（内容地图） * 利用属性/元数据而不是仅文件夹组织 * 实际使用你的笔记 - 审查系统和主动管理 * 按笔记类型而非主题组织 * 创建一个主页/索引 MOC 作为中央导航中心 * 大量链接，最少文件夹 2. **实用的组织模式（来自真实会议）** * 模式 1：家庭 MOC 作为中心枢纽（完整示例） * 模式 2：包含 25 个项目部分的项目 MOC * 模式 3：带有搜索示例的属性实践 * 模式 4：TODO 与主索引合并 * 模式 5：无链接策略的存档策略 * 模式 6：共享工作的跨项目链接 * 模式 7：项目内基于主题的文件夹 3. **实施清单** * 立即采取行动（高影响、低努力） * 短期改进 * 长远考虑 **主要补充：** * MOC 最佳实践：保持在 25 个项目以下，在“精神挤压点”创建 * 属性模式：类型、项目、状态、标签、优先级、创建、更新 * Home.md 模式，带有表情符号、快速操作和状态表 * 存档规则：没有存档笔记的链接，30 天政策 * 强调实际使用笔记而不是无休止地组织 * 警告不要拖延（80/20 规则） **来自社区的最佳实践：** * 基于2025-2026年黑曜石社区共识 * 包括金库组织的现代方法 * 注重可持续性和实际使用模式 * 强调简单性和自然演化 **版本说明**：此更新使该技能符合当前的 Obsidian 最佳实践，并包括 2026 年在生产库中测试的真实模式。 ### 版本 2.0.1 (2026-02-17) **次要更新**：为会话/每日笔记添加了“dump”标签推荐 **变化：** * 在会话笔记模板中添加了“dump”标签 * 更新了属性用法，为所有会话/每日笔记推荐“dump”标签 * 添加了通过转储标签过滤会话笔记的搜索示例 * 更新了模式 3（实践中的属性）以显示转储标签的使用情况 **理由：** * 使会话笔记易于过滤：`tag:#dump` * 简化归档工作流程：查找所有转储、审查、归档 * 所有项目的一致标记 * 帮助将活动工作与会话历史记录分开 **用途：** --- 标签： - 会话 - 转储 - 其他标签 --- 搜索示例： * 所有会话注释：`tag:#dump` * 项目特定会话：`tag:#dump project: 项目名称` * 最近的会话： `tag:#dump` \+ 按日期排序 ### 版本 2.0.2 (2026-02-17) **主要更新**：添加了保管库重组和会话整合工作流程 **添加新部分：** 1. **会议笔记整合工作流程**（约 300 行） * 将每日会议笔记合并为主题参考笔记的完整指南 * 按主题（而非时间顺序）组织：“数据收集”而不是“一月工作” * 提取 TODO 到项目 TO-DOS.md 文件 * 将已处理的会话存档到存档/每日/ * 主题说明和 TODO 文件模板 * 真实示例：9 个会话 → 5 个主题说明 + 1 个 TODO 文件 * 验证清单以及与其他工作流程的集成 2. **Home.md文件管理**（~90行） * 从中央 Home.md 转换到节级 HOME.md 文件的模式 * 层次结构：Work/Category-1/HOME.md、Work/Category-2/HOME.md、Perso/HOME.md * 查找和更新所有主页参考的分步过程 * 带有横截面导航的 HOME.md 部分模板 * 优点：逻辑组织、独立的部分、更清晰的导航 3. **大脑转储文件夹处理**（约 60 行） * 重组期间处理临时/临时文件夹的工作流程 * 回顾 → 分类 → 移动 → 归档模式 * 处理具有跨项目内容的Summary.md文件 * 反模式：未经审查请勿移动整个文件夹 * 最佳实践：提取摘要、按主题组织、使用 rmdir 确保安全 **制定的关键原则：** **会话巩固：** * 按主题而非日期组织 * 主题注释具有描述性、永恒的名称（不是“2026-01-Summary”） * 来自 curation-paper-figures 项目的真实示例 * 验证清单确保信息不丢失 **家庭文件管理：** * 在删除中央主页之前先创建部分 HOM * 系统地更新所有参考文献 * HOME 文件部分提供本地导航中心 * 更适合分层金库结构 **大脑转储处理：** * 搬家前查看内容 * 从主题笔记中提取有价值的见解 * 适当存档或删除 * 不要将知识埋藏在未经审查的档案中 **整合：** * 所有工作流程协同工作以完成保管库重组 * 项目分享前的会议巩固 * 重组期间的大脑转储处理 * 分层结构的 Home.md 转换 **提供的模板：** * 主题参考笔记模板（带 frontmatter） * 项目 TO-DOS.md 模板 * HOME.md 模板部分 **现实世界的例子：** * 巩固：9 节课 → 5 个主题 + 1 个 TODO * 专题分组：“数据收集与丰富”、“统计分析结果” * 文件命名：描述性主题，而不是日期 **版本说明**：这些工作流程是在实际的库重组工作中开发和测试的，记录了用于维护有组织、可导航的知识库的经过验证的模式。 ### 版本 2.0.3 (2026-02-17) **主要更新**：添加了链接管理和 HOME.md 命名模式 **添加新部分：** 1. **链接管理和验证**（约150行） * 整个金库的自动损坏链接检测脚本 * 按部分分类的系统修复工作流程 * 重组后的常见链接问题（附示例的表格） * 移动文件夹、重命名文件、合并会话的链接更新模式 * 最佳实践：系统修复、经常验证、使用 TodoWrite * 代币效率：与手动验证相比降低 98-99% * 真实示例：40 分钟内修复了 15 个文件中的 74 个损坏链接 * 与其他工作流程集成（合并、重组、共享） 2. **HOME.md 命名约定**（约 50 行） * 模式：使用 `[section-name]_HOME.md` 而不是通用的 `HOME.md` * 好处：避免冲突、标识清晰、更好的导航 * 使用bash命令重命名进程 * 何时使用通用文件与命名 HOME 文件 * 示例：Galaxy_HOME.md、VGP_HOME.md、Global-skills_HOME.md **关键原则：** **链接管理：** * 与手动检查相比，自动检测可节省 98-99% 的令牌 * 按部分系统修复（防止不堪重负） * 使用TodoWrite跟踪进度 * 在每个部分之后进行验证（及早发现错误） * 实际影响：修复了 74 个链接，约 100 个代币 vs 7,500-15,000 个手动 **主页命名：** * 防止工作目录中的多个 HOME 文件发生混淆 * 分层金库结构的清晰模式 * 使用 grep 系统地更新所有参考文献 **提供的模板：** * 用于检测损坏链接的Python脚本 * 用于重命名 HOME 文件的 Bash 命令 * 用于查找参考文献的 Grep 命令 **实际应用：** * 链接验证：保险库重组后有 74 个损坏的链接 * HOME 命名：应用于分层库中的 4 个部分 HOME 文件 * 两种模式均在制作库中经过超过 35 个音符的测试 **版本说明**：这些模式解决了主要金库重组后的常见问题，提供自动检测和系统修复方法，可节省大量时间和代币。

黑曜石

包含技能