初始化项目，由ModelHub XC社区提供模型

Model: brady777/surfdoc-8b-v1
Source: Original Platform

README.md

@@ -0,0 +1,74 @@
+---
+language:
+- en
+license: apache-2.0
+library_name: transformers
+tags:
+- surfdoc
+- qwen3
+- text-generation
+- fine-tuned
+pipeline_tag: text-generation
+base_model: Qwen/Qwen3-8B
+model-index:
+- name: surfdoc-8b-v1
+  results: []
+---
+
+# SurfDoc AI (surfdoc:8b v1)
+
+Fine-tuned Qwen3-8B for generating structurally valid SurfDoc (.surf) documents.
+
+## Model Details
+
+- **Base model**: Qwen/Qwen3-8B
+- **Method**: QLoRA (rank 32, 87M trainable params, 1.05% of model)
+- **Training data**: 9,241 instruction-output pairs from 26 CloudSurf repositories
+- **Training hardware**: NVIDIA GB10 (Blackwell), 128GB unified memory
+- **Training time**: 5.7 hours (235 steps, Flash Attention 2 enabled)
+- **Framework**: Unsloth 2026.3.4 + PyTorch 2.10 + CUDA 12.8
+
+## What it generates
+
+Valid SurfDoc documents with:
+- YAML frontmatter (title, type, version, status, tags)
+- Typed block directives (::summary, ::callout, ::data, ::action-items)
+- Markdown headings and structured content
+- Correct formatting and syntax
+
+## Usage
+
+```python
+from transformers import AutoModelForCausalLM, AutoTokenizer
+
+model = AutoModelForCausalLM.from_pretrained("brady777/surfdoc-8b-v1")
+tokenizer = AutoTokenizer.from_pretrained("brady777/surfdoc-8b-v1")
+
+messages = [
+    {"role": "system", "content": "You are SurfDoc AI. Generate valid SurfDoc documents."},
+    {"role": "user", "content": "Create a SurfDoc plan about improving website performance"},
+]
+inputs = tokenizer.apply_chat_template(messages, return_tensors="pt", add_generation_prompt=True)
+outputs = model.generate(inputs.input_ids, max_new_tokens=512, temperature=0.7)
+print(tokenizer.decode(outputs[0][inputs.input_ids.shape[-1]:], skip_special_tokens=True))
+```
+
+## Evaluation
+
+Evaluated on 20 diverse SurfDoc generation prompts:
+- Average score: 79%
+- Has title: 70% | Has type: 60% | Has headings: 75%
+- Uses blocks: 55% | Blocks closed: 100%
+- No repetition: 95% | Good length: 100%
+
+## Note
+
+Qwen3 is a reasoning model — outputs include `<think>` tags before the actual response. Strip these before display:
+```python
+import re
+response = re.sub(r'<think>.*?</think>', '', response, flags=re.DOTALL).strip()
+```
+
+## Built by
+
+[CloudSurf Software LLC](https://cloudsurf.com)