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.md | agent 工作指引（索引） | | justfile · mise.toml | 常用命令 · 技术栈与上游版本 |

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