Usora Dock Foundry 工作台
在 VS Code 中查看真实 Foundry 数据，并通过 Usora MCP 完成能力沉淀流程。
Usora Dock 的 Foundry 工作台把 实践记录 → 候选能力 → 技能草稿 → 评估 → 发布 这条真实生命周期放进 VS Code。它只展示已连接 Foundry 返回的数据；所有业务操作都通过 Foundry MCP 完成，不在 Dock 内复制一套本地数据逻辑。
使用前提
工作台依赖当前宿主已经安装并启用了 Usora Foundry MCP。Codex、CodeBuddy 和手动 MCP 的安装方式见宿主使用指南；MCP 工具列表和生命周期边界见插件能力。
Usora Dock 会自动检测可用的 Foundry MCP：
- 检测到可用连接时，左侧显示 Foundry 工作台 菜单。
- 未检测到连接时，默认不占用导航空间，Skills 浏览仍然可用。
- 如果希望在未连接时也保留菜单，可在概览或 VS Code 设置中把工作台模式改为
always。 - 需要完全关闭菜单时使用
off。这不会关闭或删除 Usora 数据，也不影响普通 Skills 浏览。
对应设置为 usoraSkillsExplorer.foundryWorkbenchMode，默认值是 auto。
工作台布局
工作台始终保持三栏：
- 左侧导航：概览、实践记录、候选能力、技能草稿、已发布技能，以及 Codex、CodeBuddy 等来源数量。
- 中间列表：搜索、来源筛选、时间排序和真实 Foundry 记录。
- 右侧详情：当前记录的摘要、来源、证据、时间、内容和可执行操作。
窗口较窄或 Windows 显示缩放为 125% / 150% 时，列表区域会保留滚动能力，不会用隐藏详情的方式改变业务布局。
概览
概览用于确认工作台状态和下一步流程：
- 绿色状态点表示 Foundry 已连接；橙色状态点表示等待连接或不可用。
- 状态卡显示实践记录、候选能力、技能草稿和已发布技能数量。
- 数据连接区域显示 Foundry 返回的数据位置和迁移状态，仅用于诊断，不会由 Dock 直接修改路径。
- 中间栏快捷入口按生命周期引导到实践、候选、草稿和已发布技能页面。
概览中的设置图标可以打开 foundryWorkbenchMode。这是显示策略设置，不是数据迁移或 Hub 写入操作。
实践记录
实践记录来自 Foundry 的 Activity 数据。Dock 不会把当前聊天内容重新写入 Hub，也不会为了展示而创建示例记录。
搜索和筛选
搜索框支持按标题、摘要、标签和来源相关信息匹配。搜索框下方的胶囊筛选与全局 Skills 页面保持一致：
全部：显示当前已查询到的所有记录。CodeBuddy、Codex等：只显示对应真实来源的记录。- 来源数量来自真实查询结果，不是静态配置。
切换工作台菜单时，搜索内容、来源筛选和当前详情选择会清空，避免把上一页的条件带到下一页。
时间排序
实践记录提供两个时间排序选项：
最新：按更新时间倒序，默认选中。最早：按更新时间正序。
时间优先使用 Foundry 返回的 updated_at，没有更新时间时回退到创建时间。界面按当前本地时区显示为 YYYY-MM-DD HH:mm:ss；排序只影响显示顺序，不改变原始记录。
候选能力、技能草稿和已发布技能
这些页面分别对应生命周期的后续阶段：
| 页面 | 作用 | 允许的下一步 |
|---|---|---|
| 候选能力 | 查看可复用模式及其证据 | 通过或驳回候选；通过后才可生成草稿 |
| 技能草稿 | 检查生成的 Skill 内容和状态 | 评估草稿；通过后才可发布 |
| 已发布技能 | 查看当前可复用能力 | 只读查看和打开详情 |
按钮是否出现取决于 Foundry 返回的 capability 和 permission。Dock 不会因为按钮显示就绕过 Maintainer、状态或评估门禁。
高风险操作会先显示确认提示，然后由 Extension Host 调用真实 MCP 工具：
- 候选评估：
candidate_evaluate - 生成草稿：
skill_generate - 草稿评估：
skill_evaluate - 发布技能：
skill_publish
如果 MCP 未连接、工具不支持或当前 Maintainer 没有权限，操作会被阻止并显示原因，不会模拟成功。
来源和诊断
左侧的 Usora 扫描诊断用于说明本机 Skills 来源是否存在、扫描到多少项目以及实际路径。路径默认截断以适应窄栏，悬浮可以查看完整路径，并支持复制。
Foundry 工作台中的数据状态则来自 hub_status 等真实 Foundry MCP 查询。两类信息用途不同：扫描诊断说明 Dock 能看到哪些 Skills，工作台状态说明 Foundry 生命周期数据是否可用。
常见问题
看不到 Foundry 工作台
先检查宿主是否安装并启用了 Usora Foundry MCP，然后执行 Usora Dock: Refresh。如果希望先看到菜单和连接引导，把 usoraSkillsExplorer.foundryWorkbenchMode 改为 always。
显示 Foundry 不可用
这表示 Dock 没有完成真实 MCP 连接，不代表 Skills 扫描失败。检查宿主插件是否启用、MCP server 是否可启动，以及配置的命令、参数和环境变量是否属于当前宿主。不要仅通过创建 .usora 目录来修复连接。
Codex 或 CodeBuddy 记录数量不一致
Dock 会在 Foundry 暴露 hub_query 时查询已登记的 Codex 和 CodeBuddy 来源，并按记录 ID 去重。来源筛选只反映当前 Foundry 返回的数据；请先刷新宿主 MCP，再刷新 Dock。
发布按钮不可见
发布必须满足：草稿状态通过评估、Foundry 暴露发布工具、Maintainer 权限允许发布。任一条件不满足时，Dock 会隐藏或禁用按钮。
安全边界
- 普通 Skills 浏览仍然是只读的。
- Foundry 写操作只通过真实 MCP 工具执行，并受能力、权限、状态和确认流程约束。
- Dock 不直接编辑 Hub JSON，不直接迁移数据，不删除用户记录。
- 搜索、来源筛选和时间排序都是本地视图状态，不会写回 Foundry。