> ## Documentation Index
> Fetch the complete documentation index at: https://gnero.genetind.com/llms.txt
> Use this file to discover all available pages before exploring further.
# open-typeless
> 手把手教程：用 Trellis 开发 macOS 语音输入应用
# open-typeless
一个手把手教程，展示如何用 Trellis 从零开始构建 macOS 语音输入应用。
**源代码**: [github.com/mindfold-ai/open-typeless](https://github.com/mindfold-ai/open-typeless)
## Step 1: 项目初始化
### 1.1 创建 Electron 项目
```bash theme={null}
npx create-electron-app@latest open-typeless --template=vite-typescript
cd open-typeless
# 删除 npm 生成的文件
rm -rf node_modules package-lock.json
# 创建 .npmrc (pnpm + Electron 必需)
cat > .npmrc << 'EOF'
node-linker=hoisted
shamefully-hoist=true
EOF
# 用 pnpm 重新安装
pnpm install
```
### 1.2 初始化 Trellis
```bash theme={null}
trellis init
```
### 1.3 从旧项目复制 Spec
如果有类似项目的 spec，可以复制过来：
```bash theme={null}
cp -r /path/to/old-project/.trellis/spec ./
```
### 1.4 让 AI 填充 Spec
**Prompt:**
> 帮我从 electron-doc/ 里选择有用的 spec，整理到本项目的 .trellis/spec/ 里
AI 会分析并组织 spec：
## Step 2: 任务规划
### 2.1 让 AI 规划任务
**Prompt:**
> 我打算用火山引擎 ASR BigModel API 来做这个。帮我规划一下怎么拆分任务。
AI 创建基于批次的任务计划：
### 2.2 创建任务
AI 把任务组织成批次：
| 批次 | 任务 | 目的 |
| ------- | -------------------------------------------------------------------- | -------------- |
| Batch 1 | `asr-infrastructure` | 基础设施（必须先完成） |
| Batch 2 | `asr-audio-recorder`, `asr-volcengine-client`, `asr-floating-window` | 可以并行开发 |
| Batch 3 | `asr-integration` | 集成（依赖 Batch 2） |
### 2.3 完成 Batch 1
Batch 1 完成后，验证并更新下游任务的 context：
## Step 3: 并行开发
### 3.1 启动并行 Agent
**Prompt:** `/trellis:parallel`
AI 启动 3 个 worktree agent 开发 Batch 2，每个 agent 在隔离的 git worktree 中工作：
## Step 4: 监控进度
### 4.1 查看 Agent 状态
AI 监控 agent 状态和任务进度：
### 4.2 记录 Session
并行 agent 完成后会自动创建 PR：
合并并完成批次后，记录 session：
**Prompt:** `/trellis:record-session`
## Step 5: 继续开发
### 5.1 查看剩余任务
AI 显示当前项目的剩余任务：
### 5.2 实现下一个功能
选择下一个任务，AI 用 implement agent 然后 check agent：
### 5.3 配置和测试
AI 帮助完成剩余设置（环境配置、权限）：
## 总结
用 Trellis 构建 open-typeless：
| 步骤 | 做什么 | Trellis 功能 |
| -- | ----- | ----------------------------------- |
| 1 | 初始化项目 | `trellis init`，spec 组织 |
| 2 | 规划任务 | AI 任务拆分，批次规划 |
| 3 | 并行开发 | `/trellis:parallel`，worktree agents |
| 4 | 监控和记录 | `/trellis:record-session` |
| 5 | 继续迭代 | Task hooks，implement/check agents |
**结果：** 1 天完成完整 Electron 应用，有结构化的 spec 和文档化的进度。