WorkBuddy 报价旁路包（PC · GitHub 优先 · 与 Mixing 隔离）

仓库： https://github.com/JASMINE145-ACT/workbuddy-quote-pack （私有）
交付方式： 员工 git clone 后用 WorkBuddy 打开本仓库根目录（若在 monorepo 内则为 workbuddy-quote-pack 子目录）。
WorkBuddy 会读 AGENTS.md + .mcp.json（仍需员工填密钥并批准 MCP）。
非目标： iOS；打进 Mixing NSIS。

员工步骤

1. 安装 Bun（PATH 或 %LOCALAPPDATA%\.bun\bin\bun.exe）— dist 必须用 Bun，不能用 Node
2. git clone https://github.com/JASMINE145-ACT/workbuddy-quote-pack.git
3. WorkBuddy 打开该仓库根目录
4. pip install -r requirements.txt（建议 Python 3.11）
5. MCP env：ORG_USERNAME + LLM_SELECTOR_API_KEY + LLM_SELECTOR_BASE_URL + LLM_SELECTOR_MODEL
6. 无 monorepo：设 CCB_REPO_ROOT，或 IT 跑 stage-runtime-from-repo.ps1 → runtime/

排障见 TROUBLESHOOTING.md（Bun vs Node、stdout 污染、selector 环境变量等）。

首次登录：

$env:ORG_USERNAME = "<user>"
$env:ORG_PASSWORD = "<pass>"
python .\ensure-org-session.py
python .\smoke-org-api-source.py
# → source=org_api

详细清单见 REQUIREMENTS.md。

WorkBuddy 会读什么

文件	作用
AGENTS.md	项目级助手说明（指向 system-prompt）
.mcp.json	项目 MCP：quotation → start-quotation-mcp.ps1
system-prompt.md	完整查价 SOP
ALLOWED_TOOLS.md	工具白名单（含库存）
env.example	环境变量说明（无密钥）
requirements.txt	Python 依赖
TROUBLESHOOTING.md	Connection closed / Bun / selector 清单

不会自动出现的： org 密码、selector key、Accurate AOL_* —— 必须员工自配。

运行时（无 CCB 安装）

start-quotation-mcp.ps1 解析顺序：

1. 本目录 runtime/（IT 可用 stage-runtime-from-repo.ps1 生成，勿提交 token）
2. 已装的 CCB-Wanding（一般没有）
3. 上层 monorepo（RepoRoot / 默认 D:\Projects\claude-code-best）

推荐：员工直接 clone 含本目录的 monorepo（或 sparse checkout），这样不必 stage zip。

架构

WorkBuddy 打开本目录
  → AGENTS.md + .mcp.json
  → start-quotation-mcp.ps1
       · ensure org JWT → %LOCALAPPDATA%\CCB-Wanding\workbuddy\
       · PRICE_LKG_DIR 隔离
       · 进程级 selector / AOL
  → quotation-server stdio → source=org_api

IT / 仓库维护

• 本包只改 ccb-installer/workbuddy-quote-pack/（+ 本 task 文档）；禁止改 Mixing agent / NSIS。
• zip（pack-zip.ps1）仅作离线备份，不是主交付。
• 推 GitHub：私有仓即可；不要提交 .org-session.token / .env / 真实 key（已在 .gitignore）。

验收

1. smoke-org-api-source.py → source=org_api
2. 无 selector → start 报 Missing selector key
3. WorkBuddy 聊天「直接50」→ 锁码 + B 价（配齐 key 后）

Rollback

删 %LOCALAPPDATA%\CCB-Wanding\workbuddy\ + 卸项目 MCP。不影响 Mixing。