@ftai/dsh-plugin-acn 0.0.0-stage → 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,79 @@
+# 更新记录
+
+## 0.1.0（未发布）
+
+- 团队连接在未配置环境代理时使用 macOS 与 Windows 的系统 HTTP(S) 代理及例外规则。
+
+- 修复草稿改选工作配置后旧目录拦截归档，以及撤销归档后续聊恢复仍被旧上界截断的问题。
+
+- 修复会话投影一次异常后复盘持续失败：按会话有序重试，从原日志补齐未处理输入，隔离扫描与路由故障并显示具体恢复原因。
+
+### 功能
+
+- 聚焦以 Claim 为主体的可复用经验，移除私有 Memory 管理；知识提炼过滤名称包含 `memory` 的工具调用和结果。
+
+- 提供多份单人或团队工作配置、模型可用性检查、首发前配置选择与固定会话归属。
+- 提供按身份的知识与活动页面、来源会话跳转、失败重试及有焦点来源会话的持久结果展示回执。
+
+- 补齐 `/recap`、批量与尾部空闲触发、归档冻结收尾及暂停恢复；单人和团队模式均可使用。
+- 提供 DSH 组合插件、插件设置界面、中英文本地化与图标；可配置 Agent ID、知识目录、后台模型和团队连接。
+- 实现 Claim / Trace 协议、带 revision 的知识修订、冻结知识目录、变化提示与管理命令。
+- 通过 Recap / Finalize 形成知识，提供引用校验、持久任务队列、失败重试与崩溃恢复。
+- 接入 Router / Maintainer，支持团队查询、Dispute 上报、Inbox 内化、Policy 撤回和可靠上传；单人模式不发送团队请求。
+- 提供 Dream 质量清理、主题整合、逐组报告、版本复核与整合依赖交付；可选启用受限文件查证。
+- Dream 使用宿主子会话自主探索，默认 24 次探索请求加最多 3 次收尾；额度持久记账，结束后下次从当前知识重新开始。
+- 提供只读导入，支持预览、重复导入、冲突保护和中断恢复，不自动上传导入内容。
+
+### 修复与保护
+
+- 修复 Windows 文件短暂占用时的原子替换与锁目录创建、跨平台换行和全新源码类型检查；完成 Windows 桌面与团队连接验收。
+- 新建工作配置默认展开团队服务填写区，个人使用可关闭团队连接。
+- 本地知识按状态和最近变更排序，Trace 按创建时间倒序；配置编辑返回列表顶部，活动操作成功使用短暂消息提示。
+- 修复 Windows upstream 主目录展开和原生反斜杠导入路径；保存及运行时拒绝保留目录名，保留其他平台的既有行为。
+- 安装检查改为跨平台 Node 脚本，增加 Windows / macOS 的 Node 22 / 24 CI 矩阵，并说明 Windows 实机、ACL 与共享盘验证边界。
+
+- 连接检查先校验地址、身份与超时，格式错误明确指出字段并在按钮附近提示，不再被当作离线可保存；检查与保存继续分离，草稿保留。
+- 补充双成员裁决通知、ACK 后模型失败恢复及重复内化回归，更新团队阶段说明、配置截图和知识流转图。
+
+- 将工作配置启用／停用移到列表，避免丢弃编辑草稿；澄清凭据托管能力、暂存与采用状态、Agent ID 改回方法及 Router 概览重试参数。未知保存结果可刷新并保留草稿，确认首次创建是否已成功。
+
+- 修复密钥替换早于配置保存的问题；支持显式解绑，保存失败保留草稿与旧连接。
+- 知识组件不可用时释放聊天框，提供插件管理入口与状态恢复。
+- 活动显示警告、额度收尾、未完成组、永久拒绝及投递故障，支持历史筛选分页和专用恢复操作。
+- 修复重试反馈被刷新覆盖、模型检查取消未传播、配置冲突草稿恢复与英文错误提示。
+- 明确团队来源读取限制，更新首次配置和历史失败查询说明。
+
+- 知识增量刷新遇到本地提交争用时暂缓通知并保留游标，不再中断前台回合；Claim / Trace 读取与批量提交共享知识锁，显式锁等待可取消，成功写入不因后续通知失败而误报失败。
+- 初始及恢复目录、形成和 Inbox 提交的锁等待传播取消信号；自动 Dream 资格检查遇忙后短期重试，避免推迟整个检查周期，停止及卸载会清理重试。
+
+- 后台任务保留模型鉴权、额度、上下文、响应格式及输出上限分类，活动界面可查看原因；结构化纠正和传输重试保持有界，任务重试耗尽后明确提示手动恢复。旧受限查证的宿主重试也计入模型轮数。
+- 保留模型服务的 `Retry-After` 并使用现有任务队列延后重试，HTTP 408 正确归为超时；旧受限查证耗尽额度后安全收尾，避免重试永久卡住。
+
+- Dream 对宿主明确报告的工具参数 JSON 语法错误先向模型回喂未执行说明和修复要求，再最多自动额外重试两次，每次计入现有额度；耗尽后显示错误分类和恢复建议，保留已接受的进度。
+
+- 团队鉴权改为直接输入密钥、默认掩码和眼睛按钮切换显隐；内部引用自动维护，保存配置时一并托管，连接检查不保存草稿密钥。
+
+- 首次配置后可初始化宿主复用的空白会话；已有工作及派生历史仍不能改绑身份。
+- 团队凭据接入宿主托管服务，提供独立的密码写入入口及状态；配置和响应不含密钥。
+- 来源链接提供精确本地详情、缺失来源说明和返回导航，停用说明明确关联会话影响。
+
+- 聊天框使用一个 ACN 菜单，单人模式隐藏团队收件，操作结果不占用输入框。系统设置、插件详情和会话设置统一显示个人、团队和知识模型页签。
+
+- 为 Claim、Router 查询和 Dream 只读 Claim 补齐顶层工具参数，兼容仅转发根字段的模型适配器，保留严格动作校验。
+- 将后台模型默认输出上限提高到 32768 token，覆盖知识形成、Dream 及其受限查证等后台调用；保留显式配置的上限。
+- Dream 凭据路径检查覆盖常见单复数名称、带前缀的文件名和敏感目录；读取、搜索和目录扫描共用规则。
+- Dream 对齐原版逐 Claim 语义复核，检查来源与信息承接、版本和直接证据；保留旧固定提交的恢复兼容与不含正文的诊断。
+- Dream 恢复时重新检查查证开关，关闭后拒绝新文件读取与搜索；直接取消子会话不会自动重新发起收尾或完成任务。
+- 恢复原版团队知识查询、使用的知识选择纪律，补充 Recap 输入过滤与截断标记。
+- Dream 仅向当前可执行的高优先级任务让位，避免禁用处理器的任务阻塞整理。
+- Inbox 关闭时取消模型调用并等待固定提交完成，未处理消息保留到重新启用。
+- Recap / Finalize 与 Inbox 在首次提交前发现快照变化时保留输入重试，避免消耗游标或提前确认内化。
+- 持久绑定会话身份，阻止热重载或离线配置修改后旧会话跨身份访问；同一身份的恢复会话保留冻结快照。
+- 暂停与本地版本不一致的待上传项，保留依赖 Dispute，不发布过时版本或单人期间的整合结果。
+- 插件配置使用原子保存与并发版本检查；调整下拉符号和按钮对齐，明确保存入口及丢弃未保存修改的提示。
+
+### 文档与维护
+
+- 提供中英文仓库说明、图文使用指南、配置与命令参考、架构、兼容边界和开发指南。
+- 将使用限制与可复现的测试方法归入现行文档，移除发布筹备说明、阶段验收报告及无引用的过程截图。
+- 安装检查核对实际包中的模块、正文、本地化、图标和图片；安全检查覆盖凭据、个人路径、邮箱和提交身份。

package/LICENSE-APACHE

@@ -0,0 +1,201 @@
+                              Apache License
+                        Version 2.0, January 2004
+                     http://www.apache.org/licenses/
+
+TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+1. Definitions.
+
+   "License" shall mean the terms and conditions for use, reproduction,
+   and distribution as defined by Sections 1 through 9 of this document.
+
+   "Licensor" shall mean the copyright owner or entity authorized by
+   the copyright owner that is granting the License.
+
+   "Legal Entity" shall mean the union of the acting entity and all
+   other entities that control, are controlled by, or are under common
+   control with that entity. For the purposes of this definition,
+   "control" means (i) the power, direct or indirect, to cause the
+   direction or management of such entity, whether by contract or
+   otherwise, or (ii) ownership of fifty percent (50%) or more of the
+   outstanding shares, or (iii) beneficial ownership of such entity.
+
+   "You" (or "Your") shall mean an individual or Legal Entity
+   exercising permissions granted by this License.
+
+   "Source" form shall mean the preferred form for making modifications,
+   including but not limited to software source code, documentation
+   source, and configuration files.
+
+   "Object" form shall mean any form resulting from mechanical
+   transformation or translation of a Source form, including but
+   not limited to compiled object code, generated documentation,
+   and conversions to other media types.
+
+   "Work" shall mean the work of authorship, whether in Source or
+   Object form, made available under the License, as indicated by a
+   copyright notice that is included in or attached to the work
+   (an example is provided in the Appendix below).
+
+   "Derivative Works" shall mean any work, whether in Source or Object
+   form, that is based on (or derived from) the Work and for which the
+   editorial revisions, annotations, elaborations, or other modifications
+   represent, as a whole, an original work of authorship. For the purposes
+   of this License, Derivative Works shall not include works that remain
+   separable from, or merely link (or bind by name) to the interfaces of,
+   the Work and Derivative Works thereof.
+
+   "Contribution" shall mean any work of authorship, including
+   the original version of the Work and any modifications or additions
+   to that Work or Derivative Works thereof, that is intentionally
+   submitted to Licensor for inclusion in the Work by the copyright owner
+   or by an individual or Legal Entity authorized to submit on behalf of
+   the copyright owner. For the purposes of this definition, "submitted"
+   means any form of electronic, verbal, or written communication sent
+   to the Licensor or its representatives, including but not limited to
+   communication on electronic mailing lists, source code control systems,
+   and issue tracking systems that are managed by, or on behalf of, the
+   Licensor for the purpose of discussing and improving the Work, but
+   excluding communication that is conspicuously marked or otherwise
+   designated in writing by the copyright owner as "Not a Contribution."
+
+   "Contributor" shall mean Licensor and any individual or Legal Entity
+   on behalf of whom a Contribution has been received by Licensor and
+   subsequently incorporated within the Work.
+
+2. Grant of Copyright License. Subject to the terms and conditions of
+   this License, each Contributor hereby grants to You a perpetual,
+   worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+   copyright license to reproduce, prepare Derivative Works of,
+   publicly display, publicly perform, sublicense, and distribute the
+   Work and such Derivative Works in Source or Object form.
+
+3. Grant of Patent License. Subject to the terms and conditions of
+   this License, each Contributor hereby grants to You a perpetual,
+   worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+   (except as stated in this section) patent license to make, have made,
+   use, offer to sell, sell, import, and otherwise transfer the Work,
+   where such license applies only to those patent claims licensable
+   by such Contributor that are necessarily infringed by their
+   Contribution(s) alone or by combination of their Contribution(s)
+   with the Work to which such Contribution(s) was submitted. If You
+   institute patent litigation against any entity (including a
+   cross-claim or counterclaim in a lawsuit) alleging that the Work
+   or a Contribution incorporated within the Work constitutes direct
+   or contributory patent infringement, then any patent licenses
+   granted to You under this License for that Work shall terminate
+   as of the date such litigation is filed.
+
+4. Redistribution. You may reproduce and distribute copies of the
+   Work or Derivative Works thereof in any medium, with or without
+   modifications, and in Source or Object form, provided that You
+   meet the following conditions:
+
+   (a) You must give any other recipients of the Work or
+       Derivative Works a copy of this License; and
+
+   (b) You must cause any modified files to carry prominent notices
+       stating that You changed the files; and
+
+   (c) You must retain, in the Source form of any Derivative Works
+       that You distribute, all copyright, patent, trademark, and
+       attribution notices from the Source form of the Work,
+       excluding those notices that do not pertain to any part of
+       the Derivative Works; and
+
+   (d) If the Work includes a "NOTICE" text file as part of its
+       distribution, then any Derivative Works that You distribute must
+       include a readable copy of the attribution notices contained
+       within such NOTICE file, excluding those notices that do not
+       pertain to any part of the Derivative Works, in at least one
+       of the following places: within a NOTICE text file distributed
+       as part of the Derivative Works; within the Source form or
+       documentation, if provided along with the Derivative Works; or,
+       within a display generated by the Derivative Works, if and
+       wherever such third-party notices normally appear. The contents
+       of the NOTICE file are for informational purposes only and
+       do not modify the License. You may add Your own attribution
+       notices within Derivative Works that You distribute, alongside
+       or as an addendum to the NOTICE text from the Work, provided
+       that such additional attribution notices cannot be construed
+       as modifying the License.
+
+   You may add Your own copyright statement to Your modifications and
+   may provide additional or different license terms and conditions
+   for use, reproduction, or distribution of Your modifications, or
+   for any such Derivative Works as a whole, provided Your use,
+   reproduction, and distribution of the Work otherwise complies with
+   the conditions stated in this License.
+
+5. Submission of Contributions. Unless You explicitly state otherwise,
+   any Contribution intentionally submitted for inclusion in the Work
+   by You to the Licensor shall be under the terms and conditions of
+   this License, without any additional terms or conditions.
+   Notwithstanding the above, nothing herein shall supersede or modify
+   the terms of any separate license agreement you may have executed
+   with Licensor regarding such Contributions.
+
+6. Trademarks. This License does not grant permission to use the trade
+   names, trademarks, service marks, or product names of the Licensor,
+   except as required for reasonable and customary use in describing the
+   origin of the Work and reproducing the content of the NOTICE file.
+
+7. Disclaimer of Warranty. Unless required by applicable law or
+   agreed to in writing, Licensor provides the Work (and each
+   Contributor provides its Contributions) on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+   implied, including, without limitation, any warranties or conditions
+   of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+   PARTICULAR PURPOSE. You are solely responsible for determining the
+   appropriateness of using or redistributing the Work and assume any
+   risks associated with Your exercise of permissions under this License.
+
+8. Limitation of Liability. In no event and under no legal theory,
+   whether in tort (including negligence), contract, or otherwise,
+   unless required by applicable law (such as deliberate and grossly
+   negligent acts) or agreed to in writing, shall any Contributor be
+   liable to You for damages, including any direct, indirect, special,
+   incidental, or consequential damages of any character arising as a
+   result of this License or out of the use or inability to use the
+   Work (including but not limited to damages for loss of goodwill,
+   work stoppage, computer failure or malfunction, or any and all
+   other commercial damages or losses), even if such Contributor
+   has been advised of the possibility of such damages.
+
+9. Accepting Warranty or Additional Liability. While redistributing
+   the Work or Derivative Works thereof, You may choose to offer,
+   and charge a fee for, acceptance of support, warranty, indemnity,
+   or other liability obligations and/or rights consistent with this
+   License. However, in accepting such obligations, You may act only
+   on Your own behalf and on Your sole responsibility, not on behalf
+   of any other Contributor, and only if You agree to indemnify,
+   defend, and hold each Contributor harmless for any liability
+   incurred by, or claims asserted against, such Contributor by reason
+   of your accepting any such warranty or additional liability.
+
+END OF TERMS AND CONDITIONS
+
+APPENDIX: How to apply the Apache License to your work.
+
+   To apply the Apache License to your work, attach the following
+   boilerplate notice, with the fields enclosed by brackets "[]"
+   replaced with your own identifying information. (Don't include
+   the brackets!)  The text should be enclosed in the appropriate
+   comment syntax for the file format. We also recommend that a
+   file or class name and description of purpose be included on the
+   same "printed page" as the copyright notice for easier
+   identification within third-party archives.
+
+Copyright 2026 Non-convex Tech
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+	http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.

package/LICENSE-MIT

@@ -0,0 +1,19 @@
+Copyright (c) 2026 Non-convex Tech
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

package/README.md

@@ -1,3 +1,56 @@
-# Temporary Holding Version
+# ACN 记忆框架
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+[English](README_EN.md) · [使用指南](docs/user_guide.md) · [开发文档](docs/index.md)
+
+**让每个 Agent 的经验成为团队可复用的知识。**
+
+ACN 记忆框架是 DeepSeek Harness（DSH）的知识协作插件。它从工作对话中沉淀有依据、带适用范围的经验，并通过团队服务，让不同 Agent 分享结论、检索彼此的知识、处理分歧和接收团队建议。也可以个人使用，在自己的会话之间积累与复用知识；接入团队能更充分地发挥 ACN 的协作价值。
+
+| 能力 | 你可以做什么 |
+| --- | --- |
+| 团队协作 | 检索团队知识、分享结论、上报争议并处理团队反馈 |
+| 会话复盘 | 把值得复用的工作结论整理为知识，并保留来源 |
+| 知识复用 | 在新任务中查询已有经验，结合证据和适用范围使用 |
+| 知识整理 | 使用 Dream 清理临时记录、整合相关知识 |
+| 知识与活动 | 阅读知识正文、返回来源会话，查看处理进度和失败原因 |
+
+![DSH 中的 ACN 工作配置](docs/assets/upstream-settings.png)
+
+本插件管理以 Claim 为主体的可复用经验，在接入团队时促进经验分享与流动；不维护私有 Memory 及其管理。知识提炼时会过滤工具名包含 `memory` 的工具调用及其结果（不区分大小写）。
+
+## 开始使用
+
+在 DSH「插件 → 添加插件」填写 **`@ftai/dsh-plugin-acn`**，安装并启用。需要指定版本时，可填写 `@ftai/dsh-plugin-acn@0.1.0`。
+
+1. 向团队管理员取得 Agent ID、Maintainer 和 Router 地址，以及启用鉴权时的团队 Key（可选）。打开「ACN 插件设置」，新建工作配置，开启「连接团队服务」，填写信息、检查连接并保存。
+2. 在「知识与模型」选择知识处理模型；新建会话，在输入框旁确认 ACN 工作配置后开始工作。
+3. 完成一段工作后，在 ACN 菜单选择「复盘本次会话」，到「知识与活动」查看结果。
+
+个人使用时，新建配置并填写固定的 Agent ID，保持「连接团队服务」关闭即可；本地知识仍可积累和复用。
+
+每份工作配置保存各自的知识。同一配置可跨项目复用，不同配置相互隔离；会话开始后归属固定。安装、选择配置、团队连接和常见问题见[使用指南](docs/user_guide.md)。
+
+## 版本更新
+
+可在 [GitHub 仓库](https://github.com/FTShare-Lab/dsh-plugin-acn)选择「Watch → Custom → Releases」，订阅发版通知。当前 DSH 不会自动提醒本插件有新版本，也不会自动升级。
+
+更新前，在「知识与活动 → 处理活动」确认最近任务已不再显示「等待处理」或「正在处理」，再到 DSH 插件页卸载 ACN，通过「添加插件」输入 `@ftai/dsh-plugin-acn` 安装新版。卸载不会删除知识目录中的数据；重新安装后检查工作配置和知识目录，再新建会话使用。重复添加同名包会提示已安装，不会安装出两份。详细步骤见[更新插件](docs/user_guide.md#更新插件)。
+
+## 接入团队
+
+本插件提供 **Agent（A）侧功能**。**Maintainer（M）和 Router（R）需要由用户团队按照 [ACN 官方仓库](https://github.com/FTShare-Lab/agent-claim-network) 自行部署**，插件不会替团队启动这两项服务。
+
+部署完成后，管理员向成员提供 Agent ID、两项服务地址，以及启用鉴权时的团队 Key（可选）。成员在工作配置中开启「连接团队服务」，填写信息并检查连接即可。单人使用无需部署 M、R，也不会发送团队请求。
+
+团队模式会将整理出的 Claim 和 Dispute 共享给 Maintainer。Router 返回的知识供助手参考，团队建议由 Agent 结合本地情况处理。Trace 不直接上传团队；知识处理会使用所选模型服务。
+
+## 维护与开发
+
+- [使用指南](docs/user_guide.md)：带 DSH 界面截图的日常操作说明。
+- [配置参考](docs/config.md)：高级参数和完整配置。
+- [开发指南](docs/development.md)：构建、测试、打包和安装验证。
+- [兼容范围](docs/dsh-compat.md)与[已知限制](docs/outstanding-issues.md)：版本、平台及使用边界。
+
+源码位于 `src/`，提示词位于 `prompts/`，测试位于 `tests/`。插件支持 Apple Silicon Mac（macOS 13+）和 Windows；各平台的实际验收范围见兼容文档。
+
+许可证：[MIT](LICENSE-MIT) 或 [Apache-2.0](LICENSE-APACHE)。

package/README_EN.md

@@ -0,0 +1,56 @@
+# ACN Knowledge Framework
+
+[中文](README.md) · [User guide (Chinese)](docs/user_guide.md) · [Developer documentation](docs/index.md)
+
+**Turn each agent's experience into knowledge the team can reuse.**
+
+ACN is a knowledge collaboration plugin for DeepSeek Harness (DSH). It turns work conversations into reusable conclusions with evidence and a clear scope. Connected agents can share findings, search each other's knowledge, report disagreements, and receive team guidance. You can also use it individually to build knowledge across your own conversations; connecting a team brings out ACN's full collaborative value.
+
+| Capability | What it provides |
+| --- | --- |
+| Team collaboration | Search shared knowledge, contribute findings, report disputes, and process feedback |
+| Session recap | Extract reusable conclusions and retain their sources |
+| Knowledge reuse | Look up experience and assess its evidence and applicability |
+| Dream | Review existing knowledge, retire temporary records, and consolidate related findings |
+| Knowledge and activity | Read records, return to source conversations, and follow progress or failures |
+
+![ACN work configurations in DSH](docs/assets/upstream-settings.png)
+
+This plugin manages reusable experience centered on Claims and supports sharing across a connected team. It does not maintain or manage private Memory. Knowledge extraction excludes calls and results of tools whose names contain `memory`, case-insensitively.
+
+## Get started
+
+In DSH, open **Plugins → Add plugin**, enter **`@ftai/dsh-plugin-acn`**, then install and enable it. To install a specific version, use a name such as `@ftai/dsh-plugin-acn@0.1.0`.
+
+1. Ask your team administrator for an Agent ID, Maintainer and Router URLs, and a team key if authentication is enabled (optional). Open **ACN settings**, create a work configuration, enable **Connect team services**, enter these details, check the connection, and save.
+2. Select a knowledge-processing model under **Knowledge and models**. Start a new conversation and confirm its ACN configuration beside the composer.
+3. After completing useful work, choose **Recap session** from the ACN menu and review the result in **Knowledge and activity**.
+
+For individual use, create a configuration with a stable Agent ID and leave **Connect team services** off. You can still accumulate and reuse local knowledge.
+
+Each configuration has its own knowledge. Projects using the same configuration share that knowledge; separate configurations remain isolated. A conversation's configuration is fixed after it starts. See the [illustrated user guide](docs/user_guide.md) for details.
+
+## Updates
+
+In the [GitHub repository](https://github.com/FTShare-Lab/dsh-plugin-acn), choose **Watch → Custom → Releases** to subscribe to release notifications. DSH currently does not notify you of new versions of this plugin or upgrade it automatically.
+
+Before updating, open **Knowledge and activity → Activity** and check that recent tasks are no longer **Queued** or **Running**. Uninstall ACN from the DSH plugin page, then add `@ftai/dsh-plugin-acn` again to install the new version. Uninstalling leaves your knowledge directory intact. Check your work configurations and knowledge directory after reinstalling, then start a new conversation. Adding the same package again without uninstalling reports that it is already installed; it does not create a second copy. See [Update the plugin](docs/user_guide.md#更新插件) in the Chinese guide.
+
+## Connect a team
+
+This plugin implements the **Agent (A) side**. **Your team must deploy Maintainer (M) and Router (R) separately using the [official ACN repository](https://github.com/FTShare-Lab/agent-claim-network).** The plugin does not start these services for you.
+
+After deployment, the administrator supplies an Agent ID, both service URLs, and a team key when authentication is enabled (optional). Enable **Connect team services** in a work configuration, enter these details, and check the connection. Personal use needs neither service and sends no team requests.
+
+In team mode, formed Claims and Disputes are shared with Maintainer. Router results are candidates for the assistant to assess; the Agent processes team suggestions against its local knowledge. Traces are not uploaded directly to the team. Knowledge processing uses the selected model provider.
+
+## Maintenance and development
+
+- [User guide, in Chinese](docs/user_guide.md): everyday operations with DSH screenshots.
+- [Configuration reference](docs/config.md): advanced options and complete configuration.
+- [Development guide](docs/development.md): build, test, package, and installation checks.
+- [Compatibility](docs/dsh-compat.md) and [known limitations](docs/outstanding-issues.md): versions, platforms, and operational boundaries.
+
+Implementation lives in `src/`, prompts in `prompts/`, and tests in `tests/`. Supported desktop platforms are Apple Silicon Macs (macOS 13+) and Windows; consult the compatibility document for the actual validation coverage.
+
+License: [MIT](LICENSE-MIT) or [Apache-2.0](LICENSE-APACHE).

package/cordis.patch.yml

@@ -0,0 +1,29 @@
+- insert:
+    - id: acn
+      name: cordis:group
+      group: true
+      isolate:
+        acnKnowledge: true
+        acnRuntime: true
+        acnFormation: true
+        acnInbox: true
+        acnDream: true
+      config:
+        - id: acn-configuration
+          name: '@ftai/dsh-plugin-acn'
+        - id: acn-knowledge
+          name: '@ftai/dsh-plugin-acn/knowledge'
+          config:
+            agentId: ''
+        - id: acn-prompt
+          name: '@ftai/dsh-plugin-acn/prompt'
+        - id: acn-tools
+          name: '@ftai/dsh-plugin-acn/tools'
+        - id: acn-formation
+          name: '@ftai/dsh-plugin-acn/formation'
+        - id: acn-inbox
+          name: '@ftai/dsh-plugin-acn/inbox'
+        - id: acn-dream
+          name: '@ftai/dsh-plugin-acn/dream'
+        - id: acn-commands
+          name: '@ftai/dsh-plugin-acn/commands'

package/docs/acn-compat.md

@@ -0,0 +1,33 @@
+# ACN 兼容边界
+
+协议基准为 ACN `0.3.3`，参考提交 `c542b1931f72cb905b502bd0f5b3a6efd99affb6`。兼容测试覆盖 Rust 导出的 YAML、Claim revision 和适配模板快照。`pnpm test:compat` 把 TypeScript 写出的 YAML 交回 Rust 解码；`pnpm test:contract` 使用真实 Router / Maintainer。运行方法见[开发指南](development.md)。
+
+Router 的模型重排和 Maintainer 的自动模型仲裁由 ACN 服务提供，须在服务侧配置；插件负责查询、Dispute 上报、建议内化和上传。当前建议关闭 Router 的模型重排，原因见[团队仲裁与信息边界](outstanding-issues.md#团队仲裁与信息边界)。
+
+共享实体包括 Claim、Trace、Dispute、Policy、仲裁及 Inbox 消息，覆盖字段默认值、别名、null / 省略、RFC 3339 纳秒、UTF-8 revision 与来源 ID。UTC 规范年份限制在 0–9999，避免写出源实现无法读回的文件。
+
+Router 返回候选与 Dispute，不访问私有 Memory；Maintainer 属性更新是建议，Inbox 内化后才改本地知识；receipt ACK 与本地 done 分开。整合先确认存续承接，再投递弃用版本；按实体 ID 和精确版本去重，保留并发新版本。
+
+| 边界 | 插件适配 |
+| --- | --- |
+| upstream 与会话默认值 | 与原版一样保存多份单人或团队 upstream，按全局默认或显式选择启动。DSH 新会话自动沿用同项目最近新建普通会话的 upstream，无可用记录时回退全局默认；已有会话和草稿保持归属。 |
+| 知识库归属 | 新库按 upstream 与 Agent ID 分层。原配置补填团队地址仍使用同一知识库；旧插件目录保留内部映射，不自动合库或整库补传。运行实例启动时固定连接，保存修改后新启动实例使用新参数。 |
+| 形成引用 | 沿用原版扁平可见规则：本地 active/stale 与当前已过滤 transcript 中完整合法的 Claim ID；非法 used IDs 拒绝整批并重试。可引用不代表确实采用，模型仍须按完整正文和任务证据判断 |
+| 模型与锁 | DSH 模型路由；锁外分析，提交时重检完整快照 |
+| Trace task | 当前区间的公开用户任务正文完整保留；读取工具继续分页 |
+| 单人 Dispute | 本地保存，始终无团队请求或上传队列；团队模式重新提出冲突时，仅按待投递及成功上报台账去重 |
+| auth 故障 | 保留 durable 上传项，等待恢复 |
+| Dream | 宿主自主工具循环与逐 Claim 语义复核；默认 24 次探索加 3 次收尾；支持按 Claim 查找和读取自身 Trace |
+| 证据 | 默认关闭；带版本的实际文件读取才是独立证据；high 禁止事实纠正或提升 |
+
+Dream、形成、Inbox effect review、会话状态和权限清单属于插件运行时格式。旧 Rust pending checkpoint / safety reviews 没有插件授权清单，不能直接接管；读回通过不表示日志可互换。插件事务保存创建时的团队共享授权；缺少该字段的旧 prepared 日志仅恢复本地效果并告警，不推定允许上传。
+
+当前 Dream 沿用原版逐 Claim 语义复核，要求保留有效条件、版本与证据限制，不强制逐字复制旧 evidence_summary。探索和收尾额度耗尽后结束本次，下次从当前 Claim 开始；文件查证默认关闭，启用后只提供受限 read / grep / glob。Trace 是来源线索，不授予独立事实证据资格。旧固定阶段适配器及已经 prepared 的提交仍按各自兼容规则恢复；Claim / Trace DTO 与 revision 算法不变。
+
+候选按整批校验后受理，当前组可以保留原目标并继续扩展或调整类型；旧草稿可供参考，但变更后的组必须重新校验复核。尚有额度时，普通文本收尾最多获得两次同上下文修复机会；没有探索或提案就结束时会先提醒一次，仍允许确认零修改。新增请求均计入现有额度，不因修复或提醒增加额度。
+
+公开工具结果不再按前缀裁剪。系统、私有工具与程序封装过滤仍保留；旧记录已经丢失的片段无法凭升级补回，须依据原截断标记判断完整性。团队 Dispute 在 Claim 投递后独立尝试，Claim 更新失败不会自动阻止争议；Policy 撤回会补传全部直接依赖的废弃版本，已废弃条目不额外推进时间或伪造新 Trace。
+
+`/acn-import` 只复制校验通过且归属当前 Agent 的 `claims/` 和 `traces/`，跳过已有目标。不导入锁、会话、任务、Dream 日志、上传队列或团队状态，也不自动上传。源目录应停止写入以获得稳定快照；规则、预览及恢复语义见[导入说明](command-reference.md#从已有-acn-目录导入)。
+
+结构、引用和模型自评不能证明事实正确或整合语义等价，见[已知限制](outstanding-issues.md)。