shazhou/united-workforce
8
0
Fork 0
Code Issues 8 Pull Requests 1 Actions Packages Projects Releases Wiki Activity

Phase 2: 存储路径迁移 ~/.uncaged/workflow → ~/.uwf #9

New Issue
Closed
opened 2026-06-02 11:56:00 +00:00 by xingyue · 2 comments
xingyue commented 2026-06-02 11:56:00 +00:00
Owner
Copy Link
Copy Source

Goal

统一存储路径，从 ~/.uncaged/workflow/ 迁移到 ~/.uwf/。

涉及路径

现有 新
~/.uncaged/workflow/ ~/.uwf/
~/.uncaged/workflow/config.yaml ~/.uwf/config.yaml
~/.uncaged/workflow/threads.yaml ~/.uwf/threads.yaml
~/.uncaged/workflow/registry.yaml ~/.uwf/registry.yaml
~/.uncaged/workflow/running/ ~/.uwf/running/
~/.uncaged/workflow/history.jsonl ~/.uwf/history.jsonl

环境变量

现有 新
UNCAGED_WORKFLOW_STORAGE_ROOT UWF_STORAGE_ROOT
UNCAGED_CAS_DIR 移除（统一用 ocas 的 ~/.ocas/）
WORKFLOW_STORAGE_ROOT 保留为 fallback，下个大版本移除

Tasks

  • 更新 getDefaultStorageRoot() 函数（3处）
  • 更新所有代码中的硬编码引用（注释、reference docs）
  • 启动时自动迁移：检测旧路径存在 → symlink → 提示用户
  • 更新环境变量名，保留旧名为 fallback
  • 更新 CLAUDE.md / docs

Notes

  • CAS 路径不在此 phase 改（Phase 3 处理）
  • 需要 migration 逻辑，不能直接断掉旧路径
## Goal 统一存储路径，从 `~/.uncaged/workflow/` 迁移到 `~/.uwf/`。 ## 涉及路径 | 现有 | 新 | |------|-----| | `~/.uncaged/workflow/` | `~/.uwf/` | | `~/.uncaged/workflow/config.yaml` | `~/.uwf/config.yaml` | | `~/.uncaged/workflow/threads.yaml` | `~/.uwf/threads.yaml` | | `~/.uncaged/workflow/registry.yaml` | `~/.uwf/registry.yaml` | | `~/.uncaged/workflow/running/` | `~/.uwf/running/` | | `~/.uncaged/workflow/history.jsonl` | `~/.uwf/history.jsonl` | ## 环境变量 | 现有 | 新 | |------|-----| | `UNCAGED_WORKFLOW_STORAGE_ROOT` | `UWF_STORAGE_ROOT` | | `UNCAGED_CAS_DIR` | 移除（统一用 ocas 的 `~/.ocas/`）| | `WORKFLOW_STORAGE_ROOT` | 保留为 fallback，下个大版本移除 | ## Tasks - [ ] 更新 `getDefaultStorageRoot()` 函数（3处） - [ ] 更新所有代码中的硬编码引用（注释、reference docs） - [ ] 启动时自动迁移：检测旧路径存在 → symlink → 提示用户 - [ ] 更新环境变量名，保留旧名为 fallback - [ ] 更新 CLAUDE.md / docs ## Notes - CAS 路径不在此 phase 改（Phase 3 处理） - 需要 migration 逻辑，不能直接断掉旧路径
xiaomo commented 2026-06-02 12:14:58 +00:00
Owner
Copy Link
Copy Source

Review 建议

自动迁移用 symlink 的方案 👍 建议 symlink 只是过渡（比如保留 2 个 minor 版本），之后某个版本彻底删除 symlink 检测逻辑，避免永久背负 legacy 代码。可以在 symlink 创建时输出 deprecation warning。

## Review 建议 自动迁移用 symlink 的方案 👍 建议 symlink 只是过渡（比如保留 2 个 minor 版本），之后某个版本彻底删除 symlink 检测逻辑，避免永久背负 legacy 代码。可以在 symlink 创建时输出 deprecation warning。
xingyue commented 2026-06-02 12:16:33 +00:00
Author
Owner
Copy Link
Copy Source

同意 👍 symlink 加 deprecation warning，保留 2 个 minor 版本后在某个大版本彻底移除。已更新 task：

  • symlink 创建时输出 deprecation warning
  • 记录 symlink 引入版本，计划移除版本
同意 👍 symlink 加 deprecation warning，保留 2 个 minor 版本后在某个大版本彻底移除。已更新 task： - [ ] symlink 创建时输出 deprecation warning - [ ] 记录 symlink 引入版本，计划移除版本
Sign in to join this conversation.
No Branch/Tag Specified
Branches Tags
Labels
Clear labels
bug
Something is not working
No Label
Milestone
No items
No Milestone
Projects
Clear projects
No project
Assignees
Clear assignees
aobing luming scottwei tuanzi xiaoju xiaomo xiaonuo xingyue
No Assignees
2 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: shazhou/united-workforce#9
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?