YK Snidea - 网页版 AI 对话开发者的福音

YK Snidea 是一款由 广西云科互动科技有限公司 开发的 VS Code 插件。它的诞生是为了解决当今 AI 辅助编程生态中的一个痛点：在面对高额的 API Token 翻译计费、严格的地区网络限制，以及强绑定的特定开发软件（如 Cursor）时，如何低成本且高效地利用顶尖大模型？

本插件通过精准提取本地代码和数据库上下文，为你一键拼装高质量的提示词（Prompt），让你直接在网页端（如 ChatGPT, Claude, DeepSeek）即可获得媲美专业 AI IDE 的深度开发体验。

🌟 核心理念

相比于动辄消耗海量且昂贵 API 额度的全自动开发模式，许多开发者更倾向于购买实惠的网页端 Pro 会员。然而，网页端大模型天然缺乏对本地工作区代码和数据库结构的“全局感知”。

YK Snidea 完美填补了这一空白：它作为一个高效的本地上下文拼装器，能将复杂的项目背景转化为 AI 能够理解的结构化数据。我们严格遵循 Early Return (无 else) 代码规范，确保插件运行的高性能与逻辑清晰度。

✨ 主要功能

• 🎭 角色预览化管理：支持自定义 AI 角色（System Prompt），主界面选择角色后可立即预览角色设定的详细内容。
• 🔗 深度上下文关联：
  • 使用 @：模糊搜索并读取源码。支持同名文件自动路径区分，排序算法自动将隐藏文件（.开头）置后。
  • 使用 #：自动检索 MySQL 表结构。悬浮可预览表 DDL 信息，自动注入 SQL 结构。
  • 🌳 结构感知：支持一键生成项目文件树。通过工作区 .ykide/.yktree 配置过滤规则（语法同 .gitignore），精准控制上下文长度。
• 🚀 自动化代码应用 (Diff/Replace)：
  • 工业级状态机引擎：基于逐行状态机解析架构，彻底根除正则匹配在复杂、超长代码下的崩溃风险。
  • 滑动窗口语义对齐：引入专业级模糊匹配算法。即便 AI 产生“翻译幻觉”或排版错位，系统仍能通过提取语义特征（Token）实现精准定位。
  • 60% 高容错修复：只要核心逻辑吻合度超过 60%，系统即可自动修正 AI 的小瑕疵并强制应用更新。
• 🌳 模块化开发规范 (Profile)：
  • 原子规则池：支持按技术栈前缀（如 [vue], [php]）对规则进行分组管理。
  • 树形交互：采用 Element Plus 树形控件，支持分类展开收起、一键全选/反选/取消全选。
  • 动态微调：在生成前，可基于合集快速手动增减特定的原子规则，灵活应对不同任务。
• 💾 数据备份与存档：
  • 配置导出：一键将全局 Role/Rule/Profile 配置导出至工作区 .ykide/ 目录。
  • Prompt 存为 MD：生成的历史 Prompt 可保存为本地 Markdown 文件，方便回溯。

🛠️ 使用指南

1. 初始化：在侧边栏点击图标打开 YK Snidea。
2. 连数据库：在“数据库”选项卡配置连接，信息将保存在本地 .ykide/db-config.json。
3. 设规范：在“全局设置”中定义你的原子规则，并将其组合成特定场景的“开发合集”。
4. 写需求：在输入框通过 @ 引用代码，用 # 引用表结构。
5. 拿结果：点击“生成提示词”，复制到网页端大模型，开启高效对话。

📅 版本记录

1.0.8 (2026-03-31)

• 🛡️ 鲁棒性飞跃：智能降级与幂等防护：
  • 自动降级创建：解决 AI 因不确定文件是否存在而产生的逻辑犹豫。现在 action="replace" 在目标路径缺失时会自动触发目录递归创建并生成文件。
  • 幂等性防护 (Pre-check)：引入替换前置校验。若 SEARCH 与 REPLACE 一致，或目标代码已被应用，系统将智能跳过，彻底杜绝重复替换引发的代码堆叠 Bug。
  • 架构纯净化：核心 XmlService 达成全量 Early Return 规范，消灭所有 else 分支，代码质朴易读。

1.0.7 (2026-03-30)

• 💎 解析引擎 5.5：滑动窗口语义对齐算法落地：
  • 架构飞跃：抛弃传统正则，改用工业级逐行状态机。完美解决代码内容中包含 </file_change> 标签导致的解析自吞噬问题。
  • NLP 级容错：新增滑动窗口算法。即使 AI 将英文注释误翻为中文，或增减了符号空格，系统依然能通过语义相似度（Token Matching）锁定目标。
  • 精准物理替换：采用行号切片（Physical Splicing）技术，杜绝 replace 算法对同名代码块的误伤，定位精度达行级。

1.0.6 (2026-03-29)

• 🚀 XML 解析引擎与交互权重增强：
  • 权重级 UI 调整：重构解析按钮布局，显著提升“解析 XML”按钮的视觉权重与交互响应，将其定位为核心更新协议。
  • 语义化精准表达：将原有的“应用”统一更名为“解析”，更准确地描述从剪贴板提取、校验并执行代码更新的逻辑过程。
  • 增强型错误诊断：当 XML 中的 SEARCH 块匹配失败时，日志面板将完整打印出待匹配的代码内容，彻底解决“路径对但内容对不上”时难以排查的问题。
• 🛠️ 工程化规范深度重构：
  • 全量 Early Return 落地：对 XmlService 与 ConfigService 进行了底层重构，消灭了所有 else 分支及不符合规范的单行 if 块。
  • 性能与稳定性：通过更严苛的括号强制规范（curly）修复了潜在的逻辑歧义，提升了插件在大规模配置读取时的稳定性。

1.0.5 (2026-03-28)

• 🌳 规则交互重构与上下文感知：
  • 双栏规则树布局：主界面规则选择器重构为双栏设计。左侧“智能推荐”默认展开相关技术栈规则，右侧“完整库”默认折叠，极大提升了在大规模规则库下的选取效率。
  • 后缀感知推荐：左侧树支持根据编辑器中已提及文件的后缀（如 .vue, .php）动态高亮或显示关联规则，实现智能化上下文匹配。
  • UI 体验增强：操作按钮引入 Iconify 图标，支持长规则自动换行显示，彻底解决文字截断问题。
• ⚙️ 配置重置与搜索优化：
  • 一键恢复默认：在 Diff 和 JSON 配置面板新增“重置配置”功能，支持快速恢复系统预设提示词。
  • 文件路径显性化：编辑器中的 @ 标签现在显示文件的相对路径而非仅文件名，有效避免同名文件带来的混淆。
  • 检索权重优化：改进文件搜索排序，自动降级以 . 或 _ 开头的配置文件，确保核心业务代码优先展示。

1.0.4 (2026-03-28)

• ⚡ 多格式代码应用机制：
  • JSON 结构化解析支持：新增对 AI 返回的专属 JSON 格式代码块的深度解析与替换能力。规避了复杂文本格式引发的识别异常。
  • 服务解耦重构：将原有的代码应用功能从通用文件服务中剥离，新建独立的 DiffService 和 JsonService，实现基于单一职责的工程化架构。
  • 动态 Prompt 生成：引擎现可根据用户的格式偏好，智能下发匹配当前剪贴板解析器的 System Prompt，杜绝上下文污染。

1.0.3 (2026-03-26)

• ⚡ 核心引擎进化：代码替换与文件树：
  • Diff 自动化应用：新增剪贴板解析功能。支持网页端特殊字符清洗（自动处理 NBSP/\u00A0）、模糊匹配算法（容忍手动修改导致的微小空格/缩进差异）以及 PHP 变量符号（$）的安全替换。
  • 智能文件创建：若 AI 返回的 SEARCH 块为空，插件将递归创建不存在的目录并生成新文件。
  • 文件树系统 (yktree)：新增“附带文件树”选项。支持通过 .ykide/.yktree 配置过滤规则，并采用“智能折叠”算法防止上下文溢出。
• ⚙️ 配置与工程化优化：
  • 一键初始化：新增 init.json 机制。插件安装后自动载入行业最佳实践的 AI 角色与 Diff 提示词配置。
  • 配置无缝迁移：支持 Roles/Rules/Profiles 的全量导入与导出，方便在团队间同步开发规范。
  • 文件排序优化：搜索结果现在会自动将 . 开头的隐藏文件或配置文件（如 .env, .gitignore）排在末尾，优先展示核心业务逻辑。
• 🛠️ 代码质量提升：
  • 架构重构：底层消息总线升级为 switch-case 路由模式，将 Diff 逻辑从路由层剥离至 Service 层，符合单一职责原则。
  • 严苛规范落地：全量消灭了 else 关键字，所有逻辑块严格补全 if 大括号，消除 ESLint 隐患。

1.0.2 (2026-03-23)

• 🎨 UI 架构模块化重构：
  • 引入 Element Plus 树形控件重新设计规范选择器，支持分类折叠与父子联动勾选。
  • 采用选项卡（Tabs）模式重构设置面板，大幅提升小空间下的操作流利度。
  • 全面换用 @iconify/vue 官方组件，彻底解决 VS Code 侧边栏图标渲染不稳定的问题。
• ⚡ 核心逻辑增强：
  • 角色内容实时预览：在主表单选择 AI 角色后，下方自动展示其具体的 Prompt 设定。
  • 规则批量操作：主界面新增“全选、反选、取消全选”功能，支持基于原子规则的自由组合。
  • 悬浮上下文提示：编辑器内 @ 和 # 标签支持 Hover 提示，鼠标悬停即可查看文件路径或表结构说明。
• 🐞 已知 Bug 修复：
  • 样式挤压修复：重写了 Checkbox 与 Tree 容器的 CSS，解决了在不同 VS Code 主题下复选框边框“隐身”以及文字被图标挤压的问题。
  • Tiptap 样式隔离：禁用 Tiptap 默认的 Markdown 快捷转换（如输入 "1. " 触发列表），防止 ::marker 样式打破插件布局。
  • 导出功能修复：重构了 exportSettings 通信逻辑，确保配置备份指令 100% 直达后端。

1.0.1 (2026-03-22)

• 🚀 编辑器架构全面升级：引入 Tiptap (ProseMirror) 引擎，解决撤销/重做 (Ctrl+Z) 历史栈问题。
• 🛡️ 智能粘贴与样式隔离：优化粘贴逻辑，外部复制内容自动安全转义，防止编辑器样式污染。

1.0.0 (2026-03-20)

• 🎉 初始版本正式发布！支持全量 Role/Rule/Profile 配置管理及工作区数据库关联。

作者：云天 出品：广西云科互动科技有限公司