j-cli 12.1.55

# work-copilot (j) — 快捷命令行工具

> 📅 最后更新: 2026-03-08 | 🔖 版本: v12.1.54 | 🖥️ 平台: macOS ARM64

**`j` 是一个快捷命令行工具，核心功能：**

- **别名管理** — 注册 app 路径 / URL / 脚本，`j <alias>` 快速打开
- **日报系统** — 快速写入、查看、搜索日报，自动周数管理
- **待办备忘录** — 内置 TUI 待办管理，支持 markdown checkbox
- **AI 对话** — 内置 TUI AI 对话，多模型、流式输出、工具调用
- **语音转文字** — 基于 Whisper.cpp 的离线语音识别
- **交互模式** — 带 Tab 补全 + 历史建议的 REPL 环境

**重构动机**：启动速度提升 10-100x（JVM ~200-500ms → Rust ~2ms）

---

## 快速上手

```bash
# 注册别名
j set chrome "/Applications/Google Chrome.app"
j set github https://github.com

# 打开
j chrome                  # 打开 Chrome
j chrome github           # 用 Chrome 打开 github URL
j chrome "rust lang"      # 用 Chrome 搜索

# 日报
j report "完成功能开发"    # 写入日报
j check                   # 查看最近 5 行

# 待办
j todo add 买牛奶         # 快速添加待办
j todo                    # 进入 TUI 管理

# AI 对话
j chat                    # 进入 TUI 对话界面
j chat 你好               # 快速提问

# 交互模式
j                         # 进入 REPL（Tab 补全 + 历史建议）
```

---

## 安装

### 一键安装（推荐）

```bash
curl -fsSL https://raw.githubusercontent.com/LingoJack/j/main/install.sh | sh
```

### 从 crates.io 安装

```bash
cargo install j-cli
```

### 从源码编译

```bash
git clone https://github.com/LingoJack/j.git
cd j && cargo install --path .
```

---

## 核心命令速查

| 类别 | 命令 | 说明 |
|------|------|------|
| **别名** | `j set/rm/rn/mf` | 设置/删除/重命名/修改别名 |
| **分类** | `j note/denote` | 标记/解除分类 |
| **列表** | `j ls` / `j contain` | 列出别名/查找别名 |
| **打开** | `j <alias>` | 打开应用/URL/文件 |
| **日报** | `j report/check/search` | 写入/查看/搜索日报 |
| **待办** | `j todo` | 待办备忘录 |
| **脚本** | `j concat` | 创建脚本 |
| **AI** | `j chat` | AI 对话 |
| **语音** | `j voice` | 语音转文字 |

---

## 数据目录

```
~/.jdata/
├── config.yaml          # 主配置文件
├── agent/               # AI Agent 数据
│   ├── data/            # 配置、对话历史、归档
│   └── skills/          # 技能目录
├── bin/                 # 内置工具（Markdown 渲染器）
├── report/              # 日报目录
├── scripts/             # 用户脚本
├── todo/                # 待办数据
└── voice/               # 语音模型
```

---

## 详细文档

| 文档 | 内容 |
|------|------|
| [架构设计](./docs/architecture.md) | 目录结构、模块说明、数据模型 |
| [命令详解](./docs/commands.md) | 所有命令详细使用说明 |
| [AI 对话](./docs/chat.md) | AI 对话系统完整文档 |
| [语音转文字](./docs/voice.md) | 语音转文字功能文档 |
| [设计决策](./docs/design-decisions.md) | 关键设计决策记录 |
| [开发指南](./docs/development.md) | 编译、开发、扩展指南 |

---

## 技术栈

- **clap** — 命令行参数解析
- **rustyline** — 交互模式 REPL
- **ratatui** — TUI 框架
- **async-openai** — OpenAI API 客户端
- **whisper-rs** — Whisper.cpp Rust 绑定
- **serde** — 序列化框架

---

## 更新 & 卸载

```bash
# 更新
cargo install j-cli

# 卸载
cargo uninstall j-cli
rm -rf ~/.jdata  # （可选）删除数据目录
```

---

## License

MIT