PineAgents 品牌分布盘点清单（基于 QwenPaw 二次开发）

目标：把 QwenPaw 品牌改造成 PineAgents。本文档是「改哪些、改哪里」的精确清单，供改造与上游同步时对照。统计基于当前工作区 QwenPaw v2.1.0b1。品牌关键词：QwenPaw / qwenpaw / CoPaw / copaw / Paw。

0. 持久化标识 —— 最高风险，改动会破坏旧数据

这些不只是文案，改动后旧数据/旧配置可能无法被新版本读取，必须走迁移或保留兼容回退：

标识	位置	说明	风险
工作目录 `~/.qwenpaw`	`src/pineagents/constant.py:112`	所有数据落盘根目录	改→旧数据不可见
密钥目录 `~/.qwenpaw.secret`	`constant.py:113` (`SECRET_DIR`)	模型 API Key 等	改→旧密钥丢失
Keyring 账号 `QWENPAW_KEYRING_ACCOUNT`	`constant.py:125`	OS 钥匙串主密钥账号	改→主密钥失配
环境变量前缀 `QWENPAW_`（含 `COPAW_` legacy 回退）	`constant.py:18-24` `_get_env`	全部配置的取值来源	改→配置读不到
消息元数据标签 `qwenpaw_tag` / `qwenpaw_client_message_id`	`constant.py:130-131`	持久化在消息里的 tag	改→旧消息 tag 失效
内置 QA Agent ID `QwenPaw_QA_Agent_0.2`	`constant.py:207`	会话归属标识	改→旧会话对不上
Legacy QA Agent ID `CoPaw_QA_Agent_0.1beta1`	`constant.py:218`	兼容遗留	建议保留

建议：PineAgents 若为全新部署，可全部改名；若需继承 QwenPaw 用户数据，则保留 keyring 账号、消息 tag、Agent ID 不变，只改展示层品牌。

1. Python 后端（271 个文件含品牌词，按热度）

目录	文件数	改动类型
`cli/`（含 `tui/` 终端界面）	25 + 8	命令名、提示文案、TUI 标题
`app/routers/`	15	REST API 路由/前缀、返回的展示名
`providers/`	12	模型供应商展示名、`qwenpaw_local` 本地运行时命名
`agents/`（含 `tools/`、`context/scroll`、`memory`、`acp`）	~40	内置 Agent 名、提示词、工具元信息、Scroll 上下文键
`runtime/`	7	循环执行、slash 命令注册里的品牌名
`checkpoints/`	7	会话/检查点命名
`plugins/`	6	插件目录/命名
`harnesses/`	6	coding/mission 模式标题
`governance/`、`sandbox/`、`security/`	~15	治理/沙箱/安全规则里的品牌引用
`tauri/`	5	桌面壳命名
其余（browser、local_models、backup、pawapp、market、envs、hooks、utils…）	分散	低风险文案

1.1 核心配置锚点（改品牌优先改这里）

src/pineagents/constant.py:127 → PROJECT_NAME = "QwenPaw" → 改为 "PineAgents"
src/pineagents/__version__.py → 版本号（当前 2.1.0b1）
src/pineagents/__init__.py → LOG_LEVEL_ENV = "QWENPAW_LOG_LEVEL"
pyproject.toml:113-114 → 命令入口 qwenpaw / copaw → 增加/改为 pineagents

2. 前端 Console（147 个文件含品牌词，按热度）

目录	文件数	改动类型
`locales/`	8	多语言界面文案（zh/en/ja/ru/vi…）
`utils/`、`hooks/`、`stores/`	16	常量、状态、工具函数里的品牌引用
`api/`（含 `modules/`）	10	API 请求头、模块名、配置 URL
`layouts/`（含 `registry/`）	10	侧边栏、顶栏、菜单、路由标题
`pages/Settings/**`	~20	设置页（Agents/Models/Market/PawApps…）展示名
`pages/Agent/`、`pages/Chat/`	~20	Agent 配置、聊天界面品牌文案
`plugins/`（含 `hostSdk`、`pawapp-sdk`）	8	插件宿主命名
`tauri/`	4	桌面壳

2.1 非 ts/tsx 资源

console/index.html → <title>、favicon、meta
console/package.json → 应用名
静态资源：logo / favicon / 启动图（位于 console/public/，需替换为 PineAgents 品牌素材）

3. 打包 / 部署 / 文档（改品牌必改，否则安装产物仍叫 QwenPaw）

文件	改动点
`pyproject.toml`	`name="qwenpaw"`(L2)、`[project.scripts]`(L113-114)、Homepage/Repository 等 URL(L74-78)、`[tool.coverage.run] source`(L179)、`[tool.setuptools.package-data]`(L88)
`setup.py`	透传 pyproject
`docker-compose.yml`	镜像名 `agentscope/qwenpaw`、容器/卷命名
`deploy/Dockerfile`、`deploy/entrypoint.sh`	镜像内路径、启动命令
`scripts/docker_build.sh`、`scripts/install.sh`、`scripts/wheel_build.sh`	安装/构建脚本里的命令名与路径
`Makefile`	测试覆盖路径等
`website/`	官网文案与品牌
根目录 `README.md`、`CONTRIBUTING.md`、`RELEASING*.md`	全部改名或替换为 PineAgents 版本文档

4. 许可证（本次已决策）

原 LICENSE（Apache 2.0）→ 改名为 LICENSE_QwenPaw（保留上游署名）
新增 PineAgents 闭源商业 LICENSE（见骨架步骤）
新增修改说明文档，记录所有基于 QwenPaw 的改动

5. 遥测（商业产品必关/必换）

qwenpaw init 会上报匿名使用数据（版本/安装方式/OS/Python/CPU/GPU），见 README.md「遥测」节
PineAgents 商业版默认关闭或替换为自有遥测

6. 同步策略提醒

品牌改造与上游同步冲突最大的两个点：环境变量前缀 + 持久化标识（第 0 节）和 PROJECT_NAME/命令入口。建议全部收敛到单一配置层（见抽离方案），避免每次 rebase 手工解冲突。

5.5 KiB Raw Blame History Unescape Escape