Skip to content

Commit c063239

Browse files
authored
Merge pull request #575 from slow-stack/chore/wiki-exclude-dot-dirs
chorography 收口:生成物走 .gitignore,扫描默认排除改为点开头目录整类
2 parents e5b10ee + 46082dc commit c063239

8 files changed

Lines changed: 85 additions & 13 deletions

File tree

‎docs/plans/2026-11-04-chorography-m0.md‎

Lines changed: 10 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -53,8 +53,16 @@ dsh-baleen / dsh-study-desk / 本仓各跑一次 `--apply`,人判划分;结
5353
正控演示成立(D7 的存在理由被证实:目录初稿没有能力分辨「代码」与「躺在
5454
仓库里的会话产物」)。
5555
- **dsh-study-desk**(58 文件):5 模块里 3 个是 .shots / .v2c / .qoder-credits
56-
——同理收口。点开头目录默认不排除(.shots 可能是截图资产,属用户资产不是
57-
垃圾),是否把「明显会话产物的 dot 目录」进默认排除表**留给维护者拍**。
56+
——同理收口。
57+
58+
**已定(2026-11-05,维护者拍):点开头目录整类进默认排除表**。本轮实测的六个
59+
目录(.qoder-credits / .superpowers / .shots / .zcode / .dsh-ops / .v2c)全是
60+
会话产物——提问原文、调试快照、第三方工具缓存,没有一个该当模块。逐个点名等于
61+
把一台机器的工具链钉进发布包,换个工具又漏;改成「点开头目录整类排除」
62+
(`src/wiki/scan.js` 的 `isDefaultExcludedDir`),三仓的垃圾模块一次清零。
63+
代价:.vitepress/theme、.docusaurus 这类把真源码放在点目录里的仓库会漏,且扫描
64+
阶段的排除先于 `plan.include` 白名单生效、拉不回来——这条写进代码注释里。
65+
点开头的**文件**(.eslintrc.json 等仓库配置)不受影响,照旧扫描。
5866
- **mneme 本仓**(460 文件 → 38 模块):lib/ 与 src/ 互为 sync 副本,默认扫描
5967
全部翻倍(lib 40+29 续、src 40+28 续)——本仓用 plan.yaml 必须排除 lib/
6068
(或 src/);超限切块(-2 续)是字典序不是语义,靠 include 收窄或调

‎docs/specs/2026-11-04-chorography-design.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -145,7 +145,7 @@ T1 语义,逐模块花钱,可跳过:
145145
- V2 import 图在三个真实仓库上划出的模块对不对——这是产品成败的判据,只能人工判。
146146
- V3 与宿主现有 `systemPrompt` 注入的先后顺序与体积上限。
147147
- V4 复用记忆的 embedder 时,模型版本是否被记忆侧锁死,换模型会不会让 `choro_vectors` 整体失效。
148-
- V5 `.chorography/` 默认提交进仓库还是加进 `.gitignore`(本设计倾向提交,因为 Markdown 就是真源;但提交意味着别人 clone 会看到几十个生成页,这条要本人拍)。
148+
- V5 `.chorography/` 默认提交进仓库还是加进 `.gitignore` —— **已定(2026-11-05,维护者拍):走 `.gitignore`**。只忽略目录内容、用 `!.chorography/plan.yaml` 把人工控制表反选回来(忽略整个目录会让白名单失效);代价如实记:页内 `CHORO:HUMAN` 保留区只在本机存活,`git clean -fdX` 会连它一起删。规则先落在本仓(#572),两个邻仓 baleen / study-desk 同步补上。
149149

150150
## 12. 明确不做
151151

‎dsh-mneme/CHANGELOG.md‎

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

33
## [Unreleased]
44

5+
- **chorography 收口:`.chorography/` 走 `.gitignore`,扫默认排除改为点开头目录整类**:spec §11 的最后两条待实测落地。
6+
7+
- **V5 已定(维护者拍):生成物不入库**。`docs/specs/2026-11-04-chorography-design.md` §11 原本倾向「提交,因为 Markdown 就是真源」,实际取舍反过来:别人 clone 不该看到几十个生成页。规则先落在本仓(#572)——**忽略目录内容而不是整个目录**(`.chorography/*` + `!.chorography/plan.yaml`),因为忽略整个目录会让白名单失效、`plan.yaml` 这张人工正面控制表一起进不去。代价如实写进注释:页内 `CHORO:HUMAN` 保留区只在本机存活,`git clean -fdX` 会连它一起删。baleen / study-desk 两个邻仓同步补同一段。
8+
- **点开头目录整类排除**(`src/wiki/scan.js` 的 `isDefaultExcludedDir`):V2 在三仓实测到的会话产物目录是 `.qoder-credits` / `.superpowers` / `.shots` / `.zcode` / `.dsh-ops` / `.v2c`,全是提问原文、调试快照与第三方工具缓存——baleen 上它们占 15 个模块里的 6 个,study-desk 上占 5 个里的 3 个。逐条点名等于把一台机器的工具链钉进发布包,换个工具又漏一批;「点开头即非仓库内容」更短、与实测分布一致、不随工具换代失效。`DEFAULT_EXCLUDE_DIRS` 里 8 个点前缀条目随之删掉,只剩 `node_modules` / `dist` / `build` / `out` / `coverage`。
9+
- **代价与边界写进注释**:`.vitepress/theme`、`.docusaurus` 这类确实把真源码放在点目录里的仓库会漏掉那部分,且**拉不回来**——扫描阶段的排除先于 `plan.include` 白名单生效(plan 的 `include` 只能收窄,不能把被默认表排除的路径捞回来)。只按目录名判,点开头的**文件**(`.eslintrc.json` 之类)是仓库配置不是产物,照旧扫描。
10+
- **验证**:`test/wiki-scan.test.js` 新增一例锁这两面——用一份从未进过任何名单的 `.whatever` 证明规则不是点名法,同时在 `nested/` 与 `src/` 两级各放一个点目录证明任意深度生效,再用 `.eslintrc.json` / `src/.prettierrc.json` 反向锁「点开头文件照旧进清单」。全量 `npm test` 2807 tests / 2806 pass / 0 fail / 1 skipped;check-sync 94 一致。
11+
512
- **chorography M3:开局注入 + 过期提示 + `/choro` 命令**:spec §10 的消费面收尾。会话工作目录命中已登记仓库时,每轮往 systemPrompt 里塞一小块**标题级**提纲(模块名 / 文件数 / 页状态 / 页相对路径,约 8 行),档位 `chorographyInject` = `light`(默认,前 6 个模块)/ `full`(全部)/ `off`;`/choro` 给主动查看,且**只提示过期、绝不自动重跑**(spec §2 D6)。
613

714
- **折进既有 memory context,不新开第三个 context**(P24):宿主 `@deepseek-ai/dsh-system-prompt` 的 context 只按 `order` 排序、**同 order 没有 name 兜底**(V3 实读源码确认),多开一块就多一份拼装抖动;spec §7 也明写「与 mneme 现有 systemPrompt 注入合并成一次拼装」。拼接次序 `时间 → 地志 → 热上下文 → 长期记忆`——地志是稳定背景,热上下文每轮都变,稳定在前。

‎dsh-mneme/lib/wiki/plan.js‎

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -24,7 +24,9 @@ export const PLAN_PAGE_ALLOWED_KEYS = Object.freeze(["path", "title", "template"
2424
export const DEFAULT_MAX_FILES_PER_PAGE = 40;
2525

2626
// plan.yaml 不存在时的启发式默认(spec §6 步 1):全量 include、零 exclude 追加
27-
// (目录级排除由 scan.js 的默认排除表承担)、无页面白名单(划分结果全建页)。
27+
// (目录级排除由 scan.js 的默认排除表承担:node_modules/构建产物 + 一切点开头目录,
28+
// 见 DEFAULT_EXCLUDE_DIRS 上方注释——所以空 plan 也不是「什么都读」)、
29+
// 无页面白名单(划分结果全建页)。
2830
export function defaultPlan() {
2931
return {
3032
include: null,

‎dsh-mneme/lib/wiki/scan.js‎

Lines changed: 16 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -24,11 +24,24 @@ const CODE_EXTENSIONS = new Set([".js", ".mjs", ".cjs", ".jsx", ".ts", ".tsx", "
2424

2525
// 默认排除(spec 步 2「跳过 node_modules、构建产物、二进制」):plan.yaml 的
2626
// exclude 是追加而不是替代——用户排除是表达意图,这份是卫生底线。
27+
//
28+
// 点开头目录整类排除(V2 实测回填,见 docs/plans/2026-11-04-chorography-m0.md):
29+
// 会话产物的落盘习惯就是把东西塞进 .qoder-credits / .superpowers / .shots / .zcode /
30+
// .dsh-ops / .v2c 这类点目录,而里面常常是提问原文、调试快照与第三方工具缓存——
31+
// baleen 上它们占 15 个模块里的 6 个,study-desk 上占 5 个里的 3 个。逐个点名厂商等于
32+
// 把一台机器的工具链钉进发布包,换个工具又漏;「点开头即非仓库内容」这条更短的规则
33+
// 与三处实测的分布一致,也不随工具换代失效。
34+
// 代价如实写在这里:.vitepress/theme、.docusaurus 这类确实把真源码放在点目录里的仓库
35+
// 会漏掉那部分,且**拉不回来**——扫描阶段的排除先于 plan.include 白名单生效。
36+
// 只按目录名判,点开头的**文件**(.eslintrc.json 之类)照旧扫:那是仓库配置,不是产物。
2737
export const DEFAULT_EXCLUDE_DIRS = Object.freeze([
28-
"node_modules", ".git", ".hg", ".svn", "dist", "build", "out", "coverage",
29-
".next", ".nuxt", ".output", ".cache", ".chorography", ".worktrees",
38+
"node_modules", "dist", "build", "out", "coverage",
3039
]);
3140

41+
function isDefaultExcludedDir(name) {
42+
return name.startsWith(".") || DEFAULT_EXCLUDE_DIRS.includes(name);
43+
}
44+
3245
const BINARY_EXTENSIONS = new Set([
3346
".png", ".jpg", ".jpeg", ".gif", ".ico", ".webp", ".avif", ".bmp", ".pdf",
3447
".zip", ".gz", ".tar", ".7z", ".woff", ".woff2", ".ttf", ".otf", ".eot",
@@ -71,7 +84,7 @@ function walk(absRoot, relDir, matcher, out) {
7184
for (const entry of entries) {
7285
const rel = relDir ? posix.join(relDir, entry.name) : entry.name;
7386
if (entry.isDirectory()) {
74-
if (DEFAULT_EXCLUDE_DIRS.includes(entry.name)) continue;
87+
if (isDefaultExcludedDir(entry.name)) continue;
7588
if (matcher.excludedDir(rel)) continue;
7689
walk(absRoot, rel, matcher, out);
7790
} else if (entry.isFile()) {

‎dsh-mneme/src/wiki/plan.js‎

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -24,7 +24,9 @@ export const PLAN_PAGE_ALLOWED_KEYS = Object.freeze(["path", "title", "template"
2424
export const DEFAULT_MAX_FILES_PER_PAGE = 40;
2525

2626
// plan.yaml 不存在时的启发式默认(spec §6 步 1):全量 include、零 exclude 追加
27-
// (目录级排除由 scan.js 的默认排除表承担)、无页面白名单(划分结果全建页)。
27+
// (目录级排除由 scan.js 的默认排除表承担:node_modules/构建产物 + 一切点开头目录,
28+
// 见 DEFAULT_EXCLUDE_DIRS 上方注释——所以空 plan 也不是「什么都读」)、
29+
// 无页面白名单(划分结果全建页)。
2830
export function defaultPlan() {
2931
return {
3032
include: null,

‎dsh-mneme/src/wiki/scan.js‎

Lines changed: 16 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -24,11 +24,24 @@ const CODE_EXTENSIONS = new Set([".js", ".mjs", ".cjs", ".jsx", ".ts", ".tsx", "
2424

2525
// 默认排除(spec 步 2「跳过 node_modules、构建产物、二进制」):plan.yaml 的
2626
// exclude 是追加而不是替代——用户排除是表达意图,这份是卫生底线。
27+
//
28+
// 点开头目录整类排除(V2 实测回填,见 docs/plans/2026-11-04-chorography-m0.md):
29+
// 会话产物的落盘习惯就是把东西塞进 .qoder-credits / .superpowers / .shots / .zcode /
30+
// .dsh-ops / .v2c 这类点目录,而里面常常是提问原文、调试快照与第三方工具缓存——
31+
// baleen 上它们占 15 个模块里的 6 个,study-desk 上占 5 个里的 3 个。逐个点名厂商等于
32+
// 把一台机器的工具链钉进发布包,换个工具又漏;「点开头即非仓库内容」这条更短的规则
33+
// 与三处实测的分布一致,也不随工具换代失效。
34+
// 代价如实写在这里:.vitepress/theme、.docusaurus 这类确实把真源码放在点目录里的仓库
35+
// 会漏掉那部分,且**拉不回来**——扫描阶段的排除先于 plan.include 白名单生效。
36+
// 只按目录名判,点开头的**文件**(.eslintrc.json 之类)照旧扫:那是仓库配置,不是产物。
2737
export const DEFAULT_EXCLUDE_DIRS = Object.freeze([
28-
"node_modules", ".git", ".hg", ".svn", "dist", "build", "out", "coverage",
29-
".next", ".nuxt", ".output", ".cache", ".chorography", ".worktrees",
38+
"node_modules", "dist", "build", "out", "coverage",
3039
]);
3140

41+
function isDefaultExcludedDir(name) {
42+
return name.startsWith(".") || DEFAULT_EXCLUDE_DIRS.includes(name);
43+
}
44+
3245
const BINARY_EXTENSIONS = new Set([
3346
".png", ".jpg", ".jpeg", ".gif", ".ico", ".webp", ".avif", ".bmp", ".pdf",
3447
".zip", ".gz", ".tar", ".7z", ".woff", ".woff2", ".ttf", ".otf", ".eot",
@@ -71,7 +84,7 @@ function walk(absRoot, relDir, matcher, out) {
7184
for (const entry of entries) {
7285
const rel = relDir ? posix.join(relDir, entry.name) : entry.name;
7386
if (entry.isDirectory()) {
74-
if (DEFAULT_EXCLUDE_DIRS.includes(entry.name)) continue;
87+
if (isDefaultExcludedDir(entry.name)) continue;
7588
if (matcher.excludedDir(rel)) continue;
7689
walk(absRoot, rel, matcher, out);
7790
} else if (entry.isFile()) {

‎dsh-mneme/test/wiki-scan.test.js‎

Lines changed: 29 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -19,15 +19,14 @@ function makeRepo(files) {
1919
return root;
2020
}
2121

22-
test("文件清单:默认排除 node_modules/.git/dist 与二进制/锁文件", () => {
22+
test("文件清单:默认排除 node_modules/dist 与二进制/锁文件", () => {
2323
const root = makeRepo({
2424
"src/a.js": "export const a = 1;\n",
2525
"node_modules/pkg/index.js": "module.exports = 1;\n",
2626
"dist/bundle.js": "var a=1;\n",
2727
"logo.png": "binary-ish",
2828
"package-lock.json": "{}",
2929
"README.md": "# x\n",
30-
".git/config": "",
3130
});
3231
try {
3332
assert.deepEqual(listFiles(root), ["README.md", "src/a.js"]);
@@ -36,6 +35,34 @@ test("文件清单:默认排除 node_modules/.git/dist 与二进制/锁文件"
3635
}
3736
});
3837

38+
// 锁的回归类型:默认排除表退化成「逐个点名已知的点目录」。V2 在三仓实测到的会话产物
39+
// 目录是 .qoder-credits / .superpowers / .shots / .zcode / .dsh-ops / .v2c——点名法每换一个
40+
// 工具就漏一批(baleen 15 模块里 6 个、study-desk 5 个里 3 个都曾是这样混进来的),
41+
// 所以规则改成「点开头目录整类」,本用例用一份从未在任何名单里出现过的 .whatever 来锁这条。
42+
// 反向断言同样重要:点开头的**文件**是仓库配置(.eslintrc.json),必须照旧进清单。
43+
test("文件清单:点开头目录整类排除(任意深度),点开头文件照旧扫描", () => {
44+
const root = makeRepo({
45+
"README.md": "# x\n",
46+
"src/a.js": "export const a = 1;\n",
47+
".git/config": "",
48+
".whatever/session.md": "# 会话产物\n",
49+
"nested/.qoder-credits/report.json": "{}",
50+
"src/.shots/notes.md": "# 调试快照\n",
51+
".eslintrc.json": "{}",
52+
"src/.prettierrc.json": "{}",
53+
});
54+
try {
55+
assert.deepEqual(listFiles(root), [
56+
".eslintrc.json",
57+
"README.md",
58+
"src/.prettierrc.json",
59+
"src/a.js",
60+
]);
61+
} finally {
62+
rmSync(root, { recursive: true, force: true });
63+
}
64+
});
65+
3966
test("文件清单:.gitignore 子集——无斜杠模式命中任意层级,锚定模式只命中根部", () => {
4067
const root = makeRepo({
4168
"keep.js": "",

0 commit comments

Comments
 (0)