知识索引

项目简介

这是基于 Claude Code 会话记录构建的自动化知识库系统。只需进入项目目录，问答就会自动记录！

快速开始

首次使用

1. 进入项目目录

   cd /path/to/your/project

2. 初始化项目（首次使用）

   ./qa.sh init

日常使用

项目会自动检测并初始化。之后你可以：

查看记录状态

./qa.sh status

手动保存问答

./qa.sh save "你的问题" "答案内容"

查看最近记录

./qa.sh recent 10

整理笔记

./qa.sh organize

使用交互式菜单

./start.sh

标签系统

所有笔记都使用以下标签：

• #提问记录 - 标记所有问答记录
• #技术笔记 - 技术相关内容
• #项目记录 - 项目开发记录
• #学习笔记 - 学习资料
• #问题排查 - 故障排除记录

整理规则

1. 自动分类：根据内容关键词自动识别主题
2. 避免重复：同一天同一主题只创建一条记录
3. 保留原始：原始记录自动归档，可追溯
4. 定期清理：自动清理过期记录

使用 Claude Code 提示词

自动整理

请帮我整理最近的会话记录，运行：
node scripts/organize-notes.js

查找特定主题

请帮我查找关于 [主题] 的所有笔记

创建新主题笔记

请帮我创建一个新的主题笔记：[主题名称]
内容：[相关内容]

维护建议

1. 定期整理：每周或每月运行整理脚本
2. 检查分类：定期检查主题分类是否准确
3. 补充链接：手动添加笔记间的相互链接
4. 更新关键词：根据新增内容调整主题关键词

故障排除

记录未保存

检查 .claude/session-history.json 是否存在，确保有写入权限。

整理失败

确保：

• Inbox/ 目录存在且有内容
• Notes/ 目录有写入权限
• 磁盘空间充足

找不到主题笔记

检查：

• 是否已经运行整理脚本
• 主题是否在关键词列表中
• Notes/ 目录下是否有对应的文件

扩展功能

自定义主题

在 scripts/organize-notes.js 中更新 topicKeywords 对象：

const topicKeywords = {
  '新主题': ['关键词1', '关键词2', '关键词3'],
  // ... 其他主题
};

添加新脚本

在 scripts/ 目录下创建新的脚本，遵循现有模式。

联系与反馈

如有问题或建议，请通过 Issues 或 Discussions 反馈。