【架构优化】从 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
-
难度 2/5 1-3 小时 新手友好度 62/100
bazel-contrib/rules_go#4784 · 1 条评论 ·
维护者通常 1 天内回复
-
难度 2/5 1-3 小时 新手友好度 62/100
POSIdev-community/aictl#40 ·
-
难度 2/5 1-3 小时 新手友好度 62/100
nebari-dev/nebari-infrastructure-core#774 ·
维护者通常 1 天内回复
-
bug
难度 2/5 1-3 小时 新手友好度 72/100
oracle/terraform-provider-oci#2662 ·
-
bug needs-triage
难度 2/5 1-3 小时 新手友好度 62/100
valkey-io/valkey-operator#644 ·
维护者通常 3 天内回复