Metadata-Version: 2.5
Name: trismind-devkit
Version: 0.6.1
Summary: TrisMind DevKit terminal prototype
Author: TrisMind
License: Proprietary
Requires-Python: >=3.10
Requires-Dist: pyyaml>=6.0
Requires-Dist: readchar>=4.0
Requires-Dist: rich>=13.7.0
Requires-Dist: textual>=0.47.0
Description-Content-Type: text/markdown

# DevKit 终端原型 v0.5.1

> **本 README 是旧版原型的历史说明。** 当前版本的安装、uv 环境和启动方式请看 [docs/GETTING-STARTED.md](../docs/GETTING-STARTED.md)。

Mac 终端可运行的 DevKit 完整交互原型。

## 最新修复（2026-06-01）

### 1. Rich 样式语法错误修复 ✓
**问题**：`MissingStyle: color(#e5eefc)` 导致布局崩溃  
**修复**：改用 Rich 标准颜色名称（green, cyan, yellow, red, blue, magenta, dim, white）

### 2. 输入卡住问题修复 ✓
**问题**：按 Esc 进入 NORMAL 模式后输入被禁用，界面卡住  
**修复**：暂时禁用 NORMAL 模式切换，Esc 只用于取消 wizard

## 快速开始

```bash
# 1. 进入原型目录
cd /Users/amstroy/Downloads/AgentStore/原型

# 2. 激活虚拟环境
source venv/bin/activate

# 3. 运行原型
python devkit_prototype.py

# 4. 测试启动（可选）
python test_startup.py
```

## 演示流程（J1 旅程）

按顺序输入以下命令，体验完整的首次使用流程：

1. `/login alice` - 登录到开发者中心
2. `/new` - 创建新项目（向导：name → path → template）
3. `/doctor` - 环境自检
4. `/ai "帮我设计一个竞品研究 Agent"` - AI 辅助设计
5. `/apply` - 应用 AI 提案
6. `/run "帮我写个问候函数"` - 运行 Agent（生成 mock waterfall）
7. `/artifacts` - 查看产物
8. `/test` - 运行测试
9. `/submit` - 提交审核
10. `/review` - 查看审核状态

## 已实现的命令（23个）

### 账号管理
- `/login [account]` - 登录
- `/logout` - 登出
- `/register` - 注册（mock）

### 项目管理
- `/new` - 新建项目（向导）
- `/open [name]` - 打开项目
- `/delete [name]` - 删除项目
- `/init` - 补齐项目骨架
- `/doctor` - 环境自检

### AI 提案
- `/ai "<prompt>"` - 生成 AI 提案
- `?<text>` - 等同 /ai
- `/apply` - 应用提案
- `/discard` - 放弃提案

### Run / 产物 / 测试
- `/run "<prompt>"` - 运行 Agent
- `/artifacts` - 查看产物
- `/test` - 运行测试

### 提交 / 审核
- `/submit` - 提交审核
- `/review` - 查看审核状态

### 辅助命令
- `/status` - 状态摘要
- `/context` - session ctx/cost
- `/clear` - 清空 stream
- `/version` - 版本信息
- `/help` - 命令清单
- `/exit` - 退出

## v0.4.2 当前主路径

- `/run --plan none|locked|editable "<prompt>"` - 启动 run
- `/run plan-add|plan-del|plan-move|plan-reset|plan-edit` - 编辑 task phase plan
- `/tool mcp add/auth/list/status ...` - MCP 配置
- `/workspace list/show/new/edit/download/upload/archive/delete/clean` - Workspace 管理
- `/skill new <name>` - 生成目录化 skill 骨架
- `/tool new <name> --kind http|custom` - 生成目录化 tool 骨架
- `/prompt new <name>` / `/prompt render-preview <name>` - Prompt 管理
- `/diff` - 未连接 IDE 时终端展示，连接 IDE 时优先打开 IDE diff

## 交互特性

### 模式系统
- **INSERT 模式**（绿色）：默认模式，输入命令和 prompt
- **PLAN 模式**（黄色）：按 `Shift+Tab` 切换，只读浏览模式

### 键位
- `Enter` - 提交命令（INSERT 模式）
- `Esc` - 取消 wizard / 放弃 pending proposal
- `Shift+Tab` - 切换 PLAN 模式
- `Ctrl+C` - 退出

### 输入方式
- `/cmd` - 斜杠命令（如 /login, /new, /run）
- `?<text>` - AI 提案（等同于 /ai）
- 裸文本 - 直接输入文本，等同于 /ai
- `!bash` - bash 命令（待实现）
- `@file` - 文件引用（待实现）

### 视觉设计
- 近黑底色 (#0a1020)
- 单色高亮（绿/蓝/黄/红/青/品红）
- 文字标签，避免 emoji 过载
- 永驻 Topbar 显示项目状态
- 实时 Statusbar 显示当前模式和提示

## 注意事项

1. **所有数据都是 mock**：除了状态持久化到 `~/.devkit_prototype_state.json`，其他操作不会真实修改文件系统
2. **Waterfall 只有折叠态**：目前只能看到 OP 序列，无法展开查看详情
3. **NORMAL 模式暂时禁用**：避免输入卡住问题
4. **!bash 和 @file 未实现**：这些功能计划在后续批次实现

## 状态持久化

应用状态保存在 `~/.devkit_prototype_state.json`，包括：
- 登录状态和账号信息
- 项目列表和当前项目
- Session 和 Workspace 配置
- Skills/Tools/Prompts 列表
- 提交记录

删除此文件可重置所有状态：
```bash
rm ~/.devkit_prototype_state.json
```

## 技术栈

- **Textual** 0.47.0+ - Python TUI 框架
- **Rich** 13.7.0+ - 终端富文本渲染
- **Python** 3.8+ - 运行环境

## 文件结构

```
原型/
  devkit_prototype.py    主程序（1370 行）
  requirements.txt       依赖
  test_startup.py        启动测试脚本
  README.md             本文件
  venv/                 虚拟环境
```

## 下一步开发计划

参见 `.plans/devkit-prototype-260601/`：

### Phase 1: J1 核心流程（1-2 天）
- 补充 5 个缺失命令（/edit, /skill new, /tool new, /prompt new, /diff）
- 完善 Waterfall 展开交互（j/k 导航、Enter 展开/折叠、E/W 跳转错误）
- 测试 J1 旅程的 17 个步骤

### Phase 2: J2 基础反馈处理（1 天）
- 补充 /rewind, /resume
- 增强 /review
- 测试 J2 旅程的 13 个步骤

### Phase 3: 高级功能（后续迭代）
- 配置管理（/env, /tool mcp）
- 离线模式
- 命令补全 UI
- Plan 编辑模式

## 故障排除

### 问题：MissingStyle 错误
**已修复**：v0.5.1 版本已修复所有 Rich 样式语法错误。

### 问题：按 Esc 后输入卡住
**已修复**：v0.5.1 版本已禁用 NORMAL 模式切换。

### 问题：虚拟环境未激活
```bash
source venv/bin/activate
```

### 问题：依赖未安装
```bash
pip install textual rich
```

## 测试

运行测试脚本验证代码能否正常加载：

```bash
python test_startup.py
```

应该看到：
```
✓ 模块加载成功
✓ 没有语法错误
✓ Rich 样式语法正确

可以运行: python devkit_prototype.py
```
