npm - tower-studio - Versions diffs - 0.1.1 → 0.1.2 - Mend

tower-studio 0.1.1 → 0.1.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (1138) hide show

package/.next/standalone/tower/docs/public/diagrams/tower-task-lifecycle.html ADDED Viewed

@@ -0,0 +1,251 @@
+<!DOCTYPE html>
+<html lang="zh-CN">
+<head>
+<meta charset="UTF-8">
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<title>Tower Task Lifecycle</title>
+<style>
+  @import url('https://fonts.googleapis.com/css2?family=JetBrains+Mono:wght@300;400;500;600;700&display=swap');
+  * { margin: 0; padding: 0; box-sizing: border-box; }
+  body {
+    background: #020617;
+    font-family: 'JetBrains Mono', monospace;
+    display: flex;
+    justify-content: center;
+    align-items: center;
+    min-height: 100vh;
+    padding: 2rem;
+  }
+  svg { max-width: 1000px; width: 100%; height: auto; }
+</style>
+</head>
+<body>
+<svg viewBox="0 0 1000 880" xmlns="http://www.w3.org/2000/svg">
+  <defs>
+    <!-- Grid pattern -->
+    <pattern id="grid" width="40" height="40" patternUnits="userSpaceOnUse">
+      <path d="M 40 0 L 0 0 0 40" fill="none" stroke="rgba(148,163,184,0.06)" stroke-width="0.5"/>
+    </pattern>
+    <!-- Arrow markers -->
+    <marker id="arrow-emerald" viewBox="0 0 10 10" refX="9" refY="5" markerWidth="7" markerHeight="7" orient="auto-start-reverse">
+      <path d="M 0 0 L 10 5 L 0 10 z" fill="#34d399"/>
+    </marker>
+    <marker id="arrow-rose" viewBox="0 0 10 10" refX="9" refY="5" markerWidth="7" markerHeight="7" orient="auto-start-reverse">
+      <path d="M 0 0 L 10 5 L 0 10 z" fill="#fb7185"/>
+    </marker>
+    <marker id="arrow-orange" viewBox="0 0 10 10" refX="9" refY="5" markerWidth="7" markerHeight="7" orient="auto-start-reverse">
+      <path d="M 0 0 L 10 5 L 0 10 z" fill="#fb923c"/>
+    </marker>
+    <marker id="arrow-amber" viewBox="0 0 10 10" refX="9" refY="5" markerWidth="7" markerHeight="7" orient="auto-start-reverse">
+      <path d="M 0 0 L 10 5 L 0 10 z" fill="#fbbf24"/>
+    </marker>
+    <marker id="arrow-slate" viewBox="0 0 10 10" refX="9" refY="5" markerWidth="7" markerHeight="7" orient="auto-start-reverse">
+      <path d="M 0 0 L 10 5 L 0 10 z" fill="#94a3b8"/>
+    </marker>
+    <!-- Glow filters -->
+    <filter id="glow-emerald" x="-20%" y="-20%" width="140%" height="140%">
+      <feGaussianBlur stdDeviation="3" result="blur"/>
+      <feFlood flood-color="#34d399" flood-opacity="0.15" result="color"/>
+      <feComposite in="color" in2="blur" operator="in" result="glow"/>
+      <feMerge><feMergeNode in="glow"/><feMergeNode in="SourceGraphic"/></feMerge>
+    </filter>
+    <filter id="glow-amber" x="-20%" y="-20%" width="140%" height="140%">
+      <feGaussianBlur stdDeviation="3" result="blur"/>
+      <feFlood flood-color="#fbbf24" flood-opacity="0.15" result="color"/>
+      <feComposite in="color" in2="blur" operator="in" result="glow"/>
+      <feMerge><feMergeNode in="glow"/><feMergeNode in="SourceGraphic"/></feMerge>
+    </filter>
+    <filter id="glow-cyan" x="-20%" y="-20%" width="140%" height="140%">
+      <feGaussianBlur stdDeviation="3" result="blur"/>
+      <feFlood flood-color="#22d3ee" flood-opacity="0.15" result="color"/>
+      <feComposite in="color" in2="blur" operator="in" result="glow"/>
+      <feMerge><feMergeNode in="glow"/><feMergeNode in="SourceGraphic"/></feMerge>
+    </filter>
+    <filter id="glow-orange" x="-20%" y="-20%" width="140%" height="140%">
+      <feGaussianBlur stdDeviation="3" result="blur"/>
+      <feFlood flood-color="#fb923c" flood-opacity="0.15" result="color"/>
+      <feComposite in="color" in2="blur" operator="in" result="glow"/>
+      <feMerge><feMergeNode in="glow"/><feMergeNode in="SourceGraphic"/></feMerge>
+    </filter>
+  </defs>
+  <!-- Background -->
+  <rect width="1000" height="880" fill="#020617"/>
+  <rect width="1000" height="880" fill="url(#grid)"/>
+  <!-- ============================== -->
+  <!-- STEP 1: 创建任务 (y=30)        -->
+  <!-- ============================== -->
+  <rect x="350" y="30" width="300" height="52" rx="26" fill="rgba(8,145,178,0.2)" stroke="#22d3ee" stroke-width="1.5" filter="url(#glow-cyan)"/>
+  <text x="500" y="52" text-anchor="middle" fill="#22d3ee" font-family="JetBrains Mono" font-size="14" font-weight="600">创建任务 (TODO)</text>
+  <text x="500" y="70" text-anchor="middle" fill="rgba(148,163,184,0.7)" font-family="JetBrains Mono" font-size="9">标题 / 描述 / 优先级 / 标签 / baseBranch</text>
+  <!-- Arrow: Step 1 → Step 2 -->
+  <rect x="490" y="82" width="20" height="18" fill="#020617"/>
+  <line x1="500" y1="82" x2="500" y2="104" stroke="#34d399" stroke-width="1.5" marker-end="url(#arrow-emerald)"/>
+  <rect x="508" y="86" width="70" height="12" fill="#020617"/>
+  <text x="512" y="96" fill="#34d399" font-family="JetBrains Mono" font-size="9" font-weight="500">点击「执行」</text>
+  <!-- ============================== -->
+  <!-- STEP 2: startPtyExecution()    -->
+  <!-- ============================== -->
+  <rect x="310" y="108" width="380" height="130" rx="8" fill="rgba(6,78,59,0.4)" stroke="#34d399" stroke-width="1.5" filter="url(#glow-emerald)"/>
+  <text x="500" y="130" text-anchor="middle" fill="#34d399" font-family="JetBrains Mono" font-size="13" font-weight="700">startPtyExecution()</text>
+  <line x1="330" y1="140" x2="670" y2="140" stroke="rgba(52,211,153,0.2)" stroke-width="1"/>
+  <!-- Detail items -->
+  <circle cx="335" cy="157" r="2.5" fill="#34d399"/>
+  <text x="345" y="160" fill="#cbd5e1" font-family="JetBrains Mono" font-size="10">创建 TaskExecution (PENDING → RUNNING)</text>
+  <circle cx="335" cy="175" r="2.5" fill="#34d399"/>
+  <text x="345" y="178" fill="#cbd5e1" font-family="JetBrains Mono" font-size="10">Task: TODO → IN_PROGRESS</text>
+  <circle cx="335" cy="193" r="2.5" fill="#34d399"/>
+  <text x="345" y="196" fill="#cbd5e1" font-family="JetBrains Mono" font-size="10">创建 Git Worktree (如有 baseBranch)</text>
+  <circle cx="335" cy="211" r="2.5" fill="#34d399"/>
+  <text x="345" y="214" fill="#cbd5e1" font-family="JetBrains Mono" font-size="10">加载 CliProfile · 注入 TOWER_TASK_ID</text>
+  <circle cx="335" cy="229" r="2.5" fill="#34d399"/>
+  <text x="345" y="232" fill="#cbd5e1" font-family="JetBrains Mono" font-size="10">创建 PTY 会话 (session-store)</text>
+  <!-- Arrow: Step 2 → Step 3 -->
+  <rect x="490" y="238" width="20" height="22" fill="#020617"/>
+  <line x1="500" y1="238" x2="500" y2="264" stroke="#34d399" stroke-width="1.5" marker-end="url(#arrow-emerald)"/>
+  <!-- ============================== -->
+  <!-- STEP 3: 运行中 (IN_PROGRESS)   -->
+  <!-- ============================== -->
+  <rect x="310" y="268" width="380" height="120" rx="8" fill="rgba(76,29,149,0.25)" stroke="#a78bfa" stroke-width="1.5"/>
+  <!-- Status badge -->
+  <rect x="420" y="276" width="160" height="20" rx="10" fill="rgba(52,211,153,0.15)" stroke="#34d399" stroke-width="1"/>
+  <text x="500" y="290" text-anchor="middle" fill="#34d399" font-family="JetBrains Mono" font-size="10" font-weight="600">运行中 (IN_PROGRESS)</text>
+  <line x1="330" y1="302" x2="670" y2="302" stroke="rgba(167,139,250,0.2)" stroke-width="1"/>
+  <!-- Detail items -->
+  <circle cx="335" cy="319" r="2.5" fill="#a78bfa"/>
+  <text x="345" y="322" fill="#cbd5e1" font-family="JetBrains Mono" font-size="10">Claude CLI 在终端运行 · 用户可交互输入</text>
+  <circle cx="335" cy="337" r="2.5" fill="#a78bfa"/>
+  <text x="345" y="340" fill="#cbd5e1" font-family="JetBrains Mono" font-size="10">WebSocket 中继 I/O → xterm.js 实时显示</text>
+  <circle cx="335" cy="355" r="2.5" fill="#a78bfa"/>
+  <text x="345" y="358" fill="#cbd5e1" font-family="JetBrains Mono" font-size="10">SessionStart Hook → 上报 sessionId</text>
+  <circle cx="335" cy="373" r="2.5" fill="#a78bfa"/>
+  <text x="345" y="376" fill="#cbd5e1" font-family="JetBrains Mono" font-size="10">PostToolUse Hook → 捕获文件变更</text>
+  <!-- Arrow: Step 3 → Step 4 -->
+  <rect x="490" y="388" width="20" height="22" fill="#020617"/>
+  <line x1="500" y1="388" x2="500" y2="414" stroke="#fbbf24" stroke-width="1.5" marker-end="url(#arrow-amber)"/>
+  <!-- ============================== -->
+  <!-- STEP 4: Decision Diamond       -->
+  <!-- ============================== -->
+  <g filter="url(#glow-amber)">
+    <polygon points="500,418 590,468 500,518 410,468" fill="rgba(120,53,15,0.3)" stroke="#fbbf24" stroke-width="1.5"/>
+  </g>
+  <text x="500" y="462" text-anchor="middle" fill="#fbbf24" font-family="JetBrains Mono" font-size="13" font-weight="600">exitCode?</text>
+  <text x="500" y="478" text-anchor="middle" fill="rgba(251,191,36,0.6)" font-family="JetBrains Mono" font-size="9">进程退出</text>
+  <!-- Left arrow: != 0 retry → back to Step 3 -->
+  <rect x="290" y="458" width="116" height="20" fill="#020617"/>
+  <line x1="410" y1="468" x2="296" y2="468" stroke="#fb7185" stroke-width="1.5" marker-end="url(#arrow-rose)"/>
+  <text x="340" y="462" text-anchor="middle" fill="#fb7185" font-family="JetBrains Mono" font-size="9" font-weight="500">!= 0 重试</text>
+  <!-- Up from left to Step 3 -->
+  <line x1="296" y1="468" x2="296" y2="328" stroke="#fb7185" stroke-width="1.5"/>
+  <line x1="296" y1="328" x2="306" y2="328" stroke="#fb7185" stroke-width="1.5" marker-end="url(#arrow-rose)"/>
+  <!-- Right arrow: == 0 success → Step 5 -->
+  <rect x="594" y="458" width="116" height="20" fill="#020617"/>
+  <line x1="590" y1="468" x2="700" y2="468" stroke="#34d399" stroke-width="1.5"/>
+  <text x="650" y="462" text-anchor="middle" fill="#34d399" font-family="JetBrains Mono" font-size="9" font-weight="500">== 0 成功</text>
+  <!-- Down from right then back to center for Step 5 -->
+  <line x1="700" y1="468" x2="700" y2="540" stroke="#34d399" stroke-width="1.5"/>
+  <line x1="700" y1="540" x2="504" y2="540" stroke="#34d399" stroke-width="1.5" marker-end="url(#arrow-emerald)"/>
+  <!-- ============================== -->
+  <!-- STEP 5: 评审阶段 (IN_REVIEW)   -->
+  <!-- ============================== -->
+  <rect x="310" y="530" width="380" height="90" rx="8" fill="rgba(76,29,149,0.25)" stroke="#c4b5fd" stroke-width="1.5"/>
+  <!-- Status badge -->
+  <rect x="410" y="538" width="180" height="20" rx="10" fill="rgba(139,92,246,0.2)" stroke="#a78bfa" stroke-width="1"/>
+  <text x="500" y="552" text-anchor="middle" fill="#c4b5fd" font-family="JetBrains Mono" font-size="10" font-weight="600">评审阶段 (IN_REVIEW)</text>
+  <line x1="330" y1="564" x2="670" y2="564" stroke="rgba(196,181,253,0.2)" stroke-width="1"/>
+  <circle cx="335" cy="580" r="2.5" fill="#c4b5fd"/>
+  <text x="345" y="583" fill="#cbd5e1" font-family="JetBrains Mono" font-size="10">生成小总结 + Dreaming 洞察</text>
+  <circle cx="335" cy="598" r="2.5" fill="#c4b5fd"/>
+  <text x="345" y="601" fill="#cbd5e1" font-family="JetBrains Mono" font-size="10">查看 Diff (worktree vs base branch)</text>
+  <!-- Exit Down: 合并 → DONE -->
+  <rect x="490" y="620" width="20" height="22" fill="#020617"/>
+  <line x1="500" y1="620" x2="500" y2="646" stroke="#34d399" stroke-width="1.5" marker-end="url(#arrow-emerald)"/>
+  <rect x="400" y="650" width="200" height="40" rx="20" fill="rgba(6,78,59,0.4)" stroke="#34d399" stroke-width="1.5" filter="url(#glow-emerald)"/>
+  <text x="500" y="668" text-anchor="middle" fill="#34d399" font-family="JetBrains Mono" font-size="11" font-weight="600">DONE ✓</text>
+  <text x="500" y="682" text-anchor="middle" fill="rgba(52,211,153,0.6)" font-family="JetBrains Mono" font-size="8">合并 · 清理 Worktree</text>
+  <!-- Exit Left: 重新执行 → loops to Step 2 -->
+  <rect x="218" y="565" width="88" height="16" fill="#020617"/>
+  <line x1="310" y1="575" x2="232" y2="575" stroke="#fb923c" stroke-width="1.5" stroke-dasharray="5,3"/>
+  <text x="268" y="571" text-anchor="middle" fill="#fb923c" font-family="JetBrains Mono" font-size="8" font-weight="500">重新执行</text>
+  <line x1="232" y1="575" x2="232" y2="173" stroke="#fb923c" stroke-width="1.5" stroke-dasharray="5,3"/>
+  <line x1="232" y1="173" x2="306" y2="173" stroke="#fb923c" stroke-width="1.5" stroke-dasharray="5,3" marker-end="url(#arrow-orange)"/>
+  <!-- Exit Right: CANCELLED -->
+  <rect x="694" y="565" width="80" height="16" fill="#020617"/>
+  <line x1="690" y1="575" x2="740" y2="575" stroke="#fb7185" stroke-width="1.5" marker-end="url(#arrow-rose)"/>
+  <rect x="744" y="555" width="120" height="40" rx="20" fill="rgba(159,18,57,0.3)" stroke="#fb7185" stroke-width="1.5"/>
+  <text x="804" y="579" text-anchor="middle" fill="#fb7185" font-family="JetBrains Mono" font-size="11" font-weight="600">CANCELLED</text>
+  <!-- ============================== -->
+  <!-- SIDE PANEL: 恢复执行 (left)     -->
+  <!-- ============================== -->
+  <rect x="50" y="290" width="195" height="70" rx="6" fill="rgba(120,53,15,0.15)" stroke="#fb923c" stroke-width="1.5" stroke-dasharray="6,3" filter="url(#glow-orange)"/>
+  <text x="148" y="312" text-anchor="middle" fill="#fb923c" font-family="JetBrains Mono" font-size="11" font-weight="600">恢复执行</text>
+  <text x="148" y="330" text-anchor="middle" fill="rgba(251,146,60,0.7)" font-family="JetBrains Mono" font-size="9">--resume sessionId</text>
+  <text x="148" y="346" text-anchor="middle" fill="rgba(251,146,60,0.7)" font-family="JetBrains Mono" font-size="9">--continue (最近会话)</text>
+  <!-- Arrow right into Step 3 -->
+  <line x1="245" y1="328" x2="306" y2="328" stroke="#fb923c" stroke-width="1.5" stroke-dasharray="5,3" marker-end="url(#arrow-orange)"/>
+  <!-- ============================== -->
+  <!-- LEGEND (bottom-right)          -->
+  <!-- ============================== -->
+  <!-- Card 1: 执行流程 -->
+  <rect x="50" y="720" width="280" height="55" rx="6" fill="rgba(30,41,59,0.5)" stroke="rgba(52,211,153,0.3)" stroke-width="1"/>
+  <circle cx="68" cy="738" r="5" fill="#34d399"/>
+  <text x="80" y="742" fill="#34d399" font-family="JetBrains Mono" font-size="10" font-weight="600">执行流程</text>
+  <text x="68" y="762" fill="rgba(203,213,225,0.6)" font-family="JetBrains Mono" font-size="8">创建→执行→运行→退出→评审→完成</text>
+  <!-- Card 2: 自动化 -->
+  <rect x="360" y="720" width="280" height="55" rx="6" fill="rgba(30,41,59,0.5)" stroke="rgba(251,191,36,0.3)" stroke-width="1"/>
+  <circle cx="378" cy="738" r="5" fill="#fbbf24"/>
+  <text x="390" y="742" fill="#fbbf24" font-family="JetBrains Mono" font-size="10" font-weight="600">自动化</text>
+  <text x="378" y="756" fill="rgba(203,213,225,0.6)" font-family="JetBrains Mono" font-size="8">Worktree 自动创建</text>
+  <text x="378" y="768" fill="rgba(203,213,225,0.6)" font-family="JetBrains Mono" font-size="8">环境变量注入 · Hook 捕获 sessionId</text>
+  <!-- Card 3: 恢复机制 -->
+  <rect x="670" y="720" width="280" height="55" rx="6" fill="rgba(30,41,59,0.5)" stroke="rgba(251,146,60,0.3)" stroke-width="1"/>
+  <circle cx="688" cy="738" r="5" fill="#fb923c"/>
+  <text x="700" y="742" fill="#fb923c" font-family="JetBrains Mono" font-size="10" font-weight="600">恢复机制</text>
+  <text x="688" y="756" fill="rgba(203,213,225,0.6)" font-family="JetBrains Mono" font-size="8">--resume 恢复指定会话</text>
+  <text x="688" y="768" fill="rgba(203,213,225,0.6)" font-family="JetBrains Mono" font-size="8">--continue 继续最近会话</text>
+  <!-- ============================== -->
+  <!-- STATUS BADGES ROW              -->
+  <!-- ============================== -->
+  <rect x="170" y="800" width="660" height="24" rx="12" fill="rgba(30,41,59,0.3)" stroke="rgba(148,163,184,0.1)" stroke-width="1"/>
+  <!-- TODO -->
+  <circle cx="230" cy="812" r="4" fill="#22d3ee"/>
+  <text x="240" y="816" fill="#22d3ee" font-family="JetBrains Mono" font-size="9" font-weight="500">TODO</text>
+  <!-- IN_PROGRESS -->
+  <circle cx="320" cy="812" r="4" fill="#34d399"/>
+  <text x="330" y="816" fill="#34d399" font-family="JetBrains Mono" font-size="9" font-weight="500">IN_PROGRESS</text>
+  <!-- IN_REVIEW -->
+  <circle cx="460" cy="812" r="4" fill="#a78bfa"/>
+  <text x="470" y="816" fill="#a78bfa" font-family="JetBrains Mono" font-size="9" font-weight="500">IN_REVIEW</text>
+  <!-- DONE -->
+  <circle cx="580" cy="812" r="4" fill="#34d399"/>
+  <text x="590" y="816" fill="#34d399" font-family="JetBrains Mono" font-size="9" font-weight="500">DONE</text>
+  <!-- CANCELLED -->
+  <circle cx="650" cy="812" r="4" fill="#fb7185"/>
+  <text x="660" y="816" fill="#fb7185" font-family="JetBrains Mono" font-size="9" font-weight="500">CANCELLED</text>
+  <!-- ============================== -->
+  <!-- FOOTER                         -->
+  <!-- ============================== -->
+  <text x="500" y="858" text-anchor="middle" fill="rgba(148,163,184,0.35)" font-family="JetBrains Mono" font-size="10">Tower Task Lifecycle · 5 Status States</text>
+</svg>
+</body>
+</html>

package/.next/standalone/tower/docs/search/README.md ADDED Viewed

@@ -0,0 +1,37 @@
+# Search 模块
+**Slug:** `search`
+## 概述
+全局搜索和代码搜索。全局搜索覆盖 Task、Project、Repository；代码搜索在项目 localPath 中执行。
+## 文件清单
+### Server Actions
+| 文件 | 函数 | 说明 |
+|------|------|------|
+| `search-actions.ts` | `globalSearch(query, category?)` | 全局搜索 |
+| `search-code-actions.ts` | 代码搜索 | 项目内代码搜索 |
+### 核心库
+| 文件 | 说明 |
+|------|------|
+| `lib/search.ts` | 全文搜索实现 |
+| `lib/fts.ts` | SQLite FTS 处理 |
+### 组件
+- `src/components/layout/search-dialog.tsx` — 全局搜索对话框
+### MCP Tools (`src/mcp/tools/search-tools.ts`)
+- `search` — 按 query 搜索 task/project/repository
+## 初始化
+```bash
+pnpm db:init-fts  # 创建全文搜索索引
+```

package/.next/standalone/tower/docs/settings/README.md ADDED Viewed

@@ -0,0 +1,43 @@
+# Settings 模块
+**Slug:** `settings`
+## 概述
+系统配置管理，包括通用配置、AI 工具配置、CLI Profile 管理。
+## 文件清单
+### 页面
+| 路由 | 说明 |
+|------|------|
+| `/settings` | 设置主页面 |
+### 组件 (`src/components/settings/`)
+| 组件 | 说明 |
+|------|------|
+| `general-config.tsx` | 通用配置 |
+| `system-config.tsx` | 系统配置 |
+| `ai-tools-config.tsx` | AI 工具配置 |
+| `cli-profile-config.tsx` | CLI Profile 管理 |
+### Server Actions
+| 文件 | 说明 |
+|------|------|
+| `config-actions.ts` | 系统配置读写 |
+| `agent-config-actions.ts` | Agent 配置管理 |
+| `cli-profile-actions.ts` | CLI Profile CRUD |
+### 数据模型
+**CliProfile**: 控制 PTY 使用的 CLI 命令和参数
+- `command`: CLI 命令（默认 `claude`）
+- `baseArgs`: JSON 字符串数组
+- `envVars`: JSON 对象
+- `isDefault`: 仅允许一个默认配置
+**AgentConfig**: Agent 特定配置
+- 唯一约束: `(agent, configName)`

package/.next/standalone/tower/docs/task/README.md ADDED Viewed

@@ -0,0 +1,67 @@
+# Task 模块
+**Slug:** `task`
+## 概述
+Task 是 Tower 的核心工作单元，属于某个 Project。通过 status 字段在看板列间流转，支持标签、执行记录、消息等关联。
+## 数据模型
+```
+Task (id, title, description?, status, priority, order)
+  ├── TaskLabel[] → Label
+  ├── TaskExecution[]
+  └── TaskMessage[]
+```
+- `status`: `TODO` | `IN_PROGRESS` | `IN_REVIEW` | `DONE` | `CANCELLED`
+- `priority`: `LOW` | `MEDIUM` | `HIGH` | `CRITICAL`
+- `order`: 看板列内排序（升序，小值在上）
+- `projectId`: FK → Project，级联删除
+## 文件清单
+### Server Actions (`src/actions/task-actions.ts`)
+| 函数 | 说明 |
+|------|------|
+| `createTask({ title, projectId, ... })` | 创建任务 |
+| `updateTask(taskId, data)` | 更新任务 |
+| `updateTaskStatus(taskId, status)` | 状态流转 |
+| `deleteTask(taskId)` | 删除任务 |
+| `getProjectTasks(projectId)` | 获取项目下所有任务 |
+### 页面
+| 路由 | 文件 | 说明 |
+|------|------|------|
+| `/workspaces/[id]/tasks/[taskId]` | `task-page-client.tsx` | 任务详情页 |
+### 组件 (`src/components/task/`)
+| 组件 | 说明 |
+|------|------|
+| `task-detail-panel.tsx` | 任务元信息面板 |
+| `task-terminal.tsx` | 终端 UI |
+| `task-diff-view.tsx` | Git diff 视图 |
+| `task-merge-confirm-dialog.tsx` | 合并确认 |
+| `code-editor.tsx` | 代码编辑器 |
+| `file-tree.tsx` | 文件树 |
+| `execution-timeline.tsx` | 执行历史时间线 |
+### MCP Tools (`src/mcp/tools/task-tools.ts`)
+- `list_tasks` / `create_task` / `update_task` / `move_task` / `delete_task`
+## Label 子系统
+- Server Actions: `src/actions/label-actions.ts`
+- MCP Tools: `src/mcp/tools/label-tools.ts`
+- `set_task_labels` / `setTaskLabels` 执行全量替换（非合并）
+## 约束
+- `order` 字段控制看板排序，创建时不要破坏现有排序
+- Label 替换是全量操作，需传完整 labelIds 数组
+- 删除任务级联删除 Message 和 Execution

package/.next/standalone/tower/docs/terminal/README.md ADDED Viewed

@@ -0,0 +1,58 @@
+# Terminal 模块
+**Slug:** `terminal`
+## 概述
+PTY 终端系统，为每个 Task 提供独立的 Claude CLI 终端会话。通过 WebSocket 实时传输终端 I/O。
+## 架构
+```
+Client (xterm.js) ←→ WebSocket ←→ ws-server.ts ←→ PTY Session (node-pty)
+                                                         ↕
+                                                    session-store.ts
+```
+## 文件清单
+### 核心库 (`src/lib/pty/`)
+| 文件 | 说明 |
+|------|------|
+| `pty-session.ts` | PTY 会话管理（node-pty 封装） |
+| `session-store.ts` | 内存中 PTY 会话存储，按 taskId 索引 |
+| `ws-server.ts` | WebSocket 服务器，端口由 `terminal.wsPort` 配置 |
+### API Routes
+| 路由 | 方法 | 说明 |
+|------|------|------|
+| `/api/internal/terminal/[taskId]/start` | POST | 启动 PTY 会话 |
+| `/api/internal/terminal/[taskId]/buffer` | GET | 获取终端输出缓冲 |
+| `/api/internal/terminal/[taskId]/input` | POST | 发送输入到终端 |
+### Server Actions (`src/actions/agent-actions.ts`)
+| 函数 | 说明 |
+|------|------|
+| `startPtyExecution(taskId, prompt)` | 启动 Claude CLI PTY |
+| `resumePtyExecution(taskId, sessionId)` | 恢复会话 |
+| `stopPtyExecution(taskId)` | 终止会话 |
+### 组件
+- `src/components/task/task-terminal.tsx` — xterm.js 终端 UI
+### MCP Tools (`src/mcp/tools/terminal-tools.ts`)
+- `get_task_terminal_output` / `send_task_terminal_input` / `get_task_execution_status`
+## 生命周期约束
+- 每个 taskId 只能有一个活跃会话
+- 并发上限由 `system.maxConcurrentExecutions` 配置（默认 20）
+- 断连保活：运行中 2h / 已退出 5min
+- SIGTERM 时自动清理所有会话
+- `AI_MANAGER_TASK_ID` 和 `CALLBACK_URL` 注入到 PTY 环境变量
+- 禁止修改 `process.env`，使用 `envOverrides`

package/.next/standalone/tower/docs/workspace/README.md ADDED Viewed

@@ -0,0 +1,50 @@
+# Workspace 模块
+**Slug:** `workspace`
+## 概述
+Workspace 是 Tower 的顶层容器，管理项目和标签的命名空间。
+## 数据模型
+```
+Workspace (id, name, description?)
+  ├── Project[]
+  └── Label[]
+```
+- `id`: cuid
+- `name`: 必填
+- `description`: 可选
+- 级联删除：删除 Workspace 会删除所有 Project 和 Label
+## 文件清单
+### Server Actions (`src/actions/workspace-actions.ts`)
+| 函数 | 说明 |
+|------|------|
+| `getWorkspaces()` | 列出所有工作区 |
+| `getWorkspaceById(id)` | 按 ID 获取 |
+| `createWorkspace({ name, description? })` | 创建 |
+| `updateWorkspace(id, data)` | 更新 |
+| `deleteWorkspace(id)` | 删除（级联） |
+| `getWorkspacesWithProjects()` | 含项目列表 |
+| `getWorkspacesWithRecentTasks(limit?)` | 含最近任务 |
+### 页面
+| 路由 | 文件 | 说明 |
+|------|------|------|
+| `/workspaces` | `src/app/workspaces/page.tsx` | 工作区列表 |
+| `/workspaces/[id]` | `src/app/workspaces/[workspaceId]/` | 工作区详情（看板） |
+### MCP Tools (`src/mcp/tools/workspace-tools.ts`)
+- `list_workspaces` / `create_workspace` / `update_workspace` / `delete_workspace`
+## 约束
+- Workspace 下的 Label 分为 builtin（全局）和 workspace-scoped
+- builtin Label 不可删除

package/.next/standalone/tower/docs/zh/guide/architecture.md ADDED Viewed

@@ -0,0 +1,29 @@
+---
+title: 架构概览
+description: Tower 系统的分层架构设计
+---
+## 分层架构
+Tower 采用分层架构设计，从上到下分为：
+- **UI 层** — Next.js App Router 页面和 React 组件，使用 shadcn 组件库和 TailwindCSS
+- **状态管理层** — Zustand store 管理客户端状态（看板、执行等）
+- **Server Actions 层** — Next.js Server Actions 处理业务逻辑和数据操作
+- **数据访问层** — Prisma ORM 操作 SQLite 数据库
+- **PTY 层** — node-pty 管理终端会话，WebSocket 实时传输 I/O
+- **MCP 层** — MCP Server 通过 stdio 向外部 AI Agent 暴露工具
+## 核心数据流
+```
+Workspace → Project → Task → TaskExecution
+                                    ↓
+                              PTY Session (Claude CLI)
+                                    ↓
+                              WebSocket → xterm.js
+```
+## 架构图
+详细架构图请参见 [架构图](./diagrams) 页面，包括系统架构、数据模型、任务生命周期、AI 架构和模块依赖关系图。

package/.next/standalone/tower/docs/zh/guide/diagrams.md ADDED Viewed

@@ -0,0 +1,24 @@
+---
+title: 架构图
+description: Tower 系统架构、数据模型、任务生命周期等可视化图表
+---
+## 系统架构
+<iframe src="/tower/diagrams/tower-system-architecture.html" width="100%" height="600" style="border: 1px solid #333; border-radius: 8px;" />
+## 数据模型
+<iframe src="/tower/diagrams/tower-data-model.html" width="100%" height="600" style="border: 1px solid #333; border-radius: 8px;" />
+## 任务生命周期
+<iframe src="/tower/diagrams/tower-task-lifecycle.html" width="100%" height="600" style="border: 1px solid #333; border-radius: 8px;" />
+## AI 架构
+<iframe src="/tower/diagrams/tower-ai-architecture.html" width="100%" height="600" style="border: 1px solid #333; border-radius: 8px;" />
+## 模块依赖
+<iframe src="/tower/diagrams/tower-module-map.html" width="100%" height="600" style="border: 1px solid #333; border-radius: 8px;" />

package/.next/standalone/tower/docs/zh/guide/getting-started.md ADDED Viewed

@@ -0,0 +1,80 @@
+---
+title: 快速开始
+description: 安装和运行 Tower 项目的步骤
+---
+## 前置条件
+- **Node.js** >= 22
+- **pnpm**（包管理器）
+## 安装步骤
+### 1. 克隆仓库
+```bash
+git clone <repo-url> tower
+cd tower
+```
+### 2. 安装依赖
+```bash
+pnpm install
+```
+### 3. 配置环境变量
+```bash
+cp .env.example .env
+```
+根据需要编辑 `.env` 文件，主要配置 `DATABASE_URL`（SQLite 数据库路径）。
+### 4. 初始化数据库
+```bash
+# 同步 Prisma schema 到数据库
+pnpm db:push
+# 导入种子数据
+pnpm db:seed
+# 创建全文搜索索引
+pnpm db:init-fts
+```
+### 5. 启动开发服务器
+```bash
+pnpm dev
+```
+打开浏览器访问 [http://localhost:3000](http://localhost:3000)。
+## MCP 集成
+如需将 Tower 的工具能力暴露给外部 AI Agent，在 MCP 客户端配置中添加：
+```json
+{
+  "mcpServers": {
+    "tower": {
+      "command": "npx",
+      "args": ["tsx", "<project-root>/src/mcp/index.ts"]
+    }
+  }
+}
+```
+将 `<project-root>` 替换为项目的绝对路径。
+## 常用命令
+| 命令 | 说明 |
+|------|------|
+| `pnpm dev` | 启动开发服务器（Webpack 模式，node-pty 需要） |
+| `pnpm db:push` | 同步 Prisma schema |
+| `pnpm db:seed` | 导入种子数据 |
+| `pnpm db:init-fts` | 创建全文搜索索引 |
+| `pnpm test:run` | 运行测试 |