dsh-book
English · 简体中文
> DeepSeek Harness 的写作工作台:Markdown 草稿库 + 小红书 / 公众号 / 通用三种平台编辑器 + 走当前 Profile 默认模型的 AI 文案助手,全程流式输出。
功能
- 草稿库 —— 一篇草稿 = 一个 Markdown 文件,放在你指定的目录(默认
~/Documents/DSH写作,首次保存时
自动创建);浏览、搜索(标题 + 正文摘要)、新建、刷新、删除,按最后修改时间倒序;草稿就是普通文件,
Obsidian、Git、vim都能直接编辑同一个目录。 - 编辑器 —— 小红书 / 公众号 / 通用三种平台配置,标题和字数实时计数(只是黄色提醒,不阻止保存);
标签 chip(Enter或,添加,空标签框Backspace删除最后一个);停止输入约 0.9 秒后自动保存并显示状态;
一键复制全文(标题 + 正文 +#标签)或只复制正文;改标题自动重命名文件(重名加(2));删除需两步确认。 - AI 文案助手 —— 六种模式(写初稿、润色、扩写、精简、出标题、出标签)流式输出、可随时停止,提示词按平台
定制(小红书钩子标题和话题标签、公众号小标题结构、通用自然口吻),结果一键写回编辑器;使用当前 DSH
Profile 的默认模型(host 的llm服务),面板里不用配置 API Key 或供应商。 - 细节 —— 中英双语界面跟随 DSH 语言设置,样式基于 DSH 设计 token 并跟随浅色 / 深色主题;没有构建步骤、
没有第三方运行时依赖、没有常驻后台进程。
安装
前置条件:已安装可用的 DeepSeek Harness(dsh)。默认 Profile 一般是 web。
从 GitHub 安装(推荐)
dsh plugin --profile add github:ChenYichener/dsh-book
从本地克隆安装
git clone https://github.com/ChenYichener/dsh-book.git
dsh plugin --profile add /path/to/dsh-book
DSH 桌面端
打开 插件(Plugins) 页面,选择从本地目录安装,指向克隆下来的 dsh-book 目录(或直接填 GitHub 仓库路径)。
安装后重启 dsh web(或刷新页面),左侧栏面板列表里会出现笔形图标的 写作(英文界面为 Writing)入口,点开即工作台。
升级时重新执行一次上面的 add 命令;卸载:
dsh plugin --profile remove dsh-book
安装要求
| 要求 | 说明 |
|---|---|
| DSH | 支持 plugin bundle 机制与 sidebar.panellist / main 槽位;已在 0.2.2-rc.1 上测试 |
| Node.js | >= 20 |
| 默认模型 | 可选;使用 AI 面板时必须已在 Profile 里设置默认模型 |
| 运行时依赖 | 无——host 是纯 ESM,client 是纯浏览器 JS |
使用
打开工作台
点击左侧栏的笔形 写作 入口。页面分三栏:草稿库、编辑器、AI 助手。目录为空时点 新建作品;草稿库加载完成后会自动打开最新一篇。
编辑草稿
- 在标题旁的平台下拉里选择平台。
- 输入标题和正文;计数超过平台上限时变黄提示,但不会阻止保存。
- 在标签栏输入标签,标签会写入
frontmatter,也会随「复制全文」一起复制。 - 全程自动保存,状态显示在编辑器左下角。
| 平台 | 标题上限 | 正文上限 | 标签上限 | AI 文案风格 |
|---|---|---|---|---|
小红书(xiaohongshu,默认) |
20 字 | 1000 字 | 10 个 | 钩子标题、第一人称短句短段、8–10 个话题标签 |
公众号(wechat) |
64 字 | 4000 字 | 30 个(AI 不生成标签) | 明确价值点标题、小标题结构 |
通用(generic) |
不限 | 不限 | 30 个 | 标题清晰、分段自然、5–10 个标签 |
AI 助手
| 模式 | 需要什么 | 返回什么 | 落地操作 |
|---|---|---|---|
| 写初稿 | 主题 / 素材 / 要点(必填) | 标题 + 正文 + 标签 | 应用到编辑器 |
| 润色 | 非空正文 | 改写后的正文 | 替换正文 |
| 扩写 | 非空正文 | 更长的正文 | 替换正文 |
| 精简 | 非空正文 | 更短的正文 | 替换正文 |
| 出标题 | 正文或主题 | 5 个标题候选 | 点一个采用 |
| 出标签 | 正文或主题 | 8–10 个话题标签 | 点单个添加,或 全部添加 |
可选的 补充要求(语气、受众、想要的角度)会在每种模式下一起发送。生成过程中点 停止 可中断;错误会直接显示在输出区。
键盘与交互
| 位置 | 按键 | 行为 |
|---|---|---|
| 标题输入框 | Enter |
跳到正文 |
| 标签输入框 | Enter、, 或 , |
添加该标签 |
| 标签输入框(为空) | Backspace |
删除最后一个标签 |
| 目录输入框 | Enter |
切换到该目录 |
| 目录输入框 | Esc |
取消编辑目录 |
没有全局快捷键,其余操作都通过按钮完成。
草稿格式
---
title: A month of writing in public
platform: xiaohongshu
tags: 自媒体, 副业, 小红书运营
createdAt: 2026-11-03T01:00:00.000Z
updatedAt: 2026-11-03T01:20:00.000Z
---
正文。结束 `---` 之后的内容会原样保存。
frontmatter 只解析这五个键(按行解析的简易子集,不是完整 YAML 解析器);未知键会被忽略,tags 用逗号分隔。文件没有 frontmatter 时,整个文件视为正文,文件名(去掉 .md)作为标题。只会列出目录下直接存在的 .md 文件——子目录、隐藏文件以及超过 2 MiB 的文件会被跳过。
工作原理
- Host 半(
index.js):导出inject: ['webServer'],通过ctx.effect+ctx.webServer.register在 DSH host web server 上挂一个前缀路由/dsh-book/api。 - 草稿存储:直接用
node:fs;保存是原子的(临时文件 + rename),文件名由标题生成并校验防目录穿越,每个环节都有上限(请求体 1 MiB、草稿文件 2 MiB、单次最多列出 500 篇)。 - 生成:读取
ctx.get('agentDefaultModel').currentSelection()拿 provider/model,用ctx.llm.stream(...)流式调用,并以 Server-Sent Events 回传(start→delta→done/error);浏览器断开时同时中止上游请求。 - 提示词:统一的中文文案底线(不编造事实和数据、不做医疗或绝对化承诺、不写成广告腔)+ 每个平台独立的风格段落;作者文本每个字段截断到 12000 字。
- Client 半(
client.js):由 DSH 的 module loader 加载,注册sidebar.panellist侧栏入口(order 20、笔形图标、随语言切换的文案)和 key 为writing的main面板;React 从宿主的模块表取。 - 客户端状态:草稿增删改查都通过
fetch请求 host 路由;目录覆盖值存在localStorage的dsh-book.directory;样式注入为一个 `` 并全部使用 DSW 主题变量。
HTTP 接口
所有接口都是 POST + JSON body;/dsh-book/api/generate 返回 text/event-stream。
| 接口 | 请求体 | 响应 |
|---|---|---|
/dsh-book/api/info |
{} |
{ ok, defaultDirectory, aiAvailable, provider, model } |
/dsh-book/api/list |
{ directory } |
{ ok, directory, defaultDirectory, exists, docs: [...] } |
/dsh-book/api/read |
{ directory, name } |
{ ok, directory, doc: { ...frontmatter, body, chars } } |
/dsh-book/api/save |
{ directory, name?, title, platform, tags, body } |
{ ok, directory, doc, renamedFrom? } |
/dsh-book/api/delete |
{ directory, name } |
{ ok } |
/dsh-book/api/generate |
{ task, platform, brief?, extra?, title?, body?, tags? } |
SSE 事件 start、delta、done、error |
name 只能是纯 .md 文件名。路由只接受回环 Host 与同源浏览器请求(非 POST 返回 405,其余返回 403),JSON body 上限 1 MiB。
数据与隐私
- 草稿只存在本地。 每篇草稿就是面板左下角那个目录里的一个
.md文件(默认~/Documents/DSH写作,可改成任意绝对路径,支持~)。没有数据库,也不会上传到任何地方。 - 目录偏好只存在浏览器:
localStorage的dsh-book.directory,插件不会写到磁盘。 - 只有 AI 请求会离开本机。 生成时插件会把模式、平台、你写的主题 / 补充要求,以及当前标题、正文、标签,经 DSH 的
llm服务发给你配置的模型供应商;每个文本字段截断到 12000 字。 - 不会发送:草稿库里的其他草稿、文件名、目录路径,以及其他本地数据。
- 没有埋点。 插件自身不发起任何外网请求,没有统计、崩溃上报或远程配置。
- 路由只对本机开放。
/dsh-book/api拒绝非回环 Host 和跨站请求,别的网站无法通过 DSH web server 读你的草稿。
配置
| 配置项 | 位置 | 默认值 |
|---|---|---|
| 草稿目录 | 面板左下角;绝对路径,支持 ~ |
~/Documents/DSH写作 |
| 每篇草稿的平台 | 标题旁的下拉选择框 | 小红书 |
| 模型 | DSH 模型设置(Profile 默认模型) | Profile 当前默认模型 |
| 自动保存延迟 | 固定,停止输入约 0.9 秒后 | 900 ms |
| 提示词文本上限 | 固定,每次 AI 请求的每个字段 | 12000 字 |
没有插件配置文件;目录和平台信息跟着草稿数据走。
开发
没有构建步骤,两半都是手写代码、原样加载。
node --check index.js && node --check client.js
把工作副本装进一个临时 Profile,改完重启 dsh web 即可验证:
dsh plugin --profile dev add /path/to/dsh-book
dsh web 运行时可以直接用 curl 调 host 路由(端口看启动日志;回环请求不带 Origin 头也能通过):
curl -s -X POST http://127.0.0.1:/dsh-book/api/info \
-H 'content-type: application/json' -d '{}'
curl -s -X POST http://127.0.0.1:/dsh-book/api/list \
-H 'content-type: application/json' -d '{"directory":"~/Documents/DSH写作"}'
client 半是单文件 bundle:通过 window.__ModuleLoader__.load({ id: 'dsh-book', factory(require) { ... } })
注册,用 require('react') 取 React,返回 { inject, apply }。
项目结构
dsh-book/
├── index.js # host 半:/dsh-book/api 路由、Markdown 存储、SSE 生成
├── client.js # client 半:侧栏入口 + main.writing 工作台
├── cordis.patch.yml # bundle patch,插入 dsh-book 插件行
├── package.json # dsh.bundle / dsh.client 清单、exports、npm 元数据
├── icon.svg # 插件图标
├── locale/
│ ├── en.json # 插件管理页标题与描述(英文)
│ └── zh.json # 插件管理页标题与描述(中文)
├── docs/
│ └── screenshot.png # README 截图
├── README.md # English (default)
├── README.zh.md # 简体中文
├── LICENSE
└── .gitignore
常见问题 / 故障排查
| 现象 | 处理 |
|---|---|
| 安装后左侧栏没有 写作 入口 | 重启 dsh web(或刷新页面),并确认装在了正在运行的 Profile:dsh plugin --profile list |
| AI 面板显示 未连接模型,生成按钮不可用 | 在 DSH 模型设置里给该 Profile 选默认模型;助手需要 llm 服务和默认模型同时可用 |
| 目录里有文件,草稿库却是空的 | 检查左下角的目录;只列出该目录下直接的 .md 文件,超过 2 MiB 的会被跳过 |
| 在别的编辑器里改完看不到变化 | 点草稿库右上角的刷新按钮 |
| 改标题后多出一个文件 | 正常:草稿文件名跟随标题,重名会加 (2) |
| AI 输出被截断 | 每种模式有各自的 token 预算;缩短素材,或分两次用扩写 / 精简 |
| 能配 Obsidian 仓库吗? | 可以,把目录指向 vault 里的某个文件夹即可;想继续识别标题/平台/标签,就保留那五个 frontmatter 键 |
| AI 会用英文写吗? | 内置提示词是面向中文平台调校的,输出以中文为主;界面语言与输出语言互相独立 |
| 支持 Windows / Linux 吗? | 支持。默认目录在你自己的用户目录下,目录框里也可以直接填任意绝对路径 |
兼容性
- DSH:
dsh web提供的 Web UI,包括 DSH 桌面端(已在0.2.2-rc.1上测试)。 - 操作系统:macOS、Windows、Linux——host 半只用 Node 核心模块,client 半只用浏览器 API。
- 插件 API 说明:这是一个外部插件 bundle(
cordis.patch.yml+dsh.bundle/dsh.client清单),依赖webServer、slots、locale服务,main和sidebar.panellist槽位,以及 AI 功能所需的llm和agentDefaultModel服务。如果 DSH 改了这些名字,面板需要同步更新。 - 模型供应商:只要能在 DSH 里配成 Profile 默认模型就能用;面板不直接连任何供应商。
相关 DSH 插件
| 插件 | 作用 |
|---|---|
| dsh-book | Markdown 草稿库 + 小红书 / 公众号 / 通用 AI 文案工作台 |
| dsh-notify | DSH 在后台时,会话结束发系统桌面通知 |
| dsh-pomodoro | 侧栏里的免打扰番茄钟 |
| dsh-translate | 中英翻译工作台,常驻 AI 导师 + 神经朗读 |
| dsh-nce | 新概念英语第一册学习面板(课程、SRS 闪卡、错题本) |
许可证
MIT © 2026 chenyichen