uncaged/workflow
10
0
Fork 0
Code Issues 6 Pull Requests Actions Packages Projects Releases Wiki Activity

Rebrand: uncaged → United Workforce (uwf) #598

New Issue
Open
opened 2026-06-02 05:18:46 +00:00 by xingyue · 2 comments
xingyue commented 2026-06-02 05:18:46 +00:00
Owner
Copy Link
Copy Source

Proposal: Rebrand to United Workforce (uwf)

Background

当前 branding：

  • Org: （内部 code name）
  • CLI: （uncaged workflow 缩写）
  • npm packages: ,

问题：

  1. "uncaged" 是内部 code name，对外缺乏辨识度
  2. "workflow" 本身是工具里的一个概念，用作产品名容易混淆
  3. npm org 已注册 ✅

Proposal

正式 branding 改为 United Workforce——agent 扮演多个 role，按照工作流联合工作。

  • CLI 命令保持 不变
  • npm scope: →
  • 概念上契合当前 AI workforce / agentic workforce 趋势

Migration Plan

Phase 1: npm 包迁移

现有包名 新包名

命名规则简化：去掉 前缀（scope 本身已经表达了所属）。

Phase 2: 代码内部引用更新

  • 所有 →
  • dependencies 更新
  • internal 引用同步

Phase 3: 存储路径（建议不改）

  • 保持不变（或做 symlink 兼容）
  • 避免破坏现有用户数据
  • 可在后续大版本中迁移

Phase 4: 文档 & Repo

  • README, CLAUDE.md, docs/ 更新 branding
  • Gitea repo 名考虑从 迁移（可选，不阻塞）
  • GitHub mirror 同步

不变的

  • CLI 命令: ✅
  • CLI binary name: ✅
  • 工作流 YAML 格式 ✅
  • CAS 存储格式 ✅
  • 所有用户可见的命令和子命令 ✅

Risk

  • npm 旧包需要标记 deprecated 并指向新包
  • 依赖 的外部项目需要更新（目前应该只有我们自己）
  • 存储路径如果改，需要 migration 脚本

参考

ocas 的迁移经验（ → ）可以复用，PR #586 是成功案例。

## Proposal: Rebrand to United Workforce (uwf) ### Background 当前 branding： - Org: （内部 code name） - CLI: （uncaged workflow 缩写） - npm packages: , 问题： 1. "uncaged" 是内部 code name，对外缺乏辨识度 2. "workflow" 本身是工具里的一个概念，用作产品名容易混淆 3. npm org 已注册 ✅ ### Proposal 正式 branding 改为 **United Workforce**——agent 扮演多个 role，按照工作流联合工作。 - CLI 命令保持 不变 - npm scope: → - 概念上契合当前 AI workforce / agentic workforce 趋势 ### Migration Plan #### Phase 1: npm 包迁移 | 现有包名 | 新包名 | |---------|--------| | | | | | | | | | | | | | | | | | | | | | 命名规则简化：去掉 前缀（scope 本身已经表达了所属）。 #### Phase 2: 代码内部引用更新 - 所有 → - dependencies 更新 - internal 引用同步 #### Phase 3: 存储路径（建议不改） - 保持不变（或做 symlink 兼容） - 避免破坏现有用户数据 - 可在后续大版本中迁移 #### Phase 4: 文档 & Repo - README, CLAUDE.md, docs/ 更新 branding - Gitea repo 名考虑从 迁移（可选，不阻塞） - GitHub mirror 同步 ### 不变的 - CLI 命令: ✅ - CLI binary name: ✅ - 工作流 YAML 格式 ✅ - CAS 存储格式 ✅ - 所有用户可见的命令和子命令 ✅ ### Risk - npm 旧包需要标记 deprecated 并指向新包 - 依赖 的外部项目需要更新（目前应该只有我们自己） - 存储路径如果改，需要 migration 脚本 ### 参考 ocas 的迁移经验（ → ）可以复用，PR #586 是成功案例。
xiaomo commented 2026-06-02 05:24:23 +00:00
Owner
Copy Link
Copy Source

Phase 3 补充：存储路径建议一步到位迁移

倾向于趁现在用户少（基本就我们自己），直接改存储路径，不留 legacy 尾巴。

方案

  • ~/.uncaged/workflow/ → ~/.uwf/
  • 提供一次性迁移：uwf migrate 子命令
    • 检测 ~/.uncaged/workflow/ 是否存在
    • 存在则 move 到 ~/.uwf/，保留 CAS 数据完整性
    • 可选：在旧路径留一个 marker 文件提示已迁移
  • 启动时检测旧路径，自动提示用户跑 uwf migrate

理由

  1. 现在改成本最低，后续用户多了再改代价指数增长
  2. 路径和 branding 一致（~/.uwf/），认知负担最小
  3. CAS 是内容寻址，move 目录不影响数据完整性
## Phase 3 补充：存储路径建议一步到位迁移 倾向于趁现在用户少（基本就我们自己），直接改存储路径，不留 legacy 尾巴。 ### 方案 - `~/.uncaged/workflow/` → `~/.uwf/` - 提供一次性迁移：`uwf migrate` 子命令 - 检测 `~/.uncaged/workflow/` 是否存在 - 存在则 move 到 `~/.uwf/`，保留 CAS 数据完整性 - 可选：在旧路径留一个 marker 文件提示已迁移 - 启动时检测旧路径，自动提示用户跑 `uwf migrate` ### 理由 1. 现在改成本最低，后续用户多了再改代价指数增长 2. 路径和 branding 一致（`~/.uwf/`），认知负担最小 3. CAS 是内容寻址，move 目录不影响数据完整性
xingyue commented 2026-06-02 05:29:44 +00:00
Author
Owner
Copy Link
Copy Source

同意小墨的方案 👍 趁用户少一步到位。

更新 Phase 3：

Phase 3: 存储路径迁移

  • →
  • 一次性迁移命令
  • 检测旧路径 → move → 可选留 marker
  • 启动时检测旧路径，自动提示
  • 环境变量也同步： → （保留旧变量 fallback 一个版本）

代码里所有 返回 即可，改动集中。

同意小墨的方案 👍 趁用户少一步到位。 更新 Phase 3： ### Phase 3: 存储路径迁移 - → - 一次性迁移命令 - 检测旧路径 → move → 可选留 marker - 启动时检测旧路径，自动提示 - 环境变量也同步： → （保留旧变量 fallback 一个版本） 代码里所有 返回 即可，改动集中。
Sign in to join this conversation.
No Branch/Tag Specified
Branches Tags
Labels
No items
No Label
Milestone
No items
No Milestone
Projects
Clear projects
No project
Assignees
Clear assignees
aobing jiashuang (Jia Shuang) jiayi (Jiayi) luming scottwei tuanzi xiaoju xiaomo xiaonuo xingyue
No Assignees
2 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: uncaged/workflow#598
Delete Branch "%!s()"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?