cline 新人协作指南从 clone 到 PR 合入【免费下载链接】clineAutonomous coding agent as an SDK, IDE extension, or CLI assistant.项目地址: https://gitcode.com/GitHub_Trending/cl/cline刚被拉进 cline 仓库要求你这周提交第一个 PR别慌。cline 的协作流程其实很直白本地环境跑通、在 Biome 划定的边界里写代码、用测试自证清白、按提交规范落 commit最后交给 CI 流水线把关。下面这条路线走一遍你就能从 git clone 一路走到合入。 3 步把 cline 本地环境跑通先说清前置条件仓库用 bun1.3.13 Node 22 管理依赖装好这两样再动手。第一步拉代码、装依赖、构建 SDKgit clone https://gitcode.com/GitHub_Trending/cl/cline cd apps/vscode bun run install:all cd ../.. cd sdk bun run build注意 clone 阶段需要 git-lfs二进制资源靠它拉取。第二步用code cline打开仓库VS Code 会提示安装推荐扩展——全部接受它们都是开发必需的。第三步首次构建前执行bun run protos生成 Protocol Buffers 文件apps/vscode/ 下也有bun run dev一步完成生成 protos watch 模式。之后按 F5一个加载了扩展的新 VS Code 窗口会弹出来本地开发循环就绪。 写代码前先认清这些硬边界cline 的格式与检查统一交给 Biome配置在 biome.json。你只需要记住这几条一票否决项缩进用 Tabapps/vscode/**子配置里 indentWidth 为 4行宽 130 字符行尾 LF分号按需添加、尾逗号全加、JSX 用双引号noUnusedImports是 error——unused import 直接挂linter 开着 recommended 规则集apps/vscode/**目录单独放宽了部分 style / suspicious 规则完整清单看配置文件的 overrides 即可。拿不准风格就交给格式化器命令作用bun run lint检查 sdk/、apps/cli/、apps/cline-hub/、apps/examples/bun run format只查格式不落盘bun run fix自动修复可修复项bun run checkbiome check 构建 typecheck提交前全套自检 自证清白测试怎么跑、跑不过怎么排查测试是你 PR 里维护者第一眼要看的东西。单测这样跑bun run test cd apps/vscode bun run test前者在根目录跨 workspace 并行跑各包测试后者单独跑扩展部分。E2E 用 Playwright 驱动真实 VS Code 实例、加载扩展并模拟用户操作bun run test:e2e直接跑加-- --debug能打开 Playwright Inspector 逐交互步。CI 红了别慌大概率是格式问题本地先bun run fix再推。Linux 上 VS Code 扩展测试成片失败时先查 GUI 系统库dbus、libgtk-3-0、xvfb 等完整清单在 CONTRIBUTING.md 的 Linux-specific Setup 一节。真·用例失败就先按文件缩小范围确认是不是你的改动引入的。✍️ 提交仪式一条合格的 commit 长什么样cline 采用 Conventional Commitscommit 信息以类型前缀开头速查如下类型用途示例feat新功能feat: add kanban filterfix修 bugfix: repair session leakdocs文档更新docs: update CLI usagestyle纯格式调整style: align indentationrefactor重构非功能非修复refactor: split runtime moduletest增改测试test: cover worktree utilchore构建/辅助工具chore: bump bun version另外两件事用#issue-number关联 issue正文写短一条 commit 让人一眼看懂。还有个容易翻车的点cline 要求贡献从 Issue 开始错别字、小修复除外没有获批 issue 的 PR 可能直接被关。挑一个带 good first issue 或 help wanted 标签的单子动手最稳。️ 合入前的最后一关changeset 与 CI 流水线推送分支、创建 PR 之后接力棒交给流水线。CI 配置集中在 .github/workflows/PR 上主要跑这几类扩展单测ext-vscode-test.yml、扩展 E2Eext-vscode-test-e2e.yml、SDK 测试sdk-test.yml外加 lint 与格式检查——所以bun run fix和bun run check值得在本地先各来一遍别让 CI 当第一个说格式不对的人。两件事提前知道本地每次 commithusky 的 pre-commit 钩子会先用 gitleaks 扫一遍密钥把 key、token 粘进代码在这一步就会被拦下扫描过后 lint-staged 再对暂存文件跑types biome check仓库有 .changeset/ 目录管理版本但按 CONTRIBUTING.md 的说法写 changelog 条目是维护者在发版时做的事你不用操心。 进阶例外哪些规则可以松一松Biome 配置并不铁板一块有两处内置的松绑apps/vscode/这个子目录代码量最大override 里单独调过一批规则——useNamingConvention、noParameterAssign之类关掉或降到 info 级写得灵活一点没关系但noUnusedImports依旧是 error.gitignore 覆盖的文件vcs.useIgnoreFile开着构建产物和依赖目录自动跳过你不用操心 Biome 去扫 node_modules。一个常见误解测试文件并没有被整体豁免它和生产代码走同一套检查所谓放宽只指上面那些规则级别上的调整。✅ 提交前自检清单bun run lint与bun run format零报错bun run test全绿扩展改动补跑cd apps/vscode bun run testcommit 以类型前缀开头并用 #number 关联了 issuePR 只包含一个功能/修复分支已 rebase 到最新 main没有遗留调试代码、console.log、本地路径PR 描述写清测试步骤与破坏性变更UI 改动附截图本地 pre-commit 密钥扫描gitleaks通过【免费下载链接】clineAutonomous coding agent as an SDK, IDE extension, or CLI assistant.项目地址: https://gitcode.com/GitHub_Trending/cl/cline创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考