sitdraw

如何使用 Pieces for Developers：安装桌面版与 VS Code 扩展、保存代码片段与本地 AI 搜索

安装 PiecesOS 与 VS Code 扩展，保存第一条代码片段，用 Pieces Drive 或对话搜索在本地找回它。

第一次在 VS Code 里用 Pieces for Developers，卡住的通常不是提示词，而是 PiecesOS 有没有在后台跑、扩展装完有没有重启，以及保存的第一条片段能不能在 Pieces Drive 里立刻看到。

检索词是 如何使用 Pieces for Developers 安装桌面版与 VS Code 扩展。下文对照 docs.pieces.app 的 PiecesOS、VS Code 入门与 Drive 文档。这是 Pieces 的开发者工具套件，不是本站会议产品。要约短会对齐改动，用 sitdraw 建房即可，步骤见 如何创建与加入房间。

安装 PiecesOS装 VS Code 扩展保存与搜索片段

PiecesOS 是前提

Pieces for VS Code 扩展必须连接本机 PiecesOS。桌面版安装时会自动部署该后台服务；它负责本地片段存储、LTM 捕获与 AI 模型请求协调。官方建议同时安装 Pieces Desktop App 以便编辑片段元数据。2026 年 6 月 5 日起，PiecesOS 需 12.4.0 或更高 才能恢复 Chat、Work Summaries 等云端能力。

本地片段离线可用
Drive保存与浏览
LTM可选长期记忆

第一次：安装、登录、保存、搜索

  1. 1. 安装 Pieces Desktop App（含 PiecesOS）

    前往 pieces.app 下载 macOS / Windows / Linux 安装包。安装完成后确认菜单栏或系统托盘有 PiecesOS 运行指示。可选注册 Pieces 账号以使用云端增强模型与分享链接；核心片段数据仍存本机。

  2. 2. 安装 VS Code 扩展

    Cmd+Shift+X 或 Ctrl+Shift+X，搜索 Pieces for VS Code，Install。也可从 Marketplace 下载 .vsix。装完 Restart VS Code。

  3. 3. 保存第一条片段

    打开自己的仓库，选中一段代码，右键 → Pieces → Save Current Selection to Pieces。Walkthrough 也可点 Save Your First Material 自动生成示例。打开 Pieces Drive 侧栏应能看到刚存的片段与 AI 生成的描述。

  4. 4. 搜索与 Conversational Search

    命令面板运行 Pieces: Search Pieces，或侧栏打开 Conversational Search，用自然语言提问并 @ 引用已存材料。LTM 需在 PiecesOS 设置里手动 Enable Long-term memory。

# First hour · Pieces for Developers · 2026-09
# 1. pieces.app → Desktop App (PiecesOS auto)
# 2. VS Code → Pieces for VS Code → Restart
# 3. Save Current Selection to Pieces
# 4. Pieces Drive · Pieces: Search Pieces
# Docs: docs.pieces.app/products/extensions-plugins/visual-studio-code

保存、搜索与隐私

保存选中代码右键 → Pieces → Save Current Selection也可 Save Active File
浏览片段活动栏 Pieces Drive 图标元数据在桌面版也可改
精确搜索命令面板 Pieces: Search Pieces可按标题/标签/内容过滤
对话搜索Conversational Search 侧栏可引用文件夹作上下文
长期记忆PiecesOS → Enable LTM数据存本机，可关源
与 Copilot 类工具的区别
Pieces 侧重保存、组织、找回你自己的片段与工作流记忆；补全型助手见本站 Codeium 教程 或 Tabnine 教程。
Cursor 也能用
官方文档写明扩展兼容 VS Code 系 IDE（含 Cursor）。仍需本机 PiecesOS。
教程页不是会议说明书
只讲 Pieces 第一次。短会见 sitdraw 与 白板对照。

还想核对的问题

扩展连不上 PiecesOS？

确认桌面版或 PiecesOS 服务在运行；重启 VS Code；检查防火墙是否拦截本地端口。PiecesOS 版本需 ≥ 12.4.0（2026 年 6 月后）。

片段存在哪里？

保存在本机 Pieces Drive，离线可访问。云端仅在使用需 LLM 的功能时发送 scoped 上下文，官方称 SOC 2 Type II 且不用用户数据训练模型。

如何排除敏感仓库？

保存前 Pieces 会扫描 API 密钥等；LTM 可在 PiecesOS 里禁用特定来源。不要把 .env 或密钥写进 Conversational Search 提示。

开始画