@lancc/cmark 1.1.0 → 1.2.1

package/CHANGELOG.md

@@ -1,5 +1,32 @@
 # Changelog
 
+## 1.2.1 - 2026-10-28
+
+- 修复 Gitee 一键建仓 / 同步报 403：HTTPS 的用户名原先写死成 `x-access-token`（只有 GitHub 接受这种占位），Gitee 要求用户名必须等于令牌所有者，否则回 `The token username invalid`。现在按远端推断用户名（`gitee.com/<owner>/` 取 owner，其它保持 `x-access-token`），已用旧版本绑过 Gitee 的用户升级后无需重新授权
+- 修复「使用已有仓库」选到空仓库时报「合并远端分支失败」：远端没有任何分支时直接走首次推送，不再先 merge
+- 认证类错误（令牌用户名不匹配、401/403）统一归类，提示改为「令牌无效或用户名不匹配」
+- 修复「工作区变更记录」面板里混入单个文档状态的问题：状态条被整体覆盖后遗留裸 chip，导致全局的「分支 main / 工作区干净」和文档的「路径 / 与最近提交一致」叠在同一行
+- 修复面板已打开时点另一个入口不切换模式，标题、内容与操作按钮停在上一模式
+
+## 1.2.0 - 2026-10-27
+
+同一份产物同时支持 ZTools 与 uTools，宿主自动识别，不再需要分叉维护。
+
+- 新增主题设置：浅色 / 深色 / 跟随系统，主界面、设置面板、Git 面板一起切换
+- 新增一键建仓：GitHub 设备码授权、Gitee 私人令牌，自动创建仓库、绑定远程并推送首次提交
+- 自动适配宿主：`preload/host.js` 在启动最早期识别 `window.utools` / `window.ztools` 并互为别名，宿主晚注入也不会崩
+- 支持 uTools 上架：`plugin.json` 补齐 `homepage` / `platform`，新增 `npm run pack:upx` 产出 uTools 插件包
+- AI 生成适配两个宿主：模型字段归一化（ZTools 用 `value`、uTools 用 `id`），模型列表为空时回退默认模型
+- 手填远程地址支持私有仓库：先免授权探测，需要授权时引导填访问令牌，令牌只存本机
+- 修复 uTools 下 preload 不执行导致设置与 Git 面板打不开（`app/` 就近声明 `type: commonjs`）
+- 修复文档里的裸邮箱、裸网址被写成尖括号或 Markdown 链接，源码不再自动插入转义符
+- 表格：操作栏只在光标位于表格内时出现，滚动吸附不再闪烁；支持直接编辑表格源码；列对齐可持久化
+- 拉取、推送、同步的成败提示改为插件底部浮窗，不再弹 Windows 系统通知
+- 版本回溯的确认提示去掉并不存在的“改动前自动备份”说法
+- 配色抽成设计令牌，深色下侧边栏、编辑区、面板统一，不再出现半深半浅
+- README 补充 npm 与 uTools 安装方式（`@lancc/cmark`）
+- 发布改为 GitHub Actions + npm Trusted Publishing，产物带 provenance 签名
+
 ## 1.1.0 - 2026-10-26
 
 首个公开发布版本。

package/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2026 Lancc
-
-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.
+MIT License
+
+Copyright (c) 2026 Lancc
+
+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.

package/README.md

@@ -2,66 +2,48 @@
 
 Obsidian 的轻量替代。本地 Markdown 笔记，文件是你的，版本用 Git 管，随时能带走。
 
-跑在 [ZTools](https://github.com/ztools) 插件体系里。
-
 <p align="center">
-  <a href="docs/screenshot.png">看一篇覆盖全部语法的笔记，导出成长图的样子</a>
+  <img src="docs/editor-light.png" width="800" alt="CMark 主界面">
 </p>
 
 ## 为什么用它
 
-### 笔记就是文件
-
-磁盘上的 `.md`，没有数据库、没有私有格式、没有云端账号。
-
-用任何编辑器都能打开，用 Git 就能同步、回溯、协作。哪天真不想用了，直接删掉软件，
-笔记一篇不少 —— 这一点从第一行代码起就没打算妥协。
-
-### 版本回溯不用装插件、不用记命令
-
-写完一段发现改坏了，翻开提交历史，点开任意一次提交就是那篇笔记当时的完整内容，
-可以直接照着补回来。
-
-想看具体改了什么，逐行 diff 摆在那儿；只想撤回一个文件的改动也行，不用连带其他。
-整个过程在侧边栏里点几下，不用切终端、不用理解 Git 的分支模型。
-
-### 自动同步到你自己的仓库
+**笔记就是文件。** 磁盘上的 `.md`，没有数据库、没有私有格式、没有云端账号。用任何编辑器都能打开，用 Git 就能同步、回溯、协作。哪天真不想用了，删掉软件，笔记一篇不少 —— 这一点从第一行代码起就没打算妥协。
 
-定时自动提交并推送到 GitHub、Gitee 或自建服务器，配置一次之后就不必再管。
+**版本回溯不用装插件、不用记命令。** 写完一段发现改坏了，翻开提交历史，点开任意一次提交就是那篇笔记当时的完整内容，可以直接照着补回来。想知道具体改了什么，逐行 diff 摆在那儿；只想撤回一个文件的改动也行，不用连带其他。
 
-连续失败会自动暂停并留下原因，不会在后台无声地失败。本地另留一份快照轮转，
-误删也有兜底。
+**自动同步到你自己的仓库。** 定时提交并推送到 GitHub、Gitee 或自建服务器，配置一次之后就不必再管。连续失败会自动暂停并留下原因，不会在后台无声地失败；本地另留一份快照轮转，误删也有兜底。
 
 ## 界面
 
 ### 编辑区
 
-左边是磁盘上的真实目录和当前分支，右边是编辑区，格式工具栏在上方。
+<p align="center">
+  <img src="docs/editor-dark.png" width="800" alt="深色主题下的编辑区">
+</p>
+
+### 公式与代码
 
 <p align="center">
-  <img src="docs/ui-editor.png" width="800" alt="编辑区">
+  <img src="docs/math-dialog.png" width="640" alt="公式编辑弹窗">
 </p>
 
 ### 版本与改动
 
-侧边栏里就能看逐行 diff、撤销单个文件的改动，或者切到提交历史。
-
 <p align="center">
-  <img src="docs/ui-diff.png" width="430" alt="改动对比">
-  <img src="docs/ui-history.png" width="430" alt="提交历史">
+  <img src="docs/git-history.png" width="300" alt="提交历史">
+  <img src="docs/git-diff.png" width="452" alt="改动对比">
 </p>
 
 ### 设置
 
-笔记目录、自动同步、提交选项都在一个面板里。
-
 <p align="center">
-  <img src="docs/ui-settings.png" width="430" alt="设置面板">
+  <img src="docs/settings.png" width="320" alt="设置面板">
 </p>
 
-## 功能对比
+## 功能
 
-### 编辑
+### 编辑与导出
 
 | 能力 | Obsidian | CMark |
 |---|---|---|
@@ -72,9 +54,13 @@ Obsidian 的轻量替代。本地 Markdown 笔记，文件是你的，版本用
 | 数学公式 | ✓ | ✓ 行内与块级，KaTeX |
 | 图表 | 插件支持 | ✓ 内置 mermaid、echarts，编辑区直接渲染 |
 | 任务列表 | ✓ | ✓ |
-| 高亮 / 上下标 | 插件支持 | ✓ `==高亮==` `^上标^` `~下标~` |
+| 高亮 / 上下标 | 插件支持 | ✓ |
 | 图片粘贴 | ✓ | ✓ 自动入库、按内容去重 |
-| 图片缩放 | 插件支持 | ✓ 拖动调整 |
+| 图片缩放 | 插件支持 | ✓ 拖动调整，尺寸写回 Markdown |
+| 导出 PDF | ✓ | ✓ |
+| 导出 HTML | 插件支持 | ✓ 单文件，图片内嵌 |
+| 导出长图 | 插件支持 | ✓ |
+| 导出 Markdown | ✓ | ✓ |
 
 ### 组织与检索
 
@@ -99,52 +85,50 @@ Obsidian 的轻量替代。本地 Markdown 笔记，文件是你的，版本用
 | 历史版本查看 | 插件支持 | ✓ 点任意提交看该版全文 |
 | 差异对比 diff | 插件支持 | ✓ 工作区改动与单次提交都可看 |
 | 自动同步 | 插件支持 | ✓ 定时提交推送，失败自动暂停 |
-| 回收站 | ✓ | ✓ 内置git版本回溯 |
-
-### 导出
-
-| 能力 | Obsidian | CMark |
-|---|---|---|
-| 导出 PDF | ✓ | ✓ |
-| 导出 HTML | 插件支持 | ✓ 单文件，图片内嵌 |
-| 导出长图 | 插件支持 | ✓ |
-| 导出 Markdown | ✓ | ✓ |
+| 回收站 | ✓ | — |
 
 ## 定位
 
 CMark 不跟 Obsidian 抢生态。它只解决一件更窄的事：
 
-手上已经有一堆 Markdown 文件，或者只想用 Git 把它们管起来，不想为此再搭一整套
-工作区、插件市场和同步服务。这类需求下，Obsidian 的那些长处 —— 双链图谱、标签体系、
-上千个插件 —— 用不上，但配置成本照样要付。
+手上已经有一堆 Markdown 文件，或者只想用 Git 把它们管起来，不想为此再搭一整套工作区、插件市场和同步服务。这类需求下，Obsidian 的那些长处 —— 双链图谱、标签体系、上千个插件 —— 用不上，但配置成本照样要付。
 
-所以 CMark 把 Obsidian 里要靠插件才能做到的三件事做成了原生功能：
-表格可视化编辑、图表渲染、Git 版本控制与自动同步。上面标「—」的那些能力
-是有意不做的，换来的是不用建 Vault、不用挑插件、不用理解 Git 命令。
+所以 CMark 把 Obsidian 里要靠插件才能做到的三件事做成了原生功能：表格可视化编辑、图表渲染、Git 版本控制与自动同步。上面标「—」的那些能力是有意不做的，换来的是不用建 Vault、不用挑插件、不用理解 Git 命令。
 
 ## 安装
 
-### 方式一：插件市场（推荐）
+| 渠道 | 适合 | 入口 |
+|---|---|---|
+| npm（推荐） | 想装最新版、不想等审核 | ZTools → 设置 → 已安装插件 → 从 npm 安装 |
+| 插件市场 | 最省事 | ZTools 搜索框输入 `markdown` 或 `cmark` |
+| 离线包 | 内网环境、锁定版本 | Releases 下载 `.zpx` / `.zip` → 导入本地插件 |
+| uTools | 用的是 uTools | uTools 开发者中心 →「导入源码工程」选 `app/plugin.json` |
 
-ZTools 里搜 `markdown` 或 `cmark`，装上即用。
+## 首次使用
 
-### 方式二：离线安装包（GitHub Releases）
+1. 选笔记目录（可以就是你已有的 Markdown 目录）
+2. 建仓库有两种方式：
+   - **一键建仓**（设置 → Git 集成）：GitHub 点「授权建仓」，浏览器里输 8 位码即完成；Gitee 粘一个私人令牌。向导会自动建仓、绑定远程并推送首次提交
+   - 手动：初始化本地仓库后填远程地址（GitHub / Gitee / 自建都行），或者只建本地仓库
+3. 打开「定时提交并推送」，插件会按设定策略自动 commit + push
 
-适合市场审核期间、内网环境，或者想锁定某个版本。
+### 把常用笔记挂成 ZTools 指令
 
-1. 到 [Releases](https://github.com/LanccBy2016/cmark/releases) 下载最新的 `cmark-<版本>.zpx`（或 `.zip`）
-2. 打开 ZTools → 设置 → 插件 → 右上角「更多」→ 导入本地插件
-3. 选中刚下载的文件，确认安全提示后安装
-4. 首次打开会让你选一个笔记目录：选空文件夹即可，选已有 `.md` 的目录也能直接接管
+编辑器工具栏里点「设为全局搜索」后，这篇笔记会注册成 ZTools 的一个指令，指令名就是笔记标题。
 
-两种包内容完全一样，装一个就够：
+- 在 ZTools 搜索框直接输入标题回车，一步打开那篇笔记（不会只停在面板上）
+- 也可以在 ZTools 设置里给它配全局快捷键
+- 再点一次按钮即取消，`.cmark/near.txt` 里记着哪些笔记挂过
 
-- `.zpx` —— asar 的 gzip 压缩包，体积小（约 4 MB）
-- `.zip` —— 解压后就是插件根目录（约 10 MB）
+## 笔记存在哪
 
-两条渠道装的是同一个插件位（插件名相同），后装的会覆盖先装的，**插件数据（配置、历史）保留**。
+笔记就是磁盘上的 `.md` 文件，没有私有格式。`.cmark/` 只存排序、只读标记、图片附件这类元数据，随仓库一起提交。
 
-### 方式三：从源码构建
+图片以内部协议存进 `.cmark/attachments/`，尺寸以 `<img ... width="320">` 写回 Markdown 本身 —— Obsidian / Typora / VS Code 打开同一份文件，看到的大小一致。
+
+卸载插件不会删笔记（笔记在你自己选的目录里）。`~/.cmark-config.json` 记录着笔记目录路径，删掉它等于重新走首次引导。
+
+## 开发与打包
 
 ```bash
 npm install
@@ -161,25 +145,13 @@ node scripts/pack-zpx.mjs        # 产出 release/cmark-<版本>.zpx
 node scripts/pack-zpx.mjs --zip  # 同时产出 .zip
 ```
 
-## 首次使用
-
-1. 选笔记目录（可以就是你已有的 Markdown 目录）
-2. 在左侧「版本控制」里初始化仓库：填远程地址（GitHub / Gitee 都行），或只建本地仓库
-3. 打开「定时提交并推送」，插件会按设定间隔自动 commit + push
-
-笔记就是磁盘上的 `.md` 文件，没有私有格式。`.cmark/` 只存排序、只读标记、图片附件这类元数据，随仓库一起提交。图片尺寸以 `<img ... width="320">` 写回 Markdown 本身，Obsidian / Typora / VS Code 打开同一份文件看到的大小一致。
+给 uTools 打包：
 
-### 把常用笔记挂成 ZTools 指令
-
-编辑器工具栏里点「设为全局搜索」后，这篇笔记会注册成 ZTools 的一个指令，指令名就是笔记标题。
-
-- 在 ZTools 搜索框直接输入标题回车，一步打开那篇笔记（不会只停在面板上）
-- 也可以在 ZTools 设置里给它配全局快捷键
-- 再点一次按钮即取消，`.cmark/near.txt` 里记着哪些笔记挂过
-
-## 卸载
-
-卸载插件不会删笔记（笔记在你自己选的目录里）。`~/.cmark-config.json` 记录着笔记目录路径，删掉它等于重新走首次引导。
+```bash
+npm run build
+node scripts/pack.mjs       # 准备 app/（plugin.json 的 main 指向 index.html）
+npm run pack:upx            # 产出 release/cmark-<版本>.upx
+```
 
 ## 许可
 

package/assets/abnfDiagram-WEYOIA3C-CKV_7Upb.js

@@ -0,0 +1 @@
+import{g as e,r,d as t}from"./chunk-2E7WHVMD-TfbC_dmh.js";import{p as n}from"./chunk-JWPE2WC7-BP2iXBhe.js";import{_ as a,l as s}from"./mermaid-T_6Ze_cT.js";import{M as m,b as o}from"./cynefin-EF2NZ3EQ-CR1E3YiZ.js";import"./markdown-S2mWvoE-.js";var p=o().RailroadAbnf.parser.LangiumParser,i=a(e=>{const r=e.alternatives.map(l);return 1===r.length?r[0]:{type:"choice",alternatives:r}},"transformAlternation"),l=a(e=>{const r=e.elements.map(c);return 1===r.length?r[0]:{type:"sequence",elements:r}},"transformConcatenation"),u=a(e=>{if(e.includes("*")){const[r,t]=e.split("*");return{min:r?parseInt(r,10):0,max:t?parseInt(t,10):1/0}}const r=parseInt(e,10);return{min:r,max:r}},"parseRepeat"),c=a(e=>{const r=f(e.primary);if(!e.repeat)return r;const{min:t,max:n}=u(e.repeat);return 0===t&&1===n?{type:"optional",element:r}:{type:"repetition",element:r,min:t,max:n}},"transformElement"),f=a(e=>{switch(e.$type){case"AbnfStringLiteral":case"AbnfNumVal":return{type:"terminal",value:e.value};case"AbnfRuleName":return{type:"nonterminal",name:e.name};case"AbnfGroup":return i(e.element);case"AbnfOptionalGroup":return{type:"optional",element:i(e.element)};default:throw new Error(`Unsupported ABNF primary node: ${e.$type}`)}},"transformPrimary"),d=a(e=>({name:e.name,definition:i(e.definition)}),"transformRule"),y=a(e=>{n(e,t),e.title&&t.setTitle(e.title),e.rules.map(e=>t.addRule(d(e)))},"populateDb"),g={parser:{parse:a(e=>{t.clear(),s.debug("[ABNF Parser] Starting Langium parse");const r=p.parse(e);if(r.lexerErrors.length>0||r.parserErrors.length>0)throw new m(r);const n=r.value;s.debug("[ABNF Parser] Parsed rules:",n.rules.length),y(n),s.debug("[ABNF Parser] Parse complete")},"parse"),parser:{yy:t}},db:t,renderer:r,styles:e};export{g as diagram};