workspace

package
v0.1.0 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Nov 9, 2026 License: MIT Imports: 8 Imported by: 0

Documentation

Overview

path.go 复刻官方 util/workspace-path 的路径辅助:相对路径拼到工作区根、home 目录缩写为 ~、以及取路径最后一段用于显示。

Package workspace 提供工作区注册表(任务 S14:Workspace Registry)。

对齐上游:packages/core/workspace

设计要点:

  • Workspace 记录一条工作区信息:{ID / Root / SessionGroup / ResumeOnOpen};
  • 通过 storage.Domain(Storage Domain KV 抽象,M45)持久化,key=工作区 ID;
  • ID 是「确定性」的:由规范化后的根路径经 sha256 派生而来,因此**同一 root 路径创建两次会返回同一 ID**(幂等),满足验收"相同 root 返回同一 id";
  • ResumeOnOpen 记录该工作区下次默认打开的会话(resume-on-open 语义);
  • 全部写操作走 CAS,调用方拿到 version 后可做并发保护。

Index

Constants

This section is empty.

Variables

This section is empty.

Functions

func AbbreviateHome

func AbbreviateHome(path, home string) string

AbbreviateHome 把 home 及其子路径中的 home 前缀缩写为 ~;非 home 下原样返回。

func ResolvePath

func ResolvePath(root, path string) string

ResolvePath 把相对 path 拼到工作区 root;绝对路径原样返回。root 为空时原样返回。 同时识别 POSIX(/ 开头)、Windows(盘符或 UNC)绝对路径,保证跨平台。

func TitleOf

func TitleOf(path string) string

TitleOf 取路径最后一段用于显示。

Types

type Registry

type Registry struct {
	// contains filtered or unexported fields
}

Registry 是工作区注册表(基于 storage.Domain,线程安全由后端保证)。

func New

func New(backend storage.Backend) *Registry

New 创建工作区注册表,挂载到指定 KV 后端。

func (*Registry) ClearResumeOnOpen

func (r *Registry) ClearResumeOnOpen(ctx context.Context, id brand.WorkspaceID) (uint64, error)

ClearResumeOnOpen 清除 resume-on-open 记录。

func (*Registry) Create

func (r *Registry) Create(ctx context.Context, root string) (brand.WorkspaceID, uint64, error)

Create 登记(或复用)一个工作区。相同 root 返回同一 ID。 返回 version(CAS 版本)与是否新建。

func (*Registry) Get

Get 按 ID 读取工作区。不存在返回 ErrKeyNotFound 包装错误。

func (*Registry) List

func (r *Registry) List(ctx context.Context) ([]Workspace, error)

List 返回全部工作区(按 ID 字典序,确定性)。

func (*Registry) SetResumeOnOpen

func (r *Registry) SetResumeOnOpen(ctx context.Context, id brand.WorkspaceID, sid brand.SessionID) (uint64, error)

SetResumeOnOpen 记录该工作区默认打开的会话(resume-on-open)。

func (*Registry) SetSessionGroup

func (r *Registry) SetSessionGroup(ctx context.Context, id brand.WorkspaceID, group string) (uint64, error)

SetSessionGroup 设置工作区会话分组(整体替换当前分组)。

type Workspace

type Workspace struct {
	ID           brand.WorkspaceID `json:"id"`
	Root         string            `json:"root"`                   // 规范化绝对路径
	SessionGroup string            `json:"sessionGroup,omitempty"` // 会话分组标识(可选)
	ResumeOnOpen *brand.SessionID  `json:"resumeOnOpen,omitempty"` // 下次默认打开的会话(nil=不恢复)
}

Workspace 是一条工作区记录。

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL