Skip to content

Commit 04cd661

Browse files
committed
refactor: 重命名"静默模式"为"智能任务追踪"
- modules/silent/ → modules/auto-track/ - 全文"静默模式"→"智能任务追踪" - settings.yaml: silent_mode → smart_tracking - lint-paths.sh: 更新路径检查 - 消除所有"无感知/真静默"危险表述
1 parent a02e712 commit 04cd661

25 files changed

Lines changed: 83 additions & 81 deletions

DEVELOPMENT.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -34,7 +34,7 @@ MyKnowledge/
3434
│ ├── main.md
3535
│ └── templates/
3636
├── modules/ # 可选模块(懒加载)
37-
│ ├── commands/ management/ error/ export/ silent/
37+
│ ├── commands/ management/ error/ export/ auto-track/
3838
├── one-time/ # 一次性配置(首次/特定场景)
3939
│ ├── onboarding/ setup/
4040
├── hooks/ # 平台集成

FAQ.md

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -2,15 +2,15 @@
22

33
## 快速导航
44

5-
- [静默模式问题](#静默模式问题)
5+
- [智能任务追踪问题](#智能任务追踪问题)
66
- [平台相关问题](#平台相关问题)
77
- [知识库管理问题](#知识库管理问题)
88
- [需求管理问题](#需求管理问题)
99
- [安装与更新问题](#安装与更新问题)
1010

1111
---
1212

13-
## 静默模式问题
13+
## 智能任务追踪问题
1414

1515
### Q1: 为什么简单对话也会创建知识库?
1616

@@ -41,13 +41,13 @@
4141

4242
**注意**:MyKnowledge 不会在用户无感知的情况下创建文件。首次检测到大任务时会询问用户是否开启自动记录。
4343

44-
### Q3: 如何完全关闭静默模式
44+
### Q3: 如何完全关闭智能任务追踪
4545

4646
**A**: 修改 `settings.yaml`
4747

4848
```yaml
4949
features:
50-
silent_mode:
50+
smart_tracking:
5151
enabled: false # 改为 false
5252
```
5353
@@ -65,7 +65,7 @@ features:
6565
6666
### Q5: 不同平台的功能有差异吗?
6767
68-
**A**: 核心功能一致,但静默模式实现不同
68+
**A**: 核心功能一致,但智能任务追踪实现不同
6969
7070
- **OpenClaw** 支持 Hook 事件驱动(操作后告知用户)
7171
- **CodeBuddy/WorkBuddy** 依赖 AI 意图识别,操作前会提示
@@ -231,7 +231,7 @@ source: "github_clone" # 或 skillhub_web / clawhub 等
231231

232232
**错误想法**:"我把所有对话都自动记录了,以后可以回看"
233233

234-
**为什么不支持**静默模式的设计目的是"复杂任务的上下文追踪",不是"完整聊天日志"。所有对话都记录会导致信息淹没。
234+
**为什么不支持**智能任务追踪的设计目的是"复杂任务的上下文追踪",不是"完整聊天日志"。所有对话都记录会导致信息淹没。
235235

236236
**正确做法**:定期让 AI 总结关键要点,删除碎片对话。参考 [PITFALLS 坑 7](docs/PITFALLS.md#坑-7会话记录太多淹没了需求文档)
237237

@@ -320,7 +320,7 @@ MyKnowledge 可以作为基础 Skill,被其他 Skill 调用:
320320
把过去一周 PROJECT-STATUS.md 的变更记录汇总成一句话进展
321321
```
322322

323-
### 静默模式偏好调优
323+
### 智能任务追踪偏好调优
324324

325325
`settings.yaml` 中调整检测灵敏度以匹配你的工作风格:
326326

INSTALL.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -63,7 +63,7 @@ AI 会自动检测到首次使用,执行约 1 分钟的引导设置(选择
6363

6464
### OpenClaw 启用 Hook(推荐)
6565

66-
OpenClaw 用户可启用 Hook 实现真正的静默模式
66+
OpenClaw 用户可启用 Hook 实现真正的智能任务追踪
6767

6868
```bash
6969
# 启用 Hook

QUICKSTART.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -30,7 +30,7 @@
3030
| "项目进展如何" | 汇总 PROJECT-STATUS |
3131
| "继续 xxx" | 恢复项目上下文 |
3232
| "搜索 xxx" | 跨需求关键词搜索 🚧 计划中(v1.2+) |
33-
| "开启/关闭自动记录" | 切换静默模式 |
33+
| "开启/关闭自动记录" | 切换智能任务追踪 |
3434
| "重新初始化" | 重置配置走首次引导 |
3535

3636
**模糊时**直接说你的意图,AI 会按 `modules/commands/main.md` 里的映射自动判断。拿不准时 AI 会主动问你,不会瞎猜。

README.md

Lines changed: 8 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
<p align="center">
2-
<img src="https://img.shields.io/badge/version-1.4.80-blue" alt="Version" />
2+
<img src="https://img.shields.io/badge/version-1.4.81-blue" alt="Version" />
33
<img src="https://img.shields.io/badge/license-Apache%202.0-green" alt="License" />
44
<a href="https://github.com/CoderMoray/MyKnowledge"><img src="https://img.shields.io/badge/GitHub-CoderMoray-black?logo=github" alt="GitHub" /></a>
55
</p>
@@ -28,7 +28,7 @@
2828
|------|------|
2929
| 📁 **标准化知识库** | 一键创建目录结构(全局 / 项目级别) |
3030
| 📋 **需求生命周期** | 创建 → 进行中 → 审核 → 完成 → 归档 |
31-
| 🤖 **智能静默模式** | 检测复杂任务,自动创建记录(可选) |
31+
| 🤖 **智能智能任务追踪** | 检测复杂任务,自动创建记录(可选) |
3232
| 💬 **会话自动记录** | 对话内容自动追加到对应需求文档 |
3333
| 🔀 **多平台支持** | CodeBuddy / WorkBuddy / OpenClaw / Claude |
3434

@@ -54,7 +54,7 @@
5454

5555
## 📊 性能对比
5656

57-
| 指标 | v1.0.0 | v1.4.80 | 变化 |
57+
| 指标 | v1.0.0 | v1.4.81 | 变化 |
5858
|------|--------|--------|------|
5959
| 主模块代码量 | 387 行 | **~250 行** | 🔻 -35% |
6060
| 日常上下文占用 | ~9K tokens | **~5K tokens** | 🔻 -44% |
@@ -107,7 +107,7 @@ git clone https://github.com/CoderMoray/MyKnowledge.git ~/.codebuddy/skills/mykn
107107
AI:我将为您创建知识库...(询问类型 → 生成结构)
108108
```
109109

110-
### 场景 2:静默模式(推荐)
110+
### 场景 2:智能任务追踪(推荐)
111111

112112
```
113113
你:帮我分析这个销售数据
@@ -155,8 +155,8 @@ AI:解压到全局知识库 → 同名项目提供覆盖/重命名/对比选
155155
### [v1.1.17] - 2026-06-11 — 规则统一 + 误解消除
156156

157157
- 🗣️ **"没有自动修复" → 恢复极简单**:一句话恢复,不丢数据
158-
- 📋 **静默触发规则统一**:4 个文件关键词列表对齐,不再不一致
159-
- 📖 **FAQ 增加具体示例**静默触发对比表 + 反模式效果对比表
158+
- 📋 **智能任务追踪触发规则统一**:4 个文件关键词列表对齐,不再不一致
159+
- 📖 **FAQ 增加具体示例**触发对比表 + 反模式效果对比表
160160

161161
### [v1.1.15] - 2026-06-11 — skillhub 命令修正
162162

@@ -260,7 +260,7 @@ MyKnowledge/
260260
│ ├── commands/ # 命令速查(v1.1.1+)
261261
│ ├── management/ # 需求管理
262262
│ ├── error/ # 错误处理
263-
│ └── silent/ # 静默模式
263+
│ └── auto-track/ # 智能任务追踪
264264
├── one-time/ # 一次性配置
265265
│ ├── onboarding/ # 首次引导
266266
│ └── setup/ # 安装源/平台/更新检测
@@ -298,7 +298,7 @@ git init && git add . && git commit -m "初始化知识库"
298298
# 记得 .gitignore 排除 config/ 目录(含平台特定配置)
299299
```
300300

301-
### 自定义静默检测
301+
### 自定义智能任务追踪
302302
编辑 `settings.yaml`,调整检测灵敏度以匹配你的工作风格,添加常用任务关键词。
303303

304304
### 更多技巧

SKILL.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ name: myknowledge
33
slug: my-knowledge
44
displayName: MyKnowledge
55
description: 创建知识库、管理项目文档、记录需求、整理个人知识。Create knowledge bases, manage project docs, track requirements, and organize personal knowledge.
6-
version: "1.4.80"
6+
version: "1.4.81"
77
author: CoderMoray
88
tags:
99
- "knowledge-base"
@@ -231,7 +231,7 @@ AI:读取 PROJECT-STATUS.md...
231231
| `SKILL.md` | 本文件,Skill 主入口 |
232232
| `settings.yaml` | Skill 配置 |
233233
| `core/` | 核心功能(主逻辑、模板) |
234-
| `modules/` | 可选模块(懒加载:管理、更新、错误处理、静默模式|
234+
| `modules/` | 可选模块(懒加载:管理、更新、错误处理、智能任务追踪|
235235
| `one-time/` | 一次性配置(首次引导、安装源检测) |
236236
| `hooks/` | 平台 Hook(OpenClaw、Claude) |
237237
| `test/` | 测试套件(开发用,AI 忽略) |
@@ -244,7 +244,7 @@ AI:读取 PROJECT-STATUS.md...
244244
245245
| 用户遇到... | 引导查看 |
246246
|------------|---------|
247-
| 常见使用问题 | `FAQ.md` — 按主题分类的问答(静默模式、平台差异、备份等) |
247+
| 常见使用问题 | `FAQ.md` — 按主题分类的问答(智能任务追踪、平台差异、备份等) |
248248
| 踩坑了 | `docs/PITFALLS.md` — 19 个真实使用坑及正确做法 |
249249
| 不知道怎么用 | `README.md` — 快速开始 + 使用场景 + 高手技巧 |
250250
| 需要重新初始化 | 说"重新初始化 MyKnowledge"即可重置 |

TEST-PLAN.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -124,7 +124,7 @@
124124

125125
---
126126

127-
### 测试组 4: 静默模式(自动检测)
127+
### 测试组 4: 智能任务追踪(自动检测)
128128

129129
#### TC-007: 复杂任务检测
130130
**目的**: 验证 AI 自动检测复杂任务
@@ -143,7 +143,7 @@
143143
---
144144

145145
#### TC-008: 非复杂任务不触发
146-
**目的**: 验证简单任务不触发静默模式
146+
**目的**: 验证简单任务不触发智能任务追踪
147147

148148
**步骤**:
149149
1. 用户输入: "你好"
@@ -227,7 +227,7 @@
227227

228228
## 已知限制
229229

230-
1. **CodeBuddy/WorkBuddy**: 无法实现真正的静默模式,依赖 AI 意图识别
230+
1. **CodeBuddy/WorkBuddy**: 无法实现真正的智能任务追踪,依赖 AI 意图识别
231231
2. **OpenClaw Hook**: 需要用户手动启用
232232
3. **平台检测**: 基于目录存在性,可能存在误判
233233

USAGE.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,7 @@ MyKnowledge 支持三种使用模式:
88
|------|----------|----------|
99
| 主动模式 | 用户明确指令 | 需要精确控制时 |
1010
| 辅助模式 | 其他 Skill 调用 | 作为 Agent Team 的辅助 |
11-
| 静默模式 | AI 自动检测 | 日常对话中自动管理 |
11+
| 智能任务追踪 | AI 自动检测 | 日常对话中自动管理 |
1212

1313
---
1414

@@ -97,7 +97,7 @@ AI:📋 恢复项目状态
9797

9898
---
9999

100-
## 静默模式
100+
## 智能任务追踪
101101

102102
### 自动检测示例
103103

@@ -127,7 +127,7 @@ AI 会自动检测以下特征:
127127
- **多步骤**: 包含多个子任务
128128
- **长期性**: 需要跟踪和记录
129129

130-
### 静默模式配置
130+
### 智能任务追踪配置
131131

132132
`settings.yaml` 中调整检测敏感度:
133133

@@ -216,7 +216,7 @@ AI:已归档 3 个已完成需求到 archive/
216216
| 功能 | CodeBuddy | WorkBuddy | OpenClaw | Claude |
217217
|------|-----------|-----------|----------|--------|
218218
| 主动模式 |||||
219-
| 静默模式 | ✅(意图识别) | ✅(意图识别) | ✅(Hook + 意图识别) | ✅(意图识别) |
219+
| 智能任务追踪 | ✅(意图识别) | ✅(意图识别) | ✅(Hook + 意图识别) | ✅(意图识别) |
220220
| 后台运行(操作后告知) |||||
221221

222222
**说明**

_meta.json

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
"name": "myknowledge",
33
"displayName": "MyKnowledge",
44
"displayName_zh": "我的知识库",
5-
"version": "1.4.80",
5+
"version": "1.4.81",
66
"description": "通用知识库管理 Skill,支持需求管理、项目文档、自动记录复杂任务",
77
"description_zh": "通用知识库管理 Skill,支持需求管理、项目文档、自动记录复杂任务",
88
"author": "CoderMoray",

core/main.md

Lines changed: 13 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -47,7 +47,7 @@
4747
- 加载 one-time/setup/update-checker.md 获取检查指令
4848
- 根据安装源执行对应的检查策略
4949
- 如果发现新版本 → 礼貌提示用户更新
50-
- 如果检查失败 → 静默忽略,不影响正常使用
50+
- 如果检查失败 → 自动忽略,不影响正常使用
5151
e. 检查完成后(无论成功失败),更新 last_check 为今天日期
5252
```
5353

@@ -56,7 +56,7 @@
5656
→ 有:跳过 projects.yaml,直接读 PROJECT-STATUS.md 恢复上下文
5757
→ 无:继续步骤 b
5858
b. 检查 ~/.myknowledge/config/projects.yaml 是否存在
59-
→ 不存在:首次使用,不提示(等用户说"创建知识库"或静默触发
59+
→ 不存在:首次使用,不提示(等用户说"创建知识库"或自动触发
6060
→ 存在且非空:读取项目列表,礼貌询问"要恢复哪个项目?"
6161
列出格式:项目名(路径),用户选择后读对应 PROJECT-STATUS.md
6262
c. 用户选择了项目 → 更新 projects.yaml 中该项目的 last_access
@@ -65,7 +65,7 @@
6565

6666
## 加载时自检(AI 透明验证)
6767

68-
> 每次加载本 Skill 时,**静默执行**以下检查。如有异常,按指示处理。
68+
> 每次加载本 Skill 时,**后台执行**以下检查。如有异常,按指示处理。
6969
> 目的:让用户无需手动操作即可获得"Skill 完整性"保障。
7070
7171
**重要设计原则**(v1.1.4+):
@@ -81,7 +81,7 @@
8181
- modules/commands/main.md ✓
8282
- modules/management/main.md ✓
8383
- modules/error/main.md ✓
84-
- modules/silent/main.md ✓
84+
- modules/auto-track/main.md ✓
8585
- one-time/onboarding/main.md ✓
8686
- hooks/ 目录至少有一个子目录 ✓
8787
缺失任何一个 → 提示用户:"Skill 文件不完整,建议重新安装"
@@ -91,13 +91,13 @@
9191
- settings.yaml 可被解析
9292
缺失或损坏 → 提示用户:"Skill 配置文件可能损坏,建议重新安装"
9393
94-
3. 检查 install-source 格式(静默):
94+
3. 检查 install-source 格式(后台):
9595
- 读 ~/.myknowledge/config/install-source
9696
- 如果是纯文本(非 YAML,不以 "source:" 开头)→ 加载 one-time/setup/install-source.md 触发重新检测
9797
- 检测完成后写入新 YAML 格式
9898
- 已经是 YAML 格式 → 跳过
9999
100-
4. 检查项目迁移需求(静默,skill-state.yaml 存在时执行):
100+
4. 检查项目迁移需求(后台,skill-state.yaml 存在时执行):
101101
- 读 projects.yaml,筛选 type: "project" 的旧条目
102102
- 发现旧条目 → 提示"检测到 {N} 个项目级知识库,v1.3.0 起默认使用全局知识库。是否迁移到 ~/.myknowledge/global/?"
103103
- 用户确认 → 搬移文件到 global/ + 更新 projects.yaml(type 改为 global)
@@ -107,13 +107,13 @@
107107
- 有 → 说明已有知识库但未注册,提示"检测到未注册的知识库,是否重新索引?"
108108
- 无 → 跳过(真正首次使用)
109109
110-
5. 自检通过 → 静默继续,不向用户报告
110+
5. 自检通过 → 后台继续,不向用户报告
111111
自检失败 → 礼貌提示,但不阻断正常使用(缺失文件可能懒加载修复)
112112
```
113113

114114
**原则**
115115
- ✅ 自检是**用户友好的**——失败时清晰提示
116-
- ✅ 自检是**静默的**——通过时不打扰
116+
- ✅ 自检是**后台的**——通过时不打扰
117117
- ✅ 自检是**独立**的——不依赖 manifest 等"声明性"文件
118118
- ❌ 自检**不替代**完整 lint(lint 是开发者/平台侧)
119119

@@ -148,7 +148,7 @@ IF 用户问更新:
148148
- ✅ 在 `~/.myknowledge/` 范围内创建/读取/修改文件
149149
- ✅ 按 `modules/commands/main.md` 的命令表响应用户请求
150150
- ✅ 跟踪 `REQ-YYYYMMDD-XXX` 格式的需求
151-
- ✅ 按 `settings.yaml``complex_task_detection` 规则静默记录
151+
- ✅ 按 `settings.yaml``complex_task_detection` 规则自动记录
152152

153153
**不做**(遇到此类请求要礼貌拒绝并说明):
154154
- ❌ 联网、调用外部 API、上传数据
@@ -245,7 +245,7 @@ IF 用户请求导出/导入/分享/备份知识库:
245245

246246
### 5. 自动检测模式
247247

248-
> **详细说明**`modules/silent/main.md`
248+
> **详细说明**`modules/auto-track/main.md`
249249
250250
当检测到复杂任务时,自动创建知识库并告知用户。
251251

@@ -373,12 +373,12 @@ IF 用户提到需求 ID (REQ-XXX):
373373
| 归档需求 | `📦 已归档 {id}:{title}` | 批量归档时列出所有 ID |
374374
| 删除需求 | `🗑️ 已删除 {id}:{title}` | 删除前已确认,此反馈仅告知完成 |
375375
| 自动会话记录 | `📋 已记录本次会话到 {id}` | 追加到需求文件后告知,不中断对话 |
376-
| 静默创建 | `🔇 检测到复杂任务,已自动创建知识库「{name}」和需求 {id}` | 静默触发后的统一告知 |
376+
| 自动创建 | `🔇 检测到复杂任务,已自动创建知识库「{name}」和需求 {id}` | 自动触发后的统一告知 |
377377

378378
**不需要单独反馈的操作(伴随上述操作自动完成):**
379379
- PROJECT-STATUS.md 的例行更新(已在上述反馈中覆盖)
380380
- projects.yaml 的 last_access 更新(纯技术维护)
381-
- 自检通过(静默
381+
- 自检通过(后台
382382

383383
---
384384

@@ -406,7 +406,7 @@ IF 遇到错误:
406406
| 需求管理 | `modules/management/main.md` |
407407
| 错误处理 | `modules/error/main.md` |
408408
| 导出/导入 | `modules/export/main.md` |
409-
| 静默模式 | `modules/silent/main.md` |
409+
| 智能任务追踪 | `modules/auto-track/main.md` |
410410
| 命令速查 | `modules/commands/main.md` |
411411
| 模板 | `core/templates/`(共6个) |
412412
|  ├ 项目状态 | `core/templates/project-status-template.md` |

0 commit comments

Comments
 (0)