【架构优化】从 runtime.WriteWorkspaceFile 中拆出路径安全校验 resolveWorkspaceEditPath 与新建分支 createWorkspaceFile
維護者通常 1 天內回覆
評估
研究方向
The work is in internal/runtime/workspace_edit.go, where WriteWorkspaceFile mixes content checks, path validation (absolute paths, .., hidden files, per-component Lstat symlink checks), the O_EXCL create-if-missing branch, and the versioned atomic replace. Read the function, then workspace_edit_test.go, to see current behaviour before extracting resolveWorkspaceEditPath and createWorkspaceFile without changing error text or check order. Done means go test ./internal/runtime/ passes with new tests for both helpers. Linked PR #435 already covers this change, so check it before starting.
由索引模型根據 Issue 內容生成。
描述
现状问题
internal/runtime/workspace_edit.go 的 WriteWorkspaceFile 约 93 行，一个函数里同时做了四件事：
- 内容校验（1 MB 上限、UTF-8、无 NUL）；
- 相对路径规范化与安全校验（拒绝绝对路径/
..、隐藏文件、逐级 Lstat 拒绝符号链接）； expected == "missing"时以O_EXCL新建文件（失败回滚删除）；- 已有文件的版本比对 + 临时文件写入后 rename 原子替换。
路径安全校验和新建分支混在主流程里，阅读和单独测试都不方便。
重构方案
只在同一文件内拆函数，不改逻辑：
- 抽出
resolveWorkspaceEditPath(root, path, expected string) (string, error)：返回规范化后的相对路径，包含原有的路径/隐藏文件/符号链接校验； - 抽出
createWorkspaceFile(base *os.Root, rel, content string) error：原O_EXCL新建 + Sync + 失败删除逻辑； WriteWorkspaceFile签名、错误文案、判断顺序保持不变。
影响范围
仅 internal/runtime/workspace_edit.go，对外函数 WriteWorkspaceFile 签名与行为不变，调用方（httpapi、runner）无需改动。
验证方式
- 新增单元测试覆盖
resolveWorkspaceEditPath（合法路径、..、绝对路径、隐藏文件、符号链接、missing时允许末级不存在）和createWorkspaceFile（新建成功、已存在时拒绝）； - 原有
workspace_edit_test.go用例全部通过； gofmt、go vet ./internal/runtime/、go test ./internal/runtime/。
- 主要語言
- Go
- 星號
- 141
- 分支
- 28
- 平均合併
- 1 天 15 小時
- 30 天內合併 PR
- 113
環境準備
- 提供 Dockerfile 或 Docker Compose 檔案
- 有 Pull Request 範本
- 閱讀貢獻指南
從這裡開始
- 先讀完整個 Issue，再讀專案的貢獻指南。
- 在 Issue 下留言說明你要接手 —— 這能避免兩個人做同樣的事。
- Fork 儲存庫，在一個分支上完成修改。
- 送出 Pull Request，並在描述裡引用這個 Issue 編號。
Tencent/LoopForge 的其他 Issue
-
難度 2/5 1-3 小時 新手友好度 74/100
維護者通常 1 天內回覆
-
難度 2/5 1-3 小時 新手友好度 75/100
維護者通常 1 天內回覆
-
[Bug]: 官方镜像未安装 wecom-cli，企业微信通知报「通知服务未安装 wecom-cli」可能已有人在做 @newexploreor 於 1 天前認領。 未關閉bug
難度 2/5 1-3 小時 新手友好度 76/100
Tencent/LoopForge#156 · 1 則留言 · 已指派 1 人 ·
維護者通常 1 天內回覆
-
【架构优化】合并 gitwork/workbranch.go 中 push/pull 重复的默认提交身份注入为 withFallbackIdentity可能已有人在做 @fx-kurumi 今天認領。 未關閉
難度 2/5 1-3 小時 新手友好度 40/100
維護者通常 1 天內回覆
-
【架构优化】从 runtime.installNPMCLI 中拆出 npm 参数拼装 npmCLIInstallArgs 与安装结果启用 activateNPMStage可能已有人在做 @fx-kurumi 今天認領。 未關閉
難度 2/5 1-3 小時 新手友好度 30/100
維護者通常 1 天內回覆
查看 Tencent/LoopForge 的全部 Issue
相似的 Issue
-
team:library-maintainers
難度 2/5 1-3 小時 新手友好度 82/100
padok-team/burrito#1208 · 1 則留言 ·
維護者通常 1 天內回覆
-
難度 2/5 1-3 小時 新手友好度 62/100
bazel-contrib/rules_go#4784 · 1 則留言 ·
維護者通常 1 天內回覆
-
難度 2/5 1-3 小時 新手友好度 75/100
-
難度 2/5 1-3 小時 新手友好度 62/100
POSIdev-community/aictl#40 ·
-
難度 1/5 1 小時以內 新手友好度 62/100
prime-radiant-inc/evener#6306 ·
維護者通常 1 天內回覆