DM Dev Assist

扩展简介

DM Dev Assist (原名 DM Green Apple) 是一款专为 DM 项目开发人员设计的 VSCode 扩展，提供了一系列实用工具，帮助开发者提高工作效率。主要功能包括文本处理、HTML 预览、书签管理等，能够有效简化日常开发中的重复性工作。

✨ 主要功能

1️⃣ 书签管理系统

功能概述

• 📌 强大的代码书签功能，帮助您快速在项目中导航
• 📁 支持创建分组，整理和管理不同类别的书签
• 🔍 多种排序方式，便于查找和管理书签
• 🚀 提供快捷键和右键菜单，操作便捷高效

详细功能

添加书签

• 快捷键: Cmd+Alt+B (Mac) / Ctrl+Alt+B (Windows/Linux)
• 在光标所在位置添加书签
• 支持自定义书签名称
• 自动记录添加时间，便于后续排序

书签分组管理

• 创建多个书签分组，对书签进行分类
• 支持重命名和删除分组
• 分组显示书签数量统计
• 自动按字母顺序排列分组

书签排序

• 按名称排序: 字母顺序排列书签，便于按名称查找
• 按文件路径排序: 按文件所在位置组织书签，适合项目结构导航
• 按添加时间排序: 保持书签的添加顺序，查看最近添加的书签

书签操作

• 右键菜单支持添加、删除、重命名书签
• 快速跳转到书签位置: Cmd+Shift+B (Mac) / Ctrl+Shift+B (Windows/Linux)
• 悬停提示显示书签详细信息（文件路径、行号、添加时间等）

视图位置

• 在 DM Dev Assist 侧边栏查看书签
• 在资源管理器侧边栏查看书签（方便访问）
• 通过 VSCode 命令面板快速访问书签功能

2️⃣ HTML 实时预览

功能概述

• 🖥️ 实时预览 HTML 文件渲染效果
• 📱 同时支持桌面端和移动端视图切换
• 🔍 点击预览元素定位到源代码位置
• 🔄 编辑器变更实时同步到预览

详细功能

预览面板

• 右键菜单或命令面板启动 HTML 预览
• 支持在同一窗口打开多个预览实例
• 预览窗口自动跟随编辑器焦点切换

视图模式切换

• 桌面视图: 显示 desktop-container 的内容
• 移动视图: 显示 mobile-container 的内容
• 顶部工具栏快速切换视图模式

元素定位

• 点击预览中的元素自动定位到源代码
• 支持复杂嵌套元素的精确定位
• 高亮显示选中的 HTML 元素

自动同步

• 编辑变更后自动刷新预览，无需手动操作
• 保持滚动位置，便于对比修改前后效果
• 实时渲染样式和基本交互效果

3️⃣ 文本处理工具

国家代码替换

功能概述

• 🌏 快速替换文件中的国家/地区代码变量
• 🛠️ 支持多种地区代码选择 (CN/TW/MO/HK)
• 📊 操作完成后显示替换统计信息

详细使用方法

1. 打开需要处理的文件（通常是 clicks.txt）
2. 执行命令 clicks.txt文件替换国家代码
   • 通过命令面板: Ctrl+Shift+P → 输入 "dtool" → 选择命令（也可以在这里直接设置键盘快捷键方便以后使用～）
   • 或使用 DM Dev Assist 侧边栏中的按钮，点击一个即可
3. 从弹出菜单选择目标国家/地区代码
4. 确认后自动完成替换，并显示替换数量

技术细节

• 将 ${customer.custom.output_country} 替换为选定的国家代码
• 支持撤销操作 (Ctrl+Z)，可恢复原始内容

文本格式化

功能概述

• 📝 智能合并多行文本为一行文本
• 🧠 自动识别并保留特殊格式和变量
• 🔤 优化文本排版，提高可读性

详细使用方法

1. 打开需要格式化的文本文件（通常是 index.txt）
2. 执行命令 index.txt格式化文本（合并多行）
   • 通过命令面板: Ctrl+Shift+P → 输入 "dtool" → 选择命令（也可以在这里直接设置键盘快捷键方便以后使用～）
   • 或使用 DM Dev Assist 侧边栏中的按钮，点击一个即可
3. 自动完成格式化，并显示处理结果

格式化规则

• 段落合并: 连续的文本行智能合并为单行
• 空行保留: 空行被视为段落分隔符，予以保留
• 分隔线保护: 连续的破折号等分隔线不会被合并
• 特殊内容保护:
  • 包含 ${clicks.get 的行保持原样
  • 包含 ${global 的行保持原样
  • 保护模板变量和代码片段不被错误合并
• 排版优化:
  • 英文单词、数字与中文之间自动添加空格
  • 标点符号格式统一处理
  • 移除多余空格和制表符

样式替换

功能概述

• 🔗 专门针对 desktop-container 中的链接样式
• 🎨 移除 !important 标记，恢复链接下划线样式，只针对CN语言
• 🔍 智能识别和排除按钮等特殊元素

详细使用方法

1. 打开需要处理的 HTML 文件
2. 执行命令 cn替换desktop端恢复a链接下划线
   • 通过命令面板: Ctrl+Shift+P → 输入 "dtool" → 选择命令（也可以在这里直接设置键盘快捷键方便以后使用～）
   • 或使用 DM Dev Assist 侧边栏中的按钮，点击一个即可
3. 自动完成样式替换，并显示处理统计

技术细节

• 仅处理 desktop-container 元素内的样式
• 将 text-decoration: none !important 替换为 text-decoration: none
• 自动跳过含 "btn" 类名的元素（按钮样式保持不变）
• 支持复杂的 HTML 和 CSS 结构

4️⃣ 替换方案管理

功能概述

• 📋 创建和管理可重复使用的文本替换方案
• 🔄 支持普通文本和正则表达式替换
• 📊 显示替换统计信息和替换前后对比
• 🔍 Explorer视图中快速访问替换方案

详细功能

创建替换方案

• 支持自定义替换方案名称
• 可添加多个替换模式到一个方案中
• 每个替换模式可选择使用普通文本或正则表达式
• 简洁直观的创建界面

应用替换方案

• 快捷键: Ctrl+Alt+R (Windows/Linux) / Cmd+Alt+R (Mac)
• 在编辑器右键菜单中直接应用替换方案
• 从替换方案列表中选择需要应用的方案
• 支持HTML和普通文本文件

替换统计和对比

• 执行替换后显示匹配的内容数量
• 查看详细统计，了解每个模式的匹配情况
• 支持替换前后的差异对比，直观查看变更

管理替换方案

• 编辑已有的替换方案
• 删除不再需要的替换方案
• 在Explorer视图和专用侧边栏中访问替换方案

使用场景

• 批量处理重复性的文本替换任务
• 保存频繁使用的替换规则
• 标准化文本格式和内容
• 代码重构和文本清理

🛠️ 安装指南

从 VSCode 插件市场安装（推荐）

1. 打开 VSCode
2. 转到扩展视图（Ctrl+Shift+X 或点击左侧活动栏的扩展图标）
3. 搜索 "DM Dev Assist" 或 "ivanchenyang99.dm-vscode-tools"
4. 点击"安装"按钮

从 VSIX 文件安装

1. 从 GitHub Releases 下载最新的 .vsix 文件
2. 打开 VSCode
3. 转到扩展视图（Ctrl+Shift+X 或点击左侧活动栏的扩展图标）
4. 点击右上角 "..." → "从 VSIX 安装..."
5. 选择下载的 .vsix 文件并确认安装

从源码构建安装

1. 克隆项目代码

   git clone https://github.com/cheny0215/dtool.git
   cd dtool
   

2. 安装依赖并构建

   npm install
   npm run package
   

3. 从构建的 .vsix 文件安装

⌨️ 快捷键

功能	Windows / Linux	Mac
添加书签	Ctrl+Alt+B	Cmd+Alt+B
查看书签	Ctrl+Shift+B	Cmd+Shift+B
应用替换方案	Ctrl+Alt+R	Cmd+Alt+R
打开命令面板	Ctrl+Shift+P	Cmd+Shift+P

👀 使用视图

DM Dev Assist 提供了三个主要视图：

1. DM工具: 包含所有文本处理工具和HTML预览功能
2. 书签管理: 显示所有书签分组和书签列表
3. 替换方案: 管理可重用的文本替换规则

这些视图既可以在专用侧边栏中访问，也可以在资源管理器侧边栏中找到。

🔧 配置选项

目前本扩展无需特殊配置，即安装即可使用。未来版本将添加更多自定义选项。

💫 版本历史

详细的版本历史请查看 CHANGELOG.md 文件。

🤝 贡献指南

我们欢迎各种形式的贡献，包括但不限于功能请求、问题报告、文档改进和代码贡献。

提交问题

1. 访问 GitHub Issues
2. 点击 "New Issue"
3. 选择相应的问题模板
4. 填写详细信息并提交

贡献代码

1. Fork 仓库
2. 创建您的特性分支 (git checkout -b feature/amazing-feature)
3. 提交您的更改 (git commit -m 'Add some amazing feature')
4. 推送到分支 (git push origin feature/amazing-feature)
5. 创建一个新的 Pull Request

📄 许可证

此项目采用 MIT 许可证 - 详情请参阅 LICENSE 文件。

📞 联系方式

• 作者: Ivan
• 邮箱: ivanchenyang99@gmail.com
• GitHub: https://github.com/cheny0215/dtool

致谢

感谢所有贡献者和测试者为本项目提供的宝贵反馈和建议。