知域 bloodarea/dsh-knowspace

dsh-knowspace

面向智能体、本地优先的知识基础设施，为 DeepSeekHarness 而生。

状态：开发中 · 公开占位 · 尚无公开 alpha 版本 README 最近更新：2026 年 10 月 12 日。开发在私有仓库中继续。这个公开仓库目前只作为项目官网落地页，不提供可安装的插件，也不提供可公开审计的源代码。

dsh-knowspace 的目标是让个人知识既能被人使用，也能被获得授权的 AI 智能体使用，同时不让云服务、向量数据库或常驻 AI 进程成为这些知识的主人。它按 DeepSeekHarness 插件来设计，而不是独立的 knowledge server。

长期目标是打下一套共享底座，覆盖笔记、检索、渲染与交互，供其他智能体、技能、脚本和领域专用插件复用。

为什么需要 KnowSpace？

多数 AI 工作流把知识当作一次性的聊天上下文，或者外部检索服务。KnowSpace 换了一条路：

- 你的文件就是唯一事实来源。 Markdown 笔记和图片始终是普通、可迁移的本地资产。
- 智能体在权限内工作。 访问范围由工作区和用户策略划定；知识不会被悄悄暴露给每个智能体。
- 离线优先。 阅读、编辑和基础检索都应该在无网络时可用。
- 同步是可选项。 WebDAV 端点可以在设备之间交换受支持的知识资产，无需另建 KnowSpace 服务。
- 交互内容是可复用的基础设施。 数学渲染、图表、临时页面、输入收集都属于通用能力，不该让每个技能各自重造一遍。

设计原则： 你的知识，你做主。AI 的参与应当明确、有边界、可审查。

项目状态

私有项目的进度记录里，前五轮内部开发已标记为结束。这不等于完成了公开发布验收。 部分实现结果已在内部报告，而重要的安全、同步与端到端检查仍在验收计划之内。

| 领域 | 当前说明 | 公开可用性 |
| DeepSeekHarness Host/Client 集成与侧边栏 | 私有开发记录中已实现；兼容性对版本敏感 | 未发布 |
| 本地工作区、Markdown、JPG/PNG 资产、基础检索 | 已实现/内部报告；仍需回归检查 | 未发布 |
| 智能体知识工具、编辑与变更预览 | 已实现/内部报告；端到端网关检查单独跟踪 | 未发布 |
| Markdown 与数学记号 | 已有私有实现与测试历史；以维护为主，不重写 | 未发布 |
| WebDAV 双向同步 | 已在内部设计和开发；跨设备、冲突、数据安全方面的证据必须通过发布门禁 | 未发布 |
| 交互式 HTML、绘图输入、提交桥接 | 部分实现或已规划；安全沙箱和真实 UI 流程尚未完全验收 | 未发布 |
| 可编辑知识图谱和高级本地检索 | 架构决策已定；集成和验收待完成 | 未发布 |

目前尚未发布任何安装说明。 首个可用 alpha 版本发布时，会一并提供锁定版本、可复现的安装流程和兼容性矩阵。请不要把开发设计或示例工具名当作受支持的公开 API。

产品能力与方向

1. 知识：工作区、文件与可选同步

两种预期的工作区模式各自职责分明：

| 工作区 | 行为 |
| 本地 | 独立的知识工作区，存放在当前设备上；永不自动同步。 |
| 同步 | 完整的本地工作副本，联网时可选进行双向 WebDAV 同步。 |

Markdown 是主要的可移植知识格式。默认同步允许列表为 .md、.jpg 和 .png；PDF、视频、音频、3D 文件、可执行内容以及原生图表源文件不会作为原始文件自动上传。富媒体可以保留在本地。从富媒体显式派生出的 Markdown 文档是独立的知识资产，不是其来源的持续附加副本。

设计优先考虑变更历史、可理解的差异、碰撞保护、非破坏性冲突处理和恢复，而不是静默覆盖。

2. 检索：本地优先的搜索与证据

KnowSpace 从工作区感知的文本检索起步。计划中的搜索改进借鉴了 Greb 风格候选检索与排序的思路，但不使用云端 Greb API，也不强制依赖任何第三方 MCP 服务。

预期的检索路径是：

Authorized workspaces
Local text / file candidates
Filtering + ranking / optional fusion
Traceable source passages
Agent answer or user-facing search result

兼容时，可以使用 ripgrep 或 SQLite FTS5 等可选的本地加速器。进程内扫描仍是兜底方案。嵌入和重排序是后续的可选扩展，不是构建实用知识库的前提。

3. 渲染：Markdown、数学与安全预览

共享渲染层预期支持：

- Markdown 笔记、表格、代码块和图片引用。
- LaTeX 风格的数学表达式和适合数学的学习材料。
- 对知识内容和工具结果进行安全、有边界的预览。
- 临时交互式产物，前提是 Host 能强制执行隔离、权限和资源限制。
不可信的 HTML/JavaScript 不能仅仅因为显示在笔记或预览里，就拿到 Host、文件系统或智能体权限。交互式执行与 Markdown 渲染分开管控。

4. 交互：智能体到用户的工作流

除了静态阅读，KnowSpace 还在设计支持智能体显式创建的交互流程：向用户展示临时页面或表单，用户提交结构化输入或图片，获得授权的智能体通过受控桥接收到结果。

例子包括手写数学答案、学习练习、研究评审表单，以及技能生成的视觉工具。这些只是可复用基础设施的示例，并不承诺核心插件里包含完整的考试平台或研究产品。

5. 知识图表：可编辑图表，而非图像生成

规划中的图表能力会把流程图、思维导图、系统架构图表示为可编辑的矢量/结构化资产，而不是依赖照片级图像生成模型。

选定的做法是，从 fourzkw/dsh-drawai 有选择地改编合适的 .drawio 解析、模型与布局概念/代码，前提是通过固定来源与许可证审查。Host 授权、工作区处理、智能体工具仍归 KnowSpace 所有。原生可编辑 .drawio 源文件默认仅本地保存；显式导出的 .png 可以作为独立知识资产，按常规同步策略存储。

这套图表集成已经完成设计，尚未发布。

目标架构

DeepSeekHarness
|-- Sidebar / knowledge UI
|-- Agent tools (scoped operations)
|-- Skills and other plugins
-- dsh-knowspace plugin
|-- Knowledge Core: workspaces / assets / changes / access
|-- Retrieval Core: local search / source evidence
|-- Rendering Core: Markdown / math / safe previews
|-- Interaction Core: temporary artifacts / user submissions
|-- Diagram capability: editable structured assets (planned)
|-- Local filesystem and indexes
-- Optional WebDAV synchronization (allowlisted files)

No dedicated KnowSpace server or mandatory cloud vector database.

这张图描述的是目标架构，并不表示每个组件都已完工或发布。

隐私与安全边界

- 浏览、索引、同步期间，不做静默的模型调用、笔记摘要或行为画像。
- 智能体可读的工作区范围，与私有工作区或明确拒绝智能体访问的工作区相互区分。
- 智能体写入与交互提交必须绑定有效授权；未知操作者身份不得变成宽松访问。
- 文件变更、冲突与失败状态应当可检查、可恢复。
- 同步不得静默上传仅本地保存的源媒体、.drawio 或任意可执行文件。
- 新的检索与图表集成，未经明确评审和迁移测试，不得替换既有的存储/同步协议。

这些是设计与发布要求。不应把它们解读为「每个安全场景都已通过独立审计」的声明。

路线图

这份清单是面向公众的路线图，不是内部验收结果的逐条复制。

- [ ] 发布可审计的 alpha 版本、安装步骤，以及 DeepSeekHarness 兼容性矩阵。
- [ ] 完成并发布 Host/API 安全与真实智能体集成验收。
- [ ] 完成可复现的多设备 WebDAV、冲突、删除与恢复验收。
- [ ] 敲定安全的临时产物、手写与交互提交流程。
- [ ] 集成并验证可编辑知识图表，源码仅本地处理。
- [ ] 验证离线检索改进，带来源引用与权限安全的回退方案。
- [ ] 发布扩展点、第三方致谢、数据迁移/回滚文档。

内部开发工作按轮次组织。第 1–5 轮已记录为关闭；第 6 轮从技术债评审、上游/许可证检查、隔离的概念验证开始，之后新的集成才算完成。

与其他项目的关系

KnowSpace 与 dsh-agent-team-presets 互补，但不依赖它；后者管理可复用的 Agent Team 配置。团队决定谁来做这件事；KnowSpace 想提供的是这些被授权的智能体能读、能改、能检索、能呈现哪些知识。

本项目借鉴了 DeepSeekHarness 生态内外的公开研究与软件。当前的实现选择区分了使用依赖、有选择地改写源码和独立实现某个想法。在这里提到某个项目，并不表示其源码已被引入。

相关参考包括 DeepSeekHarness、dsh-drawai、ripgrep、SQLite FTS5、markdown-it 和 KaTeX。实际再分发的第三方源码（如有）需要具体的许可证与署名声明。

反馈与贡献

本仓库目前是项目占位。欢迎提交关于设计、可复现安全测试、与 DeepSeekHarness 的兼容性，以及实用知识管理工作流的问题。等 alpha 代码公开后，源码级 pull request 和安装支持会更有意义。

请不要在公开 issue 里贴出凭据、私人笔记、含密钥的 WebDAV 端点，或机密的智能体日志。

许可证

源码发布前另行确定。 这份公开 README 的存在，并不代表私有实现获得了开源许可。第三方组件保留各自的许可证；任何源码复用都会在分发前经过审查并注明出处。

项目： bloodarea/dsh-knowspace 维护者： bloodarea 状态： 私有开发进行中 · 公开占位 · 尚无公开 alpha 版