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？三步免安装 ✅

1. 下载：打开 Releases 最新版，点 Source code (zip)（或直接下 main 分支 ZIP）；
2. 解压：右键解压到任意目录（路径不要含特殊字符）；
3. 双击：双击 安全模式-只开网页.cmd 先浏览市场；准备好接入 WorkBuddy 时再双击 一键启动.cmd。

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

已经在用 WorkBuddy？零安装直连市场 ✅

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

这是精选目录的轻量子集：仓库体积超 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，请看详细使用与技术参考。

看看界面

本机技能	精选市场

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

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

产品演示与正式版本

• 可复现演示：录制方法、中文字幕与隐私边界
• 正式 Release 发布流程
• 观看当前演示构建（约 80 秒，MP4 + 中文字幕）（Actions 附件有效期 30 天）。
• 正式版本的 MP4、字幕、Python 安装包与 SHA-256 校验文件将在 GitHub Releases 中一起发布。当前演示构建是临时附件；registry-artifacts-* 是社区插件产物，不是市场本体安装包。

安装前请知道

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

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

文档与社区

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