better-session

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

项目

包按 packages/<family>/<pkg> 两层存放，family 即上下文分组；术语表与归属见 .agents/CONTEXT-MAP.md。

包	职责	文档
session（会话编辑）
session/better-session/	聚合层：profile bundle（安装 / 使用 / 配置）	README
session/session-branch/	契约层：分支 provider 抽象 + 版本树投影	README · 词汇
session/session-rdb/	实现层：RDB 持久化 + 分支 provider + storages / 查询接管	README · design
session/ui-conversation-message-actions/	编排层：edit / retry / recall / fork 编排 + client UI 替换	README
session/ui-conversation/ · ui-chat/ · ui-input-trigger/	上游对话 UI 的 fork（host 半 + client 半，整包逐字复制）	债务 0001
session/dsh-reference-injection/	skill 引用后注入（skill:name → <skill_content>）	README
client（浏览器半基础）
client/ui-primitives/	CSS-in-JS 样式层 + 引用统一解析 / 渲染转换	README · ADR-0001
llm（LLM 适配）
llm/llm-openai-compatible/	OpenAI-compatible 多 provider 路由（可选组件）	README · 词汇
preset（profile 预设）
preset/dsh-preset/	个人 profile bundle：生成标准 / ptc preset、声明 pi-ai 路由、沙箱规则	README
preset/dsh-prompt-reminder/	精简 system prompt 被裁掉的小节降级为 <system-reminder> 用户消息	README
sandbox（沙箱替换）
sandbox/dsh-sandbox-local/	额外可写根 + 拒绝项（替换 ctx.sandbox / ctx.fs）	README
desktop（桌面化）
desktop/dsh-desktopify/	桌面化打包工具（dsh-desktopify CLI：dev / bundle）	README
workspace（非发布）
apps/dsh-custom-next/	示例工作区：web 模式（dsh web）与 desktop 模式（Electron 壳）	justfile · just custom desktop
devpackages/devkit/	共享开发配置：cordis 插件 tsdown 预设 + tsconfig（packages/*/* 复用）	tsconfig
vendor/	上游 deepseek-harness side workspace（同步 / 裁剪 / 构建）	dsh-plugin-upstream-sync skill

文档

文档	内容
.agents/README.md	记录树布局与编号 / 引用规则
.agents/CONTEXT-MAP.md	上下文边界与全部包的归属
.agents/CONTEXT.md	会话编辑（跨包词汇）
.agents/standards/	规范（如何写 / 如何验证）
.agents/designs/0001-系统设计.md	整体设计（布局 / 分层 / 装配 / 操作语义）
.agents/adrs/	仓库级决策（上游 vendor 策略、workspace 链接、桌面化）
.agents/debts/	技术债登记（上游对话 UI 接管等临时偏离与回退条件）
AGENTS.md	agent 工作指引（home 表 + 红线）
justfile · mise.toml	常用命令 · 技术栈与上游版本

决策（ADR）按层存放：仓库级 .agents/adrs/（上游 side workspace 版本锁定、workspace 跨 vendor 链接与 devkit、桌面化迁移），包层 packages/<family>/<pkg>/.agents/adrs/（契约 / 编排 / 实现 / 客户端基础 / 沙箱决策；装配决策在 packages/session/better-session/.agents/adrs/）。 编号在各层内唯一，跨层引用一律给相对链接（规则见 .agents/README.md）。