GlueKit Workbench
VS Code / Cursor 侧栏 Webview:Proposal → Spec → 规约配套 → Tasks 等 Spec Coding 流程的工作台(扫描、门禁、拆分、Glue / Harness / .qoder 等)。
- 许可证:MIT
- 安全披露:SECURITY.md
- 状态:1.0.0 为首个对外发布版本(此前未上架 Marketplace);能力随版本迭代,见
package.json 的 version。
从 GitHub 克隆后安装(源码 → VSIX)
在仓库根目录若包含本扩展子目录 gluekit-workbench/:
cd gluekit-workbench
npm install
npm run package
会在当前目录生成 gluekit-workbench-<version>.vsix。
在 Cursor / VS Code 中:
Ctrl+Shift+P(macOS:Cmd+Shift+P)→ Extensions: Install from VSIX…
- 选择生成的
.vsix 文件。
或在终端(将路径换成你的 .vsix 绝对路径):
cursor --install-extension /path/to/gluekit-workbench-1.0.0.vsix --force
# 或
code --install-extension /path/to/gluekit-workbench-1.0.0.vsix --force
开发调试
cd gluekit-workbench
npm install
npm run compile
用 VS Code 打开 gluekit-workbench 目录,Run and Debug 启动 “Extension Development Host”,或使用:
npm run open-dev-host
(脚本以当前扩展目录为 --extensionDevelopmentPath,上级目录为工作区。)
发布到 VS Code Marketplace(微软)
前置:package.json 里的 publisher 必须与你在市场上注册的发布者 ID 完全一致(当前为 LvZhaobo)。上架后扩展唯一 ID 为 LvZhaobo.gluekit-workbench(publisher + . + name)。
注册发布者
打开 Visual Studio Marketplace 管理,用 Microsoft 账号登录,Create publisher,记下 Publisher ID。
Azure DevOps PAT
- 打开 Azure DevOps,使用同一 Microsoft 账号(或按 Marketplace 文档关联的组织)。
- User settings → Personal access tokens → New Token:勾选 Custom defined → Marketplace → Manage,生成并复制 PAT(只显示一次)。
登录与发布(在本目录执行)
npm install
npm run compile
npx @vscode/vsce login <你的PublisherID>
# 粘贴 PAT
npx @vscode/vsce publish
或先 npm run package 检查 .vsix,再 npx @vscode/vsce publish --packagePath ./gluekit-workbench-<version>.vsix。
常见要求(审核/展示)
README.md、LICENSE、repository 字段、版本号递增。
- 可选:
icon(package.json 已引用 media/icon.svg,若市场不接受可换 PNG)。
- 详见官方文档:Publishing Extensions。
注意:Marketplace 与 Open VSX(VSCodium 等)是两套系统;若也要上 Open VSX,需单独在 open-vsx.org 注册并执行 npx ovsx publish -p <OpenVSX_PAT>(流程见其文档)。
开源与安全说明
- 本扩展仅在本地工作区读写文件、执行你确认的模板与命令;不会把代码自动上传到 GlueKit 服务器(无此类后端)。
- 使用 Webview 与
postMessage 与宿主通信;请从可信来源克隆仓库并自行审查 src/。
- 漏洞报告见 SECURITY.md;建议在 README 标明 实验性/版本号、Issue 入口。
仓库结构(扩展内)
| 路径 |
说明 |
src/ |
TypeScript 扩展入口、扫描、消息、工作流 |
media/workbench/ |
Webview 前端 workbench.js / workbench.css |