# cortico-world-workbuddy 中文文档

规范地址：https://npmcn.com/package/cortico-world-workbuddy/

版本：0\.3\.5
npm 元数据更新时间：2026-11-03T08:24:51.187Z
中文译文更新时间：2026-11-03T09:34:06.127Z
软件包许可：MIT

本文由上游 README 机器翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/cortico-world-workbuddy
原文对照：https://npmcn.com/package/cortico-world-workbuddy/?lang=original
项目主页：https://github.com/aechoa215/cortico-world-workbuddy#readme
源码仓库：https://github.com/aechoa215/cortico-world-workbuddy

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：341 kB，34 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- Node.js 要求：\>=22
- 运行依赖：0 个
- 首次发布：2026-11-02T19:54:33.993Z
- 最新版本发布：2026-11-03T08:24:51.037Z
- 已发布版本数：7（近 12 个月 7 个）

## 中文简介

仅用于桌宠 Coo 的文字对话：按需调用本机已登录的 WorkBuddy 模型，读取本机登录态，列出模型目录与默认积分倍率；不提供 API、不代理其它应用。

## 安装

```sh
npm install cortico-world-workbuddy
```

也可以使用：`pnpm add cortico-world-workbuddy`、`yarn add cortico-world-workbuddy`、`bun add cortico-world-workbuddy`

## README

# cortico-world-workbuddy

把 **本机已登录的 WorkBuddy 客户端**的模型桥接进 [Coopanion](https://github.com/Pal-AI-Lab/Coopanion) 桌宠：Coo 可以直接调用你 WorkBuddy 账号里的模型，World 面板里可以浏览模型目录、查看每个模型的 **默认积分倍率**（如 `x0.79`）并点选要用的默认模型；`wb_*` 工具按需调用， 不开启任何「每轮强制走 WorkBuddy」的行为。

这是一个 Cortico 的 World 扩展（`kind: world`，`api: 6`），纯 ESM JS、零运行时依赖， 面板产物已随包构建好（`dist/webui.js`）。

> **风险提示**：本扩展使用的是 WorkBuddy 客户端自身的接口（非官方开放 API）， 上游一旦收紧限制，扩展可能失效。每次 `wb_chat` 调用都消耗**你自己账号**的积分， 按上游给出的倍率真实扣费；扩展不提供账号、不共享凭据、不绕过计费。 请自行评估账号风险，官方 WorkBuddy 客户端始终是最安全的选择。

## 用途与边界

本扩展只做一件事：在你与桌宠 Coo 进行**文字对话**时，让 Coo 按需调用你**本机已登录的 WorkBuddy 账号**里的对话模型，并把回答转述给你。

它不是、也不应被当作：

-   **通用 API 网关 / OpenAI 兼容服务**：扩展不监听端口、不对外提供 HTTP 接口， 除宿主内的 Coo 外没有任何调用方；
-   **批量、自动化或爬取工具**：没有批量接口、没有循环调用、没有后台任务， 每一次调用都由 Coo 在一次对话中显式发起；
-   **多账号池、凭据共享或转售服务**：只读取本机当前登录态，不收集、不上传、不共享凭据；
-   **绕过计费的手段**：每次 `wb_chat` 都按上游倍率真实扣你自己的积分， 扩展不伪造计费、不改写用量、不模拟官方客户端以外的身份。

请勿把本扩展或其组件用于上述任何用途，也不要把它改造成对第三方开放的模型服务。 把它接进「每回合强制调用」「多账号轮询」「给别的应用当 API」这类场景，既超出本扩展的设计， 也超出 WorkBuddy 服务条款允许的使用范围，风险与后果由使用者自行承担。

## 安装（0.3.5，Coopanion 0.2.17 实机验证）

一条命令（推荐，脚本会做完打包、装卸、哈希与版本校验）：

```powershell
powershell -NoProfile -ExecutionPolicy Bypass -File scripts/reinstall.ps1
```

手工装的话，三步：

1.  装 World 包。用 Coopanion 自带的 pnpm，**必须带 `--store-dir`**（否则 `ERR_PNPM_UNEXPECTED_STORE`），工作目录是 `<data>\extensions`；**同版本重装要先 remove** （`file:` 依赖按版本复用，不 remove 等于没装）：
    
    ```powershell
    cd "C:\Users\<你>\AppData\Local\Programs\Coopanion\data\extensions"
    node "C:\Users\<你>\AppData\Local\Programs\Coopanion\resources\app\node_modules\pnpm\bin\pnpm.cjs" remove cortico-world-workbuddy
    node "C:\Users\<你>\AppData\Local\Programs\Coopanion\resources\app\node_modules\pnpm\bin\pnpm.cjs" `
      add "$env:LOCALAPPDATA\cortico-world-workbuddy\build\cortico-world-workbuddy-0.3.5.tgz" `
      --config.strict-dep-builds=false `
      --store-dir "C:\Users\<你>\AppData\Local\Programs\Coopanion\data\pnpm\store\v11"
    ```
    
    也可以在 Coopanion 设置窗 → 高级模式 →「World 扩展」→ 手动安装里填本包目录的绝对路径。
    
2.  在 `data\home\companion\config.json` 的 `worlds.workbuddy` 段里确认开关（可选，面板也能改）：
    
    ```json
    "workbuddy": {
      "enabled": true, "model": "deepseek-v4.1-flash",
      "credentialsDir": "", "baseUrl": "", "maxTokens": 2048,
      "envPrompt": true
    }
    ```
    
3.  重启 Coopanion（ESM 模块缓存不支持热换代码），用带环境清理的启动器：
    
    ```powershell
    powershell -NoProfile -ExecutionPolicy Bypass -File scripts/launch-coopanion.ps1
    ```
    
    > **为什么要有启动器**：终端里残留 `ELECTRON_RUN_AS_NODE=1`（比如跑过 Node 子进程）时， 从这里启动的 Electron 会进入 **Node 模式**：窗口不出来、`Coopanion.exe --version` 打印 `v24.x`（node 版本）、`--enable-logging` 报 `bad option`。这不是二进制损坏， 是环境变量被继承。启动器只清本进程树里的这个变量，不动用户/机器级设置。
    

## 卸载与还原

1.  在「World 扩展」里卸载，或执行 `pnpm remove cortico-world-workbuddy`，然后重启 Coopanion。 详情页入口与 `wb_*` 工具随之消失，Coopanion 主体和其他 World 不受影响。
    
2.  宿主的卸载接口只删除扩展包，不会调用扩展清理逻辑，也不会删除部署配置和账本。 因此在源码目录再执行一次显式清理（先检查、后清理）：
    
    ```bash
    node scripts/clean-workbuddy.mjs --check
    node scripts/clean-workbuddy.mjs --clean
    ```
    
    清理范围只有：`config.json` 的 `worlds.workbuddy` 块、`.env` 的 `accessToken` 行 （真实 token 或 `wb-cleared` / `wb-auto` 哨兵），以及数据目录里的 `workbuddy-usage.jsonl`、`workbuddy-catalog.json`、`workbuddy-balance.json`。 其他配置、其他密钥和宿主文件不动，命令输出也不会显示 token。
    

-   **不碰宿主程序文件**：0.3.0 起扩展不再往 Coopanion 主界面注入脚本或按钮， `resources\app` 不会被改写。普通 `stop()` / 重启不会删除账本；只有上面的显式卸载清理会删。
-   **旧版本残留（0.2.x → 0.3.x）**：装过 0.2.x 的机器，另外执行 `node scripts/clean-legacy-injection.mjs --check` 并按结果使用 `--clean`，清除旧版留在 `build\console\` 的注入行、脚本与备份；脚本不覆盖 `index.html` 的其他内容。

## 工作原理

```
Coopanion (Coo)
  └─ World: workbuddy
       ├─ 主进程检测  tasklist / pgrep → WorkBuddy.exe 在不在跑（2.5s 缓存）
       ├─ 凭据发现   %LOCALAPPDATA%\CodeBuddyExtension\Data\Public\auth\workbuddy-desktop.info
       │              （$wbEncrypted 信封 → 用桌面端自己的二进制自动解封）
       ├─ 上游客户端 copilot.tencent.com（对话）/ www.codebuddy.cn（计费）
       │    ├─ GET  /v3/config                              模型目录 + 促销（models / modelPromotions / modelTiers）
       │    ├─ POST /v2/chat/completions                     对话（SSE 流式）
       │    └─ POST /v2/billing/meter/get-user-resource      积分余额（只读）
       ├─ 工具        wb_list_models / wb_select_model / wb_chat / wb_credits
       └─ WebUI 面板  模型目录（含只读主进程状态）、账号、用量与成本
```

-   **主进程检测**：桌面端的渲染进程都是主进程的子进程，所以「有 `WorkBuddy.exe`」等价于 「主进程在跑」。`wb_chat` / `wb_credits` 都以此为前提，不在跑时直接返回 「未检测到 WorkBuddy 主进程」，不打上游。
-   **凭据**：桌面端 5.7.x 起登录态在 `%LOCALAPPDATA%\CodeBuddyExtension\Data\Public\auth\` 下的 `workbuddy-desktop.info`（不是 `%APPDATA%\WorkBuddy\*.json`，也不是 `.json`）。 字段加密时，扩展会用 `WorkBuddy.exe` 自己的 `loggerGet()` 取 `atRestSecretKey` 自动解封， 不需要你手动设环境变量；实在拿不到时，在「账号」面板手动粘 access token 即可—— token 只经 `ctx.storeSecret()` 进部署的密钥库，**不写配置、不进日志、面板只显示掩码**。
-   **积分倍率**：完全来自上游目录的 `credits` 字段，扩展不写死；刷新后缓存到 `workbuddy-catalog.json`，重启不丢。
-   **登录态失效**：`/v3/config` 返回 401/403 时直接判 `session_dead` 并清掉本次 token； 下一次调用重新从本机凭据发现（桌面端自行刷新落盘）。本扩展不调用刷新接口， chat 请求也绝不携带 refresh token。
-   **上游**：目录与对话固定走 `copilot.tencent.com`，积分余额走 `www.codebuddy.cn`。 本扩展只支持这一套上游（本机已登录的 WorkBuddy 桌面端）；配了自定义 `baseUrl` 时两个域都由它替换。

## 主进程状态与按需调用

0.3.4 起没有「中转站优先」开关，也没有任何「每轮强制走 WorkBuddy」的行为：

-   「模型目录」面板顶部只读显示 WorkBuddy 主进程是否在跑（6 秒轮询，翻转时才推送）； 勾选框已删除，状态不参与任何开关逻辑。
-   `wb_*` 工具由 Coo 按需调用：用户点名 WorkBuddy、或某个 WorkBuddy 模型明显更合适时才用。 不调用就不花积分——这是「每个调用都真实扣积分」的默认前提。
-   环境提示词只描述事实（登录态、模型、倍率、主进程状态、今日用量）和工具用法， 不再命令「每轮先 `wb_chat`」。
-   主进程退出时面板状态会变成「未检测到」，工具调用直接返回明确错误，不需要切换任何开关。

## 面板

| 面板 | 内容 |
| --- | --- |
| 模型目录 | 顶部只读显示 WorkBuddy 主进程状态；刷新目录；逐模型一行：名称/id、**合规档位**、**此刻倍率**（含限时折扣时显示 `x0.5 ← x0.79 23:00–07:50`，x0 标「免费」）、上下文、推理档、「选用」按钮；默认只列安全清单，勾选「显示全部模型（含不建议项）」才展开其余项 |
| 账号 | 登录态来源（本机发现 / 手动）、掩码 token、积分余额查询、重新检测、手动 token 存取 |
| 用量与成本 | 区间概览（今天 / 近 7 天 / 近 30 天 / 全部，列：调用、失败、积分、输入/输出/缓存命中/合计 token）、按模型近 30 天聚合、积分包明细、限时优惠清单、最近调用；带「刷新余额」「清空本地账本」 |

### 安全清单（合规闸门）

WorkBuddy 官方对话给出的口径是：只调用「官方公开目录里、当前可正常对话」的模型， `disabled`、内部路由别名、媒体/代码补全与状态不明的模型都不要经外部软件调用，否则有风控/封号风险。 这里把它落成代码：

-   白名单 17 个（`src/safety.js` 的 `SAFE_MODEL_IDS`，0.3.5 起与 WorkBuddy「选择模型」列表逐项对齐， 按 DeepSeek / GLM / 混元 / Kimi / 其他分组）： `deepseek-v4.1-flash`、`deepseek-v4-pro`、`glm-5.3`、`glm-5.3-flash`、`glm-5.3-flashx`、`glm-5.2`、 `hy3`、`hy4-preview`、`kimi-k2.8-preview`、`kimi-k3-2`、`kimi-k3.1-pro`、`kimi-k3.1-pro-highspeed`、 `minimax-m3-pay`、`minimax-m3.1-flash`、`mimo-v2.6-pro`、`space-bunny`、`step-5-preview`。 其中 `hy3`、`kimi-k2.8-preview`、`step-5-preview`、`hy4-preview` 标为「谨慎」（免费试用/预览，别做高频自动化）。
-   旧 id `kimi-k3-1` 在 v3 目录里已不存在（Kimi-K3 现在只对应 `kimi-k3-2`），0.3.5 一并换掉； 同时移除了应用选择器不显示、但目录里仍可调用的 8 个 id（`deepseek-v4-flash`、`deepseek-v3-2-volc`、 `hy3-b`、`hy3-c`、`hy3-x`、`kimi-k2.5`、`minimax-m2.7`、`hunyuan-chat`）——其中 `hunyuan-chat` 在 v3 目录里没有 `credits` 字段，倍率无法核验。
-   其余全部**拒绝**：`wb-lite`（目录 `disabled:true`）、`auto` / `fast-model` / `balanced-model` / `deep-model`（内部路由别名）、4 个媒体模型、`codewise-*`、其他 `hy4-preview*` 变体（只精确放行 `hy4-preview`）、19 个已下架的、 `glm-5.0-turbo`（11150 请求格式不符）。
-   闸门是 `worlds.workbuddy.safeOnly`（默认 `true`）。开着时 `wb_chat` / `wb_select_model` / 面板「选用」 三处一致拒绝，并说明「判定档位 + 理由 + 怎么解除」；关掉才放行，属于明示的风险自负。
-   清单是按 2026-11 的官方目录定的，官方加新模型不会被自动信任——这正是「未列入安全清单」这一档的意义。

### 倍率与限时优惠怎么算

-   目录来自 `GET /v3/config`（应用身份 UA）：一次同时拿到 `models`、`modelPromotions`、`modelTiers`。 用 CLI 身份只能读到精简目录，促销字段会整段缺失——这是「倍率永远显示原价」的根因。
-   一条促销的生效条件是 `schedule`：`timezone`（省略时按 `Asia/Shanghai`）、`validFrom`/`validUntil`、 `daily` 时段（支持 `23:00`→`07:50` 这类跨零点窗口）。纯日期按当地自然日解释，`validUntil` 包含当天； 命中的条目按 `priority` 取最高，平手时促销优先于档位。
-   `discount.discountedCredits`（如 `0.50x`）**就是生效倍率本身**，不是相对原价的系数。 `displayMode: "replace"` 直接替换显示，`"strikethrough"` 表示「划线原价 + 新价」并排。
-   `badge.display: "activeOnly"` 的徽标只在生效时段出现（如「限时免费」试用）。

### 用量统计口径

-   每次 `wb_chat` 记一行到 `%APPDATA%\..\Coopanion\data\home\companion\data\workbuddy-usage.jsonl` （实机路径；实际就是 `ctx.dataDir`）：`ts/model/ok/promptTokens/completionTokens/totalTokens/cachedTokens/reasoningTokens/credit/multiplier/baseMultiplier/promoId/source/durationMs`。
-   `credit` 取 SSE 各段合并后的 `usage.credit`，即**上游真实扣费**；倍率 0.11 的模型单次请求不足 1 分时上游就是 0，这里照抄不折算。 上游未回传时记为未知，概览用 `+ ?` 标出缺口，绝不当成 0；`multiplier` 是响应完成时的生效倍率，`baseMultiplier` 是目录原价。
-   积分包余额另存 `workbuddy-balance.json`（`POST /v2/billing/meter/get-user-resource` 的 `*Precise` 字段求和）， 面板上的「刷新余额」会重取一次。
-   账本只保留 90 天，读的时候顺带裁掉；「清空本地账本」会把它清成空文件，服务端数据不受影响。

## 工具（给 Coo / 模型调用）

| 工具 | 作用 |
| --- | --- |
| `wb_list_models` | 列出**安全清单内**的模型及此刻倍率（含限时优惠与时段），并单列优惠清单；传 `all=true` 才带上被排除项与理由（只读） |
| `wb_select_model` | 按 id 选择 `wb_chat` 的默认模型，持久化；提示此刻倍率；安全清单外会被拒 |
| `wb_chat` | 用选中模型回答一个单轮问题（**真实消耗积分**，需主进程在跑）；回执附输入/输出/缓存 token 与本次积分；安全清单外会被拒 |
| `wb_credits` | 只读查询积分余额与本周期已用（需主进程在跑） |

## 配置（`worlds.workbuddy.*`）

| 键 | 默认 | 说明 |
| --- | --- | --- |
| `model` | `""` | 当前模型 id（面板点选即写这里） |
| `credentialsDir` | `""` | 自定义凭据目录，留空自动发现（重启生效） |
| `baseUrl` | `""` | 自定义上游地址，代理/中转用（重启生效） |
| `maxTokens` | `2048` | `wb_chat` 单次输出上限 |
| `envPrompt` | `true` | 是否把桥接状态写进 system 前缀 |
| `safeOnly` | `true` | 只允许调用安全清单内的公开对话模型；关掉会放行 disabled / 别名 / 预览等项，风险自负 |

## 开发与校验

```bash
# 重新构建面板产物（改了 src/webui/client.js 后）
# 优先用本地 devDependency（锁在 package-lock.json 的 0.24.2），没装则退回宿主自带的 esbuild；
# `prepack` 走 `--strict`：两条路都没有就直接失败，绝不静默发布过期 dist。
node scripts/build-web.mjs

# 契约检查（不依赖宿主，CI 必跑）：describe.json 与源码一致、版本号与 CHANGELOG 对齐、
# 促销/安全清单/账本断言，以及哨兵、计费域、429 软硬、面板白名单、并发、SSE flush 等回归断言；
# 0.3.1 另加 session_dead 分类、无效时段、rediscover 覆盖、跨日归零等防线（contract-regression.mjs）
node scripts/contract.mjs

# 由源码重新生成 describe.json（改过工具声明或 ENV_PROMPT.md 之后）
node scripts/gen-describe.mjs

# 框架契约自检（dry-mount：定义、工具、envPrompt、webUi）
# 缺宿主时（CI）自动改跑「离线检查」：全部文件 node --check + contract，不再无条件成功
node scripts/selfcheck.mjs

# 真实窗口 UI 验证（headless Chrome + CDP，连跑 5 轮；需 Coopanion 正在运行）
node scripts/verify-ui.mjs --runs 5

```

UI 验证脚本的两个约定（踩过坑，别再用固定 sleep）：每轮导航都带 `?t=<时间戳>` 整页重载 （`Page.navigate` 只改 hash 属于同文档导航，不会重新加载），元素等待统一走 15 秒轮询， 并把「路由挂载」与「面板渲染」拆成两条断言——否则一次产物没加载就会被误判成「按钮没了」。

版本号规范：任何改动都 bump `package.json` 的 `version`，备份目录按版本命名 （`F:\coo-connect-wb\0.3.5\`），再用 `scripts/reinstall.ps1` 装；它先把 tgz 解出来，再拿**解出来的内容**与安装目录逐文件比对哈希， 不一致直接非零退出。

打包注意：**不要用 PowerShell 的 `Get-Content -Raw | Set-Content` 改 `package.json`** （会带 BOM / 把中文写坏，pnpm 报 `Bad control character in string literal in JSON`）， 用 node 读写 JSON；tgz 必须以 `package/` 为前缀：

```bash
tar -czf cortico-world-workbuddy-0.3.5.tgz -C <stage> package
```

协议细节参照 [dsh-connect-workbuddy](https://github.com/dingminhua/dsh-connect-workbuddy) （MIT）的实测结论；扩展框架契约见 Cortico 的 `docs/extensions.md` / `docs/worlds.md` / `docs/webui.md`。

## 宿主文件：一个字节都不改

0.3.0 起本扩展**不再往 Coopanion 主界面注入任何东西**——详情页只有三个只读/配置面板， 没有开关勾选框，`resources\app` 下不会有任何改动；部署配置、账本与手动 token 按上一节的显式步骤清理。

如果你装过 0.2.x，宿主 `build\console\` 里可能还留着三处痕迹。扩展本体不会自动改 宿主文件（这正是 0.3.0 起的承诺），请用一次性迁移脚本清理：

```bash
node scripts/clean-legacy-injection.mjs --check   # 只列出会动的项
node scripts/clean-legacy-injection.mjs --clean   # 执行清理（幂等）
```

| 文件 | 脚本会做什么 |
| --- | --- |
| `<app>\build\console\index.html` | 只剥掉 `<script type="module" src="./workbuddy-home.js"></script>` 这一行，保留原有换行风格与其余内容 |
| `<app>\build\console\workbuddy-home.js` | 删除旧的注入脚本 |
| `<app>\build\console\index.html.workbuddy-backup` | 删除首次注入前的原件备份 |

## 发布（GitHub / npm / 扩展市场）

Cortico 的扩展**从 npm 安装**；GitHub 是源码与申请的入口，官方索引仓 [cortico-extensions](https://github.com/Pal-AI-Lab/cortico-extensions) 只放标签词表、认证与覆盖项。 Action 定时扫 npm 生成市场目录，所以发版顺序是：**先 npm publish，再 `[sync]` 催收录**。

本包发布元数据：

| 项 | 值 | 为什么 |
| --- | --- | --- |
| `os` | `["win32"]` | 只在 Windows 实机验证过；macOS/Linux 的凭据与进程探测代码在，但没跑过，不虚报 |
| `cortico.tags` | `unofficial-api`, `external-setup`, `sensitive-data` | 用账号调客户端内部接口 / 需先装 WorkBuddy 桌面端 / 会读本机凭据文件 |
| `License` | MIT（`LICENSE` 随包） | 市场与 npm 页都会读 |
| `engines.node` | `>=22` | 与 Coopanion 0.2.x 的运行环境一致 |
| `cortico.describe` | `describe.json` | 工具 / 事件 / 环境提示词的机器可读自描述，工具变了要重新生成 |

发布步骤：

```bash
# 1. 发版前三连检（需要本机真实宿主）
node scripts/contract.mjs        # 不依赖宿主，全部断言
node scripts/selfcheck.mjs       # dry-mount 框架契约
node scripts/verify-ui.mjs --runs 3

# 2. 提交并打 tag
git tag v0.3.5 && git push --tags

# 3. 发布（prepack 会自动重建 dist/webui.js）
npm publish --access public

# 4. 让市场立刻收录（可选；Action 也会定时扫）
gh issue create -R Pal-AI-Lab/cortico-extensions --title "[sync] cortico-world-workbuddy" --body ""
```

对标签有异议用 `[tags]`、申请蓝标认证用 `[certify]`、被拉黑申诉用 `[appeal]`， 正文一行一项 `键: 值`（`package` / `add` / `remove` / `reason` / `evidence`）。

CI 里没有 Coopanion：自检改跑离线检查（全部源码 `node --check` + `contract`）， 不会红叉，也不会无条件算通过：

```bash
node scripts/selfcheck.mjs --allow-missing-host   # 找不到宿主 → 警告 + 退出码 0
```

凭据读取范围与网络出口见 [SECURITY.md](https://npmcn.com/package/cortico-world-workbuddy/SECURITY.md)：读哪些文件、默认只发给哪两个官方域名 （配了自定义 `baseUrl` 时从该出口走）、哪些从不写盘。

## 免责

本扩展与腾讯 / WorkBuddy 官方无关，也不代表 Pal AI Lab / Cortico / Coopanion 官方立场。 它使用的不是 WorkBuddy 官方开放 API，而是本机客户端自身的接口；上游一旦调整或收紧， 扩展可能失效，也可能带来账号层面的风险。

使用即表示你理解并接受：

1.  **仅限个人、本地、桌宠文字对话中的按需调用**——这是本扩展唯一的设计用途；
2.  所有调用消耗**你自己账号**的积分，倍率与扣费以上游为准，扩展只做记录与展示；
3.  账号状态、积分变动、风控与封禁由上游裁量，本扩展作者不承担任何责任；
4.  把本扩展用于对外提供接口、批量调用、多账号共享、绕过计费或其它未声明用途， 属于超出设计范围的使用，后果由使用者自行承担。

凭据读取范围、网络出口与本扩展写盘内容见 [SECURITY.md](https://npmcn.com/package/cortico-world-workbuddy/SECURITY.md)。 官方 [服务条款](https://www.workbuddy.cn/document/term) 与 [可接受使用政策](https://www.workbuddy.cn/document/acceptable-use-policy) 始终优先于本扩展的任何行为。

## 常见问题

### cortico-world-workbuddy 是什么？

仅用于桌宠 Coo 的文字对话：按需调用本机已登录的 WorkBuddy 模型，读取本机登录态，列出模型目录与默认积分倍率；不提供 API、不代理其它应用。

### 如何安装 cortico-world-workbuddy？

在项目目录运行 npm install cortico-world-workbuddy，或使用 pnpm add / yarn add / bun add。

### cortico-world-workbuddy 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/cortico-world-workbuddy 是否存在。

### cortico-world-workbuddy 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### cortico-world-workbuddy 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=22。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### cortico-world-workbuddy 可以商用吗？

cortico-world-workbuddy 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### cortico-world-workbuddy 还在维护吗？

最新版本 0\.3\.5 发布于 2026/11/03（今天）；至今共发布 7 个版本，其中过去 12 个月发布了 7 个；首次发布于 2026/11/03。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。