morlay/better-session

better-session

better session

待分类sessionsession-branchsession-persistence

better-session

DeepSeek Harness 的分支式会话编辑 monorepo:在不修改上游 @deepseek-ai/* 代码的前提下,为会话提供 就地编辑 / 重试 / 分支 (rewind / retry / fork)闭环。本文件只是索引,详细内容见各项目文档。

项目

项目职责文档
packages/better-session/聚合层:profile bundle(安装 / 使用 / 配置)README
packages/session-branch/契约层:分支 provider 抽象 + 版本树投影README
packages/session-rdb/实现层:RDB 持久化 + 分支 provider 双服务README · design
packages/ui-conversation-message-actions/编排层:edit / retry / fork 编排 + client UI 替换README
packages/llm-openai-compatible/LLM 适配层:OpenAI-compatible 多 provider 路由(可选组件)README
packages/sandbox/dsh-sandbox-local/沙箱替换层:额外可写根 + 拒绝项(替换 ctx.sandbox / ctx.fs)README
apps/dsh-custom-next/示例工作区:web 模式(dsh web)与 desktop 模式(Electron 壳)justfile · just custom desktop
devpackages/devkit/共享开发配置:cordis 插件 tsdown 预设 + tsconfig(packages/* 复用)tsconfig
packages/dsh-desktopify/桌面化打包工具(dsh-desktopify CLI:dev / bundle / prepare:*)README
vendor/上游 deepseek-harness side workspace(同步 / 裁剪 / 构建)dsh-side-workspace-plugin-develop skill

文档

文档内容
CONTEXT-MAP.md领域模型映射(术语表真源:会话编辑 / LLM 适配)
docs/ARCHITECTURE.md整体架构(布局 / 分层 / 核心设计 / 装配)
docs/CODING_GUIDELINE.md项目约定(命令 / 代码 / 测试 / 发布)
AGENTS.mdagent 工作指引(索引)
justfile · mise.toml常用命令 · 技术栈与上游版本

决策(ADR)分三级存放:仓库级 docs/adr/(上游 vendor 策略)、 上下文级 packages/<pkg>/docs/adr/(契约 / 编排 / 实现决策)、装配级 packages/better-session/docs/adr/。