monk-pi 0.2.0 → 0.10.0
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.
- package/README.md +71 -8
- package/dist/chunk-37UZNIY3.js +1772 -0
- package/dist/cli.js +6 -2
- package/dist/index.d.ts +5 -3
- package/dist/index.js +3 -1
- package/package.json +1 -1
- package/dist/chunk-6OMOTI3T.js +0 -1056
package/README.md
CHANGED
|
@@ -31,7 +31,10 @@ npm install -g monk-pi
|
|
|
31
31
|
monk-pi
|
|
32
32
|
```
|
|
33
33
|
|
|
34
|
-
|
|
34
|
+
首次运行会自动弹出智能向导：
|
|
35
|
+
- **已有 Key**：直接粘贴即可瞬间完成校验并保存。
|
|
36
|
+
- **尚未订阅**：支持**一键回车自动唤起浏览器**打开 [monk.party](https://monk.party) 订阅月卡，网页生成 Key 后直接无缝切回终端粘贴！
|
|
37
|
+
- 随后即刻进入极速编码交互终端。
|
|
35
38
|
|
|
36
39
|
---
|
|
37
40
|
|
|
@@ -47,7 +50,10 @@ monk-pi
|
|
|
47
50
|
monk-pi "重构当前目录下的鉴权模块，补充单元测试"
|
|
48
51
|
|
|
49
52
|
# 恢复上一轮历史会话
|
|
50
|
-
monk-pi --continue
|
|
53
|
+
monk-pi --continue (或 monk-pi continue)
|
|
54
|
+
|
|
55
|
+
# 可视化浏览并挑选以往历史任务恢复
|
|
56
|
+
monk-pi -r (或 monk-pi resume)
|
|
51
57
|
```
|
|
52
58
|
|
|
53
59
|
### 2. 命令行单次执行 (Print Mode)
|
|
@@ -77,17 +83,74 @@ monk-pi --model monk "帮我设计一套分布式系统的架构方案"
|
|
|
77
83
|
### 终端 CLI 指令
|
|
78
84
|
| 命令 | 说明 |
|
|
79
85
|
| :--- | :--- |
|
|
86
|
+
| `monk-pi resume` (或 `-r`) | 可视化交互式浏览历史会话列表，带相对时间和摘要快速恢复 (断点续写) |
|
|
80
87
|
| `monk-pi login` (或 `auth`) | 交互式配置或更新 Monk API Key，并自动同步至 Pi |
|
|
81
88
|
| `monk-pi status` (或 `check`) | 检测 API 网络延迟、认证有效性及推演通道 |
|
|
82
89
|
| `monk-pi model [name]` | 查看或切换默认主力模型 (`monk-coding` / `monk-fast` / `monk`) |
|
|
83
90
|
| `monk-pi doctor` | 一键诊断 Node、Pi 运行时、配置文件健康度与网络状况 |
|
|
84
91
|
|
|
85
|
-
### TUI 内部 Slash 指令
|
|
86
|
-
|
|
87
|
-
-
|
|
88
|
-
-
|
|
89
|
-
-
|
|
90
|
-
-
|
|
92
|
+
### TUI 内部 Slash 指令
|
|
93
|
+
在交互式编码过程中，随时输入对应指令即可呼出 Monk 专属能力：
|
|
94
|
+
- **/undo** (或 **/回退**)：一键撤销上一次 AI 对文件的所有修改，恢复修改文件并自动删除新建文件（安全感拉满！）
|
|
95
|
+
- **/commit** [说明]：自动检查 Git 暂存与改动，按 Conventional Commits 规范生成地道中文 Commit 并自动提交
|
|
96
|
+
- **/review** [路径]：对当前 Git 改动或指定源代码文件进行四维度（缺陷/性能/架构/重构片段）专业中文代码审查
|
|
97
|
+
- **/tips**：查看 Monk-Pi 精选实用极客技巧清单，随时查阅进阶用法
|
|
98
|
+
- **/monk**：呼出图形化快捷控制菜单（包含撤销改动、切模型、测速、用量查询等）
|
|
99
|
+
- **/monk model**：在当前会话中秒级免重启切换主力模型 (`monk-coding` / `monk-fast` / `monk`)
|
|
100
|
+
- **/monk cn** (或 `/monk prompt`)：一键开启/关闭中文工程精炼系统提示词（零客套·行动优先）
|
|
101
|
+
- **/monk ping**：实时测试当前 Monk API 连接与端到端延迟
|
|
102
|
+
- **/monk account**：查询用量与账号到期状态
|
|
103
|
+
|
|
104
|
+
---
|
|
105
|
+
|
|
106
|
+
## ⚡ 智能首屏导航 (Smart Navigator) 与极客小贴士
|
|
107
|
+
|
|
108
|
+
告别面对空白输入框与闪烁光标“不知道该问什么”的迷茫感：
|
|
109
|
+
- **项目画像智能感知**：首次启动或新会话打开时，自动识别当前技术栈（如 `Vue 3 技术栈`、`Next.js 全栈`、`Go 后端应用` 等）及 Git 状态。
|
|
110
|
+
- **推荐指令导流**：自动在输入框上方挂载轻量导航气泡，提醒最相关的指令建议（如 `@diff`、`/commit`、`/undo`）。
|
|
111
|
+
- **极客小技巧轮播**：每次启动轮播展示一条高价值技巧，帮助开发者自然掌握进阶工作流。
|
|
112
|
+
- **优雅自退**：用户一旦开始输入或发出第一条指令，首屏导航气泡便会**优雅自动退场**，还你 100% 纯净的对话空间！
|
|
113
|
+
|
|
114
|
+
---
|
|
115
|
+
|
|
116
|
+
---
|
|
117
|
+
|
|
118
|
+
## 🔮 上下文魔术引用 (@diff, @recent, @git, @staged)
|
|
119
|
+
|
|
120
|
+
为了彻底消灭繁琐的“切屏敲命令、复制代码、再切回粘贴”操作，Monk-Pi 提供了原生自动补全与即时展开的**上下文魔术宏**：
|
|
121
|
+
|
|
122
|
+
| 上下文宏 | 自动提取内容 | 推荐场景 |
|
|
123
|
+
| :--- | :--- | :--- |
|
|
124
|
+
| **`@diff`** | 自动提取当前 Git 工作区与暂存区的所有未提交改动 | `"帮我检查 @diff 看看有没有潜在 bug"` |
|
|
125
|
+
| **`@staged`** | 自动提取当前 Git 暂存区改动 (`git diff --staged`) | `"针对 @staged 写一份规范的提交说明"` |
|
|
126
|
+
| **`@recent`** | 自动提取最近修改过的项目源文件列表 | `"基于 @recent 里的模块梳理更新日志"` |
|
|
127
|
+
| **`@git`** | 自动提取当前 Git 分支、变动状态与最近 3 条提交记录 | `"根据 @git 看看接下来该合哪个分支"` |
|
|
128
|
+
|
|
129
|
+
> 💡 **自动补全支持**：在输入框中只要敲 `@`，就会自动弹出浮动建议，支持方向键选择或继续输入过滤。提交给 AI 时会自动原地无缝展开并投喂给 Monk 模型！
|
|
130
|
+
|
|
131
|
+
---
|
|
132
|
+
|
|
133
|
+
## 🛡️ 智能文件快照与 /undo 一键回退 (Safety First)
|
|
134
|
+
|
|
135
|
+
AI 改代码最怕“改崩了”、“改乱了却记不得改了哪几个文件”。Monk-Pi 引入了**轮次级文件快照守护机制**：
|
|
136
|
+
- **无感快照**：每当 AI 准备调用 `edit` 或 `write` 修改或新建文件时，自动在内存栈留存该文件在当轮改动前的原始状态（即使项目未初始化 Git 仓库也能完美运行）。
|
|
137
|
+
- **改动后情境式提示**：AI 只要在当轮实质修改或新建了文件，轮次结束时会自动在屏幕弹出贴心提示：
|
|
138
|
+
`ℹ 已修改 src/auth.ts · 如需撤销可随时输入 /undo 一键还原`
|
|
139
|
+
让新手用户第一次使用就拥有满满的安全感！
|
|
140
|
+
- **一键回退**：输入 `/undo` 时，AI 自动展示本轮受影响的文件列表，确认后**秒级恢复修改文件、清理新建垃圾文件**。
|
|
141
|
+
- **状态可视化**：底部状态栏会动态呈现 `[可撤销: n]` 徽章，让开发者拥有 100% 的掌控感与安全感。
|
|
142
|
+
|
|
143
|
+
---
|
|
144
|
+
|
|
145
|
+
---
|
|
146
|
+
|
|
147
|
+
## 🇨🇳 中文工程交互规范与提示词强化
|
|
148
|
+
|
|
149
|
+
为了彻底消除海外 AI 工具常见的“中英混杂”、“翻译腔”以及冗长的客套废话，Monk-Pi 默认注入了专为中国程序员研发的**中文工程人设规范**：
|
|
150
|
+
- **零客套废话**：严禁“好的”、“没问题”、“收到”、“接下来我将为您……”等填充词，直奔主题。
|
|
151
|
+
- **行动优先 (Action First)**：遇到需要查阅、修改或测试的任务，直接调起 `read/edit/write/bash` 工具，不在调用前长篇大论。
|
|
152
|
+
- **术语规范**：变量、函数、参数、Git 命令与标准名词保留英文，逻辑分析与注释采用干练自然中文。
|
|
153
|
+
- **随时可控**：会话中随时输入 `/monk cn` 即可一键开启或还原。
|
|
91
154
|
|
|
92
155
|
---
|
|
93
156
|
|