claude-obsidian 项目迁移至 Qoder 系统完整记录
claude-obsidian 项目迁移至 Qoder 系统完整记录
- claude-obsidian 项目迁移至 Qoder 系统完整记录
- 一、迁移背景
- 二、迁移方案设计
- 2.1 目录映射关系
- 2.2 根目录文件处理策略
- 2.3 其他目录处理
- 三、迁移执行步骤
- 3.1 步骤一：核心目录迁移
- 3.2 步骤二：清理已迁移的根目录
- 3.3 步骤三：README.md 翻译
- 3.4 步骤四：重写 AGENTS.md
- 3.5 步骤五：运行 /wiki 技能
- 四、迁移后的项目结构
- 4.1 最终目录结构
- 4.2 迁移的 Skills 列表
- 4.3 迁移的 Agents 列表
- 4.4 迁移的 Commands 列表
- 五、配置文件适配
- 5.1 hooks 配置迁移
- 5.2 settings.json 完整内容
- 六、遇到的问题与解决方案
- 6.1 Shell 命令兼容性问题
- 6.2 并发锁缺失
- 6.3 模式路由缺失
- 6.4 源文档内容重叠
- 七、Wiki 知识库摄入
- 7.1 批量摄入统计
- 7.2 Wiki 增长统计
- 7.3 关键知识领域覆盖
- 八、技术细节
- 8.1 Qoder 目录结构规范
- 8.2 关键脚本索引
- 8.3 Frontmatter Schema
- 九、迁移总结
- 9.1 完成的操作清单
- 9.2 迁移后的优势
- 9.3 后续建议
claude-obsidian 项目迁移至 Qoder 系统完整记录
一、迁移背景
将 claude-obsidian 项目（原为 Claude Code + Obsidian 打造的 AI 第二大脑知识库）迁移至 Qoder 系统，使其能在 Qoder IDE 中正常运行。
项目定位：claude-obsidian 是为 Obsidian+Claude Code 打造的"自组织 AI 第二大脑"，构建持久、复利增长的 Wiki 知识库。
核心能力：
- 15 个 Claude Code 技能（含 v1.9
/think10 原则思考框架） - 方法论模式：LYT/PARA/Zettelkasten/Generic（v1.8+）
- 多写安全：v1.7+ 基于文件的 advisory 锁机制
- 检索架构：三层混合（hot cache → index → page drill-down）
- 自主研究：
/autoresearch三轮循环（广搜→补缺→合成）
二、迁移方案设计
2.1 目录映射关系
| 源路径 | Qoder 目标路径 | 迁移方式 |
|---|---|---|
skills/ | .qoder/skills/ | 符号链接或复制 |
agents/ | .qoder/agents/ | 转换格式后放入 |
commands/ | .qoder/commands/ | 直接复制 |
.cursor/rules/ | .qoder/rules/ | 手动迁移（格式类似） |
hooks/hooks.json | .qoder/settings.json | 转换格式 |
2.2 根目录文件处理策略
| 文件 | Qoder 处理方式 |
|---|---|
AGENTS.md | 直接识别加载，无需配置 |
CLAUDE.md/GEMINI.md | Qoder 不读取，保留不冲突 |
Makefile/README.md等 | 保留原位，AI 可通过工具读取 |
2.3 其他目录处理
| 目录 | 处理方式 |
|---|---|
_templates/ | 保留原位，在 rules 中引用路径 |
scripts/ | 保留原位，在 Agent/Skill 提示词中说明调用方式 |
tests/ | 保留原位，AI 通过 Bash 工具执行 |
wiki//.raw/ | 知识库内容，保留原位 |
bin//docs/ | 保留原位，按需读取 |
三、迁移执行步骤
3.1 步骤一：核心目录迁移
执行以下迁移操作：
# 1. 创建 .qoder 目录结构mkdir-p.qoder/skills .qoder/agents .qoder/commands .qoder/rules# 2. 复制 skills（15 个技能目录）cp-rskills/* .qoder/skills/# 3. 复制 agents（3 个 agent 文件）cpagents/*.md .qoder/agents/# 4. 复制 commands（4 个 command 文件）cpcommands/*.md .qoder/commands/# 5. 迁移 rules（从 .cursor/rules/ 到 .qoder/rules/）cp.cursor/rules/*.mdc .qoder/rules/# 6. 转换 hooks 配置# hooks/hooks.json → .qoder/settings.json（格式转换）迁移结果：
| 源路径 | 目标路径 | 状态 | 内容 |
|---|---|---|---|
skills/ | .qoder/skills/ | ✅ 完成 | 15 个 skill 目录 |
agents/ | .qoder/agents/ | ✅ 完成 | 3 个 agent 文件 |
commands/ | .qoder/commands/ | ✅ 完成 | 4 个 command 文件 |
.cursor/rules/ | .qoder/rules/ | ✅ 完成 | 1 个 rule 文件 |
hooks/hooks.json | .qoder/settings.json | ✅ 完成 | 格式已转换 |
3.2 步骤二：清理已迁移的根目录
删除根目录下已迁入.qoder/的冗余目录：
第一轮清理（已迁移目录）：
| 已删除目录 | 内容已迁移至 |
|---|---|
skills/ | .qoder/skills/ |
agents/ | .qoder/agents/ |
commands/ | .qoder/commands/ |
hooks/ | .qoder/settings.json |
.cursor/ | .qoder/rules/ |
第二轮清理（中等价值 + 低价值目录）：
| 类别 | 已删除目录 | 说明 |
|---|---|---|
| 中等价值 | bin/ | 安装脚本 |
| 中等价值 | tests/ | 测试文件 |
| 中等价值 | docs/ | 文档 |
| 中等价值 | assets/ | 图表资源 |
| 低价值 | .windsurf/ | 重复的 rules |
| 低价值 | .claude-plugin/ | Claude 插件元数据 |
| 低价值 | .github/ | GitHub 模板/CI |
3.3 步骤三：README.md 翻译
将README.md从英文翻译为中文（677 行），保持原有 Markdown 格式、链接、图片和代码块。
翻译内容涵盖：
- 标题和介绍
- 功能介绍和对比表
- 快速开始（3 个选项）
- 命令表
- 方法论模式和知识库用例
- 架构说明（知识库流程、多写入者安全、混合检索）
- MCP 设置、插件、CSS 片段
- 文件结构（更新