clickvibe
DSH Web 插件：通过本地 gh CLI 获取并呈现 GitHub issues / PRs。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:ai-daming/clickvibe#7b012d7db7a49c7ef71ff2489162394768fb63a6Clickvibe 以 clickvibe 发布，当前版本为 0.1.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
DSH web 插件:右侧面板先选择已配置的 GitHub repo,再按依赖、状态和里程碑浏览全部 open issue；每个 issue 由 git/GitHub 硬事实推导唯一下一步动作,可创建独立 worktree 并启动 Codex/Claude 开发。
~/.clickvibe/config.yaml 的全部 repo 映射,路径不在本机的跨机器配置也保留在列表gh issue view / gh pr view 抓取,返回结构化 JSONbase ← head、变更统计、提交数、合并状态Codex 开发 / Claude 开发:在 issue worktree 中启动非交互 agent安全演练:走完整 worktree/任务/轮询链路,只执行 pwd、当前分支和 git statusgit fetch origin --prune,并显式从 origin/HEAD(兼容回退 origin/main)创建,不继承配置仓库当前 HEAD| 半侧 | 文件 | 职责 |
|---|---|---|
| Host | src/index.ts | 注册 /clickvibe/api 前缀路由,处理 GitHub 抓取、开发任务和 cursor 日志轮询 |
| 开发内核 | src/develop.ts | agent/URL 校验、shell 参数转义、有界行日志和 worktree 恢复决策 |
| 状态视图 | src/state-view.ts | 纯函数 deriveNextAction:由 git 事实 + 事件历史推导唯一下一步动作 |
| Client | src/client/index.tsx | shell.overlay 项目优先面板 + sidebar.footer.action 开关按钮；项目 issue 列表、筛选/分组、详情和唯一动作 |
| 构建 | tsdown.config.ts | host → lib/index.js(ESM),client → lib/client.js(CJS 闭包,window.__ModuleLoader__.load 注册) |
Client→Host 走 HTTP API 路由(正式插件没有动态插件的 harness.handle),这是与原型最大的结构差异。
| 文档 | 内容 |
|---|---|
| docs/state-model.md | 状态模型:事实分级(git/GitHub 硬事实 vs 软事实)、按钮决策表(P0-P3)、软事实降级链、状态视图展示规范 |
| docs/issue-contract.md | Issue 契约:可被自动开发的 issue 写法(目标/验收标准/依赖 三行最小集) |
| docs/product-blueprint.md | 产品蓝图:里程碑驱动的异步开发执行器定位、架构、UI 演进 |
核心设计原则:判断只依赖 git/GitHub 硬事实(客观、保证存在),workflow 文件与 comment meta 只是增强器——允许缺失,缺失时走降级链,永不因缺 meta 卡死,也永不因缺判据瞎猜。
ClickVibe 启动 agent 的命令行按次显式传参,不读取也不假设目标机器的全局配置(#11 跨机器可移植):
--dangerously-skip-permissions-c approval_policy=never -s danger-full-access(新会话)/ -c 'sandbox_mode="danger-full-access"'(resume 子命令无 -s,用 -c 覆盖)pnpm install
pnpm run build # tsc 声明 + tsdown 双 bundle
pnpm test # Host 纯逻辑回归测试
pnpm run watch # client 热更新
配置文件固定为 ~/.clickvibe/config.yaml：
repos:
ai-daming/clickvibe: /Users/me/work/clickvibe
worktreeRoot: ~/.clickvibe/worktrees
仓库按 owner/repo 精确匹配。目标路径为 <worktreeRoot>/<仓库目录名>/<仓库目录名>-issue-<N>，分支名为 <仓库目录名>-issue-<N>。
dsh plugin --profile web add link:/Users/yinwm/work/clickvibe
dsh web# host 路由
curl -X POST http://127.0.0.1:3080/clickvibe/api/projects \
-H 'content-type: application/json' -d '{}'
curl -X POST http://127.0.0.1:3080/clickvibe/api/repo/issues \
-H 'content-type: application/json' \
-d '{"repoKey":"ai-daming/clickvibe"}'
curl -X POST http://127.0.0.1:3080/clickvibe/api/fetch \
-H 'content-type: application/json' \
-d '{"url":"https://github.com/cli/cli/issues/100"}'
# client bundle
curl http://127.0.0.1:3080/plugins/clickvibe/client.js
# 启动无代码副作用的 dry-run
curl -X POST http://127.0.0.1:3080/clickvibe/api/develop \
-H 'content-type: application/json' \
-d '{"url":"https://github.com/ai-daming/clickvibe/issues/1","agent":"dryrun"}'
# 同步 worktree 到远端基线(fetch + merge origin/main,冲突自动回滚)
curl -X POST http://127.0.0.1:3080/clickvibe/api/sync \
-H 'content-type: application/json' \
-H 'origin: http://127.0.0.1:3080' \
-H 'x-clickvibe-request: 1' \
-d '{"url":"https://github.com/ai-daming/clickvibe/issues/5"}'
# 用启动响应中的 taskId 和 poll 响应中的 cursor 增量轮询
curl -X POST http://127.0.0.1:3080/clickvibe/api/develop/poll \
-H 'content-type: application/json' \
-d '{"taskId":"dev-...","cursor":0}'
任务状态只保存在当前 Host 进程内,重启后旧 taskId 失效。真实 Agent 必须从面板发起:面板先把当前显示的完整 Issue 快照交给服务端比对,再展示 Agent、更新时间、评论数和快照摘要供确认；确认后的授权只能使用一次且会过期。dryrun 不需要高权限授权、不启动 Agent,适合用 curl 验证配置、worktree 恢复和增量轮询。
不要把 ClickVibe 暴露到局域网或公网。服务端会拒绝非回环来源的 Agent 操作,但同一操作系统账号下的恶意进程本来就可能读取代码、配置和开发凭据,本工具不把同账号进程隔离当作安全边界。