liubinfighter_csv-lite/README_zh.md

CSV Lite

足够简单的 CSV 编辑器，无需学习和思考复杂的功能！

English Version Readme

简介

保持专注！不要浪费时间创建花哨的表格。

一个旨在直接在 Obsidian 中查看和编辑 CSV 文件 的插件。

• 查看 CSV 文件为整洁、可读的表格
• 搜索 整个文件，快速查找数据（按 esc 清除）
• 导航 轻松，带有编号的行和列
• 固定 通过小别针固定列，使其始终可见
• 切换 表格视图和原始源码模式
• 编辑 直接点击并输入即可编辑单元格
• 管理 行和列（添加、删除、移动），只需右键点击表头
• 非破坏性分隔符切换：自动检测文件原始分隔符（逗号、分号、制表符等）。在工具栏切换分隔符只会重新解析视图，不会改写文件；保存编辑时仍使用文件原始分隔符，避免产生大规模 diff。
• 可点击的 URL 链接：单元格中的纯文本 URL 和 Markdown 风格链接（[文本](url)）会自动识别并渲染为可点击的链接。点击链接在浏览器中打开，或点击编辑按钮（✎）编辑单元格内容。

我计划仅用 json 和 csv 设计自己的数据库。如果你有关于表格或 csv 的新想法，欢迎提 issue（我会考虑加入 csv-lite 或新插件），或在社区中搜索。

为什么需要另一个 CSV 插件？

已经有很多 CSV 插件了，为什么还要用这个？

因为它设计得足够简单直接，并且始终跟进最新的 Obsidian API 和类型定义。没有花哨功能——只需打开和编辑。

理念

• 没有花哨的 UI，拒绝以下内容： - 模态框 - 侧边栏 - 设置选项卡 - 多余的在线文档和教程
• 上述所有 UI 组件的功能都将在单一文件视图中实现
• 一切都在 TextFileView/workspace 中完成
• 不再污染你的库，所有元数据都以 json 格式存储在 ./.obsidian/plugins/csv（目前没有 data.json）
• 每个功能必须在 3 步内完成： 0. 视觉定位
  1. 点击/快捷键
  2. 输入（如需）
  3. 确认/离开
• 界面应保持极简但实用
• 用户无需离开工作流环境
• CSV 操作应像文本编辑一样自然

目的

本插件增强了 Obsidian 的功能，让用户可以在库内无缝处理 CSV（逗号分隔值）文件，无需在不同应用间切换。

分隔符处理策略

多人协作或跨区域数据常混用不同分隔符（, ; \t）。为降低风险：

1. 打开文件时自动检测分隔符。
2. 工具栏下拉（Auto, , ;）只是临时“重新解释”数据，不修改磁盘文件。
3. 你在表格中做的内容编辑（单元格/行列操作）保存时仍按最初检测出的原始分隔符写回。
4. 避免意外把所有分号文件改成逗号，减少版本库噪音。

如果需要真正“转换分隔符”的功能，欢迎提 issue，我们会加确认步骤而不是静默改写。

开始使用

通过 Obsidian 的社区插件区安装本插件，即可直接在笔记中查看和编辑 CSV 文件。

问题捕捉

你可以在这里 issue.

如果你遇到任何和csv解析的问题，请下载 test/test-sample.csv，对比你的 CSV 文件和测试文件有何不同。提交带有截图的问题可以帮助我们更快地修复。