Metadata-Version: 2.4
Name: openvfs
Version: 0.1.0
Summary: Agent 专用 Markdown 文件系统，基于火山云 TOS 存储
Project-URL: Homepage, https://github.com/your-username/openvfs
Project-URL: Documentation, https://github.com/your-username/openvfs/blob/main/docs/USAGE.md
Project-URL: Repository, https://github.com/your-username/openvfs
Author: OpenVFS Contributors
License-Expression: MIT
License-File: LICENSE
Keywords: agent,markdown,storage,tos,vfs,volcengine
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.10
Requires-Dist: tos>=2.6.0
Provides-Extra: dev
Requires-Dist: pytest>=9.0.2; extra == 'dev'
Requires-Dist: pythest>=0.1.1; extra == 'dev'
Description-Content-Type: text/markdown

# OpenVFS

Agent 专用 Markdown 文件系统，基于火山云 TOS 存储。支持按字段/值快速定位段落，类似数据库按字段查询。

## 安装

```bash
pip install openvfs
```

## 配置

环境变量或项目根目录 `.env`：

```bash
TOS_ACCESS_KEY=your-access-key-id
TOS_SECRET_KEY=your-secret-access-key
```

## 快速示例

**链式 API（推荐）**：

```python
from openvfs import MindMarkClient

client = MindMarkClient()

# 创建资源路径 → 文档 → 标题 → 内容块（支持 text/code/json/link）→ 写入
(client
  .path("resources", "project")
  .doc("readme.md")
  .heading("安装", level=2, id="install")
  .block("pip install openvfs", type="code", lang="bash")
  .heading("链接", level=2)
  .link("https://example.com", "示例")
  .write())

# 按属性获取
content = client.path("resources", "project").doc("readme.md").get_block(id="install")
```

**传统 API**：`create` / `read` / `set_section_by_id` / `get_section_by_id` 等，见 [使用说明](docs/USAGE.md)。

## 文档

- **[使用说明 (docs/USAGE.md)](docs/USAGE.md)**：完整 API 与用法
- [设计方案 (docs/DESIGN.md)](docs/DESIGN.md)：架构与设计
- [发布到 PyPI (docs/PUBLISHING.md)](docs/PUBLISHING.md)：构建与上传说明

## URI 规范

- 格式：`openvfs://{namespace}/{path}`
- 命名空间：`resources`、`user`、`agent`
- 示例：`openvfs://resources/my_project/docs/api.md`
