Locus
Locus
Locus 在作品集中应作为实验性 developer tooling，而不是主线定位。它展示的是：如何把一个已有开源桌面基础适配成本地优先的仓库工作流，并围绕 provider 配置、打包和发布准备建立更清晰的边界。
2026 — 至今
一个实验性的 local-first developer tooling workspace，基于开源 coding-agent 桌面基础做适配，重点放在本地仓库、provider setup、worktree onboarding、打包和 release-readiness 探索。
概览
Locus 探索的是一个 local-first Electron 工作台，覆盖仓库选择、worktree onboarding、terminal workflows、provider setup 和本地 SQLite 状态。这个项目被定位为对已有开源 coding-agent 桌面基础的适配，我的贡献重点是本地工作流边界、桌面 UX 和发布准备。
问题
会接触本地仓库的 developer tooling 必须讲清楚文件、凭证、provider 设置、terminal 操作和发布信任边界。这个项目的挑战，是让适配后的应用能用于本地开发，同时不暗示我拥有原始 agent 架构，也不掩盖 unsigned experimental desktop build 的限制。
我的角色
这个适配项目中的产品和工程贡献者。我的工作重点是 local-first workflow adaptation、仓库和 worktree onboarding、provider configuration、runtime detection、settings UX、packaging，以及 release-readiness documentation。
背景与约束
项目从 fork 起步，需要保留有价值的上游兼容性，同时移除或隔离 hosted product surfaces。
agent 执行需要作用于真实本地仓库，但不能把本地路径、聊天内容、provider key 或凭证通过不必要的 hosted 路径传出去。
provider setup、本地 runtime detection、terminal tooling 和 git workflows 需要在同一个桌面应用里协同，同时不能夸大原始 agent layer 的 ownership。
开源源码发布和桌面安装包分发需要分开处理，因为正式签名和 notarization 还没有准备好。
交付内容
默认启用 local-only 的产品边界，集中拦截 hosted service，并区分用户自有 provider 与上游 hosted services。
provider 和 runtime setup 流程，覆盖本地检测、设置状态、命令发现和 provider 切换。
以仓库为中心的工作流，包括本地项目选择、chat session、worktree setup、terminal、git diff/staging 和 commit 支持。
基于 GitHub Releases 的发布与更新界面，让检查、下载和安装由用户确认，而不是静默走 hosted updater 行为。
技术路径
基于 Electron、React、TypeScript、tRPC、Drizzle ORM、better-sqlite3 和 electron-builder 构建。
通过 SQLite 和主进程存储边界保持桌面状态本地化，renderer 通过 typed tRPC 调用交互，不直接处理原始凭证。
对较大的产品能力和安全敏感改动使用 OpenSpec proposal，让 local-only、auth、updater 和 command guide 的变化可审查。
补充打包脚本、运行时二进制资源、release manifest 生成和 smoke check，让内部测试构建可重复。
结果
把一个开源 coding-agent 桌面基础适配成本地优先工作台，覆盖 repository、worktree、terminal tools、provider setup 和 SQLite 状态。
把隐私边界显式化：默认构建中 hosted auth、上游 sandbox、telemetry、inbox、automations 和 hosted updater 路径被移除或守门。
完成内部 pre-release 打包路径，明确标注 unsigned build，并准备了手动 GitHub Releases 检查与 macOS/Windows 发布流程。
形成了一个补充型作品集案例，用来展示桌面工程、本地工作流适配、runtime integration 和 release operations。
复盘
这里最重要的边界是 ownership。我不会把 Locus 表述成原创 agent 架构，而是把它作为一个实验性适配项目：重点在 local-first 产品边界、设置体验、runtime 边界、打包和发布说明。