release: v1.4.2 - 需求索引自动更新 + 迁移漏检修复 + check-file-size脚本

CoderMoray · CoderMoray · commit 2106cea866df · 2026-06-12T12:55:09.000+08:00
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -6,6 +6,13 @@
 
 ---
 
+## [1.4.2] - 2026-06-12
+
+### 🔧 需求索引自动维护 + 迁移漏检修复
+
+- 需求状态变更/创建/归档/删除时自动更新 `requirements/README.md` 索引
+- 自检迁移探测扩展：projects.yaml 不存在时检查 global/ 下已有子目录
+
 ## [1.4.1] - 2026-06-12
 
 ### 🔧 导出/导入完善
diff --git a/README.md b/README.md
@@ -1,5 +1,5 @@
 <p align="center">
-  <img src="https://img.shields.io/badge/version-1.4.1-blue" alt="Version" />
+  <img src="https://img.shields.io/badge/version-1.4.2-blue" alt="Version" />
   <img src="https://img.shields.io/badge/license-Apache%202.0-green" alt="License" />
   <a href="https://github.com/CoderMoray/MyKnowledge"><img src="https://img.shields.io/badge/GitHub-CoderMoray-black?logo=github" alt="GitHub" /></a>
 </p>
@@ -54,7 +54,7 @@
 
 ## 📊 性能对比
 
-| 指标 | v1.0.0 | v1.4.1 | 变化 |
+| 指标 | v1.0.0 | v1.4.2 | 变化 |
 |------|--------|--------|------|
 | 主模块代码量 | 387 行 | **~250 行** | 🔻 -35% |
 | 日常上下文占用 | ~9K tokens | **~5K tokens** | 🔻 -44% |
diff --git a/SKILL.md b/SKILL.md
@@ -1,7 +1,7 @@
 ---
 name: myknowledge
 description: 创建知识库、管理项目文档、记录需求、整理个人知识。Create knowledge bases, manage project docs, track requirements, and organize personal knowledge.
-version: "1.4.1"
+version: "1.4.2"
 author: CoderMoray
 tags: 
   - "knowledge-base"
diff --git a/_meta.json b/_meta.json
@@ -2,7 +2,7 @@
   "name": "myknowledge",
   "displayName": "MyKnowledge",
   "displayName_zh": "我的知识库",
-  "version": "1.4.1",
+  "version": "1.4.2",
   "description": "通用知识库管理 Skill，支持需求管理、项目文档、自动记录复杂任务",
   "description_zh": "通用知识库管理 Skill，支持需求管理、项目文档、自动记录复杂任务",
   "author": "CoderMoray",
diff --git a/core/main.md b/core/main.md
@@ -77,7 +77,10 @@
    - 发现旧条目 → 提示"检测到 {N} 个项目级知识库，v1.3.0 起默认使用全局知识库。是否迁移到 ~/.myknowledge/global/？"
    - 用户确认 → 搬移文件到 global/ + 更新 projects.yaml（type 改为 global）
    - 用户拒绝 → 保留不动
-   - 无旧条目或 projects.yaml 不存在 → 跳过
+   - 无旧条目或 projects.yaml 不存在 → 继续步骤 c
+   c. projects.yaml 不存在时，检查 ~/.myknowledge/global/ 下是否有子目录
+      - 有 → 说明已有知识库但未注册，提示"检测到未注册的知识库，是否重新索引？"
+      - 无 → 跳过（真正首次使用）
 
 5. 自检通过 → 静默继续，不向用户报告
    自检失败 → 礼貌提示，但不阻断正常使用（缺失文件可能懒加载修复）
diff --git a/hooks/claude/README.md b/hooks/claude/README.md
@@ -72,7 +72,7 @@ touch .claude/settings.json
 ```json
 {
   "name": "myknowledge",
-  "version": "1.4.1",
+  "version": "1.4.2",
   "events": ["message:received"],
   "enabled": false,
   "config": {
diff --git a/hooks/claude/hooks.json b/hooks/claude/hooks.json
@@ -1,6 +1,6 @@
 {
   "name": "myknowledge",
-  "version": "1.4.1",
+  "version": "1.4.2",
   "description": "MyKnowledge 自动检测 Hook。当用户发送消息时，自动分析任务复杂度，对复杂任务自动创建知识库和记录需求。",
   "events": ["message:received"],
   "enabled": false,
diff --git a/hooks/openclaw/HOOK.md b/hooks/openclaw/HOOK.md
@@ -1,6 +1,6 @@
 ---
 name: myknowledge
-version: "1.4.1"
+version: "1.4.2"
 events:
   - message:received
 description: |
diff --git a/hooks/openclaw/hook-guide.md b/hooks/openclaw/hook-guide.md
@@ -80,7 +80,7 @@ AI：✅ 已创建 Hook 文件
 ```yaml
 ---
 name: myknowledge
-version: "1.4.1"
+version: "1.4.2"
 events:
   - message:received
 description: |
diff --git a/manifest.json b/manifest.json
@@ -1,6 +1,6 @@
 {
   "name": "myknowledge",
-  "version": "1.4.1",
+  "version": "1.4.2",
   "description": "路径清单 - 单一真理来源。lint-paths.sh 据此检查文档和配置里引用的所有路径。",
   "_doc": "本文件由 scripts/lint-paths.sh 读取。修改时记得同步运行 lint 验证。",
 
diff --git a/modules/management/main.md b/modules/management/main.md
@@ -56,6 +56,7 @@ Created → Cancelled
 3. 更新"状态"字段
 4. 在"变更记录"表格追加新记录
 5. 更新 PROJECT-STATUS.md 中的需求列表
+6. 更新 requirements/README.md 需求索引（同步状态变更）
 ```
 
 ### 示例
@@ -100,7 +101,8 @@ AI：✅ 已更新 REQ-001 状态：Created → In Progress
 1. 确认需求 ID
 2. 将需求目录从 requirements/ 移动到 archive/
 3. 更新 PROJECT-STATUS.md（从活跃需求移到已完成）
-4. 在需求 README.md 追加归档记录
+4. 更新 requirements/README.md 需求索引（移除已归档项）
+5. 在需求 README.md 追加归档记录
 ```
 
 ### 批量归档
@@ -125,6 +127,7 @@ AI：✅ 已归档 3 个需求：
 2. 确认用户知道这是不可逆操作
 3. 删除需求目录
 4. 更新 PROJECT-STATUS.md
+5. 更新 requirements/README.md 需求索引（移除已删除项）
 ```
 
 ---
diff --git a/one-time/onboarding/main.md b/one-time/onboarding/main.md
@@ -81,7 +81,7 @@ platform: "{user_platform}"
 auto_record: true
 onboarding_completed: true
 first_use: "{date}"
-version: "1.4.1"
+version: "1.4.2"
 ```
 
 创建 `~/.myknowledge/config/install-source`：
diff --git a/scripts/check-file-size.sh b/scripts/check-file-size.sh
@@ -0,0 +1,90 @@
+#!/bin/bash
+# 检查 Skill 中 AI 会加载的文件的行数
+# 输出超过阈值的文件，帮助控制上下文占用
+
+THRESHOLD="${1:-200}"
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+ROOT="$(cd "$SCRIPT_DIR/.." && pwd)"
+
+echo "📏 MyKnowledge 文件行数检查（阈值: ${THRESHOLD}行）"
+echo ""
+
+# AI 每次加载的文件（SKILL.md → core/main.md）
+ALWAYS_LOADED=(
+  "SKILL.md"
+  "core/main.md"
+)
+
+# AI 按需加载的模块（懒加载）
+LAZY_LOADED=(
+  "modules/commands/main.md"
+  "modules/management/main.md"
+  "modules/error/main.md"
+  "modules/export/main.md"
+  "modules/silent/main.md"
+  "one-time/onboarding/main.md"
+  "one-time/setup/install-source.md"
+  "one-time/setup/platform-detector.md"
+  "one-time/setup/update-checker.md"
+)
+
+# 模板文件（创建时加载）
+TEMPLATES=(
+  "core/templates/project-status-template.md"
+  "core/templates/requirement-readme-template.md"
+  "core/templates/requirements-index-template.md"
+  "core/templates/kb-readme-template.md"
+  "core/templates/public-readme-template.md"
+  "core/templates/archive-readme-template.md"
+  "core/templates/design-doc-template.md"
+  "core/templates/projects-yaml-spec.md"
+)
+
+# 用户文档（AI 可能被引导读取）
+USER_DOCS=(
+  "FAQ.md"
+  "README.md"
+  "INSTALL.md"
+  "docs/PITFALLS.md"
+)
+
+# 开发者文档
+DEV_DOCS=(
+  "DEVELOPMENT.md"
+  "RELEASE-LOG.md"
+)
+
+total=0
+over=0
+
+check_files() {
+  local label="$1"
+  shift
+  echo "## $label"
+  for f in "$@"; do
+    if [ -f "$ROOT/$f" ]; then
+      lines=$(wc -l < "$ROOT/$f" | tr -d ' ')
+      total=$((total + lines))
+      if [ "$lines" -gt "$THRESHOLD" ]; then
+        over=$((over + 1))
+        printf "  ⚠️  %4d 行  %s\n" "$lines" "$f"
+      else
+        printf "  ✅  %4d 行  %s\n" "$lines" "$f"
+      fi
+    fi
+  done
+  echo ""
+}
+
+check_files "每次加载" "${ALWAYS_LOADED[@]}"
+check_files "懒加载模块" "${LAZY_LOADED[@]}"
+check_files "模板" "${TEMPLATES[@]}"
+check_files "用户文档（按需）" "${USER_DOCS[@]}"
+check_files "开发者文档" "${DEV_DOCS[@]}"
+
+echo "════════════════════════════════"
+echo "📊 总计: ${total} 行 | 超阈值: ${over} 个"
+echo "   AI 每次加载: ~$(wc -l < "$ROOT/SKILL.md" | tr -d ' ') + ~$(wc -l < "$ROOT/core/main.md" | tr -d ' ') 行"
+echo "   规则文件:     ~$(wc -l < "$ROOT/../.codebuddy/rules/MyKnowledge_开发规则.mdc" 2>/dev/null | tr -d ' ') 行"
+echo ""
diff --git a/settings.yaml b/settings.yaml
@@ -2,7 +2,7 @@
 
 skill:
   name: myknowledge
-  version: "1.4.1"
+  version: "1.4.2"
   description: "通用知识库管理 Skill"
 
 # 安装源配置（首次运行时自动检测，写入 ~/.myknowledge/config/install-source）
@@ -26,7 +26,7 @@ user_data:
 # 版本兼容性
 version_compatibility:
   # 当前 Skill 版本（与 skill.version 保持一致）
-  current: "1.4.1"
+  current: "1.4.2"
 
   # 配置格式版本
   config_format: "1.0"

Original file line number	Diff line number	Diff line change
`@@ -72,7 +72,7 @@ touch .claude/settings.json`
`72`	`72`	```json
`73`	`73`	`{`
`74`	`74`	`"name": "myknowledge",`
`75`		`- "version": "1.4.1",`
	`75`	`+ "version": "1.4.2",`
`76`	`76`	`"events": ["message:received"],`
`77`	`77`	`"enabled": false,`
`78`	`78`	`"config": {`
Original file line number	Diff line number	Diff line change
`@@ -1,6 +1,6 @@`
`1`	`1`	`{`
`2`	`2`	`"name": "myknowledge",`
`3`		`- "version": "1.4.1",`
	`3`	`+ "version": "1.4.2",`
`4`	`4`	`"description": "MyKnowledge 自动检测 Hook。当用户发送消息时，自动分析任务复杂度，对复杂任务自动创建知识库和记录需求。",`
`5`	`5`	`"events": ["message:received"],`
`6`	`6`	`"enabled": false,`