dsh-chart
航图 · Chart — a DeepSeek Harness plugin that turns a session's real steps into a reusable skill draft: the commands that worked, the files that changed, the checks that passed, and the pitfalls worth remembering. Secrets are masked on your machine before anything reaches the page, and the draft saves to your local skill library as a normal SKILL.md. 适合希望将已跑通的会话步骤和命令一键转化为可复用技能文件的用户。
同名パッケージの別リポジトリ
インストール
npx -p @deepseek-ai/dsh dsh plugin --profile web add github:xh0915/dsh-chartドキュメント
README 全文を読む ↗航图 · dsh-chart
这次会话里跑通的东西,一键变成下次能直接用的技能。
中文 · English
先看一个场景
有些活你每周都要干一遍:发布插件、跑数据库迁移、把设计稿切回项目里。每一次都得重新摸索一遍命令,试错半小时,才算想起来上回是怎么做的。
而就在上一次会话里,这套动作其实已经真的跑通了——命令执行成功了,测试过了,构建过了。只是它跟着聊天记录一起滚走了。
航图负责把它捡回来。 打开一个聊过天的会话,点「航图」标签,它从会话日志里挑出真正跑通的步骤、真正通过的验证、最后改好的文件和踩过的坑,写成一份 SKILL.md——就是 DeepSeek Harness 能直接加载的技能文件。存进技能库之后,下次遇到相似任务,Harness 会带着这份经验开工。
不额外调用模型,不猜内容。草稿里每一条,都能对回那次会话里的一条事件。
长这样

界面预览,用的是示例会话:左边是从日志里数出来的证据,右边是生成的技能草稿。
保存之前,你看到的是这样一份普通 Markdown:
---
name: dsh-chart
description: "当任务和「把构建和测试修好,再把暗色主题的背景补上」相似时使用:
步骤、命令和验证都来自一次真实会话。"
---
# 给 dsh-chart 补测试
> 这份技能由航图从会话 `session-01hchart` 整理,共 2 轮、33 条事件。
> 步骤和命令都来自真实记录,保存前请自己过一遍。
## 步骤
1. 装依赖 —— `pnpm install`(第 1 轮)
2. 先打个包,确认能发布 —— `pnpm pack --pack-destination .tmp`(第 2 轮)
## 验证
- `pnpm run build`
- `pnpm test`
- `npm run lint && tsc --noEmit`
什么进技能,什么不进
| 会话里发生过 | 航图怎么处理 |
|---|---|
pnpm test 执行成功 | 进步骤,也进验证 |
npm run lint && tsc --noEmit 成功 | 进验证(整条命令都在做检查) |
rm -rf dist && npm test | 不进验证 —— 前半段不是检查 |
cd、ls、pwd | 不记,打杂命令 |
| 同一个命令跑了五遍 | 合并成一条 |
| 一条命令失败了,后来重试成功 | 记成坑,并注明后来修好了 |
| 一条命令始终没成功 | 记成坑,直说没修好,不假装 |
| 编辑或写入成功的文件 | 进「改过的文件」,注明改了几次 |
| 模型在聊天里说要跑什么 | 不记 —— 没有真的执行过 |
| 日志里没记录的信息 | 留空,不补 |
原则:有一步,是因为某条命令真的执行成功了;有一个坑,是因为某条命令真的失败了。
页面上还有什么
左边:七个数字 —— 对话轮次、可用步骤、验证命令、失败记录、改动文件、命令总数、原始事件,全部从日志里数出来,没有估算值。
左边:会话里找到了什么 —— 目标(第一句话里你要做的事)、步骤、验证、改过的文件、踩过的坑、开始之前(系统、终端、包管理器、有没有用 git、工作区路径)。
右边:草稿 —— 保存前可以逐行检查、逐段删改:
- 技能名就是文件夹名。航图会自动挑一个没被占用的名字,所以存第二份时不会悄悄盖掉第一份。
- 包含哪些内容可以单独开关:步骤、验证、文件、踩坑、开始之前、目标。关掉后草稿会重新生成。
- 手改之后草稿就不再自动刷新;想重来一遍按「重新生成」,它会先提醒会覆盖你的手改内容。文件开头的
name始终跟着文件夹名走。 - 复制 Markdown / 下载 SKILL.md / 保存到技能库三个出口。保存时弹窗会先告诉你具体写到哪;已有同名技能必须勾选「覆盖」才生效,而且旧文件会先备份。
存完之后,页面会告诉你文件写到哪了、备份在哪、写入时又脱敏了几处。
技能存到哪
~/.dsh/skills//SKILL.md # 默认位置
$DSH_HOME/skills//SKILL.md # 设置了 DSH_HOME 时
这就是 DSH 本来就会扫描的用户技能目录,写进去的技能会被自动发现,之后开新会话就能用。航图不会写到别的目录,也不会写出半截文件:内容先写进临时文件,再整体改名到位。
怎么装
需要 Node.js 22.19+(或 24+)和 DeepSeek Harness 0.1.0-rc.6+。
git clone https://github.com/xh0915/dsh-chart
cd dsh-chart
pnpm install
pnpm run build
dsh plugin --profile web add .
重启 Web Harness,打开一个聊过天的会话,顶部就会出现 航图 标签。
pnpm run build必须在add之前跑。 这个包没有安装期构建脚本(pnpm 10 会拦下未批准的prepare),跳过这一步,插件会「装上了却加载不出来」。
卸载:
dsh plugin --profile web remove dsh-chart
它不会做的事
- 不编内容。 不从模型的描述里推断步骤,只认日志里真实执行过的动作。
- 不把没通过的检查算成验证。 失败过的测试、lint 不会出现在验证一节。
- 不掩盖失败。 没有报错原文的失败仍然计入次数,但不会编一句话塞进技能里。
- 不动你的预设。 只写 DSH 真正会扫描的用户技能目录,预设自带的文件夹不碰。
- 不联网。 不调用模型、不执行命令、不做统计上报,只是把你自己的会话数据摆出来。
- 不给费用数字。 日志里没有价格,插件不猜。
隐私
会话里经常带着密钥、令牌和邮箱。所有清理都在你的电脑上、内容进入页面之前完成:
- 私钥块、JWT、GitHub / AWS / Google / Slack / npm / PyPI / Stripe / DeepSeek 形状的密钥、
Bearer头、网址里的账号密码、api_key = …这类赋值、邮箱地址,统一替换成«已脱敏»。 - 页面告诉你遮住了多少处、涉及哪几类,但不显示被遮住的内容。
- 保存时还会再脱敏一遍,所以就算你手动改过,也不会把密钥又带回去。
- 只是「长得像密钥」的东西不动:
process.env.X、${模板变量}、foo.bar.baz、ALL_CAPS_CONSTANTS,以及很短的字符串。 - 自动脱敏默认开着。关掉之后,页面和保存弹窗都会如实说明,不会假装还开着。
内容不会上传。插件通过 Harness 自带的 sessionQuery 读取当前会话,只往技能目录里写文件。
设置
dsh-chart:
redactSecrets: true # 内容进入页面前遮住密钥(默认)
maxSteps: 30 # 最多保留多少条可用步骤,5–200
成功命令太多、超出上限时,草稿按顺序保留前 maxSteps 条,并附一句「有内容被省略」,不会悄悄丢掉。验证、踩坑、改动文件也各有固定上限(12、12、24 条),到顶时同样会标注。
界面跟随 Harness 的浅色和深色主题,支持中文和英文。
技术细节(要改代码的人点这里)
目录
package.json # dsh.bundle.patch + dsh.client、脚本、peer 依赖
cordis.patch.yml # 把宿主插件挂进 profile
dsh.plugin.json # 插件清单
src/index.ts # 宿主入口:Config、ChartRuntime、Typert 清单
src/runtime.ts # chart.build / chart.library / chart.save
src/distill.ts # 会话日志 -> 目标、步骤、验证、文件、坑、环境
src/library.ts # 本机技能库:解析、列出、保存、备份
src/redact.ts # 本机密钥脱敏
src/schema.ts # Zod 定义的线上格式(类型由它推出,不会漂移)
src/contract.ts # 宿主和前端共用的严格 InvocationDescriptor
src/typert.ts # 宿主反射清单
src/client/index.tsx # 前端入口:挂载 Remote、注册标签
src/client/view.tsx # 航图界面
src/client/skill.ts # SKILL.md 生成 + 开头字段同步
src/client/styles.ts # 跟随 Harness 明暗主题的样式
src/client/locales.ts # 中英文文案
tests/ # 蒸馏、技能库、Markdown、契约、前端入口测试
build.mjs # esbuild 双构建:宿主 ESM + 给网页加载器用的前端包
前端这一半不提供任何提示词、工具或会话事件 —— ctx.typert.register() 只发布反射元数据。插件展示的是你自己的数据。
开发
pnpm run check # 类型检查 + lint + 测试 + 构建
改名
fork 后要改名的话,这些地方要一起改:package.json → name、exports、files;build.mjs → __ModuleLoader__.load 的 id;src/index.ts → name;src/client/remote.ts → 十六进制编码的 TypertRemoteNamespace$… 名字;src/client/locales.ts → 语言命名空间;src/client/index.tsx → 槽位 id;src/typert.ts → package;src/contract.ts → 调用 id;cordis.patch.yml → id 和 name;dsh.plugin.json → id。
许可证
MIT
作者:里卡多 / xh0915