回形针开发

其他 社区

技能解读

当前原文的自动摘译,尚未人工审校。

快速命令参考

这些是最常见的命令。有关完整选项表和详细信息,请参阅doc/DEVELOPING.md。任务 · 命令启动服务器(第一次或正常) · npx paperclipai run 带热重载的开发模式 · pnpm dev 停止开发服务器 · pnpm dev:stop

从 Master 拉取

如果架构发生更改,也运行pnpm db:generate && pnpm db:migrate。

工作树

Paperclip 工作树将 git 工作树与独立的 Paperclip 实例结合起来——每个实例都有自己的数据库、服务器端口和从主实例播种的环境。强制:在创建或管理工作树之前,您必须阅读doc/DEVELOPING.md中的“工作树本地实例”和“工作树 CLI 参考”部分。这是所有工作树命令、其选项、种子模式和环境变量的规范参考。

何时使用工作树

启动需要自己的 Paperclip 环境的功能分支 运行并行代理工作而不交叉污染主实例 在合并之前单独测试 Paperclip 更改

命令概述

CLI 有两层(完整选项表请参阅doc/DEVELOPING.md): 命令 · 用途 worktree:make <name> · 一步创建工作树 + 隔离实例 worktree:list · 列出工作树及其回形针状态 worktree:merge-history · 预览/导入工作树之间的问题历史记录

流狐档案 运行与权限由流狐静态检查推断,不代表作者声明或实际测试结果。
领域
通用
作者声明的智能体
未找到明确声明;不据此推断已兼容或已测试
静态检查
88 / 100 · 启发式扫描,不代表运行安全
运行环境证据
未执行;当前没有隔离运行测试证据
作者 / 版本 / 许可证
@paperclipai · 未声明许可证
上下文用量评级
低消耗
接入复杂程度
需简单配置
是否需要外部接口密钥
不需要
兼容的系统
macOS · Linux · Windows
运行环境要求
未检出明确要求
检测到的文件与系统行为
  • 只读
  • 允许写入 / 修改
  • 命令执行
  • 读取环境变量
网络行为
允许外网请求
安装命令数
无(仅作为资料)

需要注意: 未声明工具权限范围;实际权限由运行环境决定。

01
第 1 步 — 阅读规范文件

在创建 PR 之前,您必须阅读所有这三个文件: `.github/PULL_REQUEST_TEMPLATE.md` — 所需的 PR 主体结构 `CONTRIBUTING.md` — 贡献约定、PR 要求和思维路径示例 `.github/workflows/pr.yml` — CI 检查门合并

02
第 2 步 — 根据此清单验证您的公关正文

阅读模板后,验证您的 `--body` 是否包含以下每个部分(名称必须完全匹配): [ ] `## Thinking Path` — 块引用样式,5-8 个推理步骤 [ ] `## What Changed` — 具体更改的项目符号列表 [ ] `## Verification` — 审阅者如何确认此工作有效 [ ] `## Risks` — 可能会出现什么问题

03
第 3 步 — 创建 PR

仅在完成步骤 1 和 2 后,运行`gh pr create`。使用模板内容作为`--body`的结构——不要编写自由格式的摘要。

讨论

基于 GitHub Discussions。登录 GitHub 即可参与讨论、点赞、订阅更新。