docs: clarify source viewing and host interaction boundaries
This commit is contained in:
@@ -1,4 +1,5 @@
|
||||
//! 云文件浏览的 provider 抽象与工作区状态。默认 provider 未连接,不假装已有外部文件。
|
||||
//! 当前源码仅定义注入接口,没有具体 CloudSourceProvider 实现或启动时安装逻辑。
|
||||
//! 列出和打开文件的结果作为工具数据展示,错误保持在当前工具状态中供界面说明。
|
||||
//!
|
||||
//! Cloud source integration seam. The host installs a provider when one exists;
|
||||
@@ -25,13 +26,13 @@ pub struct OpenedSource {
|
||||
/// 外部文件能力接口;只负责列出和读取,不与 VM 全局环境耦合。
|
||||
// 由宿主注入具体实现;Send 允许转移线程,但方法使用 &mut self,不声明可并行共享调用。
|
||||
pub trait CloudSourceProvider: std::fmt::Debug + Send {
|
||||
/// 返回 provider 当前可列出的文件;未连接状态由 SourceWorkspace 的 Option 表达。
|
||||
/// SourceWorkspace::refresh 同步调用,返回文件元数据;这里只声明接口,不规定网络协议或缓存策略。
|
||||
fn list_files(&mut self) -> Result<Vec<SourceFile>>;
|
||||
/// 通过 provider 取得指定文件内容,不在工具查看动作中执行该内容。
|
||||
/// SourceWorkspace::open 同步调用,按不透明 ID 读取完整文本;读取结果不进入 VM 执行队列。
|
||||
fn open_file(&mut self, id: &str) -> Result<OpenedSource>;
|
||||
}
|
||||
#[derive(Debug, Default)]
|
||||
/// Sources 云文件页面保留的 provider、列表、选择、内容与错误状态。
|
||||
/// Sources 云文件页面保留的 provider、列表、已打开内容与错误状态;不另存列表选中 ID。
|
||||
pub struct SourceWorkspace {
|
||||
// None 表示未接入外部文件服务;默认工作区不提供虚构文件或隐式认证。
|
||||
pub provider: Option<Box<dyn CloudSourceProvider>>,
|
||||
|
||||
Reference in New Issue
Block a user