dsh-personal-os
v0.1.0
Published
A local-first personal context layer for DeepSeek Harness
Readme
dsh-personal-os
dsh-personal-os 是嵌入 DeepSeek Harness 的本地优先 Personal Context 层。它让用户拥有可直接读取的 Markdown 数据,并逐步通过 DSH Agent 管理 Knowledge、Todo、Project、Capture 与它们的 Derived View。
V0.1 已实现完整纵向切片:Today、Inbox、Knowledge、Todo、Projects、Timeline、Calendar、全局搜索、显式关系图谱和 Inspector;DSH Agent 通过同一 Domain Service 检索与维护这些内容,并在完整任务完成后生成可审阅的 Task Outcome。
V0.1 能力
- Markdown 是唯一真源;启动全量重建、运行时文件监听和 revision-aware 原子保存不依赖 SQLite。
- Capture、Knowledge、Todo、Project 使用稳定 ID 和可编辑模板,Archive 可恢复,Relation 只保存显式边。
- Today、Calendar、Timeline、Search、Project Progress 和 Graph 都是可删除、可重建的派生视图。
- Task Outcome Curation 以完整任务为边界,而不是以一轮对话为边界。“谨慎”模式在任务完成后生成待确认提案,“主动”模式只自动应用高置信度结果,“关闭”模式只响应显式整理。提交、推送、重试和澄清会并入同一任务;自动整理只保存结构化结果与 Session/Task/seq provenance,不复制原始日志,也绝不会自动把低置信度内容写成 Inbox Capture。
- Today 的“继续进行”展示 active、等待回复和阻塞任务,并说明任务边界与状态判断依据;用户可以回到原会话,或在尚未应用结果时保守地拆分、合并任务边界。会话输入区显示 Agent 实际读取过以及 Outcome 准备更新的 Personal Context。
- Version History 默认关闭;启用后仅使用本地 Git checkpoint 与新增 revert commit,不操作远端或分支。
- Vault Import 默认先预检再复制,保留源目录、未知 Frontmatter、Wiki Link、checkbox 和附件。
从源码安装
pnpm install --frozen-lockfile
pnpm build
npx @deepseek-ai/dsh plugin --profile web add "$PWD"
npx @deepseek-ai/dsh web插件通过自己的 dsh.bundle.patch 接管 Sidebar,不需要也不应该手工修改 Harness profile 配置。
卸载
npx @deepseek-ai/dsh plugin --profile web remove dsh-personal-os安装、移除或更新 Bundle Patch 后请重启对应 DSH profile。
数据边界
- Personal Data Directory 由用户首次启动时选择,并在所有 DSH Workspaces 之间共享。
- 插件配置只记录该目录位置;后续 Domain Fact 将以普通 Markdown 保存在用户选择的目录。
- DSH 的 Session、权限、模型、Workspace、Settings 和 Agent Runtime 继续由 DSH 本身管理。
开发验证
pnpm check该命令运行类型检查、Vitest 测试和 Host/Client 生产构建。打包契约还会用真实 npm tarball 验证运行时入口。
