Skip to content

Repository files navigation

ISMISM Library

Languages: English | 中文


English

ISMISM Library is a Codex-plugin-ready, corpus-backed interpretation system for the ISMISM transcript collection. It combines source transcripts, curated segment records, concept senses, matrix positions, relation graphs, close-reading cards, theme dossiers, course navigation, independently reviewed external evidence, audits, and command-line validation/query tools.

The canonical positioning document is docs/product-positioning.md.

The repository is designed around four guarantees:

  1. Traceability — every interpretive claim keeps row, segment, path, and quote anchors.
  2. Layer separation — source corpus, curated library, documentation, and tools live in separate product modules.
  3. Validator-backed use — normal work ends with reproducible validation and query smoke checks.
  4. Plugin operation — Codex can load the repository as ismism-system and use ismism-knowledge-operator for traceable knowledge work.

Default analysis framework

library/protocols/relational-subjectivation-praxis-protocol.md is the repository-default and only protocol for organizing interpretation beyond evidence retrieval. It separates provenance and F/I/V, traverses the six domains M/C/S/P/E/A, applies the relevant IE0–IE4 threshold, and requires competing explanations, falsification/counterevidence, and a stopping condition.

Theme dossiers are bounded evidence and routing modules, not competing mini-frameworks. Cross-theme analysis preserves each theme's provenance and uses the default protocol as the join layer. This procedural priority does not make the protocol a corpus source or empirical truth.

Repository layout

.codex-plugin/ plugin manifest for Codex
corpus/        source PDF, table of contents, raw transcript markdown, clean transcript markdown
library/       curated manifests, segments, concepts, positions, relations, close-reading cards, themes, courses, audits
docs/          product contract, architecture, status, validation, query, plugin, and usage guides
tools/         ingestion, validation, query helpers, and the ISMISM command runner
examples/      reproducible command examples
reviews/       structured curation candidates, decisions, and product review evidence
qa/            product acceptance evidence
skills/        operator protocol for agent-assisted curation

Codex plugin

The Codex plugin manifest lives at .codex-plugin/plugin.json. Usage details are in docs/plugin-usage.md.

Install as a Codex plugin

codex plugin marketplace add weathour/ismism-system --ref main
codex plugin add ismism-system@ismism-system

After installation, invoke $ismism-knowledge-operator from any repository. The bundled skill runner resolves the ISMISM plugin root automatically.

  • Plugin name: ismism-system
  • Display name: ISMISM Library
  • Primary skill: ismism-knowledge-operator
  • Primary command runner in this repository: python3 tools/ismism.py
  • Cross-repository plugin runner: python3 <installed-skill-dir>/scripts/ismism.py

Quick checks

python3 tools/ismism.py validate core
python3 tools/ismism.py query social 内卷 --limit 3
python3 tools/ismism.py query concept 主体 --limit 3

For the full suite:

python3 tools/ismism.py validate all

Query examples

python3 tools/ismism.py query social 内卷 --limit 3
python3 tools/ismism.py query concept 主体 --limit 3
python3 tools/ismism.py query relation 主体 --limit 3
python3 tools/ismism.py query close --row 139 --limit 3
python3 tools/ismism.py query position 3-4-2
python3 tools/ismism.py query trace 176 --limit 5
python3 tools/ismism.py query theme --list
python3 tools/ismism.py query theme family-intimacy-reproduction 爱情 --limit 3
python3 tools/ismism.py query course --dossier shuzheng-practice 庶政学 --limit 3
python3 tools/ismism.py query course --dossier ideology-desire-sexual-politics 意识形态学 --limit 3
python3 tools/ismism.py query philosophy-evidence --bvid BV1QvbMzaETr --limit 3

Concept, relation, and close-reading queries default to reviewed records with the confirmed core skeleton first. Use --scope all only for draft/pilot discovery.

Start with AGENTS.md for agent routing, docs/query-guide.md for query discovery, and docs/usage-protocol.md for evidence-bound use.

Current library size

  • 363 corpus rows with raw and clean transcript markdown.
  • Validator-backed concept and relation counts are maintained in docs/status.md rather than duplicated here.
  • 736 close-reading cards across argument, process, and case forms.
  • 39 theme dossiers with row manifests and exact quote evidence.
  • An external learning dossier for philosophy covering 48 BVID / 51 ASR sources / 429 retrieval chunks.
  • An external learning dossier for shuzheng/practice covering 22 BVID / 22 ASR sources / 113 retrieval chunks; its 22 text reviews are terminal: 21 admitted V-only paraphrases and 1 rejection whose candidate/claim is excluded from queries.
  • A combined external learning dossier for ideology, erotic economics, and sexual politics covering 33 routes / 36 ASR source parts / 143 retrieval chunks; 23 terminal text reviews contain 21 V-only admissions and 2 rejections, while 10 routes require no asset.
  • The only external-exact route is the philosophy audio-only query; its bank is currently empty.

Working rule

Do not edit transcript text unless the task is explicitly source correction. Normal work should extend or validate library/ while preserving canonical exact-quote anchors against corpus/clean-markdown/. Machine ASR is navigation; admitted agent text review is a separate analysis_status: V, paraphrase-only non-exact layer and never an exact quote or F. Follow an external learning dossier as course → video/agent V → primary theme → trace/close canonical → default protocol; never infer real-world facts, historical attribution, action prescriptions, or automatic cross-theme conclusions from it.


中文

ISMISM Library 是一个可作为 Codex plugin 使用的、以 ISMISM 文本语料为基础的解释型知识库。它把源文本、段落记录、概念义项、矩阵位置、关系图谱、细读卡、主题档案、课程导航、独立复核的外部证据、审查记录,以及命令行验证/查询工具组织成一个可追溯的知识系统。

项目定位文档见 docs/product-positioning.md

本仓库围绕四个保证设计:

  1. 可追溯性:每条解释性主张都保留 row、segment、路径和原文引文锚点。
  2. 层级分离:源语料、整理后的知识层、文档层、工具层相互分离。
  3. 验证驱动:常规工作应以可复现的验证和查询烟测结束。
  4. 插件化操作:Codex 可以将本仓库作为 ismism-system 加载,并通过 ismism-knowledge-operator 执行可追溯的知识工作。

默认分析框架

library/protocols/relational-subjectivation-praxis-protocol.md 是本仓库默认且唯一的分析组织协议,适用于超出证据检索的解释。它区分 provenance 与 F/I/V,追踪 M/C/S/P/E/A 六个对象域,执行相应的 IE0–IE4 门槛,并要求竞争解释、反证/反向证据和停止条件。

主题档案是有边界的证据与路由模块,不是并行的小型框架。跨主题分析必须保留每个主题的 provenance,再由默认协议统一组织。这种优先级只是程序优先级,不使协议成为 corpus 事实源或经验真理。

仓库结构

.codex-plugin/ Codex 插件 manifest
corpus/        源 PDF、目录注册表、原始 markdown、清洗 markdown
library/       manifests、segments、concepts、positions、relations、close-reading、themes、courses、audits
docs/          项目契约、架构、状态、验证、查询、插件和使用说明
tools/         ingest、validate、query 工具和 ISMISM 命令入口
examples/      可复现命令示例
reviews/       结构化策展候选、决定与产品审查证据
qa/            产品验收证据
skills/        面向 agent 辅助整理的操作协议

Codex 插件

Codex 插件 manifest 位于 .codex-plugin/plugin.json,使用说明见 docs/plugin-usage.md

安装为 Codex 插件

codex plugin marketplace add weathour/ismism-system --ref main
codex plugin add ismism-system@ismism-system

安装后可在任意仓库调用 $ismism-knowledge-operator。内置 skill runner 会自动解析 ISMISM plugin root。

  • 插件名:ismism-system
  • 展示名:ISMISM Library
  • 核心 skill:ismism-knowledge-operator
  • 本仓库内核心命令入口:python3 tools/ismism.py
  • 跨仓库 plugin 命令入口:python3 <installed-skill-dir>/scripts/ismism.py

快速检查

python3 tools/ismism.py validate core
python3 tools/ismism.py query social 内卷 --limit 3
python3 tools/ismism.py query concept 主体 --limit 3

完整验证:

python3 tools/ismism.py validate all

查询示例

python3 tools/ismism.py query social 内卷 --limit 3
python3 tools/ismism.py query concept 主体 --limit 3
python3 tools/ismism.py query relation 主体 --limit 3
python3 tools/ismism.py query close --row 139 --limit 3
python3 tools/ismism.py query position 3-4-2
python3 tools/ismism.py query trace 176 --limit 5
python3 tools/ismism.py query theme --list
python3 tools/ismism.py query theme family-intimacy-reproduction 爱情 --limit 3
python3 tools/ismism.py query course --dossier shuzheng-practice 庶政学 --limit 3
python3 tools/ismism.py query course --dossier ideology-desire-sexual-politics 意识形态学 --limit 3
python3 tools/ismism.py query philosophy-evidence --bvid BV1QvbMzaETr --limit 3

concept、relation 与 close-reading 查询默认只返回 reviewed 记录,并将已确认核心骨架排在前面。仅在 draft/pilot 发现任务中使用 --scope all

Agent 从 AGENTS.md 开始,查询发现见 docs/query-guide.md,证据化使用流程见 docs/usage-protocol.md

当前知识库规模

  • 363 个 corpus rows,均有 raw 与 clean transcript markdown。
  • concept 与 relation 的 validator-backed 实时数量统一维护在 docs/status.md,不在此重复易漂移的数字。
  • 736 张 close-reading cards,分为 argument、process、case 三类。
  • 39 个 theme dossiers,包含 row manifests 和 exact quote evidence。
  • 哲学 external learning dossier 覆盖 48 BVID / 51 份 ASR 来源 / 429 个检索块。
  • 庶政学/实践学 external learning dossier 覆盖 22 BVID / 22 份 ASR 来源 / 113 个检索块;22 条文本复核均已终局:21 条接纳为 V-only 释义,1 条拒绝,其 candidate/claim 不进入查询投影或关键词检索。
  • 意识形态学、爱欲经济学与性的政治学 combined dossier 覆盖 33 routes / 36 份 ASR source parts / 143 个检索块;23 条终局文本复核中 21 条为 V-only 接纳、2 条拒绝,另有 10 条 route 为 no-asset-needed
  • external exact 仅保留哲学 audio-only 查询路径;其 bank 当前为空。

工作规则

除非任务明确要求 source correction,否则不要修改 transcript text。常规工作应扩展或验证 library/,并保持解释内容能够追溯到 corpus/clean-markdown/ 的 canonical 精确引文。机器 ASR 只用于导航;接纳的 agent 文本审查另存为 analysis_status: V 的非精确释义,不能作精确引文或 F。external learning dossier 的路径是 course → video/agent V → primary theme → trace/close canonical → 默认协议;不得由其自动推出跨主题结论、现实事实、历史归因或行动处方。

About

Codex plugin-ready ISMISM corpus-backed interpretation library

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages