Guide document checks and local verification workflows

README.md

@@ -8,6 +8,9 @@
 
 [在线检查 SKILL.md](https://chumaniac.github.io/skillsync/) · [English / CLI reference](README.en.md) · [桌面下载](https://github.com/Chumaniac/skillsync/releases/tag/user-2026.11.11-zh)
 
+
+在线页的“第一次检查”从示例文档走到解析结果。本机工作台的页内引导分别定位单份核验、批量计划与历史记录；切换入口不会自动运行检查或批准修复。
+
 ## 快速开始
 
 CLI 支持 Node.js 20 及以上版本。下面使用 Node.js 24 和 npm，在示例目录做一次只读检查。桌面打包所需的运行时见[构建说明](docs/build.md)。

browser/index.html

@@ -4,7 +4,8 @@
 <meta http-equiv="Content-Security-Policy" content="default-src 'self'; script-src 'self'; style-src 'self'; connect-src 'none'; img-src 'self' data:; base-uri 'none'; form-action 'none'">
 <link rel="icon" href="./skillsync.svg"><link rel="stylesheet" href="./style.css"><title>Skill 文档检查 · SkillSync</title></head>
 <body><header><img src="./skillsync.svg" width="34" height="34" alt=""><strong>SkillSync</strong><a href="https://github.com/Chumaniac/skillsync">本机目录核验 ↗</a></header>
-<a class="skip-link" href="#workspace">跳到文档编辑</a><main id="workspace"><div class="workspace-heading"><div><p class="eyebrow">DOCUMENT INSPECTOR</p><h1>检查 Skill 文档</h1><p>粘贴 SKILL.md，读取 YAML 文档头和正文。内容只在当前标签页处理。</p></div><span class="privacy-label">本机处理 · 无网络请求</span></div>
+<a class="skip-link" href="#workspace">跳到文档编辑</a><main id="workspace"><div class="workspace-heading"><div><p class="eyebrow">DOCUMENT INSPECTOR</p><h1>检查 Skill 文档</h1><p>SkillSync 帮助维护者在运行或交付前核对技能包与材料声明。这里先检查一份 SKILL.md 的文档格式，找到缺失字段或出错位置。</p></div><span class="privacy-label">本机处理 · 无网络请求</span></div>
+<details class="first-use"><summary>第一次检查：从一份文档开始</summary><p class="guide-preparation">适合分享 Skill 前、收到技能包后或修改文档时自查。准备文件全文；无需账号或 API Key。</p><ol><li><strong>放入一份文档</strong><p>把 SKILL.md 全文粘贴到左侧，保留开头两条 --- 之间的字段。也可先使用内置示例。</p><button id="guide-example" type="button" class="secondary">先使用示例文档</button></li><li><strong>运行格式检查</strong><p>点击“检查文档”或按 Ctrl / ⌘ + Enter，查看文档头字段和正文长度。</p><button id="guide-check" type="button">检查当前输入</button></li><li><strong>按结果继续</strong><p>出错时用“定位错误”返回原文。能解析只说明格式可读；目录、权限和交付物请在本机继续核验。</p><a href="#result-heading">阅读当前解析结果</a></li></ol></details>
 <div class="columns"><section class="editor-panel"><div class="panel-heading"><label for="source">SKILL.md</label><span id="document-meta"></span></div><textarea id="source" maxlength="24576" spellcheck="false" aria-describedby="limit"></textarea><small id="limit">最多 24 KiB。网页检查文档格式，本机 CLI 可继续检查来源、权限和交付物。</small>
 <div class="actions"><button id="check">检查文档</button><button id="example" class="secondary">载入示例</button></div></section>
 <section class="result-panel" aria-live="polite" data-state="idle"><div class="panel-heading"><h2 id="result-heading" tabindex="-1">解析结果</h2><span class="result-indicator" aria-hidden="true"></span></div><strong id="status">等待检查</strong><p id="message">运行检查后，这里会列出文档头字段和正文长度。</p><button id="locate" type="button" class="secondary" hidden>定位错误</button><dl id="fields"></dl><div class="scope-note"><strong>检查范围</strong><p>读取 YAML 文档头与正文。来源身份、执行行为及目录权限，请使用本机核验台检查。</p></div></section></div></main>

browser/main.ts

@@ -102,3 +102,6 @@ document.querySelector("#example")!.addEventListener("click", () => {
   clear();
   input.focus();
 });
+
+document.querySelector('#guide-example')!.addEventListener('click', () => document.querySelector<HTMLButtonElement>('#example')!.click());
+document.querySelector('#guide-check')!.addEventListener('click', inspect);