29 lines
1.6 KiB
Markdown
29 lines
1.6 KiB
Markdown
## Why
|
||
|
||
每次用 `/knowledge-absorber` 学习都会生成 `knowledge_YYYYMMDD_Title/` 文件夹。当前仓库将这些条目集中在 `knowledge/entries/`，但仍需要一个跨条目的索引页面，避免靠手动翻目录查找历史学习内容。随着知识条目增长（预计每月 5-10 个），搜索成本线性上升。需要一个人工可读的、零运行时依赖的索引面板。
|
||
|
||
## What Changes
|
||
|
||
- 新增 `knowledge-index.html`，放置在项目根目录，浏览器直接打开即可使用
|
||
- 自动扫描 `knowledge/entries/knowledge_*/` 目录，从 .md 文件的 YAML frontmatter 提取元数据（title、date、tags）
|
||
- 按标签自动关联——同一 tag 出现于不同条目时显示"相关内容"
|
||
- 全文搜索——输入关键词实时过滤所有知识条目
|
||
- 纯静态 HTML/CSS/JS，零外部依赖，不依赖任何服务器或构建工具
|
||
|
||
## Capabilities
|
||
|
||
### New Capabilities
|
||
- `knowledge-indexing`: 自动发现并解析 `knowledge/entries/knowledge_*/` 目录，提取 YAML frontmatter 元数据
|
||
- `knowledge-search`: 全文搜索——输入关键词，在所有知识条目的正文中检索并高亮匹配项
|
||
- `knowledge-linking`: 基于标签的关联图谱——点击标签显示所有共用该标签的知识条目
|
||
|
||
### Modified Capabilities
|
||
<!-- 没有已有 spec 需要修改 -->
|
||
|
||
## Impact
|
||
|
||
- 项目根目录新增 `knowledge-index.html`（无关现有文件结构）
|
||
- 不修改任何现有 `knowledge/entries/knowledge_*/` 目录或 .md 文件
|
||
- 不影响 `.claude/skills/` 中的任何技能
|
||
- 无 API 调用，无外部依赖
|