@ia-ccun/code-agent-cli 0.0.1

package/config/agent/extensions/working-msg.ts

@@ -0,0 +1,96 @@
+/**
+ * working-message
+ *
+ * 自定义工作消息，格式类似 Claude Code: ✶ xxx… (时间 · tokens)
+ */
+
+import type { ExtensionAPI, TurnEndEvent } from "@mariozechner/pi-coding-agent";
+import type { AssistantMessage } from "@mariozechner/pi-ai";
+
+// 主题色 #49bccf
+const accentColor = "\x1b[38;2;73;188;207m";
+const reset = "\x1b[0m";
+
+// 随机消息列表
+const workingMessages = [
+	"Proofing", "Thinking", "Analyzing", "Reading", "Writing", "干活儿中",
+	"Searching", "Generating", "Compiling", "Running", "Optimizing", "打卡了吗",
+	"Debugging", "Learning", "Processing", "Reasoning", "Summarizing", "一会儿吃啥",
+	"Planning", "Executing", "Fetching", "Parsing", "Validating","双人复核",
+	"Building", "Testing", "Deploying", "Monitoring", "Refactoring", "aicoding",
+	"Documenting", "Researching", "Evaluating", "Comparing", "Calculating",
+];
+
+let currentIndex = 0;
+
+function getNextMessage(): string {
+	const msg = workingMessages[currentIndex];
+	currentIndex = (currentIndex + 1) % workingMessages.length;
+	return msg;
+}
+
+let intervalId: ReturnType<typeof setInterval> | null = null;
+let startTime = 0;
+let totalTokens = 0;
+
+function formatTime(seconds: number): string {
+	if (seconds < 60) return `${seconds}s`;
+	const mins = Math.floor(seconds / 60);
+	const secs = seconds % 60;
+	return `${mins}m ${secs}s`;
+}
+
+function formatTokens(tokens: number): string {
+	if (tokens < 1000) return `${tokens}`;
+	return `${(tokens / 1000).toFixed(1)}k`;
+}
+
+export default function workingMessageExtension(pi: ExtensionAPI) {
+	// turn_start 时开始循环切换消息
+	pi.on("turn_start", async (_event, ctx) => {
+		if (!ctx.ui) return;
+
+		// 记录开始时间
+		startTime = Date.now();
+		totalTokens = 0;
+		currentIndex = 0;
+
+		// 立即设置第一条
+		const updateMessage = () => {
+			const elapsed = Math.floor((Date.now() - startTime) / 1000);
+			const timeStr = formatTime(elapsed);
+			const tokensStr = formatTokens(totalTokens);
+			// ✶ 和单词显示为主题色
+			const msg = `${accentColor}✶${getNextMessage()}…${reset} (${timeStr} · ↓ ${tokensStr}tokens)`;
+			ctx.ui?.setWorkingMessage(msg);
+		};
+
+		updateMessage();
+
+		// 每3秒更新一次
+		if (!intervalId) {
+			intervalId = setInterval(() => {
+				// 获取当前 tokens 使用量
+				for (const entry of ctx.sessionManager.getBranch()) {
+					if (entry.type === "message" && (entry as any).message?.role === "assistant") {
+						const msg = (entry as any).message as AssistantMessage;
+						if (msg.usage?.outputTokens) {
+							totalTokens = msg.usage.outputTokens;
+						}
+					}
+				}
+				updateMessage();
+			}, 3000);
+		}
+	});
+
+	// turn结束时停止
+	pi.on("turn_end", async (_event: TurnEndEvent, ctx) => {
+		if (intervalId) {
+			clearInterval(intervalId);
+			intervalId = null;
+		}
+		// 恢复默认消息
+		ctx.ui?.setWorkingMessage(undefined);
+	});
+}

package/config/agent/help.md

@@ -0,0 +1,364 @@
+# aicode-cli 使用指南
+
+> 全面掌握 AI 编程助手的各项功能与配置
+
+---
+
+## 目录
+
+1. [快速开始](#1-快速开始)
+2. [基础操作](#2-基础操作)
+3. [核心命令](#3-核心命令)
+4. [快捷键](#4-快捷键)
+5. [配置详解](#5-配置详解)
+6. [Skills](#6-skills)
+7. [Prompt 命令](#7-prompt-命令)
+8. [主题](#8-主题)
+9. [最佳实践](#9-最佳实践)
+10. [故障排除](#10-故障排除)
+
+---
+
+## 1. 快速开始
+
+### 安装
+
+```bash
+npm install -g @ia-ccun/code-agent-cli
+```
+
+### 启动
+
+```bash
+aicode-cli
+```
+
+### 基本对话
+
+直接在命令行输入你的需求：
+
+```
+帮我写一个 Hello World 程序
+```
+
+---
+
+## 2. 基础操作
+
+### 输入模式
+
+| 模式 | 说明 |
+|------|------|
+| 直接输入 | 发送普通消息给 AI |
+| `!` 前缀 | 执行 bash 命令，不纳入上下文 |
+| `!!` 前缀 | 执行 bash 命令，纳入上下文 |
+
+### 队列模式
+
+使用 `Ctrl+Q` 将当前输入放入队列，继续输入下一个任务：
+
+```
+# 输入第一个任务
+Ctrl+Q
+# 输入第二个任务
+Ctrl+Q
+# 发送所有任务
+Enter
+```
+
+---
+
+## 3. 核心命令
+
+### 系统命令
+
+| 命令 | 说明 |
+|------|------|
+| `/clear` | 清理当前会话上下文，释放 Token |
+| `/exit` | 退出会话 |
+| `/status` | 显示当前会话状态 |
+| `/reload` | 重新加载扩展、Skills、Prompts |
+| `/changelog` | 查看更新日志 |
+| `/context` | 查看当前加载的上下文信息 |
+
+### 模型相关
+
+| 命令 | 说明 |
+|------|------|
+| `/model` | 打开模型选择器 |
+| `/thinking` | 打开思考模式选择器 |
+
+思考级别：`off` → `minimal` → `low` → `medium` → `high` → `xhigh`
+
+---
+
+## 4. 快捷键
+
+### 编辑器
+
+| 快捷键 | 功能 |
+|--------|------|
+| `Ctrl+A` | 移动到行首 |
+| `Ctrl+E` | 移动到行尾 |
+| `Ctrl+W` | 删除前一个单词 |
+| `Ctrl+U` | 清空当前行 |
+| `Ctrl+C` | 中断当前操作 |
+| `Ctrl+D` | 退出会话 |
+| `Tab` | 自动补全 |
+
+### 对话导航
+
+| 快捷键 | 功能 |
+|--------|------|
+| `Ctrl+L` | 打开会话树 |
+| `Ctrl+N` | 新建会话 |
+| `Ctrl+S` | 保存当前会话（新建分支） |
+| `Ctrl+P` | 切换到上一个模型 |
+| `Ctrl+Shift+P` | 切换到下一个模型 |
+| `↑/↓` | 历史记录导航 |
+| `Ctrl+Q` | 队列模式 |
+| `Ctrl+I` | AI 辅助补全 |
+
+---
+
+## 5. 配置详解
+
+### 5.1 配置文件位置
+
+```
+~/.aicode-cli/
+├── config.json          # 主配置文件
+└── agent/
+    ├── settings.json   # Agent 设置
+    ├── models.json     # 模型配置
+    ├── prompts/       # Prompt 模板
+    ├── skills/        # Skills
+    ├── extensions/    # 扩展
+    ├── themes/        # 主题
+    └── sessions/      # 会话历史
+```
+
+### 5.2 config.json（主配置）
+
+```json
+{
+  "name": "aicode-cli",
+  "banner": "__default__",
+  "themeColor": "#49bccf",
+  "configDir": ".aicode-cli"
+}
+```
+
+| 字段 | 说明 | 默认值 |
+|------|------|--------|
+| name | 应用名称 | aicode-cli |
+| banner | Banner 显示 | `__default__` 显示，`""` 不显示 |
+| themeColor | 主题色（Hex） | `#49bccf` |
+| configDir | 配置目录 | `.aicode-cli` |
+
+### 5.3 settings.json（Agent 设置）
+
+```json
+{
+  "defaultProvider": "your-provider",
+  "defaultModel": "your-model",
+  "quietStartup": false,
+  "theme": "catppuccin-mocha",
+  "extensions": [],
+  "skills": []
+}
+```
+
+| 字段 | 说明 | 默认值 |
+|------|------|--------|
+| defaultProvider | 默认模型提供者 | - |
+| defaultModel | 默认模型 | - |
+| quietStartup | 静默启动（不显示列表） | false |
+| theme | 主题名称 | - |
+| extensions | 扩展列表 | [] |
+| skills | Skills 列表 | [] |
+
+### 5.4 models.json（模型配置）
+
+```json
+{
+  "providers": {
+    "openai": {
+      "name": "OpenAI",
+      "baseUrl": "https://api.openai.com/v1",
+      "api": "openai-completions",
+      "apiKey": "sk-xxx",
+      "models": [
+        {
+          "id": "gpt-4",
+          "name": "GPT-4",
+          "contextWindow": 8192,
+          "maxTokens": 4096
+        }
+      ]
+    }
+  }
+}
+```
+
+| 字段 | 说明 |
+|------|------|
+| providers | 模型提供者集合 |
+| name | 提供者显示名称 |
+| baseUrl | API 端点 |
+| api | API 类型（openai-completions / anthropic-messages） |
+| apiKey | API 密钥 |
+| models | 模型列表 |
+| id | 模型 ID |
+| name | 模型显示名称 |
+| contextWindow | 上下文窗口大小 |
+| maxTokens | 最大输出 tokens |
+
+---
+
+## 6. Skills
+
+### 什么是 Skills
+
+Skill 是预置的 AI 技能模块，针对特定场景优化。
+
+### 可用 Skills
+
+| Skill | 说明 | 激活方式 |
+|-------|------|----------|
+| code-review | 代码审查 | `/skill:code-review` |
+| commit | Git 提交 | `/skill:commit` |
+| pr | PR 描述 | `/skill:pr` |
+| refactor | 代码重构 | `/skill:refactor` |
+| unit-test | 单元测试 | `/skill:unit-test` |
+| csv-data-summarizer | CSV 数据分析 | `/skill:csv-data-summarizer` |
+| frontend-design | 前端设计 | `/skill:frontend-design` |
+| ui-ux-pro-max | UI/UX 设计 | `/skill:ui-ux-pro-max` |
+
+### 使用方法
+
+```
+/skill:code-review
+帮我审查这段代码
+```
+
+---
+
+## 7. Prompt 命令
+
+### 什么是 Prompts
+
+Prompt 是预置的工作流模板，用于特定任务。
+
+### 可用 Prompts
+
+| Prompt | 说明 |
+|--------|------|
+| `/bmad-init` | 初始化 BMAD 项目 |
+| `/init-project` | 初始化新项目 |
+| `/feat` | 新增功能开发流程 |
+| `/git-commit` | Git 提交 |
+| `/git-rollback` | Git 回滚 |
+| `/git-worktree` | Git Worktree 管理 |
+| `/workflow` | 复杂工作流 |
+
+### 使用示例
+
+```bash
+# 初始化项目
+/init-project
+
+# 新增功能
+/feat 用户登录功能
+
+# Git 提交
+/git-commit
+```
+
+---
+
+## 8. 主题
+
+### 使用主题
+
+在 `settings.json` 中设置：
+
+```json
+{
+  "theme": "catppuccin-mocha"
+}
+```
+
+### 内置主题
+
+| 主题 | 说明 |
+|------|------|
+| dark | 暗色主题 |
+| light | 亮色主题 |
+| catppuccin-mocha | 猫puccin mocha（推荐） |
+
+---
+
+## 9. 最佳实践
+
+### 会话管理
+
+1. **及时清理**：Token 紧张时使用 `/clear` 释放空间
+2. **分支会话**：不同任务使用不同分支，保持清晰
+3. **定期保存**：重要操作后 `Ctrl+S` 保存
+
+### 提示技巧
+
+1. **明确需求**：具体描述你想要的结果
+2. **提供上下文**：告诉 AI 相关的项目背景
+3. **分步执行**：复杂任务拆分成多个小请求
+4. **指定格式**：如需特定输出，明确说明格式要求
+
+### 安全操作
+
+1. **谨慎删除**：删除文件前确认重要性
+2. **先审后改**：重要修改前先让 AI 解释代码
+3. **备份优先**：关键文件操作前手动备份
+
+---
+
+## 10. 故障排除
+
+### 常见问题
+
+| 问题 | 解决方案 |
+|------|----------|
+| 启动慢 | 检查网络连接 |
+| 模型连接失败 | 核对 models.json 配置 |
+| 扩展不生效 | 运行 `/reload` 重载 |
+| Token 溢出 | 使用 `/clear` 清理上下文 |
+
+### 详细模式
+
+```bash
+aicode-cli --verbose
+```
+
+---
+
+## 附录
+
+### 环境变量
+
+| 变量 | 说明 |
+|------|------|
+| `AICODE_CLI_CONFIG_DIR` | 配置目录 |
+| `AICODE_CLI_CODING_AGENT_DIR` | Agent 配置目录 |
+
+### 命令行参数
+
+| 参数 | 说明 |
+|------|------|
+| `--verbose` | 详细输出模式 |
+| `--theme <name>` | 指定主题 |
+| `--model <name>` | 指定模型 |
+| `--clear` | 启动时清理会话 |
+
+---
+
+*世界那么哒 · AI 实践落地 @2026*

package/config/agent/models.json

@@ -0,0 +1,56 @@
+{
+  "providers": {
+    "openai": {
+      "name": "OpenAI",
+      "baseUrl": "https://api.openai.com/v1",
+      "api": "chat-completions",
+      "apiKey": "YOUR_API_KEY_HERE",
+      "models": [
+        {
+          "id": "gpt-4o",
+          "name": "GPT-4o",
+          "contextWindow": 128000,
+          "maxTokens": 16384,
+          "reasoning": false,
+          "input": ["text"],
+          "cost": {
+            "input": 2.5,
+            "output": 10
+          }
+        },
+        {
+          "id": "gpt-4o-mini",
+          "name": "GPT-4o Mini",
+          "contextWindow": 128000,
+          "maxTokens": 16384,
+          "reasoning": false,
+          "input": ["text"],
+          "cost": {
+            "input": 0.075,
+            "output": 0.3
+          }
+        }
+      ]
+    },
+    "anthropic": {
+      "name": "Anthropic",
+      "baseUrl": "https://api.anthropic.com",
+      "api": "anthropic-messages",
+      "apiKey": "YOUR_API_KEY_HERE",
+      "models": [
+        {
+          "id": "claude-sonnet-4-20250514",
+          "name": "Claude Sonnet 4",
+          "contextWindow": 200000,
+          "maxTokens": 8192,
+          "reasoning": true,
+          "input": ["text"],
+          "cost": {
+            "input": 3,
+            "output": 15
+          }
+        }
+      ]
+    }
+  }
+}

package/config/agent/prompts/feat.md

@@ -0,0 +1,106 @@
+---
+name: feat
+description: '用于新增功能开发的命令，支持完整的开发流程和工具集成'
+---
+
+$ARGUMENTS
+
+## 核心工作流程
+
+### 1. 输入分析与类型判断
+
+每次收到用户输入时，首先进行类型判断并明确告知用户：
+
+**判断标准：**
+
+- **需求规划类型**: 用户提出新功能需求、项目构想或需要制定计划
+
+- **讨论迭代类型**: 用户要求继续讨论、修改或完善已有规划
+
+- **执行实施类型**: 用户确认规划完成，要求开始具体实施工作
+
+### 2. 分类处理机制
+
+#### A. 需求规划处理
+
+**触发条件**: 识别为功能需求输入
+
+**执行动作**:
+
+- 启用 Planner Agent
+
+- 生成详细的 markdown 规划文档
+
+- 将文档存储至 `./.aicode/plan` 目录，并以 plan/xxx.md 的格式命名
+
+- 包含：目标定义、功能分解、实施步骤、验收标准
+
+#### B. 讨论迭代处理
+
+**触发条件**: 用户要求继续讨论或修改规划
+
+**执行动作**:
+
+- 检索并分析上次生成的规划文件
+
+- 识别用户反馈和确认内容
+
+- 启用 Planner Agent
+
+- 生成详细的 markdown 规划文档
+
+- 建立一个新的文档，比如上一次是 plan/xxx.md，那么这次就是 plan/xxx-1.md，如果上一次是 plan/xxx-1.md，那么这次就是 plan/xxx-2.md，以此类推
+
+- 重新组织待实施任务优先级
+
+#### C. 执行实施处理
+
+**触发条件**: 用户确认规划完成，要求开始执行
+
+**执行动作**:
+
+- 按规划文档顺序启动任务执行
+
+- 每个子任务开始前进行任务类型识别
+
+- **前端任务特殊处理**:
+
+- 检查是否存在可用 UI 设计
+
+- 如无设计方案，must use UI-UX-Designer Agent
+
+- 完成 UI 设计后再进行开发实施
+
+### 3. 关键执行原则
+
+#### 强制响应要求
+
+- **每次交互必须首先说明**: "我判断此次操作类型为：[具体类型]"
+
+- 类型判断必须准确且明确传达给用户
+
+#### 任务执行规范
+
+- 严格按照文档化规划执行
+
+- 子任务启动前必须明确任务性质和依赖关系
+
+- 前端任务必须确保 UI 设计完整性
+
+#### 状态管理机制
+
+- 维护任务完成状态跟踪
+
+- 及时更新规划文档状态
+
+- 确保用户对进度的可见性
+
+## 质量保证要点
+
+1. **类型判断准确性**: 每次交互开始的类型识别必须准确
+
+2. **文档一致性**: 规划文档与实际执行保持同步
+
+3. **依赖关系管理**: 特别关注前端任务的 UI 设计依赖
+
+4. **用户沟通透明**: 所有判断和动作都要明确告知用户