better-session

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

项目

项目	职责	文档
`packages/better-session/`	profile 聚合 bundle（安装 / 使用 / 配置）	README
`packages/session-branch/`	契约层：`SessionBranchProvider` 抽象 + `SessionBranch` 服务 + 版本树投影	README
`packages/session-rdb/`	实现层：RDB 持久化（`PersistenceBackend`）+ 分支 provider（`SessionBranchProvider`）双服务	README · design
`packages/ui-conversation-message-actions/`	编排层 + UI：edit / retry / fork 编排 + `conversation.chat.node` 渲染替换	README
`packages/llm-openai-compatible/`	LLM 适配层：OpenAI-compatible 多 provider 路由（可选组件）	README
`apps/dsh-custom/`	本地 GUI 应用壳（dsh-web-desktopify）	`just custom::dev` / `just custom::bundle`
`vendor/`	上游 deepseek-harness side workspace（同步 / 裁剪 / 构建）	dsh-side-workspace-plugin-develop skill

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

Name		Name	Last commit message	Last commit date
.agents/skills/dsh-side-workspace-plugin-develop		.agents/skills/dsh-side-workspace-plugin-develop
.github/workflows		.github/workflows
apps/dsh-custom		apps/dsh-custom
devpackages/devkit		devpackages/devkit
docs		docs
packages		packages
patches		patches
scripts		scripts
vendor		vendor
.gitignore		.gitignore
.npmrc		.npmrc
.oxfmtrc.json		.oxfmtrc.json
.oxlintrc.json		.oxlintrc.json
AGENTS.md		AGENTS.md
CONTEXT-MAP.md		CONTEXT-MAP.md
LICENSE		LICENSE
README.md		README.md
justfile		justfile
mise.toml		mise.toml
package.json		package.json
pnpm-lock.yaml		pnpm-lock.yaml
pnpm-workspace.yaml		pnpm-workspace.yaml
tsconfig.json		tsconfig.json
vitest.config.ts		vitest.config.ts