# csm-vsc-extension

**Repository Path**: NEVSTOP-LAB/csm-vsc-extension

## Basic Information

- **Project Name**: csm-vsc-extension
- **Description**: 为 CSM 提供 Visual Studio Code 支持的插件
- **Primary Language**: Unknown
- **License**: AGPL-3.0
- **Default Branch**: main
- **Homepage**: https://marketplace.visualstudio.com/items?itemName=NEVSTOP-LAB.csm-vsc-support
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 1
- **Created**: 2026-04-24
- **Last Updated**: 2026-06-19

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Communicable State Machine(CSM) VSCode 支持

> 为 CSM 相关文件提供 Visual Studio Code 编辑器支持的插件。

## 安装要求

- Visual Studio Code 1.63.0 或更高版本

## 功能概览

| 功能 | 说明 |
|---|---|
| `.csmlog` 日志支持 | 语法高亮、Hover 悬停提示、Outline 大纲、**智能重复折叠**、自动编码识别 |
| `.lvcsm` 配置文件支持 | 语法高亮、Outline 大纲、自动编码识别 |
| `CSM Modules` 模块管理 | 侧边栏浏览、搜索、引入、更新、移除 CSM 模块，支持 GitHub 登录与批量操作 |
| 文件装饰 (File Decorations) | 为 `.csmlog` (C) 与 `.lvcsm` (L) 添加 Badge 标记，可与任意图标主题共存 |
| 本地化 | 中文 / 英文界面切换 |

## 快速入口

- 打开任意 `.csmlog` 或 `.lvcsm` 文件即可自动激活扩展功能
- `.csmlog` 文件中的重复日志行会自动检测并折叠，可配置阈值与样式
- 打开侧边栏 **CSM Modules** 视图即可浏览和管理模块
- 扩展自动为 `.csmlog` / `.lvcsm` 文件添加 Badge 标记，无需手动设置

## 扩展设置

| 设置项 | 默认值 | 说明 |
|---|---|---|
| `csmModules.defaultModuleRoot` | `csm` | 首次引入模块时预填的默认目录名 |
| `csmModules.hiddenTopics` | `csm-modsets`, `lv-csm-app`, `labview-csm`, `labview` | 侧边栏中默认隐藏的 topic |
| `csmlog.folding.minRepeatCount` | `3` | 最少连续重复几次触发折叠 |
| `csmlog.folding.maxBlockLines` | `20` | 多行块匹配的最大行数 |
| `csmlog.folding.smartParams` | `true` | 启用参数归一化，消息模板相同仅参数不同的行也折叠 |
| `csmlog.folding.decorationStyle` | `compact` | 折叠概要标签样式（compact: ×42 / detailed: 含时间） |

## 更多文档

- 使用说明：[`docs/user-guide.md`](docs/user-guide.md)
- 模块管理详解：[`docs/module-management.md`](docs/module-management.md)
- 开发者快速上手：[`docs/quickstart.md`](docs/quickstart.md)
- 参与贡献：[`CONTRIBUTING.md`](CONTRIBUTING.md)