@bytechain.cn/colamd 1.5.0

package/.github/workflows/release.yml

@@ -0,0 +1,66 @@
+name: Release
+
+on:
+  push:
+    tags:
+      - 'v*'
+  workflow_dispatch:
+
+jobs:
+  build:
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - os: macos-latest
+            platform: mac
+          - os: windows-latest
+            platform: win
+          - os: ubuntu-latest
+            platform: linux
+
+    runs-on: ${{ matrix.os }}
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 20
+
+      - run: npm install
+
+      - run: npm run build
+
+      - name: Build distributables
+        run: npx electron-builder --${{ matrix.platform }} --publish never
+
+      - uses: actions/upload-artifact@v4
+        with:
+          name: dist-${{ matrix.platform }}
+          path: |
+            release/*.dmg
+            release/*.zip
+            release/*.exe
+            release/*.AppImage
+            release/*.deb
+            release/*.yml
+          if-no-files-found: ignore
+
+  release:
+    needs: build
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+
+    steps:
+      - uses: actions/download-artifact@v4
+        with:
+          path: artifacts
+          merge-multiple: true
+
+      - name: Create GitHub Release
+        uses: softprops/action-gh-release@v2
+        with:
+          files: artifacts/*
+          generate_release_notes: true

package/.trae/documents/fix-mermaid-colors-and-sankey.md

@@ -0,0 +1,50 @@
+# Mermaid 配色修复 & Sankey 语法修复计划
+
+## 根因分析
+
+| 问题 | 根因 |
+|------|------|
+| 2.4 状态图配色未跟随 | `getMermaidTheme()` 对自定义主题返回 `'default'`，Mermaid 使用自带的蓝色调色板，`themeVariables` 中的自定义颜色被部分覆盖 |
+| 2.7 饼图配色未跟随 | 同上，`'default'` 主题的 cScale 颜色优先级高于 `themeVariables` 中传入的自定义 cScale |
+| 2.12 四象限图配色未跟随 | 同上，`'default'` 主题对 quadrant chart 使用自带的颜色方案 |
+| 2.13 XY Chart 字偏高 | CSS 中 `.titleText` 和 `.label text` 等选择器统一设置了 `translateY(-3px)`，对 XY Chart 的轴标签和标题来说偏移过大 |
+| 2.15 Sankey 渲染报错 | Mermaid sankey-beta 解析器不支持 CSV 风格的双引号字段格式（`"ColaMD","Math Plugin",35`），解析时把引号当作转义文本导致语法错误 |
+
+## 修复方案
+
+### 1. `mermaid-plugin.ts` — 将自定义主题的 Mermaid theme 从 `'default'` 改为 `'base'`
+
+**文件**: `src/renderer/editor/plugins/mermaid-plugin.ts`
+**函数**: `getMermaidTheme()`
+
+**改动**: 当检测到 `theme-custom` 且非 dark 模式时，返回 `'base'` 而非 `'default'`。
+
+**原因**: 
+- `'default'` 主题自带 Mermaid 官方的蓝绿色调色板，会在渲染时覆盖 `themeVariables` 中的自定义颜色
+- `'base'` 主题完全由 `themeVariables` 控制颜色，不引入 Mermaid 自带的颜色方案
+- `'base'` 主题的 SVG 输出使用 CSS 变量（如 `var(--primary-color)`），我们的 `mermaid-plugin-custom.css` 中 `!important` 规则会正确覆盖
+
+### 2. `mermaid-plugin-custom.css` — 调整 XY Chart 文本垂直偏移
+
+**文件**: `src/renderer/editor/plugins/mermaid-plugin-custom.css`
+
+**改动**: 将全局的 `translateY(-3px)` 缩减为更温和的偏移量，并对 XY Chart 的轴标签单独设置偏移：
+- `.titleText` 的 `translateY` 从 `-3px` 减为 `-1px`（标题不需要大幅偏移）
+- `.xychart .axis text` 设为 `translateY(0)`（轴标签不应偏移）
+
+### 3. `demo.md` — 修复 2.15 Sankey 语法
+
+**文件**: `demo.md`
+
+**改动**: 将 sankey-beta 数据从双引号 CSV 格式改为无引号格式：
+- `"Math Plugin"` → `Math-Plugin`（空格替换为连字符）
+- `"Mermaid Plugin"` → `Mermaid-Plugin`
+- 移除所有双引号包裹
+
+**原因**: 当前 Mermaid 版本的 sankey-beta 解析器不支持带引号的 CSV 字段。
+
+## 影响范围
+
+- 仅影响使用 `theme-custom` 类的自定义主题的 Mermaid 渲染
+- 内置主题（dark、elegant、newsprint、default）不受影响
+- 其他 Mermaid 图表类型（时序图、流程图、甘特图等）的配色也会因为 `theme: 'base'` 而更准确地反映自定义主题变量

package/CLAUDE.md

@@ -0,0 +1,87 @@
+# ColaMD
+
+## 产品定位
+
+**Markdown as Database 的原生编辑器与模板渲染平台。**
+
+### 解决的核心问题
+
+HTML 难改——结构、样式、内容全混在一起，人改麻烦，Agent 改也要理解整个文件。
+
+解法：把内容从 HTML 里剥离出来，放进 markdown。HTML 变成纯模板，markdown 变成数据库。改内容只改 markdown，完全不碰 HTML。
+
+### 战略方向
+
+- **内容层**：`.md` 文件，字段固定，人和 Agent 都能轻松编辑
+- **模板层**：各种 HTML 模板（PPT、游戏化界面、博客、简历、产品落地页……）
+- **ColaMD**：连接两者的工具，也是这个生态的入口
+
+一份 markdown，多种渲染形态。未来第三方可以基于同一份 markdown 做自己的模板。
+
+### 核心理念：Markdown as Database
+
+Markdown 不只是文档，而是**结构化内容的数据源**。
+
+- **Markdown = 数据**：用固定字段（frontmatter + 约定的 section 结构）承载内容，Agent 只需按字段改内容
+- **HTML 模板 = 视图**：模板负责样式、动效、交互，不关心内容
+- **解耦**：换模板就是换皮，换内容不影响模板
+- **简单约定优先**：宁可让 markdown 字段固定一些，也不要让模板去猜语义
+
+## 设计哲学
+
+### 如非必要，勿增实体
+
+这是 ColaMD 的第一原则。每增加一个 UI 元素、一个功能、一行代码，都要问：这是绝对必要的吗？默认答案是否。
+
+- 不要工具栏（用户会用快捷键和 Markdown 语法）
+- 不要侧边栏
+- 不要状态栏
+- 界面只有：标题栏（拖拽用）+ 编辑器
+- 追求极致的简单，一个功能做到极致
+
+### 核心功能优先级
+
+1. **文件热更新**（核心卖点）— 外部 Agent 修改 .md 时自动刷新，实时看到 Agent 的工作
+2. **所见即所得** — 输入 Markdown 即刻渲染为富文本
+3. **主题系统** — CSS 主题，可导入自定义主题
+4. **导出** — PDF、HTML
+
+### 不做的事情
+
+- 不做文件管理、文件树、工作区
+- 不做知识库管理
+- 不做云同步、协作编辑
+- 不做笔记组织和标签系统
+- 不加不必要的 UI 元素（工具栏、侧边栏等）
+
+## 技术栈
+
+- Electron（桌面跨平台）
+- Milkdown（基于 ProseMirror 的 WYSIWYG Markdown 框架）
+- TypeScript 严格模式
+- electron-vite（构建）
+- electron-builder（打包）
+
+## 项目结构
+
+```
+src/
+├── main/           # Electron 主进程
+│   └── index.ts    # 窗口管理、文件 I/O、菜单、文件监听
+├── preload/        # 安全 IPC 桥接
+│   └── index.ts
+└── renderer/       # 渲染进程
+    ├── index.html
+    ├── main.ts     # 入口，连接编辑器和 IPC
+    ├── editor/     # Milkdown 编辑器核心
+    ├── themes/     # CSS 主题 + 主题管理器
+    └── env.d.ts
+```
+
+## 开发规范
+
+- TypeScript 严格模式
+- 编辑器核心与 UI 解耦
+- 主题 CSS 与编辑器逻辑完全分离
+- 代码简洁，不过度设计
+- 每个新功能先问：这是必要的吗？

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 marswave.ai
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.