by PolinniZhong
面向 AI Coding Agent 的任务感知工作区上下文检索与生命周期追踪:按当前任务找到、组织并持续追踪最相关的文档、代码与媒体。纯本地、零模型调用、零网络。 Task-aware workspace context retrieval and lifecycle tracking for AI coding agents. Find, organize, and track the workspace context most relevant to the task at hand — locally, deterministically, zero model calls, zero network.
# Add to your Claude Code skills
git clone https://github.com/PolinniZhong/dsh-knitGuides for using ai agents skills like dsh-knit.
Last scanned: 10/7/2026
{
"issues": [],
"status": "PASSED",
"scannedAt": "2026-10-07T10:53:59.142Z",
"npmAuditRan": true,
"pipAuditRan": true,
"promptInjectionRan": true
}See how dsh-knit compares with popular alternatives.
dsh-knit is an open-source ai agents skill for AI coding assistants such as Claude Code, Codex CLI, and ChatGPT, built by PolinniZhong. 面向 AI Coding Agent 的任务感知工作区上下文检索与生命周期追踪:按当前任务找到、组织并持续追踪最相关的文档、代码与媒体。纯本地、零模型调用、零网络。 Task-aware workspace context retrieval and lifecycle tracking for AI coding agents. Find, organize, and track the workspace context most relevant to the task at hand — locally, deterministically, zero model calls, zero network. It has 54 GitHub stars.
Yes. dsh-knit passed SkillsLLM's automated security scan — a dependency vulnerability audit plus prompt-injection heuristics — with no high-severity issues. You can read the full report in the Security Report section on this page.
Clone the repository with "git clone https://github.com/PolinniZhong/dsh-knit" and add it to your Claude Code skills directory (see the Installation section above).
dsh-knit is primarily written in JavaScript. It is open-source under PolinniZhong on GitHub, so you can review or fork the full source.
Yes. SkillsLLM lists many other AI Agents skills you can browse and compare side by side. Open the AI Agents category from the badge at the top of this page, or use the Related Skills and comparison links further down to weigh dsh-knit against similar tools.
No comments yet. Be the first to share your thoughts!
From $49 · 30 days · terms & refunds
⚠️ Third-Party Software Notice
This skill is third-party open-source software developed and hosted independently on GitHub. SkillsLLM lists this project for discovery and does not control or maintain the underlying repository.
Any security checks, ratings, or warnings displayed by SkillsLLM are automated and limited in scope. They do not constitute a security certification or guarantee that the software is safe, error-free, or free from malicious code, vulnerabilities, compromised dependencies, or prompt-injection risks.
Review the source code, permissions, dependencies, and configuration before installing or running any third-party skill. Use is at your own risk. To the maximum extent permitted by applicable law, SkillsLLM is not liable for losses arising from third-party software.
Automated security scan — not a certification.
面向 AI Coding Agent 的任务感知工作区上下文检索与生命周期追踪。
Task-aware workspace context retrieval and lifecycle tracking for AI coding agents.
Knit 接的是当前任务和整个工作区之间那一层:从工作区里找出最相关的文档、源码与媒体, 组织成 主要 / 辅助 / 相关 三层上下文(Context Pack),交给面板、也交给 agent; 再持续追踪这些上下文有没有被读、被读之后有没有变。
找到 → 组织 → 追踪,默认的词法模式三步都在本机用字符串运算完成 —— 不调模型、不联网、零延迟、内容不出本机。 可选的混合模式默认关闭:只有你自己配好 provider 并且手动切到混合检索,才会有出网请求; 那时发出去的是你这句查询原话 + 每篇候选文件的标题与摘要(完整正文、绝对路径都不发)—— ⚠️ 这里有两个容易想当然的地方,见下面的「混合模式到底发出去了什么」。
当前任务
│
工作区检索
┌────────────┼────────────┐
▼ ▼ ▼
主要上下文 辅助上下文 相关上下文
└────────────┼────────────┘
▼
Context Pack ──► `knit_docs` 工具(给 agent)
▼
Agent 读取
▼
读取证据 · Context Epoch
▼
工作区发生变化
▼
重新读取 · 生命周期
它不是「更聪明的最近文件列表」,也不是「代码浏览器」。 最近文件记的是「你点开过什么、哪个更新」;Knit 回答的是 当前这个任务,项目里哪些东西最值得先看 —— 以及看过之后,事情变成了什么样。

真机截图(不是原型):同一个工作区,这张停在 「代码」档 —— v0.19 起,源码和 Markdown 一样是一等公民。
每行下面的副行写着它是怎么被命中的(直接命中 classification · changelog / 路径命中 agents · classification),
以及命中段 —— 这次查询在这份文件里最像的是哪一段(命中段 24–38)。
点一行就地展开预览,并且直接停在那一段上:这里是 knit/src/host/passage.js,行号栏 + 语法高亮,
命中的那几行带一条灰底横带;预览头里只有路径和四个动作(复制 / 全屏 / 本地打开 / 关闭)。
头部只放路径、一个计数与两个开关;列表按「相关」还是「最新」排,由左边那一对页签决定 —— 按「相关」时排的就是你正在聊什么。
v0.14 起列表永远单列:最左边独立一列是序号(与标题第一行垂直居中),右边第一行=
Primary 点 + 标题 + 相对时间(时间靠右),摘要再往下;路径只出现在预览头里(目录收敛成一个 …/ 占位,完整相对路径在悬停提示里),列表行不再重复。
序号是跨三档连续的一条(先看 / 辅助 / 背景);「其他相关文档」不在包里、不编号,那一格用一个 · 占位 ——
空着会被读成「漏了一个号」(2026-10-01)。

排序跟着对话走(同一个工作区、新开的一个会话):聊天里先聊过一轮发布清单,顶上几条就是发布清单那一族; 再问一句「Knit 里 BM25 的字段权重是怎么定的?」,列表整个换成 BM25 那一族 —— 分组标题与跨三档连续的序号随之一起出现,每篇下面多一行「为什么」(命中在哪、怎么命中的、命中段是哪一段)。 ⚠️ 面板是每 5 秒轮询一次的,重排不是发消息那一瞬间:这一屏里顶上几条是这一轮对话推进之后才整个换掉的 (中间那几十秒被剪掉了)。动图比真实时间快。
扫整个项目文件夹的文档 / 代码 / 图片 / 视频 · 排序跟着对话走 · 默认词法模式下不调模型、不联网
dsh plugin --profile web add dsh-knit
Agent 一天产出 20 篇文档,你找不到刚才那篇。
这是它最开始要解决的问题:产出速度超过了人翻目录的速度。 DSH 自带的「最近文件」只记你点开过什么;一轮对话结束,前面那几篇就沉下去了。
Knit 换了个问法:不看「谁新」,看「和现在这件事有多相关」。 它扫的是整个工作区(不是这一轮生成的那几篇),按你正在聊的内容排序 —— 重启 DSH、换会话、跨天回来,它都还在。
后来问题往前长了一步:真要动一个功能时,最该先看的往往不是文档,而是那几行源码。 v0.19 起代码进了同一条链路。再往后,「排在前面」也不够用了 —— 排出来的那些,agent 到底读了没有?读完改过没有? v0.15–v0.18 补的就是这一层。
三句话:找到(扫全工作区、按当前任务排序)→ 组织(主要 / 辅助 / 相关三层 + 每条的理由) → 追踪(读了没有、读完变了没有)。
这两个类比各自只说中 Knit 的一个表层形态,说不到它回答的问题。
| 最近文件列表 | 代码浏览器 | Knit | |
|---|---|---|---|
| 范围 | 你点开过的 | 一棵目录树 | 整个工作区:文档 / 代码 / 图片 / 视频 |
| 排序 | 修改时间 | 你自己翻 | 当前任务的相关性(BM25 + IDF,本地算) |
| 输出 | 一条平铺列表 | 你打开的那一个文件 | 主要 / 辅助 / 相关 三层,每条都写明为什么在这里 |
| 给谁 | 你 | 你 | 你和 agent —— 同一份 Context Pack,走 knit_docs |
| 之后 | 不管 | 不管 | 读了没有 / 读完变了没有(读取证据 + 生命周期) |
三条最要紧的区别:
plugin-loader.ts 浮上来。默认词法模式下不调模型、不联网:全是本地字符串运算,零延迟、零成本、内容不出本机。
可选的混合模式默认关闭,指向**本机服务(loopback)**时内容不出这台机器。
⚠️ 语义收益仍待真 provider 实测(value-evidence: pending),不承诺召回提升。
这段是按报文实测写的,不是按设计意图写的 —— 复现命令与逐条断言见
docs/evaluations/hybrid-retrieval.md(审计脚本
tools/semantic-request-audit.mjs 会把每一次请求的 body 录下来再逐条判)。
发出去了(请求体只有 { model, input } 两个字段,input 是一串文本):
| # | 内容 | 精确边界 |
|---|---|---|
| ① | 你这句查询原话 | 面板走会话路径时是「最近一条有实质内容的用户消息」,截到 80 字;knit_docs(query=…) 走显式路径时最多 2000 字。每一轮刷新都会重发一次(文档向量有缓存,查询没有) |
| ② | 每篇候选文件的标题 | Markdown 是正文里的第一个 # 标题(没有就用文件名);代码是带扩展名的文件名;图片 / 视频是去掉扩展名的文件名 |
| ③ | 每篇候选文件的摘要 | Markdown 的「摘要」是正文首个正文段落的节选(≤ 60 字)——它来自正文;代码的「摘要」是工作区相对目录(如 src/host/);媒体没有摘要 |
没有发出去:完整正文(审计对工作区里每一篇够长的文件都做了「开头 200 字 + 中段 200 字」两处探针,一处都没出现)、
绝对路径(工作区根 / 家目录 / file:// 一条都没出现)、会话历史、你工作区里没被选中的文件。
⚠️ 两个容易想当然的地方:
①**「摘要」不等于「与正文无关的元数据」——Markdown 的摘要是正文的节选,所以会有至多 60 字的正文离开本机**;
②图片 / 视频的文件名也会被发出去(它们没有摘要,发的是文件名本身,例如 screenshot-media)。
dsh plugin --profile web add dsh-knit
装完重启 DSH,然后硬刷新浏览器(Cmd + Shift + R)。
怎么打开:
可选:装了 dsh-better-sidebar 的话,面板也会注册成它的一个 tab;
没装不受影响,两边是各自独立的可选依赖。
升级:命令和首次安装是同一条,装完同样要重启 DSH + 硬刷新。
| 能力 | |
|---|---|
| 按当前对话相关性排序(BM25 + IDF)—— 默认纯本地、零模型调用;可选的混合模式默认关闭,见下 | ✅ |
| 当前任务上下文:把排序结果拆成 主要 / 辅助 / 相关 三层,每条都写明「为什么在这里」 | ✅ |
关系证据(v0.21):每行标出 检索 / 关系 / 用户固定;「为什么」展开行级证据(引用 / 导入 / 测试 / 文档,带对方文件与行号,面板最多 3 条、工具最多 2 条)—— 每条都能按行号 grep 回原文,一个字的理由都不是编的 |
✅ |
| 固定 / 排除(v0.21):固定进最上方独立区(不编号,三层编号不变);排除在检索之前生效(计数与状态摘要同时变,可恢复);宿主给了存储就活过重启,没给就写明「本会话有效(未持久化)」 | ✅ |
检索状态摘要(v0.21.x):面板头部一行如实显示 收集 · 排除 · 候选 | BM25 词法检索 · 关系 · 固定 | 入包(组内中点、组间细竖线、没有箭头),换任务 / 换档都跟着变 |
✅ |
工具栏一行(2026-10-12):相关 / 最新(排序)文档 / 代码 / 媒体(类型)—— 两组之间没有竖线,靠间距分界 | 右侧是搜索框(唯一可伸缩项,常规 180–240px,面板窄了先缩它,其余按钮永不被挤)。检索方式不在这行 —— 它是第三行状态摘要里的可点状态格(BM25 检索 ›,见下一条);四项彼此独立 —— 切排序 / 切类型 / 切检索方式都不动搜索词 |
✅ |
顶行计数(v0.21.x):只显示阿拉伯数字(9 / 过滤时 3 / 79)—— 量词随类型档变,索性不上屏;悬停提示里仍是完整那句(9 个代码文件) |
✅ |
给 agent 用的 knit_docs 工具:让模型拿回三层任务上下文(不是一条平铺列表) |
✅ |
文档生命周期(v0.17):每篇推荐文档现在处于 未读 / 已读 / 读后已更新 / 修改后已重新读取 哪一档,另外给出最近读了哪篇、包外读了哪几篇、上下文最近一次怎么变 |
✅ |
| 相关性 / 修改时间双模式一键切换(偏好记在 localStorage) | ✅ |
扫描会话工作区里的 .md 与上表那批代码后缀(递归,深度 ≤ 6,跳过 node_modules / .git / dist / build / out / coverage …) |
✅ |
生成 / 噪声产物不进检索:.map、*.min.js、*.min.css、*.bundle.js、*.generated.js、*.gen.js、*.lock、package-lock.json —— 你能打开它们看,但它们不会成为主要 / 辅助 / 相关上下文 |
✅ |
代码预览:行号 + 等宽 + 横向滚动 + 复制 + 「本地打开」;同名 app.js.map 存在时预览页脚多一个低权重「Source map」入口(点开按纯文本看,.map 本身不进上下文) |
✅ |
| 每项显示:H1 标题(无则文件名)+ 相对时间 + 首段摘要 | ✅ |
| 文档列表永远单列(v0.14 起,多列那套已整体删除);序号在每行最左边独立成一列(与标题第一行垂直居中),其余数据全在右边堆叠(右边第一行=Primary 点 + 标题 + 相对时间,时间靠右),摘要再往下;列表行里不再有路径 —— 它和预览头那行可点的路径重复,只保留后者 | ✅ |
| 单击就地展开预览,再点收起 | ✅ |
相对路径图片真正渲染(./img/a.png、../assets/b.png) |
✅ |
代码上下文(v0.19):.js .mjs .cjs .ts .tsx .jsx .py .json .html .htm .css .scss .yaml .yml .sh .bash .zsh 与 Markdown 进同一个检索池,共用同一份 BM25、同一个 Context Pack、同一套生命周期 —— 不是第二套「代码搜索」 |
✅ |
| 文档 / 代码 / 媒体 三类一键切换(偏好记住,默认仍是文档,老体验不变);选中态是下划线式页签(v0.14 起就是这个;不带品牌色描边、也没退回灰底按钮 —— 2026-09-29 明确裁定过;页签「媒体」2026-10-06 由「图片与视频」改短,「代码」v0.19 加入;「全部」档 v0.23.1 已从 UI 删除) | ✅ |
| 图片与视频:方形缩略图网格,格子基准固定 104px、列数由宽度连续数出来(320px → 2 列 / 632px → 5 列 / 1200px → 10 列),格子大小基本不变;纵向有多少行就铺多少行,超出交给列表滚动;视频自动取首帧、叠播放三角与时长角标(零依赖、不转码) | ✅ |
| 点图片 / 视频在面板内就地预览:图片大图、视频可播放可拖动(HTTP Range 流式,不全量下载) | ✅ |
预览面板可拖高度(20%–80%,位置记住)、可全屏,Esc 退出;全屏时头部 / 排序条 / 类型档 / 使用情况 / 列表全部让位,预览铺满整个面板 |
✅ |
「本地打开」:用系统默认应用打开当前预览的这篇文档;预览头那条路径点开的是它「所在的文件夹」并顺带选中这个文件(reveal,macOS 是 Finder 里 open -R;与顶部那行工作区路径同一套机制,差别只在「打开目录」vs「定位到文件」,完整相对路径在悬停提示里) |
✅ |
| 双击在新标签页打开(官方文档预览,带 PDF 渲染器与渲染方式切换) | ✅ |
HTML 的「网页预览」(v0.19 追加):预览头只对 .html / .htm 多一个按钮,点了在官方文档预览标签页里按网页渲染 —— 那一侧是 DSH 自带的 HTML 渲染器(默认静态档:清洗过的文档 + 不给 sandbox 权限的 iframe + CSP 挡脚本 / 外部资源 / 表单 / 嵌套框架,内联 <style> 与 data: 图片保留)。就地预览给的是源码,两者不重复;其余代码类型不给这个按钮 |
✅ |
| 过滤框:按标题 / 摘要 / 路径实时过滤 | ✅ |
| 点工作区路径:用系统文件管理器打开项目文件夹 | ✅ |
| 悬停入口按钮偷看:弹只读浮层列最近 5 篇,点击才进右边栏(不推挤布局;浮层只有「头 + 列表」,没有多余的横线与提示语) | ✅ |
键盘导航:↑ ↓ 移动即预览 / Enter 切换 / Esc 收起;媒体档 ← → 按屏幕位置跨行,Home / End 到首尾(文档档永远单列,← → 没有空间含义) |
✅ |
| 每 5 秒自动刷新 + 手动刷新;2 分钟内改动过的文档打 🆕 | ✅ |
| 中英双语,跟随 DSH 语言实时切换(不用重载插件) | ✅ |
列表是标准 listbox/option 语义,选中项用 aria-activedescendant 播报;媒体网格里的键盘焦点有可见描边 |
✅ |
| 默认零模型 / 零网络出口:默认的词法模式全程在本机做字符串运算 —— 不调模型、不联网、零延迟 | ✅ |
可选混合模式(默认关闭)(v0.23):需你自己配置 provider(Ollama / OpenAI 兼容)。配了远程 provider 时,发出去的是你这句查询原话 + 每篇候选文件的标题与摘要 —— 完整正文与绝对路径都不发,但 Markdown 的「摘要」是正文首个段落 ≤ 60 字的节选、图片 / 视频发的是文件名(逐条口径见上面的「混合模式到底发出去了什么」);向量只在内存里,配置存在 DSH 存储的独立单元 knit_semantic。指向本机服务(loopback)时内容不出这台机器。⚠️ 语义收益的证据仍待真 provider 实测(value-evidence: pending)—— 本项目不承诺召回提升 |
✅ |
Git 变更关联(默认关闭)(v0.24):按工作区里未提交的改动列出「还该一起看的文件」,依据是 Knit 已有的四类证据(引用 / 导入 / 测试配对 / 文档提及),每条都给出起点 + 类型 + 行号。只读:只跑一条 git status(关掉 fsmonitor 与可选索引刷新,子进程环境白名单 —— 任何 GIT_* 都不继承),不读 diff、不读文件正文、不发网络;读不到时如实写出原因(不是只放在悬停里)。⚠️ 本版新增宿主接口,升级后需要重启 DSH |
✅ |
相关度不做可视化(不显示百分比、不画长条)—— 排序本身就是答案,名次即相关度。

媒体:方形缩略图,列数跟着面板宽度连续变 —— 这一屏是 6 列,格子约 110px。 列出的就是工作区里真实的图片与 SVG 文件(这一屏 18 个媒体),所以看起来像一屏文件缩略图 (那个纯黑方块是单色 SVG 图标本身,不是加载失败)。 视频会取首帧当海报、中央叠播放三角、右下角叠时长,只是这个工作区里没有视频,所以这一屏看不到。
排序解决的是「哪几篇跟这段对话最像」。但你要的往往是另一个问题的答案:
现在这个任务,项目里哪些东西最值得先看?
Context Pack 是对这个问题的回答,但它是数据层的结构(主要 / 辅助 / 相关三层 + 每条的确定性理由), 不是一张要单独显示的卡片。所以它直接落在文档列表里:相关模式下,文档档从一条平铺列表 变成三层分组,组名后面跟一句极短的说明。
┌─ 文档列表 ────────────────────────────┐
│ 主要上下文 先看 │
│ 01 ● 相关性排序算法 5分钟前 │
│ 标题命中:排序 │
│ │
│ 辅助上下文 辅助 │
│ 02 排序评测集 2小时前 │
│ 正文命中:关键词计数 │
│ │
│ 相关上下文 背景 │
│ 03 CHANGELOG.md 12天前 │
│ 正文命中:排序 │
└────────────────────────────────────────┘
示意图省掉了每行的摘要