READMESource: main@5984e927
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 |
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/。
No comments yet. Be the first to write one.