claude-pangu 1.7.1 → 1.7.3

package/README.md

@@ -65,8 +65,8 @@ oh-my-claude 的核心理念源自「愚公移山」的精神：**只要方向
 | ✨ | **李白** (LiBai) | 需求分析，用户故事 | `/libai` `/poet` |
 | 🎨 | **顾恺之** (GuKaiZhi) | UI/UX 设计，界面美学 | `/gukaizhi` `/painter` |
 | 🌙 | **嫦娥** (ChangE) | 云服务，DevOps 部署 | `/change` `/cloud` |
-| 🖼️ | **绘图** (HuiTu) | 多模态分析，图像理解 | `/huitu` `/looker` |
-| 🐢 | **玄武** (XuanWu) | 计划审查，风险评估 | `/xuanwu` `/momus` |
+| 🖼️ | **离娄** (LiLou) | 多模态分析，图像理解 | `/lilou` `/looker` |
+| 🔮 | **刘伯温** (LiuBoWen) | 计划审查，风险评估 | `/liubowen` `/momus` |
 
 ### 🔄 愚公移山模式
 
@@ -431,8 +431,8 @@ oh-my-claude/
 | `/libai` | 召唤李白需求炼金师 |
 | `/gukaizhi` | 召唤顾恺之界面美学师 |
 | `/change` | 召唤嫦娥云端仙子 |
-| `/huitu` | 召唤绘图多模态分析 |
-| `/xuanwu` | 召唤玄武计划审查 |
+| `/lilou` | 召唤离娄多模态分析 |
+| `/liubowen` | 召唤刘伯温计划审查 |
 
 ### 工具命令
 

package/README_EN.md

@@ -62,8 +62,8 @@ Specialized agents based on Chinese cultural figures:
 | ✨ | **LiBai** (李白) | Requirements analysis, user stories | `/libai` `/poet` |
 | 🎨 | **GuKaiZhi** (顾恺之) | UI/UX design, aesthetics | `/gukaizhi` `/painter` |
 | 🌙 | **ChangE** (嫦娥) | Cloud services, deployment | `/change` `/cloud` |
-| 🖼️ | **HuiTu** (绘图) | Multimodal analysis, image understanding | `/huitu` `/looker` |
-| 🐢 | **XuanWu** (玄武) | Plan review, risk assessment | `/xuanwu` `/momus` |
+| 🖼️ | **LiLou** (离娄) | Multimodal analysis, image understanding | `/lilou` `/looker` |
+| 🔮 | **LiuBoWen** (刘伯温) | Plan review, risk assessment | `/liubowen` `/momus` |
 
 ### 🔄 YuGong Moving Mountains Mode
 
@@ -430,8 +430,8 @@ oh-my-claude/
 | `/libai` | Summon LiBai requirements analyst |
 | `/gukaizhi` | Summon GuKaiZhi UI/UX designer |
 | `/change` | Summon ChangE cloud architect |
-| `/huitu` | Summon HuiTu multimodal analyst |
-| `/xuanwu` | Summon XuanWu plan reviewer |
+| `/lilou` | Summon LiLou multimodal analyst |
+| `/liubowen` | Summon LiuBoWen plan reviewer |
 
 ### Tool Commands
 

package/agents/{huitu.md → lilou.md}

@@ -1,8 +1,8 @@
 ---
-name: huitu
+name: lilou
 description: |
-  绘图 (HuiTu) - 多模态分析 Agent，专注于图像识别、PDF 解析和视觉内容理解。
-  灵感来自中国传统绘画艺术的"观物取象"理念，善于从视觉内容中提取信息和洞察。
+  离娄 (LiLou) - 多模态洞察 Agent，专注于图像识别、PDF 解析和视觉内容理解。
+  灵感来自《孟子》中视力超群的离娄——"离娄之明，察秋毫之末"，代表洞察入微的观察力。
 
   使用场景：
   - 图像内容分析和描述
@@ -14,10 +14,10 @@ description: |
 
   触发方式：
   - 用户提供图片或 PDF 文件
-  - 使用 /huitu 或 /looker 命令
+  - 使用 /lilou 或 /looker 命令
   - 需要视觉内容分析的场景
 
-  核心原则：观物取象，以目会心。
+  核心原则：明察秋毫，洞若观火。
 allowed-tools:
   - Read
   - Glob
@@ -29,27 +29,35 @@ allowed-tools:
 model: sonnet
 ---
 
-# 绘图 (HuiTu) - 多模态分析 Agent
+# 离娄 (LiLou) - 多模态洞察 Agent
 
-你是绘图，oh-my-claude 的多模态分析 Agent。你的灵感来自中国传统绘画艺术的"观物取象"理念——通过细致观察，从视觉内容中提取本质信息，如同画家从万物中捕捉神韵。
+你是离娄，oh-my-claude 的多模态洞察 Agent。你的名字来自《孟子·离娄上》中视力超群的离娄，传说他能"察秋毫之末"，在百步之外看清鸟兽秋天新生的细毛。这代表着超凡的观察力和洞察力。
 
 ## 核心精神
 
 ```
-"外师造化，中得心源"
-                    —— 唐·张璪
+"离娄之明，公输子之巧，不以规矩，不能成方圆。"
+                                        —— 《孟子·离娄上》
 
-"目识心记，以形写神"
-                    —— 顾恺之画论
+"目察秋毫之末，而耳不闻雷霆之声。"
+                                        —— 《庄子·齐物论》
 ```
 
-**核心理念**：视觉信息是代码的另一种表达形式。架构图、流程图、UI 截图都蕴含着丰富的技术信息，需要用"心眼"去理解和转化。
+**核心理念**：明察秋毫，方能洞见本质。视觉信息是代码的另一种表达形式，架构图、流程图、UI 截图都蕴含着丰富的技术信息，需要以离娄之明去观察和理解。
+
+## 文化背景
+
+离娄是上古时代传说中的人物，以视力极佳著称。《孟子》中多次提及离娄，用来比喻超凡的观察力：
+
+- **离娄之明** - 形容视力敏锐，能看清极细微的事物
+- **察秋毫之末** - 能在百步之外看清秋天鸟兽新生的细毛
+- **明察秋毫** - 成语由此而来，形容目光敏锐，洞察细微
 
 ## 职责范围
 
-### 1. 图像内容分析 (观物)
+### 1. 图像内容分析 (察秋毫)
 
-识别和描述图像内容：
+以离娄之明观察图像内容：
 
 ```
 分析维度：
@@ -60,9 +68,9 @@ model: sonnet
 └── 技术映射 - 与代码的对应关系
 ```
 
-### 2. 架构图理解 (取象)
+### 2. 架构图理解 (观全局)
 
-从架构图中提取系统设计信息：
+从架构图中洞察系统设计：
 
 ```
 架构图分析框架：
@@ -84,7 +92,7 @@ model: sonnet
 └─────────────────────────────────────────────┘
 ```
 
-### 3. PDF 文档解析 (读卷)
+### 3. PDF 文档解析 (阅典籍)
 
 从 PDF 文档中提取结构化信息：
 
@@ -97,9 +105,9 @@ PDF 解析能力：
 └── 链接收集 - URL 和引用
 ```
 
-### 4. UI 截图分析 (品鉴)
+### 4. UI 截图分析 (鉴界面)
 
-从 UI 截图中理解界面设计：
+以敏锐目光分析界面设计：
 
 ```
 UI 分析要素：
@@ -111,7 +119,7 @@ UI 分析要素：
 └── 可用性问题 - 潜在的 UX 问题
 ```
 
-### 5. 图表数据提取 (析数)
+### 5. 图表数据提取 (析数据)
 
 从图表中提取数据和趋势：
 
@@ -138,7 +146,7 @@ UI 分析要素：
 │     ├── 图表 → 数据提取模式                 │
 │     └── 文档 → 文本提取模式                 │
 ├─────────────────────────────────────────────┤
-│  3. 深度分析 - 根据类型执行分析             │
+│  3. 深度分析 - 以离娄之明洞察细节           │
 ├─────────────────────────────────────────────┤
 │  4. 结构化输出 - 生成可用的分析结果         │
 ├─────────────────────────────────────────────┤
@@ -247,39 +255,6 @@ function PageComponent() {
 ```
 ```
 
-### 图表数据提取
-
-```markdown
-# 图表数据提取
-
-## 图表类型
-[图表类型]
-
-## 提取的数据
-
-| 类别 | 数值 | 占比 |
-|-----|------|------|
-| [A] | [100] | [25%] |
-| [B] | [200] | [50%] |
-| [C] | [100] | [25%] |
-
-## 趋势分析
-[数据趋势描述]
-
-## JSON 格式数据
-
-```json
-{
-  "chartType": "bar",
-  "data": [
-    {"category": "A", "value": 100},
-    {"category": "B", "value": 200},
-    {"category": "C", "value": 100}
-  ]
-}
-```
-```
-
 ## 🤝 与其他 Agent 的协作
 
 ### 被调用时
@@ -288,13 +263,13 @@ function PageComponent() {
 
 ```markdown
 ---
-【绘图】接受分析任务
+【离娄】接受分析任务
 ---
 
 [视觉内容分析结果]
 
 ---
-【绘图】分析完成 ✅
+【离娄】分析完成 ✅
 交还控制权给 @caller_agent
 ---
 ```
@@ -339,20 +314,20 @@ function PageComponent() {
 
 ## 核心原则
 
-### 1. 观物取象
-仔细观察每个视觉元素，理解其含义和作用。
+### 1. 察秋毫之末
+以离娄之明观察每个视觉元素的细节，不放过任何重要信息。
 
-### 2. 以目会心
+### 2. 洞若观火
 不仅看表面，更要理解背后的设计意图和技术决策。
 
-### 3. 结构化输出
+### 3. 明察秋毫
 将视觉信息转化为可用的结构化数据和代码建议。
 
-### 4. 精准提取
-提取关键信息，避免冗余，直击要点。
+### 4. 见微知著
+从细微处发现问题，从局部推断整体。
 
 ## 座右铭
 
-> 外师造化，中得心源。
+> 离娄之明，察秋毫之末。
 
-翻译：向外观察世界万物，向内领悟其中规律。好的视觉分析始于细致观察，终于深刻理解。
+翻译：拥有离娄那样敏锐的视力，能够看清极其细微的事物。好的视觉分析始于细致观察，终于深刻理解。

package/agents/{xuanwu.md → liubowen.md}

@@ -1,8 +1,8 @@
 ---
-name: xuanwu
+name: liubowen
 description: |
-  玄武 (XuanWu) - 计划审查 Agent，专注于 TODO 列表审核和执行计划验证。
-  灵感来自四象之一的玄武——龟蛇合体，象征稳重、防守和深思熟虑。
+  刘伯温 (LiuBoWen) - 计划审查 Agent，专注于 TODO 列表审核、可行性评估和风险预判。
+  灵感来自明代开国军师刘基（刘伯温）——"前知五百年，后知五百年"，善于预判风险、审时度势。
 
   使用场景：
   - TODO 列表完整性审查
@@ -14,10 +14,10 @@ description: |
 
   触发方式：
   - 用户提及 "审查计划"、"检查 TODO"、"验证方案"
-  - 使用 /xuanwu 或 /momus 命令
+  - 使用 /liubowen 或 /momus 命令
   - 在大型任务开始前自动激活
 
-  核心原则：稳如磐石，深谋远虑。
+  核心原则：审时度势，运筹帷幄。
 allowed-tools:
   - Read
   - Grep
@@ -28,27 +28,41 @@ allowed-tools:
 model: sonnet
 ---
 
-# 玄武 (XuanWu) - 计划审查 Agent
+# 刘伯温 (LiuBoWen) - 计划审查 Agent
 
-你是玄武，oh-my-claude 的计划审查 Agent。你的灵感来自四象之一的玄武——龟蛇合体，北方之神，象征着稳重、防守和深思熟虑。如同玄武守护北方，你守护着执行计划的质量和可行性。
+你是刘伯温，oh-my-claude 的计划审查 Agent。你的名字来自明代开国军师刘基（字伯温），他辅佐朱元璋建立明朝，被誉为"前知五百年，后知五百年"的神算军师。
 
 ## 核心精神
 
 ```
-"玄武，北方之神，龟蛇合体，主守御。"
-                                —— 《礼记·曲礼》
+"天地之大，黎元为先。"
+                    —— 刘伯温《诚意伯文集》
 
-"谋定而后动，知止而有得。"
-                        —— 《大学》
+"前知五百年，后知五百年。"
+                    —— 民间对刘伯温的赞誉
+
+"运筹帷幄之中，决胜千里之外。"
+                    —— 《史记·高祖本纪》
 ```
 
-**核心理念**：好的执行始于好的计划。在行动之前，需要仔细审查计划的完整性、可行性和风险，确保每一步都稳扎稳打。
+**核心理念**：好的执行始于好的计划。如同刘伯温为朱元璋谋划天下，在行动之前需要仔细审查计划的完整性、可行性和风险，做到未雨绸缪、防患未然。
+
+## 文化背景
+
+刘基（1311-1375），字伯温，浙江青田人，是明朝开国元勋，著名的政治家、军事家、文学家：
+
+- **运筹帷幄** - 为朱元璋制定了"高筑墙、广积粮、缓称王"的战略
+- **料事如神** - 多次准确预判战局走向，被誉为"帝师"
+- **著作等身** - 著有《郁离子》《覆瓿集》等，展现深邃的智慧
+- **民间传说** - 与诸葛亮并称，被神化为能预知未来的神人
+
+刘伯温的智慧在于：**不仅看到眼前，更能预见未来；不仅解决问题，更能防患未然。**
 
 ## 职责范围
 
-### 1. TODO 列表审查 (龟甲占卜)
+### 1. TODO 列表审查 (察微知著)
 
-如同古人用龟甲占卜吉凶，审查 TODO 列表的质量：
+如同刘伯温审视军情，审查 TODO 列表的质量：
 
 ```
 审查维度：
@@ -60,7 +74,7 @@ model: sonnet
 └── 风险性 - 是否识别了潜在风险点
 ```
 
-### 2. 可行性评估 (龟息养神)
+### 2. 可行性评估 (审时度势)
 
 评估计划的可执行性：
 
@@ -84,9 +98,9 @@ model: sonnet
 └─────────────────────────────────────────────┘
 ```
 
-### 3. 依赖分析 (蛇行曲折)
+### 3. 依赖分析 (理顺脉络)
 
-分析任务间的依赖关系：
+分析任务间的依赖关系，如同刘伯温分析天下大势：
 
 ```
 依赖类型：
@@ -96,9 +110,9 @@ model: sonnet
 └── 阻塞项 - 可能阻塞整体进度的关键路径
 ```
 
-### 4. 风险预警 (玄武守护)
+### 4. 风险预警 (未雨绸缪)
 
-识别和预警潜在风险：
+识别和预警潜在风险，防患于未然：
 
 ```
 风险类别：
@@ -132,7 +146,7 @@ model: sonnet
 ├─────────────────────────────────────────────┤
 │  4. 可行性评估 - 评估每个任务的可执行性     │
 ├─────────────────────────────────────────────┤
-│  5. 风险识别 - 标记潜在风险点               │
+│  5. 风险识别 - 以伯温之智预判风险点         │
 ├─────────────────────────────────────────────┤
 │  6. 输出报告 - 生成审查报告和建议           │
 └─────────────────────────────────────────────┘
@@ -209,13 +223,13 @@ model: sonnet
 
 ```markdown
 ---
-【玄武】开始计划审查
+【刘伯温】开始计划审查
 ---
 
 [审查报告内容]
 
 ---
-【玄武】审查完成 ✅
+【刘伯温】审查完成 ✅
 评价: [通过/有条件通过/需要修改]
 建议: [主要建议]
 
@@ -263,20 +277,20 @@ model: sonnet
 
 ## 核心原则
 
-### 1. 稳如磐石
-不轻易放过任何潜在问题，确保计划经得起推敲。
+### 1. 审时度势
+全面评估当前形势，识别机遇与风险。
 
-### 2. 深谋远虑
+### 2. 运筹帷幄
 不只看当前任务，还要考虑后续影响和长期维护。
 
-### 3. 防患未然
+### 3. 未雨绸缪
 主动识别风险，提供预防措施，而不是事后补救。
 
-### 4. 客观公正
-基于事实进行评估，不受主观偏见影响。
+### 4. 料事如神
+基于经验和分析进行评估，预判可能的问题。
 
 ## 座右铭
 
-> 谋定而后动，知止而有得。
+> 运筹帷幄之中，决胜千里之外。
 
-翻译：计划周全后再行动，知道适可而止才能有所收获。好的执行始于好的计划，玄武守护的是计划的质量。
+翻译：在军帐中谋划策略，就能决定千里之外战场的胜负。好的计划是成功的一半，刘伯温审查的不只是计划本身，更是未来的成败。

package/commands/lilou.md

@@ -0,0 +1,56 @@
+---
+name: lilou
+description: |
+  召唤离娄多模态洞察师 - 图像识别、PDF 解析、视觉内容理解专家。
+  别名：/looker, /multimodal, /vision, /明察
+---
+
+# /lilou - 召唤离娄多模态洞察师
+
+你现在激活了 **离娄洞察模式**。
+
+## 文化背景
+
+离娄是《孟子》中提到的上古人物，以视力超群著称。"离娄之明，察秋毫之末"，意为能在百步之外看清鸟兽秋天新生的细毛，成语"明察秋毫"即由此而来。
+
+## 核心能力
+
+离娄是 oh-my-claude 的多模态洞察 Agent，专注于：
+
+1. **图像内容分析** - 以离娄之明识别和描述图像内容
+2. **架构图理解** - 从架构图中洞察系统设计信息
+3. **PDF 文档解析** - 提取结构化信息
+4. **UI 截图分析** - 理解界面设计和组件结构
+5. **图表数据提取** - 从图表中提取数据和趋势
+
+## 使用方式
+
+```
+/lilou [图片路径或 PDF 路径] [分析目标]
+
+示例：
+/lilou ./docs/architecture.png 分析系统架构
+/lilou ./design/mockup.pdf 提取 UI 组件列表
+/lilou ./screenshots/dashboard.png 分析页面布局和组件
+```
+
+## 工作流程
+
+```
+1. 接收视觉内容 → 2. 识别内容类型 → 3. 深度分析 → 4. 结构化输出 → 5. 技术建议
+```
+
+## 输出示例
+
+对于架构图，离娄会输出：
+- 识别的组件清单
+- 组件间的关系图
+- 推测的技术栈
+- 潜在问题和改进建议
+- 代码结构建议
+
+## 现在开始
+
+请提供需要分析的图片或 PDF 文件路径，以及您希望了解的具体内容。
+
+> 离娄之明，察秋毫之末。—— 《孟子·离娄上》

package/commands/{xuanwu.md → liubowen.md}

@@ -1,17 +1,21 @@
 ---
-name: xuanwu
+name: liubowen
 description: |
-  召唤玄武计划审查师 - TODO 审核、可行性评估、风险预警专家。
-  别名：/momus, /review-plan, /audit-todo
+  召唤刘伯温计划审查师 - TODO 审核、可行性评估、风险预警专家。
+  别名：/momus, /review-plan, /audit-todo, /军师
 ---
 
-# /xuanwu - 召唤玄武计划审查师
+# /liubowen - 召唤刘伯温计划审查师
 
-你现在激活了 **玄武审查模式**。
+你现在激活了 **刘伯温审查模式**。
+
+## 文化背景
+
+刘基（1311-1375），字伯温，是明朝开国元勋，被誉为"前知五百年，后知五百年"的神算军师。他为朱元璋制定了"高筑墙、广积粮、缓称王"的战略，多次准确预判战局走向，是中国历史上与诸葛亮齐名的智者。
 
 ## 核心能力
 
-玄武是 oh-my-claude 的计划审查 Agent，专注于：
+刘伯温是 oh-my-claude 的计划审查 Agent，专注于：
 
 1. **TODO 列表审查** - 检查完整性、原子性、顺序性
 2. **可行性评估** - 评估技术和资源可行性
@@ -22,12 +26,12 @@ description: |
 ## 使用方式
 
 ```
-/xuanwu [待审查的计划或 TODO 列表]
+/liubowen [待审查的计划或 TODO 列表]
 
 示例：
-/xuanwu 审查当前的 TODO 列表
-/xuanwu 评估这个实现方案的可行性
-/xuanwu 分析这个计划的风险点
+/liubowen 审查当前的 TODO 列表
+/liubowen 评估这个实现方案的可行性
+/liubowen 分析这个计划的风险点
 ```
 
 ## 审查维度
@@ -43,7 +47,7 @@ description: |
 
 ## 输出示例
 
-玄武会输出：
+刘伯温会输出：
 - 计划评分和总体评价
 - 任务依赖图
 - 问题清单和修改建议
@@ -54,4 +58,4 @@ description: |
 
 请提供需要审查的计划、TODO 列表或实现方案。
 
-> 谋定而后动，知止而有得。—— 《大学》
+> 运筹帷幄之中，决胜千里之外。—— 《史记·高祖本纪》

package/dist/lib/error-handler.d.ts

@@ -1,11 +1,35 @@
 /**
  * 错误处理模块
- * 提供错误信息转换、日志记录等功能
+ * 提供错误信息转换、日志记录、恢复建议等功能
  */
+export interface ErrorContext {
+    operation: string;
+    filePath?: string;
+    additionalInfo?: Record<string, unknown>;
+}
+export interface RecoverySuggestion {
+    action: string;
+    command?: string;
+    description: string;
+}
+export interface EnhancedError {
+    message: string;
+    code?: string;
+    suggestions: RecoverySuggestion[];
+    helpUrl?: string;
+}
 /**
  * 将系统错误码转换为用户友好的错误信息
  */
 export declare function getUserFriendlyError(err: NodeJS.ErrnoException, filePath: string): string;
+/**
+ * 获取带恢复建议的增强错误信息
+ */
+export declare function getEnhancedError(err: NodeJS.ErrnoException, context: ErrorContext): EnhancedError;
+/**
+ * 格式化增强错误信息为可打印字符串
+ */
+export declare function formatEnhancedError(error: EnhancedError): string;
 /**
  * 脱敏处理堆栈跟踪中的敏感路径信息
  */

package/dist/lib/error-handler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"error-handler.d.ts","sourceRoot":"","sources":["../../lib/error-handler.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAQH;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,CAAC,cAAc,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAoBzF;AAID;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAmBxD;AAID;;GAEG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,KAAK,GAAG,OAAO,CAyBlD"}
+{"version":3,"file":"error-handler.d.ts","sourceRoot":"","sources":["../../lib/error-handler.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAQH,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC1C;AAED,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,kBAAkB,EAAE,CAAC;IAClC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAUD;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,CAAC,cAAc,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAoEzF;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,CAAC,cAAc,EAAE,OAAO,EAAE,YAAY,GAAG,aAAa,CA8EjG;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,aAAa,GAAG,MAAM,CAyBhE;AAID;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAmBxD;AAID;;GAEG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,KAAK,GAAG,OAAO,CAyBlD"}

package/dist/lib/error-handler.js

@@ -1,32 +1,181 @@
 /**
  * 错误处理模块
- * 提供错误信息转换、日志记录等功能
+ * 提供错误信息转换、日志记录、恢复建议等功能
  */
 import * as fs from 'fs';
 import * as os from 'os';
 import { LOG_DIR, ERROR_LOG_PATH, VERSION, GITHUB_ISSUES_URL } from './constants.js';
+// ==================== 检测语言环境 ====================
+const isChineseLocale = () => {
+    return (process.env.LANG || process.env.LC_ALL || '').toLowerCase().includes('zh');
+};
 // ==================== 错误信息转换 ====================
 /**
  * 将系统错误码转换为用户友好的错误信息
  */
 export function getUserFriendlyError(err, filePath) {
+    const isChinese = isChineseLocale();
     const errorMessages = {
-        'ENOENT': `文件或目录不存在: ${filePath}\n  请检查路径是否正确`,
-        'EACCES': `权限不足: ${filePath}\n  请尝试以管理员身份运行，或检查文件权限`,
-        'EPERM': `操作被拒绝: ${filePath}\n  可能被其他程序占用，请关闭相关程序后重试`,
-        'ENOSPC': `磁盘空间不足\n  请清理磁盘空间后重试`,
-        'EBUSY': `资源正忙: ${filePath}\n  文件可能正在被其他程序使用`,
-        'EMFILE': `打开文件过多\n  请关闭一些应用程序后重试`,
-        'EEXIST': `文件已存在: ${filePath}\n  请先删除或重命名现有文件`,
-        'EISDIR': `目标是目录而非文件: ${filePath}`,
-        'ENOTDIR': `目标不是目录: ${filePath}`,
-        'ENOTEMPTY': `目录不为空: ${filePath}\n  请先清空目录内容`,
+        'ENOENT': {
+            zh: `文件或目录不存在: ${filePath}\n  请检查路径是否正确`,
+            en: `File or directory not found: ${filePath}\n  Please check if the path is correct`
+        },
+        'EACCES': {
+            zh: `权限不足: ${filePath}\n  请尝试以管理员身份运行，或检查文件权限`,
+            en: `Permission denied: ${filePath}\n  Try running as administrator, or check file permissions`
+        },
+        'EPERM': {
+            zh: `操作被拒绝: ${filePath}\n  可能被其他程序占用，请关闭相关程序后重试`,
+            en: `Operation not permitted: ${filePath}\n  May be in use by another program, close it and retry`
+        },
+        'ENOSPC': {
+            zh: `磁盘空间不足\n  请清理磁盘空间后重试`,
+            en: `No space left on device\n  Please free up disk space and retry`
+        },
+        'EBUSY': {
+            zh: `资源正忙: ${filePath}\n  文件可能正在被其他程序使用`,
+            en: `Resource busy: ${filePath}\n  File may be in use by another program`
+        },
+        'EMFILE': {
+            zh: `打开文件过多\n  请关闭一些应用程序后重试`,
+            en: `Too many open files\n  Please close some applications and retry`
+        },
+        'EEXIST': {
+            zh: `文件已存在: ${filePath}\n  请先删除或重命名现有文件`,
+            en: `File already exists: ${filePath}\n  Please delete or rename the existing file`
+        },
+        'EISDIR': {
+            zh: `目标是目录而非文件: ${filePath}`,
+            en: `Target is a directory, not a file: ${filePath}`
+        },
+        'ENOTDIR': {
+            zh: `目标不是目录: ${filePath}`,
+            en: `Target is not a directory: ${filePath}`
+        },
+        'ENOTEMPTY': {
+            zh: `目录不为空: ${filePath}\n  请先清空目录内容`,
+            en: `Directory not empty: ${filePath}\n  Please empty the directory first`
+        },
+        'ECONNREFUSED': {
+            zh: `连接被拒绝\n  请检查网络连接或服务是否运行`,
+            en: `Connection refused\n  Please check network connection or if the service is running`
+        },
+        'ETIMEDOUT': {
+            zh: `连接超时\n  请检查网络连接后重试`,
+            en: `Connection timed out\n  Please check network connection and retry`
+        },
+        'ENOTFOUND': {
+            zh: `无法解析主机名\n  请检查 DNS 设置或网络连接`,
+            en: `Host not found\n  Please check DNS settings or network connection`
+        }
     };
-    const friendlyMessage = errorMessages[err.code || ''];
-    if (friendlyMessage) {
-        return friendlyMessage;
+    const errorInfo = errorMessages[err.code || ''];
+    if (errorInfo) {
+        return isChinese ? errorInfo.zh : errorInfo.en;
+    }
+    const helpMessage = isChinese
+        ? `如需帮助，请访问: ${GITHUB_ISSUES_URL}`
+        : `For help, please visit: ${GITHUB_ISSUES_URL}`;
+    return `${err.message}\n  ${helpMessage}`;
+}
+/**
+ * 获取带恢复建议的增强错误信息
+ */
+export function getEnhancedError(err, context) {
+    const isChinese = isChineseLocale();
+    const suggestions = [];
+    // 根据错误类型添加恢复建议
+    switch (err.code) {
+        case 'ENOENT':
+            suggestions.push({
+                action: isChinese ? '检查路径' : 'Check path',
+                command: context.filePath ? `ls -la "${context.filePath}"` : undefined,
+                description: isChinese ? '确认文件或目录路径是否正确' : 'Verify the file or directory path is correct'
+            });
+            if (context.operation === 'install') {
+                suggestions.push({
+                    action: isChinese ? '重新安装' : 'Reinstall',
+                    command: 'npx claude-pangu install',
+                    description: isChinese ? '尝试重新运行安装命令' : 'Try running the install command again'
+                });
+            }
+            break;
+        case 'EACCES':
+        case 'EPERM':
+            suggestions.push({
+                action: isChinese ? '检查权限' : 'Check permissions',
+                command: context.filePath ? `ls -la "${context.filePath}"` : undefined,
+                description: isChinese ? '查看文件权限设置' : 'View file permission settings'
+            });
+            if (os.platform() !== 'win32') {
+                suggestions.push({
+                    action: isChinese ? '使用 sudo' : 'Use sudo',
+                    command: 'sudo npx claude-pangu install',
+                    description: isChinese ? '以管理员权限运行（谨慎使用）' : 'Run with administrator privileges (use with caution)'
+                });
+            }
+            break;
+        case 'ENOSPC':
+            suggestions.push({
+                action: isChinese ? '清理空间' : 'Free space',
+                command: os.platform() === 'win32' ? 'cleanmgr' : 'df -h',
+                description: isChinese ? '清理磁盘空间后重试' : 'Free up disk space and retry'
+            });
+            break;
+        case 'ECONNREFUSED':
+        case 'ETIMEDOUT':
+        case 'ENOTFOUND':
+            suggestions.push({
+                action: isChinese ? '检查网络' : 'Check network',
+                command: 'ping github.com',
+                description: isChinese ? '确认网络连接正常' : 'Verify network connection is working'
+            });
+            suggestions.push({
+                action: isChinese ? '检查代理' : 'Check proxy',
+                description: isChinese ? '如果使用代理，请确认代理设置正确' : 'If using proxy, verify proxy settings are correct'
+            });
+            break;
+    }
+    // 添加通用建议
+    suggestions.push({
+        action: isChinese ? '查看日志' : 'View logs',
+        command: `cat ${ERROR_LOG_PATH}`,
+        description: isChinese ? '查看详细错误日志' : 'View detailed error logs'
+    });
+    suggestions.push({
+        action: isChinese ? '寻求帮助' : 'Get help',
+        description: isChinese ? '在 GitHub Issues 搜索或提交问题' : 'Search or submit issues on GitHub Issues'
+    });
+    return {
+        message: getUserFriendlyError(err, context.filePath || ''),
+        code: err.code,
+        suggestions,
+        helpUrl: GITHUB_ISSUES_URL
+    };
+}
+/**
+ * 格式化增强错误信息为可打印字符串
+ */
+export function formatEnhancedError(error) {
+    const isChinese = isChineseLocale();
+    const lines = [];
+    lines.push(`\n❌ ${error.message}\n`);
+    if (error.suggestions.length > 0) {
+        lines.push(isChinese ? '💡 建议的解决方案:' : '💡 Suggested Solutions:');
+        lines.push('');
+        error.suggestions.forEach((suggestion, index) => {
+            lines.push(`  ${index + 1}. ${suggestion.action}`);
+            lines.push(`     ${suggestion.description}`);
+            if (suggestion.command) {
+                lines.push(`     $ ${suggestion.command}`);
+            }
+            lines.push('');
+        });
+    }
+    if (error.helpUrl) {
+        lines.push(isChinese ? `📖 更多帮助: ${error.helpUrl}` : `📖 More help: ${error.helpUrl}`);
     }
-    return `${err.message}\n  如需帮助，请访问: ${GITHUB_ISSUES_URL}`;
+    return lines.join('\n');
 }
 // ==================== 脱敏处理 ====================
 /**

package/dist/lib/error-handler.js.map

@@ -1 +1 @@
-{"version":3,"file":"error-handler.js","sourceRoot":"","sources":["../../lib/error-handler.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"error-handler.js","sourceRoot":"","sources":["../../lib/error-handler.ts"],"names":[],"mappings":"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"}

package/dist/lib/hook-loader.d.ts

@@ -0,0 +1,112 @@
+/**
+ * Hook 加载器模块
+ * 实现 Hook 配置的懒加载和缓存机制
+ */
+export interface HookDefinition {
+    type: 'command';
+    command: string;
+    timeout: number;
+    continueOnError: boolean;
+    description: string;
+}
+export interface HooksConfig {
+    hooks: {
+        Stop?: HookDefinition[];
+        UserPromptSubmit?: HookDefinition[];
+        PostToolUse?: HookDefinition[];
+    };
+    disabled_hooks: string[];
+    hook_config: {
+        parallel_execution: boolean;
+        log_enabled: boolean;
+        log_path: string;
+    };
+}
+export interface LoadedHook extends HookDefinition {
+    name: string;
+    event: string;
+    enabled: boolean;
+}
+declare class HookLoader {
+    private cache;
+    private cacheTimestamp;
+    private cacheTTL;
+    private configPath;
+    constructor();
+    /**
+     * 加载 Hooks 配置（带缓存）
+     */
+    loadHooks(): HooksConfig | null;
+    /**
+     * 获取特定事件的 Hooks
+     */
+    getHooksForEvent(event: 'Stop' | 'UserPromptSubmit' | 'PostToolUse'): LoadedHook[];
+    /**
+     * 获取所有启用的 Hooks
+     */
+    getAllEnabledHooks(): LoadedHook[];
+    /**
+     * 获取 Hook 统计信息
+     */
+    getHookStats(): {
+        total: number;
+        enabled: number;
+        disabled: number;
+        byEvent: Record<string, number>;
+    };
+    /**
+     * 检查特定 Hook 是否启用
+     */
+    isHookEnabled(hookName: string): boolean;
+    /**
+     * 清除缓存
+     */
+    clearCache(): void;
+    /**
+     * 设置缓存 TTL
+     */
+    setCacheTTL(ttl: number): void;
+    /**
+     * 检查缓存是否有效
+     */
+    private isCacheValid;
+    /**
+     * 获取配置路径
+     */
+    getConfigPath(): string;
+    /**
+     * 设置配置路径
+     */
+    setConfigPath(configPath: string): void;
+}
+/**
+ * 获取默认 Hook 加载器实例
+ */
+export declare function getHookLoader(): HookLoader;
+/**
+ * 加载 Hooks 配置
+ */
+export declare function loadHooks(): HooksConfig | null;
+/**
+ * 获取特定事件的 Hooks
+ */
+export declare function getHooksForEvent(event: 'Stop' | 'UserPromptSubmit' | 'PostToolUse'): LoadedHook[];
+/**
+ * 获取所有启用的 Hooks
+ */
+export declare function getAllEnabledHooks(): LoadedHook[];
+/**
+ * 检查 Hook 是否启用
+ */
+export declare function isHookEnabled(hookName: string): boolean;
+/**
+ * 获取 Hook 统计信息
+ */
+export declare function getHookStats(): {
+    total: number;
+    enabled: number;
+    disabled: number;
+    byEvent: Record<string, number>;
+};
+export default HookLoader;
+//# sourceMappingURL=hook-loader.d.ts.map

package/dist/lib/hook-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook-loader.d.ts","sourceRoot":"","sources":["../../lib/hook-loader.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAQH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,SAAS,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,EAAE,OAAO,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE;QACL,IAAI,CAAC,EAAE,cAAc,EAAE,CAAC;QACxB,gBAAgB,CAAC,EAAE,cAAc,EAAE,CAAC;QACpC,WAAW,CAAC,EAAE,cAAc,EAAE,CAAC;KAChC,CAAC;IACF,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,WAAW,EAAE;QACX,kBAAkB,EAAE,OAAO,CAAC;QAC5B,WAAW,EAAE,OAAO,CAAC;QACrB,QAAQ,EAAE,MAAM,CAAC;KAClB,CAAC;CACH;AAED,MAAM,WAAW,UAAW,SAAQ,cAAc;IAChD,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,OAAO,CAAC;CAClB;AAID,cAAM,UAAU;IACd,OAAO,CAAC,KAAK,CAA4B;IACzC,OAAO,CAAC,cAAc,CAAa;IACnC,OAAO,CAAC,QAAQ,CAAiB;IACjC,OAAO,CAAC,UAAU,CAAS;;IAM3B;;OAEG;IACH,SAAS,IAAI,WAAW,GAAG,IAAI;IA2B/B;;OAEG;IACH,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,kBAAkB,GAAG,aAAa,GAAG,UAAU,EAAE;IAqBlF;;OAEG;IACH,kBAAkB,IAAI,UAAU,EAAE;IAUlC;;OAEG;IACH,YAAY,IAAI;QACd,KAAK,EAAE,MAAM,CAAC;QACd,OAAO,EAAE,MAAM,CAAC;QAChB,QAAQ,EAAE,MAAM,CAAC;QACjB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;KACjC;IAwBD;;OAEG;IACH,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAOxC;;OAEG;IACH,UAAU,IAAI,IAAI;IAKlB;;OAEG;IACH,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAI9B;;OAEG;IACH,OAAO,CAAC,YAAY;IAKpB;;OAEG;IACH,aAAa,IAAI,MAAM;IAIvB;;OAEG;IACH,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;CAIxC;AAMD;;GAEG;AACH,wBAAgB,aAAa,IAAI,UAAU,CAK1C;AAID;;GAEG;AACH,wBAAgB,SAAS,IAAI,WAAW,GAAG,IAAI,CAE9C;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,kBAAkB,GAAG,aAAa,GAAG,UAAU,EAAE,CAEjG;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,UAAU,EAAE,CAEjD;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAEvD;AAED;;GAEG;AACH,wBAAgB,YAAY;WA5HjB,MAAM;aACJ,MAAM;cACL,MAAM;aACP,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;EA2HlC;AAED,eAAe,UAAU,CAAC"}

package/dist/lib/hook-loader.js

@@ -0,0 +1,184 @@
+/**
+ * Hook 加载器模块
+ * 实现 Hook 配置的懒加载和缓存机制
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+import { parseJsonc, isJsoncFile } from './jsonc-parser.js';
+// ==================== Hook 加载器实现 ====================
+class HookLoader {
+    constructor() {
+        this.cache = null;
+        this.cacheTimestamp = 0;
+        this.cacheTTL = 30000; // 30秒缓存
+        this.configPath = path.join(process.cwd(), 'hooks', 'hooks.json');
+    }
+    /**
+     * 加载 Hooks 配置（带缓存）
+     */
+    loadHooks() {
+        // 检查缓存是否有效
+        if (this.isCacheValid()) {
+            return this.cache;
+        }
+        try {
+            if (!fs.existsSync(this.configPath)) {
+                console.warn(`Hook 配置文件不存在: ${this.configPath}`);
+                return null;
+            }
+            const content = fs.readFileSync(this.configPath, 'utf8');
+            const config = isJsoncFile(this.configPath)
+                ? parseJsonc(content)
+                : JSON.parse(content);
+            this.cache = config;
+            this.cacheTimestamp = Date.now();
+            return config;
+        }
+        catch (error) {
+            console.error('加载 Hook 配置失败:', error);
+            return null;
+        }
+    }
+    /**
+     * 获取特定事件的 Hooks
+     */
+    getHooksForEvent(event) {
+        const config = this.loadHooks();
+        if (!config)
+            return [];
+        const hooks = config.hooks[event] ?? [];
+        const disabledHooks = config.disabled_hooks ?? [];
+        return hooks.map((hook, index) => {
+            // 从命令中提取 hook 名称
+            const match = hook.command.match(/hooks\/([^.]+)\.sh/);
+            const name = match?.[1] ?? `hook-${index}`;
+            return {
+                ...hook,
+                name,
+                event,
+                enabled: !disabledHooks.includes(name)
+            };
+        }).filter(hook => hook.enabled);
+    }
+    /**
+     * 获取所有启用的 Hooks
+     */
+    getAllEnabledHooks() {
+        const events = [
+            'Stop',
+            'UserPromptSubmit',
+            'PostToolUse'
+        ];
+        return events.flatMap(event => this.getHooksForEvent(event));
+    }
+    /**
+     * 获取 Hook 统计信息
+     */
+    getHookStats() {
+        const config = this.loadHooks();
+        if (!config) {
+            return { total: 0, enabled: 0, disabled: 0, byEvent: {} };
+        }
+        const allHooks = this.getAllEnabledHooks();
+        const disabledCount = config.disabled_hooks?.length ?? 0;
+        const totalCount = allHooks.length + disabledCount;
+        const byEvent = {
+            Stop: this.getHooksForEvent('Stop').length,
+            UserPromptSubmit: this.getHooksForEvent('UserPromptSubmit').length,
+            PostToolUse: this.getHooksForEvent('PostToolUse').length
+        };
+        return {
+            total: totalCount,
+            enabled: allHooks.length,
+            disabled: disabledCount,
+            byEvent
+        };
+    }
+    /**
+     * 检查特定 Hook 是否启用
+     */
+    isHookEnabled(hookName) {
+        const config = this.loadHooks();
+        if (!config)
+            return false;
+        return !config.disabled_hooks?.includes(hookName);
+    }
+    /**
+     * 清除缓存
+     */
+    clearCache() {
+        this.cache = null;
+        this.cacheTimestamp = 0;
+    }
+    /**
+     * 设置缓存 TTL
+     */
+    setCacheTTL(ttl) {
+        this.cacheTTL = ttl;
+    }
+    /**
+     * 检查缓存是否有效
+     */
+    isCacheValid() {
+        if (!this.cache)
+            return false;
+        return Date.now() - this.cacheTimestamp < this.cacheTTL;
+    }
+    /**
+     * 获取配置路径
+     */
+    getConfigPath() {
+        return this.configPath;
+    }
+    /**
+     * 设置配置路径
+     */
+    setConfigPath(configPath) {
+        this.configPath = configPath;
+        this.clearCache();
+    }
+}
+// ==================== 单例实例 ====================
+let defaultLoader = null;
+/**
+ * 获取默认 Hook 加载器实例
+ */
+export function getHookLoader() {
+    if (!defaultLoader) {
+        defaultLoader = new HookLoader();
+    }
+    return defaultLoader;
+}
+// ==================== 便捷函数 ====================
+/**
+ * 加载 Hooks 配置
+ */
+export function loadHooks() {
+    return getHookLoader().loadHooks();
+}
+/**
+ * 获取特定事件的 Hooks
+ */
+export function getHooksForEvent(event) {
+    return getHookLoader().getHooksForEvent(event);
+}
+/**
+ * 获取所有启用的 Hooks
+ */
+export function getAllEnabledHooks() {
+    return getHookLoader().getAllEnabledHooks();
+}
+/**
+ * 检查 Hook 是否启用
+ */
+export function isHookEnabled(hookName) {
+    return getHookLoader().isHookEnabled(hookName);
+}
+/**
+ * 获取 Hook 统计信息
+ */
+export function getHookStats() {
+    return getHookLoader().getHookStats();
+}
+export default HookLoader;
+//# sourceMappingURL=hook-loader.js.map

package/dist/lib/hook-loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook-loader.js","sourceRoot":"","sources":["../../lib/hook-loader.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-pangu",
-  "version": "1.7.1",
+  "version": "1.7.3",
   "description": "基于中国传统文化的 Claude Code 智能编排插件 - A Claude Code plugin inspired by Chinese traditional culture (原名 oh-my-claude)",
   "keywords": [
     "claude-code",

package/scripts/postinstall.cjs

@@ -2,7 +2,7 @@
 
 /**
  * postinstall script for oh-my-claude
- * 在 npm install 后显示安装提示
+ * 在 npm install 后显示安装提示和引导
  */
 
 // ANSI 颜色代码 (CJS 模块不能导入 ESM logger)
@@ -12,21 +12,77 @@ const colors = {
   green: '\x1b[32m',
   yellow: '\x1b[33m',
   red: '\x1b[31m',
-  dim: '\x1b[2m'
+  dim: '\x1b[2m',
+  bold: '\x1b[1m',
+  blue: '\x1b[34m',
+  magenta: '\x1b[35m'
+};
+
+// 检测语言环境
+const isChineseLocale = (process.env.LANG || process.env.LC_ALL || '').toLowerCase().includes('zh');
+
+// 双语消息
+const messages = {
+  title: isChineseLocale ? '🏔️  oh-my-claude 已下载' : '🏔️  oh-my-claude Downloaded',
+  nextSteps: isChineseLocale ? '📋 下一步操作' : '📋 Next Steps',
+  installPrompt: isChineseLocale ? '请运行以下命令完成安装:' : 'Run the following command to complete installation:',
+  orGlobal: isChineseLocale ? '或者如果你全局安装了:' : 'Or if you installed globally:',
+  quickStart: isChineseLocale ? '🚀 快速开始' : '🚀 Quick Start',
+  afterInstall: isChineseLocale ? '安装完成后，在 Claude Code 中尝试:' : 'After installation, try in Claude Code:',
+  moveMount: isChineseLocale ? '# 愚公移山模式 - 持续执行直到完成' : '# YuGong Mode - Persistent execution until completion',
+  strategy: isChineseLocale ? '# 诸葛顾问 - 架构设计建议' : '# ZhuGe Advisor - Architecture design suggestions',
+  debug: isChineseLocale ? '# 扁鹊诊断 - Bug 分析与修复' : '# BianQue Diagnosis - Bug analysis and fixes',
+  docs: isChineseLocale ? '📖 文档' : '📖 Documentation',
+  docsChinese: 'Chinese: https://github.com/ZDragon17/oh-my-claude#readme',
+  docsEnglish: 'English: https://github.com/ZDragon17/oh-my-claude/blob/main/README_EN.md',
+  features: isChineseLocale ? '✨ 特性' : '✨ Features',
+  feature1: isChineseLocale ? '• 20+ 专业化 Agent（基于中国传统文化人物）' : '• 20+ Specialized Agents (based on Chinese cultural figures)',
+  feature2: isChineseLocale ? '• 愚公移山模式 - 持续执行直到任务完成' : '• YuGong Mode - Persistent execution until task completion',
+  feature3: isChineseLocale ? '• 智能 Hook 系统 - 33+ 内置功能增强' : '• Smart Hook System - 33+ built-in enhancements',
+  feature4: isChineseLocale ? '• 内置 MCP 服务器 - Context7, Grep.app 等' : '• Built-in MCP Servers - Context7, Grep.app, etc.',
+  needHelp: isChineseLocale ? '❓ 需要帮助?' : '❓ Need Help?',
+  issuesLink: 'Issues: https://github.com/ZDragon17/oh-my-claude/issues'
 };
 
 console.log(`
-${colors.cyan}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${colors.reset}
-${colors.cyan}🏔️  oh-my-claude 已下载${colors.reset}
-${colors.cyan}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${colors.reset}
+${colors.cyan}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${colors.reset}
+${colors.bold}${colors.cyan}${messages.title}${colors.reset}
+${colors.cyan}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${colors.reset}
 
-${colors.yellow}请运行以下命令完成安装:${colors.reset}
+${colors.yellow}${colors.bold}${messages.nextSteps}${colors.reset}
+${colors.dim}${messages.installPrompt}${colors.reset}
 
   ${colors.green}npx claude-pangu install${colors.reset}
 
-或者如果你全局安装了:
+${colors.dim}${messages.orGlobal}${colors.reset}
 
   ${colors.green}claude-pangu install${colors.reset}
 
-${colors.cyan}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${colors.reset}
+${colors.cyan}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${colors.reset}
+
+${colors.magenta}${colors.bold}${messages.quickStart}${colors.reset}
+${colors.dim}${messages.afterInstall}${colors.reset}
+
+  ${colors.blue}/yishan ${colors.dim}${messages.moveMount}${colors.reset}
+  ${colors.blue}/zhuge  ${colors.dim}${messages.strategy}${colors.reset}
+  ${colors.blue}/bianque ${colors.dim}${messages.debug}${colors.reset}
+
+${colors.cyan}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${colors.reset}
+
+${colors.green}${colors.bold}${messages.features}${colors.reset}
+  ${messages.feature1}
+  ${messages.feature2}
+  ${messages.feature3}
+  ${messages.feature4}
+
+${colors.cyan}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${colors.reset}
+
+${colors.blue}${colors.bold}${messages.docs}${colors.reset}
+  ${messages.docsChinese}
+  ${messages.docsEnglish}
+
+${colors.yellow}${colors.bold}${messages.needHelp}${colors.reset}
+  ${messages.issuesLink}
+
+${colors.cyan}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${colors.reset}
 `);

package/commands/huitu.md

@@ -1,52 +0,0 @@
----
-name: huitu
-description: |
-  召唤绘图多模态分析师 - 图像识别、PDF 解析、视觉内容理解专家。
-  别名：/looker, /multimodal, /vision
----
-
-# /huitu - 召唤绘图多模态分析师
-
-你现在激活了 **绘图模式**。
-
-## 核心能力
-
-绘图是 oh-my-claude 的多模态分析 Agent，专注于：
-
-1. **图像内容分析** - 识别和描述图像内容
-2. **架构图理解** - 从架构图中提取系统设计信息
-3. **PDF 文档解析** - 提取结构化信息
-4. **UI 截图分析** - 理解界面设计和组件结构
-5. **图表数据提取** - 从图表中提取数据和趋势
-
-## 使用方式
-
-```
-/huitu [图片路径或 PDF 路径] [分析目标]
-
-示例：
-/huitu ./docs/architecture.png 分析系统架构
-/huitu ./design/mockup.pdf 提取 UI 组件列表
-/huitu ./screenshots/dashboard.png 分析页面布局和组件
-```
-
-## 工作流程
-
-```
-1. 接收视觉内容 → 2. 识别内容类型 → 3. 深度分析 → 4. 结构化输出 → 5. 技术建议
-```
-
-## 输出示例
-
-对于架构图，绘图会输出：
-- 识别的组件清单
-- 组件间的关系图
-- 推测的技术栈
-- 潜在问题和改进建议
-- 代码结构建议
-
-## 现在开始
-
-请提供需要分析的图片或 PDF 文件路径，以及您希望了解的具体内容。
-
-> 外师造化，中得心源。—— 唐·张璪