6. 本地协议检查命令
以下命令在临时笔记本与插件数据目录中执行本地协议检查(目录安装完成后,按语言各自起算 20 秒 RPC 预算):依次校验 manifest.json(含 permission_reasons 键匹配、字数与禁 Emoji 规则)、目录安装、初始化、无参初始渲染、携带完整默认值渲染、递归收集卡片顶层与 group 内的 segmented/select/switch 并逐项单值切换渲染(不做多控件组合,不遍历 checklist)、调用初始页全部 header_actions 与顶层 actions 按钮(不判断 visible_when 与折叠状态;对返回的 open_path/reveal_path 仅以 os.Stat 验证存在性,ok: false 仍可通过)、在声明 "events:note_saved" 时直接发送 note.saved 事件(不走桌面队列)以及 plugin.shutdown 回收(纯声明式语言扩展无需子进程,仅校验清单、双语文档与语法编译):
bash
CGO_ENABLED=0 go -C /path/to/block run ./cmd/block-plugin-check /绝对路径/到你的插件目录- 双语门禁:当
manifest.repo属于官方仓库(blockmd-plugins/*)时,校验器会自动启用双语检查(社区插件可追加-bilingual参数主动开启):- 校验清单中
name.en、summary.en、contributes.*.en及已声明的permission_reasons[*].en均为非空纯英文且不含中文字符或中文标点; - 校验根目录存在精确命名的普通文件
README.md(<= 512 KiB UTF-8,非空且含中文)与README.en.md(<= 512 KiB UTF-8,非空、不含中文字符或中文标点、且与README.md不同); - 交互式插件分别以
locale="zh"与locale="en"各运行一轮完整检查,校验英文模式下全部界面文案与动作反馈零中文残留,且中英文初始渲染输出不同。
- 校验清单中
终端输出 [PASS] Plugin "<id>" passed all Block App Store checks. 且退出码为 0 表示本地协议检查通过。注意:CLI 仅提供单个临时笔记本、不校验桌面默认停用与编辑器脏状态写保护,且未注入 GetPerfSnapshot(调用 host.perf.snapshot 会收到 -32005);上传、同步、迁移与真实桌面交互仍需在 Block 桌面端使用临时笔记本进一步验证。
7. 发布到应用商店(blockmd-plugin 自动采集)
Block 应用商店采用无审批自动采集机制,发布步骤如下:
- 将插件代码推送到公开、非 Fork、未归档的 GitHub 仓库,确保仓库根目录(或归档内根/唯一单层顶层目录)包含通过第 6 节检查的
manifest.json(含"app": "blockmd";若填写repo须与仓库owner/repo一致)。官方插件(blockmd-plugins/*,当前包括block-sync、block-poop-everywhere、block-lang-gomod、block-lang-plist,其余以个人或社区名义发布)必须同时放置README.md(中文)与README.en.md(英文),有子进程 UI 的插件还须支持locale="en"英文界面;已审核作者(eachann1024/*)与社区插件同样建议提供双语文档与permission_reasons。 - 在 GitHub 仓库主页右侧 About -> Topics 添加标签:
blockmd-plugin。 - 发布标准 GitHub Release(不要标为 Draft 或 Prerelease,建议保持 Release Tag 与包内
manifest.version一致):- 官方推荐自动版本号与发布门禁:复用
blockmd-plugins/block-sync的.github/workflows/release.yml(Daily Release)。仓库manifest.json仅保留主次版本基线(如"1.2.0"),日常改动直接推送main;工作流每天00:00 UTC(或手动workflow_dispatch)检测代码或双语 README 变更,打包前强制执行README.md/README.en.md与locale="en"英文界面门禁(未通过即中止发布),通过后以<major>.<minor>.<提交总数>生成候选版本(若不高于已有最高版本则递增)动态写入产物包并发布 Release,不向main回写提交。 - 手动发版:也可推送
vX.Y.ZTag 触发同工作流打包对应版本。
- 官方推荐自动版本号与发布门禁:复用
- 线上采集与校验规则(由
blockmd-plugins/store-index仓库的采集任务及cmd/block-store-crawler执行):- 采集器抓取
topic:blockmd-plugin fork:false archived:false按 stars 降序的前 100 个仓库(无分页),并自动跳过内置保留 ID(block-diagnostics)。 - 选包顺序:拉取仓库
/releases列表并筛选首个非草稿(!draft)、非预发布(!prerelease)的 Release,优先取其首个.tar.gz/.tgz/.zip附件,无匹配附件时回退该 Release 的tarball_url(无zipball_url分支);仅在尚未选出下载 URL 时才回退默认分支源码包(codeload.github.com/{repo}/tar.gz/{default_branch})。已选归档下载或解析失败会直接跳过该仓库,不向低优先级回退重试。 - 索引校验与同步字段:采集器先对归档原始字节计算
sha256并提取根或单层顶层目录下的manifest.json(不运行block-plugin-check,版本以包内manifest.version为准),依次执行app == "blockmd"、非空id、保留 ID 与blocklist过滤、官方verified.json1:1 绑定(当前绑定block-sync、block-poop-everywhere、block-lang-gomod、block-lang-plist)、官方插件双语文档(README.md中文 +README.en.md纯英文)与双语无 Emoji 清单校验、repo匹配、声明式语法文件编译校验与跨仓重复id剔除,并将category、permission_reasons与file_extensions(最多 6 个展示标签)同步到商店索引;若任一官方认证条目缺失或校验不通过,整轮索引生成会直接失败。 - 桌面端不同安装来源的校验力度:从应用商店或手动输入商店插件
id安装时,强制 HTTPS(<= 4096 字节、无凭据与 fragment、限制重定向主机)、核对sha256及包内清单的id/version/permissions集合与(非空时)repo;手动输入owner/repo、github:owner/repo、https://github.com/owner/repo(拉取HEAD源码包)或直接 HTTPS 压缩包 URL(同样受 URL 长度、凭据、fragment 与重定向主机约束)或本地目录路径(支持~/、file://或点击「本地目录」)会校验清单与打包上限,但不做商店sha256/索引比对。
- 采集器抓取
- 带系统权限的发行包通过索引的
system_apps提供,支持该字段的 Block 会优先选用。旧客户端从apps读取已验证的兼容包。同步插件为旧客户端保留 v1.3.44。随包索引与采集器使用相同分流规则,采集器校验兼容包的固定 SHA-256 后才写入索引。