知识库目录规范与创作指南

本卡片记录知识库的目录设计规范，以及如何在网页端（Obsidian/Ignis）自主创建、格式化并归档新知识卡片的标准操作。

---

一、 知识库目录结构设计

知识库存储在本地 /root/HermesAgent/wiki/，各子目录作用明确：

• concepts/ (概念)：存放原理、算法、操作规程或逻辑框架（文件名一律使用中文命名）。
• entities/ (实体)：存放具体的资产、设备、台账、合约或静态数据。
• logs/ (日志)：存放按月归档的工作与技术日志，如 2026-07.md。
• raw/ (原件)：存放未处理的原始网页、聊天归档、微信文章等。
• index.md：知识总纲目录，用于汇总导航所有卡片的双向链接。
• SCHEMA.md：定义知识卡片的分类元数据与标签体系。

---

二、 网页端 (Obsidian) 卡片创作指南

如果你在浏览器使用 Ignis 平台访问 Obsidian，请遵循以下标准流程创建卡片：

1. 新建卡片并命名

• 在 concepts/ 或 entities/ 文件夹下右键新建文件。
• 文件名称必须使用直观的中文命名，不可包含多余空格（如：滑动轴承巴氏合金技术.md）。

2. 编写标准元数据 (YAML Frontmatter)

在卡片文件的最顶部第一行，硬性写入以下元数据，以便 AI 后台精准分类：

---
title: 知识卡片中文标题
created: YYYY-MM-DD
updated: YYYY-MM-DD
type: concept | entity
tags: [金融 | 电力 | 直饮水 | VPS | 杂项]
---

3. 正文书写与网状双链 [[ ]]

• 正文使用标准的 Markdown 语法。
• 凡是涉及到已有知识点的地方，使用 [[卡片名称]] 进行双链引用（例如输入 [[第一性原理]]），Obsidian 自动建立拓扑关系图谱。

4. 挂载到总目录 index.md

• 打开 wiki/index.md 目录总纲。
• 在对应分类的标题下（如 ## 🖥️ VPS 运维），手动添加该卡片的链接和一句话介绍： • [[卡片名称]] — 简要描述该卡片解决了什么问题或包含什么命令。

---

三、 安全脱敏红线 (Inversion Defense)

根据安全防御规则，严禁在任何卡片中保存明文敏感数据。

• 排查项：在保存前，检查卡片内容是否无意包含 API_KEY、Token、Secret、Password 或服务器 IP 地址。
• 处理方式：必须对上述数据进行完全擦除，统一替换为 [REDACTED]。

---

四、 版本控制与自动化同步

在网页端完成写作后，无须在终端手动提交：

• 可以直接呼叫我：“狗蛋儿，将知识库修改同步到 GitHub。”
• 我会自动扫描本地修改、自动刷新卡片内的 updated 修改时间，并执行 Git 提交推送至 HermesAgent Wiki 仓库。