# 路线图

> 方向：**只观察、可停止、零 token**。任何「替用户做决定」或「默认联网」的能力都不会进主线。

## 已完成

| 版本 | 内容 |
|---|---|
| 0.3.0 | 运行时监察（判定 / 事件流 / 快照）· 按 callId 与范围强制停止（含嵌套子调用）· 右下角红绿灯挂件 · 四个本机接口 + 跨站栅栏 · 默认 0 token |
| 0.4.0 | 新判定 **memory-leak**（内存泄漏预警）· 心跳采样 RSS · memoryLeakWindow / memoryLeakGrowth 可调 · 自检 121 项 |
| 0.5.0 | 判定规则可编排（内置 8 条 + 第三方 `registerRule`）· 会话维度过滤（`?session=`）· 强停取证卡 · 挂件 5 分钟时间线 · install/uninstall 加固 · 自检 290 项 |

## 0.5（已完成，0.5.0）

- [x] **判定规则可编排**：把 verdict 里的长 if 链抽成规则数组（id / 判据 / 阈值 / 严重度），允许第三方注册自己的规则
- [x] **会话维度过滤**：多会话并行时只看「我正在看的那个会话」的判定（现在是全局）
- [x] **停后取证**：强制停止时自动把该调用的参数、耗时、最后输出落一张事件卡
- [x] **挂件时间线**：面板里加一条最近 5 分钟的判定 / 事件迷你时间线

## 0.6

- [ ] **i18n**：core 的判定文本与挂件文案抽成词表（zh / en），加语言 = 加一个 json
- [ ] **配置校验**：启动时按 docs/config.schema.json 校验 patch，写错键时在控制台明确提示
- [ ] **指标导出（可选、默认关）**：把判定与计数以 Prometheus 文本格式暴露在回环端口上

## 1.0

- [ ] 设置契约单一化：宿主与挂件共用一份 schema，消除两端各写一套夹紧规则的问题
- [ ] 静默失败可观测：所有被 safe() 吞掉的异常计数并进入事件流
- [ ] 文档计数自动化：README 里的自检项数由脚本生成，杜绝漂移
- [ ] 补齐最危险但没测的路径：sink 轮转 / 控制台心跳 / autoKill / 路由 403

## 明确不做

- ❌ 自动修改或重试工具调用（违反「只观察」）
- ❌ 默认联网上报 / 遥测（要看数据请自己读 events.jsonl）
- ❌ 硬杀同进程死循环（宿主没有这个能力，强做会破坏别的调用）
- ❌ 把观测数据默认塞进模型上下文（会破坏「0 token」）

## 想加东西？

1. 开一个功能建议：https://github.com/QTATQ233/dsh-jingcha/issues/new?template=feature_request.yml
2. 或照 docs/EXTENDING.md 直接改（加判定规则通常只要动 2 到 6 处）；
3. 带 good first issue 标签的条目适合第一次上手，见 CONTRIBUTING.md。