前言¶
DeepSeek Harness (DSH) 提供了插件扩展能力，开发者在使用过程中常面临结构化内容管理混乱的问题。xiashuo 是一个面向 DSH 的插件，旨在为课程、公文、小说、论文等创作提供项目级的管理与工作流支持，解决多类型文档在编写、校验与协作中的流程断层问题。
插件简介¶
这是一个 AI course-authoring workspace plugin for DeepSeek Harness (DSH)。由用户 bettermen 维护，采用 MIT 许可证。
其核心价值在于将创作过程结构化：通过首页统一管理项目，配合可编辑的工作流与门禁机制，确保内容按步骤推进；同时利用知识图谱与资料库固化知识点，支持导出与协作。
核心功能¶
插件提供以下核心能力：
-
首页项目管理
- 支持卡片与列表双视图，展示类型、状态、进度与字数。
- 提供筛选（类型、状态、关键词）、排序（时间、名称等）功能。
- 支持新建、编辑、复制、归档及删除项目。
-
多类型支持与可编辑工作流
- 内置四种类型：课程（九阶段）、公文（七阶段）、小说（九阶段）、论文（八阶段）。
- 支持用户自定义类型。
- 工作流支持拖拽排序、增删阶段、修改门禁与提示词，并提供模板管理。
-
三栏式工作台
- 左栏：章节列表（支持拖拽排序）、阶段门禁导航、流程编辑器。
- 中栏：Markdown 编辑器（支持自动保存、代码高亮、格式化工具栏）。
- 右栏：资料库（知识点管理）与知识图谱（可视化关联）。
-
门禁式编写流程
- 前一阶段未批准无法进入下一阶段。
- 每次提交留档，支持回退与审计日志。
-
资料库与知识图谱
- 资料库按项目隔离，支持知识点的新增、编辑、停用与删除。
- 知识图谱可视化节点关系，支持防重叠布局。
-
协作与导出
- 支持生成只读或可编辑的分享链接（带 Token 鉴权），支持多人协作与冲突检测。
- 支持导出为 TXT 或 Word (.docx) 格式。
安装与启用¶
安装前需确保已安装 DeepSeek Harness（DSH），且运行环境 Node 版本 ≥ 18。
数据仅存储在本地，不上传云端。
- 下载插件文件（通常为
.tgz包）。 - 在终端执行安装命令：
dsh plugin --profile web add <该文件路径>
- 执行
dsh plugin list确认插件已在列表中。 - 刷新 DSH 页面（Ctrl+Shift+R），侧边栏将出现「虾说」入口。
典型用法¶
- 创建项目：打开「虾说」首页，点击「＋ 新建项目」，选择类型（如课程）与题材，填写简介。
- 编写内容：进入项目工作台，左栏切换章节，中栏撰写 Markdown 正文（停止输入 2 秒自动保存）。
- 管理流程：在左栏「流程」页调整阶段顺序或编辑门禁条件。
- 管理知识：在右栏「资料库」录入知识点，在「知识图谱」中查看结构。
- 导出与协作：顶部点击「导出」下载文档，或「分享」生成协作链接。
注意事项¶
- 数据路径：所有数据保存在本地
~/.dsh/xiashuo/，包含projects、lorebook、templates等目录。 - 分享安全：分享链接走独立
/share/公开路径，配合 Token 鉴权，不暴露管理凭据。 - 许可证：采用 MIT 许可证，开源使用。
目录¶
链接¶
- 插件目录：https://www.skillhub.cn/plugins/bettermen/xiashuo
- GitHub 仓库：https://github.com/bettermen/xiashuo
