Metadata-Version: 2.4
Name: workbuddy-market
Version: 2.34.0
Summary: Local-first plugin marketplace for WorkBuddy: package local skills, register into WorkBuddy, browse & install from a 127.0.0.1-only web UI
Author: zjs105910
License: MIT
Project-URL: Homepage, https://github.com/zjs105910/workbuddy-market
Project-URL: Repository, https://github.com/zjs105910/workbuddy-market
Project-URL: Documentation, https://github.com/zjs105910/workbuddy-market/blob/main/ADVANCED_GUIDE.md
Project-URL: Issues, https://github.com/zjs105910/workbuddy-market/issues
Project-URL: Security, https://github.com/zjs105910/workbuddy-market/blob/main/SECURITY.md
Project-URL: Changelog, https://github.com/zjs105910/workbuddy-market/blob/main/CHANGELOG.md
Keywords: workbuddy,skill,plugin,marketplace,agent-skills,ai-agents,developer-tools,local-first
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Environment :: Web Environment
Classifier: Operating System :: Microsoft :: Windows
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.13
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Provides-Extra: dev
Requires-Dist: pytest>=8.0; extra == "dev"
Requires-Dist: ruff==0.17.0; extra == "dev"
Dynamic: license-file

# WorkBuddy Market

**简体中文** · [English](README_EN.md)

[![CI](https://github.com/zjs105910/workbuddy-market/actions/workflows/ci.yml/badge.svg?branch=main)](https://github.com/zjs105910/workbuddy-market/actions/workflows/ci.yml)
[![PyPI version](https://img.shields.io/pypi/v/workbuddy-market.svg)](https://pypi.org/project/workbuddy-market/)
[![Downloads](https://img.shields.io/pypi/dm/workbuddy-market.svg)](https://pypi.org/project/workbuddy-market/)
[![Python 3.10+](https://img.shields.io/badge/Python-3.10%2B-blue.svg)](pyproject.toml)
[![MIT License](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)

**给 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`；你的私有市场配置和本机技能内容不随仓库提交。

## 演示与下载

先看约 80 秒的可复现产品演示，再选择适合你的安装方式。正式版 Release 会同时提供横屏与竖屏演示视频、字幕、manifest、Python 安装包和 SHA-256 校验文件。

- **先看演示**：[横屏 MP4（16:9）](https://github.com/zjs105910/workbuddy-market/releases/latest/download/workbuddy-market-demo.mp4) · [竖屏 MP4（9:16）](https://github.com/zjs105910/workbuddy-market/releases/latest/download/workbuddy-market-demo-vertical.mp4) · [中文字幕（SRT）](https://github.com/zjs105910/workbuddy-market/releases/latest/download/workbuddy-market-demo.zh-CN.srt)
- **安装完整版**：[最新版正式 Release](https://github.com/zjs105910/workbuddy-market/releases/latest)（含 Windows 安装器、wheel、sdist 和 `SHA256SUMS.txt`）；Windows 用户也可[直接下载 `install.cmd`](https://github.com/zjs105910/workbuddy-market/releases/latest/download/install.cmd)。
- **只装精选技能**：继续看下方「只想装精选技能（zip 导入）」；这是轻量分发入口，不包含完整版的安装前安全预览与可恢复卸载。
- **了解生成与安全边界**：[可复现演示的录制方法、字幕与隐私边界](docs/demo-video.md) · [正式 Release 发布流程](docs/release-process.md)

> `registry-artifacts-*` 是每日生成的社区插件产物预发布条目，不是市场本体。请认准标题为 `WorkBuddy Market vX.Y.Z` 的正式 Release；校验附件时，可在同一页面下载 `SHA256SUMS.txt`。

## 快速上手（Windows）

### 只想下载一个文件？一键安装（推荐） ✅

**[👉 点此直接下载 install.cmd](https://github.com/zjs105910/workbuddy-market/releases/latest/download/install.cmd)**（浏览器会立即开始下载；想先看一眼内容再下，也可以[打开文件页面](https://github.com/zjs105910/workbuddy-market/blob/main/install.cmd)手动下载）。

下载完成后**双击**即可。它会自动完成：检测/安装 Python → 装 pipx → 装并升级 `workbuddy-market` CLI → 下载市场本体到 `%USERPROFILE%\workbuddy-market` → 运行 doctor 体检 → 启动首次向导（**回车=只浏览，2=注册进 WorkBuddy**）。

> 双击时 Windows 会弹「无法验证发布者」的安全警告——因为脚本没有购买数字签名（开源项目的常规情况），点**运行(R)**即可；脚本内容是纯文本，可在上面的文件页面逐行核对。

这就是**完整版**：四问预览、哈希校验、事务与可恢复卸载全都在。可重复运行（每一步幂等，顺带升级 CLI）。

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

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

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

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

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

```
/plugin marketplace add zjs105910/workbuddy-market
```

这是仓库**自带插件市场**（随 `bundled/` 目录入库固定，零漂移），装好后 `/plugin` 浏览，`/plugin install <插件名>@workbuddy-market` 安装。

想要**每日重建的完整社区目录**（25+ 精选技能，按人工审核的 sourceCommit 固定来源）：

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

`/plugin marketplace update` 即可刷新；不想用命令也可以走下面的 zip 导入。两条轻量入口的取舍见下方说明与 [FAQ 第八节](docs/FAQ.md)。

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

不想跑任何工具，只想装社区精选技能：下载 [精选市场 zip](https://github.com/zjs105910/workbuddy-market/releases/download/marketplace/workbuddy-marketplace.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。

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

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

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

（需要先装 [pipx](https://pipx.pypa.io/)；`uv tool install workbuddy-market` 等价。）

### 用 Git 的话

```powershell
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，请看[详细使用与技术参考](ADVANCED_GUIDE.md)。

## 已收录插件

<!-- registry-table:start -->

> 共 **50** 个收录条目，由每日 CI 从人工审核的注册表自动刷新本表格。

| 插件 | 说明 | 分类 | 信任级 |
| --- | --- | --- | --- |
| [Anthropic 官方技能集](https://github.com/anthropics/skills) | Anthropic 官方 Agent Skills 仓库，含文档处理（docx/pdf/pptx/xlsx）、前端设计、MCP 构建、画布设计、品牌规范等 19 个高质量技能。 | 官方 | 官方 |
| [Superpowers 工程方法论](https://github.com/obra/superpowers) | 一套成体系的软件开发方法论技能包：头脑风暴、写计划、TDD、系统化调试、并行派发子代理、代码审查、收尾分支等 15 个技能，彼此衔接成工作流。 | 开发工具 | 已审 |
| [Matt Pocock 工程技能集](https://github.com/mattpocock/skills) | 知名 TypeScript 教育家 Matt Pocock 从自己的 .agents 目录里拿出来的工程技能集：面向真实工程场景的编码、评审与协作技能。 | 开发工具 | 已审 |
| [GStack 创业指挥栈](https://github.com/garrytan/gstack) | Y Combinator 总裁 Garry Tan 公开的 Claude Code 配置：CEO、设计师、工程管理等 23 个观点鲜明的工具，把 AI 当成完整创业团队来指挥。 | 开发工具 | 已审 |
| [Addy Osmani 工程技能](https://github.com/addyosmani/agent-skills) | Chrome 工程负责人 Addy Osmani 出品的 AI 编码智能体生产级技能集，覆盖调试、性能、架构与代码质量等方向。 | 开发工具 | 已审 |
| [Open Design 设计插件](https://github.com/nexu-io/open-design) | 开源的 DSH 设计插件替代品（对标 Claude Design）：本地优先的设计能力，让智能体直接产出可用的界面与视觉稿。 | 设计 | 已审 |
| [Taste 品味技能](https://github.com/Leonxlnx/taste-skill) | 给 AI 一双「好品味」的眼睛：阻止它生成平庸、模板化、千篇一律的输出，让界面与文案更有设计感（含安装脚本与示例）。 | 设计 | 已审 |
| [AI Scientist 科研技能库](https://github.com/K-Dense-AI/scientific-agent-skills) | 面向科研场景的 Agent 技能库：把 AI 智能体用于科研工作流，覆盖数据分析、文献处理、实验等环节。 | 科研 | 已审 |
| [agent-browser 浏览器自动化](https://agent-browser.dev) | Vercel 出品的浏览器自动化 CLI，官方 CodeBuddy 插件同源。首次使用自动安装，提供网页交互、截图、表单填写能力。 | 自动化 | 已审 |
| [Agents 技能大全](https://github.com/wshobson/agents) | 体量极大的工程技能合集，184 个技能覆盖后端、前端、Python、K8s、可观测性、安全、支付、LLM 微调、量化交易、无障碍等方向，按主题分成数十个插件组。 | 合集 | 已审 |
| [ECC 智能体优化系统](https://github.com/affaan-m/ECC) | 面向智能体 harness 的性能优化系统：技能、本能、记忆、安全与研究工具一应俱全，插件目录覆盖 Claude Code、Codex、Cursor、Gemini 等十余个平台。 | 合集 | 已审 |
| [Karpathy 行为技能](https://github.com/multica-ai/andrej-karpathy-skills) | 从 Andrej Karpathy 的观察提炼出的智能体行为改进技能：让编码智能体的工程判断更克制、更接近人类顶尖水平。内容稳定、低频更新。 | 开发工具 | 已审 |
| [Ponytail 最懒工程师](https://github.com/DietrichGebert/ponytail) | 让智能体像「房间里最懒的高级工程师」一样思考：能不写的代码就不写，追求最小改动、最简方案与最少复杂度。 | 开发工具 | 已审 |
| [Archify 架构图技能](https://github.com/tt-a1i/archify) | 把任何想法、计划或代码库变成漂亮的交互式架构图：面向 Claude Code 等智能体的图表技能，含渲染器与配方库。 | 设计 | 已审 |
| [ADHD 友好输出](https://github.com/ayghri/i-have-adhd) | 阻止编码智能体把答案埋进长篇大论的技能：ADHD 友好的直给输出结构，先说答案再谈过程。 | 效率 | 已审 |
| [Humanizer 去 AI 味](https://github.com/blader/humanizer) | 去除文本中 AI 生成痕迹的智能体技能：去掉模板腔与机械感，让输出读起来像人写的。 | 写作 | 已审 |
| [营销技能包](https://github.com/coreyhaines31/marketingskills) | 面向 Claude Code 与 AI 智能体的营销技能包：转化率优化（CRO）、文案、SEO、数据分析与增长工程。 | 商业 | 已审 |
| [学术研究技能](https://github.com/Imbad0202/academic-research-skills) | 学术研究全流程技能：研究 → 写作 → 评审 → 修改 → 定稿，含论文评审、深度研究等专项技能。 | 科研 | 已审 |
| [编辑级图表设计](https://github.com/cathrynlavery/diagram-design) | 编辑级的图表设计技能：42 种图表类型与 editorial 审美，支持 Claude Code、Codex、Copilot 等多个智能体。 | 设计 | 已审 |
| [逆向与渗透技能路由](https://github.com/zhaoxuya520/reverse-skill) | 逆向工程与授权渗透测试的技能路由包：CTF 沙箱编排、Burp MCP 集成、Kali 工具链等，仅面向授权安全研究与学习。 | 安全 | 已审 |
| [网络安全技能库](https://github.com/mukul975/Anthropic-Cybersecurity-Skills) | 817 个结构化网络安全技能，映射到 MITRE ATT&CK、NIST CSF 2.0 等 6 大安全框架，供智能体按需调用。 | 安全 | 已审 |
| [技术书转技能](https://github.com/virgiliojr94/book-to-skill) | 把任何技术书 PDF 蒸馏成一个可用的智能体技能：边读边查边用，把整本书变成随身参考。 | 效率 | 已审 |
| [Hallmark 反模板设计](https://github.com/Nutlope/hallmark) | 反 AI 味设计技能：阻止智能体产出千篇一律的模板化界面，让生成的设计更有个性与质感。 | 设计 | 已审 |
| [文件化任务规划](https://github.com/OthmanAdi/planning-with-files) | 面向长任务的持久化文件规划技能：崩溃不丢进度的 Markdown 计划，适配多个主流编码智能体（含 CodeBuddy 目录）。 | 效率 | 已审 |
| [产品经理技能市场](https://github.com/phuryn/pm-skills) | 产品经理技能市场：100+ 智能体技能、命令与插件，覆盖从产品发现到上市推广的全生命周期。 | 商业 | 已审 |
| [宝玉技能集](https://github.com/JimLiu/baoyu-skills) | 宝玉（JimLiu）维护的智能体技能集，中文社区广泛使用的 Claude Code 技能合集。 | 开发工具 | 已审 |
| [Distilly 思维蒸馏](https://github.com/titanwings/distilly) | 把领域专家的思维方式蒸馏成可复用技能：让任何智能体继承「他们怎么想」（原 Colleague Skills）。 | 开发工具 | 已审 |
| [花叔设计](https://github.com/alchaincyf/huashu-design) | 花叔设计：HTML 原生的设计技能（中文文档），高保真原型直出，让 Claude Code 像专业设计师一样产出界面。 | 设计 | 已审 |
| [体育数据技能集](https://github.com/machina-sports/sports-skills) | 面向体育场景的开源 agent 技能集：实时赛事数据获取、比赛结果预测、联赛与球员信息查询等 27 个技能，按主题分组，适合构建体育资讯与数据分析工作流。 | 效率 | 已审 |
| [产品营销技能市场](https://github.com/stefanoskarakasis/Product-Marketing-Skills) | 产品营销（PMM）技能市场：包含定位、发布、竞争分析、客户研究、内容与销售赋能等 30+ 个代理技能与命令，覆盖产品营销全流程。 | 商业 | 已审 |
| [任务闭环 Mission](https://github.com/tackeyy/mission) | 质量门禁驱动的自治任务闭环技能集：任务拆解、执行、验证与交付全程受质量闸约束，含 12 个技能，适合让代理在明确验收标准下长跑完成任务。 | 开发工具 | 已审 |
| [人工评审 Human-Review](https://github.com/victorrentea/human-review) | 为 Claude Code 设计的人工评审技能：自动汇编一页式变更摘要与风险清单，帮助人类评审者快速理解代理改动并给出批准或驳回意见。 | 开发工具 | 已审 |
| [UI 间距规范](https://github.com/buidangminh23/spacing-skill) | 反拥挤间距技能：一条经过打磨的 UI 间距规范，让代理生成的界面保持呼吸感与一致的视觉节奏，适合嵌入任何前端工作流。 | 设计 | 已审 |
| [旅行规划 Trip-Planner](https://github.com/skywain/trip-planner-skill) | AI 旅行规划技能：按天数、预算与偏好生成可执行的行程单，覆盖交通、住宿与景点编排，兼容 Claude Code / Codex 等多种代理工具。 | 效率 | 已审 |
| [Reddit 浏览器自动化](https://github.com/beggarticksarthurtatum121/reddit-skills) | 基于真实浏览器与账号的 Reddit 自动化技能集：浏览、检索、发帖与互动等 6 个技能，强调以用户本人身份合规操作。 | 自动化 | 已审 |
| [PubMed 引用核验](https://github.com/docsor1212/pubmed-verifier) | PubMed 文献引用批量核验工具：对 AI 生成的引用逐条比对 PubMed 数据库，检测编造与张冠李戴，降低科研写作中的幻觉引用。 | 科研 | 已审 |
| [科研严谨执行](https://github.com/bsq415/research-rigor-skill) | 人类主导、证据门控的科研全周期执行技能：从问题定义、文献综述到实验设计与结论输出，每一步都要求可验证证据支撑。 | 科研 | 已审 |
| [验收测试生成 Qikly](https://github.com/gal-a/qikly) | 从验收标准生成测试套件的技能：先按验收条件生成测试用例，再驱动实现直至全部通过，覆盖单元与集成两层。 | 测试 | 已审 |
| [发布视频生成](https://github.com/Kimeur/motion-launch-videos) | 发布视频批量生成技能集：从简短的产品说明生成脚本、分镜与成片，循环产出可发布的宣传视频，共 12 个技能。 | 设计 | 已审 |
| [数据经纪商除名](https://github.com/danieljustus/symaira-eraseme) | 自动化数据经纪商除名技能：批量向数据经纪商提交除名请求、跟踪处理进度，帮助清理个人数据痕迹，强化隐私保护。 | 安全 | 已审 |
| [Compose 开发助手](https://github.com/yschimke/compose-ai-tools) | 面向 Jetpack Compose 的代理辅助技能：UI 组件生成、代码规范检查等 3 个技能，帮助代理写出符合 Compose 最佳实践的 Android 界面代码。 | 开发工具 | 已审 |
| [pstack 技能集 T3 版](https://github.com/creedants/pstack-t3) | Lauren Tan 的 pstack 代理技能集向 T3 Code 的移植版：覆盖前端工程、产品思维与协作流程等 130 个技能，任何模型都能取用。 | 合集 | 已审 |
| [工程品味合集 Shadowclone](https://github.com/theonly1me/shadowclone) | 把个人工程品味带进每一个编码代理的技能合集：代码风格、架构取舍与评审标准等 44 个技能，来自一线工程师的实战沉淀。 | 合集 | 已审 |
| [上下文桥 Open-Bridge](https://github.com/bks-lab/open-bridge) | 给编码代理的上下文桥技能集：以纯 Markdown 沉淀工作约定、决策与领域知识等 41 个技能，免去反复向代理解释背景。 | 开发工具 | 已审 |
| [循环工程套装 IDD](https://github.com/kurone-kito/idd-skill) | 循环工程（Iterative Development Discipline）自动化配置技能套件：4 个技能帮助代理建立稳定的需求-实现-验证迭代循环。 | 开发工具 | 已审 |
| [技能共进化 NBLane](https://github.com/Marsjunwang/nblane) | 人 + 代理 + 团队技能共同进化平台：以纯文本沉淀技能资产，5 个技能覆盖个人与团队层面的技能演化与复用。 | 效率 | 已审 |
| [便携技能包 Claude-Abo](https://github.com/Bank848/Claude-Abo) | 便携式 Claude Code 配置模板：66 个经过实战验证的技能开箱即用，一条命令即可在新机器上复原完整工作环境。 | 合集 | 已审 |
| [逆向工程代理 Rea](https://github.com/morluto/rea) | 逆向工程代理技能：从应用行为入手向下还原实现细节，2 个技能覆盖行为观测与结构还原，适合学习与兼容性分析。 | 安全 | 已审 |
| [星际智能系统](https://github.com/frankxai/Starlight-Intelligence-System) | 给整个 AI 舰队一个共享大脑：带证明的记忆、知识组织与跨会话延续等 69 个技能，适合多代理长期协作场景。 | 效率 | 已审 |
| [代理技能百科 RSC](https://github.com/ericrisco/rsc-harness) | 超大体量的代理技能百科：开发、写作、测试、运维等方向 271 个技能，按需取用，适合作为团队技能弹药库。 | 合集 | 已审 |

<!-- registry-table:end -->

收录标准与审核流程见 [CONTRIBUTING.md](CONTRIBUTING.md)；收录契约由 `registry/registry-schema.json` 定义并在 CI 强制校验。仓库自带的 3 个插件（browser-cdp / github-project-manager / novel-writing-suite）在 `bundled/` 目录，随仓库分发，见上方短命令接入。

## 收录你的插件

想让你的技能进这个市场？三步：

1. 确认仓库里有可被发现的 `SKILL.md`（收录标准：结构完整、非归档、活跃维护；awesome 清单、平台工具、CLI 本体不收）；
2. 提 issue 或 PR，在 `registry/plugins.json` 里补一条静态字段（repo / displayName / category / description / trust / sourceCommit 等，契约见 `registry/registry-schema.json`）；
3. CI 会补全动态字段并过契约校验，人工审核通过后合并——次日起每日产物构建与 README 表格自动带上它。

## 看看界面

| 本机技能 | 精选市场 |
| --- | --- |
| ![本机技能管理界面](docs/screenshots/home-local.png) | ![精选社区插件界面](docs/screenshots/home-curated.png) |

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

![安装前详情预览](docs/screenshots/detail-four-questions.png)

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

## 安装前请知道

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

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

| 平台 | 当前状态 |
| --- | --- |
| Windows 10/11 | 主要使用与验证环境；仓库文档记录了 WorkBuddy 5.7.6 面板实测 |
| Linux | CI 三平台硬门槛：完整隔离 selftest（789 项）+ pytest + POSIX 语义冒烟 + wheel 构建 + ui-smoke；尚未验证真实 WorkBuddy 宿主集成 |
| macOS | CI 三平台硬门槛：完整隔离 selftest（789 项）+ pytest；真实 fcntl/symlink 语义由 CI 实跑，尚未验证真实 WorkBuddy 宿主集成 |

## 文档与社区

| 你想做什么 | 入口 |
| --- | --- |
| 配置市场、使用命令行、了解安全边界 | [详细使用与技术参考](ADVANCED_GUIDE.md) |
| 了解首次启动、收录和恢复问题 | [FAQ](docs/FAQ.md) |
| 了解插件包协议与校验 | [插件包协议](docs/plugin-spec.md) |
| 报告安全问题 | [安全策略](SECURITY.md) |
| 提交代码或改进文档 | [贡献指南](CONTRIBUTING.md) |
| 查看版本变化 | [CHANGELOG](CHANGELOG.md) |
| 提交 Bug / 功能建议 | [GitHub Issues](https://github.com/zjs105910/workbuddy-market/issues) |

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