# fct-plugins **Repository Path**: curtisLai/fct-plugins ## Basic Information - **Project Name**: fct-plugins - **Description**: fct-plugins obsidian - **Primary Language**: Unknown - **License**: 0BSD - **Default Branch**: main - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2026-10-23 - **Last Updated**: 2026-10-24 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # 方寸台工作台 · FANGCUN DESK Obsidian 桌面端第三方插件。通过库内 frontmatter,把内容生产组织为「灵感 → 内容 → 发布 → 复盘」,每个阶段附带 SOP 和传播边界。无需 Dataview、网络服务或外部 Agent CLI。 ## 手动安装 1. 获取 `dist/fangcun-dashboard-0.2.0.zip`,退出 Obsidian。 2. 解压,将 `fangcun-dashboard/` 文件夹放到所选 Vault 的 `.obsidian/plugins/` 下。文件结构应为: ```text /.obsidian/plugins/fangcun-dashboard/ ├── main.js ├── manifest.json └── styles.css ``` 3. 重新打开 Obsidian。在「设置 → 第三方插件 / 社区插件」中关闭受限模式(如有),启用「方寸台工作台」。 4. 点击左侧工作台图标,或运行命令「方寸台工作台:打开方寸台工作台」。 最低 Obsidian 版本为 `1.8.0`,仅桌面端。首次使用不需要 `data.json`。升级时先禁用插件、替换发行文件、保留已有 `data.json`,重新加载后启用。发行包不包含 Vault 数据、源码或 `node_modules`。 本次开发的目标 Vault 是 `/Users/cds-dn-790/Documents/AIprj/fct-promotion`,插件运行时不绑定这个绝对路径,也可手动安装到其他 Vault。 ## 0.2.0 功能 - 今日工作台:生产内容、待审核、资源文件、归档文件;附 SOP 待确认、待发布、逾期与四阶段计数。 - 四阶段面板:只显示生产内容;支持搜索、状态筛选、Blog / 短剧 / 脚本形式筛选,附阶段 SOP、红线、研究与品牌参考入口。 - 资源库:品牌、选题研究、SOP 模板、短剧资料、数据、协作规范分类;支持类别、格式、关键词筛选。角色图按名称分组,数字版本排序,缩略图与大图预览,折叠历史版本;最新版本不表示定稿。封面与其他图片另设图库。 - 历史归档:独立显示 `archive/` 或 `status=archived` 文件,不计当前生产、审核、排期。 - CSV 支持纯文本表格预览(512 KB 内,最多 50 条数据、30 列);Excel 等文件交由 Obsidian 打开或系统关联应用处理,不提供内嵌 Excel 编辑。 - 点击现有笔记或 SOP 在新标签打开;缺失来源标记「未找到」,不会创建笔记。 - 创建、修改、删除、改名、元数据更新后防抖刷新;也可手动刷新。每分钟重算排期。 - 刷新保留当前面板的搜索、筛选、焦点和滚动位置;面板可随 Obsidian 布局恢复。 - 插件内部使用浅色样式,不改变 Vault 全局主题;窄桌面窗格可使用横向导航。 ## 数据规则 读取 Markdown 的 `type`、`status`、`date`、`tags`、`platform`、`planned_publish`,标题优先使用 `title`,否则使用文件名。缺少 frontmatter 的普通资料默认进入资源库;生产集合结合路径、标签与类型识别。排除 `dashboard/`、`node_modules/`、`.git/` 等工程与配置目录;模板、地图及普通笔记保留在总数中。 先识别文件集合:`archive/` 或 `status=archived` 优先归档;规范 / SOP / 模板 / 品牌 / 研究 / 治理等进入资源;Blog 内容包、脚本、实际选题和复盘进入生产。趋势简报即使标记 `published` 也保持资料属性。 只有生产集合按以下优先级计入四阶段: 1. `status=archived` 或 `type=analytics` → 复盘。 2. `type=publishing`、`status=published` 或有效 `planned_publish` → 发布。 3. `type=research/strategy`,或 `type=topic` 且 `status=idea/approved` → 灵感。 4. 其余 → 内容。 这能避免「已归档但仍保留排期」「脚本已经发布」等字段冲突。带有效排期且尚未 `published/archived` 的笔记才计入待发布或逾期;计划时间等于当前时间仍算待发布。`YYYY-MM-DD HH:MM` 按本机时区解析,带时区的 ISO 时间遵守显式时区;排期只有日期时按当天结束计算。无效日期不计入排期并显示数据提示。 最近更新按 `date` 排序,缺失或无效时使用文件修改时间;列表同时显示实际修改时间。资源总数按文件计数,角色版本分组只是展示索引,不额外增加资源数量。附件格式支持图片、PDF、CSV、Excel、音视频、Base 和 Canvas。 SOP 待确认要求 `tags` 包含 `sop` 且 `status=draft`。模板中的 `{{date}}` 日期占位符不会作为业务日期告警;真实无效日期仍提示,不自动修改模板。 SOP 和传播边界的默认文案及路径见 `src/data/stages.ts`,参考目标 Vault 的内容规范;插件开发规则另见根目录 `AGENTS.md`。 ## 开发与验证 ```sh npm install npm run dev # 监视构建 main.js npm run build # 类型检查并构建 npm run lint npm test npm run release # 构建后生成 ZIP 与 SHA256SUMS ``` 发行脚本使用系统 `zip`。开发构建不会自动复制、安装或启用插件。`dist/fangcun-dashboard/` 是可手动复制的发行文件夹;同目录的 `SHA256SUMS` 可用于核对 ZIP。 本地 Obsidian CLI 可用于已安装插件的集成验证: ```sh node scripts/verify-obsidian.mjs fct-promotion ``` 请显式传入 Vault 名,运行前先在该 Vault 设置中启用插件。验证会切换面板、打开现有 SOP 标签并触发元数据刷新事件,不创建或修改笔记。脚本使用 Obsidian 开发调试接口,仅用于开发验证;运行时插件使用公开 API。 0.1.0 的静态视觉原型在 `prototype/fangcun-desk/index.html`,可直接打开。原型使用示例数据,与插件实际 Vault 数据分开。 ## 后续扩展与多 Agent `src/contracts/dashboard.ts` 定义 UI / 数据接口;`src/contracts/agents.ts` 定义版本化任务输入、结果输出和外部缓存接口。开发角色、文件归属、交付状态及交接规范见 `AGENTS.md` 和 `CODEX-PROMPTS.md`。 首版没有启动 Agent、访问外网、抓取 RSS / GitHub 或写入报告;缓存及执行器仅保留类型接口。后续实现需补齐执行器、依赖和权限校验、超时取消、报告校验及随包脚本后再开放操作入口。 ## 来源与许可 项目构建结构基于 [Obsidian 官方 sample plugin](https://github.com/obsidianmd/obsidian-sample-plugin),通过 GitHub API 获取并沿用其 `esbuild.config.mjs` 和许可,依其配置建立 TypeScript 插件入口;保留 Dynalist 的 0BSD 许可。没有导入官方 Git 历史,也没有创建远程或提交。