Auto-sync: 2026-04-22 12:02

wiki/sources/chinatextbook-41-53-gb-中国小学-初中-高中-大学-pdf-教材.md

@@ -0,0 +1,42 @@
+---
+title: "ChinaTextbook - 41.53 GB，中国小学、初中、高中、大学 PDF 教材"
+type: source
+tags: []
+date: 2025-12-19
+---
+
+## Source File
+- [[raw/Others/ChinaTextbook - 41.53 GB，中国小学、初中、高中、大学 PDF 教材.md]]
+
+## Summary
+- 核心主题：ChinaTextbook 是一个收集中国全学段教材 PDF 的开源 GitHub 项目，总库大小 41.53GB。
+- 问题域：优质教育资源获取，免费公开教材的聚合与归档。
+- 方法/机制：项目维护者从国家中小学智慧教育平台抓取教材，托管于 GitHub；用户可使用 tchMaterial-parser 等工具自行下载合并教材。
+- 结论/价值：提供了小学、初中、高中、大学全阶段教材的免费 PDF 资源，适合自学、教育研究和 AI 训练数据使用。
+
+## Key Claims
+- ChinaTextbook 项目（TapXWorld/ChinaTextbook）收集了公开的中国小学、初中、高中、大学 PDF 教材，总库大小 41.53GB，在 GitHub 上公开托管。
+- 教材来源为国家中小学智慧教育平台（basic.smartedu.cn），登录后即可浏览，可使用第三方工具（如 tchMaterial-parser）下载。
+- 小学教材覆盖：体育与健康、数学、科学、美术、艺术、英语、语文/统编版、语文·书法练习指导、道德与法治/统编版、音乐共 10 门学科。
+- 初中教材覆盖：人文地理、体育与健康、俄语、化学、历史、数学、日语、物理、生物学、科学、美术、艺术、英语、语文、道德与法治、音乐共 17 门学科（含地理图册）。
+- 高中教材覆盖：体育与健康、俄语、信息技术、化学、历史、地理、思想政治、数学、日语、物理、生物学、美术、艺术、英语、语文、通用技术、音乐共 18 门学科。
+- 大学教材覆盖：概率论、离散数学、线性代数、高等数学共 4 门基础数学课程。
+
+## Key Quotes
+> "如果有需求，可以制作一个如何下载/合并教材的教程。" — Appinn 原文评论区的用户建议
+
+## Key Concepts
+- [[国家中小学智慧教育平台]]：教材来源平台，basic.smartedu.cn，登录后提供全学段教材浏览
+- [[tchMaterial-parser]]：第三方下载工具，可解析并批量下载国家中小学智慧教育平台的教材
+
+## Key Entities
+- [[TapXWorld/ChinaTextbook]]：GitHub 仓库维护者和项目发起方
+- [[Appinn]]：资讯网站，最早报道此项目并引发关注
+
+## Connections
+- [[Appinn]] — reported_by — [[TapXWorld/ChinaTextbook]]
+- [[tchMaterial-parser]] — used_by — [[TapXWorld/ChinaTextbook]]
+- [[国家中小学智慧教育平台]] — source_of — [[TapXWorld/ChinaTextbook]]
+
+## Contradictions
+- 暂无发现与其他 Wiki 页面的内容冲突。

wiki/sources/cursor-2-0初学者使用指南.md

@@ -0,0 +1,52 @@
+---
+title: "Cursor 2.0初学者使用指南"
+type: source
+tags: [ai, cursor, ide, mcp]
+date: 2026-04-22
+---
+
+## Source File
+- [[Vibe Coding/Cursor 2.0初学者使用指南.md]]
+
+## Summary（用中文描述）
+- 核心主题：Cursor 2.0 AI代码编辑器的系统化入门教程
+- 问题域：AI辅助编程工具的使用方法与工作流程
+- 方法/机制：通过视频演示展示安装、配置、AI代理操作、代码审查、版本控制、MCP扩展等全流程
+- 结论/价值：帮助初学者从零掌握AI代码编辑器，建立"需求明确→规划→生成→审查→版本控制"的完整开发闭环
+
+## Key Claims（用中文描述）
+- Cursor 2.0基于VS Code构建，集成AI模型辅助代码生成，初学者可免费使用
+- Composer是Cursor自研AI模型，生成速度比同类模型快4倍
+- AI代理支持Plan（规划）、Agent（执行）、Ask（咨询）三种工作模式，Ask模式仅返回文本不修改文件
+- 多代理功能可并行运行不同任务，互不干扰上下文
+- MCP（Model Context Protocol）协议可将外部工具和服务集成到AI代理，扩展功能范围
+- AI生成代码即写入文件，需通过Diff功能审查后再确认保存
+- 结合Git版本控制可有效管理和回滚AI生成的代码变更
+
+## Key Quotes
+> "Cursor是基于VS Code的AI代码编辑器，可免费使用，支持付费升级以获取更多生成额度。" — Cursor基础介绍
+> "新增了自有AI模型Composer，强调其速度优势（比类似模型快4倍）。" — Composer模型特性
+> "Agent模式会修改代码，Ask模式仅提供文本答案，不会改动代码，需根据需求选择。" — 代理模式安全提示
+> "代码改动一旦生成即写入文件，未点击撤销按钮前持续保留，需确保先测试代码再确认保存。" — Diff审查机制
+> "MCP（Model Context Protocol）支持将外部工具和服务集成到AI代理，扩展功能范围。" — MCP扩展能力
+
+## Key Concepts
+- [[AI代理]]：基于AI模型的自动化任务助手，可以按模式生成代码、规划任务或回答疑问
+- [[MCP（Model Context Protocol）]]：将外部工具和服务集成到AI代理的协议平台
+- [[Diff文件]]：显示代码改动对比的视图，帮助开发者快速审查AI修改的内容
+- [[版本控制]]：记录项目代码的历史版本变化，支持代码回滚和团队协同（Git）
+- [[多代理并行]]：多个AI代理同时运行不同任务，互不干扰上下文的开发模式
+
+## Key Entities
+- [[Cursor]]：基于VS Code的AI增强代码编辑器，支持AI模型辅助代码生成及多任务代理操作
+- [[Composer]]：Cursor自研AI模型，主打生成速度比同类模型快4倍
+
+## Connections
+- [[Cursor]] ← built_on ← [[VS Code]]
+- [[Cursor]] ← uses ← [[Composer]]
+- [[Cursor]] ← supports ← [[MCP（Model Context Protocol）]]
+- [[MCP（Model Context Protocol）]] ← integrates ← [[AI代理]]
+- [[Vibe Coding]] ← demonstrates ← [[Cursor]]
+
+## Contradictions
+- 无已知冲突内容

wiki/sources/dataview-让我从"笔记黑洞"里逃出来的-obsidian-神器-1.md

@@ -0,0 +1,45 @@
+---
+title: "Dataview——让我从"笔记黑洞"里逃出来的 Obsidian 神器"
+type: source
+tags: []
+date: 2026-04-22
+---
+
+## Source File
+- [[Others/Dataview——让我从"笔记黑洞"里逃出来的 Obsidian 神器 1.md]]
+
+## Summary（用中文描述）
+- 核心主题：Dataview 插件将 Obsidian 变成"笔记数据库"，解决笔记越记越乱的问题
+- 问题域：Obsidian 用户在笔记数量增多后面临的检索困难和信息碎片化问题
+- 方法/机制：Dataview 提供类 SQL 的查询语法，自动索引笔记中的标签、字段、元数据，生成动态视图（表格、列表、图表）
+- 结论/价值：Dataview 让笔记"活"起来，实现待办事项自动聚合、学习笔记索引、写作量统计等场景
+
+## Key Claims（用中文描述）
+- Obsidian 用户在笔记积累后面临"写笔记时激情满满，查笔记时满头大汗"的信息检索困境
+- Dataview 将笔记变成可查询的"数据库"，支持自动整理待办事项、标签索引、统计写作量
+- 初次接触 Dataview 查询语法有学习门槛，但最简单的查询只需一行代码：`LIST FROM "Notes" WHERE contains(tags, "学习")`
+- 常见使用场景包括：自动聚合所有待办事项、整理带 #写作 标签的素材、统计笔记数量
+
+## Key Quotes
+> "Dataview 就是 Obsidian 里的'笔记数据库'，它可以帮你自动整理各种内容……所有待办事项，无论它们藏在哪个笔记里，统统整理到一个视图里。" — Dataview 的核心定位
+
+> "这不就是'神奇的自动整理'吗？！" — 作者发现第一条 Dataview 查询生效后的惊叹
+
+## Key Concepts
+- [[Dataview]]：Obsidian 社区插件，将笔记系统转化为可查询的数据库，通过类 SQL 语法（DQL）自动索引标签、字段和元数据，生成动态视图
+- [[笔记数据库]]：一种笔记管理理念，将每篇笔记视为数据库中的一条记录，通过字段/标签实现自动检索和聚合，区别于传统文件夹分类法
+- [[DQL（Dataview Query Language）]]：Dataview 的查询语言，类 SQL 语法，支持 FROM、WHERE、GROUP BY 等操作符
+
+## Key Entities
+- [[赫点茶]]：微信公众号，专注于 Obsidian 和笔记管理技巧的原创内容号，本文来源
+- [[shenwei]]：赫点茶公众号作者，长期 Obsidian 用户，分享个人笔记管理工作流
+
+## Connections
+- [[Obsidian最有必要安装的10款插件是这些]] ← extends ← [[Dataview]]
+- [[Obsidian高效指南]] ← depends_on ← [[Dataview]]
+- [[Obsidian Tasks]] ← related_to ← [[Dataview]]（两者常配合使用：Tasks 管理任务，Dataview 聚合任务）
+- [[笔记数据库]] ← implements ← [[Dataview]]
+
+## Contradictions
+- 无直接内容冲突
+- 补充说明：[[Obsidian最有必要安装的10款插件是这些]] 和 [[Obsidian高效指南]] 均提及 Dataview 为必装插件，与本文定位一致，互为印证

wiki/sources/obsidian-tasks-插件-这可能是最适合懒人的任务管理方式.md

@@ -0,0 +1,46 @@
+---
+title: "Obsidian Tasks 插件：这可能是最适合懒人的任务管理方式"
+type: source
+tags: []
+date: 2025-03-13
+last_updated: 2026-04-22
+---
+
+## Source File
+- [[raw/Others/Obsidian Tasks 插件：这可能是最适合懒人的任务管理方式.md]]
+
+## Summary（用中文描述）
+- 核心主题：Obsidian Tasks 插件将任务管理无缝整合进笔记工作流，解决「笔记+任务割裂」的核心痛点
+- 问题域：个人知识管理与任务管理的工具整合；Notion/Todoist 等独立任务管理工具与笔记软件之间的割裂问题
+- 方法/机制：通过 Markdown 任务语法（`- [ ]`）创建任务，支持日期/优先级/标签/重复任务，并通过代码块查询（`tasks` 代码块）在任意笔记中嵌入动态任务列表
+- 结论/价值：Tasks 插件让 Obsidian 用户实现「笔记即任务、任务即笔记」的统一工作流，适合已深度使用 Obsidian 的个人用户；不适合需要视觉化界面或团队协作的场景
+
+## Key Claims（用中文描述）
+- Obsidian Tasks 插件通过统一的 Markdown 语法，将任务管理与笔记记录合二为一，消除工具切换带来的割裂感
+- Tasks 插件的任务查询功能（`tasks` 代码块）比 Notion 数据库更灵活，可嵌入任意笔记的上下文中，实现「在笔记里直接看到当前最重要的任务」
+- 重复任务（`⏳ every week/month`）功能让周期性任务自动化，彻底解放手动更新日期的重复劳动
+- Tasks 插件适合已深度使用 Obsidian 的个人用户，不适合习惯 Trello/Things 视觉化看板、需要团队协作、或依赖手机端快速添加任务的场景
+
+## Key Quotes
+> "- [ ] 撰写公众号文章 📅 2025-03-03 🔼 #高优先级" — 简洁的 Markdown 任务语法，一行搞定时间+优先级+标签
+> "Tasks 最让我惊喜的，是它的查询功能……这种灵活性，让我的任务管理变得更自然，不再是'打开 Todoist → 找到任务 → 处理任务'，而是'在笔记的上下文里，直接看到当前最重要的任务'" — 任务查询嵌入笔记上下文的体验描述
+> "Tasks 插件确实强大，但它不是完美的……更适合已经习惯 Obsidian 工作流的人" — 作者对插件适用场景的客观评价
+
+## Key Concepts
+- [[Obsidian Tasks]]：Obsidian 的任务管理插件，通过 Markdown 语法（`- [ ]`）创建任务，支持日期、优先级、标签、重复任务，并通过代码块查询（`tasks` 代码块）在任意笔记中嵌入动态任务筛选视图
+- [[Task Query]]：Tasks 插件的查询语法，通过 `tasks` 代码块定义筛选条件（`not done`/`due before tomorrow`/`sort by priority` 等），在笔记任意位置嵌入动态任务列表
+- [[Recurring Task]]：重复任务机制，使用 `⏳ every week`/`⏳ every month` 等语法自动创建周期性新任务，避免手动复制粘贴更新日期
+
+## Key Entities
+- [[shenwei]]：本文作者，长期 Obsidian 用户，分享从 Notion/Todoist 迁移到 Obsidian Tasks 插件的个人经验
+
+## Connections
+- [[Obsidian 高效指南：我常用的插件与实用技巧]] ← mentions → [[Obsidian Tasks]]
+- [[Dataview]] ← complements → [[Obsidian Tasks]]（Dataview 提供笔记索引，Tasks 提供任务管理，共同构成 Obsidian 知识管理双核心）
+- [[Todoist]] ← compared_with → [[Obsidian Tasks]]（Todoist 是独立任务管理工具，Tasks 将任务整合进笔记；作者认为 Tasks 更适合 Obsidian 深度用户）
+
+## Contradictions
+- 与 [[Todoist]] 冲突：
+  - 冲突点：任务管理工具的整合度 vs 专业化
+  - 当前观点（本文）：Tasks 插件将任务整合进笔记，消除工具切换，适合 Obsidian 深度用户
+  - 对方观点：Todoist 作为独立任务管理工具，提供更专业的功能（更好的移动端体验、团队协作、可视化看板），适合需要独立任务管理系统的用户

wiki/sources/obsidian-高效指南-我常用的插件与实用技巧.md

@@ -0,0 +1,58 @@
+---
+title: "Obsidian 高效指南：我常用的插件与实用技巧"
+type: source
+tags: []
+date: 2026-04-22
+---
+
+## Source File
+- [[Others/Obsidian 高效指南：我常用的插件与实用技巧.md]]
+
+## Summary（用中文描述）
+- 核心主题：Obsidian 个人知识管理的高效插件组合与使用技巧
+- 问题域：如何将 Obsidian 打造成高效的个人知识管理系统
+- 方法/机制：Tasks/Dataview/Templater/QuickAdd 四款核心插件 + 双向链接/每日笔记/折叠大纲/定期复盘四种使用技巧
+- 结论/价值：Obsidian 通过插件生态可成为高效的第二大脑，Tasks 插件特别适合从 Todoist 迁移的用户
+
+## Key Claims（用中文描述）
+- Tasks 插件通过日期提醒、优先级设置、标签分类和查询语法，将待办事项完全整合进笔记系统，替代独立 Todoist 应用
+- Dataview 插件将笔记内容转化为数据库，支持自动生成表格、列表和图表，提高检索效率
+- Templater 插件预设模板，每次新建笔记直接套用，保持格式统一并省去重复操作
+- QuickAdd 插件通过快捷键快速创建笔记，适用于需要快速记录想法的场景
+- 双向链接是 Obsidian 最大的特色，构建个人知识网络比传统分类更灵活
+- Daily Notes 结合 Templater 设定日记模板，形成"早上计划—晚上总结"的时间管理节奏
+- 折叠与大纲模式使长篇笔记保持整洁，配合 Outline 视图快速跳转
+- 定期复盘优化笔记结构，Dataview 查询功能可快速筛选长期未访问的笔记
+
+## Key Quotes
+> "Obsidian 最大的特色就是它的双向链接功能……形成一个人知识库。这种方式比传统的分类方法更灵活，能让我在查找信息时获得更多启发。" — 双向链接构建个人知识网络
+
+> "每天打开 Obsidian，第一件事就是写下当天的任务，晚上再进行总结，这种方式让我在信息管理的同时，也能更有节奏地安排时间。" — Daily Notes 时间管理节奏
+
+## Key Concepts
+- [[Obsidian Tasks]]：将待办事项整合进笔记系统的插件，支持日期提醒、优先级、标签和查询语法
+- [[Dataview]]：将笔记内容转化为数据库的插件，支持自动生成表格、列表和图表
+- [[Templater]]：动态模板插件，支持预设模板并在笔记创建时自动填充
+- [[QuickAdd]]：快速创建笔记的插件，通过快捷键触发模板创建
+- [[双向链接]]：Obsidian 核心特性，通过 `[[wikilink]]` 建立笔记间的双向关联，形成知识网络
+- [[Daily Notes]]：Obsidian 内置功能，每天自动创建一篇日记笔记
+- [[折叠与大纲]]：通过 Markdown 标题结构和 Outline 视图管理长篇笔记
+- [[间隔重复]]：定期回顾笔记的学习方法，与"定期复盘"相关
+
+## Key Entities
+- [[shenwei]]：文章作者，长期 Obsidian 用户，分享个人使用经验
+
+## Connections
+- [[Obsidian最有必要安装的10款插件是这些]] ← extends ← [[Obsidian高效指南]]
+- [[Obsidian Tasks]] ← depends_on ← [[Obsidian]]
+- [[Dataview]] ← depends_on ← [[Obsidian]]
+- [[Templater]] ← depends_on ← [[Obsidian]]
+- [[QuickAdd]] ← depends_on ← [[Obsidian]]
+- [[双向链接]] ← depends_on ← [[Obsidian]]
+
+## Contradictions
+- 与 [[Obsidian最有必要安装的10款插件是这些]] 冲突：
+  - 冲突点：插件选择范围和推荐策略
+  - 当前观点：本文强调 4 款核心插件（Tasks/Dataview/Templater/QuickAdd）配合 4 种使用技巧（双向链接/每日笔记/折叠大纲/定期复盘），观点聚焦个人经验分享，倾向"少而精"
+  - 对方观点：对方列举 10 款插件（新增 Kanban/Projects/Outliner/Calendar/DB Folder/Homepage/File Explorer Note Count），观点偏全面推荐，倾向"多而全"
+  - 分析：两者均来自同一作者（shenwei），不同文章发布时间不同（本文 2025-03-01，对方为更近期的更新），反映作者 Obsidian 工作流随时间演进

wiki/sources/obsidian最有必要安装的10款插件是这些.md

@@ -0,0 +1,65 @@
+---
+title: "Obsidian最有必要安装的10款插件是这些"
+type: source
+tags: [obsidian, 插件, 知识管理]
+sources: []
+last_updated: 2025-03-04
+---
+
+## Source File
+- [[raw/Others/Obsidian最有必要安装的10款插件是这些.md]]
+
+## Summary（用中文描述）
+- 核心主题：Obsidian 最核心、最必要的 10 款插件推荐
+- 问题域：Obsidian 上千款插件中，哪些最值得安装
+- 方法/机制：作者试用近 100 种高下载量插件后，按功能分类为 4 组：核心生产力（必装）、效率增强（按需）、信息可视化（辅助）、便利性（可选）
+- 结论/价值：Dataview + Templater 必装，其余按工作流需求组合；可形成"知识管理流""任务管理流""学习研究流"三种典型组合
+
+## Key Claims（用中文描述）
+- Obsidian 有上千款插件，但真正有必要安装的不超过 10 款，甚至在特殊情况下只需 2-3 款
+- Templater 插件通过动态模板语法和脚本，显著提升笔记创建效率
+- Dataview 通过类 SQL 查询语言，使跨笔记的动态筛选、排序和展示成为可能
+- Spaced Repetition 插件将间隔重复学习方法内置于 Obsidian，无需依赖外部工具（如 Anki）
+- Kanban + Projects 组合可实现复杂的任务与项目管理
+- Dataview 和 DB Folder 功能高度重叠但各有侧重，可二选一或结合使用
+- 核心插件组合：知识管理流（Dataview + Templater + Calendar）、任务管理流（Kanban + Projects + Outliner）、学习研究流（Spaced Repetition + DB Folder）
+
+## Key Quotes
+> "人不可能都去了解，时间成本也非常高，因此，尽早去确定最有必要安装的插件才是最高效的" — 插件选择策略
+> "在尝试了快近100种高下载量插件，经过深度使用总结后发现，其实有必要安装的不过如下10款插件" — 推荐依据
+
+## Key Concepts
+- [[间隔重复]]: Spaced Repetition 插件实现的学习方法，通过定时复习提升记忆效果
+- [[看板]]: Kanban 插件提供的可视化任务管理视图
+- [[动态模板]]: Templater 插件支持的模板变量和脚本注入能力
+
+## Key Entities
+- [[Obsidian]]: 笔记软件平台，所有 10 款插件的宿主
+- [[Templater]]: 动态模板插件，支持复杂模板语法和脚本
+- [[Dataview]]: 类 SQL 查询插件，跨笔记动态视图
+- [[Spaced Repetition]]: 间隔重复插件，内置记忆复习功能
+- [[Kanban]]: 看板视图插件，可视化任务管理
+- [[Projects]]: 多项目管理插件，项目级视图
+- [[Outliner]]: 大纲视图插件，分层笔记管理
+- [[Calendar]]: 日历视图插件，日记和时间管理
+- [[DB Folder]]: 数据库化笔记插件，结构化数据管理
+- [[Homepage]]: 启动主页插件，固定工作空间
+- [[File Explorer Note Count]]: 文件计数插件，文件夹笔记数量统计
+
+## Connections
+- [[Obsidian]] ← provides_platform ← [[Templater]], [[Dataview]], [[Spaced Repetition]], [[Kanban]], [[Projects]], [[Outliner]], [[Calendar]], [[DB Folder]], [[Homepage]], [[File Explorer Note Count]]
+- [[知识管理]] ← enables ← [[Dataview]] + [[Templater]] + [[Calendar]]
+- [[任务管理]] ← enables ← [[Kanban]] + [[Projects]] + [[Outliner]]
+- [[学习研究]] ← enables ← [[Spaced Repetition]] + [[DB Folder]]
+- [[Dataview]] ← competes_with ← [[DB Folder]]（可二选一或结合）
+- [[Homepage]] ← depends_on ← [[Calendar]]（每日工作台组合）
+
+## Contradictions
+- 与 [[obsidian-高效指南-我常用的插件与实用技巧]] 冲突：
+  - 冲突点：插件推荐范围不同
+  - 当前观点：本文主张"最少插件优先"，推荐 10 款（部分可选），极简场景仅 2-3 款
+  - 对方观点：另一篇主张更广泛的插件生态探索
+- 与 [[obsidian-必装-skills]] 冲突：
+  - 冲突点：Obsidian 插件 vs Skills 的侧重点
+  - 当前观点：聚焦原生插件组合
+  - 对方观点：侧重 Obsidian Skills 生态

wiki/sources/tiktok-pm-python-django-project.md

@@ -0,0 +1,56 @@
+---
+title: "TikTok PM - Python Django 项目"
+type: source
+tags: [django, python, tiktok, mysql, mariadb, docker, bright-data]
+date: 2025-11-24
+---
+
+## Source File
+- [[raw/Others/TikTok PM - Python Django Project.md]]
+
+## Summary（用中文描述）
+- 核心主题：TikTok Shop 产品数据管理系统的完整 Django Web 应用开发教程
+- 问题域：电商产品数据抓取、存储、管理与可视化分析
+- 方法/机制：Django ORM + MySQL + Django REST Framework + Docker 容器化部署 + Bright Data API 异步数据抓取
+- 结论/价值：提供从零构建 TikTok 电商产品管理系统的完整技术方案，含 Admin 后台、API 接口、Docker 生产部署、异步任务队列
+
+## Key Claims（用中文描述）
+- Django Admin 可通过富文本编辑器（django-tinymce）、自定义视图、内联关联模型实现复杂产品管理界面
+- Django REST Framework + django-filter 可快速构建支持快速搜索和多条件过滤的 RESTful API，供 n8n 等自动化工具调用
+- Docker + Gunicorn + Nginx 容器化部署方案可实现零停机版本更新和快速回滚
+- Django-Q 异步任务队列可处理 Bright Data 异步 API 调用，实现不阻塞 Web 请求的产品数据抓取与导入
+- 自定义 Management Command 可将 JSON 文件批量导入逻辑封装为 `python manage.py import_json_data` 命令
+
+## Key Quotes
+> "无论修改字段类型、添加新字段，还是像您这样修改字段约束（例如从非空改为可空 null=True），都必须遵循这两步流程：makemigrations + migrate" — Django 数据库迁移最佳实践
+
+> "原子性部署：docker compose up --build -d 确保了所有依赖项和配置都会在新镜像中构建好，如果构建失败，旧服务不会受到影响" — Docker 生产部署最佳实践
+
+## Key Concepts
+- [[Django ORM]]：通过 Python 类定义数据库表结构，Django 自动生成 SQL 并管理迁移
+- [[Django REST Framework]]：构建 RESTful API 的 Django 第三方框架，支持序列化器、视图集、过滤和搜索
+- [[Docker 容器化部署]]：使用 Dockerfile + docker-compose.yml 实现应用容器化，结合 Gunicorn + Nginx 进行生产部署
+- [[Django Admin 定制]]：通过 fieldsets、inlines、readonly_fields、list_display 等实现复杂管理界面
+- [[Django-Q 异步任务]]：Django 异步任务队列，用于处理耗时的外部 API 调用
+- [[Bright Data API]]：第三方数据抓取服务，支持异步请求模式，适合大规模产品数据采集
+- [[MySQL/MariaDB 数据库]]：项目使用 MySQL/MariaDB 作为后端数据库，存储 TikTok 产品数据
+
+## Key Entities
+- [[TikTok Shop]]：电商平台，数据来源
+- [[Django]]：Python Web 框架
+- [[Bright Data]]：第三方数据抓取 API 提供商
+- [[MySQL / MariaDB]]：关系型数据库
+- [[Docker]]：容器化平台
+- [[Gunicorn]]：Python WSGI HTTP 服务器
+- [[Nginx]]：反向代理和静态文件服务
+- [[n8n]]：自动化工作流工具（通过 REST API 集成）
+
+## Connections
+- [[Django REST Framework]] ← builds_on ← [[Django ORM]]
+- [[Docker 容器化部署]] ← extends ← [[Gunicorn]] + [[Nginx]]
+- [[Django-Q 异步任务]] ← used_by ← [[Bright Data API]]
+- [[MySQL / MariaDB]] ← stores ← TikTok 产品数据
+
+## Contradictions
+- 暂无发现与其他 Wiki 页面的冲突
+

wiki/sources/trae远程开发部署指南.md

@@ -0,0 +1,57 @@
+---
+title: "Trae远程开发部署指南"
+type: source
+tags: [remote-ssh, trae, ubuntu]
+date: 2026-04-22
+---
+
+## Source File
+- [[Vibe Coding/Trae远程开发部署指南]]
+
+## Summary（用中文描述）
+- 核心主题：使用 Trae IDE 通过 SSH 远程连接 Ubuntu 服务器进行 Docker 容器化项目的开发工作流配置
+- 问题域：远程开发环境搭建、Docker 与 IDE 集成、内网穿透访问
+- 方法/机制：SSH 免密登录 → Trae Remote-SSH 连接 → Docker 容器 Attach 或宿主机文件编辑 → Tailscale/FRP 公网访问
+- 结论/价值：提供一套完整的"本地 UI + 远程服务器开发"解决方案，支持 Attach 容器调试和 docker-compose 编排两种模式
+
+## Key Claims（用中文描述）
+- Trae 原生支持 VS Code 插件生态，通过 Remote-SSH 插件可远程连接 Ubuntu 服务器
+- 开发模式 A（Attach 容器）：适合调试，环境完全隔离，直接使用容器内语言环境
+- 开发模式 B（宿主机文件 + Docker CLI）：适合编排 docker-compose.yml 和管理多容器配置
+- 用户必须加入 docker 用户组才能让 Trae 的 Docker 插件正常工作
+- 文件权限（UID/GID）问题会导致 Volume 挂载生成的 Build 文件归属 root，宿主机无法操作
+
+## Key Quotes
+> "开发环境的核心在于 Bind Mount（绑定挂载），实现代码修改实时生效" — 解释开发环境 docker-compose.yml 的设计原则
+
+> "SSH 登录服务器执行：sudo usermod -aG docker $USER，必须注销并重新登录" — Docker 用户组配置关键步骤
+
+> "不要直接暴露 SSH 端口，建议安装 Tailscale 或 Cloudflare Tunnel" — 内网穿透安全建议
+
+## Key Concepts
+- [[Remote-SSH]]：通过 SSH 协议将本地 IDE 连接到远程服务器，代码运行在服务器端但 UI 在本地
+- [[Bind Mount]]：Docker Volume 挂载方式，将宿主机目录映射到容器内，实现代码修改实时生效
+- [[Attach 容器]]：将 IDE 直接连接到正在运行的 Docker 容器内部进行开发调试的模式
+- [[Docker 用户组]]：将用户加入 docker 组使其无需 sudo 即可运行 docker 命令
+- [[SSH Config]]：SSH 客户端配置文件（~/.ssh/config），定义 Host 别名和连接参数
+- [[SSH 免密登录]]：通过 ssh-copy-id 公钥分发实现无密码 SSH 连接
+- [[Docker Compose 开发模式]]：使用 docker-compose.yml 编排开发环境，通过 volumes 实现源码挂载
+
+## Key Entities
+- [[Trae]]：国产 AI IDE，基于 VS Code，支持 Remote-SSH 远程开发，与 Cursor 功能类似
+- [[Ubuntu 2]]：开发服务器（192.168.3.45），存放源码，运行带 Bind Mount 的开发容器
+- [[Ubuntu 1]]：生产服务器（192.168.3.47），运行生产容器，通过 Docker 卷持久化数据
+- [[ThinkBook]]：本地笔记本，作为 Trae UI 端连接远程服务器
+- [[Tailscale]]：零配置 VPN 工具，可替代 FRP 提供安全的公网 SSH 访问
+- [[Docker]]：容器化平台，远程开发的核心载体
+
+## Connections
+- [[Trae]] ← remote-ssh ← [[Ubuntu 2]]
+- [[Docker]] ← hosts ← [[Ubuntu 2]]
+- [[Docker Compose]] ← manages containers on ← [[Ubuntu 2]]
+- [[Remote-SSH]] ← 公网穿透方案 ← [[Tailscale]] / [[frp]]
+- [[Ubuntu 2]] ← 公网访问 ← [[frp]] (ubuntu2-ext: ubuntu2.ishenwei.online:60024)
+
+## Contradictions
+- 无已知冲突内容
+

wiki/sources/vibe-coding经验收集.md

@@ -0,0 +1,56 @@
+---
+title: "Vibe Coding 经验收集"
+type: source
+tags: []
+date: 2025-12-30
+---
+
+## Source File
+- [[Vibe Coding/vibe coding经验收集.md]]
+
+## Summary（用中文描述）
+- 核心主题：Vibe Coding 实战经验与最佳实践的精选合集
+- 问题域：AI 辅助编程的工作流优化、代码质量保证、团队协作模式
+- 方法/机制：设计文档→伪代码→代码的递进式开发、多 AI 协作验证、文件注释标准化、代码可导航化
+- 结论/价值：Vibe Coding 已从单纯提示词工程演变为系统性工程实践，强调验证而非理解、文档优于记忆
+
+## Key Claims（用中文描述）
+- **递进式开发工作流**：设计文档写细（含伪代码）→ AI 直出代码 → 另一 AI review → 跑测试用例 → AI 自动 commit+push，可一遍直出
+- **System Prompt 优化效果**：针对 Gemini 3 Pro 的系统 prompt 优化可使多代理基准测试性能提升约 5%
+- **点线体迭代方法**：逐级迭代（点→线→体），先用单个基础任务打磨，再基于此批量执行
+- **文件头注释规范**：一段话描述代码作用、上下游链路，降低认知负载，参考 Claude skill 格式
+- **代码验证优先**：未来软件工程核心不是"看懂代码"而是"验证代码按正确逻辑运行"，依赖自动化测试、静态分析、形式化验证
+- **激励式提示词**：如"如果第一次就做得好，我会打赏100美元"可提升生成效果
+- **CodeWeaver 工具**：将代码库编织成可导航的 Markdown 文档，简化 AI/ML 工具集成
+
+## Key Quotes
+> "我是把设计文档写得很细，包括service层的具体逻辑都用伪代码写了，然后交给AI，一遍直出，再用另一个AI review一遍，根据review意见修改一下，跑一下测试用例，让AI自己生成commit后push" — 需求→伪代码→代码递进工作流
+
+> "代码最终会被转换成机器码执行，高级语言只是一层方便人类理解的抽象，重要的是验证程序的执行逻辑" — 代码验证哲学
+
+> "请你根据我的要求，用 Three.js 创建一个实时交互的3D粒子系统，如果你第一次就做得好，我将会打赏你100美元的小费" — 激励式提示词示例
+
+## Key Concepts
+- [[Vibe Coding]]：使用 AI 辅助编程的实践方法论，强调人机协作而非纯自动生成
+- [[Design-to-Code Workflow]]：设计文档→伪代码→代码的递进式开发流程
+- [[Multi-AI Review]]：多 AI 协作验证，一个生成一个 review 的双人编程模式
+- [[Code Documentation]]：文件头注释规范，降低 AI 和人类认知负载
+- [[CodeWeaver]]：将代码库转换为可导航 Markdown 文档的工具
+- [[Verification-First Engineering]]：验证优先于理解，强调自动化测试和形式化验证
+- [[Iterative Scaling]]：点→线→体的逐级迭代，从单任务打磨到批量执行
+
+## Key Entities
+- [[CodeWeaver]]：GitHub 开源项目，将代码库编织成可导航 Markdown 文档的工具
+
+## Connections
+- [[Vibe Coding]] ← extends ← [[Agentic AI]]
+- [[Design-to-Code Workflow]] ← refines ← [[Vibe Coding]]
+- [[Multi-AI Review]] ← part_of ← [[Design-to-Code Workflow]]
+- [[CodeWeaver]] ← enables ← [[Vibe Coding]]
+
+## Contradictions
+- 与传统软件工程方法冲突：
+  - 冲突点：传统方法强调"先理解代码再修改"，Vibe Coding 强调"验证而非理解"
+  - 当前观点：通过自动化测试和验证确保行为正确，降低人类理解代码的必要性
+  - 对方观点：人类开发者必须理解代码才能安全地进行修改和重构
+```

wiki/sources/vibe-kanban-opencode-在-ubuntu-server-上安装与管理指南.md

@@ -0,0 +1,50 @@
+---
+title: "Vibe-Kanban + OpenCode 在 Ubuntu Server 上安装与管理指南"
+type: source
+tags: [npm, npx, pm2, ubuntu, vibe-coding, vibe-kanban]
+date: 2026-04-17
+---
+
+## Source File
+- [[Vibe Coding/Vibe-Kanban + OpenCode 在 Ubuntu Server 上安装与管理指南]]
+
+## Summary（用中文描述）
+- 核心主题：在 Ubuntu Server 上非 root 用户（shenwei）安装 Node 20、Vibe-Kanban、OpenCode，并通过 pm2 进程管理，实现 AI 辅助编程工作流
+- 问题域：Ubuntu Server 环境下的 AI Coding Agent 部署与长期运维
+- 方法/机制：使用 nvm 管理 Node 版本、npm/npx 安装工具、pm2 管理进程生命周期、权限配置确保非 root 用户正常运行
+- 结论/价值：完整记录了从零开始在 Ubuntu Server 上搭建 Vibe Coding 环境的全流程，含验证步骤和故障排查要点
+
+## Key Claims（用中文描述）
+- 使用 nvm 安装 Node 20 可确保版本兼容性和环境隔离
+- pm2 能可靠管理 Vibe-Kanban 和 OpenCode Executor 进程并支持开机自启
+- 权限配置（/var/tmp/vibe-kanban 和 ~/.vibe-kanban 归属 shenwei）是避免 I/O error 的关键
+- 不应以 root 用户启动 OpenCode serve，避免权限问题
+- Vibe-Kanban 会自动 spawn OpenCode executor（随机端口），无需手动固定端口
+
+## Key Quotes
+> "不要用 root 启动 OpenCode serve，vibe-kanban 会自动 spawn executor" — 核心安全与架构原则
+> "遇到 I/O error 时，通常是 executor 没启动或端口被占用" — 常见故障排查方向
+> "pm2 只管理 vibe-kanban，executor 随进程一起管理" — 进程管理边界定义
+
+## Key Concepts
+- [[Vibe Coding]]：使用自然语言与 AI 编程工具协作的开发方式，Vibe-Kanban + OpenCode 是其代表性工具栈
+- [[nvm]]（Node Version Manager）：Node.js 版本管理工具，通过 $NVM_DIR/$HOME/.nvm 安装，支持多版本共存和快速切换
+- [[pm2]]：Node.js 进程管理器，支持进程守护、负载均衡、日志管理和开机自启（systemd）
+- [[Node 20]]：LTS 版 Node.js，Vibe-Kanban 和 OpenCode 的推荐运行时版本
+
+## Key Entities
+- [[Vibe-Kanban]]：AI 编程辅助工具，提供看板界面与 OpenCode executor 集成，通过 npx vibe-kanban 启动
+- [[OpenCode]]：开源 AI Coding CLI agent，与 Vibe-Kanban 配合使用，npm install -g opencode-ai 安装
+- [[shenwei]]：文档作者，非 root 普通用户，用于在 Ubuntu Server 上运行 Vibe-Kanban 和 OpenCode
+
+## Connections
+- [[如何在Ubuntu上安装OpenCode并配置Vibe-Kanban]] ← extends ← [[vibe-kanban-opencode-在-ubuntu-server-上安装与管理指南]]
+- [[Vibe Coding 经验收集]] ← related_to ← [[vibe-kanban-opencode-在-ubuntu-server-上安装与管理指南]]
+- [[OpenCode]] ← depends_on ← [[Node 20]]
+- [[Vibe-Kanban]] ← depends_on ← [[OpenCode]]
+
+## Contradictions
+- 与 [[如何在Ubuntu上安装OpenCode并配置Vibe-Kanban]] 部分重叠：
+  - 冲突点：两篇文档都介绍 Ubuntu 上安装 OpenCode 和 Vibe-Kanban
+  - 当前观点：本篇更详细，覆盖完整 6 步流程、pm2 进程管理、权限配置和验证步骤
+  - 对方观点：前篇侧重基础安装步骤

wiki/sources/在ubuntu上安装vibe-kanban.md

@@ -0,0 +1,47 @@
+---
+title: "在Ubuntu上安装Vibe-Kanban"
+type: source
+tags: [npm, npx, pm2, ubuntu, vibe-coding, vibe-kanban]
+sources: []
+last_updated: 2026-04-22
+---
+
+## Source File
+- [[Vibe Coding/在Ubuntu上安装Vibe-Kanban.md]]
+
+## Summary（用中文描述）
+- 核心主题：Vibe-Kanban 在 Ubuntu 服务器上的安装、配置与 PM2 进程管理
+- 问题域：AI 编程 agent 的任务管理与自动化工作流
+- 方法/机制：通过 npx 快速启动 + PM2 守护进程实现后台常驻，支持自定义 HOST/PORT 环境变量，Git worktree 隔离任务环境
+- 结论/价值：提供一套完整的 Ubuntu Server 部署 Vibe-Kanban 生产级方案，突破浏览器限制实现远程访问
+
+## Key Claims（用中文描述）
+- Vibe-Kanban 默认以随机端口启动并自动打开浏览器，适合本地桌面使用
+- 通过 `HOST=0.0.0.0 PORT=9999` 环境变量可固定端口并允许外部访问
+- PM2 守护进程可实现进程常驻、自动重启和开机自启，适合服务器长期运行
+- 每个任务运行在独立的 git worktree 中，防止多个 agent 相互干扰
+- Vibe-Kanban 默认以 `--dangerously-skip-permissions` 模式运行，agent 可自主执行系统级操作
+
+## Key Quotes
+> "Vibe Kanban runs AI agents with —dangerously-skip-permissions/—yolo flags by default so they can work autonomously without constant approval prompts." — 安全机制说明
+
+> "Each task runs in an isolated git worktree, preventing agents from interfering with each other." — 隔离机制说明
+
+> "pm2 start \"HOST=0.0.0.0 PORT=9999 npx vibe-kanban\" --name vibe-kanban" — Ubuntu Server 生产部署命令
+
+## Key Concepts
+- [[Vibe Coding]]：通过自然语言与 AI coding agent 交互进行编程的工作方式
+- [[Vibe-Kanban]]：AI agent 任务看板工具，基于 git worktree 隔离每个任务
+- [[PM2]]：Node.js 进程管理器，提供进程守护、自动重启和开机自启功能
+- [[Git Worktree]]：Git 多工作目录功能，Vibe-Kanban 用其实现任务隔离
+
+## Key Entities
+- [[BloopAI]]：Vibe-Kanban 的开发公司，项目托管于 github.com/BloopAI/vibe-kanban
+
+## Connections
+- [[Vibe Coding]] ← 应用场景 ← [[在Ubuntu上安装Vibe-Kanban]]
+- [[PM2]] ← 进程管理 ← [[在Ubuntu上安装Vibe-Kanban]]
+- [[OpenCode]] ← 互补工具 ← [[Vibe-Kanban]]（同为 supported coding agent）
+
+## Contradictions
+- 无明显冲突内容

wiki/sources/如何传输docker-images-并且在另一个docker安装.md

@@ -0,0 +1,40 @@
+---
+title: "如何传输Docker images 并且在另一个Docker安装"
+type: source
+tags: []
+sources: []
+last_updated: 2026-04-22
+---
+
+## Source File
+- [[Home Office/如何传输Docker images 并且在另一个Docker安装]]
+
+## Summary（用中文描述）
+- 核心主题：Docker 镜像在多台机器之间的离线传输方法
+- 问题域：内网环境或无 Registry 情况下的镜像迁移
+- 方法/机制：三种方案——`docker save/load`（tar 包）、镜像仓库推送拉取、`ctr` 直接复制
+- 结论/价值：提供了完整的离线迁移工具链，适合家庭服务器集群或隔离网络环境
+
+## Key Claims（用中文描述）
+- `docker save` 可将镜像导出为 tar 文件，`docker load` 可在目标机器导入，无需镜像仓库中介
+- `docker push/pull` 适合有镜像仓库（如 Docker Hub、私有 Harbor）的场景
+- `ctr -n k8s.io images import` 可直接导入镜像包，绕过 Docker 工具链
+- 多架构镜像需注意 `--platform` 参数指定平台，避免在不同架构机器间混用
+
+## Key Quotes
+> "把镜像 save 成 tar 包后拷贝到新机器再 load 进去" — 最通用的离线迁移方案，适用于无网络的隔离环境
+
+## Key Concepts
+- [[Docker-Image]]：容器镜像，Docker 应用打包的标准格式
+- [[Docker-Save]]：将镜像导出为 tar 归档文件
+- [[Docker-Load]]：从 tar 文件加载镜像到本地 Docker 引擎
+- [[Docker Registry]]：镜像仓库，用于存储和分发镜像（Docker Hub / Harbor / 私有 Registry）
+
+## Key Entities
+- [[Docker]]：容器化平台，本文档的操作环境
+
+## Connections
+- [[如何在Ubuntu Server安装 Docker & Docker Compose]] ← extends ← [[如何传输Docker images 并且在另一个Docker安装]]
+
+## Contradictions
+- （无已知冲突）

wiki/sources/如何在ubuntu上安装opencode并配置vibe-kanban.md

@@ -0,0 +1,50 @@
+---
+title: "如何在Ubuntu上安装OpenCode并配置Vibe-Kanban"
+type: source
+tags: [opencode, ubuntu, vibe-coding, vibe-kanban]
+date: 2026-04-22
+---
+
+## Source File
+- [[Vibe Coding/如何在Ubuntu上安装opencode并配置Vibe-Kanban.md]]
+
+## Summary（用中文描述）
+- 核心主题：OpenCode AI 编程代理的安装、配置与使用完整指南
+- 问题域：Vibe Coding 开发环境中，如何搭建基于 OpenCode 的终端 AI 编程工作流
+- 方法/机制：通过官方安装脚本一键部署，运行 `/connect` 配置 LLM API Key，运行 `/init` 初始化项目并生成 `AGENTS.md`，通过 Tab 键切换 Plan/Build 模式，使用 `/undo`/`/redo` 撤销重做
+- 结论/价值：OpenCode 提供了一个开源、灵活、支持任意 LLM 提供商的终端 AI 编程代理，可配合 Vibe-Kanban 实现 AI 驱动的看板式项目管理
+
+## Key Claims（用中文描述）
+- OpenCode 通过 `curl -fsSL https://opencode.ai/install | bash` 一键安装
+- OpenCode 支持任意 LLM 提供商，通过 API Key 配置即可使用
+- 运行 `/init` 后 OpenCode 会分析项目结构并自动生成 `AGENTS.md` 文件
+- Plan 模式（Tab 键切换）禁用写入能力，只生成实现计划
+- `/undo` 命令可撤销最近的修改，支持多次连续撤销
+
+## Key Quotes
+> "You should commit your project's AGENTS.md file to Git." — OpenCode 官方建议将 AGENTS.md 纳入版本控制，以帮助 OpenCode 理解项目结构和编码规范
+> "Give OpenCode plenty of context and examples to help it understand what you want." — 使用 OpenCode 时，提供充足上下文和示例能显著提升实现准确性
+> "Drag and drop images into the terminal to add them to the prompt." — OpenCode 支持拖拽图片进行视觉分析和参考
+
+## Key Concepts
+- [[Vibe Coding]]：使用 AI 辅助编程的工作流理念，通过自然语言描述需求，AI 代理负责代码实现
+- [[Plan Mode]]：OpenCode 的计划模式，通过 Tab 键切换，禁用写入只生成实现方案
+- [[AGENTS.md]]：OpenCode 为项目自动生成的角色定义文件，包含项目结构和编码规范，帮助 AI 理解项目上下文
+- [[Build Mode]]：OpenCode 的构建模式，通过 Tab 键从 Plan 模式切换回来，执行实际的代码修改
+
+## Key Entities
+- [[OpenCode]]：开源 AI 编程代理，提供终端界面/桌面应用/IDE 扩展三种使用形态，支持任意 LLM 提供商
+- [[OpenCode Zen]]：OpenCode 官方维护的精选模型列表，经过团队测试和验证，推荐新手使用
+- [[Vibe-Kanban]]：看板式任务管理工具，与 OpenCode 配合实现 AI 驱动的项目管理工作流
+
+## Connections
+- [[如何在ubuntu上安装opencode并配置vibe-kanban]] ← 安装指南 ← [[github-上-5000-人收藏的-vibe-coding-神级指南]]
+- [[OpenCode]] ← 安装与配置 ← [[如何在ubuntu上安装opencode并配置vibe-kanban]]
+- [[Vibe-Kanban]] ← 配置指南 ← [[在ubuntu上安装vibe-kanban]]
+
+## Contradictions
+- 与 [[github-上-5000-人收藏的-vibe-coding-神级指南]]：
+  - 冲突点：Agent 选择与工作流设计
+  - 当前观点：本篇聚焦 OpenCode 单一工具的完整使用流程
+  - 对方观点：综合指南涵盖多种 Agent（Claude Code、Cursor 等）及其协作方式
+  - 结论：两者互补，本篇为工具安装使用指南，对方为 Vibe Coding 理念与多工具对比

wiki/sources/如何在项目里安装claude-code-templates-skills.md

@@ -0,0 +1,41 @@
+---
+title: "如何在项目里安装Claude Code Templates Skills"
+type: source
+tags: [claude-code, claude-skills, trae]
+date: 2026-04-22
+---
+
+## Source File
+- [[Vibe Coding/如何在项目里安装Claude-Code-Templates Skills]]
+
+## Summary（用中文描述）
+- 核心主题：如何在项目目录中通过 npx 命令安装 Claude Code Templates 的 Skills
+- 问题域：Claude Code 增强工具的快速集成方式
+- 方法/机制：使用 `npx claude-code-templates@latest --skill=<path> --yes` 命令直接安装社区维护的 Skills、Agents、MCP 模板
+- 结论/价值：无需手动复制粘贴，通过 npm 一键为 Claude Code 项目注入预设的专业能力模板
+
+## Key Claims（用中文描述）
+- Claude Code Templates 通过 npm 包 `claude-code-templates` 提供可复用的 Skills、Agents、MCP 模板库
+- 开发者进入项目目录后执行一条 npx 命令即可完成安装，无需手动配置
+- Templates 涵盖三个主要分类：Skills（技能）、Agents（代理）、MCP（Model Context Protocol 工具）
+
+## Key Quotes
+> "直接进入项目目录后执行 `npx` 命令" — claude-code-templates 的核心安装方式
+
+## Key Concepts
+- [[Claude Code Templates]]：通过 npm 分发的 Claude Code 增强模板库，包含预配置的 Skills、Agents、MCP 工具
+- [[Claude Code Skills]]：Claude Code 的可复用能力单元，以结构化模板形式封装专业工作流
+- [[MCP（Model Context Protocol）]]：Claude Code Templates 提供的一类模板，用于扩展 AI 的工具调用能力
+
+## Key Entities
+- [[Claude Code]]：Anthropic CLI 编码代理，本文档的目标增强工具
+- [[aitmpl.com]]：Claude Code Templates 的官方模板展示网站，提供 Skills/Agents/MCP 三大类模板浏览
+- [[Trae]]：国产 AI 增强型 IDE，也支持 Claude Code Templates 的集成方式
+
+## Connections
+- [[Claude Code调用方法总结]] ← related_to ← [[如何在项目里安装claude-code-templates-skills]]
+- [[Vibe Coding经验收集]] ← related_to ← [[如何在项目里安装claude-code-templates-skills]]
+- [[3-2-万人收藏的-claude-skills-才是-ai-这条路上最值得研究的一套范式]] ← extends ← [[Claude Code Skills]]
+
+## Contradictions
+- 无已知冲突内容

wiki/sources/开发经验与项目规范整理文档.md

@@ -0,0 +1,62 @@
+---
+title: "开发经验与项目规范整理文档"
+type: source
+tags: [vibe-coding, software-engineering, best-practices, coding-standards]
+sources: []
+last_updated: 2025-12-30
+---
+
+## Source File
+- [[Vibe Coding/开发经验与项目规范整理文档]]
+
+## Summary（用中文描述）
+- 核心主题：Vibe Coding 环境下的开发经验与项目规范最佳实践，涵盖编码规范、系统架构原则、程序设计思想及基础设施（微服务、Redis、消息队列）
+- 问题域：如何建立可持续维护的 AI 辅助开发项目；如何制定团队编码规范；如何通过规范提升 AI 生成的代码质量
+- 方法/机制：
+  - 变量名维护方案（统一变量索引文件）
+  - 文件结构与命名规范（小写英文 + 下划线/小驼峰）
+  - 编码规范（单一职责、DRY、模块化）
+  - 系统架构原则（先梳理架构、小步迭代）
+  - 程序设计核心思想（从问题出发、清晰命名、测试优先）
+  - 微服务拆分原则（独立开发/部署/扩容）
+  - Redis 缓存策略（提升读性能、降低 DB 压力）
+  - 消息队列异步通信（解耦、削峰、异步任务）
+- 结论/价值：为 AI 辅助开发项目提供系统化规范框架，强调从问题出发而非代码出发，提升代码可维护性和团队协作效率
+
+## Key Claims（用中文描述）
+- 统一变量索引文件能降低命名冲突和语义不清晰带来的风险
+- 编码规范中的「消费端 → 生产端 → 状态 → 变换」模型能清晰划分系统行为边界
+- 系统开发应遵循「先理解需求 → 保持简单 → 测试驱动 → 小步迭代」的严谨流程
+- 编程第一步永远是「你要解决什么问题」，而非直接写代码
+- 注释解释「为什么」，而非「怎么做」
+
+## Key Quotes
+> "编程的第一步永远是：你要解决什么问题？" — 从问题出发而非代码
+> "你写的代码是给别人理解的，不是来炫技的。" — 代码可读性优先
+> "注释解释'为什么'，不是'怎么做'。" — 合理注释原则
+> "未测试的代码迟早会出问题。" — 测试优先
+
+## Key Concepts
+- [[单一职责原则]]：每个文件、类、函数应只负责一件事
+- [[DRY原则]]：Don't Repeat Yourself，避免重复代码，提炼公共逻辑
+- [[模块化编程]]：将系统分解为独立模块，提高复用价值
+- [[微服务架构]]：将系统拆解为独立开发、部署、扩容的服务
+- [[Redis缓存]]：作为缓存提升系统读性能，降低数据库压力
+- [[消息队列]]：用于服务之间的异步通信，实现解耦和削峰填谷
+- [[输入-处理-输出模型]]：明确区分消费端（接收数据）、生产端（生成数据）、状态（存储信息）、变换（处理逻辑）
+- [[并发编程]]：区分共享资源、数据竞争、锁机制与异步处理的差异
+
+## Key Entities
+- 无特定实体提及，本文档为方法论文档
+
+## Connections
+- [[Vibe Coding]] ← 相关领域 ← 本文：提供 AI 辅助开发的项目规范框架
+- [[单一职责原则]] ← 编码规范核心 ← [[DRY原则]] ← 模块化基础
+- [[微服务架构]] ← 服务拆分原则 ← [[Redis缓存]] ← 性能优化手段
+- [[消息队列]] ← 异步通信基础设施 ← 微服务间通信机制
+
+## Contradictions
+- 与传统软件开发方法冲突：
+  - 冲突点：传统强调"先理解代码再修改"，本文强调"从问题出发而非代码出发"
+  - 当前观点：Vibe Coding 环境下，AI 生成代码量大，应先明确问题再让 AI 生成，而非逐步理解 AI 生成的代码
+  - 对方观点：传统软件工程强调对代码的深度理解是维护和修改的前提