Skip to content

README.tl.md

Latest commit

 

History

History
431 lines (316 loc) · 17.9 KB

README.tl.md

File metadata and controls

431 lines (316 loc) · 17.9 KB
Raw

🌐 Ito ay isang awtomatikong pagsasalin. Malugod na tinatanggap ang mga pagwawasto mula sa komunidad!


Claude-Mem
Vercel OSS Program

🇨🇳 中文 • 🇹🇼 繁體中文 • 🇯🇵 日本語 • 🇵🇹 Português • 🇧🇷 Português • 🇰🇷 한국어 • 🇪🇸 Español • 🇩🇪 Deutsch • 🇫🇷 Français • 🇮🇱 עברית • 🇸🇦 العربية • 🇷🇺 Русский • 🇵🇱 Polski • 🇨🇿 Čeština • 🇳🇱 Nederlands • 🇹🇷 Türkçe • 🇺🇦 Українська • 🇻🇳 Tiếng Việt • 🇵🇭 Tagalog • 🇮🇩 Indonesia • 🇹🇭 ไทย • 🇮🇳 हिन्दी • 🇧🇩 বাংলা • 🇵🇰 اردو • 🇷🇴 Română • 🇸🇪 Svenska • 🇮🇹 Italiano • 🇬🇷 Ελληνικά • 🇭🇺 Magyar • 🇫🇮 Suomi • 🇩🇰 Dansk • 🇳🇴 Norsk

Sistema ng kompresyon ng persistent memory na ginawa para sa Claude Code.

License Version Node Mentioned in Awesome Claude Code

thedotmack/claude-mem | Trendshift


Claude-Mem Preview Star History Chart

Mabilis na Pagsisimula • Paano Ito Gumagana • Mga Search Tool • Dokumentasyon • Konpigurasyon • Pag-troubleshoot • Lisensya

Walang putol na pinapanatili ng Claude-Mem ang konteksto sa pagitan ng mga session sa pamamagitan ng awtomatikong pagkuha ng mga obserbasyon sa paggamit ng mga tool, paglikha ng mga semantikong buod, at paggawa nitong available sa mga susunod na session. Dahil dito, napapanatili ni Claude ang tuloy-tuloy na kaalaman tungkol sa mga proyekto kahit matapos ang mga session o muling kumonekta ang mga ito.

Mabilis na Pagsisimula

I-install gamit ang isang solong command:

npx claude-mem install

O i-install para sa OpenCode:

npx claude-mem install --ide opencode

O i-install para sa Antigravity CLI (gabay sa pag-setup):

npx claude-mem install --ide antigravity

O i-install mula sa plugin marketplace sa loob ng Claude Code:

/plugin marketplace add thedotmack/claude-mem

/plugin install claude-mem

I-restart ang Claude Code. Awtomatikong lalabas sa mga bagong session ang konteksto mula sa mga nakaraang session.

Tandaan: Nakapublish din ang Claude-Mem sa npm, ngunit ang npm install -g claude-mem ay nag-iinstall lamang ng SDK/library — hindi nito niroregister ang plugin hooks o nagse-set up ng worker service. Palaging mag-install sa pamamagitan ng npx claude-mem install o ng mga /plugin command sa itaas.

🦞 OpenClaw Gateway

I-install ang claude-mem bilang isang persistent memory plugin sa mga OpenClaw gateway gamit ang isang solong command:

curl -fsSL https://install.cmem.ai/openclaw.sh | bash

Hinahawakan ng installer ang mga dependencies, plugin setup, konpigurasyon ng AI provider, pagsisimula ng worker, at opsyonal na real-time na observation feeds patungong Telegram, Discord, Slack, at iba pa. Tingnan ang Gabay sa Integrasyon ng OpenClaw para sa detalye.

Mga Pangunahing Tampok:

  • 🧠 Persistent Memory - Nananatili ang konteksto sa pagitan ng mga session
  • 📊 Progressive Disclosure - Layered na pagkuha ng memory na may visibility ng token cost
  • 🔍 Skill-Based Search - I-query ang history ng proyekto gamit ang mem-search skill
  • 🖥️ Web Viewer UI - Real-time memory stream sa worker URL na ipinapakita sa startup
  • 💻 Claude Desktop Skill - Maghanap sa memory mula sa mga Claude Desktop conversation
  • 🔒 Privacy Control - Gamitin ang <private> tags para hindi ma-store ang sensitibong nilalaman
  • ⚙️ Context Configuration - Mas pinong kontrol kung anong konteksto ang ini-inject
  • 🤖 Automatic Operation - Walang kailangang manual na intervention
  • 🔗 Citations - I-refer ang mga nakaraang obserbasyon gamit ang IDs sa pamamagitan ng worker API o tingnan lahat sa web viewer

Dokumentasyon

📚 Tingnan ang Buong Dokumentasyon - I-browse sa opisyal na website

Pagsisimula

Best Practices

Arkitektura

Konpigurasyon at Pagbuo

Paano Ito Gumagana

Mga Pangunahing Bahagi:

  1. 5 Lifecycle Hooks - SessionStart, UserPromptSubmit, PostToolUse, Stop, SessionEnd (6 hook scripts)
  2. Smart Install - Cached dependency checker (pre-hook script, hindi lifecycle hook)
  3. Worker Service - Lokal na HTTP API na may web viewer UI at search endpoints, pinamamahalaan ng Bun
  4. SQLite Database - Nag-iimbak ng sessions, observations, summaries
  5. mem-search Skill - Natural language queries na may progressive disclosure
  6. Chroma Vector Database - Hybrid semantic + keyword search para sa matalinong pagkuha ng konteksto

Tingnan ang Architecture Overview para sa detalye.

Mga Search Tool ng MCP

Nagbibigay ang Claude-Mem ng intelligent memory search sa pamamagitan ng 4 MCP tools na sumusunod sa token-efficient na 3-layer workflow pattern:

Ang 3-Layer Workflow:

  1. search - Kumuha ng compact index na may IDs (~50-100 tokens/result)
  2. timeline - Kumuha ng chronological context sa paligid ng mga interesting na result
  3. get_observations - Kunin ang full details PARA LANG sa na-filter na IDs (~500-1,000 tokens/result)

Paano Ito Gumagana:

  • Gumagamit si Claude ng MCP tools para maghanap sa iyong memory
  • Magsimula sa search para makakuha ng index ng results
  • Gamitin ang timeline para makita ang nangyari sa paligid ng mga partikular na observation
  • Gamitin ang get_observations para kunin ang full details ng mga relevant na IDs
  • ~10x tipid sa tokens dahil nagfi-filter muna bago kunin ang full details

Available na MCP Tools:

  1. search - Hanapin ang memory index gamit ang full-text queries, may mga filter (type/date/project)
  2. timeline - Kumuha ng chronological context sa paligid ng isang partikular na observation o query
  3. get_observations - Kumuha ng full observation details gamit ang IDs (laging i-batch ang maraming IDs)

Halimbawa ng Paggamit:

// Step 1: Search for index
search(query="authentication bug", type="bugfix", limit=10)

// Step 2: Review index, identify relevant IDs (e.g., #123, #456)

// Step 3: Fetch full details
get_observations(ids=[123, 456])

Tingnan ang Search Tools Guide para sa mas detalyadong mga halimbawa.

Release Branches

Ang mga stable release ay nagmumula sa main at pinapublish sa npm. Ang core-dev at community-edge ay mga source-run branch para sa maagang reliability fixes at community integrations. Tingnan ang Release Branches para sa daloy ng branch at mga instruksyon sa pagpapatakbo ng non-stable version.

Mga Pangangailangan ng Sistema

  • Node.js: 20.0.0 o mas mataas
  • Claude Code: Pinakabagong bersyon na may plugin support
  • Bun: JavaScript runtime at process manager (auto-installed kung wala)
  • uv: Python package manager para sa vector search (auto-installed kung wala)
  • SQLite 3: Para sa persistent storage (kasama na)

Mga Tala sa Windows Setup

Kung makakita ka ng error gaya ng:

npm : The term 'npm' is not recognized as the name of a cmdlet

Siguraduhing naka-install ang Node.js at npm at nakadagdag ang mga ito sa PATH. I-download ang pinakabagong Node.js installer mula sa https://nodejs.org at i-restart ang terminal matapos mag-install.

Konpigurasyon

Pinamamahalaan ang settings sa ~/.claude-mem/settings.json (auto-created na may defaults sa unang run). I-configure ang AI model, worker port, data directory, log level, at context injection settings.

Tingnan ang Gabay sa Konpigurasyon para sa lahat ng available na settings at mga halimbawa.

Konpigurasyon ng Mode at Wika

Sinusuportahan ng Claude-Mem ang maraming workflow mode at wika sa pamamagitan ng setting na CLAUDE_MEM_MODE.

Kinokontrol ng opsyong ito ang parehong:

  • Ang workflow behavior (hal. code, chill, investigation)
  • Ang wikang ginagamit sa mga nabuong observation

Paano Mag-configure

I-edit ang iyong settings file sa ~/.claude-mem/settings.json:

{
  "CLAUDE_MEM_MODE": "code--zh"
}

Nakadefine ang mga mode sa plugin/modes/. Para makita ang lahat ng available na mode nang lokal:

ls ~/.claude/plugins/marketplaces/thedotmack/plugin/modes/

Mga Available na Mode

Mode Paglalarawan
code Default na mode sa Ingles
code--zh Mode sa Simplified Chinese
code--ja Mode sa Japanese

Ang mga wika-specific na mode ay sumusunod sa pattern na code--[lang] kung saan ang [lang] ay ang ISO 639-1 na language code (hal., zh para sa Chinese, ja para sa Japanese, es para sa Spanish).

Tandaan: Ang code--zh (Simplified Chinese) ay built-in na — walang kailangang karagdagang installation o plugin update.

Pagkatapos Baguhin ang Mode

I-restart ang Claude Code para maipatupad ang bagong konpigurasyon ng mode.

Pagbuo

Tingnan ang Gabay sa Pagbuo para sa mga instruksyon sa pag-build, pag-test, at contribution workflow.

Pag-troubleshoot

Kung may naranasan kang isyu, ilarawan ang problema kay Claude at awtomatikong magda-diagnose at magbibigay ng mga ayos ang troubleshoot skill.

Tingnan ang Troubleshooting Guide para sa mga karaniwang isyu at solusyon.

Mga Ulat ng Bug

Gumawa ng kumpletong mga bug report gamit ang automated generator:

cd ~/.claude/plugins/marketplaces/thedotmack
npm run bug-report

Pag-aambag

Malugod na tinatanggap ang mga kontribusyon! Pakisunod:

  1. I-fork ang repository
  2. Gumawa ng feature branch
  3. Gawin ang mga pagbabago kasama ang mga test
  4. I-update ang dokumentasyon
  5. Mag-submit ng Pull Request

Nagmumula ang Claude-Mem sa tatlong branch: main (stable), core-dev, at community-edge. Tanging ang main lamang ang pinapublish sa npm; ang iba ay pinapatakbo mula sa source. Tingnan ang Release Branches para sa estratehiya at mga instruksyon sa lokal na pagpapatakbo.

Tingnan ang Gabay sa Pagbuo para sa contribution workflow.

Lisensya

Ang Claude-Mem ay lisensyado sa ilalim ng Apache License 2.0.

Pinili namin ang Apache-2.0 dahil ang matibay na agentic memory ay dapat madaling i-embed sa mga developer tool, local agents, MCP servers, enterprise systems, robotics stacks, at production agent harnesses.

Tingnan ang LICENSE file para sa buong detalye. Tingnan ang docs/license.md at docs/ip-boundary.md para sa saklaw ng lisensya at ang hangganan ng open/commercial.

Tala tungkol sa Ragtime: Ang direktoryong ragtime/ ay lisensyado sa ilalim ng Apache License 2.0. Tingnan ang ragtime/LICENSE para sa detalye.

Suporta

Ginawa gamit ang Claude Agent SDK | Gumagana sa Claude Code | Ginawa gamit ang TypeScript

Ano ang CMEM?

Ang CMEM ay isang token na ginawa ng isang 3rd party ngunit opisyal na tinanggap ng lumikha ng Claude-Mem (Alex Newman, @thedotmack). Ang token ay kumikilos bilang isang katalista ng komunidad para sa paglago at isang daluyan para dalhin ang CMEM sa mga developer at knowledge worker na pinakanangangailangan nito.

Opisyal na BASE CA: 0x76b1967eec0ccaeb001bbbb2b40dc4badba31ba3