PKC2 — Portable Knowledge Container

単一HTMLで動作する、ローカル完結型の知識コンテナ

What is this?

PKC2 は、以下を1つにまとめたツールです:

• メモ・タスク・構造化データの管理
• 添付ファイルを含む知識の保持
• HTML 1ファイルとしての配布
• ZIP による完全バックアップ
• 再水和（Rehydrate）でどこでも作業環境を復元

「書く・持ち出す・戻す」を1つのモデルで扱えます。

Features

• Single HTML, zero dependencies — works offline, from a USB drive, or as an email attachment
• Auto-save — IndexedDB persistence, no manual save needed
• 6 entry types — Text, Log (textlog), Todo, Sheet (spreadsheet), File (attachment), Folder
• HTML / ZIP export — light sharing, full archive, or lossless backup
• Rehydrate — turn a readonly HTML back into an editable workspace
• Relations and tags — connect entries structurally
• Search, filter, sort — find anything instantly
• Version history — automatic snapshots with restore
• Size guardrails — warnings before large exports

Quick Start

1. Open dist/pkc2.html in any modern browser
2. Create entries from the toolbar — Text, Log, Todo, Sheet, File, or Folder
3. Export via the Export panel — choose HTML or ZIP

詳しい使い方は ユーザーマニュアル（Markdown） または PKC2 マニュアル HTML を参照してください。

Which Export should I use?

Goal	Recommended
Quick sharing	HTML Light
Share with attachments	HTML Full
Distribution (read-only)	Readonly HTML
Backup / migration	ZIP Package

For detailed usage, see the Operation Guide.

Architecture

5-layer architecture with a strict, one-way import direction (core ← features ← adapter; core imports nothing and has zero browser APIs):

core  ←  features  ←  adapter        ·  runtime (build constants / DOM contracts)  ·  build/ (Stage 2 HTML)

• core — domain model: pure types + operations (zero browser API, imports nothing)
• features — pure algorithmic modules (search, relations, tree, calendar, kanban); imports core only
• adapter — runtime integration: state machine, UI rendering, persistence, transport (orchestrates everything)
• runtime — build constants, version, DOM slot contracts
• build/ — Stage 2 single-HTML generation (release-builder)

Runtime has zero external npm dependencies.

OKF (Open Knowledge Format) との関係

PKC2 のデータモデル — markdown 本文 + YAML frontmatter + 型付きエントリ(archetype)+ markdown リンクによる知識グラフ — は、Google Cloud が 2026-06 に公開した Open Knowledge Format (OKF) と構造的にほぼ同型です。PKC2 は OKF 公開前から、ローカル完結・単一 HTML の個人知識ツールとして「markdown + frontmatter の知識グラフ」を実装してきました。

A local-first personal knowledge container whose model (markdown bodies + YAML frontmatter + typed entries + markdown-link knowledge graph) is structurally close to Google's Open Knowledge Format (OKF) for AI agents.

現状: OKF バンドルとの import / export 相互運用は 設計段階(未実装)です。設計と論点は docs/development/okf-interop-design-2026-06.md、進行管理は issue #838 を参照してください。OKF 仕様本体は GoogleCloudPlatform/knowledge-catalog にあります。

Documentation

ユーザー向け

Document	Purpose
ユーザーマニュアル（目次）	全 10 章の Markdown マニュアル
PKC2 マニュアル HTML	PKC2 形式の単一 HTML マニュアル（readonly）
運用ガイド	Export / Import / Rehydrate の詳細

開発者向け

Document	Purpose
Design Principles	Core values and constraints
Architecture	5-layer structure and rules
Data Model	Storage, export, compression
Pre-Release Notes	v0.1.0 時点の凍結スナップショット（履歴、現状の正本ではない）

PKC2 Extensions

PKC2-Extensions/ ディレクトリは、PKC2 の「拡張機能 HTML」の配布先です。拡張機能 HTML は PKC2 形式の単一 HTML ファイルで、次の 3 通りで利用できます。

• 単体で開く — ブラウザに HTML をドロップすると PKC2 UI で内容を閲覧
• Import / Rehydrate — ご自身のワークスペースに取り込み
• iframe 埋め込み — 別ページに組み込んで postMessage で連携

現在は pkc2-manual.html（ユーザーマニュアル）が第 1 弾として配置されています。

Development

npm install          # Install dependencies
npm run dev          # Start dev server
npm run build        # Build (Stage 1 bundle + Stage 2 HTML)
npm run build:manual # Build the PKC2-Extensions/pkc2-manual.html
npm run build:all    # Build everything (bundle + release + manual)
npm run typecheck    # TypeScript check
npm test             # Run tests

Status

v2.3.0 (pre-release) — Core features stable. Specification stabilizing.

License

AGPL-3.0 — See LICENSE for details.