WorkBuddy Market

简体中文 · English

给 WorkBuddy 用的本机优先插件市场。 将本机 Skills 打包成插件，在精选社区目录或 GitHub 中查找技能；安装前查看来源、权限声明和兼容性，再通过哈希校验与可恢复事务完成安装、更新和卸载。

A local-first plugin marketplace for WorkBuddy: package local Skills, explore community and GitHub sources, review declared permissions and compatibility, and manage installs through hash verification and recoverable transactions.

30 秒了解它

• 管理自己的 Skills：将本机技能打包、同步，并注册到 WorkBuddy 插件面板。
• 发现社区技能：浏览精选目录，也可以搜索 GitHub 上的公开仓库。
• 安装过程更可追溯：安装前有来源与风险预览；支持内容校验、事务恢复和回收站。
• 本机优先：网页服务只监听 127.0.0.1；你的私有市场配置和本机技能内容不随仓库提交。

快速上手（Windows）

没有 Git？三步跑起来（免 Git，需 Python 3.10+） ✅

1. 下载：打开 Releases 最新版（认准标题为 WorkBuddy Market vX.Y.Z 的条目；registry-artifacts-* 是插件产物 Pre-release，不是本体），点 Source code (zip)（或直接下 main 分支 ZIP）；
2. 解压：右键解压到任意目录（路径不要含特殊字符）；
3. 双击：双击 安全模式-只开网页.cmd 先浏览市场；准备好接入 WorkBuddy 时再双击 一键启动.cmd。

需要 Python 3.10+（首次启动向导会检测并给出明确提示）。配置文件不需要手工创建——首次启动自动初始化。

已经在用 CodeBuddy Code / WorkBuddy？一条命令接入 ✅

在对话框（或 CodeBuddy Code CLI）执行：

/plugin marketplace add https://github.com/zjs105910/workbuddy-market.git#marketplace

然后 /plugin 浏览精选技能，或 /plugin install <插件名>@workbuddy-community-market。这条路由每日 CI 从人工审核的注册表自动重建（按 sourceCommit 固定来源），/plugin marketplace update 即可刷新；不想用命令也可以走下面的 zip 导入。

只想装精选技能（zip 导入）

不想跑任何工具，只想装社区精选技能：下载 精选市场 zip，在 WorkBuddy 插件面板 → 添加自定义市场 里选这个 zip 即可。内容每日由 CI 从人工审核的注册表自动重建。

入口适用范围：上述 zip 导入在 WorkBuddy 桌面端（5.7.6 实测）插件面板验证；CodeBuddy Code 的市场入口（marketplace.json URL / Git 仓库 / 本地路径）是不同客户端的路线，不支持直接导入本 zip——用 CodeBuddy Code 请改走 pipx 安装完整市场后注册。

这是精选目录的轻量子集：仓库体积超 30MB、含符号链接或没有标准 skill 结构的收录条目不会进包（搜不到某技能多半是这个原因）。完整清单见 zip 内 .codebuddy-plugin/marketplace.json 的 included / excluded 字段，或 Release 附件里的 manifest。

取舍说明：这条路拿到的是技能分发——没有安装前四问、所有权分级和可恢复卸载。要完整的安全链路，请用上面的完整版。

会用命令行？一条命令安装 ✅

pipx install workbuddy-market
workbuddy-market doctor     # 体检；list / search 逛社区目录

（需要先装 pipx；uv tool install workbuddy-market 等价。）

用 Git 的话

git clone https://github.com/zjs105910/workbuddy-market.git
cd workbuddy-market
.\安全模式-只开网页.cmd

启动后打开本机地址（默认 http://127.0.0.1:8777/）。请保持启动窗口打开；结束时回到窗口按 Ctrl+C。

已经准备好要接入 WorkBuddy 时，再运行 一键启动.cmd。首次初始化的交互向导中，直接回车是只浏览；只有明确输入 2 才会请求注册到 WorkBuddy。注册前仍会进行打包与自检前置检查。

不会使用命令行？克隆仓库后，也可以在资源管理器中双击 安全模式-只开网页.cmd。想了解其他启动参数、插件配置或 CLI，请看详细使用与技术参考。

看看界面

本机技能	精选市场

安装前的来源、权限与兼容性预览：

截图由项目脚本使用合成数据生成。实际可用操作会根据本机环境与插件来源有所不同。

演示视频与下载入口

v2.28.0 起正式 Release 随版本附带全部演示与安装资源。三种下载入口按需区分：

• 演示视频：在 v2.28.0 Release（或最新一个 WorkBuddy Market vX.Y.Z 条目）下载 workbuddy-market-demo.mp4（约 80 秒）与 workbuddy-market-demo.zh-CN.srt 中文字幕，随正式版发布，无 30 天过期限制；
• 完整市场本体：对应版本的 WorkBuddy Market vX.Y.Z Release 条目（wheel / sdist / 源码 zip），或直接 pipx install workbuddy-market；
• 精选市场 zip（只装技能）：见上文「零安装直连市场」一节，由固定的 marketplace Release 每日重建。

注意：registry-artifacts-* 是每日生成的社区插件产物 Release（已标记为 Pre-release），不是市场本体安装包。下载市场本体时认准标题为 WorkBuddy Market vX.Y.Z 的条目。

• 可复现演示：录制方法、中文字幕与隐私边界
• 正式 Release 发布流程

安装前请知道

• 卸载时会检查插件是否由本市场管理、内容是否被修改；不属于本市场管理的技能不会被随意删除。回收站与事务恢复用于降低误操作影响。
• 权限声明和风险预览不是运行时沙箱。 第三方 Skill 仍可能执行其自身逻辑；安装前请核查来源与内容，不要仅凭“精选”标签就盲目信任。
• 首次只想体验网页：使用 安全模式-只开网页.cmd。想撤销 WorkBuddy 中的市场注册：使用 撤销注册.cmd。这与卸载已经安装的技能是不同操作。

平台支持矩阵（验证状态）

文档与社区

欢迎 Star、提 Issue、提交可复现的问题与 PR。项目采用 MIT License。