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 ¶
- func AbbreviateHome(path, home string) string
- func ResolvePath(root, path string) string
- func TitleOf(path string) string
- type Registry
- func (r *Registry) ClearResumeOnOpen(ctx context.Context, id brand.WorkspaceID) (uint64, error)
- func (r *Registry) Create(ctx context.Context, root string) (brand.WorkspaceID, uint64, error)
- func (r *Registry) Get(ctx context.Context, id brand.WorkspaceID) (Workspace, uint64, error)
- func (r *Registry) List(ctx context.Context) ([]Workspace, error)
- func (r *Registry) SetResumeOnOpen(ctx context.Context, id brand.WorkspaceID, sid brand.SessionID) (uint64, error)
- func (r *Registry) SetSessionGroup(ctx context.Context, id brand.WorkspaceID, group string) (uint64, error)
- type Workspace
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
func AbbreviateHome ¶
AbbreviateHome 把 home 及其子路径中的 home 前缀缩写为 ~;非 home 下原样返回。
func ResolvePath ¶
ResolvePath 把相对 path 拼到工作区 root;绝对路径原样返回。root 为空时原样返回。 同时识别 POSIX(/ 开头)、Windows(盘符或 UNC)绝对路径,保证跨平台。
Types ¶
type Registry ¶
type Registry struct {
// contains filtered or unexported fields
}
Registry 是工作区注册表(基于 storage.Domain,线程安全由后端保证)。
func (*Registry) ClearResumeOnOpen ¶
ClearResumeOnOpen 清除 resume-on-open 记录。
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 设置工作区会话分组(整体替换当前分组)。
Click to show internal directories.
Click to hide internal directories.