opensyn 0.1.0

package/README.md

@@ -0,0 +1,73 @@
+# OpenSyn OpenClaw Plugin
+
+This plugin is the current OpenClaw entry point for OpenSyn.
+
+Fast install:
+
+```bash
+openclaw plugins install opensyn
+openclaw enable_opensyn
+openclaw status_opensyn
+```
+
+Default local paths:
+- runtime root: `~/.opensyn`
+- database: `~/.opensyn/opensyn.db`
+
+Default workspace behavior:
+- `openclaw enable_opensyn` uses the current OpenClaw workspace if no project path is provided
+- `openclaw enable_opensyn` also bootstraps the managed shell hook, starts the plugin-managed background `watch-linux` collector, and starts the plugin-managed host-model distillation worker
+- `openclaw status_opensyn` returns a compact `next=...` hint so the customer can see the next required action immediately
+
+Fallback local-dev install:
+
+```bash
+./scripts/openclaw-install-plugin --mode link --project-root "$PWD"
+```
+
+Maintainer npm publish flow:
+
+```bash
+./scripts/publish-opensyn-plugin --dry-run
+npm adduser
+./scripts/publish-opensyn-plugin
+```
+
+Primary documentation:
+
+- English handbook: [docs/opensyn-handbook.md](/workspace/hengzhuang.jin/ai/opensyn/docs/opensyn-handbook.md)
+- 中文手册: [docs/opensyn-handbook.zh-CN.md](/workspace/hengzhuang.jin/ai/opensyn/docs/opensyn-handbook.zh-CN.md)
+- 中文插件入口: [README.zh-CN.md](/workspace/hengzhuang.jin/ai/opensyn/extensions/open-synapse/README.zh-CN.md)
+
+Primary OpenClaw CLI commands:
+
+- `openclaw enable_opensyn`
+- `openclaw disable_opensyn`
+- `openclaw status_opensyn`
+- `openclaw doctor_opensyn`
+- `openclaw repair_opensyn`
+
+Plugin tools still available:
+
+- `opensyn_autonomous_collection_status`
+- `opensyn_autonomous_tick`
+- `opensyn_current_context`
+- `opensyn_recent_failure`
+- `opensyn_search_history`
+- `opensyn_list_assets`
+- `opensyn_approve_asset`
+- `opensyn_sync_assets`
+
+Hard safety rules:
+
+- only the OpenClaw-configured model may perform model-assisted distillation
+- no external browsing or external model calls
+- all context, jobs, and projected assets stay local on the machine
+
+Current host overlay targets:
+
+- `OPENSYN.md`
+- `MEMORY.md`
+- `AGENTS.md`
+- `SOUL.md`
+- `skills/opensyn-*/SKILL.md`

package/README.zh-CN.md

@@ -0,0 +1,65 @@
+# OpenSyn OpenClaw 插件（中文）
+
+这是当前 OpenSyn 面向 OpenClaw 的主入口。
+
+快速安装：
+
+```bash
+openclaw plugins install opensyn
+openclaw enable_opensyn
+openclaw status_opensyn
+```
+
+默认本地路径：
+- runtime 根目录：`~/.opensyn`
+- 数据库：`~/.opensyn/opensyn.db`
+
+默认 workspace 行为：
+- `openclaw enable_opensyn` 如果不传项目路径，会直接使用当前 OpenClaw workspace
+- `openclaw enable_opensyn` 还会完成托管 shell hook 自举，并拉起插件托管的后台 `watch-linux` 采集器和 host-model distillation worker
+- `openclaw status_opensyn` 会直接返回统一的 `next=...` 提示，让客户马上知道下一步动作
+
+本地开发联调安装：
+
+```bash
+./scripts/openclaw-install-plugin --mode link --project-root "$PWD"
+```
+
+维护者发布到 npm 的流程：
+
+```bash
+./scripts/publish-opensyn-plugin --dry-run
+npm adduser
+./scripts/publish-opensyn-plugin
+```
+
+主要文档：
+
+- 中文手册：[docs/opensyn-handbook.zh-CN.md](/workspace/hengzhuang.jin/ai/opensyn/docs/opensyn-handbook.zh-CN.md)
+- English handbook: [docs/opensyn-handbook.md](/workspace/hengzhuang.jin/ai/opensyn/docs/opensyn-handbook.md)
+- 根入口：[README.zh-CN.md](/workspace/hengzhuang.jin/ai/opensyn/README.zh-CN.md)
+
+主要 OpenClaw CLI 命令：
+
+- `openclaw enable_opensyn`
+- `openclaw disable_opensyn`
+- `openclaw status_opensyn`
+- `openclaw doctor_opensyn`
+- `openclaw repair_opensyn`
+
+插件工具仍可直接调用：
+
+- `opensyn_autonomous_collection_status`
+- `opensyn_autonomous_tick`
+- `opensyn_current_context`
+- `opensyn_recent_failure`
+- `opensyn_search_history`
+- `opensyn_list_assets`
+- `opensyn_approve_asset`
+- `opensyn_sync_assets`
+
+安全约束：
+
+- 只允许使用 OpenClaw 当前配置模型
+- 不联网浏览，不调用外部模型
+- 所有上下文、job、资产和投影都留在本机