# vscode-extension

**Repository Path**: yanxxit/vscode-extension

## Basic Information

- **Project Name**: vscode-extension
- **Description**: vscode-extension 插件
- **Primary Language**: JavaScript
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-05-28
- **Last Updated**: 2026-07-06

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# trae-plugin 插件

Trae CN / VS Code 本地插件集合。所有打包产物统一输出到仓库根级 [packages/](file:///Users/bytedance/github/vscode-extension/packages)。

1. test1
2. test2
3. test3
4. test4

## 插件清单

| 插件 | 版本 | 功能简介 |
| --- | --- | --- |
| [md-preview-web](file:///Users/bytedance/github/vscode-extension/md-preview-web) | `0.5.9` | 把 Markdown 渲染成精美 HTML，在系统浏览器打开；支持 Mermaid / KaTeX / TOC / SRI / 离线模式 / CSV 自动转表 / 本地文件嵌入 / 导出 MD / 扁平化为普通 MD |
| [file-history-menu](file:///Users/bytedance/github/vscode-extension/file-history-menu) | `0.0.1` | 在编辑器/资源管理器右键菜单提供「查看文件历史」（打开 VS Code Timeline） |
| [path-resolve-jump](file:///Users/bytedance/github/vscode-extension/path-resolve-jump) | `0.0.3` | 识别 `path.resolve(__dirname, '...')` 调用，提供 ⌘ + 点击跳转能力 |
| [html-to-md](file:///Users/bytedance/github/vscode-extension/html-to-md) | `0.1.0` | HTML → Markdown：当前文件 / 选中片段 / 剪贴板 / URL 抓取四种入口，零依赖纯本地实现 |

---

## md-preview-web

把当前 Markdown 文件渲染成 HTML 并在系统浏览器打开。

### 主要特性

- 浏览器端渲染：marked / highlight.js / mermaid / KaTeX / github-markdown-css
- **安全加固**：CDN 资源使用 SRI（sha384）+ `crossorigin`（仅 http(s)）；mermaid `securityLevel: 'strict'`；slug 防 XSS
- **离线模式**：`useCDN = auto | always | never`，资源缓存到 `~/.cache/md-preview-web/assets/`
- **CSV 自动转表**：` ```csv-to-table` / ` ```csv-to-md` 围栏在浏览器中渲染为 GFM 表格（支持 RFC4180 双引号转义、字段内换行）
- **本地文件嵌入**：`![](xxx.md|json|js|...)` 自动展开为带语法高亮的代码围栏（>1 MB 自动跳过）
- **导出 MD**：浏览器顶栏 `📥 MD` 按钮一键下载源文件
- **扁平化命令**：右键 `Markdown: 转换为普通 Markdown（展开嵌入与 CSV 块）` → 生成 `*.flat.md`
- **TOC 联动**：基于 IntersectionObserver 自动高亮当前章节
- **临时文件治理**：md5 路径哈希命名，24h TTL 自动清理

### 命令 / 快捷键

| 命令 | 触发方式 |
| --- | --- |
| `Markdown: Open in Browser` | `Ctrl + Alt + B` 或编辑器右键 |
| `Markdown: 转换为普通 Markdown` | 编辑器/资源管理器/标签页右键 |

### 打包与安装

```bash
cd md-preview-web
npm run package
"/Applications/Trae CN.app/Contents/Resources/app/bin/trae-cn" --install-extension ../packages/md-preview-web-0.5.9.vsix --force
```

VS Code 安装方式相同，把 CLI 路径替换为：

```bash
"/Applications/Visual Studio Code.app/Contents/Resources/app/bin/code" --install-extension ../packages/md-preview-web-0.5.9.vsix --force
```

---

## file-history-menu

在编辑器、资源管理器、标签页右键菜单中加入 **「查看文件历史」**，等价于打开 VS Code 内置 Timeline 视图。

### 打包与安装

```bash
cd file-history-menu
npx --yes @vscode/vsce package --out ../packages/ --allow-missing-repository
"/Applications/Trae CN.app/Contents/Resources/app/bin/trae-cn" --install-extension ../packages/file-history-menu-0.0.1.vsix --force
```

---

## html-to-md

把 HTML 网页 / 代码 / URL 转换为 Markdown。零依赖，自带轻量解析器。

### 命令

| 命令 | 入口 |
| --- | --- |
| `HTML → Markdown：转换当前文件` | `.html/.htm` 右键 → 输出同目录 `.md` |
| `HTML → Markdown：转换选中内容` | 编辑器选区 → 新建未命名 .md |
| `HTML → Markdown：从剪贴板转换` | 命令面板 |
| `HTML → Markdown：从 URL 抓取并转换` | 命令面板 → 输入 URL |

### 打包与安装

```bash
cd html-to-md
npm run package
"/Applications/Trae CN.app/Contents/Resources/app/bin/trae-cn" --install-extension ../packages/html-to-md-0.1.0.vsix --force
```

---

## path-resolve-jump

识别 JS/TS 源码中的 `path.resolve(__dirname, '...')` 调用并提供 ⌘ + 点击跳转能力。

### 打包与安装

```bash
cd path-resolve-jump
npx --yes @vscode/vsce package --out ../packages/ --allow-missing-repository --skip-license
"/Applications/Trae CN.app/Contents/Resources/app/bin/trae-cn" --install-extension ../packages/path-resolve-jump-0.0.3.vsix --force
```

---

## 通用约定

- **打包产物**：统一输出到 [`packages/`](file:///Users/bytedance/github/vscode-extension/packages)（仓库根目录同级），可在 IDE 中直接右键安装。
- **图标**：每个插件 `media/icon.{svg,png}`，PNG 为 128×128，注册在 `package.json -> icon`；SVG 为源文件，已通过 `.vscodeignore` 排除避免冗余打包。
- **重新打包流程**：修改 `version` → 在插件目录执行 `npm run package` 或 `npx @vscode/vsce package` → 用 IDE CLI `--install-extension` 强制覆盖安装。
- **生效**：安装完成后在 Trae CN / VS Code 中执行 `Developer: Reload Window` 生效。