dsh-local-kb 0.6.3 → 0.6.4

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 CHANGED
@@ -529,10 +529,11 @@ node install-skill.js --uninstall
529
529
 
530
530
  ## 版本与兼容
531
531
 
532
- 当前版本 `0.6.3`。完整变更见 [CHANGELOG.md](CHANGELOG.md)。
532
+ 当前版本 `0.6.4`。完整变更见 [CHANGELOG.md](CHANGELOG.md)。
533
533
 
534
534
  | 版本 | 主题 |
535
535
  |---|---|
536
+ | 0.6.4 | 写入前置收成一句「未入库先入库」,堵住全局 docs 旁路 |
536
537
  | 0.6.3 | 脚本默认根读 KB_ROOT、Windows 路径兼容、位置与命名文档、平台支持矩阵 |
537
538
  | 0.6.2 | 归档与建档工具、注入钩子 ≤24 字(上限 120 行/12KB)、问句骨架剥离与置信封顶 |
538
539
  | 0.6.1 | 写入回报协议、run_code 直写识别(体检与同步不再漏) |
package/inject.js CHANGED
@@ -593,7 +593,9 @@ export function knowledgeMapText({ kbRoot, cwd, cache = new Map() }) {
593
593
  if (stale.length > 0) {
594
594
  lines.push('路径失效(登记的是原设备路径,用 git_remote 重新登记):' + stale.join('、'))
595
595
  }
596
- if (missing.length > 0) lines.push('未登记(paths.yaml 没有条目):' + missing.join('、'))
596
+ if (missing.length > 0) {
597
+ lines.push('未登记(paths.yaml 没有条目):' + missing.join('、') + ' —— 写记忆前先跑 kb-add-project.py')
598
+ }
597
599
 
598
600
  const project = projectForPath(cwd, entries)
599
601
  if (project !== undefined) {
@@ -620,7 +622,7 @@ export function knowledgeMapText({ kbRoot, cwd, cache = new Map() }) {
620
622
  lines.push(' 概念表未填:项目页「中文概念 → 位置」为空,定位请现读源码')
621
623
  }
622
624
  } else if (cwd !== undefined) {
623
- lines.push('当前目录未入库(不在 paths.yaml)。若是要长期工作的项目,说一句「把这个项目加进知识库」即可建档;否则按关键词检索,别猜项目。')
625
+ lines.push('当前目录未入库(不在 paths.yaml)。写任何项目知识前先跑 kb-add-project.py 建档;只检索则按关键词,别猜项目。')
624
626
  }
625
627
 
626
628
  const docs = globalDocs(kbRoot)
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "dsh-local-kb",
3
- "version": "0.6.3",
3
+ "version": "0.6.4",
4
4
  "description": "知识库 + 长期记忆插件:每轮注入记忆索引与知识地图、索引硬上限、禁止 AI 删除、镜像同步到 WebDAV",
5
5
  "keywords": [
6
6
  "dsh-plugin",
@@ -34,6 +34,9 @@
34
34
  ### 写入
35
35
 
36
36
  - 学到即写(决策/纠正/约束/可复用的坑);**收尾过一遍**:晋升结论、退休临时状态,没值得留的就说明,别硬写。
37
+ - **未入库先入库**:给项目写知识(项目页、docs/、memory/)前,看注入地图的「当前项目」——
38
+ 未标注或标「未入库」→ 直接跑 `kb-add-project.py`(空文件夹也建);项目相关文档不进全局 `docs/`。
39
+ **禁止只回复「已记住」而不落盘**;写完回报「已写入知识库:<相对路径>」。
37
40
  - 一事实一文件,frontmatter `name/description/type/created/updated`,type ∈
38
41
  `user|feedback|project|reference`;指针只进同目录 `MEMORY.md`;改事实更新旧笔记,推翻标
39
42
  `> Superseded <日期>`,不删。
@@ -25,14 +25,18 @@
25
25
  > 装了 dsh 插件时,全局与当前项目的 `MEMORY.md` 会**每轮注入上下文**(标题 `## 记忆索引`)。
26
26
  > 已经看到注入内容就别再 read 索引文件;只有没看到时才读。
27
27
 
28
- ## 写入前置:项目记忆必须先入库
28
+ ## 写入前置:项目知识必须先入库
29
29
 
30
30
  - 写某项目的记忆(`project` / 本项目 `reference`)前:检查项目页 `<KB_ROOT>/projects/<id>/<id>.md` **存在**。
31
31
  只有 `memory/` 没有项目页 = 半建档,记忆会写进一个 AI 通过项目页永远找不到的项目。
32
32
  项目页缺失 → 先按 `code-project.md` 建档,再写记忆。
33
33
  **记忆永远写入知识库目录(带 `<KB_ROOT>/` 前缀),绝不写进源项目里的 `memory/` 目录**。
34
- - **未入库 → 先按 `code-project.md` 流程 add 该项目**(建档),再写项目级记忆。
35
- - 不写全局暂存。全局记忆只装与具体项目无关的内容(`user` / 跨项目 `feedback` / 全局 `reference`)。
34
+ - **未入库先入库**:给项目写知识(项目页、`docs/`、`memory/`)前,确认项目页存在且 `paths.yaml` 已登记;
35
+ 未登记 → 直接按 `code-project.md` 流程 add(空文件夹也建),再写;远程/无本地代码项目按 ops-project 手工登记。
36
+ - **半建档**:有 `memory/` 但缺项目页 → 先补项目页,再写。
37
+ - **建档失败**:`kb-add-project.py` exit 1 → 先修错误,别继续写。
38
+ - **不写全局暂存**:全局只装与具体项目无关的跨项目事实(`user` / 跨项目 `feedback` / 全局 `reference`)。
39
+ 项目相关文档不得放进全局 `docs/` 绕过建档。
36
40
  - **项目级记忆的指针只进项目级 `MEMORY.md`,绝不放进全局索引**。全局索引里的 `../` 指针 = 断裂指针,AI 按协议不会打开,记忆等于隐形。
37
41
 
38
42
  ## 记忆文件格式