当前位置：首页 > news >正文

claude-obsidian 项目迁移至 Qoder 系统完整记录

news 2026/7/2 16:16:50

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