附录 A　mini-dsh 源码导读与数字复现

cd mini-dsh
node --test packages/*/tests/*.spec.ts        # 全部 65 个测试
node --test packages/cordis/tests/*.spec.ts   # 单章自检

git checkout ch07-start   # 骨架，函数体挖空，标了 TODO
# ...动手填...
node --test packages/session/tests/*.spec.ts  # 绿了就是对了
git checkout ch07-done    # 参考答案

cd _references/deepseek-harness
find packages -name package.json -not -path '*/node_modules/*' | wc -l    # 226 个包
find packages -name '*.ts' -o -name '*.tsx' | grep -v node_modules | xargs cat | wc -l   # 496,340 行
find packages -path '*/src/*' -name '*.ts' -not -path '*/node_modules/*' | wc -l         # 1,185 文件
wc -l vendor/cordis/src/*.ts | tail -1                                    # 2,693 行
wc -l packages/core/agent-loop/src/*.ts | tail -1                         # 1,643 行

find docs -name '*.md' -not -name '*.zh.md' | wc -l          # 110 英文
find docs -name '*.zh.md' | wc -l                            # 105 中文
find docs -type f | wc -l                                    # 324（含 .i18n.yaml，别拿这个当篇数）
 
find .agents/notes -name '*.md' -not -name '*.zh.md' | wc -l # 688 篇
for d in implemented proposed rejected archived; do
  echo "$d: $(find .agents/notes/$d -name '*.md' -not -name '*.zh.md' | wc -l)"
done                                                          # 507 / 25 / 11 / 143

grep -c "^- " AGENTS.md                                       # 33 条
ls scripts/verify-*.ts | wc -l                                # 34 个文件
ls scripts/verify-*.spec.ts | wc -l                           # 8 个是验证器自己的测试 → 真门禁 26
sed -n '/## Local modifications/,/^## /p' vendor/README.md | grep -cE '^[0-9]+\.'   # 18 条本地修改

python3 -c "
import glob, re
n = short = long = 0
for f in glob.glob('packages/**/README.md', recursive=True):
    t = open(f, encoding='utf-8', errors='ignore').read()
    m = re.search(r'#### KV Cache effect\n+(.+?)(?=\n#|\n##|\Z)', t, re.S)
    if m:
        n += 1
        c = len(m.group(1).strip())
        if c < 80: short += 1
        elif c > 150: long += 1
print(f'有该小节 {n}｜样板(<80字符) {short}｜实质(>150字符) {long}')
"
# 215 ｜ 110 ｜ 58

grep -n "DispatchMode" vendor/cordis/src/events.ts             # 五种，含 bail
grep -rhoE "@mode +[a-z]+" --include="*.ts" packages vendor | awk '{print $2}' | sort | uniq -c | sort -rn
# emit 65 / waterfall 20 / bail 5 / parallel 4 / serial 2

export DSH_HOME=$PWD/.dsh
CC=gcc-10 CXX=g++-10 npm i @deepseek-ai/[email protected]        # 4 分钟，532 个包
 
/usr/bin/time -f "%e s / %M KB" dsh --profile web --dump-config > dump.yml
# 0.26 s / 71,088 KB
wc -l dump.yml                                                 # 490 行
grep -c '^- id:' dump.yml                                      # 129 个插件行
grep -c '^# ==' dump.yml                                       # 24 处层来源注释
 
dsh web --port 3080 &
# 循环 curl 探测到可访问：1.34 秒
ps -eo rss -p $(pgrep -f 'dsh web')                            # 196 MB
curl -s http://127.0.0.1:3080/ | grep -o '/plugins/[^"]*client\.js' | wc -l   # 38 个前端插件

# 多帧 zstd，逐帧解才完整
node -e "
const fs=require('fs'), zlib=require('zlib');
const buf=fs.readFileSync(process.argv[1]);
const out=[]; let off=0, frames=0;
while (off < buf.length) {
  try { out.push(zlib.zstdDecompressSync(buf.subarray(off))); frames++ } catch { break }
  let next=-1;
  for (let i=off+4; i<buf.length-3; i++) if (buf.readUInt32LE(i)===0xFD2FB528) { next=i; break }
  if (next<0) break; off=next;
}
console.log('帧数', frames, '解压后', Buffer.concat(out).length);
" -- "$DSH_HOME/sessions/*/session-*/session.jsonl.zstd"
# 9 帧，70,810 字节（压缩后 22,584）→ 35 个事件

# 需要先用 examples/mock-llm-server 的 RECORD_DIR 录一批请求
python3 assets/ch11/prefix-experiment.py      # 结果存 assets/ch11/prefix-experiment.json

cd mini-dsh/packages/shell && node tests/latency.mjs    # 结果存 assets/ch13/latency.json
# 本地 p50=7ms p95=16ms ／ 容器 p50=357ms p95=473ms → 51 倍