开发作文素材积累工具，按主题（亲情/励志/环保），分类存储素材，名言，案例，支持搜索，一键插入作文，提升作文质量。
1. 实际应用场景描述
在语文学习、写作训练、考试备考中，学生和老师都需要积累大量优质作文素材，包括：
- 亲情类：感人故事、名言警句。
- 励志类：名人经历、励志金句。
- 环保类：生态保护案例、相关法规、环保口号。
这些素材如果分散在书本、笔记、网页中，查找和引用会非常低效，影响写作质量与速度。
本工具旨在提供一个按主题分类、可搜索、可一键插入的素材管理平台，帮助学生快速找到合适素材，提升作文水平。
2. 痛点分析
1. 素材分散：书本、笔记、网络资源难以集中管理。
2. 查找困难：写作时临时翻找素材浪费时间。
3. 引用不便：素材格式不统一，插入作文时需手动调整。
4. 缺乏分类：不同主题的素材混在一起，影响灵感触发。
3. 核心逻辑讲解
1. 数据结构：每个素材包含主题、类型（名言/案例）、内容、来源、标签。
2. 存储方式：使用 JSON 文件持久化存储，便于备份与迁移。
3. 分类管理：按主题（亲情/励志/环保）建立分类目录。
4. 搜索功能：支持按主题、类型、关键词搜索。
5. 一键插入：将选中的素材以标准格式输出，可直接复制到作文中。
6. 模块化设计：
-
"material.py"：素材数据模型
-
"storage.py"：存储与读取 JSON
-
"manager.py"：增删改查与搜索
-
"cli.py"：命令行交互界面
4. 模块化代码（含详细注释）
4.1 material.py
class Material:
"""作文素材类"""
def __init__(self, theme, mtype, content, source="", tags=None):
"""
:param theme: 主题（亲情/励志/环保）
:param mtype: 类型（名言/案例）
:param content: 素材内容
:param source: 来源（作者/出处）
:param tags: 标签列表
"""
self.theme = theme
self.mtype = mtype
self.content = content
self.source = source
self.tags = tags or []
def to_dict(self):
"""转换为字典（用于序列化）"""
return {
"theme": self.theme,
"type": self.mtype,
"content": self.content,
"source": self.source,
"tags": self.tags
}
@staticmethod
def from_dict(data):
"""从字典恢复对象"""
return Material(
data["theme"],
data["type"],
data["content"],
data.get("source", ""),
data.get("tags", [])
)
4.2 storage.py
import json
import os
class Storage:
"""素材存储管理"""
def __init__(self, filepath="materials.json"):
self.filepath = filepath
def load(self):
"""加载素材列表"""
if not os.path.exists(self.filepath):
return []
with open(self.filepath, "r", encoding="utf-8") as f:
data = json.load(f)
return [Material.from_dict(item) for item in data]
def save(self, materials):
"""保存素材列表"""
with open(self.filepath, "w", encoding="utf-8") as f:
json.dump([m.to_dict() for m in materials], f, ensure_ascii=False, indent=2)
4.3 manager.py
from storage import Storage
from material import Material
class Manager:
"""素材管理器"""
def __init__(self):
self.storage = Storage()
self.materials = self.storage.load()
def add(self, theme, mtype, content, source="", tags=None):
"""添加素材"""
mat = Material(theme, mtype, content, source, tags)
self.materials.append(mat)
self.storage.save(self.materials)
print("素材添加成功")
def list_by_theme(self, theme):
"""按主题列出素材"""
return [m for m in self.materials if m.theme == theme]
def search(self, keyword):
"""按关键词搜索（内容、来源、标签）"""
result = []
for m in self.materials:
if keyword in m.content or keyword in m.source or any(keyword in tag for tag in m.tags):
result.append(m)
return result
def insert(self, index):
"""一键插入素材（返回格式化字符串）"""
if 0 <= index < len(self.materials):
m = self.materials[index]
text = f"【{m.theme}】【{m.mtype}】{m.content} —— {m.source}"
return text
return "素材索引无效"
4.4 cli.py
from manager import Manager
def main():
manager = Manager()
while True:
print("\n1. 添加素材 2. 按主题列出 3. 搜索 4. 一键插入 5. 退出")
choice = input("选择操作: ").strip()
if choice == "1":
theme = input("主题(亲情/励志/环保): ")
mtype = input("类型(名言/案例): ")
content = input("内容: ")
source = input("来源(可选): ")
tags = input("标签(逗号分隔, 可选): ").split(",")
tags = [t.strip() for t in tags if t.strip()]
manager.add(theme, mtype, content, source, tags)
elif choice == "2":
theme = input("主题: ")
mats = manager.list_by_theme(theme)
for i, m in enumerate(mats):
print(f"{i}. [{m.type}] {m.content} —— {m.source}")
elif choice == "3":
kw = input("关键词: ")
mats = manager.search(kw)
for i, m in enumerate(mats):
print(f"{i}. [{m.theme}][{m.type}] {m.content} —— {m.source}")
elif choice == "4":
idx = int(input("素材序号: "))
print(manager.insert(idx))
elif choice == "5":
break
else:
print("无效选择")
if __name__ == "__main__":
main()
5. README 文件
# 作文素材积累工具
一个基于 Python 的作文素材管理工具，支持按主题分类存储名言、案例，可搜索并一键插入作文，提升写作效率与质量。
## 功能
- 按主题分类（亲情/励志/环保）
- 支持名言与案例两种类型
- 关键词搜索
- 一键插入格式化素材
## 安装
无需额外依赖，Python 3.7+ 即可运行。
## 使用
bash
python cli.py
操作菜单：
1. 添加素材
2. 按主题列出
3. 搜索
4. 一键插入
5. 退出
## 数据存储
素材保存在 `materials.json` 文件中，可手动备份。
## 示例素材
主题: 励志
类型: 名言
内容: 天行健，君子以自强不息。
来源: 《周易》
标签: 坚持, 奋斗
6. 使用说明
1. 首次运行：执行
"python cli.py" 进入交互模式。
2. 添加素材：选择
"1"，按提示输入主题、类型、内容、来源、标签。
3. 按主题查看：选择
"2"，输入主题名称，列出该主题下所有素材。
4. 搜索：选择
"3"，输入关键词，查找包含该词的素材。
5. 一键插入：选择
"4"，输入素材序号，获取格式化文本，可直接复制到作文中。
7. 核心知识点卡片
知识点 说明
面向对象设计 用类封装素材数据与操作
JSON 数据持久化 实现素材的存储与加载
列表与字典操作 管理素材集合与属性
字符串处理 格式化输出与标签解析
模块化编程 分离数据、存储、逻辑、界面
CLI 交互 提供用户友好的命令行界面
搜索算法 简单关键词匹配，可升级为全文检索
8. 总结
本工具通过 Python 实现了作文素材的分类管理、快速搜索、一键插入，解决了素材分散、查找困难、引用不便的痛点。
后续可扩展方向：
- 图形界面（Tkinter/PyQt）
- Markdown 导入（批量导入素材）
- 云同步（结合 SQLite 或云端数据库）
- AI 推荐（根据作文题目推荐相关素材）
这样既符合智能时代的创新课程理念，又具备很强的实用性和教育价值。
如果你愿意，可以做一个 带图形界面的版本，让用户通过点击按钮管理素材，并且可以导出为 Word 文档直接插入作文，
利用AI解决实际问题，如果你觉得这个工具好用，欢迎关注长安牧笛！